Díganos qué opina sobre la experiencia de descarga del PDF.

Documentación de C#
Aprenda a escribir aplicaciones con el lenguaje de programación C# en la plataforma
.NET.

Aprender a programar en C#

ｂ INTRODUCCIÓN

Aprender C# | Tutoriales, cursos, vídeos y mucho más

ｑ VIDEO

Serie de vídeos para principiantes de C#

Flujo para principiantes de C#

Serie de vídeos para usuarios de nivel intermedio de C#

ｇ TUTORIAL

Tutoriales autoguiados

Tutorial en el explorador

ｉ REFERENCIA

C# en Q&A

Lenguajes en foros de la comunidad tecnológica de .NET

C# en Stack Overflow

C# en Discord

Aspectos básicos de C#

ｅ INFORMACIÓN GENERAL

Un paseo por C#

Dentro de un programa de C#

Serie de vídeos de información destacada de C#

ｐ CONCEPTO

Sistema de tipos

Programación orientada a objetos

Técnicas funcionales

Excepciones

Estilo de codificación

ｇ TUTORIAL

Mostrar línea de comandos

Introducción a las clases

C# orientado a objetos

Conversión de tipos

Detección de patrones

Uso de LINQ para consultar datos

Conceptos clave

ｅ INFORMACIÓN GENERAL

Conceptos de programación

ｆ INICIO RÁPIDO

Métodos

Propiedades

Indizadores

Iterators

Delegados

Events

ｐ CONCEPTO

Tipos de referencia que aceptan valores NULL

Migraciones de referencia que admiten un valor NULL

Resolución de advertencias que admiten un valor NULL

Language-Integrated Query (LINQ)

Control de versiones

Novedades

ｈ NOVEDADES

Novedades de C# 11

Novedades de C# 10

Novedades de C# 9.0

Novedades de C# 8.0

ｇ TUTORIAL

Exploración de los tipos de registros

Exploración de instrucciones de nivel superior

Exploración de nuevos patrones

Actualización de interfaces de forma segura

Creación de mixins con interfaces

Exploración de los índices y rangos

Tipos de referencia que aceptan valores NULL

Exploración de flujos asincrónicos

Escritura de un controlador de interpolación de cadenas personalizado

ｉ REFERENCIA

Cambios importantes en el compilador de C#

Compatibilidad de versiones

Referencia del lenguaje C#

ｉ REFERENCIA

Referencia del lenguaje

 g j

Palabras clave de C#

Operadores de C#

Configurar la versión del lenguaje

Especificación del lenguaje C#: borrador de C# 7 en curso

Mantente en contacto

ｉ REFERENCIA

Comunidad de desarrolladores de .NET

YouTube

Twitter
Paseo por el lenguaje C#
Artículo • 15/02/2023 • Tiempo de lectura: 16 minutos

C# (pronunciado "si sharp" en inglés) es un lenguaje de programación moderno, basado

en objetos y con seguridad de tipos. C# permite a los desarrolladores crear muchos
tipos de aplicaciones seguras y sólidas que se ejecutan en .NET. C# tiene sus raíces en la
familia de lenguajes C, y a los programadores de C, C++, Java y JavaScript les resultará
familiar inmediatamente. Este paseo proporciona información general de los principales
componentes del lenguaje en C# 8 y versiones anteriores. Si quiere explorar el lenguaje
a través de ejemplos interactivos, pruebe los tutoriales de introducción a C#.

C# es un lenguaje de programación orientado a componentes, orientado a objetos. C#

proporciona construcciones de lenguaje para admitir directamente estos conceptos, por
lo que se trata de un lenguaje natural en el que crear y usar componentes de software.
Desde su origen, C# ha agregado características para admitir nuevas cargas de trabajo y
prácticas de diseño de software emergentes. En el fondo, C# es un lenguaje orientado a
objetos. Defina los tipos y su comportamiento.

Varias características de C# facilitan la creación de aplicaciones sólidas y duraderas. La

recolección de elementos no utilizados reclama de forma automática la memoria que
ocupan los objetos que no se utilizan y a los que no se puede acceder. Los tipos que
aceptan valores NULL ofrecen protección ante variables que no hacen referencia a
objetos asignados. El control de excepciones proporciona un enfoque estructurado y
extensible para la detección y recuperación de errores. Las expresiones lambda admiten
técnicas de programación funcional. La sintaxis de Language Integrated Query (LINQ)
crea un patrón común para trabajar con datos de cualquier origen. La compatibilidad
del lenguaje con las operaciones asincrónicas proporciona la sintaxis para crear
sistemas distribuidos. C# tiene un sistema de tipos unificado. Todos los tipos de C#,
incluidos los tipos primitivos como int y double , se heredan de un único tipo object
raíz. Todos los tipos comparten un conjunto de operaciones comunes. Los valores de
cualquier tipo se pueden almacenar, transportar y operar de forma coherente. Además,
C# admite tanto tipos de referencia definidos por el usuario como tipos de valor. C#
permite la asignación dinámica de objetos y el almacenamiento en línea de estructuras
ligeras. C# admite métodos y tipos genéricos, que proporcionan una mayor seguridad
de tipos, así como un mejor rendimiento. C# también proporciona iteradores, gracias a
los que los implementadores de clases de colecciones pueden definir comportamientos
personalizados para el código de cliente.

C# resalta el control de versiones para garantizar que los programas y las bibliotecas
puedan evolucionar con el tiempo de manera compatible. Los aspectos del diseño de
C# afectados directamente por las consideraciones de versionamiento incluyen los
modificadores virtual y override independientes, las reglas para la resolución de
sobrecargas de métodos y la compatibilidad para declaraciones explícitas de miembros
de interfaz.

Arquitectura de .NET
Los programas de C# se ejecutan en .NET, un sistema de ejecución virtual denominado
Common Language Runtime (CLR) y un conjunto de bibliotecas de clases. CLR es la
implementación de Microsoft del estándar internacional Common Language
Infrastructure (CLI). CLI es la base para crear entornos de ejecución y desarrollo en los
que los lenguajes y las bibliotecas funcionan juntos sin problemas.

El código fuente escrito en C# se compila en un lenguaje intermedio (IL) que guarda

conformidad con la especificación de CLI. El código y los recursos de IL, como los mapas
de bits y las cadenas, se almacenan en un ensamblado, normalmente con una extensión
.dll. Un ensamblado contiene un manifiesto que proporciona información sobre los
tipos, la versión y la referencia cultural.

Cuando se ejecuta el programa C#, el ensamblado se carga en CLR. CLR realiza la

compilación Just-In-Time (JIT) para convertir el código IL en instrucciones de máquina
nativas. Además, CLR proporciona otros servicios relacionados con la recolección de
elementos no utilizados, el control de excepciones y la administración de recursos. El
código que se ejecuta en CLR a veces se conoce como "código administrado". El
"código no administrado" se compila en un lenguaje nativo de la máquina destinado a
un sistema concreto.

La interoperabilidad entre lenguajes es una característica principal de .NET. El código IL

generado por el compilador de C# se ajusta a la especificación de tipo común (CTS). El
código IL generado desde C# puede interactuar con el código generado a partir de las
versiones de .NET de F# , Visual Basic y C++. Hay más de otros 20 lenguajes
compatibles con CTS. Un solo ensamblado puede contener varios módulos escritos en
diferentes lenguajes .NET y los tipos se pueden hacer referencia mutuamente igual que
si estuvieran escritos en el mismo lenguaje.

Además de los servicios en tiempo de ejecución, .NET también incluye amplias

bibliotecas, que admiten muchas cargas de trabajo diferentes. Se organizan en espacios
de nombres que proporcionan una amplia variedad de funcionalidades útiles. Las
bibliotecas incluyen todo, desde la entrada y salida de archivos, la manipulación de
cadenas y el análisis de XML hasta los marcos de aplicaciones web y los controles de
Windows Forms. En una aplicación de C# típica se usa la biblioteca de clases de .NET de
forma extensa para controlar tareas comunes de infraestructura.
Para obtener más información sobre .NET, vea Introducción a .NET.

Hola a todos
El programa "Hola mundo" tradicionalmente se usa para presentar un lenguaje de
programación. En este caso, se usa C#:

C#

using System;

class Hello

static void Main()

Console.WriteLine("Hello, World");

El programa "Hola mundo" empieza con una directiva using que hace referencia al
espacio de nombres System . Los espacios de nombres proporcionan un método
jerárquico para organizar las bibliotecas y los programas de C#. Los espacios de
nombres contienen tipos y otros espacios de nombres; por ejemplo, el espacio de
nombres System contiene varios tipos, como la clase Console a la que se hace referencia
en el programa, y otros espacios de nombres, como IO y Collections . Una directiva
using que hace referencia a un espacio de nombres determinado permite el uso no
calificado de los tipos que son miembros de ese espacio de nombres. Debido a la
directiva using , puede utilizar el programa Console.WriteLine como abreviatura de
System.Console.WriteLine .

La clase Hello declarada por el programa "Hola mundo" tiene un miembro único, el
método llamado Main . El método Main se declara con el modificador static . Mientras
que los métodos de instancia pueden hacer referencia a una instancia de objeto
envolvente determinada utilizando la palabra clave this , los métodos estáticos
funcionan sin referencia a un objeto determinado. Por convención, un método estático
denominado Main sirve como punto de entrada de un programa de C#.

La salida del programa la genera el método WriteLine de la clase Console en el espacio

de nombres System . Esta clase la proporcionan las bibliotecas de clase estándar, a las
que, de forma predeterminada, el compilador hace referencia automáticamente.

Tipos y variables
Un tipo define la estructura y el comportamiento de los datos en C#. La declaración de
un tipo puede incluir sus miembros, tipo base, interfaces que implementa y operaciones
permitidas para ese tipo. Una variable es una etiqueta que hace referencia a una
instancia de un tipo específico.

Hay dos clases de tipos en C#: tipos de valor y tipos de referencia. Las variables de tipos
de valor contienen directamente sus datos. Las variables de tipos de referencia
almacenan referencias a los datos, lo que se conoce como objetos. Con los tipos de
referencia, es posible que dos variables hagan referencia al mismo objeto y que, por
tanto, las operaciones en una variable afecten al objeto al que hace referencia la otra.
Con los tipos de valor, cada variable tiene su propia copia de los datos y no es posible
que las operaciones en una variable afecten a la otra (excepto para las variables de
parámetro ref y out ).

Un identificador es un nombre de variable. Un identificador es una secuencia de

caracteres Unicode sin ningún espacio en blanco. Un identificador puede ser una
palabra reservada de C# si tiene el prefijo @ . El uso de una palabra reservada como
identificador puede ser útil al interactuar con otros lenguajes.

Los tipos de valor de C# se dividen en tipos simples, tipos de enumeración, tipos de

estructura, tipos de valor que aceptan valores NULL y tipos de valor de tupla. Los tipos de
referencia de C# se dividen en tipos de clase, tipos de interfaz, tipos de matriz y tipos
delegados.

En el esquema siguiente se ofrece información general del sistema de tipos de C#.

Tipos de valor
Tipos simples
Entero con signo: sbyte , short , int , long
Entero sin signo: byte , ushort , uint , ulong
Caracteres Unicode: char , que representa una unidad de código UTF-16
Punto flotante binario IEEE: float , double
Punto flotante decimal de alta precisión: decimal
Booleano: bool , que representa valores booleanos, valores que son true o
false

Tipos de enumeración
Tipos definidos por el usuario con el formato enum E {...} . Un tipo enum es
un tipo distinto con constantes con nombre. Cada tipo enum tiene un tipo
subyacente, que debe ser uno de los ocho tipos enteros. El conjunto de
valores de un tipo enum es igual que el conjunto de valores del tipo
subyacente.
 Tipos de estructura
Tipos definidos por el usuario con el formato struct S {...}
Tipos de valores que aceptan valores NULL
Extensiones de todos los demás tipos de valor con un valor null
Tipos de valor de tupla
Tipos definidos por el usuario con el formato (T1, T2, ...)
Tipos de referencia
Tipos de clase
Clase base definitiva de todos los demás tipos: object
Cadenas Unicode: string , que representa una secuencia de unidades de
código UTF-16
Tipos definidos por el usuario con el formato class C {...}
Tipos de interfaz
Tipos definidos por el usuario con el formato interface I {...}
Tipos de matriz
Unidimensional, multidimensional y escalonada. Por ejemplo, int[] , int[,]
y int[][] .
Tipos delegados
Tipos definidos por el usuario con el formato delegate int D(...)

Los programas de C# utilizan declaraciones de tipos para crear nuevos tipos. Una
declaración de tipos especifica el nombre y los miembros del nuevo tipo. Seis de las
categorías de tipos de C# las define el usuario: tipos de clase, tipos de estructura, tipos
de interfaz, tipos de enumeración, tipos de delegado y tipos de valor de tupla. También
puede declarar tipos record , bien sean record struct o record class . Los tipos de
registro tienen miembros sintetizados por el compilador. Los registros se usan
principalmente para almacenar valores, con un comportamiento mínimo asociado.

A tipo class define una estructura de datos que contiene miembros de datos
(campos) y miembros de función (métodos, propiedades y otros). Los tipos de
clase admiten herencia única y polimorfismo, mecanismos por los que las clases
derivadas pueden extender y especializar clases base.
Un tipo struct es similar a un tipo de clase, por el hecho de que representa una
estructura con miembros de datos y miembros de función. Pero a diferencia de las
clases, las estructuras son tipos de valor y no suelen requerir la asignación del
montón. Los tipos de estructura no admiten la herencia especificada por el usuario
y todos se heredan implícitamente del tipo object .
Un tipo interface define un contrato como un conjunto con nombre de
miembros públicos. Un valor class o struct que implementa interface debe
proporcionar implementaciones de miembros de la interfaz. Un interface puede
 heredar de varias interfaces base, y un class o struct pueden implementar varias
interfaces.
Un tipo delegate representa las referencias a métodos con una lista de parámetros
determinada y un tipo de valor devuelto. Los delegados permiten tratar métodos
como entidades que se puedan asignar a variables y se puedan pasar como
parámetros. Los delegados son análogos a los tipos de función proporcionados
por los lenguajes funcionales. También son similares al concepto de punteros de
función de otros lenguajes. A diferencia de los punteros de función, los delegados
están orientados a objetos y tienen seguridad de tipos.

Los tipos class , struct , interface y delegate admiten parámetros genéricos,

mediante los que se pueden parametrizar con otros tipos.

C# admite matrices unidimensionales y multidimensionales de cualquier tipo. A

diferencia de los tipos enumerados antes, no es necesario declarar los tipos de matriz
antes de usarlos. En su lugar, los tipos de matriz se crean mediante un nombre de tipo
entre corchetes. Por ejemplo, int[] es una matriz unidimensional de int , int[,] es
una matriz bidimensional de int y int[][] es una matriz unidimensional de las
matrices unidimensionales, o la matriz "escalonada", de int .

Los tipos que aceptan valores NULL no requieren una definición independiente. Para
cada tipo T que no acepta valores NULL, existe un tipo T? que acepta valores NULL
correspondiente, que puede tener un valor adicional, null . Por ejemplo, int? es un tipo
que puede contener cualquier entero de 32 bits o el valor null y string? es un tipo
que puede contener cualquier string o el valor null .

El sistema de tipos de C# está unificado, de tal forma que un valor de cualquier tipo
puede tratarse como object . Todos los tipos de C# directa o indirectamente se derivan
del tipo de clase object , y object es la clase base definitiva de todos los tipos. Los
valores de tipos de referencia se tratan como objetos mediante la visualización de los
valores como tipo object . Los valores de tipos de valor se tratan como objetos
mediante la realización de operaciones de conversión boxing y operaciones de conversión
unboxing. En el ejemplo siguiente, un valor int se convierte en object y vuelve a int .

C#

int i = 123;

object o = i; // Boxing

int j = (int)o; // Unboxing

Cuando se asigna un valor de un tipo de valor a una referencia object , se asigna un

"box" para contener el valor. Ese box es una instancia de un tipo de referencia, y es
donde se copia el valor. Por el contrario, cuando una referencia object se convierte en
un tipo de valor, se comprueba si el elemento object al que se hace referencia es un
box del tipo de valor correcto. Si la comprobación se realiza correctamente, el valor del
box se copia en el tipo de valor.

El sistema de tipos unificado de C# significa que los tipos de valor se tratan como
referencias de object "a petición". Debido a la unificación, las bibliotecas de uso
general que usan el tipo object se pueden utilizar con todos los tipos que se derivan de
object , incluidos los tipos de referencia y los tipos de valor.

Hay varios tipos de variables en C#, entre otras, campos, elementos de matriz, variables
locales y parámetros. Las variables representan ubicaciones de almacenamiento. Cada
variable tiene un tipo que determina qué valores se pueden almacenar en ella, como se
muestra a continuación.

Tipo de valor distinto a NULL

Un valor de ese tipo exacto
Tipos de valor NULL
Un valor null o un valor de ese tipo exacto
objeto
Una referencia null , una referencia a un objeto de cualquier tipo de referencia
o una referencia a un valor de conversión boxing de cualquier tipo de valor
Tipo de clase
Una referencia null , una referencia a una instancia de ese tipo de clase o una
referencia a una instancia de una clase derivada de ese tipo de clase
Tipo de interfaz
Un referencia null , una referencia a una instancia de un tipo de clase que
implementa dicho tipo de interfaz o una referencia a un valor de conversión
boxing de un tipo de valor que implementa dicho tipo de interfaz
Tipo de matriz
Una referencia null , una referencia a una instancia de ese tipo de matriz o una
referencia a una instancia de un tipo de matriz compatible
Tipo delegado
Una referencia null o una referencia a una instancia de un tipo delegado
compatible

Estructura del programa

Los conceptos organizativos clave de C# son programas, espacios de nombres, tipos,
miembros y ensamblados. Los programas declaran tipos, que contienen miembros y
pueden organizarse en espacios de nombres. Las clases, estructuras e interfaces son
ejemplos de tipos. Los campos, los métodos, las propiedades y los eventos son ejemplos
de miembros. Cuando se compilan programas de C#, se empaquetan físicamente en
ensamblados. Normalmente, los ensamblados tienen las extensiones de archivo .exe o
.dll , en función de si implementan aplicaciones o bibliotecas, respectivamente.

Como ejemplo pequeño, considere la posibilidad de usar un ensamblado que contenga

el código siguiente:

C#

namespace Acme.Collections;

public class Stack<T>

Entry _top;

public void Push(T data)

_top = new Entry(_top, data);

public T Pop()

if (_top == null)

throw new InvalidOperationException();

T result = _top.Data;

_top = _top.Next;

return result;

class Entry

public Entry Next { get; set; }

public T Data { get; set; }

public Entry(Entry next, T data)

Next = next;

Data = data;

El nombre completo de esta clase es Acme.Collections.Stack . La clase contiene varios

miembros: un campo denominado _top , dos métodos denominados Push y Pop , y una
clase anidada denominada Entry . La clase Entry contiene además tres miembros: una
propiedad llamada Next , otra llamada Data y un constructor. Stack es una clase
genérica. Tiene un parámetro de tipo, T , que se reemplaza con un tipo concreto cuando
se usa.

Una pila es una colección de tipo "el primero que entra es el último que sale" (FILO). Los
elementos nuevos se agregan a la parte superior de la pila. Cuando se quita un
elemento, se quita de la parte superior de la pila. En el ejemplo anterior se declara el
tipo Stack que define el almacenamiento y comportamiento de una pila. Puede declarar
una variable que haga referencia a una instancia del tipo Stack para usar esa
funcionalidad.

Los ensamblados contienen código ejecutable en forma de instrucciones de lenguaje

intermedio (IL) e información simbólica en forma de metadatos. Antes de ejecutarlo, el
compilador Just-In-Time (JIT) del entorno de ejecución de .NET convierte el código de IL
de un ensamblado en código específico del procesador.

Como un ensamblado es una unidad autodescriptiva de funcionalidad que contiene

código y metadatos, no hay necesidad de directivas #include ni archivos de
encabezado de C#. Los tipos y miembros públicos contenidos en un ensamblado
determinado estarán disponibles en un programa de C# simplemente haciendo
referencia a dicho ensamblado al compilar el programa. Por ejemplo, este programa usa
la clase Acme.Collections.Stack desde el ensamblado acme.dll :

C#

class Example

public static void Main()

var s = new Acme.Collections.Stack<int>();

s.Push(1); // stack contains 1

s.Push(10); // stack contains 1, 10

s.Push(100); // stack contains 1, 10, 100

Console.WriteLine(s.Pop()); // stack contains 1, 10

Console.WriteLine(s.Pop()); // stack contains 1

Console.WriteLine(s.Pop()); // stack is empty

Para compilar este programa, necesitaría hacer referencia al ensamblado que contiene la
clase de pila que se define en el ejemplo anterior.

Los programas de C# se pueden almacenar en varios archivos de origen. Cuando se

compila un programa de C#, todos los archivos de origen se procesan juntos y se
pueden hacer referencia entre sí de manera libre. Conceptualmente, es como si todos
los archivos de origen estuviesen concatenados en un archivo de gran tamaño antes de
que se procesen. En C# nunca se necesitan declaraciones adelantadas porque, excepto
en contadas ocasiones, el orden de declaración es insignificante. C# no limita un archivo
de origen a declarar solamente un tipo público ni precisa que el nombre del archivo de
origen coincida con un tipo declarado en el archivo de origen.

En otros artículos de este paseo se explican estos bloques organizativos.

Siguiente
Tipos y miembros de C#
Artículo • 10/02/2023 • Tiempo de lectura: 7 minutos

En cuanto lenguaje orientado a objetos, C# admite los conceptos de encapsulación,

herencia y polimorfismo. Una clase puede heredar directamente de una clase primaria e
implementar cualquier número de interfaces. Los métodos que invalidan los métodos
virtuales en una clase primaria requieren la palabra clave override como una manera de
evitar redefiniciones accidentales. En C#, un struct es como una clase ligera; es un tipo
asignado en la pila que puede implementar interfaces pero que no admite la herencia.
C# proporciona tipos de record class y de record struct cuyo propósito es,
principalmente, almacenar valores de datos.

Clases y objetos
Las clases son los tipos más fundamentales de C#. Una clase es una estructura de datos
que combina estados (campos) y acciones (métodos y otros miembros de función) en
una sola unidad. Una clase proporciona una definición para instancias de la clase,
también conocidas como objetos. Las clases admiten herencia y polimorfismo,
mecanismos por los que las clases derivadas pueden extender y especializar clases base.

Las clases nuevas se crean mediante declaraciones de clase. Una declaración de clase
comienza con un encabezado. El encabezado especifica lo siguiente:

Atributos y modificadores de la clase

Nombre de la clase
Clase base (al heredar de una clase base)
Interfaces implementadas por la clase

Al encabezado le sigue el cuerpo de la clase, que consta de una lista de declaraciones

de miembros escritas entre los delimitadores { y } .

En el código siguiente se muestra una declaración de una clase simple denominada

Point :

C#

public class Point

public int X { get; }

public int Y { get; }

public Point(int x, int y) => (X, Y) = (x, y);

Las instancias de clases se crean mediante el operador new , que asigna memoria para
una nueva instancia, invoca un constructor para inicializar la instancia y devuelve una
referencia a la instancia. Las instrucciones siguientes crean dos objetos Point y
almacenan las referencias en esos objetos en dos variables:

C#

var p1 = new Point(0, 0);

var p2 = new Point(10, 20);

La memoria ocupada por un objeto se reclama automáticamente cuando el objeto ya no

es accesible. En C#, no es necesario ni posible desasignar objetos de forma explícita.

Parámetros de tipo
Las clases genéricas definen parámetros de tipos. Los parámetros de tipo son una lista
de nombres de parámetros de tipo entre paréntesis angulares. Los parámetros de tipo
siguen el nombre de la clase. Los parámetros de tipo pueden usarse luego en el cuerpo
de las declaraciones de clase para definir a los miembros de la clase. En el ejemplo
siguiente, los parámetros de tipo de Pair son TFirst y TSecond :

C#

public class Pair<TFirst, TSecond>

public TFirst First { get; }

public TSecond Second { get; }

public Pair(TFirst first, TSecond second) =>

(First, Second) = (first, second);

Un tipo de clase que se declara para tomar parámetros de tipo se conoce como tipo de
clase genérica. Los tipos de estructura, interfaz y delegado también pueden ser
genéricos.
Cuando se usa la clase genérica, se deben proporcionar argumentos de tipo
para cada uno de los parámetros de tipo:

C#

var pair = new Pair<int, string>(1, "two");

int i = pair.First; //TFirst int

string s = pair.Second; //TSecond string

Un tipo genérico con argumentos de tipo proporcionado, como Pair<int,string>

anteriormente, se conoce como tipo construido.

Clases base
Una declaración de clase puede especificar una clase base. Tras el nombre de clase y los
parámetros de tipo, agregue un signo de dos puntos y el nombre de la clase base.
Omitir una especificación de la clase base es igual que derivarla del tipo object . En el
ejemplo siguiente, la clase base de Point3D es Point . En el primer ejemplo, la clase base
de Point es object :

C#

public class Point3D : Point

public int Z { get; set; }

public Point3D(int x, int y, int z) : base(x, y)

Z = z;

Una clase hereda a los miembros de su clase base. La herencia significa que una clase
contiene implícitamente casi todos los miembros de su clase base. Una clase no hereda
la instancia, los constructores estáticos ni el finalizador. Una clase derivada puede
agregar nuevos miembros a aquellos de los que hereda, pero no puede quitar la
definición de un miembro heredado. En el ejemplo anterior, Point3D hereda los
miembros X y Y de Point , y cada instancia de Point3D contiene tres miembros: X , Y y
Z.

Existe una conversión implícita de un tipo de clase a cualquiera de sus tipos de clase
base. Una variable de un tipo de clase puede hacer referencia a una instancia de esa
clase o a una instancia de cualquier clase derivada. Por ejemplo, dadas las declaraciones
de clase anteriores, una variable de tipo Point puede hacer referencia a una instancia
de Point o Point3D :

C#

Point a = new(10, 20);

Point b = new Point3D(10, 20, 30);

Estructuras
Las clases definen tipos que admiten la herencia y el polimorfismo. Permiten crear
comportamientos sofisticados basados en jerarquías de clases derivadas. Por el
contrario, los tipos struct son tipos más simples, cuyo propósito principal es almacenar
valores de datos. Dichos tipos struct no pueden declarar un tipo base; se derivan
implícitamente de System.ValueType. No se pueden derivar otros tipos de struct a
partir de un tipo de struct . Están sellados implícitamente.

C#

public struct Point

public double X { get; }

public double Y { get; }

public Point(double x, double y) => (X, Y) = (x, y);

Interfaces
Una interfaz define un contrato que se puede implementar mediante clases y structs.
Una interfaz se define para declarar capacidades que se comparten entre tipos distintos.
Por ejemplo, la interfaz System.Collections.Generic.IEnumerable<T> define una manera
coherente de recorrer todos los elementos de una colección, como una matriz. Una
interfaz puede contener métodos, propiedades, eventos e indexadores. Normalmente,
una interfaz no proporciona implementaciones de los miembros que define, sino que
simplemente especifica los miembros que se deben proporcionar mediante clases o
estructuras que implementan la interfaz.

Las interfaces pueden usar la herencia múltiple. En el ejemplo siguiente, la interfaz

IComboBox hereda de ITextBox y IListBox .

C#

interface IControl

void Paint();

interface ITextBox : IControl

void SetText(string text);

 interface IListBox : IControl

void SetItems(string[] items);

interface IComboBox : ITextBox, IListBox { }

Las clases y los structs pueden implementar varias interfaces. En el ejemplo siguiente, la
clase EditBox implementa IControl y IDataBound .

C#

interface IDataBound

void Bind(Binder b);

public class EditBox : IControl, IDataBound

public void Paint() { }

public void Bind(Binder b) { }

Cuando una clase o un struct implementan una interfaz determinada, las instancias de
esa clase o struct se pueden convertir implícitamente a ese tipo de interfaz. Por ejemplo

C#

EditBox editBox = new();

IControl control = editBox;

IDataBound dataBound = editBox;

Enumeraciones
Un tipo de enumeración define un conjunto de valores constantes. En el elemento enum
siguiente se declaran constantes que definen diferentes verduras de raíz:

C#

public enum SomeRootVegetable

HorseRadish,

Radish,

Turnip

También puede definir un elemento enum que se usará de forma combinada como
marcas. La declaración siguiente declara un conjunto de marcas para las cuatro
estaciones. Se puede aplicar cualquier combinación de estaciones, incluido un valor All
que incluya todas las estaciones:

C#

[Flags]

public enum Seasons

None = 0,

Summer = 1,

Autumn = 2,

Winter = 4,

Spring = 8,

All = Summer | Autumn | Winter | Spring

En el ejemplo siguiente se muestran las declaraciones de ambas enumeraciones

anteriores:

C#

var turnip = SomeRootVegetable.Turnip;

var spring = Seasons.Spring;

var startingOnEquinox = Seasons.Spring | Seasons.Autumn;

var theYear = Seasons.All;

Tipos que aceptan valores NULL

Las variables de cualquier tipo se pueden declarar para que no acepten valores NULL o
sí acepten valores NULL. Una variable que acepta valores NULL puede contener un valor
null adicional que no indica valor alguno. Los tipos de valor que aceptan valores NULL

(estructuras o enumeraciones) se representan mediante System.Nullable<T>. Los tipos

de referencia que no aceptan valores NULL y los que sí aceptan valores NULL se
representan mediante el tipo de referencia subyacente. La distinción se representa
mediante metadatos leídos por el compilador y algunas bibliotecas. El compilador
proporciona advertencias cuando se desreferencian las referencias que aceptan valores
NULL sin comprobar primero su valor con null . El compilador también proporciona
advertencias cuando las referencias que no aceptan valores NULL se asignan a un valor
que puede ser null . En el ejemplo siguiente se declara un elemento int que admite un
valor NULL, y que se inicializa en null . A continuación, establece el valor en 5 . Muestra
el mismo concepto con una cadena que acepta valores NULL. Para más información,
consulte Tipos de valor que admiten un valor NULL y Tipos de referencia que aceptan
valores NULL.

C#

int? optionalInt = default;

optionalInt = 5;

string? optionalText = default;

optionalText = "Hello World.";

Tuplas
C# admite tuplas, lo que proporciona una sintaxis concisa para agrupar varios
elementos de datos en una estructura de datos ligera. Puede crear una instancia de una
tupla declarando los tipos y los nombres de los miembros entre ( y ) , como se
muestra en el ejemplo siguiente:

C#

(double Sum, int Count) t2 = (4.5, 3);

Console.WriteLine($"Sum of {t2.Count} elements is {t2.Sum}.");

//Output:

//Sum of 3 elements is 4.5.

Las tuplas proporcionan una alternativa para la estructura de datos con varios miembros
sin usar los bloques de creación que se describen en el siguiente artículo.

Anterior Siguiente
Bloques de creación de programas de
C#
Artículo • 18/01/2023 • Tiempo de lectura: 26 minutos

Los tipos descritos en el artículo anterior de esta serie sobre el recorrido por C# se crean
mediante estos bloques de creación:

Miembros, como propiedades, campos, métodos y eventos.

Expresiones
Instrucciones

Miembros
Los miembros de un class son estáticos o de instancia. Los miembros estáticos
pertenecen a clases y los miembros de instancia pertenecen a objetos (instancias de
clases).

En la lista siguiente se proporciona una visión general de los tipos de miembros que
puede contener una clase.

Constantes: Valores constantes asociados a la clase

Campos: variables que están asociadas a la clase.
Métodos: acciones que puede realizar la clase.
Propiedades: Acciones asociadas a la lectura y escritura de propiedades con
nombre de la clase
Indizadores: Acciones asociadas a la indexación de instancias de la clase como una
matriz
Eventos: Notificaciones que puede generar la clase
Operadores: Conversiones y operadores de expresión admitidos por la clase
Constructores: Acciones necesarias para inicializar instancias de la clase o la clase
propiamente dicha
Finalizadores: acciones que se realizan antes de que las instancias de la clase se
descarten de forma permanente
Tipos: Tipos anidados declarados por la clase

Accesibilidad
Cada miembro de una clase tiene asociada una accesibilidad, que controla las regiones
del texto del programa que pueden acceder al miembro. Existen seis formas de
accesibilidad posibles. A continuación se resumen los modificadores de acceso.

public : El acceso no está limitado.

private : El acceso está limitado a esta clase.

protected : El acceso está limitado a esta clase o a las clases derivadas de esta
clase.
internal : El acceso está limitado al ensamblado actual ( .exe o .dll ).

protected internal : El acceso está limitado a esta clase, las clases derivadas de la
misma o las clases que forman parte del mismo ensamblado.
private protected : El acceso está limitado a esta clase o a las clases derivadas de
este tipo que forman parte del mismo ensamblado.

Campos
Un campo es una variable que está asociada con una clase o a una instancia de una
clase.

Un campo declarado con el modificador "static" define un campo estático. Un campo

estático identifica exactamente una ubicación de almacenamiento. Independientemente
del número de instancias de una clase que se creen, solo hay una única copia de un
campo estático.

Un campo declarado sin el modificador "static" define un campo de instancia. Cada

instancia de una clase contiene una copia independiente de todos los campos de
instancia de esa clase.

En el ejemplo siguiente, cada instancia de la clase Color tiene una copia independiente
de los campos de instancia R , G y B , pero solo hay una copia de los campos estáticos
Black , White , Red , Green y Blue :

C#

public class Color

public static readonly Color Black = new(0, 0, 0);

public static readonly Color White = new(255, 255, 255);

public static readonly Color Red = new(255, 0, 0);

public static readonly Color Green = new(0, 255, 0);

public static readonly Color Blue = new(0, 0, 255);

public byte R;

public byte G;

public byte B;

public Color(byte r, byte g, byte b)

R = r;

G = g;

B = b;

Como se muestra en el ejemplo anterior, los campos de solo lectura se puede declarar
con un modificador readonly . La asignación a un campo de solo lectura únicamente se
puede producir como parte de la declaración del campo o en un constructor de la
misma clase.

Métodos
Un método es un miembro que implementa un cálculo o una acción que puede realizar
un objeto o una clase. A los métodos estáticos se accede a través de la clase. A los
métodos de instancia se accede a través de instancias de la clase.

Los métodos pueden tener una lista de parámetros, los cuales representan valores o
referencias a variables que se pasan al método. Los métodos tienen un tipo de valor
devuelto, el cual especifica el tipo del valor calculado y devuelto por el método. El tipo
de valor devuelto de un método es void si no devuelve un valor.

Al igual que los tipos, los métodos también pueden tener un conjunto de parámetros de
tipo, para lo cuales se deben especificar argumentos de tipo cuando se llama al método.
A diferencia de los tipos, los argumentos de tipo a menudo se pueden deducir de los
argumentos de una llamada al método y no es necesario proporcionarlos
explícitamente.

La signatura de un método debe ser única en la clase en la que se declara el método. La

signatura de un método se compone del nombre del método, el número de parámetros
de tipo y el número, los modificadores y los tipos de sus parámetros. La signatura de un
método no incluye el tipo de valor devuelto.

Cuando el cuerpo del método es una expresión única, el método se puede definir con
un formato de expresión compacta, tal y como se muestra en el ejemplo siguiente:

C#

public override string ToString() => "This is an object";

Parámetros
Los parámetros se usan para pasar valores o referencias a variables a métodos. Los
parámetros de un método obtienen sus valores reales de los argumentos que se
especifican cuando se invoca el método. Hay cuatro tipos de parámetros: parámetros de
valor, parámetros de referencia, parámetros de salida y matrices de parámetros.

Un parámetro de valor se usa para pasar argumentos de entrada. Un parámetro de valor

corresponde a una variable local que obtiene su valor inicial del argumento que se ha
pasado para el parámetro. Las modificaciones de un parámetro de valor no afectan el
argumento que se ha pasado para el parámetro.

Los parámetros de valor pueden ser opcionales; se especifica un valor predeterminado

para que se puedan omitir los argumentos correspondientes.

Un parámetro de referencia se usa para pasar argumentos mediante una referencia. El

argumento pasado para un parámetro de referencia debe ser una variable con un valor
definido. Durante la ejecución del método, el parámetro de referencia representa la
misma ubicación de almacenamiento que la variable del argumento. Un parámetro de
referencia se declara con el modificador ref . En el ejemplo siguiente se muestra el uso
de parámetros ref .

C#

static void Swap(ref int x, ref int y)

int temp = x;

x = y;

y = temp;

public static void SwapExample()

int i = 1, j = 2;

Swap(ref i, ref j);

Console.WriteLine($"{i} {j}"); // "2 1"

}

Un parámetro de salida se usa para pasar argumentos mediante una referencia. Es

similar a un parámetro de referencia, excepto que no necesita que asigne un valor
explícitamente al argumento proporcionado por el autor de la llamada. Un parámetro
de salida se declara con el modificador out . En el ejemplo siguiente se muestra el uso
de parámetros out .

C#

static void Divide(int x, int y, out int quotient, out int remainder)

 quotient = x / y;

remainder = x % y;

public static void OutUsage()

Divide(10, 3, out int quo, out int rem);

Console.WriteLine($"{quo} {rem}"); // "3 1"

Una matriz de parámetros permite que se pasen a un método un número variable de

argumentos. Una matriz de parámetros se declara con el modificador params . Solo el
último parámetro de un método puede ser una matriz de parámetros y el tipo de una
matriz de parámetros debe ser un tipo de matriz unidimensional. Los métodos Write y
WriteLine de la clase System.Console son buenos ejemplos de uso de la matriz de

parámetros. Se declaran de la manera siguiente.

C#

public class Console

public static void Write(string fmt, params object[] args) { }

public static void WriteLine(string fmt, params object[] args) { }

// ...

Dentro de un método que usa una matriz de parámetros, la matriz de parámetros se

comporta exactamente igual que un parámetro normal de un tipo de matriz. Pero en
una invocación de un método con una matriz de parámetros, es posible pasar un único
argumento del tipo de matriz de parámetros o cualquier número de argumentos del
tipo de elemento de la matriz de parámetros. En este caso, una instancia de matriz se e
inicializa automáticamente con los argumentos dados. Este ejemplo

C#

int x, y, z;

x = 3;

y = 4;

z = 5;

Console.WriteLine("x={0} y={1} z={2}", x, y, z);

es equivalente a escribir lo siguiente.

C#

int x = 3, y = 4, z = 5;

 string s = "x={0} y={1} z={2}";

object[] args = new object[3];

args[0] = x;

args[1] = y;

args[2] = z;

Console.WriteLine(s, args);

Cuerpo del método y variables locales

El cuerpo de un método especifica las instrucciones que se ejecutarán cuando se invoca
el método.

Un cuerpo del método puede declarar variables que son específicas de la invocación del
método. Estas variables se denominan variables locales. Una declaración de variable
local especifica un nombre de tipo, un nombre de variable y, posiblemente, un valor
inicial. En el ejemplo siguiente se declara una variable local i con un valor inicial de
cero y una variable local j sin ningún valor inicial.

C#

class Squares

public static void WriteSquares()

int i = 0;

int j;

while (i < 10)

j = i * i;

Console.WriteLine($"{i} x {i} = {j}");

i++;

C# requiere que se asigne definitivamente una variable local antes de que se pueda
obtener su valor. Por ejemplo, si la declaración de i anterior no incluyera un valor
inicial, el compilador notificaría un error con los usos posteriores de i porque i no se
asignaría definitivamente en esos puntos del programa.

Puede usar una instrucción return para devolver el control a su llamador. En un método
que devuelve void , las instrucciones return no pueden especificar una expresión. En un
método que devuelve valores distintos de void, las instrucciones return deben incluir
una expresión que calcula el valor devuelto.
Métodos estáticos y de instancia
Un método declarado con un modificador static es un método estático. Un método
estático no opera en una instancia específica y solo puede acceder directamente a
miembros estáticos.

Un método declarado sin un modificador static es un método de instancia. Un método

de instancia opera en una instancia específica y puede acceder a miembros estáticos y
de instancia. Se puede acceder explícitamente a la instancia en la que se invoca un
método de instancia como this . Es un error hacer referencia a this en un método
estático.

La siguiente clase Entity tiene miembros estáticos y de instancia.

C#

class Entity

static int s_nextSerialNo;

int _serialNo;

public Entity()

_serialNo = s_nextSerialNo++;

public int GetSerialNo()

return _serialNo;

public static int GetNextSerialNo()

return s_nextSerialNo;

public static void SetNextSerialNo(int value)

s_nextSerialNo = value;

Cada instancia de Entity contiene un número de serie (y, probablemente, otra

información que no se muestra aquí). El constructor Entity (que es como un método de
instancia) inicializa la nueva instancia con el siguiente número de serie disponible. Como
el constructor es un miembro de instancia, se le permite acceder al campo de instancia
_serialNo y al campo estático s_nextSerialNo .
Los métodos estáticos GetNextSerialNo y SetNextSerialNo pueden acceder al campo
estático s_nextSerialNo , pero sería un error para ellas acceder directamente al campo
de instancia _serialNo .

En el ejemplo siguiente se muestra el uso de la clase Entity .

C#

Entity.SetNextSerialNo(1000);

Entity e1 = new();

Entity e2 = new();

Console.WriteLine(e1.GetSerialNo()); // Outputs "1000"

Console.WriteLine(e2.GetSerialNo()); // Outputs "1001"

Console.WriteLine(Entity.GetNextSerialNo()); // Outputs "1002"

Los métodos estáticos SetNextSerialNo y GetNextSerialNo se invocan en la clase,

mientras que el método de instancia GetSerialNo se invoca en instancias de la clase.

Métodos virtual, de reemplazo y abstracto

Use métodos virtuales, de invalidación y abstractos para definir el comportamiento de
una jerarquía de tipos de clase. Como una clase se puede derivar de una clase base, es
posible que tenga que modificar el comportamiento implementado en la clase base de
esas clases derivadas. Un método *virtual es el que se declara e implementa en una
clase base donde cualquier clase derivada puede proporcionar una implementación más
específica. Un método de reemplazo es el que se implementa en una clase derivada que
modifica el comportamiento de la implementación de la clase base. Un método
abstracto es el que se declara en una clase base que se debe reemplazar en todas las
clases derivadas. De hecho, los métodos abstractos no definen una implementación en
la clase base.

Las llamadas de métodos de instancia se pueden resolver en implementaciones de la

clase base o de clases derivadas. El tipo de una variable determina su tipo en tiempo de
compilación. El tipo en tiempo de compilación es el que usa el compilador para
determinar sus miembros. Pero una variable se puede asignar a una instancia de
cualquier tipo derivado de su tipo en tiempo de compilación. El tipo en tiempo de
ejecución es el tipo de la instancia a la que hace referencia esa variable.

Cuando se invoca un método virtual, el tipo en tiempo de ejecución de la instancia para

la que tiene lugar esa invocación determina la implementación del método real que se
invocará. En una invocación de método no virtual, el tipo en tiempo de compilación de la
instancia es el factor determinante.
Un método virtual puede ser reemplazado en una clase derivada. Cuando una
declaración de método de instancia incluye un modificador "override", el método
reemplaza un método virtual heredado con la misma signatura. Una declaración de
método virtual presenta un nuevo método. Una declaración de método de reemplazo
especializa un método virtual heredado existente proporcionando una nueva
implementación de ese método.

Un método abstracto es un método virtual sin implementación. Un método abstracto se

declara con el modificador abstract y solo se permite en una clase abstracta. Un
método abstracto debe reemplazarse en todas las clases derivadas no abstractas.

En el ejemplo siguiente se declara una clase abstracta, Expression , que representa un

nodo de árbol de expresión y tres clases derivadas, Constant , VariableReference y
Operation , que implementan nodos de árbol de expresión para constantes, referencias a
variables y operaciones aritméticas. Este ejemplo es similar a los tipos de árbol de
expresión, pero no está relacionada con ellos.

C#

public abstract class Expression

public abstract double Evaluate(Dictionary<string, object> vars);

public class Constant : Expression

double _value;

public Constant(double value)

_value = value;

public override double Evaluate(Dictionary<string, object> vars)

return _value;

public class VariableReference : Expression

string _name;

public VariableReference(string name)

_name = name;

public override double Evaluate(Dictionary<string, object> vars)

object value = vars[_name] ?? throw new Exception($"Unknown

variable: {_name}");

return Convert.ToDouble(value);

public class Operation : Expression

Expression _left;

char _op;

Expression _right;

public Operation(Expression left, char op, Expression right)

_left = left;

_op = op;

_right = right;

public override double Evaluate(Dictionary<string, object> vars)

double x = _left.Evaluate(vars);

double y = _right.Evaluate(vars);

switch (_op)

case '+': return x + y;

case '-': return x - y;

case '*': return x * y;

case '/': return x / y;

default: throw new Exception("Unknown operator");

Las cuatro clases anteriores se pueden usar para modelar expresiones aritméticas. Por
ejemplo, usando instancias de estas clases, la expresión x + 3 se puede representar de
la manera siguiente.

C#

Expression e = new Operation(

new VariableReference("x"),

'+',

new Constant(3));

El método Evaluate de una instancia Expression se invoca para evaluar la expresión

determinada y generar un valor double . El método toma un argumento Dictionary que
contiene nombres de variables (como claves de las entradas) y valores (como valores de
las entradas). Como Evaluate es un método abstracto, las clases no abstractas que
derivan de Expression deben invalidar Evaluate .

Una implementación de Constant de Evaluate simplemente devuelve la constante

almacenada. Una implementación de VariableReference busca el nombre de variable en
el diccionario y devuelve el valor resultante. Una implementación de Operation evalúa
primero los operandos izquierdo y derecho (mediante la invocación recursiva de sus
métodos Evaluate ) y luego realiza la operación aritmética correspondiente.

El siguiente programa usa las clases Expression para evaluar la expresión x * (y + 2)

para los distintos valores de x y y .

C#

Expression e = new Operation(

new VariableReference("x"),

'*',

new Operation(

new VariableReference("y"),

'+',

new Constant(2)
)

);

Dictionary<string, object> vars = new();

vars["x"] = 3;

vars["y"] = 5;

Console.WriteLine(e.Evaluate(vars)); // "21"

vars["x"] = 1.5;

vars["y"] = 9;

Console.WriteLine(e.Evaluate(vars)); // "16.5"

Sobrecarga de métodos
La sobrecarga de métodos permite que varios métodos de la misma clase tengan el
mismo nombre mientras tengan signaturas únicas. Al compilar una invocación de un
método sobrecargado, el compilador usa la resolución de sobrecarga para determinar el
método concreto que de invocará. La resolución de sobrecarga busca el método que
mejor coincida con los argumentos. Si no se puede encontrar la mejor coincidencia, se
genera un error. En el ejemplo siguiente se muestra la resolución de sobrecarga en
vigor. El comentario para cada invocación del método UsageExample muestra qué
método se invoca.

C#
 class OverloadingExample

static void F() => Console.WriteLine("F()");

static void F(object x) => Console.WriteLine("F(object)");

static void F(int x) => Console.WriteLine("F(int)");

static void F(double x) => Console.WriteLine("F(double)");

static void F<T>(T x) => Console.WriteLine($"F<T>(T), T is

{typeof(T)}");

static void F(double x, double y) => Console.WriteLine("F(double,

double)");

public static void UsageExample()

F(); // Invokes F()

F(1); // Invokes F(int)

F(1.0); // Invokes F(double)

F("abc"); // Invokes F<T>(T), T is System.String

F((double)1); // Invokes F(double)

F((object)1); // Invokes F(object)

F<int>(1); // Invokes F<T>(T), T is System.Int32

F(1, 1); // Invokes F(double, double)

Tal como se muestra en el ejemplo, un método determinado siempre se puede

seleccionar mediante la conversión explícita de los argumentos en los tipos de
parámetros exactos o los argumentos de tipo.

Otros miembros de función

Los miembros que contienen código ejecutable se conocen colectivamente como
miembros de función de una clase. En la sección anterior se describen los métodos, que
son los tipos principales de los miembros de función. En esta sección se describen los
otros tipos de miembros de función admitidos por C#: constructores, propiedades,
indexadores, eventos, operadores y finalizadores.

En el ejemplo siguiente se muestra una clase genérica llamada MyList<T> , que

implementa una lista creciente de objetos. La clase contiene varios ejemplos de los tipos
más comunes de miembros de función.

C#

public class MyList<T>

const int DefaultCapacity = 4;

T[] _items;

 int _count;

public MyList(int capacity = DefaultCapacity)

_items = new T[capacity];

public int Count => _count;

public int Capacity

get => _items.Length;

set

if (value < _count) value = _count;

if (value != _items.Length)

T[] newItems = new T[value];

Array.Copy(_items, 0, newItems, 0, _count);

_items = newItems;

public T this[int index]

get => _items[index];

set

if (!object.Equals(_items[index], value)) {

_items[index] = value;

OnChanged();

public void Add(T item)

if (_count == Capacity) Capacity = _count * 2;

_items[_count] = item;

_count++;

OnChanged();

protected virtual void OnChanged() =>

Changed?.Invoke(this, EventArgs.Empty);

public override bool Equals(object other) =>

Equals(this, other as MyList<T>);

static bool Equals(MyList<T> a, MyList<T> b)

if (Object.ReferenceEquals(a, null)) return

Object.ReferenceEquals(b, null);

if (Object.ReferenceEquals(b, null) || a._count != b._count)

return false;

 for (int i = 0; i < a._count; i++)

if (!object.Equals(a._items[i], b._items[i]))

return false;

return true;

public event EventHandler Changed;

public static bool operator ==(MyList<T> a, MyList<T> b) =>

Equals(a, b);

public static bool operator !=(MyList<T> a, MyList<T> b) =>

!Equals(a, b);

Constructores
C# admite constructores de instancia y estáticos. Un constructor de instancia es un
miembro que implementa las acciones necesarias para inicializar una instancia de una
clase. Un constructor estático es un miembro que implementa las acciones necesarias
para inicializar una clase en sí misma cuando se carga por primera vez.

Un constructor se declara como un método sin ningún tipo de valor devuelto y el

mismo nombre que la clase contenedora. Si una declaración de constructor incluye un
modificador static , declara un constructor estático. De lo contrario, declara un
constructor de instancia.

Los constructores de instancia pueden sobrecargarse y tener parámetros opcionales. Por

ejemplo, la clase  MyList<T> declara un constructor de instancia con único
parámetro  int opcional. Los constructores de instancia se invocan mediante el
operador new . Las siguientes instrucciones asignan dos instancias MyList<string>
mediante el constructor de la clase MyList con y sin el argumento opcional.

C#

MyList<string> list1 = new();

MyList<string> list2 = new(10);

A diferencia de otros miembros, los constructores de instancias no se heredan. Una

clase no tiene constructores de instancia que no sean los que se declaren realmente en
la misma. Si no se proporciona ningún constructor de instancia para una clase, se
proporciona automáticamente uno vacío sin ningún parámetro.

Propiedades
Las propiedades son una extensión natural de los campos. Ambos son miembros con
nombre con tipos asociados y la sintaxis para acceder a los campos y las propiedades es
la misma. Pero a diferencia de los campos, las propiedades no denotan ubicaciones de
almacenamiento. Las propiedades tienen descriptores de acceso que especifican las
instrucciones ejecutadas cuando se leen o escriben sus valores. Un descriptor de acceso
get lee el valor. Un descriptor de acceso set escribe el valor.

Una propiedad se declara como un campo, salvo que la declaración finaliza con un
descriptor de acceso get o un descriptor de acceso set escrito entre los delimitadores {
y } en lugar de finalizar en un punto y coma. Una propiedad que tiene un descriptor de
acceso get y un descriptor de acceso set es una propiedad de lectura y escritura. Una
propiedad que solo tiene un descriptor de acceso get es una propiedad de solo lectura.
Una propiedad que solo tiene un descriptor de acceso set es una propiedad de solo
escritura.

Un descriptor de acceso get corresponde a un método sin parámetros con un valor

devuelto del tipo de propiedad. Un descriptor de acceso set corresponde a un método
con un solo parámetro denominado value y ningún tipo de valor devuelto. El descriptor
de acceso get calcula el valor de la propiedad. El descriptor de acceso set proporciona
un nuevo valor para la propiedad. Cuando la propiedad es el destino de una asignación,
o el operando de ++ o -- , se invoca al descriptor de acceso set. En otros casos en los
que se hace referencia a la propiedad, se invoca al descriptor de acceso get.

La clase MyList<T> declara dos propiedades, Count y Capacity , que son de solo lectura
y de lectura y escritura, respectivamente. El código siguiente es un ejemplo de uso de
estas propiedades:

C#

MyList<string> names = new();

names.Capacity = 100; // Invokes set accessor

int i = names.Count; // Invokes get accessor

int j = names.Capacity; // Invokes get accessor

De forma similar a los campos y métodos, C# admite propiedades de instancia y

propiedades estáticas. Las propiedades estáticas se declaran con el modificador "static",
y las propiedades de instancia se declaran sin él.
Los descriptores de acceso de una propiedad pueden ser virtuales. Cuando una
declaración de propiedad incluye un modificador virtual , abstract o override , se
aplica a los descriptores de acceso de la propiedad.

Indexadores
Un indexador es un miembro que permite indexar de la misma manera que una matriz.
Un indexador se declara como una propiedad, excepto por el hecho que el nombre del
miembro es this , seguido por una lista de parámetros que se escriben entre los
delimitadores [ y ] . Los parámetros están disponibles en los descriptores de acceso del
indexador. De forma similar a las propiedades, los indexadores pueden ser lectura y
escritura, de solo lectura y de solo escritura, y los descriptores de acceso de un
indexador pueden ser virtuales.

La clase MyList<T> declara un único indexador de lectura y escritura que toma un

parámetro int . El indexador permite indexar instancias de MyList<T> con valores int .
Por ejemplo:

C#

MyList<string> names = new();

names.Add("Liz");

names.Add("Martha");

names.Add("Beth");

for (int i = 0; i < names.Count; i++)

string s = names[i];

names[i] = s.ToUpper();

Los indizadores se pueden sobrecargar. Una clase puede declarar varios indexadores
siempre y cuando el número o los tipos de sus parámetros sean diferentes.

Eventos
Un evento es un miembro que permite que una clase u objeto proporcionen
notificaciones. Un evento se declara como un campo, excepto por el hecho de que la
declaración incluye una palabra clave event , y el tipo debe ser un tipo delegado.

Dentro de una clase que declara un miembro de evento, el evento se comporta como
un campo de un tipo delegado (siempre que el evento no sea abstracto y no declare
descriptores de acceso). El campo almacena una referencia a un delegado que
representa los controladores de eventos que se han agregado al evento. Si no existen
controladores de eventos, el campo es null .

La MyList<T> clase declara un único miembro de evento denominado Changed , que

indica que se ha agregado un nuevo elemento a la lista o se ha cambiado un elemento
de lista mediante el descriptor de acceso set del indexador. El método virtual OnChanged
genera el evento cambiado, y comprueba primero si el evento es null (lo que significa
que no existen controladores). La noción de generar un evento es equivalente
exactamente a invocar el delegado representado por el evento. No hay ninguna
construcción especial de lenguaje para generar eventos.

Los clientes reaccionan a los eventos mediante controladores de eventos. Los

controladores de eventos se asocian mediante el operador += y se quitan con el
operador -= . En el ejemplo siguiente se asocia un controlador de eventos con el evento
Changed de un objeto MyList<string> .

C#

class EventExample

static int s_changeCount;

static void ListChanged(object sender, EventArgs e)

s_changeCount++;

public static void Usage()

var names = new MyList<string>();

names.Changed += new EventHandler(ListChanged);

names.Add("Liz");

names.Add("Martha");

names.Add("Beth");

Console.WriteLine(s_changeCount); // "3"

Para escenarios avanzados donde se quiere controlar el almacenamiento subyacente de

un evento, una declaración de evento puede proporcionar de forma explícita los
descriptores de acceso add y remove , que son similares al descriptor de acceso set de
una propiedad.

Operadores
Un operador es un miembro que define el significado de aplicar un operador de
expresión determinado a las instancias de una clase. Se pueden definir tres tipos de
operadores: operadores unarios, operadores binarios y operadores de conversión. Todos
los operadores se deben declarar como public y static .

La clase MyList<T> declara dos operadores, operator == y operator != . Los operadores

de reemplazo proporcionan un nuevo significado a expresiones que aplican esos
operadores a instancias MyList . En concreto, los operadores definen la igualdad de dos
instancias MyList<T> como la comparación de cada uno de los objetos contenidos con
sus métodos Equals . En el ejemplo siguiente se usa el operador == para comparar dos
instancias MyList<int> .

C#

MyList<int> a = new();

a.Add(1);

a.Add(2);

MyList<int> b = new();

b.Add(1);

b.Add(2);

Console.WriteLine(a == b); // Outputs "True"

b.Add(3);

Console.WriteLine(a == b); // Outputs "False"

El primer objeto Console.WriteLine genera True porque las dos listas contienen el
mismo número de objetos con los mismos valores en el mismo orden. Si MyList<T> no
hubiera definido operator == , el primer objeto Console.WriteLine habría generado
False porque a y b hacen referencia a diferentes instancias de MyList<int> .

Finalizadores
Un finalizador es un miembro que implementa las acciones necesarias para finalizar una
instancia de una clase. Normalmente, se necesita un finalizador para liberar los recursos
no administrados. Los finalizadores no pueden tener parámetros, no pueden tener
modificadores de accesibilidad y no se pueden invocar de forma explícita. El finalizador
de una instancia se invoca automáticamente durante la recolección de elementos no
utilizados. Para obtener más información, vea el artículo sobre finalizadores.

El recolector de elementos no utilizados tiene una amplia libertad para decidir cuándo
debe recolectar objetos y ejecutar finalizadores. En concreto, los intervalos de las
invocaciones de finalizador no son deterministas y los finalizadores se pueden ejecutar
en cualquier subproceso. Por estas y otras razones, las clases deben implementar
finalizadores solo cuando no haya otras soluciones que sean factibles.
La instrucción using proporciona un mejor enfoque para la destrucción de objetos.

Expresiones
Las expresiones se construyen con operandos y operadores. Los operadores de una
expresión indican qué operaciones se aplican a los operandos. Ejemplos de operadores
incluyen + , - , * , / y new . Algunos ejemplos de operandos son literales, campos,
variables locales y expresiones.

Cuando una expresión contiene varios operadores, su precedencia controla el orden en

el que se evalúan los operadores individuales. Por ejemplo, la expresión x + y * z se
evalúa como x + (y * z) porque el operador * tiene mayor precedencia que el
operador + .

Cuando un operando se encuentra entre dos operadores con la misma precedencia, la

asociatividad de los operadores controla el orden en que se realizan las operaciones:

Excepto los operadores de asignación y los operadores de fusión de NULL, todos

los operadores binarios son asociativos a la izquierda, lo que significa que las
operaciones se realizan de izquierda a derecha. Por ejemplo, x + y + z se evalúa
como (x + y) + z .
Los operadores de asignación, los operadores de fusión de NULL ?? y ??= y el
operador condicional ?: son asociativos a la derecha, lo que significa que las
operaciones se realizan de derecha a izquierda. Por ejemplo, x = y = z se evalúa
como x = (y = z) .

La precedencia y la asociatividad pueden controlarse mediante paréntesis. Por ejemplo,

x + y * z primero multiplica y por z y luego suma el resultado a x , pero (x + y) * z

primero suma x y y y luego multiplica el resultado por z .

La mayoría de los operadores se pueden sobrecargar. La sobrecarga de operador

permite la especificación de implementaciones de operadores definidas por el usuario
para operaciones donde uno o ambos operandos son de un tipo de struct o una clase
definidos por el usuario.

C# ofrece operadores para realizar operaciones aritméticas, lógicas, de desplazamiento

y bit a bit, además de comparaciones de igualdad y de orden.

Para obtener la lista completa de los operadores de C# ordenados por nivel de

prioridad, vea Operadores de C#.
Instrucciones
Las acciones de un programa se expresan mediante instrucciones. C# admite varios tipos
de instrucciones diferentes, varias de las cuales se definen en términos de instrucciones
insertadas.

Un bloque permite que se escriban varias instrucciones en contextos donde se

permite una única instrucción. Un bloque se compone de una lista de instrucciones
escritas entre los delimitadores { y } .
Las instrucciones de declaración se usan para declarar variables locales y
constantes.
Las instrucciones de expresión se usan para evaluar expresiones. Las expresiones
que pueden usarse como instrucciones incluyen invocaciones de método,
asignaciones de objetos mediante el operador new , asignaciones mediante = y los
operadores de asignación compuestos, operaciones de incremento y decremento
mediante los operadores ++ y -- y expresiones await .
Las instrucciones de selección se usan para seleccionar una de varias instrucciones
posibles para su ejecución en función del valor de alguna expresión. Este grupo
contiene las instrucciones if y switch .
Las instrucciones de iteración se usan para ejecutar una instrucción insertada de
forma repetida. Este grupo contiene las instrucciones while , do , for y foreach .
Las instrucciones de salto se usan para transferir el control. Este grupo contiene las
instrucciones break , continue , goto , throw , return y yield .
La instrucción try ... catch se usa para detectar excepciones que se producen
durante la ejecución de un bloque, y la instrucción try ... finally se usa para
especificar el código de finalización que siempre se ejecuta, tanto si se ha
producido una excepción como si no.
Las instrucciones checked y unchecked sirven para controlar el contexto de
comprobación de desbordamiento para conversiones y operaciones aritméticas de
tipo integral.
La instrucción lock se usa para obtener el bloqueo de exclusión mutua para un
objeto determinado, ejecutar una instrucción y, luego, liberar el bloqueo.
La instrucción using se usa para obtener un recurso, ejecutar una instrucción y,
luego, eliminar dicho recurso.

A continuación se enumeran los tipos de instrucciones que se pueden usar:

Declaración de variable local

Declaración de constante local
Instrucción de expresión
Instrucción if
 Instrucción switch
Instrucción while
Instrucción do
Instrucción for
Instrucción foreach
Instrucción break
Instrucción continue
Instrucción goto
Instrucción return
Instrucción yield
Instrucciones throw y try
Instrucciones checked y unchecked
Instrucción lock
Instrucción using

Anterior Siguiente
Áreas de lenguaje principales de C#
Artículo • 18/01/2023 • Tiempo de lectura: 10 minutos

En este artículo se presentan las características principales del lenguaje C#.

Matrices, colecciones y LINQ

C# y .NET proporcionan muchos tipos de colecciones diferentes. Las matrices tienen una
sintaxis definida por el lenguaje. Los tipos de colecciones genéricos se enumeran en el
espacio de nombres System.Collections.Generic. Las colecciones especializadas incluyen
System.Span<T> para acceder a la memoria continua en el marco de pila, así como
System.Memory<T> para acceder a la memoria continua en el montón administrado.
Todas las colecciones, incluidas las matrices, Span<T> y Memory<T>, comparten un
principio unificador para la iteración. Puede usar la interfaz
System.Collections.Generic.IEnumerable<T>. Este principio unificador implica que
cualquiera de los tipos de colecciones se puede usar con consultas LINQ u otros
algoritmos. Los métodos se escriben mediante IEnumerable<T>, y esos algoritmos
funcionan con cualquier colección.

Matrices
Una matriz es una estructura de datos que contiene un número de variables a las que se
accede mediante índices calculados. Las variables contenidas en una matriz,
denominadas también elementos de la matriz, son todas del mismo tipo. Este tipo se
denomina tipo de elemento de la matriz.

Los tipos de matriz son tipos de referencia, y la declaración de una variable de matriz
simplemente establece un espacio reservado para una referencia a una instancia de
matriz. Las instancias de matriz reales se crean dinámicamente en tiempo de ejecución
mediante el operador new . La operación new especifica la longitud de la nueva instancia
de matriz, que luego se fija para la vigencia de la instancia. Los índices de los elementos
de una matriz van de 0 a Length - 1 . El operador new inicializa automáticamente los
elementos de una matriz a su valor predeterminado, que, por ejemplo, es cero para
todos los tipos numéricos y null para todos los tipos de referencias.

En el ejemplo siguiente se crea una matriz de elementos int , se inicializa y se imprime

su contenido.

C#
 int[] a = new int[10];

for (int i = 0; i < a.Length; i++)

a[i] = i * i;

for (int i = 0; i < a.Length; i++)

Console.WriteLine($"a[{i}] = {a[i]}");

Este ejemplo crea una matriz unidimensional y opera en ella. C# también admite
matrices multidimensionales. El número de dimensiones de un tipo de matriz, conocido
también como _clasificación del tipo de matriz, es uno más el número de comas entre
los corchetes del tipo de matriz. En el ejemplo siguiente se asignan una matriz
unidimensional, bidimensional y tridimensional, respectivamente.

C#

int[] a1 = new int[10];

int[,] a2 = new int[10, 5];

int[,,] a3 = new int[10, 5, 2];

La matriz a1 contiene 10 elementos, la matriz a2 50 (10 × 5) elementos y la matriz a3

100 (10 × 5 × 2) elementos.
El tipo de elemento de una matriz puede ser cualquiera,
incluido un tipo de matriz. Una matriz con elementos de un tipo de matriz a veces se
conoce como matriz escalonada porque las longitudes de las matrices de elementos no
tienen que ser iguales. En el ejemplo siguiente se asigna una matriz de matrices de int :

C#

int[][] a = new int[3][];

a[0] = new int[10];

a[1] = new int[5];

a[2] = new int[20];

La primera línea crea una matriz con tres elementos, cada uno de tipo int[] y cada uno
con un valor inicial de null . Las líneas siguientes inicializan entonces los tres elementos
con referencias a instancias de matriz individuales de longitud variable.

El operador new permite especificar los valores iniciales de los elementos de matriz
mediante un inicializador de matriz, que es una lista de las expresiones escritas entre
los delimitadores { y } . En el ejemplo siguiente se asigna e inicializa un tipo int[] con
tres elementos.
 C#

int[] a = new int[] { 1, 2, 3 };

La longitud de la matriz se deduce del número de expresiones entre { y } . La

inicialización de la matriz se puede acortar aún más, de modo que no sea necesario
reformular el tipo de matriz.

C#

int[] a = { 1, 2, 3 };

Los dos ejemplos anteriores son equivalentes al código siguiente:

C#

int[] t = new int[3];

t[0] = 1;

t[1] = 2;

t[2] = 3;

int[] a = t;

La instrucción foreach se puede utilizar para enumerar los elementos de cualquier

colección. El código siguiente numera la matriz del ejemplo anterior:

C#

foreach (int item in a)

Console.WriteLine(item);

La instrucción foreach utiliza la interfaz IEnumerable<T>, por lo que puede trabajar con
cualquier colección.

Interpolación de cadenas
La interpolación de cadenas de C# le permite dar formato a las cadenas mediante la
definición de expresiones cuyos resultados se colocan en una cadena de formato. Por
ejemplo, en el ejemplo siguiente se imprime la temperatura de un día determinado a
partir de un conjunto de datos meteorológicos:

C#
 Console.WriteLine($"The low and high temperature on {weatherData.Date:MM-dd-
yyyy}");

Console.WriteLine($" was {weatherData.LowTemp} and

{weatherData.HighTemp}.");

// Output (similar to):

// The low and high temperature on 08-11-2020

// was 5 and 30.

Una cadena interpolada se declara mediante el token $ . La interpolación de cadenas

evalúa las expresiones entre { y } , convierte el resultado en un elemento string y
reemplaza el texto entre corchetes por el resultado de cadena de la expresión. El
elemento : presente en la primera expresión, {weatherData.Date:MM-dd-yyyy} ,
especifica la cadena de formato. En el ejemplo anterior, especifica que la fecha debe
imprimirse en formato "MM-dd-aaaa".

Detección de patrones
El lenguaje C# proporciona expresiones de coincidencia de patrones para consultar el
estado de un objeto y ejecutar código basado en dicho estado. Puede inspeccionar los
tipos y los valores de las propiedades y los campos para determinar qué acción se debe
realizar. También puede inspeccionar los elementos de una lista o matriz. La expresión
switch es la expresión primaria para la coincidencia de patrones.

Delegados y expresiones lambda

Un tipo de delegado representa las referencias a métodos con una lista de parámetros
determinada y un tipo de valor devuelto. Los delegados permiten tratar métodos como
entidades que se puedan asignar a variables y se puedan pasar como parámetros. Los
delegados son similares al concepto de punteros de función de otros lenguajes. A
diferencia de los punteros de función, los delegados están orientados a objetos y tienen
seguridad de tipos.

En el siguiente ejemplo se declara y usa un tipo de delegado denominado Function .

C#

delegate double Function(double x);

class Multiplier

double _factor;

public Multiplier(double factor) => _factor = factor;

 public double Multiply(double x) => x * _factor;

class DelegateExample

static double[] Apply(double[] a, Function f)

var result = new double[a.Length];

for (int i = 0; i < a.Length; i++) result[i] = f(a[i]);

return result;

public static void Main()

double[] a = { 0.0, 0.5, 1.0 };

double[] squares = Apply(a, (x) => x * x);

double[] sines = Apply(a, Math.Sin);

Multiplier m = new(2.0);

double[] doubles = Apply(a, m.Multiply);

Una instancia del tipo de delegado Function puede hacer referencia a cualquier método
que tome un argumento double y devuelva un valor double . El método Apply aplica un
elemento Function determinado a los elementos de double[] y devuelve double[] con
los resultados. En el método Main , Apply se usa para aplicar tres funciones diferentes a
un valor double[] .

Un delegado puede hacer referencia a una expresión lambda para crear una función
anónima (como (x) => x * x en el ejemplo anterior), un método estático (como
Math.Sin en el ejemplo anterior) o un método de instancia (como m.Multiply en el
ejemplo anterior). Un delegado que hace referencia a un método de instancia también
hace referencia a un objeto determinado y, cuando se invoca el método de instancia a
través del delegado, ese objeto se convierte en this en la invocación.

Los delegados también se pueden crear mediante funciones anónimas o expresiones

lambda, que son "métodos insertados" que se crean al declararlos. Las funciones
anónimas pueden ver las variables locales de los métodos adyacentes. En el ejemplo
siguiente no se crea una clase:

C#

double[] doubles = Apply(a, (double x) => x * 2.0);

Un delegado no conoce la clase del método al que hace referencia; de hecho, tampoco
tiene importancia. El método al que se hace referencia debe tener los mismos
parámetros y el mismo tipo de valor devuelto que el delegado.

async y await
C# admite programas asincrónicos con dos palabras clave: async y await . Puede
agregar el modificador async a una declaración de método para declarar que dicho
método es asincrónico. El operador await indica al compilador que espere de forma
asincrónica a que finalice un resultado. El control se devuelve al autor de la llamada, y el
método devuelve una estructura que administra el estado del trabajo asincrónico.
Normalmente, la estructura es un elemento System.Threading.Tasks.Task<TResult>, pero
puede ser cualquier tipo que admita el patrón awaiter. Estas características permiten
escribir código que se lee como su homólogo sincrónico, pero que se ejecuta de forma
asincrónica. Por ejemplo, el código siguiente descarga la página principal de
Microsoft Docs:

C#

public async Task<int> RetrieveDocsHomePage()

var client = new HttpClient();

byte[] content = await

client.GetByteArrayAsync("https://docs.microsoft.com/");

Console.WriteLine($"{nameof(RetrieveDocsHomePage)}: Finished
downloading.");

return content.Length;

En este pequeño ejemplo se muestran las características principales de la programación

asincrónica:

La declaración del método incluye el modificador async .

El cuerpo del método espera ( await ) a la devolución del método
GetByteArrayAsync .

El tipo especificado en la instrucción return coincide con el argumento de tipo de

la declaración Task<T> para el método. (Un método que devuelva Task usará
instrucciones return sin ningún argumento).

Atributos
Los tipos, los miembros y otras entidades en un programa de C # admiten
modificadores que controlan ciertos aspectos de su comportamiento. Por ejemplo, la
accesibilidad de un método se controla mediante los modificadores public , protected ,
internal y private . C # generaliza esta funcionalidad de manera que los tipos de
información declarativa definidos por el usuario se puedan adjuntar a las entidades del
programa y recuperarse en tiempo de ejecución. Los programas especifican esta
información declarativa mediante la definición y el uso de atributos.

En el ejemplo siguiente se declara un atributo HelpAttribute que se puede colocar en

entidades de programa para proporcionar vínculos a la documentación asociada.

C#

public class HelpAttribute : Attribute

string _url;

string _topic;

public HelpAttribute(string url) => _url = url;

public string Url => _url;

public string Topic

get => _topic;

set => _topic = value;

Todas las clases de atributos se derivan de la clase base Attribute proporcionada por la
biblioteca .NET. Los atributos se pueden aplicar proporcionando su nombre, junto con
cualquier argumento, entre corchetes, justo antes de la declaración asociada. Si el
nombre de un atributo termina en Attribute , esa parte del nombre se puede omitir
cuando se hace referencia al atributo. Por ejemplo, HelpAttribute se puede usar de la
manera siguiente.

C#

[Help("https://docs.microsoft.com/dotnet/csharp/tour-of-csharp/features")]

public class Widget

[Help("https://docs.microsoft.com/dotnet/csharp/tour-of-
csharp/features",

Topic = "Display")]
public void Display(string text) { }

En este ejemplo se adjunta un atributo HelpAttribute a la clase Widget . También se

agrega otro atributo HelpAttribute al método Display en la clase. Los constructores
públicos de una clase de atributos controlan la información que se debe proporcionar
cuando el atributo se adjunta a una entidad de programa. Se puede proporcionar
información adicional haciendo referencia a las propiedades públicas de lectura y
escritura de la clase de atributos (como la referencia a la propiedad Topic usada
anteriormente).

Los metadatos que definen atributos pueden leerse y manipularse en tiempo de

ejecución mediante reflexión. Cuando se solicita un atributo determinado mediante esta
técnica, se invoca el constructor de la clase de atributos con la información
proporcionada en el origen del programa. Se devuelve la instancia del atributo
resultante. Si se proporciona información adicional mediante propiedades, dichas
propiedades se establecen en los valores dados antes de devolver la instancia del
atributo.

El siguiente ejemplo de código demuestra cómo obtener las HelpAttribute instancias

asociadas a la clase Widget y su método Display .

C#

Type widgetType = typeof(Widget);

object[] widgetClassAttributes =
widgetType.GetCustomAttributes(typeof(HelpAttribute), false);

if (widgetClassAttributes.Length > 0)

HelpAttribute attr = (HelpAttribute)widgetClassAttributes[0];

Console.WriteLine($"Widget class help URL : {attr.Url} - Related topic :

{attr.Topic}");

System.Reflection.MethodInfo displayMethod =
widgetType.GetMethod(nameof(Widget.Display));

object[] displayMethodAttributes =
displayMethod.GetCustomAttributes(typeof(HelpAttribute), false);

if (displayMethodAttributes.Length > 0)

HelpAttribute attr = (HelpAttribute)displayMethodAttributes[0];

Console.WriteLine($"Display method help URL : {attr.Url} - Related topic

: {attr.Topic}");

Más información
Puede explorar más sobre C# con uno de nuestros tutoriales.

Anterior
Introducción a C#
Artículo • 10/02/2023 • Tiempo de lectura: 3 minutos

Le damos la bienvenida a los tutoriales de introducción a C#. Estas lecciones empiezan

con código interactivo que puede ejecutar en su explorador. Puede obtener información
sobre los conceptos básicos de C# en la serie de vídeos C# 101 antes de comenzar
estas lecciones interactivas.
https://docs.microsoft.com/shows/CSharp-101/What-is-C/player

En las primeras lecciones se explican los conceptos de C# con la utilización de pequeños

fragmentos de código. Aprenderá los datos básicos de la sintaxis de C# y cómo trabajar
con tipos de datos como cadenas, números y booleanos. Se trata de material totalmente
interactivo, que le permitirá empezar a escribir y ejecutar código en cuestión de
minutos. En las primeras lecciones se asume que no dispone de conocimientos previos
sobre programación o sobre el lenguaje C#.

Puede probar estos tutoriales en entornos diferentes. Los conceptos que aprenderá son
los mismos. La diferencia estará en el tipo de experiencia que elija:

En el explorador, en la plataforma de documentos: esta experiencia inserta una

ventana de código de C# ejecutable en las páginas de documentos. Deberá
escribir y ejecutar el código de C# en el explorador.
En la experiencia de Microsoft Learn: esta ruta de aprendizaje contiene varios
módulos en los que se exponen los conceptos básicos de C#.
En Jupyter desde Binder : puede experimentar con código de C# en un cuaderno
de Jupyter en Binder.
En el equipo local: una vez que haya explorado en línea, puede descargar el SDK
de .NET y compilar programas en su equipo.

Todos los tutoriales de introducción posteriores a la lección Hola mundo se encuentran

disponibles mediante la experiencia de explorador en línea o en el entorno de desarrollo
local. Al final de cada tutorial, decida si desea continuar con la siguiente lección en línea
o en su propia máquina. Hay vínculos que le ayudarán a configurar el entorno y
continuar con el siguiente tutorial en su máquina.

Hola mundo
En el tutorial Hola mundo, creará el programa de C# más básico. Explorará el tipo
string y cómo trabajar con texto. También puede usar la ruta de acceso en
Microsoft Learn o en Jupyter desde Binder .
Números en C#
En el tutorial Números en C#, obtendrá información sobre cómo se almacenan los
números en los equipos y cómo realizar cálculos con distintos tipos numéricos.
Conocerá los datos básicos sobre cómo realizar redondeos y cálculos matemáticos con
C#. Este tutorial también está disponible para ejecutarse localmente en su máquina.

En este tutorial se asume que ha completado la lección Hola mundo.

Bifurcaciones y bucles
En el tutorial Ramas y bucles se explican los datos básicos sobre la selección de
diferentes rutas de acceso de la ejecución del código en función de los valores
almacenados en variables. Aprenderá los datos básicos del flujo de control, es decir,
cómo los programas toman decisiones y eligen distintas acciones. Este tutorial también
está disponible para ejecutarse localmente en su máquina.

En este tutorial se asume que ha completado las lecciones Hola mundo y Números en
C#.

Colección de listas
En la lección Colección de listas se ofrece información general sobre el tipo de colección
de listas que almacena secuencias de datos. Se explica cómo agregar y quitar
elementos, buscarlos y ordenar las listas. Explorará los diferentes tipos de listas. Este
tutorial también está disponible para ejecutarse localmente en su máquina.

En este tutorial se asume que ha completado las lecciones que se muestran

anteriormente.

101 ejemplos de LINQ
Este ejemplo requiere la herramienta global dotnet-try . Una vez que instale la
herramienta y clone el repositorio try-samples , puede aprender Language Integrated
Query (LINQ) mediante un conjunto de 101 ejemplos que puede ejecutar de forma
interactiva. Puede descubrir diferentes maneras de consultar, explorar y transformar
secuencias de datos.
Configuración de un entorno local
Artículo • 22/09/2022 • Tiempo de lectura: 2 minutos

El primer paso en la ejecución de un tutorial en el equipo es configurar un entorno de

desarrollo. Pruebe una de las siguientes alternativas:

Para usar la CLI de .NET y su elección de texto o editor de código, consulte el

tutorial de .NET Hola mundo en 10 minutos . En este tutorial se incluyen
instrucciones para configurar un entorno de desarrollo en Windows, Linux o
macOS.
Para usar la CLI de .NET y Visual Studio Code, instale el SDK de .NET y
Visual Studio Code .
Para usar Visual Studio 2019, consulte Tutorial: Cree una aplicación de consola de
C# sencilla en Visual Studio.

Flujo de desarrollo de aplicaciones básico

Las instrucciones de estos tutoriales asumen que está usando la CLI de .NET para crear,
compilar y ejecutar aplicaciones. Usará los comandos siguientes:

dotnet new crea una aplicación. Este comando genera los archivos y los recursos
necesarios para la aplicación. Los tutoriales de introducción a C# usan el tipo de
aplicación console . Cuando conozca los conceptos básicos, puede expandirlo a
otros tipos de aplicaciones.
dotnet build compila el archivo ejecutable.
dotnet run ejecuta el archivo ejecutable.

Si usa Visual Studio 2019 para estos tutoriales, elegirá una selección de menú de

Visual Studio cuando un tutorial le indique que ejecute uno de estos comandos de la
CLI:

Archivo>Nuevo>Proyecto crea una aplicación.

Se recomienda la plantilla de proyecto Console Application .
Se le ofrecerá la posibilidad de especificar una plataforma de destino. Los
tutoriales siguientes funcionan mejor cuando el destino es .NET 5 o versiones
posteriores.
Compilar>Compilar solución crea el arcivo ejecutable.
Depurar>Iniciar sin depurar ejecuta el archivo ejecutable.

Elección del tutorial

Puede empezar con cualquiera de los siguientes tutoriales:

Números en C#
En el tutorial Números en C#, obtendrá información sobre cómo se almacenan los
números en los equipos y cómo realizar cálculos con distintos tipos numéricos.
Conocerá los datos básicos sobre cómo realizar redondeos y cálculos matemáticos con
C#.

En este tutorial se asume que ha completado la lección Hola mundo.

Bifurcaciones y bucles
En el tutorial Ramas y bucles se explican los datos básicos sobre la selección de
diferentes rutas de acceso de la ejecución del código en función de los valores
almacenados en variables. Aprenderá los datos básicos del flujo de control, es decir,
cómo los programas toman decisiones y eligen distintas acciones.

En este tutorial se supone que ha completado las lecciones Hola mundo y Números en
C#.

Colección de listas
En la lección Colección de listas se ofrece información general sobre el tipo de colección
de listas que almacena secuencias de datos. Se explica cómo agregar y quitar
elementos, buscarlos y ordenar las listas. Explorará los diferentes tipos de listas.

En este tutorial se presupone que ha completado las lecciones que se muestran

anteriormente.
Uso de números enteros y de punto
flotante en C#
Artículo • 29/09/2022 • Tiempo de lectura: 10 minutos

En este tutorial se explican los tipos numéricos en C#. Escribirá pequeñas cantidades de
código y luego compilará y ejecutará ese código. El tutorial contiene una serie de
lecciones que ofrecen información detallada sobre los números y las operaciones
matemáticas en C#. En ellas se enseñan los aspectos básicos del lenguaje C#.

Requisitos previos
En el tutorial se espera que tenga una máquina configurada para el desarrollo local.
Consulte Configuración del entorno local para obtener instrucciones de instalación e
información general sobre el desarrollo de aplicaciones en .NET.

Si no quiere configurar un entorno local, consulte la versión interactiva en el explorador

de este tutorial.

Análisis de las operaciones matemáticas con

enteros
Cree un directorio denominado numbers-quickstart. Conviértalo en el directorio actual y
ejecute el siguiente comando:

CLI de .NET

dotnet new console -n NumbersInCSharp -o .

） Importante

Las plantillas de C# para .NET 6 usan instrucciones de nivel superior. Es posible que
la aplicación no coincida con el código de este artículo si ya ha actualizado a
.NET 6. Para obtener más información, consulte el artículo Las nuevas plantillas de
C# generan instrucciones de nivel superior.

El SDK de .NET 6 también agrega un conjunto de directivas implícitas global using

para proyectos que usan los SDK siguientes:

Microsoft.NET.Sdk
 Microsoft.NET.Sdk.Web
Microsoft.NET.Sdk.Worker

Estas directivas de global using implícitas incluyen los espacios de nombres más
comunes para el tipo de proyecto.

Abra Program.cs en su editor favorito y reemplace el contenido del archivo por el

código siguiente:

C#

int a = 18;

int b = 6;

int c = a + b;

Console.WriteLine(c);

Ejecute este código escribiendo dotnet run en la ventana de comandos.

Ha visto una de las operaciones matemáticas fundamentales con enteros. El tipo int
representa un entero, que puede ser cero o un número entero positivo o negativo. Use
el símbolo + para la suma. Otros operadores matemáticos comunes con enteros son:

- para resta

* para multiplicación
/ para división

Comience por explorar esas operaciones diferentes. Agregue estas líneas después de la
línea que escribe el valor de c :

C#

// subtraction

c = a - b;

Console.WriteLine(c);

// multiplication

c = a * b;

Console.WriteLine(c);

// division

c = a / b;

Console.WriteLine(c);

Ejecute este código escribiendo dotnet run en la ventana de comandos.

Si quiere, también puede probar a escribir varias operaciones matemáticas en la misma
línea. Pruebe c = a + b - 12 * 17; por ejemplo. Se permite la combinación de
variables y números constantes.

 Sugerencia

Cuando explore C# o cualquier otro lenguaje de programación, cometerá errores al

escribir código. El compilador buscará dichos errores y los notificará. Si la salida
contiene mensajes de error, revise detenidamente el código de ejemplo y el código
de la ventana para saber qué debe corregir. Este ejercicio le ayudará a aprender la
estructura del código de C#.

Ha terminado el primer paso. Antes comenzar con la siguiente sección, se va a mover el

código actual a un método independiente. Un método es una serie de instrucciones
agrupadas a la que se ha puesto un nombre. Llame a un método escribiendo el nombre
del método seguido de () . La organización del código en métodos facilita empezar a
trabajar con un ejemplo nuevo. Cuando termine, el código debe tener un aspecto
similar al siguiente:

C#

WorkWithIntegers();

void WorkWithIntegers()
{

int a = 18;

int b = 6;

int c = a + b;

Console.WriteLine(c);

// subtraction

c = a - b;

Console.WriteLine(c);

// multiplication

c = a * b;

Console.WriteLine(c);

// division

c = a / b;

Console.WriteLine(c);

La línea WorkWithIntegers(); invoca el método. El código siguiente declara el método y

lo define.
Análisis sobre el orden de las operaciones
Convierta en comentario la llamada a WorkingWithIntegers() . De este modo la salida
estará menos saturada a medida que trabaje en esta sección:

C#

//WorkWithIntegers();

El // inicia un comentario en C#. Los comentarios son cualquier texto que desea
mantener en el código fuente pero que no se ejecuta como código. El compilador no
genera ningún código ejecutable a partir de comentarios. Dado que WorkWithIntegers()
es un método, solo tiene que comentar una línea.

El lenguaje C# define la prioridad de las diferentes operaciones matemáticas con reglas

compatibles con las reglas aprendidas en las operaciones matemáticas. La multiplicación
y división tienen prioridad sobre la suma y resta. Explórelo mediante la adición del
código siguiente tras la llamada a dotnet run y la ejecución de WorkWithIntegers() :

C#

int a = 5;

int b = 4;

int c = 2;

int d = a + b * c;

Console.WriteLine(d);

La salida muestra que la multiplicación se realiza antes que la suma.

Puede forzar la ejecución de un orden diferente de las operaciones si la operación o las

operaciones que realizó primero se incluyen entre paréntesis. Agregue las líneas
siguientes y ejecute de nuevo:

C#

d = (a + b) * c;

Console.WriteLine(d);

Combine muchas operaciones distintas para indagar más. Agregue algo similar a las
líneas siguientes. Pruebe dotnet run de nuevo.

C#
 d = (a + b) - 6 * c + (12 * 4) / 3 + 12;

Console.WriteLine(d);

Puede que haya observado un comportamiento interesante de los enteros. La división

de enteros siempre genera un entero como resultado, incluso cuando se espera que el
resultado incluya un decimal o una parte de una fracción.

Si no ha observado este comportamiento, pruebe este código:

C#

int e = 7;

int f = 4;

int g = 3;

int h = (e + f) / g;

Console.WriteLine(h);

Escriba dotnet run de nuevo para ver los resultados.

Antes de continuar, vamos a tomar todo el código que ha escrito en esta sección y a
colocarlo en un nuevo método. Llame a ese nuevo método OrderPrecedence . El código
debería tener este aspecto:

C#

// WorkWithIntegers();

OrderPrecedence();

void WorkWithIntegers()
{

int a = 18;

int b = 6;

int c = a + b;

Console.WriteLine(c);

// subtraction

c = a - b;

Console.WriteLine(c);

// multiplication

c = a * b;

Console.WriteLine(c);

// division

c = a / b;

Console.WriteLine(c);

 void OrderPrecedence()

int a = 5;

int b = 4;

int c = 2;

int d = a + b * c;

Console.WriteLine(d);

d = (a + b) * c;

Console.WriteLine(d);

d = (a + b) - 6 * c + (12 * 4) / 3 + 12;

Console.WriteLine(d);

int e = 7;

int f = 4;

int g = 3;

int h = (e + f) / g;

Console.WriteLine(h);

Información sobre los límites y la precisión de

los enteros
En el último ejemplo se ha mostrado que la división de enteros trunca el resultado.
Puede obtener el resto con el operador de módulo, el carácter % . Pruebe el código
siguiente tras la llamada de método a OrderPrecedence() :

C#

int a = 7;

int b = 4;

int c = 3;

int d = (a + b) / c;

int e = (a + b) % c;

Console.WriteLine($"quotient: {d}");

Console.WriteLine($"remainder: {e}");

El tipo de entero de C# difiere de los enteros matemáticos en un aspecto: el tipo int

tiene límites mínimo y máximo. Agregue este código para ver esos límites:

C#

int max = int.MaxValue;

int min = int.MinValue;
Console.WriteLine($"The range of integers is {min} to {max}");

Si un cálculo genera un valor que supera los límites, se producirá una condición de
subdesbordamiento o desbordamiento. La respuesta parece ajustarse de un límite al
otro. Agregue estas dos líneas para ver un ejemplo:

C#

int what = max + 3;

Console.WriteLine($"An example of overflow: {what}");

Tenga en cuenta que la respuesta está muy próxima al entero mínimo (negativo). Es lo
mismo que min + 2 . La operación de suma desbordó los valores permitidos para los
enteros. La respuesta es un número negativo muy grande porque un desbordamiento
"se ajusta" desde el valor de entero más alto posible al más bajo.

Hay otros tipos numéricos con distintos límites y precisiones que podría usar si el tipo
int no satisface sus necesidades. Vamos a explorar ahora esos otros tipos. Antes de
comenzar la siguiente sección, mueva el código que escribió en esta sección a un
método independiente. Denomínelo TestLimits .

Operaciones con el tipo double

El tipo numérico double representa números de punto flotante de doble precisión.
Puede que no esté familiarizado con estos términos. Un número de punto flotante
resulta útil para representar números no enteros cuya magnitud puede ser muy grande
o pequeña. La precisión doble es un término relativo que describe el número de dígitos
binarios que se usan para almacenar el valor. Los números de precisión doble tienen el
doble del número de dígitos binarios que la precisión sencilla. En los equipos
modernos, es más habitual usar números con precisión doble que con precisión sencilla.
Los números de precisión sencilla se declaran mediante la palabra clave float .
Comencemos a explorar. Agregue el siguiente código y observe el resultado:

C#

double a = 5;

double b = 4;

double c = 2;

double d = (a + b) / c;

Console.WriteLine(d);

Tenga en cuenta que la respuesta incluye la parte decimal del cociente. Pruebe una
expresión algo más complicada con tipos double:

C#
 double e = 19;

double f = 23;

double g = 8;

double h = (e + f) / g;

Console.WriteLine(h);

El intervalo de un valor double es mucho más amplio que en el caso de los valores
enteros. Pruebe el código siguiente debajo del que ha escrito hasta ahora:

C#

double max = double.MaxValue;

double min = double.MinValue;

Console.WriteLine($"The range of double is {min} to {max}");

Estos valores se imprimen en notación científica. El número a la izquierda de E es la

mantisa. El número a la derecha es el exponente, como una potencia de diez. Al igual
que sucede con los números decimales en las operaciones matemáticas, los tipos
double en C# pueden presentar errores de redondeo. Pruebe este código:

C#

double third = 1.0 / 3.0;

Console.WriteLine(third);

Sabe que la repetición de 0.3 un número finito de veces no es exactamente lo mismo

que 1/3 .

Desafío

Pruebe otros cálculos con números grandes, números pequeños, multiplicaciones y

divisiones con el tipo double . Intente realizar cálculos más complicados. Una vez que
haya invertido un tiempo en ello, tome el código que ha escrito y colóquelo en un
nuevo método. Ponga a ese nuevo método el nombre WorkWithDoubles .

Trabajo con tipos decimales

Hasta el momento ha visto los tipos numéricos básicos en C#: los tipos integer y double.
Pero hay otro tipo más que debe conocer: decimal . El tipo decimal tiene un intervalo
más pequeño, pero mayor precisión que double . Observemos lo siguiente:

C#
 decimal min = decimal.MinValue;

decimal max = decimal.MaxValue;

Console.WriteLine($"The range of the decimal type is {min} to {max}");

Tenga en cuenta que el intervalo es más pequeño que con el tipo double . Puede
observar una precisión mayor con el tipo decimal si prueba el siguiente código:

C#

double a = 1.0;

double b = 3.0;

Console.WriteLine(a / b);

decimal c = 1.0M;

decimal d = 3.0M;

Console.WriteLine(c / d);

El sufijo M en los números es la forma de indicar que una constante debe usar el tipo
decimal . De no ser así, el compilador asume el tipo de double .

７ Nota

La letra M se eligió como la letra más distintiva visualmente entre las palabras clave
double y decimal .

Observe que la expresión matemática con el tipo decimal tiene más dígitos a la derecha
del punto decimal.

Desafío

Ahora que ya conoce los diferentes tipos numéricos, escriba código para calcular el área
de un círculo cuyo radio sea de 2,50 centímetros. Recuerde que el área de un circulo es
igual al valor de su radio elevado al cuadrado multiplicado por Pi. Sugerencia: .NET
contiene una constante de Pi, Math.PI, que puede usar para ese valor. Math.PI, al igual
que todas las constantes declaradas en el espacio de nombres System.Math , es un valor
double . Por ese motivo, debe usar double en lugar de valores decimal para este desafío.

Debe obtener una respuesta entre 19 y 20. Puede comprobar la respuesta si consulta el
ejemplo de código terminado en GitHub .

Si lo desea, pruebe con otras fórmulas.

Ha completado el inicio rápido "Números en C#". Puede continuar con la guía de inicio
rápido Ramas y bucles en su propio entorno de desarrollo.

En estos temas encontrará más información sobre los números en C#:

Tipos numéricos integrales

Tipos numéricos de punto flotante
Conversiones numéricas integradas
Instrucciones y bucles de C# if : tutorial
de lógica condicional
Artículo • 28/11/2022 • Tiempo de lectura: 10 minutos

En este tutorial se enseña a escribir código de C# que analiza variables y cambia la ruta
de acceso de ejecución en función de dichas variables. Escriba código de C# y vea los
resultados de la compilación y la ejecución. El tutorial contiene una serie de lecciones en
las que se analizan las construcciones de bifurcaciones y bucles en C#. En ellas se
enseñan los aspectos básicos del lenguaje C#.

 Sugerencia

Para pegar un fragmento de código dentro del modo de enfoque , debe usar el
método abreviado de teclado ( Ctrl + v o cmd + v ).

Requisitos previos
En el tutorial se espera que tenga una máquina configurada para el desarrollo local.
Consulte Configuración del entorno local para obtener instrucciones de instalación e
información general sobre el desarrollo de aplicaciones en .NET.

Si prefiere ejecutar el código sin tener que configurar un entorno local, consulte la
versión interactiva en el explorador de este tutorial.

Toma de decisiones con la instrucción if .

Cree un directorio denominado branches-tutorial. Conviértalo en el directorio actual y
ejecute el siguiente comando:

CLI de .NET

dotnet new console -n BranchesAndLoops -o .

） Importante

Las plantillas de C# para .NET 6 usan instrucciones de nivel superior. Es posible que
la aplicación no coincida con el código de este artículo si ya ha actualizado a
 .NET 6. Para obtener más información, consulte el artículo Las nuevas plantillas de
C# generan instrucciones de nivel superior.

El SDK de .NET 6 también agrega un conjunto de directivas implícitas global using

para proyectos que usan los SDK siguientes:

Microsoft.NET.Sdk
Microsoft.NET.Sdk.Web
Microsoft.NET.Sdk.Worker

Estas directivas de global using implícitas incluyen los espacios de nombres más
comunes para el tipo de proyecto.

Este comando crea una nueva aplicación de consola de .NET en el directorio actual. Abra
Program.cs en su editor favorito y reemplace el contenido por el código siguiente:

C#

int a = 5;

int b = 6;

if (a + b > 10)

Console.WriteLine("The answer is greater than 10.");

Pruebe este código escribiendo dotnet run en la ventana de la consola. Debería ver el
mensaje "La respuesta es mayor que 10", impreso en la consola. Modifique la
declaración de b para que el resultado de la suma sea menor que diez:

C#

int b = 3;

Escriba dotnet run de nuevo. Como la respuesta es menor que diez, no se imprime
nada. La condición que está probando es false. No tiene ningún código para ejecutar
porque solo ha escrito una de las bifurcaciones posibles para una instrucción if : la
bifurcación true.

 Sugerencia

Cuando explore C# o cualquier otro lenguaje de programación, cometerá errores al

escribir código. El compilador buscará dichos errores y los notificará. Fíjese en la
salida de error y en el código que generó el error. El error del compilador
normalmente puede ayudarle a encontrar el problema.
En este primer ejemplo se muestran la potencia de if y los tipos booleanos. Un
booleano es una variable que puede tener uno de estos dos valores: true o false . C#
define un tipo especial bool para las variables booleanas. La instrucción if comprueba
el valor de bool . Cuando el valor es true , se ejecuta la instrucción que sigue a if . De lo
contrario, se omite. Este proceso de comprobación de condiciones y ejecución de
instrucciones en función de esas condiciones es muy eficaz.

Operaciones conjuntas con if y else

Para ejecutar un código distinto en las bifurcaciones true y false, cree una bifurcación
else para que se ejecute cuando la condición sea false. Pruebe una rama else . Agregue
las dos últimas líneas del código siguiente (ya debe tener los cuatro primeros):

C#

int a = 5;

int b = 3;

if (a + b > 10)

Console.WriteLine("The answer is greater than 10");

else

Console.WriteLine("The answer is not greater than 10");

La instrucción que sigue a la palabra clave else se ejecuta solo si la condición de

prueba es false . La combinación de if y else con condiciones booleanas ofrece toda
la eficacia necesaria para administrar una condición true y false simultáneamente.

） Importante

La sangría debajo de las instrucciones if y else se utiliza para los lectores

humanos. El lenguaje C# no considera significativos los espacios en blanco ni las
sangrías. La instrucción que sigue a la palabra clave if o else se ejecutará en
función de la condición. Todos los ejemplos de este tutorial siguen una práctica
común para aplicar sangría a las líneas en función del flujo de control de las
instrucciones.

Dado que la sangría no es significativa, debe usar { y } para indicar si desea que más
de una instrucción forme parte del bloque que se ejecuta de forma condicional. Los
programadores de C# suelen usar esas llaves en todas las cláusulas if y else . El
siguiente ejemplo es igual que el que acaba de crear. Modifique el código anterior para
que coincida con el código siguiente:
 C#

int a = 5;

int b = 3;

if (a + b > 10)

Console.WriteLine("The answer is greater than 10");

else

Console.WriteLine("The answer is not greater than 10");

 Sugerencia

En el resto de este tutorial, todos los ejemplos de código incluyen las llaves, según
las prácticas aceptadas.

Puede probar condiciones más complicadas. Agregue el código siguiente después del
que ha escrito hasta ahora:

C#

int c = 4;

if ((a + b + c > 10) && (a == b))

Console.WriteLine("The answer is greater than 10");

Console.WriteLine("And the first number is equal to the second");

else

Console.WriteLine("The answer is not greater than 10");

Console.WriteLine("Or the first number is not equal to the second");

El símbolo == prueba la igualdad. Usar == permite distinguir la prueba de igualdad de

la asignación, que verá en a = 5 .

&& representa "y". Significa que ambas condiciones deben cumplirse para ejecutar la

instrucción en la bifurcación true. En estos ejemplos también se muestra que puede

tener varias instrucciones en cada bifurcación condicional, siempre que las encierre
entre { y } . También puede usar || para representar "o". Agregue el código siguiente
antes del que ha escrito hasta ahora:

C#
 if ((a + b + c > 10) || (a == b))

Console.WriteLine("The answer is greater than 10");

Console.WriteLine("Or the first number is equal to the second");

else

Console.WriteLine("The answer is not greater than 10");

Console.WriteLine("And the first number is not equal to the second");

Modifique los valores de a , b y c y cambie entre && y || para explorar. Obtendrá más
conocimientos sobre el funcionamiento de los operadores && y || .

Ha terminado el primer paso. Antes comenzar con la siguiente sección, se va a mover el

código actual a un método independiente. Con este paso, resulta más fácil empezar con
un nuevo ejemplo. Coloque el código existente en un método denominado
ExploreIf() . Llámelo desde la parte superior del programa. Cuando termine, el código
debe tener un aspecto similar al siguiente:

C#

ExploreIf();

void ExploreIf()

int a = 5;

int b = 3;

if (a + b > 10)

Console.WriteLine("The answer is greater than 10");

else

Console.WriteLine("The answer is not greater than 10");

int c = 4;

if ((a + b + c > 10) && (a > b))

Console.WriteLine("The answer is greater than 10");

Console.WriteLine("And the first number is greater than the

second");

else

Console.WriteLine("The answer is not greater than 10");

Console.WriteLine("Or the first number is not greater than the

second");

 if ((a + b + c > 10) || (a > b))

Console.WriteLine("The answer is greater than 10");

Console.WriteLine("Or the first number is greater than the second");

else

Console.WriteLine("The answer is not greater than 10");

Console.WriteLine("And the first number is not greater than the

second");

Convierta en comentario la llamada a ExploreIf() . De este modo la salida estará menos

saturada a medida que trabaje en esta sección:

C#

//ExploreIf();

El // inicia un comentario en C#. Los comentarios son cualquier texto que desea
mantener en el código fuente pero que no se ejecuta como código. El compilador no
genera ningún código ejecutable a partir de comentarios.

Uso de bucles para repetir las operaciones

En esta sección se usan bucles para repetir las instrucciones. Agregue este código
después de la llamada a ExploreIf :

C#

int counter = 0;

while (counter < 10)

Console.WriteLine($"Hello World! The counter is {counter}");

counter++;

La instrucción while comprueba una condición y ejecuta la instrucción o el bloque de

instrucciones que aparece después de while . Comprueba repetidamente la condición,
ejecutando esas instrucciones hasta que la condición sea false.

En este ejemplo aparece otro operador nuevo. El código ++ que aparece después de la
variable counter es el operador de incremento. Suma un valor de uno al valor de
counter y almacena dicho valor en la variable de counter .

） Importante

Asegúrese de que la condición del bucle while cambia a false mientras ejecuta el
código. En caso contrario, se crea un bucle infinito donde nunca finaliza el
programa. Esto no está demostrado en este ejemplo, ya que tendrá que forzar al
programa a cerrar mediante CTRL-C u otros medios.

El bucle while prueba la condición antes de ejecutar el código que sigue a while . El
bucle do ... while primero ejecuta el código y después comprueba la condición. El bucle
do while se muestra en el código siguiente:

C#

int counter = 0;

do

Console.WriteLine($"Hello World! The counter is {counter}");

counter++;

} while (counter < 10);

Este bucle do y el bucle while anterior generan el mismo resultado.

Operaciones con el bucle for

El bucle for se utiliza con frecuencia en C#. Pruebe este código:

C#

for (int index = 0; index < 10; index++)

Console.WriteLine($"Hello World! The index is {index}");

El código anterior funciona de la misma forma que los bucles while y do que ya ha
usado. La instrucción for consta de tres partes que controlan su funcionamiento.

La primera parte es el inicializador de for: int index = 0; declara que index es la

variable de bucle y establece su valor inicial en 0 .

La parte central es la condición de for: index < 10 declara que este bucle for debe
continuar ejecutándose mientras que el valor del contador sea menor que diez.
La última parte es el iterador de for: index++ especifica cómo modificar la variable de
bucle después de ejecutar el bloque que sigue a la instrucción for . En este caso,
especifica que index debe incrementarse en uno cada vez que el bloque se ejecuta.

Experimente usted mismo. Pruebe cada una de las siguientes variaciones:

Cambie el inicializador para que se inicie en un valor distinto.

Cambie la condición para que se detenga en un valor diferente.

Cuando haya terminado, escriba algo de código para practicar con lo que ha aprendido.

Hay otra instrucción de bucle que no se trata en este tutorial: la instrucción foreach . La
instrucción foreach repite su instrucción con cada elemento de una secuencia de
elementos. Se usa más a menudo con colecciones, por lo que se trata en el siguiente
tutorial.

Bucles anidados creados

Se puede anidar un bucle while , do o for dentro de otro para crear una matriz
mediante la combinación de cada elemento del bucle externo con cada elemento del
bucle interno. Vamos a crear un conjunto de pares alfanuméricos para representar filas y
columnas.

Un bucle for puede generar las filas:

C#

for (int row = 1; row < 11; row++)

Console.WriteLine($"The row is {row}");

Otro bucle puede generar las columnas:

C#

for (char column = 'a'; column < 'k'; column++)

Console.WriteLine($"The column is {column}");

Puede anidar un bucle dentro de otro para formar pares:

C#
 for (int row = 1; row < 11; row++)

for (char column = 'a'; column < 'k'; column++)

Console.WriteLine($"The cell is ({row}, {column})");

Puede ver que el bucle externo se incrementa una vez con cada ejecución completa del
bucle interno. Invierta el anidamiento de filas y columnas, y vea los cambios por sí
mismo. Cuando haya terminado, coloque el código de esta sección en un método
denominado ExploreLoops() .

Combinación de ramas y bucles

Ahora que ya ha obtenido la información sobre el bucle if y las construcciones de
bucles con el lenguaje C#, trate de escribir código de C# para obtener la suma de todos
los enteros de uno a veinte que se puedan dividir entre tres. Tenga en cuenta las
siguientes sugerencias:

El operador % proporciona el resto de una operación de división.

La instrucción if genera la condición para saber si un número debe formar parte
de la suma.
El bucle for puede facilitar la repetición de una serie de pasos para todos los
números comprendidos entre el uno y el veinte.

Pruébelo usted mismo. Después, revise cómo lo ha hecho. Debe obtener 63 como
respuesta. Puede ver una respuesta posible mediante la visualización del código
completado en GitHub .

Ha completado el tutorial "Bifurcaciones y bucles".

Puede continuar con el tutorial Matrices y colecciones en su propio entorno de

desarrollo.

Puede aprender más sobre estos conceptos en los artículos siguientes:

Instrucciones de selección
Instrucciones de iteración
Aprenda a administrar colecciones de
datos mediante List<T> en C#
Artículo • 07/03/2023 • Tiempo de lectura: 6 minutos

En este tutorial de presentación se proporciona una introducción al lenguaje C# y se

exponen los conceptos básicos de la clase List<T>.

Requisitos previos
En el tutorial se espera que tenga una máquina configurada para el desarrollo local.
Consulte Configuración del entorno local para obtener instrucciones de instalación e
información general sobre el desarrollo de aplicaciones en .NET.

Si prefiere ejecutar el código sin tener que configurar un entorno local, consulte la
versión interactiva en el explorador de este tutorial.

Un ejemplo de lista básico

Cree un directorio denominado list-tutorial. Conviértalo en el directorio actual y ejecute
dotnet new console .

） Importante

Las plantillas de C# para .NET 6 usan instrucciones de nivel superior. Es posible que
la aplicación no coincida con el código de este artículo si ya ha actualizado a
.NET 6. Para obtener más información, consulte el artículo Las nuevas plantillas de
C# generan instrucciones de nivel superior.

El SDK de .NET 6 también agrega un conjunto de directivas implícitas global using

para proyectos que usan los SDK siguientes:

Microsoft.NET.Sdk
Microsoft.NET.Sdk.Web
Microsoft.NET.Sdk.Worker

Estas directivas de global using implícitas incluyen los espacios de nombres más
comunes para el tipo de proyecto.

Abra Program.cs en su editor favorito y reemplace el código existente por el siguiente:

 C#

var names = new List<string> { "<name>", "Ana", "Felipe" };

foreach (var name in names)

Console.WriteLine($"Hello {name.ToUpper()}!");

Reemplace <name> por su propio nombre. Guarde Program.cs. Escriba dotnet run en la
ventana de la consola para probarlo.

Ha creado una lista de cadenas, ha agregado tres nombres a esa lista y ha impreso los
nombres en MAYÚSCULAS. Los conceptos aplicados ya se han aprendido en los
tutoriales anteriores para recorrer en bucle la lista.

El código para mostrar los nombres usa la característica interpolación de cadenas. Si un

valor de string va precedido del carácter $ , significa que puede insertar código de C#
en la declaración de cadena. La cadena real reemplaza a ese código de C# con el valor
que genera. En este ejemplo, reemplaza {name.ToUpper()} con cada nombre, convertido
a mayúsculas, porque se llama al método ToUpper.

Vamos a continuar indagando.

Modificación del contenido de las listas

La colección creada usa el tipo List<T>. Este tipo almacena las secuencias de elementos.
Especifique el tipo de los elementos entre corchetes angulares.

Un aspecto importante de este tipo List<T> es que se puede aumentar o reducir, lo que
permite agregar o quitar elementos. Agregue este código al final del programa:

C#

Console.WriteLine();

names.Add("Maria");

names.Add("Bill");

names.Remove("Ana");

foreach (var name in names)

Console.WriteLine($"Hello {name.ToUpper()}!");

Se han agregado dos nombres más al final de la lista. También se ha quitado uno.
Guarde el archivo y escriba dotnet run para probarlo.
List<T> también permite hacer referencia a elementos individuales a través del índice.
Coloque el índice entre los tokens [ y ] después del nombre de la lista. C# utiliza 0
para el primer índice. Agregue este código directamente después del código que acaba
de agregar y pruébelo:

C#

Console.WriteLine($"My name is {names[0]}");

Console.WriteLine($"I've added {names[2]} and {names[3]} to the list");

No se puede acceder a un índice si se coloca después del final de la lista. Recuerde que
los índices empiezan en 0, por lo que el índice más grande válido es uno menos que el
número de elementos de la lista. Puede comprobar durante cuánto tiempo la lista usa la
propiedad Count. Agregue el código siguiente al final del programa:

C#

Console.WriteLine($"The list has {names.Count} people in it");

Guarde el archivo y vuelva a escribir dotnet run para ver los resultados.

Búsqueda y orden en las listas

En los ejemplos se usan listas relativamente pequeñas, pero las aplicaciones a menudo
pueden crear listas que contengan muchos más elementos, en ocasiones, con una
numeración que engloba millares. Para encontrar elementos en estas colecciones más
grandes, debe buscar diferentes elementos en la lista. El método IndexOf busca un
elemento y devuelve su índice. Si el elemento no está en la lista, IndexOf devuelve -1 .
Agregue este código a la parte inferior del programa:

C#

var index = names.IndexOf("Felipe");

if (index == -1)

Console.WriteLine($"When an item is not found, IndexOf returns

{index}");

else

Console.WriteLine($"The name {names[index]} is at index {index}");

index = names.IndexOf("Not Found");

if (index == -1)

Console.WriteLine($"When an item is not found, IndexOf returns

{index}");

else

Console.WriteLine($"The name {names[index]} is at index {index}");

Los elementos de la lista también se pueden ordenar. El método Sort clasifica todos los
elementos de la lista en su orden normal (por orden alfabético si se trata de cadenas).
Agregue este código a la parte inferior del programa:

C#

names.Sort();

foreach (var name in names)

Console.WriteLine($"Hello {name.ToUpper()}!");

Guarde el archivo y escriba dotnet run para probar esta última versión.

Antes comenzar con la siguiente sección, se va a mover el código actual a un método

independiente. Con este paso, resulta más fácil empezar con un nuevo ejemplo.
Coloque todo el código que ha escrito en un nuevo método denominado
WorkWithStrings() . Llame a ese método en la parte superior del programa. Cuando

termine, el código debe tener un aspecto similar al siguiente:

C#

WorkWithStrings();

void WorkWithStrings()

var names = new List<string> { "<name>", "Ana", "Felipe" };

foreach (var name in names)

Console.WriteLine($"Hello {name.ToUpper()}!");

Console.WriteLine();

names.Add("Maria");

names.Add("Bill");

names.Remove("Ana");

foreach (var name in names)

Console.WriteLine($"Hello {name.ToUpper()}!");

Console.WriteLine($"My name is {names[0]}");

Console.WriteLine($"I've added {names[2]} and {names[3]} to the list");

Console.WriteLine($"The list has {names.Count} people in it");

var index = names.IndexOf("Felipe");

if (index == -1)

Console.WriteLine($"When an item is not found, IndexOf returns

{index}");

else

Console.WriteLine($"The name {names[index]} is at index {index}");

index = names.IndexOf("Not Found");

if (index == -1)

Console.WriteLine($"When an item is not found, IndexOf returns

{index}");

else

Console.WriteLine($"The name {names[index]} is at index {index}");

names.Sort();

foreach (var name in names)

Console.WriteLine($"Hello {name.ToUpper()}!");

Listas de otros tipos

Hasta el momento, se ha usado el tipo string en las listas. Se va a crear una lista
List<T> con un tipo distinto. Se va a crear una serie de números.

Agregue lo siguiente al programa después de llamar a WorkWithStrings() :

C#

var fibonacciNumbers = new List<int> {1, 1};

Se crea una lista de enteros y se definen los dos primeros enteros con el valor 1. Son los
dos primeros valores de una sucesión de Fibonacci, una secuencia de números. Cada
número sucesivo de Fibonacci se obtiene con la suma de los dos números anteriores.
Agregue este código:

C#

var previous = fibonacciNumbers[fibonacciNumbers.Count - 1];

var previous2 = fibonacciNumbers[fibonacciNumbers.Count - 2];

fibonacciNumbers.Add(previous + previous2);

foreach (var item in fibonacciNumbers)

Console.WriteLine(item);

Guarde el archivo y escriba dotnet run para ver los resultados.

 Sugerencia

Para centrarse solo en esta sección, puede comentar el código que llama a
WorkWithStrings(); . Solo debe colocar dos caracteres / delante de la llamada,

como en: // WorkWithStrings(); .

Desafío
Trate de recopilar los conceptos que ha aprendido en esta lección y en las anteriores.
Amplíe lo que ha creado hasta el momento con los números de Fibonacci. Pruebe a
escribir el código para generar los veinte primeros números de la secuencia. (Como
sugerencia, el 20º número de la serie de Fibonacci es 6765).

Desafío completo
Puede ver un ejemplo de solución en el ejemplo de código terminado en GitHub .

Con cada iteración del bucle, se obtienen los dos últimos enteros de la lista, se suman y
se agrega el valor resultante a la lista. El bucle se repite hasta que se hayan agregado
veinte elementos a la lista.

Enhorabuena, ha completado el tutorial sobre las listas. Puede seguir estos tutoriales
adicionales en su propio entorno de desarrollo.
Puede obtener más información sobre cómo trabajar con el tipo List en el artículo de
los aspectos básicos de .NET que trata sobre las colecciones. Ahí también podrá conocer
muchos otros tipos de colecciones.
Estructura general de un programa de
C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los programas de C# constan de uno o más archivos. Cada archivo contiene cero o más
espacios de nombres. Un espacio de nombres contiene tipos como clases, estructuras,
interfaces, enumeraciones y delegados, u otros espacios de nombres. El siguiente
ejemplo es el esqueleto de un programa de C# que contiene todos estos elementos.

C#

// A skeleton of a C# program

using System;

// Your program starts here:

Console.WriteLine("Hello world!");

namespace YourNamespace

class YourClass

struct YourStruct

interface IYourInterface

delegate int YourDelegate();

enum YourEnum

namespace YourNestedNamespace

struct YourStruct

En el ejemplo anterior se usan instrucciones de nivel superior para el punto de entrada

del programa. Esta característica se agregó en C# 9. Antes de C# 9, el punto de entrada
era un método estático denominado Main , como se muestra en el ejemplo siguiente:

C#

// A skeleton of a C# program

using System;

namespace YourNamespace

class YourClass

struct YourStruct

interface IYourInterface

delegate int YourDelegate();

enum YourEnum

namespace YourNestedNamespace

struct YourStruct

class Program

static void Main(string[] args)

//Your program starts here...

Console.WriteLine("Hello world!");

Secciones relacionadas
Obtenga información sobre estos elementos del programa en la sección de tipos de la
guía de aspectos básicos:

Clases
Structs
 Espacios de nombres
Interfaces
Enumeraciones
Delegados

Especificación del lenguaje C#

Para obtener más información, consulte la sección Conceptos básicos de Especificación
del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el
uso de C#.
Main() y argumentos de línea de
comandos
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

El método Main es el punto de entrada de una aplicación de C# (las bibliotecas y los

servicios no requieren un método Main como punto de entrada). Cuando se inicia la
aplicación, el método Main es el primero que se invoca.

Solo puede haber un punto de entrada en un programa de C#. Si hay más de una clase
que tenga un método Main , deberá compilar el programa con la opción del compilador
StartupObject para especificar qué método Main quiere utilizar como punto de entrada.
Para obtener más información, consulte StartupObject (opciones del compilador de C#).

C#

class TestClass

static void Main(string[] args)

// Display the number of command line arguments.

Console.WriteLine(args.Length);

A partir de C# 9, puede omitir el método Main y escribir instrucciones de C# como si

estuvieran en el método Main , como en el ejemplo siguiente:

C#

using System.Text;

StringBuilder builder = new();

builder.AppendLine("Hello");

builder.AppendLine("World!");

Console.WriteLine(builder.ToString());

Para obtener información sobre cómo escribir código de aplicación con un método de
punto de entrada implícito, consulte las instrucciones de nivel superior.

Información general
 El método Main es el punto de entrada de un programa ejecutable; es donde se
inicia y finaliza el control del programa.
Main se declara dentro de una clase o estructura. El valor de Main debe ser static y

no public. (En el ejemplo anterior, recibe el acceso predeterminado de private). La

clase o estructura envolvente no debe ser estático.
Main puede tener un tipo de valor devuelto void , int , Task o Task<int> .

Solo si Main devuelve un tipo de valor devuelto Task o Task<int> , la declaración

de Main puede incluir el modificador async, Esto excluye específicamente un
método async void Main .
El método Main se puede declarar con o sin un parámetro string[] que contiene
los argumentos de línea de comandos. Al usar Visual Studio para crear aplicaciones
Windows, se puede agregar el parámetro manualmente o usar el método
GetCommandLineArgs() con el fin de obtener los argumentos de la línea de
comandos. Los parámetros se leen como argumentos de línea de comandos
indizados con cero. A diferencia de C y C++, el nombre del programa no se trata
como el primer argumento de línea de comandos en la matriz args , pero es el
primer elemento del método GetCommandLineArgs().

En la lista siguiente se muestran las signaturas Main válidas:

C#

public static void Main() { }

public static int Main() { }

public static void Main(string[] args) { }

public static int Main(string[] args) { }

public static async Task Main() { }

public static async Task<int> Main() { }

public static async Task Main(string[] args) { }

public static async Task<int> Main(string[] args) { }

En los ejemplos anteriores se usa el modificador de acceso public . Esto es habitual,

pero no es necesario.

Al agregar los tipos de valor devuelto async , Task y Task<int> , se simplifica el código
de programa cuando las aplicaciones de consola tienen que realizar tareas de inicio y
await de operaciones asincrónicas en Main .

Valores devueltos Main()

Puede devolver un objeto int desde el método Main si lo define de una de las
siguientes maneras:
 Código del método Main Signatura de Main

No se usa args ni await static int Main()

Se usa args , no se usa await static int Main(string[] args)

No se usa args , se usa await static async Task<int> Main()

Se usan args y await static async Task<int> Main(string[] args)

Si el valor devuelto de Main no se usa, la devolución de void o Task permite que el

código sea ligeramente más sencillo.

Código del método Main Signatura de Main

No se usa args ni await static void Main()

Se usa args , no se usa await static void Main(string[] args)

No se usa args , se usa await static async Task Main()

Se usan args y await static async Task Main(string[] args)

Pero, si se devuelve int o Task<int> , el programa puede comunicar información de

estado a otros programas o scripts que invocan el archivo ejecutable.

En el ejemplo siguiente se muestra cómo se puede acceder al código de salida para el

proceso.

En este ejemplo se usan las herramientas de línea de comandos de .NET Core. Si no está

familiarizado con las herramientas de línea de comandos de .NET Core, puede obtener
información sobre ellas en este artículo de introducción.

Cree una aplicación mediante la ejecución de dotnet new console . Modifique el método
Main en Program.cs como se indica a continuación:

C#

// Save this program as MainReturnValTest.cs.

class MainReturnValTest

static int Main()

//...

return 0;

Cuando un programa se ejecuta en Windows, cualquier valor devuelto por la función

Main se almacena en una variable de entorno. Esta variable de entorno se puede
recuperar mediante ERRORLEVEL desde un archivo por lotes, o mediante $LastExitCode
desde PowerShell.

Puede compilar la aplicación mediante el comando dotnet build de la CLI de dotnet.

Después, cree un script de PowerShell para ejecutar la aplicación y mostrar el resultado.

Pegue el código siguiente en un archivo de texto y guárdelo como test.ps1 en la
carpeta que contiene el proyecto. Ejecute el script de PowerShell. Para ello, escriba
test.ps1 en el símbolo del sistema de PowerShell.

Dado que el código devuelve el valor cero, el archivo por lotes comunicará un resultado
satisfactorio. En cambio, si cambia MainReturnValTest.cs para que devuelva un valor
distinto de cero y luego vuelve a compilar el programa, la ejecución posterior del script
de PowerShell informará de que se ha producido un error.

PowerShell

dotnet run

if ($LastExitCode -eq 0) {

Write-Host "Execution succeeded"

} else

Write-Host "Execution Failed"

Write-Host "Return value = " $LastExitCode

Resultados

Execution succeeded

Return value = 0

Valores devueltos asincrónicos de Main

Cuando se declara un valor devuelto async para Main , el compilador genera el código
reutilizable para llamar a métodos asincrónicos en Main . Si no especifica la palabra clave
async , debe escribir ese código usted mismo, como se muestra en el siguiente ejemplo.
El código del ejemplo garantiza que el programa se ejecute hasta que se complete la
operación asincrónica:

C#
 public static void Main()

AsyncConsoleWork().GetAwaiter().GetResult();

private static async Task<int> AsyncConsoleWork()

// Main body here

return 0;

Este código reutilizable se puede reemplazar por:

C#

static async Task<int> Main(string[] args)

return await AsyncConsoleWork();

Una ventaja de declarar Main como async es que el compilador siempre genera el
código correcto.

Cuando el punto de entrada de la aplicación devuelve Task o Task<int> , el compilador

genera un nuevo punto de entrada que llama al método de punto de entrada declarado
en el código de la aplicación. Suponiendo que este punto de entrada se denomina
$GeneratedMain , el compilador genera el código siguiente para estos puntos de entrada:

static Task Main() hace que el compilador emita el equivalente de private

static void $GeneratedMain() => Main().GetAwaiter().GetResult();

static Task Main(string[]) hace que el compilador emita el equivalente de

private static void $GeneratedMain(string[] args) =>

Main(args).GetAwaiter().GetResult();

static Task<int> Main() hace que el compilador emita el equivalente de private

static int $GeneratedMain() => Main().GetAwaiter().GetResult();

static Task<int> Main(string[]) hace que el compilador emita el equivalente de

private static int $GeneratedMain(string[] args) =>

Main(args).GetAwaiter().GetResult();

７ Nota

Si en los ejemplos se usase el modificador async en el método Main , el compilador

generaría el mismo código.
Argumentos de la línea de comandos
Puede enviar argumentos al método Main definiéndolo de una de las siguientes
maneras:

Código del método Main Signatura de Main

No hay valores devueltos, no se usa await static void Main(string[] args)

Valor devuelto, no se usa await static int Main(string[] args)

No hay valores devueltos, se usa await static async Task Main(string[] args)

Valor devuelto, se usa await static async Task<int> Main(string[] args)

Si no se usan los argumentos, puede omitir args de la signatura del método para
simplificar ligeramente el código:

Código del método Main Signatura de Main

No hay valores devueltos, no se usa await static void Main()

Valor devuelto, no se usa await static int Main()

No hay valores devueltos, se usa await static async Task Main()

Valor devuelto, se usa await static async Task<int> Main()

７ Nota

También puede usar Environment.CommandLine o

Environment.GetCommandLineArgs para acceder a los argumentos de la línea de
comandos desde cualquier punto de una consola o de una aplicación de Windows
Forms. Para habilitar los argumentos de la línea de comandos en la signatura de
método Main de una aplicación de Windows Forms, tendrá que modificar
manualmente la signatura de Main . El código generado por el diseñador de
Windows Forms crea un Main sin ningún parámetro de entrada.

El parámetro del método Main es una matriz String que representa los argumentos de la
línea de comandos. Normalmente, para determinar si hay argumentos, se prueba la
propiedad Length ; por ejemplo:
 C#

if (args.Length == 0)

System.Console.WriteLine("Please enter a numeric argument.");

return 1;

 Sugerencia

La matriz args no puede ser NULL. así que es seguro acceder a la propiedad
Length sin comprobar los valores NULL.

También puede convertir los argumentos de cadena en tipos numéricos mediante la

clase Convert o el método Parse . Por ejemplo, la siguiente instrucción convierte la
string en un número long mediante el método Parse:

C#

long num = Int64.Parse(args[0]);

También se puede usar el tipo de C# long , que tiene como alias Int64 :

C#

long num = long.Parse(args[0]);

También puede usar el método ToInt64 de la clase Convert para hacer lo mismo:

C#

long num = Convert.ToInt64(s);

Para obtener más información, vea Parse y Convert.

En el ejemplo siguiente se muestra cómo usar argumentos de la línea de comandos en

una aplicación de consola. La aplicación toma un argumento en tiempo de ejecución, lo
convierte en un entero y calcula el factorial del número. Si no se proporciona ningún
argumento, la aplicación emite un mensaje en el que se explica el uso correcto del
programa.

Para compilar y ejecutar la aplicación desde un símbolo del sistema, siga estos pasos:
1. Pegue el código siguiente en cualquier editor de texto, y después guarde el
archivo como archivo de texto con el nombre Factorial.cs.

C#

public class Functions

public static long Factorial(int n)

// Test for invalid input.

if ((n < 0) || (n > 20))

return -1;

// Calculate the factorial iteratively rather than recursively.

long tempResult = 1;

for (int i = 1; i <= n; i++)

tempResult *= i;

return tempResult;

class MainClass

static int Main(string[] args)

// Test if input arguments were supplied.

if (args.Length == 0)

Console.WriteLine("Please enter a numeric argument.");

Console.WriteLine("Usage: Factorial <num>");

return 1;

// Try to convert the input arguments to numbers. This will

throw

// an exception if the argument is not a number.

// num = int.Parse(args[0]);

int num;

bool test = int.TryParse(args[0], out num);

if (!test)

Console.WriteLine("Please enter a numeric argument.");

Console.WriteLine("Usage: Factorial <num>");

return 1;

// Calculate factorial.

long result = Functions.Factorial(num);

// Print result.

 if (result == -1)

Console.WriteLine("Input must be >= 0 and <= 20.");

else

Console.WriteLine($"The Factorial of {num} is {result}.");

return 0;

// If 3 is entered on command line, the

// output reads: The factorial of 3 is 6.

2. En la pantalla Inicio o en el menú Inicio, abra una ventana del Símbolo del sistema
para desarrolladores de Visual Studio y navegue hasta la carpeta que contiene el
archivo que creó.

3. Escriba el siguiente comando para compilar la aplicación.

dotnet build

Si la aplicación no tiene ningún error de compilación, se creará un archivo

ejecutable con el nombre Factorial.exe.

4. Escriba el siguiente comando para calcular el factorial de 3:

dotnet run -- 3

5. El comando genera este resultado: The factorial of 3 is 6.

７ Nota

Al ejecutar una aplicación en Visual Studio, puede especificar argumentos de la

línea de comandos en la Página Depuración, Diseñador de proyectos.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
System.Environment
Procedimiento para mostrar argumentos de la línea de comandos
Instrucciones de nivel superior:
programas sin métodos Main
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

A partir de C# 9, no es necesario incluir explícitamente un método Main en un proyecto

de aplicación de consola. En su lugar, puede usar la característica de instrucciones de
nivel superior para minimizar el código que tiene que escribir. En este caso, el
compilador genera una clase y un punto de entrada de método Main para la aplicación.

Aquí se muestra un archivo Program.cs que es un programa de C# completo en C# 10:

C#

Console.WriteLine("Hello World!");

Las instrucciones de nivel superior permiten escribir programas sencillos para utilidades
pequeñas, como Azure Functions y Acciones de GitHub. También facilitan a los nuevos
programadores de C# empezar a aprender y escribir código.

En las secciones siguientes se explican las reglas de lo que puede y no puede hacer con
las instrucciones de nivel superior.

Solo un archivo de nivel superior

Una aplicación solo debe tener un punto de entrada. Un proyecto solo puede tener un
archivo con instrucciones de nivel superior. Al colocar instrucciones de nivel superior en
más de un archivo de un proyecto, se produce el error del compilador siguiente:

CS8802 Solo una unidad de compilación puede tener instrucciones de nivel

superior.

Un proyecto puede tener cualquier número de archivos de código fuente adicionales

que no tengan instrucciones de nivel superior.

Ningún otro punto de entrada

Puede escribir un método Main de forma explícita, pero no puede funcionar como
punto de entrada. El compilador emite la advertencia siguiente:
 CS7022 El punto de entrada del programa es código global: se ignora el punto de
entrada "Main()".

En un proyecto con instrucciones de nivel superior, no se puede usar la opción del

compilador -main para seleccionar el punto de entrada, incluso si el proyecto tiene uno
o varios métodos Main .

Directivas using
Si incluye directivas using, deben aparecer en primer lugar en el archivo, como en este
ejemplo:

C#

using System.Text;

StringBuilder builder = new();

builder.AppendLine("Hello");

builder.AppendLine("World!");

Console.WriteLine(builder.ToString());

Espacio de nombres global

Las instrucciones de nivel superior están implícitamente en el espacio de nombres
global.

Espacios de nombres y definiciones de tipos

Un archivo con instrucciones de nivel superior también puede contener espacios de
nombres y definiciones de tipos, pero deben aparecer después de las instrucciones de
nivel superior. Por ejemplo:

C#

MyClass.TestMethod();

MyNamespace.MyClass.MyMethod();

public class MyClass

public static void TestMethod()

 Console.WriteLine("Hello World!");

namespace MyNamespace

class MyClass

public static void MyMethod()

Console.WriteLine("Hello World from

MyNamespace.MyClass.MyMethod!");

args
Las instrucciones de nivel superior pueden hacer referencia a la variable args para
acceder a los argumentos de línea de comandos que se hayan escrito. La variable args
nunca es NULL, pero su valor Length es cero si no se han proporcionado argumentos de
línea de comandos. Por ejemplo:

C#

if (args.Length > 0)

foreach (var arg in args)

Console.WriteLine($"Argument={arg}");

else

Console.WriteLine("No arguments");

await
Puede llamar a un método asincrónico mediante el uso await . Por ejemplo:

C#

Console.Write("Hello ");

await Task.Delay(5000);

Console.WriteLine("World!");

Código de salida para el proceso

Para devolver un valor int cuando finaliza la aplicación, use la instrucción return como
lo haría en un método Main que devuelva una instancia de int . Por ejemplo:

C#

string? s = Console.ReadLine();

int returnValue = int.Parse(s ?? "-1");

return returnValue;

Método de punto de entrada implícito

El compilador genera un método que actúa como el punto de entrada del programa
para un proyecto con instrucciones de nivel superior. El nombre de este método no es
en realidad Main , es un detalle de implementación al que el código no puede hacer
referencia directamente. La signatura del método depende de si las instrucciones de
nivel superior contienen la palabra clave await o la instrucción return . En la tabla
siguiente se muestra el aspecto que tendría la signatura del método, utilizando el
nombre del método Main en la tabla para mayor comodidad.

El código de nivel superior contiene Signatura de Main implícita

await y return static async Task<int> Main(string[] args)

await static async Task Main(string[] args)

return static int Main(string[] args)

No await ni return static void Main(string[] args)

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Especificación de la característica: instrucciones de nivel superior

El sistema de tipos de C#
Artículo • 15/02/2023 • Tiempo de lectura: 16 minutos

C# es un lenguaje fuertemente tipado. Todas las variables y constantes tienen un tipo, al

igual que todas las expresiones que se evalúan como un valor. Cada declaración del
método especifica un nombre, el tipo y naturaleza (valor, referencia o salida) para cada
parámetro de entrada y para el valor devuelto. La biblioteca de clases .NET define tipos
numéricos integrados, así como tipos complejos que representan una amplia variedad
de construcciones. Entre ellas se incluyen el sistema de archivos, conexiones de red,
colecciones y matrices de objetos, y fechas. Los programas de C# típicos usan tipos de
la biblioteca de clases, así como tipos definidos por el usuario que modelan los
conceptos que son específicos del dominio del problema del programa.

Entre la información almacenada en un tipo se pueden incluir los siguientes elementos:

El espacio de almacenamiento que requiere una variable del tipo.

Los valores máximo y mínimo que puede representar.
Los miembros (métodos, campos, eventos, etc.) que contiene.
El tipo base del que hereda.
Interfaces que implementa.
Los tipos de operaciones permitidas.

El compilador usa información de tipo para garantizar que todas las operaciones que se
realizan en el código cuentan con seguridad de tipos. Por ejemplo, si declara una variable
de tipo int, el compilador le permite usar la variable en operaciones de suma y resta. Si
intenta realizar esas mismas operaciones en una variable de tipo bool, el compilador
genera un error, como se muestra en el siguiente ejemplo:

C#

int a = 5;

int b = a + 2; //OK

bool test = true;

// Error. Operator '+' cannot be applied to operands of type 'int' and

'bool'.

int c = a + test;

７ Nota
 Los desarrolladores de C y C++ deben tener en cuenta que, en C#, bool no se
puede convertir en int .

El compilador inserta la información de tipo en el archivo ejecutable como metadatos.

Common Language Runtime (CLR) usa esos metadatos en tiempo de ejecución para
garantizar aún más la seguridad de tipos cuando asigna y reclama memoria.

Especificar tipos en declaraciones de variable

Cuando declare una variable o constante en un programa, debe especificar su tipo o
utilizar la palabra clave var para que el compilador infiera el tipo. En el ejemplo siguiente
se muestran algunas declaraciones de variable que utilizan tanto tipos numéricos
integrados como tipos complejos definidos por el usuario:

C#

// Declaration only:

float temperature;

string name;

MyClass myClass;

// Declaration with initializers (four examples):

char firstLetter = 'C';

var limit = 3;

int[] source = { 0, 1, 2, 3, 4, 5 };

var query = from item in source

where item <= limit

select item;

Los tipos de parámetros del método y los valores devueltos se especifican en la

declaración del método. En la siguiente firma se muestra un método que requiere una
variable int como argumento de entrada y devuelve una cadena:

C#

public string GetName(int ID)

if (ID < names.Length)

return names[ID];

else

return String.Empty;

private string[] names = { "Spencer", "Sally", "Doug" };

Después de declarar una variable, no se puede volver a declarar con un nuevo tipo y no
se puede asignar un valor que no sea compatible con su tipo declarado. Por ejemplo, no
puede declarar un valor int y, luego, asignarle un valor booleano de true . En cambio,
los valores se pueden convertir en otros tipos, por ejemplo, cuando se asignan a
variables nuevas o se pasan como argumentos de método. El compilador realiza
automáticamente una conversión de tipo que no da lugar a una pérdida de datos. Una
conversión que pueda dar lugar a la pérdida de datos requiere un valor cast en el
código fuente.

Para obtener más información, vea Conversiones de tipos.

Tipos integrados
C# proporciona un conjunto estándar de tipos integrados. Estos representan números
enteros, valores de punto flotante, expresiones booleanas, caracteres de texto, valores
decimales y otros tipos de datos. También hay tipos string y object integrados. Estos
tipos están disponibles para su uso en cualquier programa de C#. Para obtener una lista
completa de los tipos integrados, vea Tipos integrados.

Tipos personalizados
Puede usar las construcciones struct, class, interface, enum y record para crear sus
propios tipos personalizados. La biblioteca de clases .NET es en sí misma una colección
de tipos personalizados que puede usar en sus propias aplicaciones. De forma
predeterminada, los tipos usados con más frecuencia en la biblioteca de clases están
disponibles en cualquier programa de C#. Otros están disponibles solo cuando agrega
explícitamente una referencia de proyecto al ensamblado que los define. Una vez que el
compilador tenga una referencia al ensamblado, puede declarar variables (y constantes)
de los tipos declarados en dicho ensamblado en el código fuente. Para más información,
vea Biblioteca de clases .NET.

Common Type System

Es importante entender dos aspectos fundamentales sobre el sistema de tipos en .NET:

Es compatible con el principio de herencia. Los tipos pueden derivarse de otros

tipos, denominados tipos base. El tipo derivado hereda (con algunas restricciones),
los métodos, las propiedades y otros miembros del tipo base. A su vez, el tipo base
puede derivarse de algún otro tipo, en cuyo caso el tipo derivado hereda los
miembros de ambos tipos base en su jerarquía de herencia. Todos los tipos,
 incluidos los tipos numéricos integrados como System.Int32 (palabra clave de C#:
int ), se derivan en última instancia de un único tipo base, que es System.Object
(palabra clave de C#: object). Esta jerarquía de tipos unificada se denomina
Common Type System (CTS). Para más información sobre la herencia en C#, vea
Herencia.
En CTS, cada tipo se define como un tipo de valor o un tipo de referencia. Estos
tipos incluyen todos los tipos personalizados de la biblioteca de clases .NET y
también sus propios tipos definidos por el usuario. Los tipos que se definen
mediante el uso de la palabra clave struct son tipos de valor; todos los tipos
numéricos integrados son structs . Los tipos que se definen mediante el uso de la
palabra clave class o record son tipos de referencia. Los tipos de referencia y los
tipos de valor tienen distintas reglas de tiempo de compilación y distintos
comportamientos de tiempo de ejecución.

En la ilustración siguiente se muestra la relación entre los tipos de valor y los tipos de
referencia en CTS.

７ Nota

Puede ver que los tipos utilizados con mayor frecuencia están organizados en el
espacio de nombres System. Sin embargo, el espacio de nombres que contiene un
tipo no tiene ninguna relación con un tipo de valor o un tipo de referencia.
Las clases (class) y estructuras (struct) son dos de las construcciones básicas de Common
Type System en .NET. C# 9 agrega registros, que son un tipo de clase. Cada una de ellas
es básicamente una estructura de datos que encapsula un conjunto de datos y
comportamientos que forman un conjunto como una unidad lógica. Los datos y
comportamientos son los miembros de la clase, estructura o registro. Los miembros
incluyen sus métodos, propiedades y eventos, entre otros elementos, como se muestra
más adelante en este artículo.

Una declaración de clase, estructura o registro es como un plano que se utiliza para
crear instancias u objetos en tiempo de ejecución. Si define una clase, una estructura o
un registro denominado Person , Person es el nombre del tipo. Si declara e inicializa una
variable p de tipo Person , se dice que p es un objeto o instancia de Person . Se pueden
crear varias instancias del mismo tipo Person , y cada instancia tiene diferentes valores
en sus propiedades y campos.

Una clase es un tipo de referencia. Cuando se crea un objeto del tipo, la variable a la
que se asigna el objeto contiene solo una referencia a esa memoria. Cuando la
referencia de objeto se asigna a una nueva variable, la nueva variable hace referencia al
objeto original. Los cambios realizados en una variable se reflejan en la otra variable
porque ambas hacen referencia a los mismos datos.

Una estructura es un tipo de valor. Cuando se crea una estructura, la variable a la que se
asigna la estructura contiene los datos reales de ella. Cuando la estructura se asigna a
una nueva variable, se copia. Por lo tanto, la nueva variable y la variable original
contienen dos copias independientes de los mismos datos. Los cambios realizados en
una copia no afectan a la otra copia.

Los tipos de registro pueden ser tipos de referencia ( record class ) o tipos de valor
( record struct ).

En general, las clases se utilizan para modelar comportamientos más complejos. Las
clases suelen almacenar datos que están diseñados para modificarse después de crear
un objeto de clase. Los structs son más adecuados para estructuras de datos pequeñas.
Los structs suelen almacenar datos que no están diseñados para modificarse después de
que se haya creado el struct. Los tipos de registro son estructuras de datos con
miembros sintetizados del compilador adicionales. Los registros suelen almacenar datos
que no están diseñados para modificarse después de que se haya creado el objeto.

Tipos de valor
Los tipos de valor derivan de System.ValueType, el cual deriva de System.Object. Los
tipos que derivan de System.ValueType tienen un comportamiento especial en CLR. Las
variables de tipo de valor contienen directamente sus valores. La memoria de un struct
se asigna en línea en cualquier contexto en el que se declare la variable. No se produce
ninguna asignación del montón independiente ni sobrecarga de la recolección de
elementos no utilizados para las variables de tipo de valor. Puede declarar tipos record
struct que son tipos de valor e incluir los miembros sintetizados para los registros.

Existen dos categorías de tipos de valor: struct y enum .

Los tipos numéricos integrados son structs y tienen campos y métodos a los que se
puede acceder:

C#

// constant field on type byte.

byte b = byte.MaxValue;

Pero se declaran y se les asignan valores como si fueran tipos simples no agregados:

C#

byte num = 0xA;

int i = 5;

char c = 'Z';

Los tipos de valor están sellados. No se puede derivar un tipo de cualquier tipo de valor,
por ejemplo System.Int32. No se puede definir un struct para que herede de cualquier
clase o struct definido por el usuario porque un struct solo puede heredar de
System.ValueType. A pesar de ello, un struct puede implementar una o más interfaces.
No se puede convertir un tipo de struct en cualquier tipo de interfaz que implemente.
Esta conversión provoca una que operación boxing encapsule el struct dentro de un
objeto de tipo de referencia en el montón administrado. Las operaciones de conversión
boxing se producen cuando se pasa un tipo de valor a un método que toma
System.Object o cualquier tipo de interfaz como parámetro de entrada. Para obtener
más información, vea Conversión boxing y unboxing.

Puede usar la palabra clave struct para crear sus propios tipos de valor personalizados.
Normalmente, un struct se usa como un contenedor para un pequeño conjunto de
variables relacionadas, como se muestra en el ejemplo siguiente:

C#

public struct Coords

public int x, y;

 public Coords(int p1, int p2)

x = p1;

y = p2;

Para más información sobre estructuras, vea Tipos de estructura. Para más información
sobre los tipos de valor, vea Tipos de valor.

La otra categoría de tipos de valor es enum . Una enumeración define un conjunto de

constantes integrales con nombre. Por ejemplo, la enumeración System.IO.FileMode de
la biblioteca de clases .NET contiene un conjunto de enteros constantes con nombre
que especifican cómo se debe abrir un archivo. Se define como se muestra en el
ejemplo siguiente:

C#

public enum FileMode

CreateNew = 1,

Create = 2,

Open = 3,

OpenOrCreate = 4,

Truncate = 5,

Append = 6,

La constante System.IO.FileMode.Create tiene un valor de 2. Sin embargo, el nombre es

mucho más significativo para los humanos que leen el código fuente y, por esa razón, es
mejor utilizar enumeraciones en lugar de números literales constantes. Para obtener
más información, vea System.IO.FileMode.

Todas las enumeraciones se heredan de System.Enum, el cual se hereda de

System.ValueType. Todas las reglas que se aplican a las estructuras también se aplican a
las enumeraciones. Para más información sobre las enumeraciones, vea Tipos de
enumeración.

Tipos de referencia
Un tipo que se define como class , record , delegate, matriz o interface es un reference
type.
Al declarar una variable de un reference type, contiene el valor null hasta que se asigna
con una instancia de ese tipo o se crea una mediante el operador new. La creación y
asignación de una clase se muestran en el ejemplo siguiente:

C#

MyClass myClass = new MyClass();

MyClass myClass2 = myClass;

No se puede crear una instancia de interface directamente mediante el operador new.

En su lugar, cree y asigne una instancia de una clase que implemente la interfaz.
Considere el ejemplo siguiente:

C#

MyClass myClass = new MyClass();

// Declare and assign using an existing value.

IMyInterface myInterface = myClass;

// Or create and assign a value in a single statement.

IMyInterface myInterface2 = new MyClass();

Cuando se crea un objeto, se asigna memoria en el montón administrado. La variable

contiene solo una referencia a la ubicación del objeto. Los tipos del montón
administrado producen sobrecarga cuando se asignan y cuando se reclaman. La
recolección de elementos no utilizados es la funcionalidad de administración automática
de memoria de CLR, que realiza la recuperación. En cambio, la recolección de elementos
no utilizados también está muy optimizada y no crea problemas de rendimiento en la
mayoría de los escenarios. Para obtener más información sobre la recolección de
elementos no utilizados, vea Administración de memoria automática.

Todas las matrices son tipos de referencia, incluso si sus elementos son tipos de valor.
Las matrices derivan de manera implícita de la clase System.Array. El usuario las declara
y las usa con la sintaxis simplificada que proporciona C#, como se muestra en el
ejemplo siguiente:

C#

// Declare and initialize an array of integers.

int[] nums = { 1, 2, 3, 4, 5 };

// Access an instance property of System.Array.

int len = nums.Length;

Los tipos de referencia admiten la herencia completamente. Al crear una clase, puede
heredar de cualquier otra interfaz o clase que no esté definida como sellado. Otras
clases pueden heredar de la clase e invalidar sus métodos virtuales. Para obtener más
información sobre cómo crear sus clases, vea Clases, estructuras y registros. Para más
información sobre la herencia y los métodos virtuales, vea Herencia.

Tipos de valores literales

En C#, los valores literales reciben un tipo del compilador. Puede especificar cómo debe
escribirse un literal numérico; para ello, anexe una letra al final del número. Por ejemplo,
para especificar que el valor 4.56 debe tratarse como un valor float , anexe "f" o "F"
después del número: 4.56f . Si no se anexa ninguna letra, el compilador inferirá un tipo
para el literal. Para obtener más información sobre los tipos que se pueden especificar
con sufijos de letras, vea Tipos numéricos integrales y Tipos numéricos de punto
flotante.

Dado que los literales tienen tipo y todos los tipos derivan en última instancia de
System.Object, puede escribir y compilar código como el siguiente:

C#

string s = "The answer is " + 5.ToString();

// Outputs: "The answer is 5"

Console.WriteLine(s);

Type type = 12345.GetType();

// Outputs: "System.Int32"

Console.WriteLine(type);

Tipos genéricos
Los tipos se pueden declarar con uno o varios parámetros de tipo que actúan como un
marcador de posición para el tipo real (el tipo concreto). El código de cliente
proporciona el tipo concreto cuando crea una instancia del tipo. Estos tipos se
denominan tipos genéricos. Por ejemplo, el tipo de .NET
System.Collections.Generic.List<T> tiene un parámetro de tipo al que, por convención,
se le denomina T . Cuando crea una instancia del tipo, especifica el tipo de los objetos
que contendrá la lista, por ejemplo, string :

C#
 List<string> stringList = new List<string>();

stringList.Add("String example");
// compile time error adding a type other than a string:

stringList.Add(4);

El uso del parámetro de tipo permite reutilizar la misma clase para incluir cualquier tipo
de elemento, sin necesidad de convertir cada elemento en object. Las clases de
colección genéricas se denominan colecciones con establecimiento inflexible de tipos
porque el compilador conoce el tipo específico de los elementos de la colección y
puede generar un error en tiempo de compilación si, por ejemplo, intenta agregar un
valor entero al objeto stringList del ejemplo anterior. Para más información, vea
Genéricos.

Tipos implícitos, tipos anónimos y tipos que

admiten un valor NULL
Como se ha mencionado anteriormente, puede asignar implícitamente un tipo a una
variable local (pero no miembros de clase) mediante la palabra clave var. La variable
sigue recibiendo un tipo en tiempo de compilación, pero este lo proporciona el
compilador. Para más información, vea Variables locales con asignación implícita de
tipos.

En algunos casos, resulta conveniente crear un tipo con nombre para conjuntos sencillos
de valores relacionados que no desea almacenar ni pasar fuera de los límites del
método. Puede crear tipos anónimos para este fin. Para obtener más información,
consulte Tipos anónimos (Guía de programación de C#).

Los tipos de valor normales no pueden tener un valor null, pero se pueden crear tipos de
valor que aceptan valores NULL mediante la adición de ? después del tipo. Por ejemplo,
int? es un tipo int que también puede tener el valor null. Los tipos que admiten un
valor NULL son instancias del tipo struct genérico System.Nullable<T>. Los tipos que
admiten un valor NULL son especialmente útiles cuando hay un intercambio de datos
con bases de datos en las que los valores numéricos podrían ser null . Para más
información, vea Tipos que admiten un valor NULL.

Tipo en tiempo de compilación y tipo en

tiempo de ejecución
Una variable puede tener distintos tipos en tiempo de compilación y en tiempo de
ejecución. El tipo en tiempo de compilación es el tipo declarado o inferido de la variable
en el código fuente. El tipo en tiempo de ejecución es el tipo de la instancia a la que hace
referencia esa variable. A menudo, estos dos tipos son los mismos, como en el ejemplo
siguiente:

C#

string message = "This is a string of characters";

En otros casos, el tipo en tiempo de compilación es diferente, tal y como se muestra en

los dos ejemplos siguientes:

C#

object anotherMessage = "This is another string of characters";

IEnumerable<char> someCharacters = "abcdefghijklmnopqrstuvwxyz";

En los dos ejemplos anteriores, el tipo en tiempo de ejecución es string . El tipo en

tiempo de compilación es object en la primera línea y IEnumerable<char> en la
segunda.

Si los dos tipos son diferentes para una variable, es importante comprender cuándo se
aplican el tipo en tiempo de compilación y el tipo en tiempo de ejecución. El tipo en
tiempo de compilación determina todas las acciones realizadas por el compilador. Estas
acciones del compilador incluyen la resolución de llamadas a métodos, la resolución de
sobrecarga y las conversiones implícitas y explícitas disponibles. El tipo en tiempo de
ejecución determina todas las acciones que se resuelven en tiempo de ejecución. Estas
acciones de tiempo de ejecución incluyen el envío de llamadas a métodos virtuales, la
evaluación de expresiones is y switch y otras API de prueba de tipos. Para comprender
mejor cómo interactúa el código con los tipos, debe reconocer qué acción se aplica a
cada tipo.

Secciones relacionadas
Para más información, consulte los siguientes artículos.

Tipos integrados
Tipos de valor
Tipos de referencia
Especificación del lenguaje C#
Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Declaración de espacios de nombres
para organizar los tipos
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los espacios de nombres se usan mucho en programación de C# de dos maneras. En

primer lugar, .NET usa espacios de nombres para organizar sus clases de la siguiente
manera:

C#

System.Console.WriteLine("Hello World!");

System es un espacio de nombres y Console es una clase de ese espacio de nombres. La

palabra clave using se puede usar para que el nombre completo no sea necesario,
como en el ejemplo siguiente:

C#

using System;

C#

Console.WriteLine("Hello World!");

Para más información, vea using (Directiva).

） Importante

Las plantillas de C# para .NET 6 usan instrucciones de nivel superior. Es posible que
la aplicación no coincida con el código de este artículo si ya ha actualizado a
.NET 6. Para obtener más información, consulte el artículo Las nuevas plantillas de
C# generan instrucciones de nivel superior.

El SDK de .NET 6 también agrega un conjunto de directivas implícitas global using

para proyectos que usan los SDK siguientes:

Microsoft.NET.Sdk
Microsoft.NET.Sdk.Web
Microsoft.NET.Sdk.Worker
 Estas directivas de global using implícitas incluyen los espacios de nombres más
comunes para el tipo de proyecto.

En segundo lugar, declarar sus propios espacios de nombres puede ayudarle a controlar
el ámbito de nombres de clase y método en proyectos de programación grandes. Use la
palabra clave namespace para declarar un espacio de nombres, como en el ejemplo
siguiente:

C#

namespace SampleNamespace

class SampleClass

public void SampleMethod()

System.Console.WriteLine(

"SampleMethod inside SampleNamespace");

El nombre del espacio de nombres debe ser un nombre de identificador de C# válido.

A partir de C# 10, puede declarar un espacio de nombres para todos los tipos definidos
en ese archivo, como se muestra en el ejemplo siguiente:

C#

namespace SampleNamespace;

class AnotherSampleClass

public void AnotherSampleMethod()

System.Console.WriteLine(
"SampleMethod inside SampleNamespace");

La ventaja de esta nueva sintaxis es que es más sencilla, lo que ahorra espacio horizontal
y llaves. Esto facilita la lectura del código.

Información general sobre los espacios de

nombres
Los espacios de nombres tienen las propiedades siguientes:

Organizan proyectos de código de gran tamaño.

Se delimitan mediante el operador . .
La directiva using obvia la necesidad de especificar el nombre del espacio de
nombres para cada clase.
El espacio de nombres global es el espacio de nombres "raíz": global::System
siempre hará referencia al espacio de nombres System de .NET.

Especificación del lenguaje C#

Para más información, vea la sección Espacio de nombres de la Especificación del
lenguaje C#.
Introducción a las clases
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Tipos de referencia
Un tipo que se define como una class, es un tipo de referencia. Al declarar una variable
de un tipo de referencia en tiempo de ejecución, esta contendrá el valor null hasta que
se cree expresamente una instancia de la clase mediante el operador new o se le asigne
un objeto de un tipo compatible que se ha creado en otro lugar, tal y como se muestra
en el ejemplo siguiente:

C#

//Declaring an object of type MyClass.

MyClass mc = new MyClass();

//Declaring another object of the same type, assigning it the value of the
first object.

MyClass mc2 = mc;

Cuando se crea el objeto, se asigna suficiente memoria en el montón administrado para

ese objeto específico y la variable solo contiene una referencia a la ubicación de dicho
objeto. Los tipos del montón administrado producen sobrecarga cuando se asignan y
cuando los reclama la función de administración de memoria automática de CLR,
conocida como recolección de elementos no utilizados. En cambio, la recolección de
elementos no utilizados también está muy optimizada y no crea problemas de
rendimiento en la mayoría de los escenarios. Para obtener más información sobre la
recolección de elementos no utilizados, vea Administración automática de la memoria y
recolección de elementos no utilizados.

Declarar clases
Las clases se declaran mediante la palabra clave class seguida por un identificador
único, como se muestra en el siguiente ejemplo:

C#

//[access modifier] - [class] - [identifier]

public class Customer

// Fields, properties, methods and events go here...

La palabra clave class va precedida del nivel de acceso. Como en este caso se usa
public, cualquier usuario puede crear instancias de esta clase. El nombre de la clase
sigue a la palabra clave class . El nombre de la clase debe ser un nombre de
identificador de C# válido. El resto de la definición es el cuerpo de la clase, donde se
definen los datos y el comportamiento. Los campos, las propiedades, los métodos y los
eventos de una clase se denominan de manera colectiva miembros de clase.

Creación de objetos
Aunque a veces se usan indistintamente, una clase y un objeto son cosas diferentes. Una
clase define un tipo de objeto, pero no es un objeto en sí. Un objeto es una entidad
concreta basada en una clase y, a veces, se conoce como una instancia de una clase.

Los objetos se pueden crear usando la palabra clave new , seguida del nombre de la
clase en la que se basará el objeto, como en este ejemplo:

C#

Customer object1 = new Customer();

Cuando se crea una instancia de una clase, se vuelve a pasar al programador una
referencia al objeto. En el ejemplo anterior, object1 es una referencia a un objeto que
se basa en Customer . Esta referencia apunta al objeto nuevo, pero no contiene los datos
del objeto. De hecho, puede crear una referencia de objeto sin tener que crear ningún
objeto:

C#

Customer object2;

No se recomienda crear referencias de objeto como la anterior, que no hace referencia a

ningún objeto, ya que, si se intenta obtener acceso a un objeto a través de este tipo de
referencia, se producirá un error en tiempo de ejecución. Pero este tipo de referencia se
puede haber creado para hacer referencia a un objeto, ya sea creando uno o
asignándola a un objeto existente, como en el ejemplo siguiente:

C#

Customer object3 = new Customer();

Customer object4 = object3;

Este código crea dos referencias de objeto que hacen referencia al mismo objeto. Por lo
tanto, los cambios efectuados en el objeto mediante object3 se reflejan en los usos
posteriores de object4 . Dado que los objetos basados en clases se tratan por referencia,
las clases se denominan "tipos de referencia".

Herencia de clases
Las clases admiten completamente la herencia, una característica fundamental de la
programación orientada a objetos. Al crear una clase, puede heredar de cualquier otra
que no esté definida como sealed, y otras clases pueden heredar de esa e invalidar sus
métodos virtuales. Además, puede implementar una o varias interfaces.

La herencia se consigue mediante una derivación, en la que se declara una clase

mediante una clase base, desde la que hereda los datos y el comportamiento. Una clase
base se especifica anexando dos puntos y el nombre de la clase base seguido del
nombre de la clase derivada, como en el siguiente ejemplo:

C#

public class Manager : Employee

// Employee fields, properties, methods and events are inherited

// New Manager fields, properties, methods and events go here...

Cuando una clase declara una clase base, hereda todos los miembros de la clase base
excepto los constructores. Para obtener más información, vea Herencia.

Una clase de C# solo puede heredar directamente de una clase base. En cambio, dado
que una clase base puede heredar de otra clase, una clase podría heredar
indirectamente varias clases base. Además, una clase puede implementar directamente
una o varias interfaces. Para obtener más información, vea Interfaces.

Una clase puede declararse abstract. Una clase abstracta contiene métodos abstractos
que tienen una definición de firma, pero no tienen ninguna implementación. No se
pueden crear instancias de las clases abstractas. Solo se pueden usar a través de las
clases derivadas que implementan los métodos abstractos. Por el contrario, la clase
sealed no permite que otras clases se deriven de ella. Para más información, vea Clases y
miembros de clase abstractos y sellados.

Las definiciones de clase se pueden dividir entre distintos archivos de código fuente.
Para más información, vea Clases y métodos parciales.
Ejemplo
En el ejemplo siguiente se define una clase pública que contiene una propiedad
implementada automáticamente, un método y un método especial denominado
constructor. Para obtener más información, consulte los artículos Propiedades, Métodos
y Constructores. Luego, se crea una instancia de las instancias de la clase con la palabra
clave new .

C#

using System;

public class Person

// Constructor that takes no arguments:

public Person()

Name = "unknown";

// Constructor that takes one argument:

public Person(string name)

Name = name;

// Auto-implemented readonly property:

public string Name { get; }

// Method that overrides the base class (System.Object) implementation.

public override string ToString()

return Name;

class TestPerson

static void Main()

// Call the constructor that has no parameters.

var person1 = new Person();

Console.WriteLine(person1.Name);

// Call the constructor that has one parameter.

var person2 = new Person("Sarah Jones");

Console.WriteLine(person2.Name);

// Get the string representation of the person2 instance.

Console.WriteLine(person2);

// Output:

// unknown

 // Sarah Jones

// Sarah Jones

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Introducción a los tipos de registro en C
#
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Un registro en C# es una clase o estructura que proporciona sintaxis y comportamiento

especiales para trabajar con modelos de datos.

Cuándo se usan los registros

Considere la posibilidad de usar un registro en lugar de una clase o estructura en los
escenarios siguientes:

Desea definir un modelo de datos que dependa de la igualdad de valores.

Desea definir un tipo para el que los objetos son inmutables.

Igualdad de valores
En el caso de los registros, la igualdad de valores significa que dos variables de un tipo
de registro son iguales si los tipos coinciden y todos los valores de propiedad y campo
coinciden. Para otros tipos de referencia, como las clases, la igualdad significa igualdad
de referencias. Es decir, dos variables de un tipo de clase son iguales si hacen referencia
al mismo objeto. Los métodos y operadores que determinan la igualdad de dos
instancias de registro usan la igualdad de valores.

No todos los modelos de datos funcionan bien con la igualdad de valores. Por ejemplo,
Entity Framework Core depende de la igualdad de referencias para garantizar que solo
usa una instancia de un tipo de entidad para lo que es conceptualmente una entidad.
Por esta razón, los tipos de registro no son adecuados para su uso como tipos de
entidad en Entity Framework Core.

Inmutabilidad
Un tipo inmutable es aquél que impide cambiar cualquier valor de propiedad o campo
de un objeto una vez creada su instancia. La inmutabilidad puede ser útil cuando se
necesita que un tipo sea seguro para los subprocesos o si depende de que un código
hash quede igual en una tabla hash. Los registros proporcionan una sintaxis concisa
para crear y trabajar con tipos inmutables.
La inmutabilidad no es adecuada para todos los escenarios de datos. Por ejemplo, Entity
Framework Core no admite la actualización con tipos de entidad inmutables.

Diferencias entre los registros y las clases y

estructuras
La misma sintaxis que declara y crea instancias de clases o estructuras se puede usar con
los registros. Basta con sustituir la palabra clave class por record , o bien usar record
struct en lugar de struct . Del mismo modo, las clases de registro admiten la misma

sintaxis para expresar las relaciones de herencia. Los registros se diferencian de las
clases de las siguientes maneras:

Puede usar parámetros posicionales para crear un tipo y sus instancias con
propiedades inmutables.
Los mismos métodos y operadores que indican la igualdad o desigualdad de la
referencia en las clases (como Object.Equals(Object) y == ), indican la igualdad o
desigualdad de valores en los registros.
Puede usar una expresión with para crear una copia de un objeto inmutable con
nuevos valores en las propiedades seleccionadas.
El método ToString de un registro crea una cadena con formato que muestra el
nombre de tipo de un objeto y los nombres y valores de todas sus propiedades
públicas.
Un registro puede heredar de otro registro. Un registro no puede heredar de una
clase y una clase no puede heredar de un registro.

Las estructuras de registro se diferencian de las estructuras en que el compilador

sintetiza los métodos para la igualdad y ToString . El compilador sintetiza un método
Deconstruct para las estructuras de registro posicional.

Ejemplos
En el ejemplo siguiente se define un registro público que usa parámetros posicionales
para declarar y crear instancias de un registro. A continuación, imprime el nombre de
tipo y los valores de propiedad:

C#

public record Person(string FirstName, string LastName);

public static void Main()

 Person person = new("Nancy", "Davolio");

Console.WriteLine(person);

// output: Person { FirstName = Nancy, LastName = Davolio }

En el ejemplo siguiente se muestra la igualdad de valores en los registros:

C#

public record Person(string FirstName, string LastName, string[]

PhoneNumbers);

public static void Main()

var phoneNumbers = new string[2];

Person person1 = new("Nancy", "Davolio", phoneNumbers);

Person person2 = new("Nancy", "Davolio", phoneNumbers);

Console.WriteLine(person1 == person2); // output: True

person1.PhoneNumbers[0] = "555-1234";

Console.WriteLine(person1 == person2); // output: True

Console.WriteLine(ReferenceEquals(person1, person2)); // output: False

En el ejemplo siguiente se muestra el uso de una expresión with para copiar un objeto
inmutable y cambiar una de las propiedades:

C#

public record Person(string FirstName, string LastName)

public string[] PhoneNumbers { get; init; }

public static void Main()

Person person1 = new("Nancy", "Davolio") { PhoneNumbers = new string[1]

};

Console.WriteLine(person1);

// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers

= System.String[] }

Person person2 = person1 with { FirstName = "John" };

Console.WriteLine(person2);

// output: Person { FirstName = John, LastName = Davolio, PhoneNumbers =

System.String[] }

Console.WriteLine(person1 == person2); // output: False

person2 = person1 with { PhoneNumbers = new string[1] };

Console.WriteLine(person2);

 // output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers

= System.String[] }

Console.WriteLine(person1 == person2); // output: False

person2 = person1 with { };

Console.WriteLine(person1 == person2); // output: True

Para obtener más información, consulte Registros (Referencia de C#).

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Interfaces: definir el comportamiento de
varios tipos
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Una interfaz contiene las definiciones de un grupo de funcionalidades relacionadas que

una class o una struct no abstracta deben implementar. Una interfaz puede definir
métodos static , que deben tener una implementación. Una interfaz puede definir una
implementación predeterminada de miembros. Una interfaz no puede declarar datos de
instancia, como campos, propiedades implementadas automáticamente o eventos
similares a las propiedades.

Mediante las interfaces puede incluir, por ejemplo, un comportamiento de varios

orígenes en una clase. Esta capacidad es importante en C# porque el lenguaje no
admite la herencia múltiple de clases. Además, debe usar una interfaz si desea simular la
herencia de estructuras, porque no pueden heredar de otra estructura o clase.

Para definir una interfaz, deberá usar la palabra clave interface, tal y como se muestra en
el ejemplo siguiente.

C#

interface IEquatable<T>

bool Equals(T obj);

El nombre de una interfaz debe ser un nombre de identificador de C# válido. Por

convención, los nombres de interfaz comienzan con una letra I mayúscula.

Cualquier clase o estructura que implementa la interfaz IEquatable<T> debe contener

una definición para un método Equals que coincida con la firma que la interfaz
especifica. Como resultado, puede contar con una clase que implementa IEquatable<T>
para contener un método Equals con el que una instancia de la clase puede determinar
si es igual a otra instancia de la misma clase.

La definición de IEquatable<T> no facilita ninguna implementación para Equals . Una

clase o estructura puede implementar varias interfaces, pero una clase solo puede
heredar de una sola clase.

Para obtener más información sobre las clases abstractas, vea Clases y miembros de
clase abstractos y sellados (Guía de programación de C#).
Las interfaces pueden contener propiedades, eventos, indizadores o métodos de
instancia, o bien cualquier combinación de estos cuatro tipos de miembros. Las
interfaces pueden contener constructores estáticos, campos, constantes u operadores. A
partir de C# 11, los miembros de interfaz que no son campos pueden ser static
abstract . Una interfaz no puede contener campos de instancia, constructores de

instancias ni finalizadores. Los miembros de interfaz son públicos de forma

predeterminada y se pueden especificar explícitamente modificadores de accesibilidad,
como public , protected , internal , private , protected internal o private protected .
Un miembro private debe tener una implementación predeterminada.

Para implementar un miembro de interfaz, el miembro correspondiente de la clase de

implementación debe ser público, no estático y tener el mismo nombre y firma que el
miembro de interfaz.

７ Nota

Cuando una interfaz declara miembros estáticos, un tipo que implementa esa
interfaz también puede declarar miembros estáticos con la misma firma. Los
miembros son distintos y se identifican de forma única mediante el tipo que
declara el miembro. El miembro estático declarado en un tipo no reemplaza el
miembro estático que se declara en la interfaz.

Una clase o estructura que implementa una interfaz debe proporcionar una
implementación para todos los miembros declarados sin una implementación
predeterminada proporcionada por la interfaz. Sin embargo, si una clase base
implementa una interfaz, cualquier clase que se derive de la clase base hereda esta
implementación.

En el siguiente ejemplo se muestra una implementación de la interfaz IEquatable<T>. La

clase de implementación Car debe proporcionar una implementación del método
Equals.

C#

public class Car : IEquatable<Car>

public string? Make { get; set; }

public string? Model { get; set; }

public string? Year { get; set; }

// Implementation of IEquatable<T> interface

public bool Equals(Car? car)

return (this.Make, this.Model, this.Year) ==

 (car?.Make, car?.Model, car?.Year);

Las propiedades y los indizadores de una clase pueden definir descriptores de acceso
adicionales para una propiedad o indizador que estén definidos en una interfaz. Por
ejemplo, una interfaz puede declarar una propiedad que tenga un descriptor de acceso
get. La clase que implementa la interfaz puede declarar la misma propiedad con un
descriptor de acceso get y set. Sin embargo, si la propiedad o el indizador usan una
implementación explícita, los descriptores de acceso deben coincidir. Para obtener más
información sobre la implementación explícita, vea Implementación de interfaz explícita
y Propiedades de interfaces.

Las interfaces pueden heredar de una o varias interfaces. La interfaz derivada hereda los
miembros de sus interfaces base. Una clase que implementa una interfaz derivada debe
implementar todos los miembros de esta, incluidos los de las interfaces base. Esa clase
puede convertirse implícitamente en la interfaz derivada o en cualquiera de sus
interfaces base. Una clase puede incluir una interfaz varias veces mediante las clases
base que hereda o mediante las interfaces que otras interfaces heredan. Sin embargo, la
clase puede proporcionar una implementación de una interfaz solo una vez y solo si la
clase declara la interfaz como parte de la definición de la clase ( class ClassName :
InterfaceName ). Si la interfaz se hereda porque se heredó una clase base que

implementa la interfaz, la clase base proporciona la implementación de los miembros de

la interfaz. Sin embargo, la clase derivada puede volver a implementar cualquier
miembro de la interfaz virtual, en lugar de usar la implementación heredada. Cuando las
interfaces declaran una implementación predeterminada de un método, cualquier clase
que las implemente heredará la implementación correspondiente (deberá convertir la
instancia de clase al tipo de interfaz para acceder a la implementación predeterminada
en el miembro de la interfaz).

Una clase base también puede implementar miembros de interfaz mediante el uso de
los miembros virtuales. En ese caso, una clase derivada puede cambiar el
comportamiento de la interfaz reemplazando los miembros virtuales. Para obtener más
información sobre los miembros virtuales, vea Polimorfismo.

Resumen de interfaces
Una interfaz tiene las propiedades siguientes:

En las versiones de C# anteriores a la 8.0, una interfaz es como una clase base
abstracta con solo miembros abstractos. Cualquier clase o estructura que
implemente la interfaz debe implementar todos sus miembros.
A partir de la versión 8.0 de C#, una interfaz puede definir implementaciones
predeterminadas para algunos o todos sus miembros. Una clase o estructura que
implemente la interfaz no tiene que implementar los miembros que tengan
implementaciones predeterminadas. Para obtener más información, vea Métodos
de interfaz predeterminados.
No se puede crear una instancia de una interfaz directamente. Sus miembros se
implementan por medio de cualquier clase o estructura que implementa la
interfaz.
Una clase o estructura puede implementar varias interfaces. Una clase puede
heredar una clase base y también implementar una o varias interfaces.
Clases y métodos genéricos
Artículo • 10/01/2023 • Tiempo de lectura: 3 minutos

Los genéricos introducen el concepto de parámetros de tipo a .NET, lo que le permite

diseñar clases y métodos que aplazan la especificación de uno o varios tipos hasta que
el código de cliente declare y cree una instancia de la clase o el método. Por ejemplo, al
usar un parámetro de tipo genérico T , puede escribir una clase única que otro código
de cliente puede usar sin incurrir en el costo o riesgo de conversiones en tiempo de
ejecución u operaciones de conversión boxing, como se muestra aquí:

C#

// Declare the generic class.

public class GenericList<T>

public void Add(T input) { }

class TestGenericList

private class ExampleClass { }

static void Main()

// Declare a list of type int.

GenericList<int> list1 = new GenericList<int>();

list1.Add(1);

// Declare a list of type string.

GenericList<string> list2 = new GenericList<string>();

list2.Add("");

// Declare a list of type ExampleClass.

GenericList<ExampleClass> list3 = new GenericList<ExampleClass>();

list3.Add(new ExampleClass());

Las clases y métodos genéricos combinan reusabilidad, seguridad de tipos y eficacia de

una manera en que sus homólogos no genéricos no pueden. Los genéricos se usan
frecuentemente con colecciones y los métodos que funcionan en ellas. El espacio de
nombres System.Collections.Generic contiene varias clases de colecciones basadas en
genéricos. No se recomiendan las colecciones no genéricas, como ArrayList, y se
mantienen por compatibilidad. Para más información, vea Elementos genéricos en .NET.

También se pueden crear tipos y métodos genéricos personalizados para proporcionar

soluciones y patrones de diseño generalizados propios con seguridad de tipos y
eficaces. En el ejemplo de código siguiente se muestra una clase genérica simple de lista
vinculada para fines de demostración. (En la mayoría de los casos, debe usar la clase
List<T> proporcionada por .NET en lugar de crear la suya propia). El parámetro de tipo
T se usa en diversas ubicaciones donde normalmente se usaría un tipo concreto para

indicar el tipo del elemento almacenado en la lista. Se usa de estas formas:

Como el tipo de un parámetro de método en el método AddHead .

Como el tipo de valor devuelto de la propiedad Data en la clase anidada Node .
Como el tipo de miembro privado data de la clase anidada.

T está disponible para la clase Node anidada. Cuando se crea una instancia de

GenericList<T> con un tipo concreto, por ejemplo como un GenericList<int> , cada

repetición de T se sustituye por int .

C#

// type parameter T in angle brackets

public class GenericList<T>

// The nested class is also generic on T.

private class Node

// T used in non-generic constructor.

public Node(T t)

next = null;

data = t;

private Node? next;

public Node? Next

get { return next; }

set { next = value; }

// T as private member data type.

private T data;

// T as return type of property.

public T Data

get { return data; }

set { data = value; }

private Node? head;

// constructor

public GenericList()

head = null;

// T as method parameter type:

public void AddHead(T t)

Node n = new Node(t);

n.Next = head;

head = n;

public IEnumerator<T> GetEnumerator()

Node? current = head;

while (current != null)

yield return current.Data;

current = current.Next;

En el ejemplo de código siguiente se muestra cómo el código de cliente usa la clase

genérica GenericList<T> para crear una lista de enteros. Simplemente cambiando el
argumento de tipo, el código siguiente puede modificarse fácilmente para crear listas de
cadenas o cualquier otro tipo personalizado:

C#

class TestGenericList

static void Main()

// int is the type argument

GenericList<int> list = new GenericList<int>();

for (int x = 0; x < 10; x++)

list.AddHead(x);

foreach (int i in list)

System.Console.Write(i + " ");

System.Console.WriteLine("\nDone");

Introducción a los genéricos

Use tipos genéricos para maximizar la reutilización del código, la seguridad de
tipos y el rendimiento.
El uso más común de los genéricos es crear clases de colección.
La biblioteca de clases de .NET contiene varias clases de colección genéricas en el
espacio de nombres System.Collections.Generic. Las colecciones genéricas se
deberían usar siempre que sea posible en lugar de clases como ArrayList en el
espacio de nombres System.Collections.
Puede crear sus propias interfaces, clases, métodos, eventos y delegados
genéricos.
Puede limitar las clases genéricas para habilitar el acceso a métodos en tipos de
datos determinados.
Puede obtener información sobre los tipos que se usan en un tipo de datos
genérico en tiempo de ejecución mediante la reflexión.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#.

Vea también
System.Collections.Generic
Elementos genéricos en .NET
Tipos anónimos
Artículo • 03/03/2023 • Tiempo de lectura: 5 minutos

Los tipos anónimos son una manera cómoda de encapsular un conjunto de propiedades
de solo lectura en un único objeto sin tener que definir primero un tipo explícitamente.
El compilador genera el nombre del tipo y no está disponible en el nivel de código
fuente. El compilador deduce el tipo de cada propiedad.

Para crear tipos anónimos, use el operador new con un inicializador de objeto. Para
obtener más información sobre los inicializadores de objeto, vea Inicializadores de
objeto y colección (Guía de programación de C#).

En el ejemplo siguiente se muestra un tipo anónimo que se inicializa con dos

propiedades llamadas Amount y Message .

C#

var v = new { Amount = 108, Message = "Hello" };

// Rest the mouse pointer over v.Amount and v.Message in the following

// statement to verify that their inferred types are int and string.

Console.WriteLine(v.Amount + v.Message);

Los tipos anónimos suelen usarse en la cláusula select de una expresión de consulta
para devolver un subconjunto de las propiedades de cada objeto en la secuencia de
origen. Para más información sobre las consultas, vea LINQ en C#.

Los tipos anónimos contienen una o varias propiedades públicas de solo lectura. No es
válido ningún otro tipo de miembros de clase, como métodos o eventos. La expresión
que se usa para inicializar una propiedad no puede ser null , una función anónima o un
tipo de puntero.

El escenario más habitual es inicializar un tipo anónimo con propiedades de otro tipo.
En el siguiente ejemplo, se da por hecho que existe una clase con el nombre Product . La
clase Product incluye las propiedades Color y Price , junto con otras propiedades que
no son de su interés. La variable products es una colección de objetos Product . La
declaración de tipo anónimo comienza con la palabra clave new . La declaración inicializa
un nuevo tipo que solo usa dos propiedades de Product . El uso de tipos anónimos hace
que la consulta devuelva una cantidad de datos menor.

Si no especifica nombres de miembros en el tipo anónimo, el compilador da a los

miembros de este tipo el nombre de la propiedad que se usa para inicializarlos. Debe
proporcionar un nombre para una propiedad que se está inicializando con una
expresión, como se muestra en el ejemplo anterior. En el siguiente ejemplo, los nombres
de las propiedades del tipo anónimo son Color y Price .

C#

var productQuery =

from prod in products

select new { prod.Color, prod.Price };

foreach (var v in productQuery)

Console.WriteLine("Color={0}, Price={1}", v.Color, v.Price);

 Sugerencia

Puede usar la regla de estilo de .NET IDE0037 para aplicar si se prefieren los
nombres de miembros inferidos o explícitos.

También es posible definir un campo por objeto de otro tipo: clase, estructura o incluso
otro tipo anónimo. Se realiza mediante el uso de la variable que contiene este objeto
igual que en el ejemplo siguiente, donde se crean dos tipos anónimos mediante tipos
definidos por el usuario para los que ya se han creado instancias. En ambos casos, el
campo product del tipo anónimo shipment y shipmentWithBonus será de tipo Product
que contiene los valores predeterminados de cada campo. Y el campo bonus será de
tipo anónimo creado por el compilador.

C#

var product = new Product();

var bonus = new { note = "You won!" };

var shipment = new { address = "Nowhere St.", product };

var shipmentWithBonus = new { address = "Somewhere St.", product, bonus };

Normalmente, cuando se usa un tipo anónimo para inicializar una variable, la variable se
declara como variable local con tipo implícito mediante var. El nombre del tipo no se
puede especificar en la declaración de la variable porque solo el compilador tiene
acceso al nombre subyacente del tipo anónimo. Para obtener más información sobre
var , vea Variables locales con asignación implícita de tipos.

Puede crear una matriz de elementos con tipo anónimo combinando una variable local
con tipo implícito y una matriz con tipo implícito, como se muestra en el ejemplo
siguiente.

C#

var anonArray = new[] { new { name = "apple", diam = 4 }, new { name =

"grape", diam = 1 }};

Los tipos anónimos son tipos class que derivan directamente de object y que no se
pueden convertir a ningún tipo excepto object. El compilador proporciona un nombre
para cada tipo anónimo, aunque la aplicación no pueda acceder a él. Desde el punto de
vista de Common Language Runtime, un tipo anónimo no es diferente de otros tipos de
referencia.

Si dos o más inicializadores de objeto anónimo en un ensamblado especifican una

secuencia de propiedades que están en el mismo orden y que tienen los mismos
nombres y tipos, el compilador trata el objeto como instancias del mismo tipo.
Comparten la misma información de tipo generada por el compilador.

Los tipos anónimos admiten la mutación no destructiva en forma de con expresiones.

Esto le permite crear una nueva instancia de un tipo anónimo en el que una o varias
propiedades tienen nuevos valores:

C#

var apple = new { Item = "apples", Price = 1.35 };

var onSale = apple with { Price = 0.79 };

Console.WriteLine(apple);

Console.WriteLine(onSale);

No se puede declarar que un campo, una propiedad, un evento o el tipo de valor

devuelto de un método tengan un tipo anónimo. De forma similar, no se puede declarar
que un parámetro formal de un método, propiedad, constructor o indizador tenga un
tipo anónimo. Para pasar un tipo anónimo, o una colección que contiene tipos
anónimos, como un argumento a un método, puede declarar el parámetro como
object de tipo. Sin embargo, el uso de object para tipos anónimos anula el propósito
de la coincidencia segura. Si tiene que almacenar resultados de consulta o pasarlos
fuera del límite del método, considere la posibilidad de usar un struct o una clase con
nombre normal en lugar de un tipo anónimo.

Como los métodos Equals y GetHashCode de tipos anónimos se definen en términos de

los métodos Equals y GetHashCode de las propiedades, dos instancias del mismo tipo
anónimo son iguales solo si todas sus propiedades son iguales.
Los tipos anónimos invalidan el método ToString, concatenando el nombre y la salida
ToString de cada propiedad rodeada de llaves.

var v = new { Title = "Hello", Age = 24 };

Console.WriteLine(v.ToString()); // "{ Title = Hello, Age = 24 }"

Información general de clases,

estructuras y registros en C#
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

En C#, la definición de un tipo (una clase, estructura o registro) es como un plano

técnico que especifica lo que el tipo puede hacer. Un objeto es básicamente un bloque
de memoria que se ha asignado y configurado de acuerdo con el plano. En este artículo
se proporciona información general de estos planos técnicos y sus características. En el
siguiente artículo de esta serie se presentan los objetos.

Encapsulación
A veces se hace referencia a la encapsulación como el primer pilar o principio de la
programación orientada a objetos. Una clase o una estructura pueden especificar hasta
qué punto se puede acceder a sus miembros para codificar fuera de la clase o la
estructura. No se prevé el uso de los métodos y las variables fuera de la clase, o el
ensamblado puede ocultarse para limitar el potencial de los errores de codificación o de
los ataques malintencionados. Para más información, consulte el tutorial Programación
orientada a objetos.

Miembros
Los miembros de un tipo incluyen todos los métodos, campos, constantes, propiedades
y eventos. En C#, no hay métodos ni variables globales como en otros lenguajes. Incluso
se debe declarar el punto de entrada de un programa, el método Main , dentro de una
clase o estructura (de forma implícita cuando usa instrucciones de nivel superior).

La lista siguiente incluye los diversos tipos de miembros que se pueden declarar en una
clase, estructura o registro.

Campos
Constantes
Propiedades
Métodos
Constructores
Events
Finalizadores
Indexadores
Operadores
 Tipos anidados

Para más información, consulte Miembros.

Accesibilidad
Algunos métodos y propiedades están diseñados para ser invocables y accesibles desde
el código fuera de una clase o estructura, lo que se conoce como código de cliente.
Otros métodos y propiedades pueden estar indicados exclusivamente para utilizarse en
la propia clase o estructura. Es importante limitar la accesibilidad del código, a fin de
que solo el código de cliente previsto pueda acceder a él. Puede usar los siguientes
modificadores de acceso para especificar hasta qué punto los tipos y sus miembros son
accesibles para el código de cliente:

public
protected
internal
protected internal
private
private protected

La accesibilidad predeterminada es private .

Herencia
Las clases (pero no las estructuras) admiten el concepto de herencia. Una clase que
deriva de otra clase (denominada clase base) contiene automáticamente todos los
miembros públicos, protegidos e internos de la clase base, salvo sus constructores y
finalizadores.

Las clases pueden declararse como abstract, lo que significa que uno o varios de sus
métodos no tienen ninguna implementación. Aunque no se pueden crear instancias de
clases abstractas directamente, pueden servir como clases base para otras clases que
proporcionan la implementación que falta. Las clases también pueden declararse como
sealed para evitar que otras clases hereden de ellas.

Para más información, vea Herencia y Polimorfismo.

Interfaces
Las clases, las estructuras y los registros pueden implementar varias interfaces.
Implementar de una interfaz significa que el tipo implementa todos los métodos
definidos en la interfaz. Para más información, vea Interfaces.

Tipos genéricos
Las clases, las estructuras y los registros pueden definirse con uno o varios parámetros
de tipo. El código de cliente proporciona el tipo cuando crea una instancia del tipo. Por
ejemplo, la clase List<T> del espacio de nombres System.Collections.Generic se define
con un parámetro de tipo. El código de cliente crea una instancia de List<string> o
List<int> para especificar el tipo que contendrá la lista. Para más información, vea
Genéricos.

Tipos estáticos
Las clases (pero no las estructuras ni los registros) pueden declararse como static . Una
clase estática puede contener solo miembros estáticos y no se puede crear una instancia
de ellos con la palabra clave new . Una copia de la clase se carga en memoria cuando se
carga el programa, y sus miembros son accesibles a través del nombre de clase. Las
clases, las estructuras y los registros pueden contener miembros estáticos. Para obtener
más información, vea Clases estáticas y sus miembros.

Tipos anidados
Una clase, estructura o registro se puede anidar dentro de otra clase, estructura o
registro. Para obtener más información, consulte Tipos anidados.

Tipos parciales
Puede definir parte de una clase, estructura o método en un archivo de código y otra
parte en un archivo de código independiente. Para más información, vea Clases y
métodos parciales.

Inicializadores de objeto
Puede crear instancias e inicializar objetos de clase o estructura, así como colecciones
de objetos, asignando valores a sus propiedades. Para más información, consulte
Procedimiento para inicializar un objeto mediante un inicializador de objeto.
Tipos anónimos
En situaciones donde no es conveniente o necesario crear una clase con nombre, utilice
los tipos anónimos. Los tipos anónimos se definen mediante sus miembros de datos con
nombre. Para obtener más información, consulte Tipos anónimos (Guía de
programación de C#).

Métodos de extensión
Puede "extender" una clase sin crear una clase derivada mediante la creación de un tipo
independiente. Ese tipo contiene métodos a los que se puede llamar como si
perteneciesen al tipo original. Para más información, consulte Métodos de extensión.

Variables locales con asignación implícita de

tipos
Dentro de un método de clase o estructura, puede utilizar tipos implícitos para indicar al
compilador que determine el tipo de una variable en tiempo de compilación. Para más
información, consulte var (referencia de C#).

Registros
C# 9 presenta el tipo record , un tipo de referencia que se puede crear en lugar de una
clase o una estructura. Los registros son clases con un comportamiento integrado para
encapsular datos en tipos inmutables. C# 10 presenta el tipo de valor record struct . Un
registro ( record class o record struct ) proporciona las siguientes características:

Sintaxis concisa para crear un tipo de referencia con propiedades inmutables.

Igualdad de valores.
Dos variables de un tipo de registro son iguales si tienen el
mismo tipo y si, por cada campo, los valores en ambos registros son iguales. Las
clases usan la igualdad de referencia: dos variables de un tipo de clase son iguales
si hacen referencia al mismo objeto.
Sintaxis concisa para la mutación no destructiva.
Una expresión with permite crear
una copia de una instancia de registro existente, pero con los valores de propiedad
especificados modificados.
Formato integrado para la presentación.
El método ToString imprime el nombre
del tipo de registro y los nombres y valores de las propiedades públicas.
Compatibilidad con jerarquías de herencia en clases de registro.
Las clases de
registro admiten la herencia. Las clases de structs no admiten la herencia.
Para obtener más información, consulte Registros.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Objetos: creación de instancias de tipos
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Una definición de clase o estructura es como un plano que especifica qué puede hacer
el tipo. Un objeto es básicamente un bloque de memoria que se ha asignado y
configurado de acuerdo con el plano. Un programa puede crear muchos objetos de la
misma clase. Los objetos también se denominan instancias y pueden almacenarse en
una variable con nombre, o en una matriz o colección. El código de cliente es el código
que usa estas variables para llamar a los métodos y acceder a las propiedades públicas
del objeto. En un lenguaje orientado a objetos, como C#, un programa típico consta de
varios objetos que interactúan dinámicamente.

７ Nota

Los tipos estáticos se comportan de forma diferente a lo que se describe aquí. Para
más información, vea Clases estáticas y sus miembros.

Instancias de estructura frente a Instancias de

clase
Puesto que las clases son tipos de referencia, una variable de un objeto de clase
contiene una referencia a la dirección del objeto del montón administrado. Si se asigna
una segunda variable del mismo tipo a la primera variable, ambas variables hacen
referencia al objeto de esa dirección. Este punto se analiza con más detalle más adelante
en este artículo.

Las instancias de clases se crean mediante el operador new. En el ejemplo siguiente,

Person es el tipo, y person1 y person2 son instancias u objetos de ese tipo.

C#

public class Person

public string Name { get; set; }

public int Age { get; set; }

public Person(string name, int age)

Name = name;

Age = age;

// Other properties, methods, events...

 class Program

static void Main()

Person person1 = new Person("Leopold", 6);

Console.WriteLine("person1 Name = {0} Age = {1}", person1.Name,

person1.Age);

// Declare new person, assign person1 to it.

Person person2 = person1;

// Change the name of person2, and person1 also changes.

person2.Name = "Molly";

person2.Age = 16;

Console.WriteLine("person2 Name = {0} Age = {1}", person2.Name,

person2.Age);

Console.WriteLine("person1 Name = {0} Age = {1}", person1.Name,

person1.Age);

/*

Output:

person1 Name = Leopold Age = 6

person2 Name = Molly Age = 16

person1 Name = Molly Age = 16
*/

Dado que las estructuras son tipos de valor, una variable de un objeto de estructura
contiene una copia de todo el objeto. También se pueden crear instancias de estructuras
usando el operador new , pero esto no resulta necesario, como se muestra en el ejemplo
siguiente:

C#

namespace Example;

public struct Person

public string Name;

public int Age;

public Person(string name, int age)

Name = name;

Age = age;

public class Application

static void Main()

// Create struct instance and initialize by using "new".

// Memory is allocated on thread stack.

Person p1 = new Person("Alex", 9);

Console.WriteLine("p1 Name = {0} Age = {1}", p1.Name, p1.Age);

// Create new struct object. Note that struct can be initialized

// without using "new".

Person p2 = p1;

// Assign values to p2 members.

p2.Name = "Spencer";

p2.Age = 7;

Console.WriteLine("p2 Name = {0} Age = {1}", p2.Name, p2.Age);

// p1 values remain unchanged because p2 is copy.

Console.WriteLine("p1 Name = {0} Age = {1}", p1.Name, p1.Age);

/*

Output:

p1 Name = Alex Age = 9

p2 Name = Spencer Age = 7

p1 Name = Alex Age = 9

*/

La memoria para p1 y p2 se asigna en la pila de subprocesos. Esta memoria se reclama

junto con el tipo o método en el que se declara. Este es uno de los motivos por los que
se copian las estructuras en la asignación. Por el contrario, la memoria que se asigna a
una instancia de clase la reclama automáticamente (recolección de elementos no
utilizados) Common Language Runtime cuando todas las referencias al objeto se han
salido del ámbito. No es posible destruir de forma determinante un objeto de clase
como en C++. Para obtener más información sobre la recolección de elementos no
utilizados en .NET, vea Recolección de elementos no utilizados.

７ Nota

La asignación y desasignación de memoria en el montón administrado están muy

optimizadas en Common Language Runtime. En la mayoría de los casos, no existe
ninguna diferencia significativa en el costo de rendimiento entre asignar una
instancia de clase en el montón y asignar una instancia de estructura en la pila.

Identidad de objeto frente a igualdad de

valores
Cuando se comparan dos objetos para comprobar si son iguales, primero debe
determinar si quiere saber si las dos variables representan el mismo objeto en la
memoria o si los valores de uno o varios de sus campos son equivalentes. Si tiene
previsto comparar valores, debe tener en cuenta si los objetos son instancias de tipos de
valor (estructuras) o tipos de referencia (clases, delegados y matrices).

Para determinar si dos instancias de clase hacen referencia a la misma ubicación en

la memoria (lo que significa que tienen la misma identidad), use el método estático
Object.Equals. (System.Object es la clase base implícita para todos los tipos de
valor y tipos de referencia, incluidas las clases y estructuras definidas por el
usuario).

Para determinar si los campos de instancia de dos instancias de estructura

presentan los mismos valores, use el método ValueType.Equals. Dado que todas las
estructuras heredan implícitamente de System.ValueType, se llama al método
directamente en el objeto, como se muestra en el ejemplo siguiente:

C#

// Person is defined in the previous example.

//public struct Person

//{

// public string Name;

// public int Age;

// public Person(string name, int age)

// {

// Name = name;

// Age = age;

// }

//}

Person p1 = new Person("Wallace", 75);

Person p2 = new Person("", 42);

p2.Name = "Wallace";

p2.Age = 75;

if (p2.Equals(p1))

Console.WriteLine("p2 and p1 have the same values.");

// Output: p2 and p1 have the same values.

En algunos casos, la implementación de System.ValueType de Equals utiliza la

conversión boxing y la reflexión. Para obtener información sobre cómo
proporcionar un algoritmo de igualdad eficaz que sea específico del tipo, consulte
Definición de la igualdad de valores para un tipo. Los registros son tipos de
referencia que usan semántica de valores para la igualdad.
 Para determinar si los valores de los campos de dos instancias de clase son iguales,
puede usar el método Equals o el operador ==. En cambio, úselos solo si la clase
los ha invalidado o sobrecargado para proporcionar una definición personalizada
de lo que significa "igualdad" para los objetos de ese tipo. La clase también puede
implementar la interfaz IEquatable<T> o la interfaz IEqualityComparer<T>. Ambas
interfaces proporcionan métodos que pueden servir para comprobar la igualdad
de valores. Al diseñar sus propias clases que invaliden Equals , asegúrese de seguir
las instrucciones descritas en Procedimiento: Definición de la igualdad de valores
para un tipo y Object.Equals(Object).

Secciones relacionadas
Para obtener más información:

Clases
Constructores
Finalizadores
Eventos
object
Herencia
class
Tipos de estructura
new (operador)
Sistema de tipos comunes
Herencia: deriva tipos para crear un
comportamiento más especializado
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

La herencia, junto con la encapsulación y el polimorfismo, es una de las tres

características principales de la programación orientada a objetos. La herencia permite
crear clases que reutilizan, extienden y modifican el comportamiento definido en otras
clases. La clase cuyos miembros se heredan se denomina clase base y la clase que
hereda esos miembros se denomina clase derivada. Una clase derivada solo puede tener
una clase base directa, pero la herencia es transitiva. Si ClassC se deriva de ClassB y
ClassB se deriva de ClassA , ClassC hereda los miembros declarados en ClassB y

ClassA .

７ Nota

Los structs no admiten la herencia, pero pueden implementar interfaces.

Conceptualmente, una clase derivada es una especialización de la clase base. Por

ejemplo, si tiene una clase base Animal , podría tener una clase derivada denominada
Mammal y otra clase derivada denominada Reptile . Mammal es Animal y Reptile también

es Animal , pero cada clase derivada representa especializaciones diferentes de la clase

base.

Las declaraciones de interfaz pueden definir una implementación predeterminada de

sus miembros. Estas implementaciones las heredan las interfaces derivadas y las clases
que implementan esas interfaces. Para más información sobre los métodos de interfaz
predeterminados, consulte el artículo sobre interfaces.

Cuando se define una clase para que derive de otra clase, la clase derivada obtiene
implícitamente todos los miembros de la clase base, salvo sus constructores y sus
finalizadores. La clase derivada reutiliza el código de la clase base sin tener que volver a
implementarlo. Puede agregar más miembros en la clase derivada. La clase derivada
amplía la funcionalidad de la clase base.

En la ilustración siguiente se muestra una clase WorkItem que representa un elemento

de trabajo de un proceso empresarial. Como con todas las clases, se deriva de
System.Object y hereda todos sus métodos. WorkItem agrega seis miembros propios.
Estos miembros incluyen un constructor, porque los constructores no se heredan. La
clase ChangeRequest hereda de WorkItem y representa un tipo concreto de elemento de
trabajo. ChangeRequest agrega dos miembros más a los miembros que hereda de
WorkItem y de Object. Debe agregar su propio constructor y además agrega
originalItemID . La propiedad originalItemID permite que la instancia ChangeRequest

se asocie con el WorkItem original al que se aplica la solicitud de cambio.

En el ejemplo siguiente se muestra cómo se expresan en C# las relaciones de clase de la

ilustración anterior. En el ejemplo también se muestra cómo WorkItem reemplaza el
método virtual Object.ToString y cómo la clase ChangeRequest hereda la implementación
WorkItem del método. En el primer bloque se definen las clases:

C#

// WorkItem implicitly inherits from the Object class.

public class WorkItem

// Static field currentID stores the job ID of the last WorkItem that

// has been created.

private static int currentID;

//Properties.

protected int ID { get; set; }

protected string Title { get; set; }

protected string Description { get; set; }

protected TimeSpan jobLength { get; set; }

// Default constructor. If a derived class does not invoke a base-

// class constructor explicitly, the default constructor is called

// implicitly.

public WorkItem()

ID = 0;

Title = "Default title";

Description = "Default description.";

 jobLength = new TimeSpan();

// Instance constructor that has three parameters.

public WorkItem(string title, string desc, TimeSpan joblen)

this.ID = GetNextID();

this.Title = title;

this.Description = desc;

this.jobLength = joblen;

// Static constructor to initialize the static member, currentID. This

// constructor is called one time, automatically, before any instance

// of WorkItem or ChangeRequest is created, or currentID is referenced.

static WorkItem() => currentID = 0;

// currentID is a static field. It is incremented each time a new

// instance of WorkItem is created.

protected int GetNextID() => ++currentID;

// Method Update enables you to update the title and job length of an

// existing WorkItem object.

public void Update(string title, TimeSpan joblen)

this.Title = title;

this.jobLength = joblen;

// Virtual method override of the ToString method that is inherited

// from System.Object.

public override string ToString() =>

$"{this.ID} - {this.Title}";

// ChangeRequest derives from WorkItem and adds a property (originalItemID)

// and two constructors.

public class ChangeRequest : WorkItem

protected int originalItemID { get; set; }

// Constructors. Because neither constructor calls a base-class

// constructor explicitly, the default constructor in the base class

// is called implicitly. The base class must contain a default

// constructor.

// Default constructor for the derived class.

public ChangeRequest() { }

// Instance constructor that has four parameters.

public ChangeRequest(string title, string desc, TimeSpan jobLen,

int originalID)

// The following properties and the GetNexID method are inherited

// from WorkItem.

 this.ID = GetNextID();

this.Title = title;

this.Description = desc;

this.jobLength = jobLen;

// Property originalItemID is a member of ChangeRequest, but not

// of WorkItem.

this.originalItemID = originalID;

En el bloque siguiente se muestra cómo usar las clases base y derivadas:

C#

// Create an instance of WorkItem by using the constructor in the

// base class that takes three arguments.

WorkItem item = new WorkItem("Fix Bugs",

"Fix all bugs in my code branch",

new TimeSpan(3, 4, 0, 0));

// Create an instance of ChangeRequest by using the constructor in

// the derived class that takes four arguments.

ChangeRequest change = new ChangeRequest("Change Base Class Design",

"Add members to the class",

new TimeSpan(4, 0, 0),

1);

// Use the ToString method defined in WorkItem.

Console.WriteLine(item.ToString());

// Use the inherited Update method to change the title of the

// ChangeRequest object.

change.Update("Change the Design of the Base Class",

new TimeSpan(4, 0, 0));

// ChangeRequest inherits WorkItem's override of ToString.

Console.WriteLine(change.ToString());

/* Output:

1 - Fix Bugs

2 - Change the Design of the Base Class

*/

Métodos abstractos y virtuales

Cuando una clase base declara un método como virtual, una clase derivada puede
aplicar override al método con una implementación propia. Si una clase base declara un
miembro como abstract, ese método se debe reemplazar en todas las clases no
abstractas que hereden directamente de dicha clase. Si una clase derivada es abstracta,
hereda los miembros abstractos sin implementarlos. Los miembros abstractos y virtuales
son la base del polimorfismo, que es la segunda característica principal de la
programación orientada a objetos. Para obtener más información, vea Polimorfismo .

Clases base abstractas

Puede declarar una clase como abstracta si quiere impedir la creación directa de
instancias mediante el operador new. Una clase abstracta solo se puede usar si a partir
de ella se deriva una clase nueva. Una clase abstracta puede contener una o más firmas
de método que, a su vez, se declaran como abstractas. Estas firmas especifican los
parámetros y el valor devuelto, pero no tienen ninguna implementación (cuerpo del
método). Una clase abstracta no tiene que contener miembros abstractos, pero si lo
hace, la clase se debe declarar como abstracta. Las clases derivadas que no son
abstractas deben proporcionar la implementación para todos los métodos abstractos de
una clase base abstracta.

Interfaces
Una interfaz es un tipo de referencia que define un conjunto de miembros. Todas las
clases y estructuras que implementan esa interfaz deben implementar ese conjunto de
miembros. Una interfaz puede definir una implementación predeterminada para todos o
ninguno de estos miembros. Una clase puede implementar varias interfaces, aunque
solo puede derivar de una única clase base directa.

Las interfaces se usan para definir funciones específicas para clases que no tienen
necesariamente una relación "es un/una". Por ejemplo, la interfaz System.IEquatable<T>
se puede implementar mediante cualquier clase o estructura para determinar si dos
objetos del tipo son equivalentes (pero el tipo define la equivalencia). IEquatable<T> no
implica el mismo tipo de relación "es un/una" que existe entre una clase base y una
clase derivada (por ejemplo, Mammal es Animal ). Para más información, vea Interfaces.

Impedir la derivación adicional

Una clase puede impedir que otras clases hereden de ella, o de cualquiera de sus
miembros, si se declara a sí misma o al miembro como sealed.

Clase derivada que oculta miembros de clase

base
Una clase derivada puede ocultar miembros de clase base si declara los miembros con
el mismo nombre y firma. Se puede usar el modificador new para indicar de forma
explícita que el miembro no está diseñado para reemplazar al miembro base. No es
necesario usar new, pero se generará una advertencia del compilador si no se usa new.
Para obtener más información, vea Control de versiones con las palabras clave Override
y New y Saber cuándo usar las palabras clave Override y New.
Polimorfismo
Artículo • 31/01/2023 • Tiempo de lectura: 8 minutos

El polimorfismo suele considerarse el tercer pilar de la programación orientada a

objetos, después de la encapsulación y la herencia. Polimorfismo es una palabra griega
que significa "con muchas formas" y tiene dos aspectos diferentes:

En tiempo de ejecución, los objetos de una clase derivada pueden ser tratados
como objetos de una clase base en lugares como parámetros de métodos y
colecciones o matrices. Cuando se produce este polimorfismo, el tipo declarado
del objeto ya no es idéntico a su tipo en tiempo de ejecución.
Las clases base pueden definir e implementar métodosvirtuales, y las clases
derivadas pueden invalidarlos, lo que significa que pueden proporcionar su propia
definición e implementación. En tiempo de ejecución, cuando el código de cliente
llama al método, CLR busca el tipo en tiempo de ejecución del objeto e invoca esa
invalidación del método virtual. En el código fuente puede llamar a un método en
una clase base y hacer que se ejecute una versión del método de la clase derivada.

Los métodos virtuales permiten trabajar con grupos de objetos relacionados de manera
uniforme. Por ejemplo, supongamos que tiene una aplicación de dibujo que permite a
un usuario crear varios tipos de formas en una superficie de dibujo. En tiempo de
compilación, no sabe qué tipos de formas en concreto creará el usuario. Sin embargo, la
aplicación tiene que realizar el seguimiento de los distintos tipos de formas que se
crean, y tiene que actualizarlos en respuesta a las acciones del mouse del usuario. Para
solucionar este problema en dos pasos básicos, puede usar el polimorfismo:

1. Crear una jerarquía de clases en la que cada clase de forma específica deriva de
una clase base común.
2. Usar un método virtual para invocar el método apropiado en una clase derivada
mediante una sola llamada al método de la clase base.

Primero, cree una clase base llamada Shape y clases derivadas como Rectangle , Circle
y Triangle . Dé a la clase Shape un método virtual llamado Draw e invalídelo en cada
clase derivada para dibujar la forma determinada que la clase representa. Cree un
objeto List<Shape> y agréguele una instancia de Circle , Triangle y Rectangle .

C#

public class Shape

// A few example members

public int X { get; private set; }

public int Y { get; private set; }

 public int Height { get; set; }

public int Width { get; set; }

// Virtual method

public virtual void Draw()

Console.WriteLine("Performing base class drawing tasks");

public class Circle : Shape

public override void Draw()

// Code to draw a circle...

Console.WriteLine("Drawing a circle");

base.Draw();

public class Rectangle : Shape

public override void Draw()

// Code to draw a rectangle...

Console.WriteLine("Drawing a rectangle");

base.Draw();

public class Triangle : Shape

public override void Draw()

// Code to draw a triangle...

Console.WriteLine("Drawing a triangle");

base.Draw();

Para actualizar la superficie de dibujo, use un bucle foreach para iterar por la lista y
llamar al método Draw en cada objeto Shape de la lista. Aunque cada objeto de la lista
tenga un tipo declarado de Shape , se invocará el tipo en tiempo de ejecución (la versión
invalidada del método en cada clase derivada).

C#

// Polymorphism at work #1: a Rectangle, Triangle and Circle

// can all be used wherever a Shape is expected. No cast is

// required because an implicit conversion exists from a derived

// class to its base class.

var shapes = new List<Shape>

new Rectangle(),

 new Triangle(),

new Circle()

};

// Polymorphism at work #2: the virtual method Draw is

// invoked on each of the derived classes, not the base class.

foreach (var shape in shapes)

shape.Draw();

/* Output:

Drawing a rectangle

Performing base class drawing tasks

Drawing a triangle

Performing base class drawing tasks

Drawing a circle

Performing base class drawing tasks

*/

En C#, cada tipo es polimórfico porque todos los tipos, incluidos los definidos por el
usuario, heredan de Object.

Introducción al polimorfismo

Miembros virtuales
Cuando una clase derivada hereda de una clase base, incluye todos los miembros de la
clase base. Todo el comportamiento declarado en la clase base forma parte de la clase
derivada. Esto permite que los objetos de la clase derivada se traten como objetos de la
clase base. Los modificadores de acceso ( public , protected , private etc.) determinan si
esos miembros son accesibles desde la implementación de la clase derivada. Los
métodos virtuales proporcionan al diseñador diferentes opciones para el
comportamiento de la clase derivada:

La clase derivada puede invalidar los miembros virtuales de la clase base, y definir
un comportamiento nuevo.
La clase derivada hereda el método de clase base más cercano sin invalidarlo para
conservar el comportamiento existente, pero permite que más clases derivadas
invaliden el método.
La clase derivada puede definir una nueva implementación no virtual de esos
miembros que oculte las implementaciones de la clase base.

Una clase derivada puede invalidar un miembro de la clase base si este se declara como
virtual o abstracto. El miembro derivado debe usar la palabra clave override para indicar
explícitamente que el propósito del método es participar en una invocación virtual. El
siguiente fragmento de código muestra un ejemplo:

C#

public class BaseClass

public virtual void DoWork() { }

public virtual int WorkProperty

get { return 0; }

public class DerivedClass : BaseClass

public override void DoWork() { }

public override int WorkProperty

get { return 0; }

Los campos no pueden ser virtuales; solo pueden serlo los métodos, propiedades,
eventos e indizadores. Cuando una clase derivada invalida un miembro virtual, se llama
a ese miembro aunque se acceda a una instancia de esa clase como una instancia de la
clase base. El siguiente fragmento de código muestra un ejemplo:

C#

DerivedClass B = new DerivedClass();

B.DoWork(); // Calls the new method.

BaseClass A = B;

A.DoWork(); // Also calls the new method.

Los métodos y propiedades virtuales permiten a las clases derivadas extender una clase
base sin necesidad de usar la implementación de clase base de un método. Para obtener
más información, consulte Control de versiones con las palabras clave Override y New.
Una interfaz proporciona otra manera de definir un método o conjunto de métodos
cuya implementación se deja a las clases derivadas.

Ocultación de miembros de clase base con miembros

nuevos
Si quiere que la clase derivada tenga un miembro con el mismo nombre que el de un
miembro de una clase base, puede usar la palabra clave new para ocultar el miembro de
clase base. La palabra clave new se coloca antes que el tipo devuelto del miembro de la
clase que se está reemplazando. El siguiente fragmento de código muestra un ejemplo:

C#

public class BaseClass

public void DoWork() { WorkField++; }

public int WorkField;

public int WorkProperty

get { return 0; }

public class DerivedClass : BaseClass

public new void DoWork() { WorkField++; }

public new int WorkField;

public new int WorkProperty

get { return 0; }

Se puede acceder a los miembros de la clase base ocultos desde el código de cliente si
se convierte la instancia de la clase derivada en una instancia de la clase base. Por
ejemplo:

C#

DerivedClass B = new DerivedClass();

B.DoWork(); // Calls the new method.

BaseClass A = (BaseClass)B;

A.DoWork(); // Calls the old method.

Evasión de que las clases derivadas invaliden los

miembros virtuales
Los miembros virtuales siguen siendo virtuales con independencia de cuántas clases se
hayan declarado entre el miembro virtual y la clase que originalmente lo haya
declarado. Si la clase A declara un miembro virtual y la clase B deriva de A , y la clase C
de B , la clase C hereda el miembro virtual y puede invalidarlo, independientemente de
que la clase B haya declarado una invalidación para ese miembro. El siguiente
fragmento de código muestra un ejemplo:
 C#

public class A

public virtual void DoWork() { }

}

public class B : A

public override void DoWork() { }

Una clase derivada puede detener la herencia virtual al declarar una invalidación como
sealed. Para detener la herencia, es necesario colocar la palabra clave sealed antes de la
palabra clave override en la declaración del miembro de la clase. El siguiente
fragmento de código muestra un ejemplo:

C#

public class C : B

public sealed override void DoWork() { }

En el ejemplo anterior, el método DoWork ya no es virtual para ninguna clase que se

derive de C . Sigue siendo virtual para las instancias de C , aunque se conviertan al tipo
B o al tipo A . Los métodos sellados se pueden reemplazar por clases derivadas

mediante la palabra clave new , como se muestra en el ejemplo siguiente:

C#

public class D : C

public new void DoWork() { }

En este caso, si se llama a DoWork en D con una variable de tipo D , se llama a la nueva
instancia de DoWork . Si se usa una variable de tipo C , B o A para acceder a una
instancia de D , la llamada a DoWork seguirá las reglas de herencia virtual y enrutará esas
llamadas a la implementación de DoWork en la clase C .

Acceso a miembros virtuales de clases base desde clases

derivadas
Una clase derivada que ha reemplazado o invalidado un método o propiedad puede
seguir accediendo al método o propiedad en la clase base usando la siguiente palabra
clave base . El siguiente fragmento de código muestra un ejemplo:

C#

public class Base

public virtual void DoWork() {/*...*/ }

public class Derived : Base

public override void DoWork()

//Perform Derived's work here

//...

// Call DoWork on base class

base.DoWork();

Para obtener más información, vea base.

７ Nota

Se recomienda que las máquinas virtuales usen base para llamar a la

implementación de la clase base de ese miembro en su propia implementación.
Dejar que se produzca el comportamiento de la clase base permite a la clase
derivada concentrarse en implementar el comportamiento específico de la clase
derivada. Si no se llama a la implementación de la clase base, depende de la clase
derivada hacer que su comportamiento sea compatible con el de la clase base.
Información general sobre la
coincidencia de patrones
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

La coincidencia de patrones es una técnica consistente en probar una expresión para

determinar si tiene ciertas características. La coincidencia de patrones de C#
proporciona una sintaxis más concisa para probar las expresiones y realizar acciones
cuando una expresión coincide. La "expresión is" admite la coincidencia de patrones
para probar una expresión y declarar condicionalmente una nueva variable como el
resultado de esa expresión. La expresión switch permite realizar acciones basadas en el
primer patrón que coincida para una expresión. Estas dos expresiones admiten un
variado vocabulario de patrones.

En este artículo encontrará información general sobre los escenarios en los que puede
usar la coincidencia de patrones. Estas técnicas pueden mejorar la legibilidad y la
corrección del código. Para ver una explicación detallada de todos los patrones que
puede aplicar, consulte el artículo sobre patrones en la referencia del lenguaje.

Comprobaciones de valores null

Uno de los escenarios más comunes para usar la coincidencia de patrones es asegurarse
de que los valores no son null . Puede probar y convertir un tipo de valor que admite
valores null a su tipo subyacente mientras prueba null con el ejemplo siguiente:

C#

int? maybe = 12;

if (maybe is int number)

Console.WriteLine($"The nullable int 'maybe' has the value {number}");

else

Console.WriteLine("The nullable int 'maybe' doesn't hold a value");

El código anterior es un patrón de declaración para probar el tipo de la variable y

asignarlo a una nueva variable. Las reglas de lenguaje hacen que esta técnica sea más
segura que muchas otras. Solo es posible acceder a la variable number y asignarla en la
parte verdadera de la cláusula if . Si intenta acceder a ella en otro lugar, ya sea en la
cláusula else o después del bloque if , el compilador emitirá un error. En segundo
lugar, como no usa el operador == , este patrón funciona cuando un tipo sobrecarga el
operador == . Esto lo convierte en una manera ideal de comprobar los valores de
referencia nula, incorporando el patrón not :

C#

string? message = "This is not the null string";

if (message is not null)

Console.WriteLine(message);

En el ejemplo anterior se ha usado un patrón constante para comparar la variable con

null . not es un patrón lógico que coincide cuando el patrón negado no coincide.

Pruebas de tipo
Otro uso común de la coincidencia de patrones consiste en probar una variable para ver
si coincide con un tipo determinado. Por ejemplo, el código siguiente comprueba si una
variable no es null e implementa la interfaz System.Collections.Generic.IList<T>. Si es así,
usa la propiedad ICollection<T>.Count de esa lista para buscar el índice central. El
patrón de declaración no coincide con un valor null , independientemente del tipo de
tiempo de compilación de la variable. El código siguiente protege contra null , además
de proteger contra un tipo que no implementa IList .

C#

public static T MidPoint<T>(IEnumerable<T> sequence)

if (sequence is IList<T> list)

return list[list.Count / 2];

else if (sequence is null)

throw new ArgumentNullException(nameof(sequence), "Sequence can't be

null.");

else

int halfLength = sequence.Count() / 2 - 1;

if (halfLength < 0) halfLength = 0;

return sequence.Skip(halfLength).First();

Se pueden aplicar las mismas pruebas en una expresión switch para probar una
variable con varios tipos diferentes. Puede usar esa información para crear algoritmos
mejores basados en el tipo de tiempo de ejecución específico.

Comparación de valores discretos

También puede probar una variable para buscar una coincidencia con valores
específicos. En el código siguiente se muestra un ejemplo en el que se prueba un valor
con todos los valores posibles declarados en una enumeración:

C#

public State PerformOperation(Operation command) =>

command switch

Operation.SystemTest => RunDiagnostics(),

Operation.Start => StartSystem(),

Operation.Stop => StopSystem(),

Operation.Reset => ResetToReady(),

_ => throw new ArgumentException("Invalid enum value for command",

nameof(command)),

};

En el ejemplo anterior se muestra un envío de método basado en el valor de una

enumeración. El caso final _ es un patrón de descarte que coincide con todos los
valores. Controla todas las condiciones de error en las que el valor no coincide con uno
de los valores enum definidos. Si omite ese segmento modificador, el compilador le
advierte de que no ha controlado todos los valores de entrada posibles. En tiempo de
ejecución, la expresión switch produce una excepción si el objeto que se está
examinando no coincide con ninguno de los segmentos modificadores. Puede usar
constantes numéricas en lugar de un conjunto de valores de enumeración. También
puede usar esta técnica similar para los valores de cadena constantes que representan
los comandos:

C#

public State PerformOperation(string command) =>

command switch

"SystemTest" => RunDiagnostics(),

"Start" => StartSystem(),

"Stop" => StopSystem(),

 "Reset" => ResetToReady(),

_ => throw new ArgumentException("Invalid string value for command",

nameof(command)),

};

En el ejemplo anterior se muestra el mismo algoritmo, pero se usan valores de cadena

en lugar de una enumeración. Usaría este escenario si la aplicación responde a
comandos de texto, en lugar de a un formato de datos normal. A partir de C# 11,
también puede usar Span<char> o ReadOnlySpan<char> para probar los valores de
cadena constantes, tal como se muestra en el ejemplo siguiente:

C#

public State PerformOperation(ReadOnlySpan<char> command) =>

command switch

"SystemTest" => RunDiagnostics(),

"Start" => StartSystem(),

"Stop" => StopSystem(),

"Reset" => ResetToReady(),

_ => throw new ArgumentException("Invalid string value for command",

nameof(command)),

};

En todos estos ejemplos, el patrón de descarte le garantiza que controlará todas las
entradas. El compilador le ayuda a asegurarse de que se controlan todos los valores de
entrada posibles.

Patrones relacionales
Puede usar patrones relacionales para probar cómo se compara un valor con las
constantes. Por ejemplo, el código siguiente devuelve el estado del agua en función de
la temperatura en Fahrenheit:

C#

string WaterState(int tempInFahrenheit) =>

tempInFahrenheit switch

(> 32) and (< 212) => "liquid",

< 32 => "solid",

> 212 => "gas",

32 => "solid/liquid transition",

212 => "liquid / gas transition",

};

El código anterior también muestra el and patrón lógico conjuntivo para comprobar que
ambos patrones relacionales coincidan. También puede usar un patrón or disyuntivo
para comprobar que cualquiera de los patrones coincide. Los dos patrones relacionales
están entre paréntesis, que se pueden usar alrededor de cualquier patrón para mayor
claridad. Los dos últimos segmentos modificadores controlan los casos del punto de
fusión y el punto de ebullición. Sin esos dos segmentos, el compilador le advertirá de
que la lógica no abarca todas las entradas posibles.

El código anterior también muestra otra característica importante que el compilador

proporciona para las expresiones de coincidencia de patrones: el compilador le advierte
si no controla todos los valores de entrada. El compilador emite además una
advertencia si una parte de la expresión switch anterior ya controla una parte de la
expresión. Esto le da libertad para refactorizar y reordenar expresiones switch. La misma
expresión también se podría escribir así:

C#

string WaterState2(int tempInFahrenheit) =>

tempInFahrenheit switch

< 32 => "solid",

32 => "solid/liquid transition",

< 212 => "liquid",

212 => "liquid / gas transition",

_ => "gas",

};

La lección más importante de todo esto y cualquier otra refactorización o reordenación

es que el compilador valida que ha cubierto todas las entradas.

Varias entradas
Todos los patrones que ha visto hasta ahora comprueban una entrada. Puede escribir
patrones que examinen varias propiedades de un objeto. Fíjese en el siguiente registro
Order :

C#

public record Order(int Items, decimal Cost);

El tipo de registro posicional anterior declara dos miembros en posiciones explícitas.

Primero aparece Items y, luego, el valor Cost del pedido. Para obtener más
información, consulte Registros.
El código siguiente examina el número de elementos y el valor de un pedido para
calcular un precio con descuento:

C#

public decimal CalculateDiscount(Order order) =>

order switch

{ Items: > 10, Cost: > 1000.00m } => 0.10m,

{ Items: > 5, Cost: > 500.00m } => 0.05m,

{ Cost: > 250.00m } => 0.02m,

null => throw new ArgumentNullException(nameof(order), "Can't

calculate discount on null order"),

var someObject => 0m,

};

Los dos primeros segmentos examinan dos propiedades de Order . El tercero examina
solo el costo. El siguiente realiza la comprobación de null y el último coincide con
cualquier otro valor. Si el tipo Order define un método Deconstruct adecuado, puede
omitir los nombres de propiedad del patrón y usar la desconstrucción para examinar las
propiedades:

C#

public decimal CalculateDiscount(Order order) =>

order switch

( > 10, > 1000.00m) => 0.10m,

( > 5, > 50.00m) => 0.05m,

{ Cost: > 250.00m } => 0.02m,

null => throw new ArgumentNullException(nameof(order), "Can't

calculate discount on null order"),

var someObject => 0m,

};

El código anterior muestra el patrón posicional donde las propiedades se deconstruyen

para la expresión.

Patrones de lista
Puede comprobar los elementos de una lista o una matriz mediante un patrón de lista.
Un patrón de lista proporciona una forma de aplicar un patrón a cualquier elemento de
una secuencia. Además, puede aplicar el patrón de descarte ( _ ) para que coincida con
cualquier elemento, o bien un patrón de sector para que coincida con ninguno o más
elementos.
Los patrones de lista son una herramienta valiosa cuando los datos no siguen una
estructura normal. Puede usar la coincidencia de patrones para probar la forma y los
valores de los datos en vez de transformarlos en un conjunto de objetos.

Tenga en cuenta el siguiente extracto de un archivo de texto que contiene transacciones

bancarias:

Resultados

04-01-2020, DEPOSIT, Initial deposit, 2250.00

04-15-2020, DEPOSIT, Refund, 125.65

04-18-2020, DEPOSIT, Paycheck, 825.65

04-22-2020, WITHDRAWAL, Debit, Groceries, 255.73

05-01-2020, WITHDRAWAL, #1102, Rent, apt, 2100.00

05-02-2020, INTEREST, 0.65

05-07-2020, WITHDRAWAL, Debit, Movies, 12.57

04-15-2020, FEE, 5.55

Es un formato CSV, pero algunas de las filas tienen más columnas que otras. También
hay algo incluso peor para el procesamiento, una columna del tipo WITHDRAWAL que
tiene texto generado por el usuario y puede contener una coma en el texto. Un patrón
de lista que incluye el patrón de descarte, el patrón constante y el patrón var para
capturar los datos de los procesos del valor en este formato:

C#

decimal balance = 0m;

foreach (string[] transaction in ReadRecords())

balance += transaction switch

[_, "DEPOSIT", _, var amount] => decimal.Parse(amount),

[_, "WITHDRAWAL", .., var amount] => -decimal.Parse(amount),

[_, "INTEREST", var amount] => decimal.Parse(amount),

[_, "FEE", var fee] => -decimal.Parse(fee),

_ => throw new

InvalidOperationException($"Record {string.Join(", ", transaction)} is not
in the expected format!"),

};

Console.WriteLine($"Record: {string.Join(", ", transaction)}, New

balance: {balance:C}");
}

En el ejemplo anterior se toma una matriz de cadenas, donde cada elemento es un

campo de la fila. Las claves de expresión switch del segundo campo, que determinan el
tipo de transacción y el número de columnas restantes. Cada fila garantiza que los datos
están en el formato correcto. El patrón de descarte ( _ ) omite el primer campo, con la
fecha de la transacción. El segundo campo coincide con el tipo de transacción. Las
coincidencias restantes del elemento saltan hasta el campo con la cantidad. La
coincidencia final usa el patrón var para capturar la representación de cadena de la
cantidad. La expresión calcula la cantidad que se va a agregar o restar del saldo.

Los patrones de lista permiten buscar coincidencias en la forma de una secuencia de

elementos de datos. Los patrones de descarte y de sector se usan para hallar
coincidencias con la ubicación de los elementos. Se usan otros patrones para que
coincidan con las características de los elementos individuales.

En este artículo se proporciona una introducción a los tipos de código que se pueden
escribir con la coincidencia de patrones en C#. En los artículos siguientes se muestran
más ejemplos del uso de patrones en escenarios y un vocabulario completo de patrones
disponibles.

Vea también
Uso de la coincidencia de patrones para evitar la comprobación de "is" seguida de
una conversión (reglas de estilo IDE0020 e IDE0038)
Exploración: Uso de la coincidencia de patrones para crear el comportamiento de
la clase y mejorar el código
Tutorial: Uso de la coincidencia de patrones para compilar algoritmos basados en
tipos y basados en datos
Referencia: Coincidencia de patrones
Descartes: aspectos básicos de C#
Artículo • 03/03/2023 • Tiempo de lectura: 9 minutos

Los descartes son variables de marcador de posición que deliberadamente no se usan

en el código de la aplicación. Los descartes son equivalentes a variables sin asignar, ya
que no tienen un valor. Un descarte comunica la intención al compilador y otros
usuarios que leen el código: Pretendía ignorar el resultado de una expresión. Es posible
que desee ignorar el resultado de una expresión, uno o varios miembros de una
expresión de tupla, un parámetro out de un método o el destino de una expresión de
coincidencia de patrones.

Los descartes aclaran la intención del código. Un descarte indica que el código nunca
usa la variable. Mejoran la legibilidad y el mantenimiento.

Para indicar que una variable es un descarte, se le asigna como nombre el carácter de
subrayado ( _ ). Por ejemplo, la siguiente llamada de método devuelve una tupla en la
que el primer y el segundo valor son descartes. area es una variable declarada
previamente establecida en el tercer componente devuelto por GetCityInformation :

C#

(_, _, area) = city.GetCityInformation(cityName);

A partir de C# 9.0, se pueden usar descartes para especificar los parámetros de entrada
de una expresión lambda que no se utilizan. Para más información, consulte sección
sobre parámetros de entrada de una expresión lambda en el artículo sobre expresiones
lambda.

Cuando _ es un descarte válido, si se intenta recuperar su valor o usarlo en una

operación de asignación, se genera el error del compilador CS0103: "El nombre '_' no
existe en el contexto actual". Este error se debe a que no se le ha asignado un valor a _ ,
y es posible que tampoco se le haya asignado una ubicación de almacenamiento. Si
fuese una variable real no se podría descartar más de un valor, como en el ejemplo
anterior.

Deconstrucción de tuplas y objetos

Los descartes son útiles en el trabajo con tuplas, cuando el código de la aplicación usa
algunos elementos de tupla pero omite otros. Por ejemplo, el siguiente método
QueryCityDataForYears devuelve una tupla con el nombre de una ciudad, su superficie,
un año, la población de la ciudad en ese año, un segundo año y la población de la
ciudad en ese segundo año. En el ejemplo se muestra la evolución de la población entre
esos dos años. De los datos disponibles en la tupla, no nos interesa la superficie de la
ciudad, y conocemos el nombre de la ciudad y las dos fechas en tiempo de diseño.
Como resultado, solo nos interesan los dos valores de población almacenados en la
tupla, y podemos controlar los valores restantes como descartes.

C#

var (_, _, _, pop1, _, pop2) = QueryCityDataForYears("New York City", 1960,

2010);

Console.WriteLine($"Population change, 1960 to 2010: {pop2 - pop1:N0}");

static (string, double, int, int, int, int) QueryCityDataForYears(string

name, int year1, int year2)

int population1 = 0, population2 = 0;

double area = 0;

if (name == "New York City")

area = 468.48;

if (year1 == 1960)

population1 = 7781984;

if (year2 == 2010)

population2 = 8175133;

return (name, area, year1, population1, year2, population2);

return ("", 0, 0, 0, 0, 0);

// The example displays the following output:

// Population change, 1960 to 2010: 393,149

Para obtener más información sobre la deconstrucción de tuplas con descartes, vea
Deconstructing tuples and other types (Deconstruir tuplas y otros tipos).

El método Deconstruct de una clase, estructura o interfaz también permite recuperar y

deconstruir un conjunto de datos específico de un objeto. Puede usar descartes cuando
le interese trabajar con un solo subconjunto de los valores deconstruidos. En el
siguiente ejemplo se deconstruye un objeto Person en cuatro cadenas (el nombre
propio, los apellidos, la ciudad y el estado), pero se descartan los apellidos y el estado.

C#
using System;

namespace Discards

public class Person

public string FirstName { get; set; }

public string MiddleName { get; set; }

public string LastName { get; set; }

public string City { get; set; }

public string State { get; set; }

public Person(string fname, string mname, string lname,

string cityName, string stateName)

FirstName = fname;

MiddleName = mname;

LastName = lname;

City = cityName;

State = stateName;

// Return the first and last name.

public void Deconstruct(out string fname, out string lname)

fname = FirstName;

lname = LastName;

public void Deconstruct(out string fname, out string mname, out

string lname)

fname = FirstName;

mname = MiddleName;

lname = LastName;

public void Deconstruct(out string fname, out string lname,

out string city, out string state)

fname = FirstName;

lname = LastName;

city = City;

state = State;

class Example

public static void Main()

var p = new Person("John", "Quincy", "Adams", "Boston", "MA");

// Deconstruct the person object.

var (fName, _, city, _) = p;

 Console.WriteLine($"Hello {fName} of {city}!");

// The example displays the following output:

// Hello John of Boston!

Para obtener más información sobre la deconstrucción de tipos definidos por el usuario
con descartes, vea Deconstructing tuples and other types (Deconstruir tuplas y otros
tipos).

Coincidencia de patrones con switch

El patrón de descarte se puede usar en la coincidencia de patrones con la expresión
switch. Todas las expresiones, incluida null , siempre coinciden con el patrón de
descarte.

En el ejemplo siguiente se define un método ProvidesFormatInfo que usa una expresión

switch para determinar si un objeto proporciona una implementación de

IFormatProvider y probar si el objeto es null . También se usa el patrón de descarte para

controlar los objetos que no son NULL de cualquier otro tipo.

C#

object?[] objects = { CultureInfo.CurrentCulture,

CultureInfo.CurrentCulture.DateTimeFormat,

CultureInfo.CurrentCulture.NumberFormat,

new ArgumentException(), null };

foreach (var obj in objects)

ProvidesFormatInfo(obj);

static void ProvidesFormatInfo(object? obj) =>

Console.WriteLine(obj switch

IFormatProvider fmt => $"{fmt.GetType()} object",

null => "A null object reference: Its use could result in a
NullReferenceException",

_ => "Some object type without format information"

});

// The example displays the following output:

// System.Globalization.CultureInfo object

// System.Globalization.DateTimeFormatInfo object

// System.Globalization.NumberFormatInfo object

// Some object type without format information

// A null object reference: Its use could result in a

NullReferenceException

Llamadas a métodos con parámetros out

Cuando se llama al método Deconstruct para deconstruir un tipo definido por el
usuario (una instancia de una clase, estructura o interfaz), puede descartar los valores de
argumentos out individuales. Pero también puede descartar el valor de argumentos
out al llamar a cualquier método con un parámetro out .

En el ejemplo siguiente se llama al método DateTime.TryParse(String, out DateTime)

para determinar si la representación de cadena de una fecha es válida en la referencia
cultural actual. Dado que al ejemplo solo le interesa validar la cadena de fecha, y no
analizarla para extraer la fecha, el argumento out para el método es un descarte.

C#

string[] dateStrings = {"05/01/2018 14:57:32.8", "2018-05-01 14:57:32.8",

"2018-05-01T14:57:32.8375298-04:00", "5/01/2018",

"5/01/2018 14:57:32.80 -07:00",

"1 May 2018 2:57:32.8 PM", "16-05-2018 1:00:32 PM",

"Fri, 15 May 2018 20:10:57 GMT" };

foreach (string dateString in dateStrings)

if (DateTime.TryParse(dateString, out _))

Console.WriteLine($"'{dateString}': valid");

else

Console.WriteLine($"'{dateString}': invalid");

// The example displays output like the following:

// '05/01/2018 14:57:32.8': valid

// '2018-05-01 14:57:32.8': valid

// '2018-05-01T14:57:32.8375298-04:00': valid

// '5/01/2018': valid

// '5/01/2018 14:57:32.80 -07:00': valid

// '1 May 2018 2:57:32.8 PM': valid

// '16-05-2018 1:00:32 PM': invalid

// 'Fri, 15 May 2018 20:10:57 GMT': invalid

Descarte independiente
Puede usar un descarte independiente para indicar cualquier variable que decida omitir.
Un uso típico es usar una asignación para asegurarse de que un argumento no sea
NULL. En el código siguiente se usa un descarte para forzar una asignación. El lado
derecho de la asignación utiliza el operador de uso combinado de NULL para producir
System.ArgumentNullException cuando el argumento es null . El código no necesita el
resultado de la asignación, por lo que se descarta. La expresión fuerza una
comprobación nula. El descarte aclara su intención: el resultado de la asignación no es
necesario ni se usa.

C#

public static void Method(string arg)

_ = arg ?? throw new ArgumentNullException(paramName: nameof(arg),

message: "arg can't be null");

// Do work with arg.

En el ejemplo siguiente se usa un descarte independiente para omitir el objeto Task

devuelto por una operación asincrónica. La asignación de la tarea tiene el efecto de
suprimir la excepción que se produce en la operación cuando está a punto de
completarse. Hace que su intención sea clara: Quiere descartar Task y omitir los errores
generados a partir de esa operación asincrónica.

C#

private static async Task ExecuteAsyncMethods()

Console.WriteLine("About to launch a task...");

_ = Task.Run(() =>

var iterations = 0;

for (int ctr = 0; ctr < int.MaxValue; ctr++)

iterations++;

Console.WriteLine("Completed looping operation...");

throw new InvalidOperationException();

});

await Task.Delay(5000);

Console.WriteLine("Exiting after 5 second delay");

// The example displays output like the following:

// About to launch a task...

// Completed looping operation...

// Exiting after 5 second delay

Sin asignar la tarea a un descarte, el código siguiente genera una advertencia del
compilador:

C#

private static async Task ExecuteAsyncMethods()

Console.WriteLine("About to launch a task...");

// CS4014: Because this call is not awaited, execution of the current

 method continues before the call is completed.

// Consider applying the 'await' operator to the result of the call.

Task.Run(() =>

var iterations = 0;

for (int ctr = 0; ctr < int.MaxValue; ctr++)

iterations++;

Console.WriteLine("Completed looping operation...");

throw new InvalidOperationException();

});

await Task.Delay(5000);

Console.WriteLine("Exiting after 5 second delay");

７ Nota

Si ejecuta cualquiera de los dos ejemplos anteriores mediante un depurador, este

detendrá el programa cuando se produzca la excepción. Sin un depurador
asociado, la excepción se omite en ambos casos en modo silencioso.

_ también es un identificador válido. Cuando se usa fuera de un contexto compatible, _

no se trata como un descarte, sino como una variable válida. Si un identificador

denominado _ ya está en el ámbito, el uso de _ como descarte independiente puede
producir lo siguiente:

La modificación accidental del valor de la variable _ en el ámbito, al asignarle el

valor del descarte previsto. Por ejemplo:

C#

private static void ShowValue(int _)

{

byte[] arr = { 0, 0, 1, 2 };

_ = BitConverter.ToInt32(arr, 0);

Console.WriteLine(_);

// The example displays the following output:

// 33619968

Un error del compilador por infringir la seguridad de tipos. Por ejemplo:

C#

private static bool RoundTrips(int _)

string value = _.ToString();

int newValue = 0;

_ = Int32.TryParse(value, out newValue);

return _ == newValue;

// The example displays the following compiler error:

// error CS0029: Cannot implicitly convert type 'bool' to 'int'

Error del compilador CS0136: "Una variable local o un parámetro denominados '_'
no se pueden declarar en este ámbito porque ese nombre se está usando en un
ámbito local envolvente para definir una variable local o un parámetro". Por
ejemplo:

C#

public void DoSomething(int _)

var _ = GetValue(); // Error: cannot declare local _ when one is

already in scope

// The example displays the following compiler error:

// error CS0136:

// A local or parameter named '_' cannot be declared in this

scope

// because that name is used in an enclosing local scope

// to define a local or parameter

Consulte también
Eliminación de valores de expresión innecesarios (regla de estilo IDE0058)
Eliminación de la asignación de valores innecesarios (regla de estilo IDE0059)
Eliminación del parámetro sin usar (regla de estilo IDE0060)
Deconstruir tuplas y otros tipos
is operator
Expresión switch
Deconstruir tuplas y otros tipos
Artículo • 15/02/2023 • Tiempo de lectura: 11 minutos

Una tupla proporciona una manera ligera de recuperar varios valores de una llamada de
método. Pero una vez que recupere la tupla, deberá controlar sus elementos
individuales. Trabajar elemento a elemento es complicado, como se muestra en el
ejemplo siguiente. El método QueryCityData devuelve una tupla de tres y cada uno de
sus elementos se asigna a una variable en una operación aparte.

C#

public class Example

public static void Main()

var result = QueryCityData("New York City");

var city = result.Item1;

var pop = result.Item2;

var size = result.Item3;

// Do something with the data.

private static (string, int, double) QueryCityData(string name)

if (name == "New York City")

return (name, 8175133, 468.48);

return ("", 0, 0);

Recuperar varios valores de campo y propiedad de un objeto puede ser igualmente

complicado: debe asignar un valor de campo o propiedad a una variable miembro a
miembro.

Puede recuperar varios elementos de una tupla o recuperar varios campos, propiedades
y valores calculados de un objeto en una sola operación de deconstrucción. Para
deconstruir una tupla, asigne sus elementos a variables individuales. Cuando se
deconstruye un objeto, los valores seleccionados se asignan a variables individuales.

Tuplas
C# incluye compatibilidad integrada para deconstruir tuplas, lo que permite
desempaquetar todos los elementos de una tupla en una sola operación. La sintaxis
general para deconstruir una tupla es parecida a la sintaxis para definirla, ya que las
variables a las que se va a asignar cada elemento se escriben entre paréntesis en el lado
izquierdo de una instrucción de asignación. Por ejemplo, la siguiente instrucción asigna
los elementos de una tupla de cuatro a cuatro variables distintas:

C#

var (name, address, city, zip) = contact.GetAddressInfo();

Hay tres formas de deconstruir una tupla:

Se puede declarar explícitamente el tipo de cada campo entre paréntesis. En el

ejemplo siguiente se usa este enfoque para deconstruir la tupla de tres que
devuelve el método QueryCityData .

C#

public static void Main()

(string city, int population, double area) = QueryCityData("New

York City");

// Do something with the data.

Puede usar la palabra clave var para que C# deduzca el tipo de cada variable.
Debe colocar la palabra clave var fuera de los paréntesis. En el ejemplo siguiente
se usa la inferencia de tipos al deconstruir la tupla de tres devuelta por el método
QueryCityData .

C#

public static void Main()

var (city, population, area) = QueryCityData("New York City");

// Do something with the data.

También se puede usar la palabra clave var individualmente con alguna de las
declaraciones de variable, o todas, dentro de los paréntesis.

C#
 public static void Main()

(string city, var population, var area) = QueryCityData("New York

City");

// Do something with the data.

Esto es complicado y no se recomienda.

Por último, puede deconstruir la tupla en variables que ya se hayan declarado.

C#

public static void Main()

string city = "Raleigh";

int population = 458880;

double area = 144.8;

(city, population, area) = QueryCityData("New York City");

// Do something with the data.

A partir de C# 10, puede mezclar la declaración y la asignación de variables en una

deconstrucción.

C#

public static void Main()

string city = "Raleigh";

int population = 458880;

(city, population, double area) = QueryCityData("New York City");

// Do something with the data.

No se puede especificar un tipo específico fuera de los paréntesis aunque cada campo
de la tupla tenga el mismo tipo. Al hacerlo, se genera el error del compilador CS8136:
"La forma de deconstrucción "var (...)" no permite un tipo específico para "var'".

Debe asignar cada elemento de la tupla a una variable. Si omite algún elemento, el
compilador genera el error CS8132: "No se puede deconstruir una tupla de "x"
elementos en "y" variables".
Elementos de tupla con descartes
A menudo, cuando se deconstruye una tupla, solo interesan los valores de algunos
elementos. Puede aprovechar la compatibilidad de C# con los descartes, que son
variables de solo escritura cuyos valores se decide omitir. Un carácter de subrayado ("_")
elige un descarte en una asignación. Puede descartar tantos valores como quiera; todos
se representan mediante el descarte único _ .

En el ejemplo siguiente se muestra el uso de tuplas con descartes. El método

QueryCityDataForYears devuelve una tupla de seis con el nombre de una ciudad, su

área, un año, la población de la ciudad en ese año, un segundo año y la población de la

ciudad en ese segundo año. En el ejemplo se muestra la evolución de la población entre
esos dos años. De los datos disponibles en la tupla, no nos interesa la superficie de la
ciudad, y conocemos el nombre de la ciudad y las dos fechas en tiempo de diseño.
Como resultado, solo nos interesan los dos valores de población almacenados en la
tupla, y podemos controlar los valores restantes como descartes.

C#

using System;

public class ExampleDiscard

public static void Main()

var (_, _, _, pop1, _, pop2) = QueryCityDataForYears("New York

City", 1960, 2010);

Console.WriteLine($"Population change, 1960 to 2010: {pop2 -

pop1:N0}");

private static (string, double, int, int, int, int)

QueryCityDataForYears(string name, int year1, int year2)

int population1 = 0, population2 = 0;

double area = 0;

if (name == "New York City")

area = 468.48;

if (year1 == 1960)

population1 = 7781984;

if (year2 == 2010)

population2 = 8175133;

 return (name, area, year1, population1, year2, population2);

return ("", 0, 0, 0, 0, 0);

// The example displays the following output:

// Population change, 1960 to 2010: 393,149

Tipos definidos por el usuario

C# no ofrece compatibilidad integrada con la deconstrucción de tipos que no son de
tupla distintos de los tipos record y DictionaryEntry. A pesar de ello, como autor de una
clase, una estructura o una interfaz, puede permitir que las instancias del tipo se
deconstruyan mediante la implementación de uno o varios métodos Deconstruct . El
método no devuelve ningún valor, y cada valor que se va a deconstruir se indica
mediante un parámetro out en la firma del método. Por ejemplo, el siguiente método
Deconstruct de una clase Person devuelve el nombre de pila, el segundo nombre y los

apellidos:

C#

public void Deconstruct(out string fname, out string mname, out string
lname)

A continuación, puede deconstruir una instancia de la clase Person denominada p con

una asignación como el código siguiente:

C#

var (fName, mName, lName) = p;

En el ejemplo siguiente se sobrecarga el método Deconstruct para devolver varias

combinaciones de las propiedades de un objeto Person . Las sobrecargas individuales
devuelven lo siguiente:

El nombre de pila y los apellidos.

El nombre de pila, el segundo nombre y los apellidos.
El nombre de pila, los apellidos, el nombre de la ciudad y el nombre del estado.

C#

using System;

public class Person

public string FirstName { get; set; }

public string MiddleName { get; set; }

public string LastName { get; set; }

public string City { get; set; }

public string State { get; set; }

public Person(string fname, string mname, string lname,

string cityName, string stateName)

FirstName = fname;

MiddleName = mname;

LastName = lname;

City = cityName;

State = stateName;

// Return the first and last name.

public void Deconstruct(out string fname, out string lname)

fname = FirstName;

lname = LastName;

public void Deconstruct(out string fname, out string mname, out string
lname)

fname = FirstName;

mname = MiddleName;

lname = LastName;

public void Deconstruct(out string fname, out string lname,

out string city, out string state)

fname = FirstName;

lname = LastName;

city = City;

state = State;

public class ExampleClassDeconstruction

public static void Main()

var p = new Person("John", "Quincy", "Adams", "Boston", "MA");

// Deconstruct the person object.

var (fName, lName, city, state) = p;

Console.WriteLine($"Hello {fName} {lName} of {city}, {state}!");

 // The example displays the following output:

// Hello John Adams of Boston, MA!

Varios métodos de Deconstruct que tienen el mismo número de parámetros son

ambiguos. Debe tener cuidado al definir métodos Deconstruct con distintos números
de parámetros o "aridad". No se pueden distinguir los métodos Deconstruct con el
mismo número de parámetros durante la resolución de sobrecarga.

Tipo definido por el usuario con descartes

Tal como haría con las tuplas, puede usar descartes para omitir los elementos
seleccionados que haya devuelto un método Deconstruct . Cada descarte se define
mediante una variable denominada "_". Una operación de deconstrucción única puede
incluir varios descartes.

En el siguiente ejemplo se deconstruye un objeto Person en cuatro cadenas (el nombre

propio, los apellidos, la ciudad y el estado), pero se descartan los apellidos y el estado.

C#

// Deconstruct the person object.

var (fName, _, city, _) = p;

Console.WriteLine($"Hello {fName} of {city}!");

// The example displays the following output:

// Hello John of Boston!

Métodos de extensión para tipos definidos por

el usuario
Aunque usted no haya creado una clase, una estructura o una interfaz, puede
igualmente deconstruir objetos de ese tipo. Para ello, implemente uno o varios métodos
de extensión Deconstruct que devuelvan los valores que le interesen.

En el ejemplo siguiente se definen dos métodos de extensión Deconstruct para la clase

System.Reflection.PropertyInfo. El primero devuelve un conjunto de valores que indican
las características de la propiedad, incluido su tipo, si es estática o de instancia, si es de
solo lectura y si está indexada. El segundo indica la accesibilidad de la propiedad. Dado
que la accesibilidad de los descriptores de acceso get y set puede diferir, los valores
booleanos indican si la propiedad tiene descriptores de acceso get y set independientes
y, si es así, si tienen la misma accesibilidad. Si solo hay un descriptor de acceso o tanto
el descriptor de acceso get como set tienen la misma accesibilidad, la variable access
indica la accesibilidad de la propiedad en su conjunto. En caso contrario, la accesibilidad
de los descriptores de acceso get y set se indica mediante las variables getAccess y
setAccess .

C#

using System;

using System.Collections.Generic;
using System.Reflection;

public static class ReflectionExtensions

public static void Deconstruct(this PropertyInfo p, out bool isStatic,

out bool isReadOnly, out bool isIndexed,

out Type propertyType)

var getter = p.GetMethod;

// Is the property read-only?

isReadOnly = ! p.CanWrite;

// Is the property instance or static?

isStatic = getter.IsStatic;

// Is the property indexed?

isIndexed = p.GetIndexParameters().Length > 0;

// Get the property type.

propertyType = p.PropertyType;

public static void Deconstruct(this PropertyInfo p, out bool

hasGetAndSet,

out bool sameAccess, out string access,

out string getAccess, out string

setAccess)

hasGetAndSet = sameAccess = false;

string getAccessTemp = null;

string setAccessTemp = null;

MethodInfo getter = null;

if (p.CanRead)

getter = p.GetMethod;

MethodInfo setter = null;

if (p.CanWrite)

setter = p.SetMethod;

if (setter != null && getter != null)

hasGetAndSet = true;

if (getter != null)

if (getter.IsPublic)

getAccessTemp = "public";

else if (getter.IsPrivate)

getAccessTemp = "private";

else if (getter.IsAssembly)

getAccessTemp = "internal";

else if (getter.IsFamily)

getAccessTemp = "protected";

else if (getter.IsFamilyOrAssembly)

getAccessTemp = "protected internal";

if (setter != null)

if (setter.IsPublic)

setAccessTemp = "public";

else if (setter.IsPrivate)

setAccessTemp = "private";

else if (setter.IsAssembly)

setAccessTemp = "internal";

else if (setter.IsFamily)

setAccessTemp = "protected";

else if (setter.IsFamilyOrAssembly)

setAccessTemp = "protected internal";

// Are the accessibility of the getter and setter the same?

if (setAccessTemp == getAccessTemp)

sameAccess = true;

access = getAccessTemp;

getAccess = setAccess = String.Empty;

else

access = null;

getAccess = getAccessTemp;

setAccess = setAccessTemp;

public class ExampleExtension

public static void Main()

Type dateType = typeof(DateTime);

PropertyInfo prop = dateType.GetProperty("Now");

var (isStatic, isRO, isIndexed, propType) = prop;

Console.WriteLine($"\nThe {dateType.FullName}.{prop.Name}
property:");

Console.WriteLine($" PropertyType: {propType.Name}");

Console.WriteLine($" Static: {isStatic}");

Console.WriteLine($" Read-only: {isRO}");

 Console.WriteLine($" Indexed: {isIndexed}");

Type listType = typeof(List<>);

prop = listType.GetProperty("Item",

BindingFlags.Public |
BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static);

var (hasGetAndSet, sameAccess, accessibility, getAccessibility,

setAccessibility) = prop;

Console.Write($"\nAccessibility of the {listType.FullName}.

{prop.Name} property: ");

if (!hasGetAndSet | sameAccess)

Console.WriteLine(accessibility);

else

Console.WriteLine($"\n The get accessor: {getAccessibility}");

Console.WriteLine($" The set accessor: {setAccessibility}");

// The example displays the following output:

// The System.DateTime.Now property:

// PropertyType: DateTime

// Static: True

// Read-only: True

// Indexed: False

//

// Accessibility of the System.Collections.Generic.List`1.Item

property: public

Método de extensión para tipos de sistema

Algunos tipos de sistema proporcionan el método Deconstruct por motivos prácticos.
Por ejemplo, el tipo System.Collections.Generic.KeyValuePair<TKey,TValue> proporciona
esta funcionalidad. Al recorrer en iteración un objeto
System.Collections.Generic.Dictionary<TKey,TValue>, cada elemento es un valor
KeyValuePair<TKey, TValue> y se puede deconstruir. Considere el ejemplo siguiente:

C#

Dictionary<string, int> snapshotCommitMap =

new(StringComparer.OrdinalIgnoreCase)

["https://github.com/dotnet/docs"] = 16_465,

["https://github.com/dotnet/runtime"] = 114_223,

["https://github.com/dotnet/installer"] = 22_436,

["https://github.com/dotnet/roslyn"] = 79_484,

["https://github.com/dotnet/aspnetcore"] = 48_386

 };

foreach (var (repo, commitCount) in snapshotCommitMap)

Console.WriteLine(

$"The {repo} repository had {commitCount:N0} commits as of November

10th, 2021.");

Puede agregar un método Deconstruct a tipos de sistema que no tengan uno.

Considere el siguiente método de extensión:

C#

public static class NullableExtensions

public static void Deconstruct<T>(

this T? nullable,

out bool hasValue,

out T value) where T : struct

hasValue = nullable.HasValue;

value = nullable.GetValueOrDefault();

Este método de extensión permite que todos los tipos Nullable<T> se deconstruyan en
una tupla de (bool hasValue, T value) . En el ejemplo siguiente se muestra el código
que usa este método de extensión:

C#

DateTime? questionableDateTime = default;

var (hasValue, value) = questionableDateTime;

Console.WriteLine(

$"{{ HasValue = {hasValue}, Value = {value} }}");

questionableDateTime = DateTime.Now;

(hasValue, value) = questionableDateTime;

Console.WriteLine(

$"{{ HasValue = {hasValue}, Value = {value} }}");

// Example outputs:

// { HasValue = False, Value = 1/1/0001 12:00:00 AM }

// { HasValue = True, Value = 11/10/2021 6:11:45 PM }

Tipos record
Cuando se declara un tipo de registro con dos o más parámetros posicionales, el
compilador crea un método Deconstruct con un parámetro out para cada parámetro
posicional en la declaración de record . Para obtener más información, vea Sintaxis
posicional para la definición de propiedades y Comportamiento de deconstructores en
registros derivados.

Vea también
Deconstrucción de declaraciones de variables (regla de estilo IDE0042)
Descartes
Tipos de tupla
Excepciones y control de excepciones
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las características de control de excepciones del lenguaje C# le ayudan a afrontar

cualquier situación inesperada o excepcional que se produce cuando se ejecuta un
programa. El control de excepciones usa las palabras clave try , catch y finally para
intentar realizar acciones que pueden no completarse correctamente, para controlar
errores cuando decide que es razonable hacerlo y para limpiar recursos más adelante.
Las excepciones las puede generar Common Language Runtime (CLR), .NET, bibliotecas
de terceros o el código de aplicación. Las excepciones se crean mediante el uso de la
palabra clave throw .

En muchos casos, una excepción la puede no producir un método al que el código ha

llamado directamente, sino otro método más bajo en la pila de llamadas. Cuando se
genera una excepción, CLR desenreda la pila, busca un método con un bloque catch
para el tipo de excepción específico y ejecuta el primer bloque catch que encuentra. Si
no encuentra ningún bloque catch adecuado en cualquier parte de la pila de llamadas,
finalizará el proceso y mostrará un mensaje al usuario.

En este ejemplo, un método prueba a hacer la división entre cero y detecta el error. Sin
el control de excepciones, este programa finalizaría con un error
DivideByZeroException no controlada.

C#

public class ExceptionTest

static double SafeDivision(double x, double y)

if (y == 0)

throw new DivideByZeroException();

return x / y;

public static void Main()

// Input for test purposes. Change the values to see

// exception handling behavior.

double a = 98, b = 0;

double result;

try

result = SafeDivision(a, b);

Console.WriteLine("{0} divided by {1} = {2}", a, b, result);

 catch (DivideByZeroException)

Console.WriteLine("Attempted divide by zero.");

Información general sobre excepciones

Las excepciones tienen las siguientes propiedades:

Las excepciones son tipos que derivan en última instancia de System.Exception .

Use un bloque try alrededor de las instrucciones que pueden producir
excepciones.
Una vez que se produce una excepción en el bloque try , el flujo de control salta al
primer controlador de excepciones asociado que está presente en cualquier parte
de la pila de llamadas. En C#, la palabra clave catch se utiliza para definir un
controlador de excepciones.
Si no hay ningún controlador de excepciones para una excepción determinada, el
programa deja de ejecutarse con un mensaje de error.
No detecte una excepción a menos que pueda controlarla y dejar la aplicación en
un estado conocido. Si se detecta System.Exception , reinícielo con la palabra clave
throw al final del bloque catch .
Si un bloque catch define una variable de excepción, puede utilizarla para obtener
más información sobre el tipo de excepción que se ha producido.
Las excepciones puede generarlas explícitamente un programa con la palabra
clave throw .
Los objetos de excepción contienen información detallada sobre el error, como el
estado de la pila de llamadas y una descripción de texto del error.
El código de un bloque finally se ejecuta incluso si se produce una excepción.
Use un bloque finally para liberar recursos, por ejemplo, para cerrar las
secuencias o los archivos que se abrieron en el bloque try .
Las excepciones administradas de .NET se implementan en el mecanismo de
control de excepciones estructurado de Win32. Para más información, vea Control
de excepciones estructurado (C/C++) y A Crash Course on the Depths of Win32
Structured Exception Handling (Curso intensivo sobre los aspectos específicos
del control de excepciones estructurado de Win32).

Especificación del lenguaje C#

Para obtener más información, consulte la sección Excepciones de Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.

Vea también
SystemException
Palabras clave de C#
throw
try-catch
try-finally
try-catch-finally
Excepciones
Uso de excepciones
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En C#, los errores del programa en tiempo de ejecución se propagan a través del
programa mediante un mecanismo denominado excepciones. Las excepciones las inicia
el código que encuentra un error y las detecta el código que puede corregir dicho error.
El entorno de ejecución .NET o el código de un programa pueden producir excepciones.
Una vez iniciada, una excepción se propaga hasta la pila de llamadas hasta que
encuentra una instrucción catch para la excepción. Las excepciones no detectadas se
controlan mediante un controlador de excepciones que ofrece el sistema y muestra un
cuadro de diálogo.

Las excepciones están representadas por clases derivadas de Exception. Esta clase
identifica el tipo de excepción y contiene propiedades que tienen los detalles sobre la
excepción. Iniciar una excepción implica crear una instancia de una clase derivada de
excepción, configurar opcionalmente las propiedades de la excepción y luego producir
el objeto con la palabra clave throw . Por ejemplo:

C#

class CustomException : Exception

public CustomException(string message)

private static void TestThrow()

throw new CustomException("Custom exception in TestThrow()");

Cuando se inicia una excepción, el entorno runtime comprueba la instrucción actual

para ver si se encuentra dentro de un bloque try . Si es así, se comprueban los bloques
catch asociados al bloque try para ver si pueden detectar la excepción. Los bloques

Catch suelen especificar tipos de excepción; si el tipo del bloque catch es el mismo de

la excepción, o una clase base de la excepción, el bloque catch puede controlar el

método. Por ejemplo:

C#

try

TestThrow();

 catch (CustomException ex)

System.Console.WriteLine(ex.ToString());

Si la instrucción que inicia una excepción no está en un bloque try , o si el bloque try
que la encierra no tiene un elemento catch coincidente, el entorno de ejecución busca
una instrucción try y bloques catch en el método de llamada. El entorno runtime sigue
hasta la pila de llamadas para buscar un bloque catch compatible. Después de
encontrar el bloque catch y ejecutarlo, el control pasa a la siguiente instrucción
después de dicho bloque catch .

Una instrucción try puede contener más de un bloque catch . Se ejecuta la primera
instrucción catch que pueda controlar la excepción; las instrucciones catch siguientes
se omiten, aunque sean compatibles. Ordene los bloques catch de más específicos (o
más derivados) a menos específicos. Por ejemplo:

C#

using System;

using System.IO;

namespace Exceptions

public class CatchOrder

public static void Main()

try

using (var sw = new StreamWriter("./test.txt"))

sw.WriteLine("Hello");

// Put the more specific exceptions first.

catch (DirectoryNotFoundException ex)

Console.WriteLine(ex);

catch (FileNotFoundException ex)

Console.WriteLine(ex);

// Put the least specific exception last.

catch (IOException ex)

Console.WriteLine(ex);

 Console.WriteLine("Done");

Para que el bloque catch se ejecute, el entorno runtime busca bloques finally . Los
bloques Finally permiten al programador limpiar cualquier estado ambiguo que
pudiera haber quedado tras la anulación de un bloque try o liberar los recursos
externos (como identificadores de gráficos, conexiones de base de datos o flujos de
archivos) sin tener que esperar a que el recolector de elementos no utilizados en el
entorno de ejecución finalice los objetos. Por ejemplo:

C#

static void TestFinally()

FileStream? file = null;

//Change the path to something that works on your machine.

FileInfo fileInfo = new System.IO.FileInfo("./file.txt");

try

file = fileInfo.OpenWrite();

file.WriteByte(0xF);

finally

// Closing the file allows you to reopen it immediately - otherwise

IOException is thrown.

file?.Close();

try

file = fileInfo.OpenWrite();

Console.WriteLine("OpenWrite() succeeded");

catch (IOException)

Console.WriteLine("OpenWrite() failed");

Si WriteByte() ha iniciado una excepción, el código del segundo bloque try que
intente reabrir el archivo generaría un error si no se llama a file.Close() , y el archivo
permanecería bloqueado. Como los bloques finally se ejecutan aunque se inicie una
excepción, el bloque finally del ejemplo anterior permite que el archivo se cierre
correctamente y ayuda a evitar un error.
Si no se encuentra ningún bloque catch compatible en la pila de llamadas después de
iniciar una excepción, sucede una de estas tres acciones:

Si la excepción se encuentra en un finalizador, este se anula y, si procede, se llama

al finalizador base.
Si la pila de llamadas contiene un constructor estático o un inicializador de campo
estático, se inicia una excepción TypeInitializationException, y la excepción original
se asigna a la propiedad InnerException de la nueva excepción.
Si se llega al comienzo del subproceso, este finaliza.
Control de excepciones (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Los programadores de C# usan un bloque try para separar el código que podría verse
afectado por una excepción. Los bloques catch asociados se usan para controlar las
excepciones resultantes. Un bloque finally contiene código que se ejecuta
independientemente de si se produce una excepción en el bloque try , como la
liberación de recursos asignados en el bloque try . Los bloques try requieren uno o
varios bloques catch asociados, un bloque finally o ambos.

En los ejemplos siguientes se muestra una instrucción try-catch , una instrucción try-
finally y una instrucción try-catch-finally .

C#

try

// Code to try goes here.

catch (SomeSpecificException ex)

// Code to handle the exception goes here.

// Only catch exceptions that you know how to handle.

// Never catch base class System.Exception without

// rethrowing it at the end of the catch block.

C#

try

// Code to try goes here.

finally

// Code to execute after the try block goes here.

C#

try

// Code to try goes here.

 catch (SomeSpecificException ex)

// Code to handle the exception goes here.

finally

// Code to execute after the try (and possibly catch) blocks

// goes here.

Un bloque try sin un bloque catch o finally produce un error del compilador.

Bloques catch
Los bloques catch pueden especificar el tipo de excepción que quiere detectar. La
especificación de tipo se denomina filtro de excepciones. El tipo de excepción se debe
derivar de Exception. En general, no especifique Exception como el filtro de excepciones
a menos que sepa cómo controlar todas las que puedan producirse en el bloque try o
que haya incluido una instrucción throw al final del bloque catch .

Se pueden encadenar juntos varios bloques catch con distintas clases de excepciones.
Los bloques catch se evalúan de arriba abajo en el código, pero solo se ejecuta un
bloque catch para cada excepción que se produce. Se ejecuta el primer bloque catch
que especifica el tipo exacto o una clase base de la excepción producida. Si no hay
ningún bloque catch que especifique una clase de excepciones coincidente, se
selecciona un bloque catch que no tenga ningún tipo, si hay alguno en la instrucción.
Es importante colocar primero los bloques catch con las clases de excepción más
específicas (es decir, las más derivadas).

Detecte excepciones cuando se cumplan las condiciones siguientes:

Comprende bien el motivo por el que podría producirse la excepción y puede

implementar una recuperación específica, por ejemplo, pedir al usuario que escriba
un nuevo nombre de archivo cuando detecte un objeto FileNotFoundException.
Puede crear y producir una nueva excepción más específica.

C#

int GetInt(int[] array, int index)

try

return array[index];

catch (IndexOutOfRangeException e)

throw new ArgumentOutOfRangeException(

"Parameter index is out of range.", e);

Quiere controlar parcialmente una excepción antes de pasarla para aumentar su

control. En el ejemplo siguiente, se usa un bloque catch para agregar una entrada
a un registro de errores antes de volver a producir la excepción.

C#

try

// Try to access a resource.

catch (UnauthorizedAccessException e)

// Call a custom error logging procedure.

LogError(e);

// Re-throw the error.

throw;

También puede especificar filtros de excepción para agregar una expresión booleana a
una cláusula catch. Los filtros de excepción indican que una cláusula catch específica
solo coincide cuando la condición es "true". En el ejemplo siguiente, ambas cláusulas
catch usan la misma clase de excepción, pero se comprueba una condición adicional
para crear un mensaje de error distinto:

C#

int GetInt(int[] array, int index)

try

return array[index];

catch (IndexOutOfRangeException e) when (index < 0)

throw new ArgumentOutOfRangeException(

"Parameter index cannot be negative.", e);

catch (IndexOutOfRangeException e)

throw new ArgumentOutOfRangeException(

"Parameter index cannot be greater than the array size.", e);

Se puede usar un filtro de excepción que siempre devuelva false para examinar todas
las excepciones, pero no para procesarlas. Un uso habitual es registrar excepciones:

C#

public static void Main()

try

string? s = null;

Console.WriteLine(s.Length);

catch (Exception e) when (LogException(e))

Console.WriteLine("Exception must have been handled");

private static bool LogException(Exception e)

Console.WriteLine($"\tIn the log routine. Caught {e.GetType()}");

Console.WriteLine($"\tMessage: {e.Message}");

return false;

El método LogException siempre devuelve false ; ninguna cláusula catch que use este
filtro de excepción coincide. La cláusula catch puede ser general, mediante el uso de
System.Exception, y las cláusulas posteriores pueden procesar clases de excepción más
específicas.

Bloques Finally
Los bloques finally permiten limpiar las acciones que se realizan en un bloque try . Si
está presente, el bloque finally se ejecuta en último lugar, después del bloque try y
de cualquier bloque catch coincidente. Un bloque finally siempre se ejecuta,
independientemente de si se produce una excepción o si se encuentra un bloque catch
que coincida con el tipo de excepción.

Los bloques finally pueden usarse para liberar recursos como secuencias de archivo,
conexiones de base de datos y controladores de gráficos sin necesidad de esperar a que
el recolector de elementos no utilizados en tiempo de ejecución finalice los objetos.
Para obtener más información, vea using (instrucción).

En el ejemplo siguiente, el bloque finally se usa para cerrar un archivo que se abre en
el bloque try . Observe que se comprueba el estado del identificador de archivos antes
de cerrar el archivo. Si el bloque try no puede abrir el archivo, el manipulador de
archivos sigue teniendo el valor null , y el bloque finally no intenta cerrarlo. En lugar
de eso, si el archivo se abre correctamente en el bloque try , el bloque finally cierra el
archivo abierto.

C#

FileStream? file = null;

FileInfo fileinfo = new System.IO.FileInfo("./file.txt");

try

file = fileinfo.OpenWrite();

file.WriteByte(0xF);

finally

// Check for null because OpenWrite might have failed.

file?.Close();

Especificación del lenguaje C#

Para obtener más información, vea las secciones Excepciones y La instrucción try de la
Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la
sintaxis y el uso de C#.

Consulte también
Referencia de C#
try-catch
try-finally
try-catch-finally
using (instrucción)
Creación y producción de excepciones
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Las excepciones se usan para indicar que se ha producido un error mientras se

ejecutaba el programa. Se crean los objetos de excepción que describen un error y,
luego, se producen con la palabra clave throw. Después, el tiempo de ejecución busca el
controlador de excepciones más compatible.

Los programadores deberían producir excepciones cuando una o varias de las

siguientes condiciones sean verdaderas:

El método no puede finalizar su función definida. Por ejemplo, si un parámetro de

un método tiene un valor no válido:

C#

static void CopyObject(SampleClass original)

_ = original ?? throw new ArgumentException("Parameter cannot be

null", nameof(original));

Se realiza una llamada inadecuada a un objeto, en función del estado del objeto.
Un ejemplo podría ser intentar escribir en un archivo de solo lectura. En los casos
en los que un estado de objeto no permite una operación, genere una instancia de
InvalidOperationException o un objeto con base en una derivación de esta clase. El
código siguiente es un ejemplo de un método que genera un objeto
InvalidOperationException:

C#

public class ProgramLog

{

FileStream logFile = null!;

public void OpenLog(FileInfo fileName, FileMode mode) { }

public void WriteLog()

if (!logFile.CanWrite)

throw new InvalidOperationException("Logfile cannot be

read-only");

// Else write data to the log and return.

 Cuando un argumento de un método genera una excepción. En este caso, se debe

detectar la excepción original y se debe crear una instancia de ArgumentException.
La excepción original debe pasarse al constructor de ArgumentException como el
parámetro InnerException:

C#

static int GetValueFromArray(int[] array, int index)

try

return array[index];

catch (IndexOutOfRangeException e)

throw new ArgumentOutOfRangeException(

"Parameter index is out of range.", e);

７ Nota

El ejemplo anterior es para fines ilustrativos. La validación de índices a través de

excepciones es, en la mayoría de los casos, una práctica incorrecta. Las excepciones
deben estar reservadas para protegerse frente a condiciones de programa
excepcionales, no para la comprobación de argumentos que se ha visto antes.

Las excepciones contienen una propiedad denominada StackTrace. Esta cadena contiene
el nombre de los métodos de la pila de llamadas actual, junto con el nombre de archivo
y el número de la línea en la que se ha producido la excepción para cada método.
Common Language Runtime (CLR) crea automáticamente un objeto StackTrace desde el
punto de la instrucción throw , de manera que todas las excepciones se deben producir
desde el punto en el que debe comenzar el seguimiento de la pila.

Todas las excepciones contienen una propiedad denominada Message. Esta cadena
debe establecerse para que explique el motivo de la excepción. No se debe colocar
información confidencial en materia de seguridad en el texto del mensaje. Además de
Message, ArgumentException contiene una propiedad denominada ParamName que
debe establecerse en el nombre del argumento que ha provocado que se genere la
excepción. En un establecedor de propiedades, ParamName debe establecerse en
value .
Los métodos públicos y protegidos generan excepciones siempre que no puedan
finalizar sus funciones previstas. La clase de excepciones generada es la excepción más
específica disponible que se ajuste a las condiciones de error. Estas excepciones se
deben documentar como parte de la funcionalidad de la clase, y las clases derivadas o
actualizaciones de la clase original deben mantener el mismo comportamiento para la
compatibilidad con versiones anteriores.

Aspectos que se deben evitar al producir

excepciones
En la siguiente lista se identifican los procedimientos que se deben evitar al producir
excepciones:

No use excepciones para cambiar el flujo de un programa como parte de la

ejecución normal. Use excepciones para notificar y controlar condiciones de error.
Las excepciones no se deben devolver como un parámetro o valor devuelto en
lugar de producirse.
No genere System.Exception, System.SystemException,
System.NullReferenceException ni System.IndexOutOfRangeException de manera
intencionada desde su propio código fuente.
No cree excepciones que se puedan producir en el modo de depuración, pero no
en el modo de lanzamiento. Para identificar los errores en tiempo de ejecución
durante la fase de desarrollo, use la aserción de depuración.

Definir clases de excepción

Los programas pueden producir una clase de excepción predefinida en el espacio de
nombres System (excepto en los casos indicados anteriormente) o crear sus propias
clases de excepción mediante la derivación de Exception. Las clases derivadas deben
definir al menos tres constructores: un constructor sin parámetros, uno que establezca la
propiedad de mensaje y otro que establezca las propiedades Message y InnerException.
Por ejemplo:

C#

[Serializable]

public class InvalidDepartmentException : Exception

public InvalidDepartmentException() : base() { }

public InvalidDepartmentException(string message) : base(message) { }

public InvalidDepartmentException(string message, Exception inner) :

 base(message, inner) { }

Agregue propiedades nuevas a la clase de excepción cuando los datos que

proporcionan sean útiles para resolver la excepción. Si se agregan nuevas propiedades a
la clase de excepción derivada, se debe invalidar ToString() para devolver la
información agregada.

Especificación del lenguaje C#

Para obtener más información, vea las secciones Excepciones y La instrucción throw de
la Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de
la sintaxis y el uso de C#.

Vea también
Jerarquía de excepciones
Excepciones generadas por el
compilador
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Algunas excepciones las inicia automáticamente el entorno de ejecución .NET cuando se

producen errores de operaciones básicas. En la tabla siguiente se enumeran estas
excepciones y sus condiciones de error.

Excepción Descripción

ArithmeticException Una clase base para las excepciones que se producen durante las
operaciones aritméticas, como DivideByZeroException y
OverflowException.

ArrayTypeMismatchException Se inicia cuando una matriz no puede almacenar un elemento

determinado porque el tipo real del elemento es incompatible
con el tipo real de la matriz.

DivideByZeroException Se inicia cuando se intenta dividir un valor entero entre cero.

IndexOutOfRangeException Se inicia cuando se intenta indexar una matriz y el índice es

menor que cero o queda fuera de los límites de la matriz.

InvalidCastException Se inicia cuando se produce un error, en tiempo de ejecución, en

una conversión explícita de un tipo base a una interfaz o a un tipo
derivado.

NullReferenceException Se inicia cuando se intenta hacer referencia a un objeto cuyo

valor es null.

OutOfMemoryException Se inicia cuando se produce un error al intentar asignar memoria

con el operador new. Esta excepción indica que se ha agotado la
memoria disponible para el entorno compatible con Common
Language Runtime.

OverflowException Se inicia cuando se desborda una operación aritmética en un

contexto checked .

StackOverflowException Se inicia cuando se agota la pila de ejecución por tener

demasiadas llamadas a métodos pendientes. Normalmente,
indica una recursividad muy profunda o infinita.

TypeInitializationException Se inicia cuando un constructor estático inicia una excepción y no

existe una cláusula catch compatible para capturarla.

Vea también
try-catch
try-finally
try-catch-finally
Convenciones y reglas de nomenclatura
de identificadores de C#
Artículo • 29/11/2022 • Tiempo de lectura: 2 minutos

Un identificador es el nombre que se asigna a un tipo (clase, interfaz, estructura,

registro, delegado o enumeración), miembro, variable o espacio de nombres.

Reglas de nomenclatura
Los identificadores válidos deben seguir estas reglas:

Los identificadores deben comenzar con una letra o un carácter de subrayado ( _ ).

Los identificadores pueden contener caracteres de letra Unicode, caracteres de
dígito decimales, caracteres de conexión Unicode, caracteres de combinación
Unicode o caracteres de formato Unicode. Para obtener más información sobre las
categorías Unicode, vea la base de datos de categorías Unicode .
Puede declarar
identificadores que coincidan con palabras clave de C# mediante el prefijo @ en el
identificador. @ no forma parte del nombre de identificador. Por ejemplo, @if
declara un identificador denominado if . Estos identificadores textuales son
principalmente para la interoperabilidad con los identificadores declarados en
otros lenguajes.

Para obtener una definición completa de identificadores válidos, vea el tema

Identificadores en la Especificación del lenguaje C#.

Convenciones de nomenclatura
Además de las reglas, hay muchas convenciones de nomenclatura de identificadores
que se utilizan en las API de .NET. Por convención, los programas de C# usan
PascalCase para nombres de tipo, espacios de nombres y todos los miembros públicos.
Además, son comunes las convenciones siguientes:

Los nombres de interfaz empiezan por una I mayúscula.

Los tipos de atributo terminan con la palabra Attribute .
Los tipos de enumeración usan un sustantivo singular para los que no son marcas
y uno plural para los que sí.
Los identificadores no deben contener dos caracteres de subrayado ( _ )
consecutivos. Esos nombres están reservados para los identificadores generados
por el compilador.
Para más información, consulte Convenciones de nomenclatura.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Guía de programación de C#
Referencia de C#
Clases
Tipos de estructura
Espacios de nombres
Interfaces
Delegados
Convenciones de código de C#
Artículo • 03/03/2023 • Tiempo de lectura: 13 minutos

Las convenciones de codificación tienen los objetivos siguientes:

＂ Crean una apariencia coherente en el código, para que los lectores puedan
centrarse en el contenido, no en el diseño.
＂ Permiten a los lectores comprender el código más rápidamente al hacer
suposiciones basadas en la experiencia anterior.
＂ Facilitan la copia, el cambio y el mantenimiento del código.
＂ Muestran los procedimientos recomendados de C#.

） Importante

Microsoft usa las instrucciones de este artículo para desarrollar ejemplos y

documentación. Se adoptaron a partir de las instrucciones de estilo de codificación
de .NET Runtime y C# . Puede usarlas o adaptarlas a sus necesidades. Los
objetivos principales son la coherencia y la legibilidad dentro del proyecto, el
equipo, la organización o el código fuente de la empresa.

Convenciones de nomenclatura
Hay varias convenciones de nomenclatura que se deben tener en cuenta al escribir
código de C#.

En los ejemplos siguientes, cualquiera de las instrucciones relativas a los elementos

marcados public también es aplicable cuando se trabaja con elementos protected y
protected internal , los cuales están diseñados para ser visibles para los autores de

llamadas externos.

Pascal case
Use la grafía Pascal ("PascalCasing") al asignar un nombre a class , record o struct .

C#

public class DataService

 C#

public record PhysicalAddress(

string Street,

string City,

string StateOrProvince,

string ZipCode);

C#

public struct ValueCoordinate

Al asignar un nombre a interface , use la grafía Pascal además de agregar el prefijo I al

nombre. Esto indica claramente a los consumidores que es un elemento interface .

C#

public interface IWorkerQueue

Al asignar nombres a miembros public de tipos, como campos, propiedades, eventos,

métodos y funciones locales, use la grafía Pascal.

C#

public class ExampleEvents

// A public field, these should be used sparingly

public bool IsValid;

// An init-only property

public IWorkerQueue WorkerQueue { get; init; }

// An event

public event Action EventProcessing;

// Method

public void StartEventProcessing()

// Local function

static int CountQueueItems() => WorkerQueue.Count;

// ...

Al escribir registros posicionales, use la grafía Pascal para los parámetros, ya que son las
propiedades públicas del registro.

C#

public record PhysicalAddress(

string Street,

string City,

string StateOrProvince,

string ZipCode);

Para más información sobre los registros posicionales, consulte Sintaxis posicional para
la definición de propiedades.

Grafía Camel
Use la grafía Camel ("camelCasing") al asignar nombres a campos private o internal , y
prefijos con _ .

C#

public class DataService

private IWorkerQueue _workerQueue;

 Sugerencia

Al editar código de C# que sigue estas convenciones de nomenclatura en un IDE

que admite la finalización de instrucciones, al escribir _ se mostrarán todos los
miembros con ámbito de objeto.

Al trabajar con campos static que sean private o internal , use el prefijo s_ y, para el
subproceso estático, use t_ .

C#

public class DataService

private static IWorkerQueue s_workerQueue;

[ThreadStatic]

private static TimeSpan t_timeSpan;

Al escribir parámetros de método, use la grafía Camel.

C#

public T SomeMethod<T>(int someNumber, bool isValid)

Para obtener más información sobre las convenciones de nomenclatura de C#, vea Estilo
de codificación de C# .

Convenciones de nomenclatura adicionales

En ejemplos que no incluyan directivas using, use calificaciones de espacio de
nombres. Si sabe que un espacio de nombres se importa en un proyecto de forma
predeterminada, no es necesario completar los nombres de ese espacio de
nombres. Los nombres completos pueden partirse después de un punto (.) si son
demasiado largos para una sola línea, como se muestra en el ejemplo siguiente.

C#

var currentPerformanceCounterCategory = new System.Diagnostics.

PerformanceCounterCategory();

No es necesario cambiar los nombres de objetos que se crearon con las

herramientas del diseñador de Visual Studio para que se ajusten a otras directrices.

Convenciones de diseño
Un buen diseño utiliza un formato que destaque la estructura del código y haga que el
código sea más fácil de leer. Las muestras y ejemplos de Microsoft cumplen las
convenciones siguientes:

Utilice la configuración del Editor de código predeterminada (sangría automática,

sangrías de 4 caracteres, tabulaciones guardadas como espacios). Para obtener
más información, vea Opciones, editor de texto, C#, formato.

Escriba solo una instrucción por línea.

Escriba solo una declaración por línea.

Si a las líneas de continuación no se les aplica sangría automáticamente, hágalo

con una tabulación (cuatro espacios).
 Agregue al menos una línea en blanco entre las definiciones de método y las de
propiedad.

Utilice paréntesis para que las cláusulas de una expresión sean evidentes, como se
muestra en el código siguiente.

C#

if ((val1 > val2) && (val1 > val3))

// Take appropriate action.

Colocación de directivas using fuera de la

declaración del espacio de nombres
Cuando una directiva using está fuera de la declaración de un espacio de nombres, ese
espacio de nombres importado es su nombre completo. Eso es más claro. Cuando la
directiva using está dentro del espacio de nombres, puede ser relativa al espacio de
nombres o su nombre completo. Eso es ambiguo.

C#

using Azure;

namespace CoolStuff.AwesomeFeature

public class Awesome

public void Stuff()

WaitUntil wait = WaitUntil.Completed;

Se supone que hay una referencia (directa o indirecta) a la clase WaitUntil.

Ahora vamos a cambiarla ligeramente:

C#

namespace CoolStuff.AwesomeFeature

using Azure;

public class Awesome

public void Stuff()

WaitUntil wait = WaitUntil.Completed;

Y se compila hoy. Y mañana. Sin embargo, en algún momento de la próxima semana,

este código (sin modificar) produce dos errores:

Consola

- error CS0246: The type or namespace name 'WaitUntil' could not be found
(are you missing a using directive or an assembly reference?)

- error CS0103: The name 'WaitUntil' does not exist in the current context

Una de las dependencias ha introducido esta clase en un espacio de nombres y,

después, finaliza con .Azure :

C#

namespace CoolStuff.Azure

public class SecretsManagement

public string FetchFromKeyVault(string vaultId, string secretId) {

return null; }

Una directiva using colocada dentro de un espacio de nombres es contextual y

complica la resolución de nombres. En este ejemplo, es el primer espacio de nombres
que encuentra.

CoolStuff.AwesomeFeature.Azure
CoolStuff.Azure

Azure

Si se agrega un nuevo espacio de nombres que coincida con CoolStuff.Azure o

CoolStuff.AwesomeFeature.Azure , se tomaría como coincidencia antes que el espacio de

nombres global Azure . Para resolverlo, agregue el modificador global:: a la

declaración using . Sin embargo, es más fácil colocar declaraciones using fuera del
espacio de nombres.

C#

namespace CoolStuff.AwesomeFeature

using global::Azure;

public class Awesome

public void Stuff()

WaitUntil wait = WaitUntil.Completed;

Convenciones de los comentarios

Coloque el comentario en una línea independiente, no al final de una línea de
código.

Comience el texto del comentario con una letra mayúscula.

Finalice el texto del comentario con un punto.

Inserte un espacio entre el delimitador de comentario (//) y el texto del

comentario, como se muestra en el ejemplo siguiente.

C#

// The following declaration creates a query. It does not run

// the query.

No crees bloques de formato con asteriscos alrededor de los comentarios.

Asegúrese de que todos los miembros públicos tengan los comentarios XML
necesarios que proporcionan descripciones adecuadas sobre su comportamiento.

Convenciones de lenguaje
En las secciones siguientes se describen las prácticas que sigue el equipo C# para
preparar las muestras y ejemplos de código.
Tipo de datos String
Use interpolación de cadenas para concatenar cadenas cortas, como se muestra en
el código siguiente.

C#

string displayName = $"{nameList[n].LastName},

{nameList[n].FirstName}";

Para anexar cadenas en bucles, especialmente cuando se trabaja con grandes

cantidades de texto, utilice un objeto StringBuilder.

C#

var phrase =
"lalalalalalalalalalalalalalalalalalalalalalalalalalalalalala";

var manyPhrases = new StringBuilder();

for (var i = 0; i < 10000; i++)

manyPhrases.Append(phrase);

//Console.WriteLine("tra" + manyPhrases);

Variables locales con tipo implícito

Use tipos implícitos para las variables locales cuando el tipo de la variable sea
obvio desde el lado derecho de la asignación, o cuando el tipo exacto no sea
importante.

C#

var var1 = "This is clearly a string.";

var var2 = 27;

No use var cuando el tipo no sea evidente desde el lado derecho de la asignación.
No asuma que el tipo está claro a partir de un nombre de método. Se considera
que un tipo de variable es claro si es un operador new o una conversión explícita.

C#

int var3 = Convert.ToInt32(Console.ReadLine());

int var4 = ExampleClass.ResultSoFar();

No confíe en el nombre de variable para especificar el tipo de la variable. Puede no

ser correcto. En el siguiente ejemplo, el nombre de la variable inputInt es
engañoso. Es una cadena.

C#

var inputInt = Console.ReadLine();

Console.WriteLine(inputInt);

Evite el uso de var en lugar de dynamic. Use dynamic cuando desee la inferencia
de tipos en tiempo de ejecución. Para obtener más información, vea Uso de tipo
dinámico (Guía de programación de C#).

Use tipos implícitos para determinar el tipo de la variable de bucle en bucles for.

En el ejemplo siguiente se usan tipos implícitos en una instrucción for .

C#

var phrase =
"lalalalalalalalalalalalalalalalalalalalalalalalalalalalalala";

var manyPhrases = new StringBuilder();

for (var i = 0; i < 10000; i++)

manyPhrases.Append(phrase);

//Console.WriteLine("tra" + manyPhrases);

No use tipos implícitos para determinar el tipo de la variable de bucle en bucles

foreach. En la mayoría de los casos, el tipo de elementos de la colección no es
inmediatamente obvio. El nombre de la colección no debe servir únicamente para
inferir el tipo de sus elementos.

En el ejemplo siguiente se usan tipos explícitos en una instrucción foreach .

C#

foreach (char ch in laugh)

if (ch == 'h')

Console.Write("H");

else

Console.Write(ch);

Console.WriteLine();

 ７ Nota

Tenga cuidado de no cambiar accidentalmente un tipo de elemento de la

colección iterable. Por ejemplo, es fácil cambiar de System.Linq.IQueryable a
System.Collections.IEnumerable en una instrucción foreach , lo cual cambia la
ejecución de una consulta.

Tipos de datos sin signo

En general, utilice int en lugar de tipos sin signo. El uso de int es común en todo C#, y
es más fácil interactuar con otras bibliotecas cuando se usa int .

Matrices
Utilice sintaxis concisa para inicializar las matrices en la línea de declaración. En el
siguiente ejemplo, observe que no puede utilizar var en lugar de string[] .

C#

string[] vowels1 = { "a", "e", "i", "o", "u" };

Si usa la creación de instancias explícita, puede usar var .

C#

var vowels2 = new string[] { "a", "e", "i", "o", "u" };

Delegados
Use Func<> y Action<> en lugar de definir tipos de delegado. En una clase, defina el
método delegado.

C#

public static Action<string> ActionExample1 = x => Console.WriteLine($"x is:

{x}");

public static Action<string, string> ActionExample2 = (x, y) =>

Console.WriteLine($"x is: {x}, y is {y}");

public static Func<string, int> FuncExample1 = x => Convert.ToInt32(x);

 public static Func<int, int, int> FuncExample2 = (x, y) => x + y;

Llame al método con la signatura definida por el delegado Func<> o Action<> .

C#

ActionExample1("string for x");

ActionExample2("string for x", "string for y");

Console.WriteLine($"The value is {FuncExample1("1")}");

Console.WriteLine($"The sum is {FuncExample2(1, 2)}");

Si crea instancias de un tipo de delegado, utilice la sintaxis concisa. En una clase, defina
el tipo de delegado y un método que tenga una firma coincidente.

C#

public delegate void Del(string message);

public static void DelMethod(string str)

Console.WriteLine("DelMethod argument: {0}", str);

Cree una instancia del tipo de delegado y llámela. La siguiente declaración muestra la
sintaxis condensada.

C#

Del exampleDel2 = DelMethod;

exampleDel2("Hey");

La siguiente declaración utiliza la sintaxis completa.

C#

Del exampleDel1 = new Del(DelMethod);

exampleDel1("Hey");

Instrucciones try - catch y using en el control de

excepciones
Use una instrucción try-catch en la mayoría de casos de control de excepciones.

C#

static string GetValueFromArray(string[] array, int index)

try

return array[index];

catch (System.IndexOutOfRangeException ex)

Console.WriteLine("Index is out of range: {0}", index);

throw;

Simplifique el código mediante la instrucción using de C#. Si tiene una instrucción

try-finally en la que el único código del bloque finally es una llamada al método
Dispose, use en su lugar una instrucción using .

En el ejemplo siguiente, la instrucción try - finally solo llama a Dispose en el

bloque finally .

C#

Font font1 = new Font("Arial", 10.0f);

try

byte charset = font1.GdiCharSet;

finally

if (font1 != null)

((IDisposable)font1).Dispose();

Puede hacer lo mismo con una instrucción using .

C#

using (Font font2 = new Font("Arial", 10.0f))

byte charset2 = font2.GdiCharSet;

 Use la nueva sintaxis using que no requiere corchetes:

C#

using Font font3 = new Font("Arial", 10.0f);

byte charset3 = font3.GdiCharSet;

Operadores && y ||
Para evitar excepciones y aumentar el rendimiento omitiendo las comparaciones
innecesarias, use && en lugar de & y || en lugar de | cuando realice comparaciones,
como se muestra en el ejemplo siguiente.

C#

Console.Write("Enter a dividend: ");

int dividend = Convert.ToInt32(Console.ReadLine());

Console.Write("Enter a divisor: ");

int divisor = Convert.ToInt32(Console.ReadLine());

if ((divisor != 0) && (dividend / divisor > 0))

Console.WriteLine("Quotient: {0}", dividend / divisor);

else

Console.WriteLine("Attempted division by 0 ends up here.");

Si el divisor es 0, la segunda cláusula de la instrucción if produciría un error en tiempo

de ejecución. Pero el operador && se cortocircuita cuando la primera expresión es falsa.
Es decir, no evalúa la segunda expresión. El operador & evaluaría ambas, lo que
provocaría un error en tiempo de ejecución cuando divisor es 0.

Operador new
Use una de las formas concisas de creación de instancias de objeto, tal como se
muestra en las declaraciones siguientes. En el segundo ejemplo se muestra la
sintaxis que está disponible a partir de C# 9.

C#

var instance1 = new ExampleClass();

 C#

ExampleClass instance2 = new();

Las declaraciones anteriores son equivalentes a la siguiente declaración.

C#

ExampleClass instance2 = new ExampleClass();

Use inicializadores de objeto para simplificar la creación de objetos, tal y como se

muestra en el ejemplo siguiente.

C#

var instance3 = new ExampleClass { Name = "Desktop", ID = 37414,

Location = "Redmond", Age = 2.3 };

En el ejemplo siguiente se establecen las mismas propiedades que en el ejemplo

anterior, pero no se utilizan inicializadores.

C#

var instance4 = new ExampleClass();

instance4.Name = "Desktop";

instance4.ID = 37414;

instance4.Location = "Redmond";

instance4.Age = 2.3;

Control de eventos
Si va a definir un controlador de eventos que no es necesario quitar más tarde, utilice
una expresión lambda.

C#

public Form2()

this.Click += (s, e) =>

MessageBox.Show(

((MouseEventArgs)e).Location.ToString());

};

La expresión lambda acorta la siguiente definición tradicional.

C#

public Form1()

this.Click += new EventHandler(Form1_Click);

void Form1_Click(object? sender, EventArgs e)

MessageBox.Show(((MouseEventArgs)e).Location.ToString());

Miembros estáticos
Llame a miembros estáticos con el nombre de clase: ClassName.StaticMember. Esta
práctica hace que el código sea más legible al clarificar el acceso estático. No califique
un miembro estático definido en una clase base con el nombre de una clase derivada.
Mientras el código se compila, su legibilidad se presta a confusión, y puede
interrumpirse en el futuro si se agrega a un miembro estático con el mismo nombre a la
clase derivada.

Consultas LINQ
Utilice nombres descriptivos para las variables de consulta. En el ejemplo siguiente,
se utiliza seattleCustomers para los clientes que se encuentran en Seattle.

C#

var seattleCustomers = from customer in customers

where customer.City == "Seattle"

select customer.Name;

Utilice alias para asegurarse de que los nombres de propiedad de tipos anónimos
se escriben correctamente con mayúscula o minúscula, usando para ello la grafía
Pascal.

C#

var localDistributors =

from customer in customers

join distributor in distributors on customer.City equals

distributor.City

select new { Customer = customer, Distributor = distributor };

Cambie el nombre de las propiedades cuando puedan ser ambiguos en el

resultado. Por ejemplo, si la consulta devuelve un nombre de cliente y un
identificador de distribuidor, en lugar de dejarlos como Name e ID en el resultado,
cambie su nombre para aclarar que Name es el nombre de un cliente e ID es el
identificador de un distribuidor.

C#

var localDistributors2 =

from customer in customers

join distributor in distributors on customer.City equals

distributor.City

select new { CustomerName = customer.Name, DistributorID =

distributor.ID };

Utilice tipos implícitos en la declaración de variables de consulta y variables de

intervalo.

C#

var seattleCustomers = from customer in customers

where customer.City == "Seattle"

select customer.Name;

Alinee las cláusulas de consulta bajo la cláusula from, como se muestra en los
ejemplos anteriores.

Use cláusulas where antes de otras cláusulas de consulta para asegurarse de que
las cláusulas de consulta posteriores operan en un conjunto de datos reducido y
filtrado.

C#

var seattleCustomers2 = from customer in customers

where customer.City == "Seattle"

orderby customer.Name

select customer;

Use varias cláusulas from en lugar de una cláusula join para obtener acceso a
colecciones internas. Por ejemplo, una colección de objetos Student podría
contener cada uno un conjunto de resultados de exámenes. Cuando se ejecuta la
siguiente consulta, devuelve cada resultado superior a 90, además del apellido del
alumno que recibió la puntuación.
 C#

var scoreQuery = from student in students

from score in student.Scores!

where score > 90

select new { Last = student.LastName, score };

Seguridad
Siga las instrucciones de Instrucciones de codificación segura.

Consulte también
Instrucciones de codificación en el entorno de ejecución de .NET
Convenciones de código de Visual Basic
Instrucciones de codificación segura
Procedimiento para mostrar
argumentos de la línea de comandos
Artículo • 28/11/2022 • Tiempo de lectura: 2 minutos

Los argumentos proporcionados para un archivo ejecutable en la línea de comandos

son accesibles en instrucciones de nivel superior o mediante un parámetro opcional
para Main . Los argumentos se proporcionan en forma de una matriz de cadenas. Cada
elemento de la matriz contiene un argumento. Se quita el espacio en blanco entre los
argumentos. Por ejemplo, considere estas invocaciones de línea de comandos de un
ejecutable ficticio:

Entrada en la línea de comandos Matriz de cadenas que se pasa a Main

executable.exe a b c "a"

"b"

"c"

executable.exe one two "one"

"two"

executable.exe "one two" three "one two"

"three"

７ Nota

Si se ejecuta una aplicación en Visual Studio, se pueden especificar argumentos de

línea de comandos en la Página Depuración, Diseñador de proyectos.

Ejemplo
En este ejemplo se muestran los argumentos de la línea de comandos pasados a una
aplicación de la línea de comandos. La salida que se muestra corresponde a la primera
entrada de la tabla anterior.

C#

// The Length property provides the number of array elements.

Console.WriteLine($"parameter count = {args.Length}");

 for (int i = 0; i < args.Length; i++)

Console.WriteLine($"Arg[{i}] = [{args[i]}]");

/* Output (assumes 3 cmd line args):

parameter count = 3

Arg[0] = [a]

Arg[1] = [b]

Arg[2] = [c]

*/

Consulte también
Introducción a System.CommandLine
Tutorial: Introducción a System.CommandLine
Exploración de la programación
orientada a objetos con clases y objetos
Artículo • 28/11/2022 • Tiempo de lectura: 10 minutos

En este tutorial, creará una aplicación de consola y conocerá las características básicas
orientadas a objetos que forman parte del lenguaje C#.

Requisitos previos
Se recomienda tener Visual Studio para Windows o Mac. Puede descargar una
versión gratuita desde la página de descargas de Visual Studio . Visual Studio
incluye el SDK de .NET.
También se puede usar el editor de Visual Studio Code . Deberá instalar el SDK
de .NET más reciente por separado.
Si prefiere usar otro editor, deberá instalar el SDK de .NET más reciente.

Creación de una aplicación

En una ventana de terminal, cree un directorio denominado clases. Creará la aplicación
ahí. Cambie a ese directorio y escriba dotnet new console en la ventana de la consola.
Este comando crea la aplicación. Abra Program.cs. El resultado debería tener un aspecto
similar a este:

C#

// See https://aka.ms/new-console-template for more information

Console.WriteLine("Hello, World!");

En este tutorial, se van a crear tipos nuevos que representan una cuenta bancaria.
Normalmente los desarrolladores definen cada clase en un archivo de texto diferente.
De esta forma, la tarea de administración resulta más sencilla a medida que aumenta el
tamaño del programa. Cree un archivo denominado BankAccount.cs en el directorio
Classes.

Este archivo va a contener la definición de una cuenta bancaria. La programación

orientada a objetos organiza el código creando tipos en forma de clases. Estas clases
contienen el código que representa una entidad específica. La clase BankAccount
representa una cuenta bancaria. El código implementa operaciones específicas a través
de métodos y propiedades. En este tutorial, la cuenta bancaria admite el siguiente
comportamiento:

1. Tiene un número de diez dígitos que identifica la cuenta bancaria de forma única.
2. Tiene una cadena que almacena el nombre o los nombres de los propietarios.
3. Se puede consultar el saldo.
4. Acepta depósitos.
5. Acepta reintegros.
6. El saldo inicial debe ser positivo.
7. Los reintegros no pueden generar un saldo negativo.

Definición del tipo de cuenta bancaria

Puede empezar por crear los datos básicos de una clase que define dicho
comportamiento. Cree un archivo con el comando File:New. Asígnele el nombre
BankAccount.cs. Agregue el código siguiente al archivo BankAccount.cs:

C#

namespace Classes;

public class BankAccount

public string Number { get; }

public string Owner { get; set; }

public decimal Balance { get; }

public void MakeDeposit(decimal amount, DateTime date, string note)

public void MakeWithdrawal(decimal amount, DateTime date, string note)

Antes de avanzar, se va a dar un repaso a lo que ha compilado. La declaración

namespace permite organizar el código de forma lógica. Este tutorial es relativamente

pequeño, por lo que deberá colocar todo el código en un espacio de nombres.

public class BankAccount define la clase o el tipo que quiere crear. Todo lo que se

encuentra entre { y } después de la declaración de clase define el estado y el

comportamiento de la clase. La clase BankAccount cuenta con cinco miembros. Los tres
primeros son propiedades. Las propiedades son elementos de datos que pueden
contener código que exige la validación u otras reglas. Los dos últimos son métodos.
Los métodos son bloques de código que realizan una única función. La lectura de los
nombres de cada miembro debe proporcionar suficiente información tanto al usuario
como a otro desarrollador para entender cuál es la función de la clase.

Apertura de una cuenta nueva

La primera característica que se va a implementar es la apertura de una cuenta bancaria.
Cuando un cliente abre una cuenta, debe proporcionar un saldo inicial y la información
sobre el propietario o los propietarios de esa cuenta.

Para crear un objeto de tipo BankAccount , es necesario definir un constructor que asigne
esos valores. Un constructor es un miembro que tiene el mismo nombre que la clase. Se
usa para inicializar los objetos de ese tipo de clase. Agregue el siguiente constructor al
tipo BankAccount . Coloque el siguiente código encima de la declaración de MakeDeposit .

C#

public BankAccount(string name, decimal initialBalance)

this.Owner = name;

this.Balance = initialBalance;

En el código anterior se identifican las propiedades del objeto que se está construyendo
mediante la inclusión del calificador this . Ese calificador suele ser opcional y se omite.
También podría haber escrito lo siguiente:

C#

public BankAccount(string name, decimal initialBalance)

Owner = name;

Balance = initialBalance;

El calificador this solo es necesario cuando una variable o un parámetro local tiene el
mismo nombre que el campo o la propiedad. El calificador this se omite en el resto de
este artículo, a menos que sea necesario.

A los constructores se les llama cuando se crea un objeto mediante new. Reemplace la
línea Console.WriteLine("Hello World!"); de Program.cs por la siguiente línea
(reemplace <name> por su nombre):

C#
 using Classes;

var account = new BankAccount("<name>", 1000);

Console.WriteLine($"Account {account.Number} was created for {account.Owner}

with {account.Balance} initial balance.");

Vamos a ejecutar lo que se ha creado hasta ahora. Si usa Visual Studio, seleccione Iniciar
sin depurar en el menú Depurar. Si va a usar una línea de comandos, escriba dotnet
run en el directorio en el que ha creado el proyecto.

¿Ha observado que el número de cuenta está en blanco? Es el momento de

solucionarlo. El número de cuenta debe asignarse cuando se construye el objeto. Sin
embargo, el autor de la llamada no es el responsable de crearlo. El código de la clase
BankAccount debe saber cómo asignar nuevos números de cuenta. Una manera sencilla

de empezar es con un número de diez dígitos. Increméntelo cuando cree cada cuenta.
Por último, almacene el número de cuenta actual cuando se construya un objeto.

Agregue una declaración de miembro a la clase BankAccount . Coloque la siguiente línea

de código después de la llave de apertura { al principio de la clase BankAccount :

C#

private static int accountNumberSeed = 1234567890;

accountNumberSeed es un miembro de datos. Tiene el estado private , lo que significa

que solo se puede acceder a él con el código incluido en la clase BankAccount . Es una
forma de separar las responsabilidades públicas (como tener un número de cuenta) de
la implementación privada (cómo se generan los números de cuenta). También es
static , lo que significa que lo comparten todos los objetos BankAccount . El valor de

una variable no estática es único para cada instancia del objeto BankAccount . Agregue
las dos líneas siguientes al constructor para asignar el número de cuenta: Colóquelas
después de la línea donde pone this.Balance = initialBalance :

C#

this.Number = accountNumberSeed.ToString();

accountNumberSeed++;

Escriba dotnet run para ver los resultados.

Creación de depósitos y reintegros

La clase de la cuenta bancaria debe aceptar depósitos y reintegros para que el
funcionamiento sea adecuado. Se van a implementar depósitos y reintegros con la
creación de un diario de cada transacción de la cuenta. Hacer un seguimiento de cada
transacción ofrece algunas ventajas con respecto a limitarse a actualizar el saldo en cada
transacción. El historial se puede utilizar para auditar todas las transacciones y
administrar los saldos diarios. Con el cálculo del saldo a partir del historial de todas las
transacciones, cuando proceda, nos aseguramos de que todos los errores de una única
transacción que se solucionen se reflejarán correctamente en el saldo cuando se haga el
siguiente cálculo.

Se va a empezar por crear un tipo para representar una transacción. La transacción es un

tipo simple que no tiene ninguna responsabilidad. Necesita algunas propiedades. Cree
un archivo denominado Transaction.cs. Agregue el código siguiente a él:

C#

namespace Classes;

public class Transaction

public decimal Amount { get; }

public DateTime Date { get; }

public string Notes { get; }

public Transaction(decimal amount, DateTime date, string note)

Amount = amount;

Date = date;

Notes = note;

Ahora se va a agregar List<T> de objetos Transaction a la clase BankAccount . Agregue

la siguiente declaración después del constructor en el archivo BankAccount.cs:

C#

private List<Transaction> allTransactions = new List<Transaction>();

Ahora vamos a calcular correctamente Balance . El saldo actual se puede averiguar si se

suman los valores de todas las transacciones. Como el código es actual, solo puede
obtener el saldo inicial de la cuenta, así que tiene que actualizar la propiedad Balance .
Reemplace la línea public decimal Balance { get; } de BankAccount.cs con el código
siguiente:
 C#

public decimal Balance

get

decimal balance = 0;

foreach (var item in allTransactions)

balance += item.Amount;

return balance;

En este ejemplo se muestra un aspecto importante de las propiedades. Ahora va a

calcular el saldo cuando otro programador solicite el valor. El cálculo enumera todas las
transacciones y proporciona la suma como el saldo actual.

Después, implemente los métodos MakeDeposit y MakeWithdrawal . Estos métodos

aplicarán las dos reglas finales: el saldo inicial debe ser positivo, y ningún reintegro debe
generar un saldo negativo.

Las reglas presentan el concepto de las excepciones. La forma habitual de indicar que un
método no puede completar su trabajo correctamente consiste en generar una
excepción. El tipo de excepción y el mensaje asociado a ella describen el error. En este
caso, el método MakeDeposit genera una excepción si el importe del depósito no es
mayor que 0. El método MakeWithdrawal genera una excepción si el importe del
reintegro no es mayor que 0 o si el procesamiento de la operación tiene como resultado
un saldo negativo: Agregue el código siguiente después de la declaración de la lista
allTransactions :

C#

public void MakeDeposit(decimal amount, DateTime date, string note)

if (amount <= 0)

throw new ArgumentOutOfRangeException(nameof(amount), "Amount of

deposit must be positive");

var deposit = new Transaction(amount, date, note);

allTransactions.Add(deposit);
}

public void MakeWithdrawal(decimal amount, DateTime date, string note)

 if (amount <= 0)

throw new ArgumentOutOfRangeException(nameof(amount), "Amount of

withdrawal must be positive");

if (Balance - amount < 0)

throw new InvalidOperationException("Not sufficient funds for this

withdrawal");

var withdrawal = new Transaction(-amount, date, note);

allTransactions.Add(withdrawal);

La instrucción throwgenera una excepción. La ejecución del bloque actual finaliza y el

control se transfiere al primer bloque catch coincidente que se encuentra en la pila de
llamadas. Se agregará un bloque catch para probar este código un poco más adelante.

El constructor debe obtener un cambio para que agregue una transacción inicial, en
lugar de actualizar el saldo directamente. Puesto que ya escribió el método
MakeDeposit , llámelo desde el constructor. El constructor terminado debe tener este
aspecto:

C#

public BankAccount(string name, decimal initialBalance)

Number = accountNumberSeed.ToString();

accountNumberSeed++;

Owner = name;

MakeDeposit(initialBalance, DateTime.Now, "Initial balance");

DateTime.Now es una propiedad que devuelve la fecha y hora actuales. Para probar este
código, agregue algunos depósitos y reintegros en el método Main , siguiendo el código
con el que se crea un elemento BankAccount :

C#

account.MakeWithdrawal(500, DateTime.Now, "Rent payment");

Console.WriteLine(account.Balance);

account.MakeDeposit(100, DateTime.Now, "Friend paid me back");

Console.WriteLine(account.Balance);

Después, compruebe si detecta las condiciones de error intentando crear una cuenta
con un saldo negativo. Agregue el código siguiente después del código anterior que
acaba de agregar:

C#

// Test that the initial balances must be positive.

BankAccount invalidAccount;

try

invalidAccount = new BankAccount("invalid", -55);

catch (ArgumentOutOfRangeException e)

Console.WriteLine("Exception caught creating account with negative

balance");

Console.WriteLine(e.ToString());

return;

Use las instrucciones try y catch para marcar un bloque de código que puede generar
excepciones y para detectar los errores que se esperan. Puede usar la misma técnica
para probar el código que genera una excepción para un saldo negativo. Agregue el
código siguiente antes de la declaración de invalidAccount en el método Main :

C#

// Test for a negative balance.

try

account.MakeWithdrawal(750, DateTime.Now, "Attempt to overdraw");

catch (InvalidOperationException e)

Console.WriteLine("Exception caught trying to overdraw");

Console.WriteLine(e.ToString());

Guarde el archivo y escriba dotnet run para probarlo.

Desafío: registro de todas las transacciones

Para finalizar este tutorial, puede escribir el método GetAccountHistory que crea string
para el historial de transacciones. Agregue este método al tipo BankAccount :

C#

public string GetAccountHistory()

 var report = new System.Text.StringBuilder();

decimal balance = 0;

report.AppendLine("Date\t\tAmount\tBalance\tNote");

foreach (var item in allTransactions)

balance += item.Amount;

report.AppendLine($"
{item.Date.ToShortDateString()}\t{item.Amount}\t{balance}\t{item.Notes}");

return report.ToString();

En el historial se usa la clase StringBuilder para dar formato a una cadena que contiene
una línea para cada transacción. Se ha visto anteriormente en estos tutoriales el código
utilizado para dar formato a una cadena. Un carácter nuevo es \t . Inserta una pestaña
para dar formato a la salida.

Agregue esta línea para probarla en Program.cs:

C#

Console.WriteLine(account.GetAccountHistory());

Ejecute el programa para ver los resultados.

Pasos siguientes
Si se ha quedado bloqueado, puede consultar el origen de este tutorial en el repositorio
de GitHub .

Puede continuar con el tutorial de la programación orientada a objetos.

Puede aprender más sobre estos conceptos en los artículos siguientes:

Instrucciones de selección
Instrucciones de iteración
Programación orientada a objetos (C#)
Artículo • 28/11/2022 • Tiempo de lectura: 12 minutos

C# es un lenguaje de programación orientado a objetos. Los cuatro principios básicos

de la programación orientada a objetos son:

Abstracción: modelar los atributos e interacciones pertinentes de las entidades

como clases para definir una representación abstracta de un sistema.
Encapsulación: ocultar el estado interno y la funcionalidad de un objeto y permitir
solo el acceso a través de un conjunto público de funciones.
Herencia: capacidad de crear nuevas abstracciones basadas en abstracciones
existentes.
Polimorfismo: capacidad de implementar propiedades o métodos heredados de
maneras diferentes en varias abstracciones.

En el tutorial anterior, Introducción a las clases se trató la abstracción y la encapsulación.

La clase BankAccount proporcionó una abstracción para el concepto de una cuenta
bancaria. Puede modificar su implementación sin que afecte para nada al código que
usó la clase BankAccount . Las clases BankAccount y Transaction proporcionan
encapsulación de los componentes necesarios para describir esos conceptos en el
código.

En este tutorial, ampliará la aplicación para hacer uso de la herencia y el polimorfismo

para agregar nuevas características. También agregará características a la clase
BankAccount , aprovechando las técnicas de abstracción y encapsulación que aprendió en

el tutorial anterior.

Creación de diferentes tipos de cuentas

Después de compilar este programa, recibirá solicitudes para agregarle características.
Funciona bien en situaciones en las que solo hay un tipo de cuenta bancaria. Con el
tiempo, las necesidades cambian y se solicitan tipos de cuenta relacionados:

Una cuenta que devenga intereses que genera beneficios al final de cada mes.
Una línea de crédito que puede tener un saldo negativo, pero cuando sea así, se
producirá un cargo por intereses cada mes.
Una cuenta de tarjeta de regalo de prepago que comienza con un único depósito
y solo se puede liquidar. Se puede recargar una vez al principio de cada mes.

Todas estas cuentas diferentes son similares a la clase BankAccount definida en el tutorial
anterior. Podría copiar ese código, cambiar el nombre de las clases y realizar
modificaciones. Esa técnica funcionaría a corto plazo, pero a la larga supondría más
trabajo. Cualquier cambio se copiará en todas las clases afectadas.

En su lugar, puede crear nuevos tipos de cuenta bancaria que hereden métodos y datos
de la clase BankAccount creada en el tutorial anterior. Estas clases nuevas pueden
extender la clase BankAccount con el comportamiento específico necesario para cada
tipo:

C#

public class InterestEarningAccount : BankAccount

public class LineOfCreditAccount : BankAccount

{

public class GiftCardAccount : BankAccount

Cada una de estas clases hereda el comportamiento compartido de su clase base

compartida, la clase BankAccount . Escriba las implementaciones para la funcionalidad
nueva y diferente en cada una de las clases derivadas. Estas clases derivadas ya tienen
todo el comportamiento definido en la clase BankAccount .

Es recomendable crear cada clase nueva en un archivo de código fuente diferente. En

Visual Studio , puede hacer clic con el botón derecho en el proyecto y seleccionar
Agregar clase para agregar una clase nueva en un archivo nuevo. En Visual Studio
Code , seleccione Archivo y luego Nuevo para crear un nuevo archivo de código
fuente. En cualquier herramienta, ponga un nombre al archivo que coincida con la clase:
InterestEarningAccount.cs, LineOfCreditAccount.cs y GiftCardAccount.cs.

Cuando cree las clases como se muestra en el ejemplo anterior, observará que ninguna
de las clases derivadas se compila. La inicialización de un objeto es responsabilidad de
un constructor. Un constructor de clase derivada debe inicializar la clase derivada y
proporcionar instrucciones sobre cómo inicializar el objeto de la clase base incluido en
la clase derivada. Normalmente, se produce una inicialización correcta sin ningún
código adicional. La clase BankAccount declara un constructor público con la siguiente
firma:

C#

public BankAccount(string name, decimal initialBalance)

El compilador no genera un constructor predeterminado al definir un constructor. Esto

significa que cada clase derivada debe llamar explícitamente a este constructor. Se
declara un constructor que puede pasar argumentos al constructor de la clase base. En
el código siguiente se muestra el constructor de InterestEarningAccount :

C#

public InterestEarningAccount(string name, decimal initialBalance) :

base(name, initialBalance)

Los parámetros de este nuevo constructor coinciden con el tipo de parámetro y los
nombres del constructor de clase base. Utilice la sintaxis de : base() para indicar una
llamada a un constructor de clase base. Algunas clases definen varios constructores, y
esta sintaxis le permite elegir el constructor de clase base al que llama. Una vez que
haya actualizado los constructores, puede desarrollar el código para cada una de las
clases derivadas. Los requisitos para las clases nuevas se pueden indicar de la siguiente
manera:

Una cuenta que devenga intereses:

obtendrá un crédito del 2 % del saldo a final de mes.
Una línea de crédito:
puede tener un saldo negativo, pero no mayor en valor absoluto que el límite
de crédito.
Generará un cargo por intereses cada mes en el que el saldo final del mes no
sea 0.
Generará un cargo por cada retirada que supere el límite de crédito.
Una cuenta de tarjeta regalo:
Se puede recargar con una cantidad especificada una vez al mes, el último día
del mes.

Puede ver que los tres tipos de cuenta tienen una acción que tiene lugar al final de cada
mes. Sin embargo, cada tipo de cuenta realiza diferentes tareas. Utiliza el polimorfismo
para implementar este código. Cree un método virtual único en la clase BankAccount :

C#

public virtual void PerformMonthEndTransactions() { }

El código anterior muestra cómo se usa la palabra clave virtual para declarar un
método en la clase base para el que una clase derivada puede proporcionar una
implementación diferente. Un método virtual es un método en el que cualquier clase
derivada puede optar por volver a implementar. Las clases derivadas usan la palabra
clave override para definir la nueva implementación. Normalmente, se hace referencia a
este proceso como "reemplazar la implementación de la clase base". La palabra clave
virtual especifica que las clases derivadas pueden invalidar el comportamiento.

También puede declarar métodos abstract en los que las clases derivadas deben
reemplazar el comportamiento. La clase base no proporciona una implementación para
un método abstract . A continuación, debe definir la implementación de dos de las
nuevas clases que ha creado. Empiece por InterestEarningAccount :

C#

public override void PerformMonthEndTransactions()

if (Balance > 500m)

{

decimal interest = Balance * 0.05m;

MakeDeposit(interest, DateTime.Now, "apply monthly interest");

Agregue el código siguiente a LineOfCreditAccount . El código niega el saldo para

calcular un cargo de interés positivo que se retira de la cuenta:

C#

public override void PerformMonthEndTransactions()

if (Balance < 0)

// Negate the balance to get a positive interest charge:

decimal interest = -Balance * 0.07m;

MakeWithdrawal(interest, DateTime.Now, "Charge monthly interest");

La clase GiftCardAccount necesita dos cambios para implementar su funcionalidad de

fin de mes. En primer lugar, modifique el constructor para incluir una cantidad opcional
para agregar cada mes:

C#

private readonly decimal _monthlyDeposit = 0m;

public GiftCardAccount(string name, decimal initialBalance, decimal

 monthlyDeposit = 0) : base(name, initialBalance)

=> _monthlyDeposit = monthlyDeposit;

El constructor proporciona un valor predeterminado para el valor monthlyDeposit , por lo

que los llamadores pueden omitir 0 para ningún ingreso mensual. A continuación,
invalide el método PerformMonthEndTransactions para agregar el depósito mensual, si se
estableció en un valor distinto de cero en el constructor:

C#

public override void PerformMonthEndTransactions()

if (_monthlyDeposit != 0)

MakeDeposit(_monthlyDeposit, DateTime.Now, "Add monthly deposit");

La invalidación aplica el conjunto de depósitos mensual en el constructor. Agregue el

código siguiente al método Main para probar estos cambios en GiftCardAccount y en
InterestEarningAccount :

C#

var giftCard = new GiftCardAccount("gift card", 100, 50);

giftCard.MakeWithdrawal(20, DateTime.Now, "get expensive coffee");

giftCard.MakeWithdrawal(50, DateTime.Now, "buy groceries");

giftCard.PerformMonthEndTransactions();

// can make additional deposits:

giftCard.MakeDeposit(27.50m, DateTime.Now, "add some additional spending

money");

Console.WriteLine(giftCard.GetAccountHistory());

var savings = new InterestEarningAccount("savings account", 10000);

savings.MakeDeposit(750, DateTime.Now, "save some money");

savings.MakeDeposit(1250, DateTime.Now, "Add more savings");

savings.MakeWithdrawal(250, DateTime.Now, "Needed to pay monthly bills");

savings.PerformMonthEndTransactions();

Console.WriteLine(savings.GetAccountHistory());

Verifique los resultados. Ahora, agregue un conjunto similar de código de prueba para
LineOfCreditAccount :

var lineOfCredit = new LineOfCreditAccount("line of credit", 0);

// How much is too much to borrow?

lineOfCredit.MakeWithdrawal(1000m, DateTime.Now, "Take out monthly

 advance");

lineOfCredit.MakeDeposit(50m, DateTime.Now, "Pay back small amount");

lineOfCredit.MakeWithdrawal(5000m, DateTime.Now, "Emergency funds for

repairs");

lineOfCredit.MakeDeposit(150m, DateTime.Now, "Partial restoration on

repairs");

lineOfCredit.PerformMonthEndTransactions();

Console.WriteLine(lineOfCredit.GetAccountHistory());

Al agregar el código anterior y ejecutar el programa, verá algo parecido al siguiente

error:

Consola

Unhandled exception. System.ArgumentOutOfRangeException: Amount of deposit

must be positive (Parameter 'amount')

at OOProgramming.BankAccount.MakeDeposit(Decimal amount, DateTime date,

String note) in BankAccount.cs:line 42

at OOProgramming.BankAccount..ctor(String name, Decimal initialBalance)

in BankAccount.cs:line 31

at OOProgramming.LineOfCreditAccount..ctor(String name, Decimal

initialBalance) in LineOfCreditAccount.cs:line 9

at OOProgramming.Program.Main(String[] args) in Program.cs:line 29

７ Nota

La salida real incluye la ruta de acceso completa a la carpeta con el proyecto. Los
nombres de carpeta se omitieron para ser más breves. Además, dependiendo del
formato del código, los números de línea pueden ser ligeramente diferentes.

Este código produce un error porque BankAccount supone que el saldo inicial debe ser
mayor que 0. Otra suposición incorporada en la clase BankAccount es que el saldo no
puede entrar en cifras negativas. Lo que sucede que es se rechazan las retiradas que
provocan un descubierto en la cuenta. Ambas suposiciones deben cambiar. La línea de
la cuenta de crédito comienza en 0, y generalmente tendrá un saldo negativo. Además,
si un cliente retira demasiado dinero, generará un cargo. La transacción se acepta, solo
que cuesta más. La primera regla se puede implementar agregando un argumento
opcional al constructor BankAccount que especifica el saldo mínimo. El valor
predeterminado es 0 . La segunda regla requiere un mecanismo que permita que las
clases derivadas modifiquen el algoritmo predeterminado. En cierto sentido, la clase
base "pregunta" al tipo derivado qué debe ocurrir cuando hay un descubierto. El
comportamiento predeterminado es rechazar la transacción generando una excepción.
Comencemos agregando un segundo constructor que incluya un parámetro
minimumBalance opcional. Este nuevo constructor se ocupa de todas las acciones que
realiza el constructor existente. Además, establece la propiedad del saldo mínimo.
Puede copiar el cuerpo del constructor existente, pero eso significa que dos ubicaciones
cambiarán en el futuro. Lo que puede hacer es usar un encadenamiento de constructores
para que un constructor llame a otro. En el código siguiente se muestran los dos
constructores y el nuevo campo adicional:

C#

private readonly decimal _minimumBalance;

public BankAccount(string name, decimal initialBalance) : this(name,

initialBalance, 0) { }

public BankAccount(string name, decimal initialBalance, decimal

minimumBalance)

Number = s_accountNumberSeed.ToString();

s_accountNumberSeed++;

Owner = name;

_minimumBalance = minimumBalance;

if (initialBalance > 0)

MakeDeposit(initialBalance, DateTime.Now, "Initial balance");

En el código anterior se muestran dos técnicas nuevas. En primer lugar, el campo

minimumBalance está marcado como readonly . Esto significa que el valor no se puede
cambiar después de que se construya el objeto. Una vez que se crea BankAccount ,
minimumBalance no puede cambiar. En segundo lugar, el constructor que toma dos
parámetros utiliza : this(name, initialBalance, 0) { } como su implementación. La
expresión : this() llama al otro constructor, el que tiene tres parámetros. Esta técnica
permite tener una única implementación para inicializar un objeto, aunque el código de
cliente puede elegir uno de muchos constructores.

Esta implementación solo llama a MakeDeposit si el saldo inicial es mayor que 0 . Esto
conserva la regla de que los depósitos deben ser positivos, pero permite que la cuenta
de crédito se abra con un saldo de 0 .

Ahora que la clase BankAccount tiene un campo de solo lectura para el saldo mínimo, el
último cambio es modificar la codificación rígida 0 a minimumBalance en el método
MakeWithdrawal :

C#
 if (Balance - amount < minimumBalance)

Después de extender la clase BankAccount , puede modificar el constructor

LineOfCreditAccount para llamar al nuevo constructor base, como se muestra en el
código siguiente:

C#

public LineOfCreditAccount(string name, decimal initialBalance, decimal

creditLimit) : base(name, initialBalance, -creditLimit)

Observe que el constructor LineOfCreditAccount cambia el signo del parámetro

creditLimit para que coincida con el significado del parámetro minimumBalance .

Diferentes reglas de descubierto

La última característica que se va a agregar permite a LineOfCreditAccount cobrar una
cuota por sobrepasar el límite de crédito en lugar de rechazar la transacción.

Una técnica consiste en definir una función virtual en la que se implemente el

comportamiento requerido. La clase BankAccount refactoriza el método MakeWithdrawal
en dos métodos. El nuevo método realiza la acción especificada cuando la retirada toma
el saldo por debajo del mínimo. El método MakeWithdrawal existente tiene el siguiente
código:

C#

public void MakeWithdrawal(decimal amount, DateTime date, string note)

if (amount <= 0)

throw new ArgumentOutOfRangeException(nameof(amount), "Amount of

withdrawal must be positive");

if (Balance - amount < _minimumBalance)

throw new InvalidOperationException("Not sufficient funds for this

withdrawal");

var withdrawal = new Transaction(-amount, date, note);

allTransactions.Add(withdrawal);

Reemplácelo por el código siguiente:

C#

public void MakeWithdrawal(decimal amount, DateTime date, string note)

if (amount <= 0)

throw new ArgumentOutOfRangeException(nameof(amount), "Amount of

withdrawal must be positive");

Transaction? overdraftTransaction = CheckWithdrawalLimit(Balance -

amount < _minimumBalance);

Transaction? withdrawal = new(-amount, date, note);

_allTransactions.Add(withdrawal);

if (overdraftTransaction != null)

_allTransactions.Add(overdraftTransaction);

protected virtual Transaction? CheckWithdrawalLimit(bool isOverdrawn)

if (isOverdrawn)

throw new InvalidOperationException("Not sufficient funds for this

withdrawal");

else

return default;
}

El método agregado es protected , lo que significa que solo se puede llamar desde
clases derivadas. Esa declaración impide que otros clientes llamen al método. También
es virtual para que las clases derivadas puedan cambiar el comportamiento. El tipo de
valor devuelto es Transaction? . La anotación ? indica que el método puede devolver
null . Agregue la siguiente implementación en LineOfCreditAccount para cobrar una
cuota cuando se supere el límite de retirada:

C#

protected override Transaction? CheckWithdrawalLimit(bool isOverdrawn) =>

isOverdrawn

? new Transaction(-20, DateTime.Now, "Apply overdraft fee")

: default;

El reemplazo devuelve una transacción de cuota cuando en la cuenta se produce un

descubierto. Si la retirada no supera el límite, el método devuelve una transacción null .
Esto indica que no hay ninguna cuota. Pruebe estos cambios agregando el código
siguiente al método Main en la clase Program :

C#

var lineOfCredit = new LineOfCreditAccount("line of credit", 0, 2000);

// How much is too much to borrow?

lineOfCredit.MakeWithdrawal(1000m, DateTime.Now, "Take out monthly

advance");

lineOfCredit.MakeDeposit(50m, DateTime.Now, "Pay back small amount");

lineOfCredit.MakeWithdrawal(5000m, DateTime.Now, "Emergency funds for

repairs");

lineOfCredit.MakeDeposit(150m, DateTime.Now, "Partial restoration on

repairs");

lineOfCredit.PerformMonthEndTransactions();

Console.WriteLine(lineOfCredit.GetAccountHistory());

Ejecute el programa y compruebe los resultados.

Resumen
Si se ha quedado bloqueado, puede consultar el origen de este tutorial en el repositorio
de GitHub .

En este tutorial se han mostrado muchas de las técnicas que se usan en la programación
orientada a objetos:

Usó la abstracción cuando definió clases para cada uno de los distintos tipos de
cuenta. Esas clases describían el comportamiento de ese tipo de cuenta.
Usó la encapsulación cuando mantuvo muchos detalles private en cada clase.
Usó la herencia cuando aprovechó la implementación ya creada en la clase
BankAccount para guardar el código.
Usó el polimorfismo cuando creó métodos virtual que las clases derivadas
podrían reemplazar para crear un comportamiento específico para ese tipo de
cuenta.
Herencia en C# y .NET
Artículo • 04/02/2023 • Tiempo de lectura: 27 minutos

Este tutorial es una introducción a la herencia en C#. La herencia es una característica de

los lenguajes de programación orientados a objetos que permite definir una clase base,
que proporciona funcionalidad específica (datos y comportamiento), así como clases
derivadas, que heredan o invalidan esa funcionalidad.

Requisitos previos
Se recomienda tener Visual Studio para Windows o Mac. Puede descargar una
versión gratuita desde la página de descargas de Visual Studio . Visual Studio
incluye el SDK de .NET.
También se puede usar el editor de Visual Studio Code . Deberá instalar el SDK
de .NET más reciente por separado.
Si prefiere usar otro editor, deberá instalar el SDK de .NET más reciente.

Ejecución de los ejemplos

Para crear y ejecutar los ejemplos de este tutorial, use la utilidad dotnet desde la línea
de comandos. Siga estos pasos para cada ejemplo:

1. Cree un directorio para almacenar el ejemplo.

2. Escriba el comando dotnet new console en el símbolo del sistema para crear un
nuevo proyecto de .NET Core.

3. Copie y pegue el código del ejemplo en el editor de código.

4. Escriba el comando dotnet restore desde la línea de comandos para cargar o

restaurar las dependencias del proyecto.

No es necesario ejecutar dotnet restore porque lo ejecutan implícitamente todos

los comandos que necesitan que se produzca una restauración, como dotnet new ,
dotnet build , dotnet run , dotnet test , dotnet publish y dotnet pack . Para
deshabilitar la restauración implícita, use la opción --no-restore .

El comando dotnet restore sigue siendo válido en algunos escenarios donde

tiene sentido realizar una restauración explícita, como las compilaciones de
integración continua en Azure DevOps Services o en los sistemas de compilación
que necesitan controlar explícitamente cuándo se produce la restauración.
 Para obtener información sobre cómo administrar fuentes de NuGet, vea la
documentación de dotnet restore.

5. Escriba el comando dotnet run para compilar y ejecutar el ejemplo.

Información previa: ¿Qué es la herencia?

La herencia es uno de los atributos fundamentales de la programación orientada a
objetos. Permite definir una clase secundaria que reutiliza (hereda), amplía o modifica el
comportamiento de una clase primaria. La clase cuyos miembros son heredados se
conoce como clase base. La clase que hereda los miembros de la clase base se conoce
como clase derivada.

C# y .NET solo admiten herencia única. Es decir, una clase solo puede heredar de una
clase única. Sin embargo, la herencia es transitiva, lo que le permite definir una jerarquía
de herencia para un conjunto de tipos. En otras palabras, el tipo D puede heredar del
tipo C , que hereda del tipo B , que hereda del tipo de clase base A . Dado que la
herencia es transitiva, los miembros de tipo A están disponibles para el tipo D .

No todos los miembros de una clase base los heredan las clases derivadas. Los
siguientes miembros no se heredan:

Constructores estáticos, que inicializan los datos estáticos de una clase.

Constructores de instancias, a los que se llama para crear una nueva instancia de la
clase. Cada clase debe definir sus propios constructores.

Finalizadores, llamados por el recolector de elementos no utilizados en tiempo de

ejecución para destruir instancias de una clase.

Si bien las clases derivadas heredan todos los demás miembros de una clase base, que
dichos miembros estén o no visibles depende de su accesibilidad. La accesibilidad del
miembro afecta a su visibilidad en las clases derivadas del modo siguiente:

Los miembros privados solo son visible en las clases derivadas que están anidadas
en su clase base. De lo contrario, no son visibles en las clases derivadas. En el
ejemplo siguiente, A.B es una clase anidada que se deriva de A , y C se deriva de
A . El campo privado A._value es visible en A.B. Pero si quita los comentarios del

método C.GetValue e intenta compilar el ejemplo, se produce el error del

compilador CS0122: "'A._value' no es accesible debido a su nivel de protección".

C#
 public class A

private int _value = 10;

public class B : A

public int GetValue()

return _value;

public class C : A

// public int GetValue()

// {

// return _value;

// }

public class AccessExample

public static void Main(string[] args)

var b = new A.B();

Console.WriteLine(b.GetValue());

// The example displays the following output:

// 10

Los miembros protegidos solo son visibles en las clases derivadas.

Los miembros internos solo son visibles en las clases derivadas que se encuentran
en el mismo ensamblado que la clase base. No son visibles en las clases derivadas
ubicadas en un ensamblado diferente al de la clase base.

Los miembros públicos son visibles en las clases derivadas y forman parte de la
interfaz pública de dichas clases. Los miembros públicos heredados se pueden
llamar como si se definieran en la clase derivada. En el ejemplo siguiente, la clase
A define un método denominado Method1 y la clase B hereda de la clase A . El
ejemplo llama a Method1 como si fuera un método de instancia en B .

C#

public class A

public void Method1()

 // Method implementation.
}

public class B : A

{ }

public class Example

public static void Main()

B b = new ();

b.Method1();

Las clases derivadas pueden también invalidar los miembros heredados al proporcionar
una implementación alternativa. Para poder invalidar un miembro, el miembro de la
clase base debe marcarse con la palabra clave virtual. De forma predeterminada, los
miembros de clase base no están marcados con virtual y no se pueden invalidar. Al
intentar invalidar un miembro no virtual, como se muestra en el ejemplo siguiente, se
genera el error del compilador CS0506: "<el miembro> no puede invalidar el miembro
<> heredado porque no está marcado como virtual, abstracto o invalidado".

C#

public class A

public void Method1()

// Do something.

public class B : A

public override void Method1() // Generates CS0506.

// Do something else.

En algunos casos, una clase derivada debe invalidar la implementación de la clase base.
Los miembros de clase base marcados con la palabra clave abstract requieren que las
clases derivadas los invaliden. Al intentar compilar el ejemplo siguiente, se genera el
error de compilador CS0534, "<class> no implementa el miembro abstracto heredado
<member>", porque la clase B no proporciona ninguna implementación para
A.Method1 .
 C#

public abstract class A

public abstract void Method1();

public class B : A // Generates CS0534.

public void Method3()

// Do something.

La herencia solo se aplica a clases e interfaces. Other type categories (structs, delegates,
and enums) do not support inheritance. Debido a estas reglas, al intentar compilar
código como en el ejemplo siguiente se produce el error del compilador CS0527: "El
tipo 'ValueType' en la lista de interfaz no es una interfaz". El mensaje de error indica que,
aunque se pueden definir las interfaces que implementa una estructura, no se admite la
herencia.

C#

public struct ValueStructure : ValueType // Generates CS0527.

Herencia implícita
Aparte de los tipos de los que puedan heredar mediante herencia única, todos los tipos
del sistema de tipos .NET heredan implícitamente de Object o de un tipo derivado de
este. La funcionalidad común de Object está disponible para cualquier tipo.

Para ver lo que significa la herencia implícita, vamos a definir una nueva clase,
SimpleClass , que es simplemente una definición de clase vacía:

C#

public class SimpleClass

{ }

Después, se puede usar la reflexión (que permite inspeccionar los metadatos de un tipo
para obtener información sobre ese tipo) con el fin de obtener una lista de los
miembros que pertenecen al tipo SimpleClass . Aunque no se ha definido ningún
miembro en la clase SimpleClass , la salida del ejemplo indica que en realidad tiene
nueve miembros. Uno de ellos es un constructor sin parámetros (o predeterminado) que
el compilador de C# proporciona de manera automática para el tipo SimpleClass . Los
ocho restantes son miembros de Object, el tipo del que heredan implícitamente a la
larga todas las clases e interfaces del sistema de tipo .NET.

C#

using System.Reflection;

public class SimpleClassExample

public static void Main()

Type t = typeof(SimpleClass);

BindingFlags flags = BindingFlags.Instance | BindingFlags.Static |

BindingFlags.Public |

BindingFlags.NonPublic |
BindingFlags.FlattenHierarchy;

MemberInfo[] members = t.GetMembers(flags);

Console.WriteLine($"Type {t.Name} has {members.Length} members: ");

foreach (MemberInfo member in members)

string access = "";

string stat = "";

var method = member as MethodBase;

if (method != null)

if (method.IsPublic)

access = " Public";

else if (method.IsPrivate)

access = " Private";

else if (method.IsFamily)

access = " Protected";

else if (method.IsAssembly)

access = " Internal";

else if (method.IsFamilyOrAssembly)

access = " Protected Internal ";

if (method.IsStatic)

stat = " Static";

string output = $"{member.Name} ({member.MemberType}): {access}

{stat}, Declared by {member.DeclaringType}";

Console.WriteLine(output);

// The example displays the following output:

// Type SimpleClass has 9 members:

// ToString (Method): Public, Declared by System.Object

// Equals (Method): Public, Declared by System.Object

// Equals (Method): Public Static, Declared by System.Object

 // ReferenceEquals (Method): Public Static, Declared by System.Object

// GetHashCode (Method): Public, Declared by System.Object

// GetType (Method): Public, Declared by System.Object

// Finalize (Method): Internal, Declared by System.Object

// MemberwiseClone (Method): Internal, Declared by System.Object

// .ctor (Constructor): Public, Declared by SimpleClass

La herencia implícita desde la clase Object permite que estos métodos estén disponibles
para la clase SimpleClass :

El método público ToString , que convierte un objeto SimpleClass en su

representación de cadena, devuelve el nombre de tipo completo. En este caso, el
método ToString devuelve la cadena "SimpleClass".

Tres métodos de prueba de igualdad de dos objetos: el método de instancia

pública Equals(Object) , el método público estático Equals(Object, Object) y el
método público estático ReferenceEquals(Object, Object) . De forma
predeterminada, estos métodos prueban la igualdad de referencia; es decir, para
que sean iguales, dos variables de objeto deben hacer referencia al mismo objeto.

El método público GetHashCode , que calcula un valor que permite que una
instancia del tipo se use en colecciones con hash.

El método público GetType , que devuelve un objeto Type que representa el tipo
SimpleClass .

El método protegido Finalize, que está diseñado para liberar recursos no

administrados antes de que el recolector de elementos no utilizados reclame la
memoria de un objeto.

El método protegido MemberwiseClone, que crea un clon superficial del objeto

actual.

Debido a la herencia implícita, se puede llamar a cualquier miembro heredado de un

objeto SimpleClass como si realmente fuera un miembro definido en la clase
SimpleClass . Así, en el ejemplo siguiente se llama al método SimpleClass.ToString , que

SimpleClass hereda de Object.

C#

public class EmptyClass

{ }

public class ClassNameExample

public static void Main()

EmptyClass sc = new();

Console.WriteLine(sc.ToString());

// The example displays the following output:

// EmptyClass

En la tabla siguiente se enumeran las categorías de tipos que se pueden crear en C# y

los tipos de los que heredan implícitamente. Cada tipo base constituye un conjunto
diferente de miembros disponible mediante herencia para los tipos derivados de forma
implícita.

Categoría de tipo Hereda implícitamente de

clase Object

struct ValueType, Object

enum Enum, ValueType, Object

delegado MulticastDelegate, Delegate, Object

Herencia y una relación "is a"

Normalmente, la herencia se usa para expresar una relación "is a" entre una clase base y
una o varias clases derivadas, donde las clases derivadas son versiones especializadas de
la clase base; la clase derivada es un tipo de la clase base. Por ejemplo, la clase
Publication representa una publicación de cualquier tipo y las clases Book y Magazine
representan tipos específicos de publicaciones.

７ Nota

Una clase o struct puede implementar una o varias interfaces. Aunque a menudo la
implementación se presenta como una solución alternativa para la herencia única o
como una forma de usar la herencia con structs, su finalidad es expresar una
relación diferente (una relación "can do") entre una interfaz y su tipo de
implementación que la herencia. Una interfaz define un subconjunto de
funcionalidad (por ejemplo, la posibilidad de probar la igualdad, comparar u
ordenar objetos o de admitir análisis y formato con referencia cultural) que la
interfaz pone a disposición de sus tipos de implementación.
Tenga en cuenta que "is a" también expresa la relación entre un tipo y una instancia
específica de ese tipo. En el ejemplo siguiente, Automobile es una clase que tiene tres
propiedades de solo lectura exclusivas: Make , el fabricante del automóvil; Model , el tipo
de automóvil; y Year , el año de fabricación. La clase Automobile también tiene un
constructor cuyos argumentos se asignan a los valores de propiedad, y reemplaza al
método Object.ToString para crear una cadena que identifica de forma única la instancia
de Automobile en lugar de la clase Automobile .

C#

public class Automobile

{

public Automobile(string make, string model, int year)

if (make == null)

throw new ArgumentNullException(nameof(make), "The make cannot

be null.");

else if (string.IsNullOrWhiteSpace(make))

throw new ArgumentException("make cannot be an empty string or

have space characters only.");

Make = make;

if (model == null)

throw new ArgumentNullException(nameof(model), "The model cannot

be null.");

else if (string.IsNullOrWhiteSpace(model))

throw new ArgumentException("model cannot be an empty string or

have space characters only.");

Model = model;

if (year < 1857 || year > DateTime.Now.Year + 2)

throw new ArgumentException("The year is out of range.");

Year = year;

public string Make { get; }

public string Model { get; }

public int Year { get; }

public override string ToString() => $"{Year} {Make} {Model}";

En este caso, no se debe basar en la herencia para representar marcas y modelos de

coche específicos. Por ejemplo, no es necesario definir un tipo Packard para representar
los automóviles fabricados por la empresa de automóviles Packard Motor. En su lugar,
se pueden representar mediante la creación de un objeto Automobile con los valores
adecuados que se pasan a su constructor de clase, como en el ejemplo siguiente.
 C#

using System;

public class Example

public static void Main()

var packard = new Automobile("Packard", "Custom Eight", 1948);

Console.WriteLine(packard);

// The example displays the following output:

// 1948 Packard Custom Eight

Una relación "is a" basada en la herencia se aplica mejor a una clase base y a clases
derivadas que agregan miembros adicionales a la clase base o que requieren
funcionalidad adicional que no está presente en la clase base.

Diseño de la clase base y las clases derivadas

Veamos el proceso de diseño de una clase base y sus clases derivadas. En esta sección,
se definirá una clase base, Publication , que representa una publicación de cualquier
tipo, como un libro, una revista, un periódico, un diario, un artículo, etc. También se
definirá una clase Book que se deriva de Publication . El ejemplo se podría ampliar
fácilmente para definir otras clases derivadas, como Magazine , Journal , Newspaper y
Article .

Clase base Publication

A la hora de diseñar la clase Publication , se deben tomar varias decisiones de diseño:

Qué miembros se van a incluir en la clase Publication base, y si los miembros de

Publication proporcionan implementaciones de método, o bien si Publication es
una clase base abstracta que funciona como plantilla para sus clases derivadas.

En este caso, la clase Publication proporcionará implementaciones de método. La

sección Diseño de clases base abstractas y sus clases derivadas contiene un
ejemplo en el que se usa una clase base abstracta para definir los métodos que
deben invalidar las clases derivadas. Las clases derivadas pueden proporcionar
cualquier implementación que sea adecuada para el tipo derivado.
La posibilidad de reutilizar el código (es decir, varias clases derivadas comparten la
declaración y la implementación de los métodos de clase base y no tienen que
invalidarlos) es una ventaja de las clases base no abstractas. Por tanto, se deben
agregar miembros a Publication si es probable que algunos o la mayoría de los
tipos Publication especializados compartan su código. Si no puede proporcionar
implementaciones de clase base de forma eficaz, acabará por tener que
proporcionar implementaciones de miembros prácticamente idénticas en las clases
derivadas en lugar de una única implementación en la clase base. La necesidad de
mantener código duplicado en varias ubicaciones es un origen potencial de
errores.

Para maximizar la reutilización del código y crear una jerarquía de herencia lógica e
intuitiva, asegúrese de incluir en la clase Publication solo los datos y la
funcionalidad común a todas o a la mayoría de las publicaciones. Así, las clases
derivadas implementan miembros que son únicos para una clase determinada de
publicación que representan.

Hasta qué punto extender la jerarquía de clases. ¿Quiere desarrollar una jerarquía
de tres o más clases, en lugar de simplemente una clase base y una o más clases
derivadas? Por ejemplo, Publication podría ser una clase base de Periodical ,
que, a su vez, es una clase base de Magazine , Journal y Newspaper .

En el ejemplo, se usará la jerarquía pequeña de una clase Publication y una sola

clase derivada, Book . El ejemplo se podría ampliar fácilmente para crear una serie
de clases adicionales que se derivan de Publication , como Magazine y Article .

Si tiene sentido crear instancias de la clase base. Si no, se debe aplicar la palabra
clave abstract a la clase. De lo contrario, se puede crear una instancia de la clase
Publication mediante una llamada a su constructor de clase. Si se intenta crear

una instancia de una clase marcada con la palabra clave abstract mediante una
llamada directa a su constructor de clase, el compilador de C# genera el
error CS0144, "No se puede crear una instancia de la clase o interfaz abstracta". Si
se intenta crear una instancia de la clase mediante reflexión, el método de
reflexión produce una excepción MemberAccessException.

De forma predeterminada, se puede crear una instancia de una clase base

mediante una llamada a su constructor de clase. No es necesario definir un
constructor de clase de forma explícita. Si uno no está presente en el código
fuente de la clase base, el compilador de C# proporciona automáticamente un
constructor (sin parámetros) de forma predeterminada.
 En el ejemplo, la clase Publication se marcará como abstract para que no se
puedan crear instancias de ella. Una clase abstract sin ningún método abstract
indica que representa un concepto abstracto que se comparte entre varias clases
concretas (como un Book , Journal ).

Si las clases derivadas deben heredar la implementación de la clase base de

determinados miembros, si tienen la opción de invalidar la implementación de la
clase base, o bien si deben proporcionar una implementación. La palabra clave
abstract se usa para forzar que las clases derivadas proporcionen una
implementación. La palabra clave virtual se usa para permitir que las clases
derivadas invaliden un método de clase base. De forma predeterminada, no se
pueden invalidar los métodos definidos en la clase base.

La clase Publication no tiene ningún método abstract , pero la propia clase es

abstract .

Si una clase derivada representa la clase final en la jerarquía de herencia y no se

puede usar ella misma como clase base para clases derivadas adicionales. De
forma predeterminada, cualquier clase puede servir como clase base. Se puede
aplicar la palabra clave sealed para indicar que una clase no puede servir como
clase base para las clases adicionales. Al intentar derivar de un error del
compilador generado por una clase sellada CS0509, "no se puede derivar de
typeName <>sellado".

Para el ejemplo, la clase derivada se marcará como sealed .

En el ejemplo siguiente se muestra el código fuente para la clase Publication , así como
una enumeración PublicationType que devuelve la propiedad
Publication.PublicationType . Además de los miembros que hereda de Object, la clase
Publication define los siguientes miembros únicos e invalidaciones de miembros:

C#

public enum PublicationType { Misc, Book, Magazine, Article };

public abstract class Publication

private bool _published = false;

private DateTime _datePublished;

private int _totalPages;

public Publication(string title, string publisher, PublicationType type)

if (string.IsNullOrWhiteSpace(publisher))

 throw new ArgumentException("The publisher is required.");

Publisher = publisher;

if (string.IsNullOrWhiteSpace(title))

throw new ArgumentException("The title is required.");

Title = title;

Type = type;

public string Publisher { get; }

public string Title { get; }

public PublicationType Type { get; }

public string? CopyrightName { get; private set; }

public int CopyrightDate { get; private set; }

public int Pages

get { return _totalPages; }

set

if (value <= 0)

throw new ArgumentOutOfRangeException(nameof(value), "The

number of pages cannot be zero or negative.");

_totalPages = value;

public string GetPublicationDate()

if (!_published)

return "NYP";

else

return _datePublished.ToString("d");

public void Publish(DateTime datePublished)

_published = true;

_datePublished = datePublished;

public void Copyright(string copyrightName, int copyrightDate)

if (string.IsNullOrWhiteSpace(copyrightName))

throw new ArgumentException("The name of the copyright holder is

required.");

CopyrightName = copyrightName;

int currentYear = DateTime.Now.Year;

if (copyrightDate < currentYear - 10 || copyrightDate > currentYear

+ 2)

throw new ArgumentOutOfRangeException($"The copyright year must

be between {currentYear - 10} and {currentYear + 1}");

CopyrightDate = copyrightDate;

public override string ToString() => Title;

Un constructor

Dado que la clase Publication es abstract , no se puede crear una instancia de

ella directamente desde código similar al del ejemplo siguiente:

C#

var publication = new Publication("Tiddlywinks for Experts", "Fun and

Games",

PublicationType.Book);

Sin embargo, su constructor de instancia se puede llamar directamente desde los

constructores de clases derivadas, como muestra el código fuente de la clase Book .

Dos propiedades relacionadas con la publicación

Title es una propiedad String de solo lectura cuyo valor se suministra mediante la

llamada al constructor Publication .

Pages es una propiedad Int32 de solo lectura que indica cuántas páginas en total
tiene la publicación. El valor se almacena en un campo privado denominado
totalPages . Debe ser un número positivo o se inicia una excepción
ArgumentOutOfRangeException.

Miembros relacionados con el publicador

Dos propiedades de solo lectura, Publisher y Type . Los valores se proporcionan

originalmente mediante la llamada al constructor de clase Publication .

Miembros relacionados con la publicación

Dos métodos, Publish y GetPublicationDate , establecen y devuelven la fecha de

publicación. El método Publish establece una marca published privada en true
cuando se llama y asigna la fecha pasada a él como argumento al campo
datePublished privado. El método GetPublicationDate devuelve la cadena "NYP" si

la marca published es false , y el valor del campo datePublished si es true .

 Miembros relacionados con copyright

El método Copyright toma como argumentos el nombre del propietario del

copyright y el año del copyright, y los asigna a las propiedades CopyrightName y
CopyrightDate .

Una invalidación del método ToString

Si un tipo no invalida al método Object.ToString, devuelve el nombre completo del

tipo, que es de poca utilidad a la hora de diferenciar una instancia de otra. La clase
Publication invalida Object.ToString para devolver el valor de la propiedad Title .

En la ilustración siguiente se muestra la relación entre la clase base Publication y su

clase Object heredada de forma implícita.

La clase Book .
La clase Book representa un libro como un tipo especializado de publicación. En el
ejemplo siguiente se muestra el código fuente de la clase Book .
C#

using System;

public sealed class Book : Publication

public Book(string title, string author, string publisher) :

this(title, string.Empty, author, publisher)

{ }

public Book(string title, string isbn, string author, string publisher)

: base(title, publisher, PublicationType.Book)

// isbn argument must be a 10- or 13-character numeric string

without "-" characters.

// We could also determine whether the ISBN is valid by comparing

its checksum digit

// with a computed checksum.

//

if (!string.IsNullOrEmpty(isbn))

// Determine if ISBN length is correct.

if (!(isbn.Length == 10 | isbn.Length == 13))

throw new ArgumentException("The ISBN must be a 10- or 13-

character numeric string.");

if (!ulong.TryParse(isbn, out _))

throw new ArgumentException("The ISBN can consist of numeric

characters only.");

ISBN = isbn;

Author = author;

public string ISBN { get; }

public string Author { get; }

public decimal Price { get; private set; }

// A three-digit ISO currency symbol.

public string? Currency { get; private set; }

// Returns the old price, and sets a new price.

public decimal SetPrice(decimal price, string currency)

if (price < 0)

throw new ArgumentOutOfRangeException(nameof(price), "The price

cannot be negative.");

decimal oldValue = Price;

Price = price;

if (currency.Length != 3)

throw new ArgumentException("The ISO currency symbol is a 3-

 character string.");

Currency = currency;

return oldValue;

public override bool Equals(object? obj)

if (obj is not Book book)

return false;

else

return ISBN == book.ISBN;

public override int GetHashCode() => ISBN.GetHashCode();

public override string ToString() => $"{(string.IsNullOrEmpty(Author) ?

"" : Author + ", ")}{Title}";

Además de los miembros que hereda de Publication , la clase Book define los
siguientes miembros únicos e invalidaciones de miembros:

Dos constructores

Los dos constructores Book comparten tres parámetros comunes. Dos, title y
publisher, corresponden a los parámetros del constructor Publication . La tercera
es author, que se almacena para una propiedad Author pública inmutable. Un
constructor incluye un parámetro isbn, que se almacena en la propiedad
automática ISBN .

El primer constructor usa esta palabra clave para llamar al otro constructor. El
encadenamiento de constructores es un patrón común en la definición de
constructores. Los constructores con menos parámetros proporcionan valores
predeterminados al llamar al constructor con el mayor número de parámetros.

El segundo constructor usa la palabra clave base para pasar el título y el nombre
del editor al constructor de clase base. Si no realiza una llamada explícita a un
constructor de clase base en el código fuente, el compilador de C# proporciona
automáticamente una llamada al constructor sin parámetros o predeterminado de
la clase base.

Una propiedad ISBN de solo lectura, que devuelve el ISBN (International Standard
Book Number) del objeto Book , un número exclusivo de 10 y 13 caracteres. El ISBN
se proporciona como argumento para uno de los constructores Book . El ISBN se
 almacena en un campo de respaldo privado, generado automáticamente por el
compilador.

Una propiedad Author de solo lectura. El nombre del autor se proporciona como
argumento para ambos constructores Book y se almacena en la propiedad.

Dos propiedades relacionadas con el precio de solo lectura, Price y Currency . Sus
valores se proporcionan como argumentos en una llamada al método SetPrice . La
propiedad Currency es el símbolo de moneda ISO de tres dígitos (por ejemplo,
USD para el dólar estadounidense). Los símbolos de moneda ISO se pueden
recuperar de la propiedad ISOCurrencySymbol. Ambas propiedades son de solo
lectura desde ubicaciones externas, pero se pueden establecer mediante código en
la clase Book .

Un método SetPrice , que establece los valores de las propiedades Price y

Currency . Esos son los valores devueltos por dichas propiedades.

Invalida el método ToString (heredado de Publication ) y los métodos

Object.Equals(Object) y GetHashCode (heredados de Object).

A menos que se invalide, el método Object.Equals(Object) prueba la igualdad de

referencia. Es decir, dos variables de objeto se consideran iguales si hacen
referencia al mismo objeto. Por otro lado, en la clase Book , dos objetos Book
deben ser iguales si tienen el mismo ISBN.

Cuando invalide el método Object.Equals(Object), también debe invalidar el

método GetHashCode, que devuelve un valor que se usa en el entorno de
ejecución para almacenar elementos en colecciones con hash para una
recuperación eficiente. El código hash debe devolver un valor que sea coherente
con la prueba de igualdad. Puesto que se ha invalidado Object.Equals(Object) para
devolver true , si las propiedades de ISBN de dos objetos Book son iguales, se
devuelve el código hash calculado mediante la llamada al método GetHashCode
de la cadena devuelta por la propiedad ISBN .

En la siguiente ilustración se muestra la relación entre la clase Book y Publication , su

clase base.
Ahora se puede crear una instancia de un objeto Book , invocar sus miembros únicos y
heredados, y pasarla como argumento a un método que espera un parámetro de tipo
Publication o de tipo Book , como se muestra en el ejemplo siguiente.

C#

public class ClassExample

public static void Main()

var book = new Book("The Tempest", "0971655819", "Shakespeare,

William",

 "Public Domain Press");

ShowPublicationInfo(book);

book.Publish(new DateTime(2016, 8, 18));

ShowPublicationInfo(book);

var book2 = new Book("The Tempest", "Classic Works Press",

"Shakespeare, William");

Console.Write($"{book.Title} and {book2.Title} are the same

publication: " +

$"{((Publication)book).Equals(book2)}");

public static void ShowPublicationInfo(Publication pub)

string pubDate = pub.GetPublicationDate();

Console.WriteLine($"{pub.Title}, " +

$"{(pubDate == "NYP" ? "Not Yet Published" : "published on

" + pubDate):d} by {pub.Publisher}");

// The example displays the following output:

// The Tempest, Not Yet Published by Public Domain Press

// The Tempest, published on 8/18/2016 by Public Domain Press

// The Tempest and The Tempest are the same publication: False

Diseño de clases base abstractas y sus clases

derivadas
En el ejemplo anterior, se define una clase base que proporciona una implementación
para una serie de métodos con el fin de permitir que las clases derivadas compartan
código. En muchos casos, sin embargo, no se espera que la clase base proporcione una
implementación. En su lugar, la clase base es una clase abstracta que declara métodos
abstractos; sirve como una plantilla que define los miembros que debe implementar
cada clase derivada. Normalmente, en una clase base abstracta, la implementación de
cada tipo derivado es exclusiva de ese tipo. La clase se ha marcado con la palabra clave
abstract porque no tenía mucho sentido crear instancias de un objeto Publication ,
aunque la clase proporcionara las implementaciones de funcionalidad común a las
publicaciones.

Por ejemplo, cada forma geométrica bidimensional cerrada incluye dos propiedades:
área, la extensión interna de la forma; y perímetro, o la distancia a lo largo de los bordes
de la forma. La manera en que se calculan estas propiedades, sin embargo, depende
completamente de la forma específica. La fórmula para calcular el perímetro (o la
circunferencia) de un círculo, por ejemplo, es diferente a la de un cuadrado. La clase
Shape es una clase abstract con métodos abstract . Eso indica que las clases derivadas

comparten la misma funcionalidad, pero que la implementan de otra manera.

En el ejemplo siguiente se define una clase base abstracta denominada Shape que
define dos propiedades: Area y Perimeter . Además de marcar la clase con la palabra
clave abstract, cada miembro de instancia también se marca con la palabra clave
abstract. En este caso, Shape también invalida el método Object.ToString para devolver
el nombre del tipo, en lugar de su nombre completo. Y define dos miembros estáticos,
GetArea y GetPerimeter , que permiten que los llamadores recuperen fácilmente el área

y el perímetro de una instancia de cualquier clase derivada. Cuando se pasa una

instancia de una clase derivada a cualquiera de estos métodos, el runtime llama a la
invalidación del método de la clase derivada.

C#

public abstract class Shape

public abstract double Area { get; }

public abstract double Perimeter { get; }

public override string ToString() => GetType().Name;

public static double GetArea(Shape shape) => shape.Area;

public static double GetPerimeter(Shape shape) => shape.Perimeter;

Después, se pueden derivar algunas clases de Shape que representan formas concretas.
El ejemplo siguiente define tres clases Square , Rectangle y Circle . Cada una usa una
fórmula única para esa forma en particular para calcular el área y el perímetro. Algunas
de las clases derivadas también definen propiedades, como Rectangle.Diagonal y
Circle.Diameter , que son únicas para la forma que representan.

C#

using System;

public class Square : Shape

public Square(double length)

Side = length;

public double Side { get; }

 public override double Area => Math.Pow(Side, 2);

public override double Perimeter => Side * 4;

public double Diagonal => Math.Round(Math.Sqrt(2) * Side, 2);

public class Rectangle : Shape

public Rectangle(double length, double width)

Length = length;

Width = width;

public double Length { get; }

public double Width { get; }

public override double Area => Length * Width;

public override double Perimeter => 2 * Length + 2 * Width;

public bool IsSquare() => Length == Width;

public double Diagonal => Math.Round(Math.Sqrt(Math.Pow(Length, 2) +

Math.Pow(Width, 2)), 2);

public class Circle : Shape

public Circle(double radius)

Radius = radius;

public override double Area => Math.Round(Math.PI * Math.Pow(Radius, 2),

2);

public override double Perimeter => Math.Round(Math.PI * 2 * Radius, 2);

// Define a circumference, since it's the more familiar term.

public double Circumference => Perimeter;

public double Radius { get; }

public double Diameter => Radius * 2;

En el ejemplo siguiente se usan objetos derivados de Shape . Se crea una instancia de

una matriz de objetos derivados de Shape y se llama a los métodos estáticos de la clase
Shape , que ajusta los valores de propiedad Shape devueltos. El runtime recupera los
valores de las propiedades invalidadas de los tipos derivados. En el ejemplo también se
convierte cada objeto Shape de la matriz a su tipo derivado y, si la conversión se realiza
correctamente, recupera las propiedades de esa subclase específica de Shape .

C#

using System;

public class Example

public static void Main()

Shape[] shapes = { new Rectangle(10, 12), new Square(5),

new Circle(3) };

foreach (Shape shape in shapes)

Console.WriteLine($"{shape}: area, {Shape.GetArea(shape)}; " +

$"perimeter, {Shape.GetPerimeter(shape)}");

if (shape is Rectangle rect)

Console.WriteLine($" Is Square: {rect.IsSquare()},

Diagonal: {rect.Diagonal}");

continue;

if (shape is Square sq)

Console.WriteLine($" Diagonal: {sq.Diagonal}");

continue;

// The example displays the following output:

// Rectangle: area, 120; perimeter, 44

// Is Square: False, Diagonal: 15.62

// Square: area, 25; perimeter, 20

// Diagonal: 7.07

// Circle: area, 28.27; perimeter, 18.85

Procedimiento para convertir de forma

segura mediante la coincidencia de
patrones y los operadores is y as
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Dado que los objetos son polimórficos, es posible que una variable de un tipo de clase
base contenga un tipo derivado. Para acceder a los miembros de instancia del tipo
derivado, es necesario volver a convertir el valor en el tipo derivado. Pero una
conversión conlleva el riesgo de producir una InvalidCastException. C# proporciona
instrucciones de coincidencia de patrones que realizan una conversión
condicionalmente, solo si se va a realizar correctamente. C# además proporciona los
operadores is y as para probar si un valor es de un tipo determinado.

En el ejemplo siguiente se muestra cómo usar la instrucción is de coincidencia de

patrones.

C#

var g = new Giraffe();

var a = new Animal();

FeedMammals(g);

FeedMammals(a);

// Output:

// Eating.

// Animal is not a Mammal

SuperNova sn = new SuperNova();

TestForMammals(g);

TestForMammals(sn);

static void FeedMammals(Animal a)

if (a is Mammal m)

m.Eat();

else

// variable 'm' is not in scope here, and can't be used.

Console.WriteLine($"{a.GetType().Name} is not a Mammal");

static void TestForMammals(object o)

// You also can use the as operator and test for null

 // before referencing the variable.

var m = o as Mammal;

if (m != null)

Console.WriteLine(m.ToString());

else

Console.WriteLine($"{o.GetType().Name} is not a Mammal");

// Output:

// I am an animal.

// SuperNova is not a Mammal

class Animal

public void Eat() { Console.WriteLine("Eating."); }

public override string ToString()

return "I am an animal.";

class Mammal : Animal { }

class Giraffe : Mammal { }

class SuperNova { }

El ejemplo anterior muestra una serie de características de sintaxis de coincidencia de

patrones. La instrucción if (a is Mammal m) combina la prueba con una asignación de
inicialización. La asignación solo se produce cuando la prueba se realiza correctamente.
La variable m solo está en ámbito en la instrucción if insertada donde se ha asignado.
No se puede acceder a m más adelante en el mismo método. En el ejemplo anterior
también se muestra cómo usar el operador as para convertir un objeto en un tipo
especificado.

También puede usar la misma sintaxis para probar si un tipo de valor que admite valores
NULL tiene un valor, como se muestra en el ejemplo siguiente:

C#

int i = 5;

PatternMatchingNullable(i);

int? j = null;

PatternMatchingNullable(j);

double d = 9.78654;

PatternMatchingNullable(d);

 PatternMatchingSwitch(i);

PatternMatchingSwitch(j);

PatternMatchingSwitch(d);

static void PatternMatchingNullable(ValueType? val)

if (val is int j) // Nullable types are not allowed in patterns

Console.WriteLine(j);

else if (val is null) // If val is a nullable type with no value, this

expression is true

Console.WriteLine("val is a nullable type with the null value");

else

Console.WriteLine("Could not convert " + val.ToString());

static void PatternMatchingSwitch(ValueType? val)

switch (val)

case int number:

Console.WriteLine(number);

break;

case long number:

Console.WriteLine(number);

break;

case decimal number:

Console.WriteLine(number);

break;

case float number:

Console.WriteLine(number);

break;

case double number:

Console.WriteLine(number);

break;

case null:

Console.WriteLine("val is a nullable type with the null value");

break;

default:

Console.WriteLine("Could not convert " + val.ToString());

break;

El ejemplo anterior muestra otras características de coincidencia de patrones para usar

con conversiones. Puede probar una variable para el patrón null si busca
específicamente el valor null . Cuando el valor de runtime de la variable es null , una
instrucción is que busca un tipo siempre devuelve false . La instrucción is de
coincidencia de patrones no permite un tipo de valor que acepta valores NULL, como
int? o Nullable<int> , pero puede probar con cualquier otro tipo de valor. Los patrones

is del ejemplo anterior no se limitan a los tipos de valor que admiten un valor NULL.
También puede usar esos patrones para probar si una variable de un tipo de referencia
tiene un valor o es null .

En el ejemplo anterior también se muestra cómo usar el patrón de tipo en una

instrucción switch donde la variable puede ser uno de muchos tipos diferentes.

Si quiere probar si una variable es de un tipo determinado, pero no asignarla a una

nueva variable, puede usar los operadores is y as para los tipos de referencia y los
tipos que aceptan valores NULL. El código siguiente muestra cómo usar las instrucciones
is y as que formaban parte del lenguaje C# antes de la incorporación de la
coincidencia de patrones para probar si una variable es de un tipo determinado:

C#

// Use the is operator to verify the type.

// before performing a cast.

Giraffe g = new();

UseIsOperator(g);

// Use the as operator and test for null

// before referencing the variable.

UseAsOperator(g);

// Use pattern matching to test for null

// before referencing the variable

UsePatternMatchingIs(g);

// Use the as operator to test

// an incompatible type.

SuperNova sn = new();

UseAsOperator(sn);

// Use the as operator with a value type.

// Note the implicit conversion to int? in

// the method body.

int i = 5;

UseAsWithNullable(i);

double d = 9.78654;

UseAsWithNullable(d);

static void UseIsOperator(Animal a)

if (a is Mammal)

 Mammal m = (Mammal)a;

m.Eat();

static void UsePatternMatchingIs(Animal a)

if (a is Mammal m)

m.Eat();

static void UseAsOperator(object o)

Mammal? m = o as Mammal;

if (m is not null)

Console.WriteLine(m.ToString());

else

Console.WriteLine($"{o.GetType().Name} is not a Mammal");

static void UseAsWithNullable(System.ValueType val)

int? j = val as int?;

if (j is not null)

Console.WriteLine(j);

else

Console.WriteLine("Could not convert " + val.ToString());

class Animal

public void Eat() => Console.WriteLine("Eating.");

public override string ToString() => "I am an animal.";

class Mammal : Animal { }

class Giraffe : Mammal { }

class SuperNova { }

Como puede ver al comparar este código con el código de coincidencia de patrones, la
sintaxis de coincidencia de patrones proporciona características más sólidas mediante la
combinación de la prueba y la asignación en una sola instrucción. Use la sintaxis de
coincidencia de patrones siempre que sea posible.
Tutorial: Uso de la coincidencia de
patrones para compilar algoritmos
basados en tipos y basados en datos
Artículo • 20/02/2023 • Tiempo de lectura: 17 minutos

Puede escribir una funcionalidad que se comporta como si se hubiesen ampliado tipos
que pueden estar en otras bibliotecas. Los patrones también se usan para crear una
funcionalidad que la aplicación requiere y que no es una característica fundamental del
tipo que se está ampliando.

En este tutorial, aprenderá a:

＂ Reconocer situaciones donde se debe usar la coincidencia de patrones.

＂ Usar las expresiones de coincidencia de patrones para implementar un
comportamiento en función de los tipos y los valores de propiedad.
＂ Combinar la coincidencia de patrones con otras técnicas para crear algoritmos
completos.

Requisitos previos
Se recomienda tener Visual Studio para Windows o Mac. Puede descargar una
versión gratuita desde la página de descargas de Visual Studio . Visual Studio
incluye el SDK de .NET.
También se puede usar el editor de Visual Studio Code . Deberá instalar el SDK
de .NET más reciente por separado.
Si prefiere usar otro editor, deberá instalar el SDK de .NET más reciente.

En este tutorial se da por supuesto que conoce bien C# y. NET, incluidos Visual Studio o
la CLI de .NET.

Escenarios para la coincidencia de patrones

Con frecuencia, el desarrollo moderno incluye integrar datos desde varios orígenes y
presentar información y perspectivas a partir de esos datos en una sola aplicación
cohesiva. Ni usted ni su equipo tendrán control ni acceso para todos los tipos que
representan los datos entrantes.

El diseño clásico orientado a objetos llamaría a la creación de tipos en la aplicación que

representen cada tipo de datos de esos orígenes de datos múltiples. Luego, la aplicación
podría trabajar con esos tipos nuevos, crear jerarquías de herencia, crear métodos
virtuales e implementar abstracciones. Esas técnicas funcionan y son a veces las mejores
herramientas. En otras ocasiones, puede escribir menos código. Puede escribir código
más claro con técnicas que separan los datos de las operaciones que manipulan esos
datos.

En este tutorial, creará y explorará una aplicación que toma datos entrantes de varios
orígenes externos para un solo escenario. Verá cómo la coincidencia de patrones
proporciona una forma eficaz de consumir y procesar esos datos de maneras que no
formaban parte del sistema original.

Considere un área metropolitana importante que usa peajes y precios estipulados para
las horas de mayor actividad con el fin de administrar el tráfico. Puede escribir una
aplicación que calcule los peajes de un vehículo en función de su tipo. Mejoras
posteriores incorporan precios basados en la cantidad de ocupantes del vehículo. Otras
mejoras agregan precios según la hora y el día de la semana.

Desde esa descripción breve, puede haber esbozado rápidamente una jerarquía de
objetos para modelar este sistema. Sin embargo, los datos provienen de varios orígenes,
como otros sistemas de administración de registros de vehículos. Estos sistemas ofrecen
distintas clases para modelar esos datos y no se tiene un modelo de objetos único que
puede usar. En este tutorial, usará estas clases simplificadas para modelar los datos del
vehículo desde dichos sistemas externos, tal como se muestra en el código siguiente:

C#

namespace ConsumerVehicleRegistration

public class Car

public int Passengers { get; set; }

namespace CommercialRegistration

public class DeliveryTruck

public int GrossWeightClass { get; set; }

namespace LiveryRegistration

public class Taxi

public int Fares { get; set; }

 public class Bus

public int Capacity { get; set; }

public int Riders { get; set; }

Puede descargar el código de inicio del repositorio dotnet/samples de GitHub. Puede

ver que las clases de vehículo provienen de distintos sistemas y que están en distintos
espacios de nombres. No se puede usar ninguna clase base común distinta de
System.Object .

Diseños de coincidencia de patrones

En el escenario que se usa en este tutorial se resaltan los tipos de problemas en los que
resulta adecuado usar la coincidencia de patrones para resolver lo siguiente:

Los objetos con los que necesita trabajar no están en una jerarquía de objetos que
coincida con sus objetivos. Es posible que trabaje con clases que forman parte de
sistemas no relacionados.
La funcionalidad que agrega no forma parte de la abstracción central de estas
clases. El peaje que paga un vehículo cambia según los distintos tipos de vehículos,
pero el peaje no es una función central del vehículo.

Cuando la forma de los datos y las operaciones que se realizan en esos datos no se
describen en conjunto, las características de coincidencia de patrones de C# permiten
que sea más fácil trabajar con ellos.

Implementación de cálculos de peajes básicos

El cálculo de peaje más básico solo se basa en el tipo de vehículo:

Un Car es USD 2,00.
Un Taxi es USD 3,50.
Un Bus es USD 5,00.
Un DeliveryTruck es USD 10,00

Cree una clase TollCalculator nueva e implemente la coincidencia de patrones en el

tipo de vehículo para obtener el importe del peaje. En el siguiente código se muestra la
implementación inicial de TollCalculator .
 C#

using System;

using CommercialRegistration;

using ConsumerVehicleRegistration;

using LiveryRegistration;

namespace Calculators;

public class TollCalculator

public decimal CalculateToll(object vehicle) =>

vehicle switch

Car c => 2.00m,

Taxi t => 3.50m,

Bus b => 5.00m,

DeliveryTruck t => 10.00m,

{ } => throw new ArgumentException(message: "Not a known

vehicle type", paramName: nameof(vehicle)),

null => throw new ArgumentNullException(nameof(vehicle))

};

El código anterior usa una expresión switch (que no es lo mismo que una instrucción
switch) que prueba el patrón de declaración. Una expresión switch comienza por la
variable, vehicle en el código anterior, seguida de la palabra clave switch . A
continuación, todos los segmentos modificadores aparecen entre llaves. La expresión
switch lleva a cabo otras mejoras en la sintaxis que rodea la instrucción switch . La
palabra clave case se omite y el resultado de cada segmento es una expresión. Los dos
últimos segmentos muestran una característica de lenguaje nueva. El caso { } coincide
con cualquier objeto no nulo que no coincidía con ningún segmento anterior. Este
segmento detecta todo tipo incorrecto que se pasa a este método. El caso { } debe
seguir los casos de cada tipo de vehículo. Si se invierte el orden, el caso { } tendrá
prioridad. Por último, el null patrón de constante detecta si se pasa null a este
método. El patrón null puede ser el último porque los otros patrones solo coinciden
con un objeto no nulo del tipo correcto.

Puede probar este código con el código siguiente en Program.cs :

C#

using System;

using CommercialRegistration;

using ConsumerVehicleRegistration;

using LiveryRegistration;

 using toll_calculator;

var tollCalc = new TollCalculator();

var car = new Car();

var taxi = new Taxi();

var bus = new Bus();

var truck = new DeliveryTruck();

Console.WriteLine($"The toll for a car is {tollCalc.CalculateToll(car)}");

Console.WriteLine($"The toll for a taxi is {tollCalc.CalculateToll(taxi)}");

Console.WriteLine($"The toll for a bus is {tollCalc.CalculateToll(bus)}");

Console.WriteLine($"The toll for a truck is

{tollCalc.CalculateToll(truck)}");

try

tollCalc.CalculateToll("this will fail");

catch (ArgumentException e)

Console.WriteLine("Caught an argument exception when using the wrong

type");

try

tollCalc.CalculateToll(null!);

catch (ArgumentNullException e)

Console.WriteLine("Caught an argument exception when using null");

Ese código se incluye en el proyecto de inicio, pero se marca como comentario. Quite
los comentarios y podrá probar lo que escribió.

Empezará a ver cómo los patrones pueden ayudarlo a crear algoritmos cuando el
código y los datos están separados. La expresión switch prueba el tipo y genera valores
distintos en función de los resultados. Eso es solo el principio.

Incorporación de precios por ocupación

La autoridad encargada de los peajes quiere incentivar que los vehículos viajen a plena
capacidad. Se decidió cobrar más cuando los vehículos circulan con menos pasajeros y
se incentiva que los vehículos vayan llenos al ofrecer precios más bajos:

Los automóviles y taxis sin pasajeros pagan USD 0,50 adicionales.

Los automóviles y taxis con dos pasajeros tienen un descuento de USD 0,50.
Los automóviles y taxis con tres o más pasajeros tienen un descuento de USD 1.
 Los buses que viajan con menos del 50 % de su capacidad pagan USD 2
adicionales.
Los buses que viajan con más del 90 % de su capacidad tienen un descuento de
USD 1.

Estas reglas se pueden implementar con un patrón de propiedad en la misma expresión

switch. Un patrón de propiedad compara un valor de propiedad con un valor constante.
El patrón de propiedad examina las propiedades del objeto una vez que se determina el
tipo. El caso único de Car se amplía a cuatro casos distintos:

C#

vehicle switch

Car {Passengers: 0} => 2.00m + 0.50m,

Car {Passengers: 1} => 2.0m,

Car {Passengers: 2} => 2.0m - 0.50m,

Car => 2.00m - 1.0m,

// ...

};

Los primeros tres casos prueban el tipo como Car y luego comprueban el valor de la
propiedad Passengers . Si ambos coinciden, esa expresión se evalúa y devuelve.

También podría expandir los casos para los taxis de manera similar:

C#

vehicle switch

// ...

Taxi {Fares: 0} => 3.50m + 1.00m,

Taxi {Fares: 1} => 3.50m,

Taxi {Fares: 2} => 3.50m - 0.50m,

Taxi => 3.50m - 1.00m,

// ...

};

A continuación, implemente las reglas de ocupación mediante la expansión de los casos

para los buses, tal como se muestra en el ejemplo siguiente:

C#
 vehicle switch

// ...

Bus b when ((double)b.Riders / (double)b.Capacity) < 0.50 => 5.00m +

2.00m,

Bus b when ((double)b.Riders / (double)b.Capacity) > 0.90 => 5.00m -

1.00m,

Bus => 5.00m,

// ...

};

A la autoridad encargada de los peajes no le preocupa el número de pasajeros en los

camiones de reparto. Alternativamente, ajustan el importe del peaje en base a la clase
de peso de los camiones, como sigue:

A los camiones de más de 2268 kilos se les cobran USD 5 adicionales.

Los camiones livianos, por debajo de los 1360 kilos, tienen un descuento de 2 USD.

Esta regla se implementa con el código siguiente:

C#

vehicle switch

// ...

DeliveryTruck t when (t.GrossWeightClass > 5000) => 10.00m + 5.00m,

DeliveryTruck t when (t.GrossWeightClass < 3000) => 10.00m - 2.00m,

DeliveryTruck => 10.00m,

};

En el código anterior se muestra la cláusula when de un segmento modificador. Puede

usar la cláusula when para probar condiciones distintas de la igualdad de una propiedad.
Cuando haya terminado, tendrá un método muy similar al código siguiente:

C#

vehicle switch

Car {Passengers: 0} => 2.00m + 0.50m,

Car {Passengers: 1} => 2.0m,

Car {Passengers: 2} => 2.0m - 0.50m,

Car => 2.00m - 1.0m,

Taxi {Fares: 0} => 3.50m + 1.00m,

Taxi {Fares: 1} => 3.50m,

 Taxi {Fares: 2} => 3.50m - 0.50m,

Taxi => 3.50m - 1.00m,

Bus b when ((double)b.Riders / (double)b.Capacity) < 0.50 => 5.00m +

2.00m,

Bus b when ((double)b.Riders / (double)b.Capacity) > 0.90 => 5.00m -

1.00m,

Bus => 5.00m,

DeliveryTruck t when (t.GrossWeightClass > 5000) => 10.00m + 5.00m,

DeliveryTruck t when (t.GrossWeightClass < 3000) => 10.00m - 2.00m,

DeliveryTruck => 10.00m,

{ } => throw new ArgumentException(message: "Not a known vehicle

type", paramName: nameof(vehicle)),

null => throw new ArgumentNullException(nameof(vehicle))

};

Muchos de estos segmentos modificadores son ejemplos de patrones recursivos. Por

ejemplo, Car { Passengers: 1} muestra un patrón constante dentro de un patrón de
propiedad.

Puede usar modificadores anidados para que este código sea menos repetitivo. Tanto
Car como Taxi tienen cuatro segmentos distintos en los ejemplos anteriores. En ambos

casos, se puede crear un patrón de declaración que se alimenta de un patrón de

constante. Esta técnica se muestra en el código siguiente:

C#

public decimal CalculateToll(object vehicle) =>

vehicle switch

Car c => c.Passengers switch

0 => 2.00m + 0.5m,

1 => 2.0m,

2 => 2.0m - 0.5m,

_ => 2.00m - 1.0m

},

Taxi t => t.Fares switch

0 => 3.50m + 1.00m,

1 => 3.50m,
2 => 3.50m - 0.50m,

_ => 3.50m - 1.00m

},

Bus b when ((double)b.Riders / (double)b.Capacity) < 0.50 => 5.00m +

2.00m,

Bus b when ((double)b.Riders / (double)b.Capacity) > 0.90 => 5.00m -

 1.00m,

Bus b => 5.00m,

DeliveryTruck t when (t.GrossWeightClass > 5000) => 10.00m + 5.00m,

DeliveryTruck t when (t.GrossWeightClass < 3000) => 10.00m - 2.00m,

DeliveryTruck t => 10.00m,

{ } => throw new ArgumentException(message: "Not a known vehicle

type", paramName: nameof(vehicle)),

null => throw new ArgumentNullException(nameof(vehicle))

};

En el ejemplo anterior, el uso de una expresión recursiva significa que no repite los
segmentos Car y Taxi que contienen segmentos secundarios que prueban el valor de
propiedad. Esta técnica no se usa para los segmentos Bus y DeliveryTruck , porque esos
segmentos prueban intervalos para la propiedad, no valores discretos.

Incorporación de precio en horas punta

Para la característica final, la autoridad encargada de los peajes quiere agregar precios
en función de las horas punta. En las horas de mayor afluencia durante mañana y tarde,
el valor de los peajes se dobla. Esa regla solo afecta el tráfico en una dirección: hacia la
ciudad en la mañana y desde la ciudad en la tarde. En otros momentos durante la
jornada laboral, los peajes aumentan en un 50 %. Tarde por la noche y temprano en la
mañana, disminuyen en un 25 %. Durante el fin de semana, la tarifa es normal
independientemente de la hora. Puede usar una serie de instrucciones if y else para
expresar esto mediante el código siguiente:

C#

public decimal PeakTimePremiumIfElse(DateTime timeOfToll, bool inbound)

if ((timeOfToll.DayOfWeek == DayOfWeek.Saturday) ||

(timeOfToll.DayOfWeek == DayOfWeek.Sunday))

return 1.0m;

else

int hour = timeOfToll.Hour;

if (hour < 6)

return 0.75m;

else if (hour < 10)

if (inbound)

 return 2.0m;

else

return 1.0m;

else if (hour < 16)

return 1.5m;

else if (hour < 20)

if (inbound)

return 1.0m;

else

return 2.0m;

else // Overnight

return 0.75m;

El código anterior funciona correctamente, pero no es legible. Para que el código tenga
sentido, tiene que encadenar todos los casos de entrada y las instrucciones if
anidadas. En su lugar, usará la coincidencia de patrones para esta característica, pero la
integrará con otras técnicas. Podría crear una expresión de coincidencia de patrones
única que consideraría todas las combinaciones de dirección, día de la semana y hora. El
resultado sería una expresión complicada. Podría ser difícil de leer y de comprender.
Esto implica que es difícil garantizar su exactitud. En su lugar, combine esos método
para crear una tupla de valores que describa de manera concisa todos esos estados.
Luego, use la coincidencia de patrones para calcular un multiplicador para el peaje. La
tupla contiene tres condiciones discretas:

El día es un día laborable o fin de semana.

La banda de tiempo cuando se cobra el peaje.
La dirección si va hacia la ciudad o desde la ciudad.

En la tabla siguiente se muestran las combinaciones de valores de entrada y el

multiplicador de precio en horas punta:

Día Time Dirección Premium

 Día Time Dirección Premium

Día de la semana hora punta de la mañana hacia la ciudad x 2,00

Día de la semana hora punta de la mañana desde la ciudad x 1,00

Día de la semana día hacia la ciudad x 1,50

Día de la semana día desde la ciudad x 1,50

Día de la semana hora punta de la tarde hacia la ciudad x 1,00

Día de la semana hora punta de la tarde desde la ciudad x 2,00

Día de la semana noche hacia la ciudad x 0,75

Día de la semana noche desde la ciudad x 0,75

Fin de semana hora punta de la mañana hacia la ciudad x 1,00

Fin de semana hora punta de la mañana desde la ciudad x 1,00

Fin de semana día hacia la ciudad x 1,00

Fin de semana día desde la ciudad x 1,00

Fin de semana hora punta de la tarde hacia la ciudad x 1,00

Fin de semana hora punta de la tarde desde la ciudad x 1,00

Fin de semana noche hacia la ciudad x 1,00

Fin de semana noche desde la ciudad x 1,00

Hay 16 combinaciones distintas de las tres variables. Mediante la combinación de

algunas de las condiciones, simplificará la expresión switch final.

El sistema que cobra los peajes usa una estructura DateTime para la hora en que se
cobró el peaje. Genere métodos de miembro que creen las variables a partir de la tabla
anterior. La función siguiente usa una expresión switch de coincidencia de patrones para
expresar si la estructura DateTime representa un día laborable o un fin de semana:

C#

private static bool IsWeekDay(DateTime timeOfToll) =>

timeOfToll.DayOfWeek switch

DayOfWeek.Monday => true,

DayOfWeek.Tuesday => true,

DayOfWeek.Wednesday => true,

DayOfWeek.Thursday => true,

 DayOfWeek.Friday => true,

DayOfWeek.Saturday => false,

DayOfWeek.Sunday => false

};

Ese método es correcto, pero es redundante. Puede simplificarlo tal como se muestra en
el código siguiente:

C#

private static bool IsWeekDay(DateTime timeOfToll) =>

timeOfToll.DayOfWeek switch

DayOfWeek.Saturday => false,

DayOfWeek.Sunday => false,

_ => true

};

A continuación, agregue una función similar para categorizar la hora en los bloques:

C#

private enum TimeBand

MorningRush,

Daytime,

EveningRush,

Overnight

private static TimeBand GetTimeBand(DateTime timeOfToll) =>

timeOfToll.Hour switch

< 6 or > 19 => TimeBand.Overnight,

< 10 => TimeBand.MorningRush,

< 16 => TimeBand.Daytime,

_ => TimeBand.EveningRush,

};

Agregue un elemento enum privado para convertir cada intervalo de tiempo en un valor
discreto. Después, el método GetTimeBand usa patrones relacionales y patrones or
conjuntivos, ambos agregados en C# 9.0. El patrón relacional permite probar un valor
numérico mediante < , > , <= o >= . El patrón or comprueba si una expresión coincide
con uno o más patrones. También puede usar un patrón and para asegurarse de que
una expresión coincide con dos patrones distintos, y un patrón not para probar que una
expresión no coincide con un patrón.
Después de usar esos métodos, puede usar otra expresión switch con el patrón de
tuplas para calcular el recargo en los precios. Puede crear una expresión switch con los
16 segmentos:

C#

public decimal PeakTimePremiumFull(DateTime timeOfToll, bool inbound) =>

(IsWeekDay(timeOfToll), GetTimeBand(timeOfToll), inbound) switch

(true, TimeBand.MorningRush, true) => 2.00m,

(true, TimeBand.MorningRush, false) => 1.00m,

(true, TimeBand.Daytime, true) => 1.50m,

(true, TimeBand.Daytime, false) => 1.50m,

(true, TimeBand.EveningRush, true) => 1.00m,

(true, TimeBand.EveningRush, false) => 2.00m,

(true, TimeBand.Overnight, true) => 0.75m,

(true, TimeBand.Overnight, false) => 0.75m,

(false, TimeBand.MorningRush, true) => 1.00m,

(false, TimeBand.MorningRush, false) => 1.00m,

(false, TimeBand.Daytime, true) => 1.00m,

(false, TimeBand.Daytime, false) => 1.00m,

(false, TimeBand.EveningRush, true) => 1.00m,

(false, TimeBand.EveningRush, false) => 1.00m,

(false, TimeBand.Overnight, true) => 1.00m,

(false, TimeBand.Overnight, false) => 1.00m,

};

El código anterior funciona, pero se puede simplificar. Las ocho combinaciones para el
fin de semana tienen el mismo peaje. Puede reemplazar las ocho por la siguiente línea:

C#

(false, _, _) => 1.0m,

Tanto el tráfico hacia la ciudad como el tráfico desde la ciudad tienen el mismo
multiplicador durante el día y la noche de los fines de semana. Esos cuatro segmentos
modificadores se pueden reemplazar por las dos líneas siguientes:

C#

(true, TimeBand.Overnight, _) => 0.75m,

(true, TimeBand.Daytime, _) => 1.5m,

El código debe ser similar al código siguiente después de esos dos cambios:

C#
 public decimal PeakTimePremium(DateTime timeOfToll, bool inbound) =>

(IsWeekDay(timeOfToll), GetTimeBand(timeOfToll), inbound) switch

(true, TimeBand.MorningRush, true) => 2.00m,

(true, TimeBand.MorningRush, false) => 1.00m,

(true, TimeBand.Daytime, _) => 1.50m,

(true, TimeBand.EveningRush, true) => 1.00m,

(true, TimeBand.EveningRush, false) => 2.00m,

(true, TimeBand.Overnight, _) => 0.75m,

(false, _, _) => 1.00m,

};

Por último, puede quitar las dos horas punta en que se paga el precio regular. Cuando
quite esos segmentos, puede reemplazar false por un descarte ( _ ) en el segmento
modificador final. Tendrá el siguiente método finalizado:

C#

public decimal PeakTimePremium(DateTime timeOfToll, bool inbound) =>

(IsWeekDay(timeOfToll), GetTimeBand(timeOfToll), inbound) switch

(true, TimeBand.Overnight, _) => 0.75m,

(true, TimeBand.Daytime, _) => 1.5m,

(true, TimeBand.MorningRush, true) => 2.0m,

(true, TimeBand.EveningRush, false) => 2.0m,

_ => 1.0m,

};

En este ejemplo se resalta una de las ventajas de la coincidencia de patrones: las ramas
del patrón se evalúan en orden. Si vuelve a ordenarlas para que una rama anterior
controle uno de los últimos casos, el compilador genera una advertencia sobre el
código inaccesible. Esas reglas de lenguaje facilitan la realización de las simplificaciones
anteriores con la confianza de que el código no cambió.

La coincidencia de patrones hace que algunos tipos de código sean más legibles y
ofrece una alternativa a las técnicas orientadas a objetos cuando no se puede agregar
código a las clases. La nube hace que los datos y la funcionalidad residan por separado.
La forma de los datos y las operaciones que se realizan en ellos no necesariamente se
describen en conjunto. En este tutorial, consumió datos existentes de maneras
totalmente distintas de su función original. La coincidencia de patrones le ha brindado
la capacidad de escribir una funcionalidad que reemplazase a esos tipos, aunque no le
permitía extenderlos.

Pasos siguientes
Puede descargar el código finalizado del repositorio GitHub dotnet/samples . Explore
los patrones por su cuenta y agregue esta técnica a sus actividades habituales de
codificación. Aprender estas técnicas le permite contar con otra forma de enfocar los
problemas y crear una funcionalidad nueva.

Vea también
Patrones
Expresión switch
Procedimientos para controlar una
excepción mediante Try y Catch
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El propósito de un bloque try-catch es detectar y controlar una excepción generada por

código en funcionamiento. Algunas excepciones se pueden controlar en un bloque
catch y es posible resolver el problema sin que se vuelva a producir la excepción, pero

la mayoría de las veces lo único que se puede hacer es asegurarse de que se produzca
la excepción adecuada.

Ejemplo
En este ejemplo, IndexOutOfRangeException no es la excepción más adecuada. Tiene
más sentido la excepción ArgumentOutOfRangeException para el método, ya que el
error lo provoca el argumento index que pasa el autor de la llamada.

C#

static int GetInt(int[] array, int index)

try

return array[index];

catch (IndexOutOfRangeException e) // CS0168

Console.WriteLine(e.Message);

// Set IndexOutOfRangeException to the new exception's

InnerException.

throw new ArgumentOutOfRangeException("index parameter is out of

range.", e);

Comentarios
El código que produce una excepción está incluido en el bloque try . Se agrega una
instrucción catch inmediatamente después para controlar IndexOutOfRangeException , si
se produce. El bloque catch controla la excepción IndexOutOfRangeException y produce
en su lugar la excepción ArgumentOutOfRangeException , más adecuada. Para
proporcionar al autor de la llamada tanta información como sea posible, considere la
posibilidad de especificar la excepción original como InnerException de la nueva
excepción. Dado que la propiedad InnerException es read-only, debe asignarla en el
constructor de la nueva excepción.
Procedimiento para ejecutar código de
limpieza mediante finally
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El propósito de una instrucción finally es asegurarse de que la limpieza necesaria de

los objetos, por lo general objetos que contienen recursos externos, se produzca
inmediatamente, incluso si se produce una excepción. Un ejemplo de esta limpieza es
llamar a Close en un FileStream inmediatamente después de su uso en lugar de esperar
a que el objeto sea recolectado por el Common Language Runtime, de esta forma:

C#

static void CodeWithoutCleanup()

FileStream? file = null;

FileInfo fileInfo = new FileInfo("./file.txt");

file = fileInfo.OpenWrite();

file.WriteByte(0xF);

file.Close();

Ejemplo
Para activar el código anterior en una instrucción try-catch-finally , el código de
limpieza se separa del código de trabajo, de esta forma.

C#

static void CodeWithCleanup()

FileStream? file = null;

FileInfo? fileInfo = null;

try

fileInfo = new FileInfo("./file.txt");

file = fileInfo.OpenWrite();

file.WriteByte(0xF);

catch (UnauthorizedAccessException e)

Console.WriteLine(e.Message);

finally

file?.Close();

Dado que una excepción puede producirse en cualquier momento dentro del bloque
try antes de la llamada a OpenWrite() , o que podría producirse un error en la propia
llamada a OpenWrite() , no se garantiza que el archivo esté abierto cuando se intente
cerrar. El bloque finally agrega una comprobación para asegurarse de que el objeto
FileStream no sea null antes de que se pueda llamar al método Close. Sin la
comprobación null , el bloque finally podría iniciar su propia excepción
NullReferenceException, pero debería evitarse generar excepciones en bloques finally ,
si es posible.

Una conexión de base de datos es otra buena candidata para cerrarse en un bloque
finally . Dado que a veces se limita el número de conexiones permitido en un servidor

de base de datos, se deben cerrar las conexiones de base de datos tan pronto como sea
posible. Si se produce una excepción antes de poder cerrar la conexión, es mejor usar el
bloque finally que esperar a la recolección de elementos no utilizados.

Consulte también
using (instrucción)
try-catch
try-finally
try-catch-finally
Novedades de C# 11
Artículo • 21/02/2023 • Tiempo de lectura: 9 minutos

Se agregaron las siguientes características en C# 11:

Literales de cadena sin formato

Compatibilidad con matemáticas genéricas
Atributos genéricos
Literales de cadena UTF-8
Nuevas líneas en expresiones de interpolación de cadenas
Patrones de lista
Tipos locales de archivo
Miembros requeridos
Structs predeterminados automáticos
Coincidencia de patrones de Span<char> en una string de constante
Ámbito nameof ampliado
IntPtr numérico
Campos ref y scoped ref
Conversión mejorada de grupo de métodos a delegado
Ola de advertencias 7

Puede descargar la versión más reciente de Visual Studio 2022 . También puede probar

todas estas características con el SDK de .NET 7, que se puede descargar desde la
página de descargas de .NET .

７ Nota

Estamos interesados en sus comentarios sobre estas características. Si encuentra

problemas con cualquiera de estas nuevas características, cree un nuevo
problema en el repositorio dotnet/roslyn .

Atributos genéricos
Puede declarar una clase genérica cuya clase base sea System.Attribute. Esta
característica proporciona una sintaxis más cómoda para los atributos que requieren un
parámetro System.Type. Antes había que crear un atributo que tomara Type como
parámetro de constructor:

C#
 // Before C# 11:

public class TypeAttribute : Attribute

public TypeAttribute(Type t) => ParamType = t;

public Type ParamType { get; }

Y, para aplicar el atributo, se usa el operador typeof:

C#

[TypeAttribute(typeof(string))]

public string Method() => default;

Con esta nueva característica, puede crear un atributo genérico en su lugar:

C#

// C# 11 feature:

public class GenericAttribute<T> : Attribute { }

Luego, especifique el parámetro de tipo para usar el atributo:

C#

[GenericAttribute<string>()]

public string Method() => default;

Debe proporcionar todos los parámetros de tipo al aplicar el atributo. En otras palabras,
el tipo genérico debe construirse completamente.
En el ejemplo anterior, los paréntesis
vacíos ( ( y ) ) se pueden omitir, ya que el atributo no tiene ningún argumento.

C#

public class GenericType<T>

[GenericAttribute<T>()] // Not allowed! generic attributes must be fully

constructed types.

public string Method() => default;

Los argumentos de tipo deben cumplir las mismas restricciones que el operador typeof.
No se permiten los tipos que requieren anotaciones de metadatos. Por ejemplo, no se
permiten los siguientes tipos como parámetro de tipo:
 dynamic

string? (o cualquier tipo de referencia que acepte valores NULL)

(int X, int Y) (o cualquier otro tipo de tupla que use la sintaxis de tupla de C#)

Estos tipos no se representan directamente en los metadatos Incluyen anotaciones que

describen el tipo. En todos los casos, se puede usar el tipo subyacente en su lugar:

object para dynamic

string en lugar de string? .

ValueTuple<int, int> en lugar de (int X, int Y) .

Compatibilidad matemática genérica

Hay varias características de lenguaje que habilitan la compatibilidad matemática
genérica:

static virtual miembros en interfaces

Operador definido por el usuario checked

operadores de desplazamiento relajado
Operador de desplazamiento a la derecha sin signo

Puede agregar static abstract o static virtual miembros en interfaces para definir
interfaces que incluyan operadores sobrecargables, otros miembros estáticos y
propiedades estáticas. El escenario principal de esta característica es usar operadores
matemáticos en tipos genéricos. Por ejemplo, puede implementar la interfaz de
System.IAdditionOperators<TSelf, TOther, TResult> en un tipo que implementa

operator + . Otras interfaces definen otras operaciones matemáticas o valores bien

definidos. Puede obtener información sobre la nueva sintaxis en el artículo sobre
interfaces. Las interfaces que incluyen métodos de static virtual suelen ser interfaces
genéricas. Además, la mayoría declarará una restricción que el parámetro de tipo
implementa en la interfaz declarada.

Para más información y probar la característica usted mismo, consulte el tutorial

Exploración de miembros de la interfaz abstracta estática o la entrada de blog
Características en versión preliminar de .NET 6: matemáticas genéricas .

Las matemáticas genéricas han creado otros requisitos en el lenguaje.

Operador de desplazamiento a la derecha sin signo: antes de C# 11, para forzar un

desplazamiento a la derecha sin signo, había que convertir cualquier tipo entero
con signo en un tipo sin signo, llevar a cabo el desplazamiento y, después,
 convertir el resultado en un tipo con signo. A partir de C# 11, puede usar >>> , el
operador de desplazamiento sin signo.
Requisitos de operador de desplazamiento menos estrictos: C# 11 elimina el
requisito de que el segundo operando debe ser un int o convertible
implícitamente en int . Este cambio permite que los tipos que implementan
interfaces matemáticas genéricas se usen en estas ubicaciones.
Operadores definidos por el usuario checked y unchecked: los desarrolladores ya
pueden definir los operadores aritméticos checked y unchecked . El compilador
genera llamadas a la variante correcta en función del contexto actual. Puede
obtener más información sobre los checked operadores en el artículo sobre
operadores aritméticos.

IntPtr y UIntPtr numéricos

Los tipos nint y nuint ahora se conocen como System.IntPtr y System.UIntPtr
respectivamente.

Nuevas líneas en interpolaciones de cadenas

El texto dentro de los caracteres { y } de una interpolación de cadenas ahora puede
abarcar varias líneas. El texto entre los marcadores { y } se analiza como C#. Se
permite cualquier C# válido, incluidas las nuevas líneas. Esta característica facilita la
lectura de interpolaciones de cadenas que usan expresiones de C# más largas, como
expresiones switch de coincidencia de patrones o consultas LINQ.

Puede aprender más sobre la característica de nuevas líneas en el artículo

Interpolaciones de cadenas de la referencia del lenguaje.

Patrones de lista
Los patrones de lista amplían la coincidencia de patrones para buscar coincidencias con
secuencias de elementos de una lista o una matriz. Por ejemplo, sequence is [1, 2, 3]
es true cuando sequence es una matriz o una lista de tres enteros (1, 2 y 3). Puede
hacer coincidir elementos mediante cualquier patrón, como constante, tipo, propiedad y
patrones relacionales. El patrón de descarte ( _ ) coincide con cualquier elemento único y
el nuevo patrón de intervalo ( .. ) coincide con cualquier secuencia de cero o más
elementos.
Puede encontrar más información sobre los patrones de lista en el artículo sobre
coincidencia de patrones en la referencia del lenguaje.

Conversión mejorada de grupo de métodos a

delegado
El estándar de C# en conversiones de grupo de métodos ahora incluye el siguiente
elemento:

La conversión se permite (pero no necesaria) para usar una instancia de

delegado existente que ya contiene estas referencias.

Las versiones anteriores del estándar prohibían al compilador reutilizar el objeto

delegado creado para una conversión de grupo de métodos. El compilador de C# 11
almacena en caché el objeto delegado creado a partir de una conversión de grupo de
métodos y reutiliza ese objeto delegado único. Esta característica se incluyó por primera
vez en Visual Studio 2022 versión 17.2 como característica en vista previa y en .NET 7
(versión preliminar 2).

Literales de cadena sin formato

Los literales de cadena sin formato son un nuevo formato para los literales de cadena.
Los literales de cadena sin formato pueden contener texto arbitrario, como espacios en
blanco, nuevas líneas, comillas insertadas y otros caracteres especiales sin necesidad de
secuencias de escape. Un literal de cadena sin formato comienza con al menos tres
caracteres de comillas dobles ("""). Y termina con el mismo número de caracteres de
comillas dobles. Normalmente, un literal de cadena sin formato usa tres comillas dobles
en una sola línea para iniciar la cadena y tres comillas dobles en una línea independiente
para finalizar la cadena. Las nuevas líneas que siguen a la comilla de apertura y
preceden a la comilla de cierre no se incluyen en el contenido final:

C#

string longMessage = """

This is a long message.

It has several lines.

Some are indented

more than others.

Some should start at the first column.

Some have "quoted text" in them.

""";

Cualquier espacio en blanco a la izquierda de las comillas dobles de cierre se quitará del
literal de cadena. Los literales de cadena sin formato se pueden combinar con la
interpolación de cadenas para incluir llaves en el texto de salida. Varios caracteres $
indican cuántas llaves consecutivas comienzan y terminan la interpolación:

C#

var location = $$"""

You are at {{{Longitude}}, {{Latitude}}}

""";

En el ejemplo anterior se especifica que dos llaves inician y finalizan una interpolación.
La tercera llave de apertura y cierre repetida se incluye en la cadena de salida.

Puede encontrar más información sobre los literales de cadena sin formato en el artículo
sobre cadenas de la guía de programación y los artículos de referencia del lenguaje
sobre literales de cadena y cadenas interpoladas.

Estructuras predeterminadas automáticas

El compilador de C# 11 garantiza que todos los campos de un tipo struct se
inicializarán en su valor predeterminado como parte de la ejecución de un constructor.
Este cambio significa que el compilador inicializa automáticamente cualquier campo o
propiedad automática no inicializados por un constructor. Las estructuras en las que el
constructor no asigna definitivamente todos los campos ahora se compilan, mientras
que los campos que no se inicializan explícitamente se establecen en su valor
predeterminado. Puede obtener más información sobre cómo afecta este cambio a la
inicialización de estructuras en el artículo sobre estructuras.

Span<char> de coincidencia de patrón o

ReadOnlySpan<char> en una constante string
Ha podido probar si un elemento string tiene un valor constante específico mediante
la coincidencia de patrones en varias versiones. Ahora, puede usar la misma lógica de
coincidencia de patrones con variables que son Span<char> o ReadOnlySpan<char> .

Ámbito nameof ampliado

Los nombres de parámetro de tipo y los de parámetro ahora están en el ámbito cuando
se usan en una expresión nameof de una declaración de atributo del método. Esta
característica significa que puede usar el operador nameof para especificar el nombre de
un parámetro de método en un atributo de una declaración de método o parámetro.
Esta característica suele ser útil para agregar atributos y llevar a cabo análisis que
admitan valores NULL.

Literales de cadena de UTF-8

Puede especificar el sufijo u8 en un literal de cadena para especificar la codificación de
caracteres UTF-8. Si la aplicación necesita cadenas UTF-8, para constantes de cadena
HTTP o protocolos de texto similares, puede usar esta característica para simplificar la
creación de cadenas UTF-8.

Puede obtener más información sobre los literales de cadena UTF-8 en la sección literal
de cadena del artículo sobre los tipos de referencia integrados.

Miembros requeridos
Puede agregar el modificadorrequired a propiedades y campos para aplicar
constructores y llamadores para inicializar esos valores. El
System.Diagnostics.CodeAnalysis.SetsRequiredMembersAttribute se puede agregar a
constructores para informar al compilador de que un constructor inicializa todos los
miembros necesarios.

Para obtener más información sobre los miembros necesarios, consulte la sección solo
inicial del artículo de propiedades.

Campos ref y variables ref scoped

Puede declarar campos ref en ref struct. Esto admite el uso de tipos como
System.Span<T> sin atributos especiales o tipos internos ocultos.

Puede agregar el modificador scoped a cualquier declaración de ref . Esto limita el

ámbito al que la referencia puede escapar.

Tipos locales de archivo

A partir de C# 11, el modificador de acceso file se puede usar para crear un tipo cuya
visibilidad esté limitada al archivo de origen en el que se declara. Esta característica
ayuda a los autores de generadores de código fuente a evitar conflictos de
nomenclatura. Puede obtener más información sobre esta característica en el artículo
sobre tipos con ámbito de archivo en la sección de referencia del lenguaje.

Vea también
Novedades de .NET 7
Novedades de C# 10
Artículo • 21/02/2023 • Tiempo de lectura: 6 minutos

C# 10 agrega las características y las mejoras al lenguaje C# siguientes:

Structs de registro
Mejoras de tipos de estructura
Controladores de cadena interpolada
Directivas global using
Declaración de espacios de nombres con ámbito de archivo
Patrones de propiedades extendidos
Mejoras en expresiones lambda
Se permiten cadenas interpoladas const
Los tipos de registro pueden sellar ToString()
Asignación definitiva mejorada
Se permite la asignación y la declaración en la misma desconstrucción
Se permite el atributo AsyncMethodBuilder en los métodos
Atributo CallerArgumentExpression
Pragma #line mejorado
Ola de advertencias 6

C# 10 es compatible con .NET 6. Para obtener más información, vea Control de
versiones del lenguaje C#.

Puede descargar el SDK de .NET 6 más reciente de la página de descargas de .NET .

También puede descargar Visual Studio 2022 , que incluye el SDK de .NET 6.

７ Nota

Estamos interesados en sus comentarios sobre estas características. Si encuentra

problemas con cualquiera de estas nuevas características, cree un nuevo
problema en el repositorio dotnet/roslyn .

Structs de registro
Puede declarar los registros de tipo de valor mediante las declaraciones record struct o
readonly record struct. Ahora puede aclarar que un elemento record es un tipo de
referencia con la declaración record class .
Mejoras de tipos de estructura
C# 10 presenta las mejoras siguientes relacionadas con los tipos de estructura:

Puede declarar un constructor sin parámetros de instancia en un tipo de estructura

e inicializar un campo o propiedad de instancia en su declaración. Para más
información, consulte la sección Inicialización de estructuras y valores
predeterminados del artículo Tipos de estructuras.
Un operando izquierdo de la expresión with puede ser de cualquier tipo de
estructura o un tipo anónimo (de referencia).

Controlador de cadena interpolada

Puede crear un tipo que compile la cadena resultante a partir de una expresión de
cadena interpolada. Las bibliotecas de .NET usan esta característica en muchas API.
Puede compilar una siguiendo este tutorial.

Directivas using globales

Puede agregar el modificador global a cualquier directiva using para indicar al
compilador que la directiva se aplica a todos los archivos de código fuente de la
compilación. Normalmente, se trata de todos los archivos de código fuente de un
proyecto.

Declaración de espacios de nombres con

ámbito de archivo
Puede usar una nueva forma de la declaración namespace para declarar que todas las
declaraciones posteriores son miembros del espacio de nombres declarado:

C#

namespace MyNamespace;

Esta nueva sintaxis ahorra espacio horizontal y vertical para las declaraciones namespace .

Patrones de propiedades extendidos

A partir de C# 10, puede hacer referencia a propiedades o campos anidados en un
patrón de propiedad. Por ejemplo, un patrón con el formato

C#

{ Prop1.Prop2: pattern }

es válido en C# 10 y versiones posteriores, y equivalente a

C#

{ Prop1: { Prop2: pattern } }

válido en C# 8.0 y versiones posteriores.

Para obtener más información, consulte la nota de propuesta de características Patrones

de propiedades extendidos. Para obtener más información sobre un patrón de
propiedades, vea la sección Patrón de propiedad del artículo Patrones.

Mejoras de expresiones lambda

C# 10 incluye muchas mejoras en el modo en que se controlan las expresiones lambda:

Las expresiones lambda pueden tener un tipo natural, donde el compilador puede
deducir un tipo delegado de la expresión lambda o del grupo de métodos.
Las expresiones lambda pueden declarar un tipo de valor devuelto cuando el
compilador no puede deducirlo.
Los atributos se pueden aplicar a las expresiones lambda.

Estas características hacen que las expresiones lambda sean parecidas a los métodos y
las funciones locales. Facilitan el uso de expresiones lambda sin declarar una variable de
un tipo delegado y funcionan de forma más fluida con las nuevas API mínimas de
ASP.NET CORE.

Cadenas interpoladas constantes

En C# 10, las cadenas const se pueden inicializar mediante la interpolación de cadenas
si todos los marcadores de posición son cadenas constantes. La interpolación de
cadenas puede crear cadenas constantes más legibles a medida que se compilan las
cadenas constantes usadas en la aplicación. Las expresiones de marcador de posición no
pueden ser constantes numéricas porque esas constantes se convierten en cadenas en
tiempo de ejecución. La referencia cultural actual puede afectar a su representación de
cadena. Obtenga más información en la referencia del lenguaje sobre expresiones const.

Los tipos de registro pueden sellar ToString

En C# 10, puede agregar el modificador sealed al invalidar ToString en un tipo de
registro. Al sellar el método ToString , se impide que el compilador sintetice un método
ToString para cualquier tipo de registro derivado. Un elemento ToString sealed
(sellado) garantiza que todos los tipos de registros derivados usen el método ToString ,
definido en un tipo de registro base común. Puede obtener más información sobre esta
característica en el artículo sobre registros.

Asignación y declaración en la misma

desconstrucción
Este cambio quita una restricción de versiones anteriores de C#. Anteriormente, una
desconstrucción podía asignar todos los valores a variables existentes, o bien inicializar
variables recién declaradas:

C#

// Initialization:

(int x, int y) = point;

// assignment:

int x1 = 0;

int y1 = 0;

(x1, y1) = point;

En C# 10 se elimina esta restricción:

C#

int x = 0;

(x, int y) = point;

Asignación definitiva mejorada

Antes de C# 10, había muchos escenarios en los que la asignación definitiva y el análisis
de estado NULL generaban advertencias que eran falsos positivos. Por lo general, estas
implicaban comparaciones con constantes booleanas, el acceso a una variable solo en
las instrucciones true o false de una instrucción if , y expresiones de uso combinado
de NULL. Estos ejemplos generaron advertencias en versiones anteriores de C#, pero no
en C# 10:

C#

string representation = "N/A";

if ((c != null && c.GetDependentValue(out object obj)) == true)

representation = obj.ToString(); // undesired error

// Or, using ?.

if (c?.GetDependentValue(out object obj) == true)

representation = obj.ToString(); // undesired error

// Or, using ??

if (c?.GetDependentValue(out object obj) ?? false)

representation = obj.ToString(); // undesired error

El impacto principal de esta mejora es que las advertencias para la asignación definitiva
y el análisis de estado NULL son más precisas.

Se permite el atributo AsyncMethodBuilder en

los métodos
En C# 10 y versiones posteriores, puede especificar un generador de métodos
asincrónicos diferente para un único método, además de especificar el tipo de
generador de métodos para todos los métodos que devuelven un tipo concreto similar
a una tarea. Un generador de métodos asíncronos personalizado permite escenarios
avanzados de optimización del rendimiento en los que un método determinado puede
beneficiarse de un generador personalizado.

Para obtener más información, vea la sección sobre AsyncMethodBuilder del artículo
sobre los atributos leídos por el compilador.

Diagnóstico del atributo

CallerArgumentExpression
Puede usar System.Runtime.CompilerServices.CallerArgumentExpressionAttribute para
especificar un parámetro que el compilador reemplace por la representación de texto de
otro argumento. Esta característica permite a las bibliotecas crear diagnósticos más
específicos. El código siguiente prueba una condición. Si la condición es false, el
mensaje de excepción incluye la representación de texto del argumento pasado a
condition :

C#

public static void Validate(bool condition,

[CallerArgumentExpression("condition")] string? message=null)

if (!condition)

throw new InvalidOperationException($"Argument failed validation:

<{message}>");

Puede obtener más información sobre esta característica en el artículo sobre Atributos
de información del autor de la llamada en la sección de referencia del lenguaje.

Pragma #line mejorado

C# 10 admite un formato nuevo para el pragma #line . Es probable que no use el
formato nuevo, pero verá sus efectos. Las mejoras permiten una salida más detallada en
lenguajes específicos de dominio (DSL), como Razor. El motor de Razor usa estas
mejoras para mejorar la experiencia de depuración. Encontrará que los depuradores
pueden resaltar el origen de Razor con más precisión. Para obtener más información
sobre la nueva sintaxis, vea el artículo sobre Directivas de preprocesador en la referencia
del lenguaje. También puede leer la especificación de la característica para obtener
ejemplos basados en Razor.
Novedades de C# 9.0
Artículo • 15/02/2023 • Tiempo de lectura: 20 minutos

C# 9.0 agrega las siguientes características y mejoras al lenguaje C#:

Registros
Establecedores de solo inicialización
Instrucciones de nivel superior
Mejoras de coincidencia de patrones
Rendimiento e interoperabilidad
Enteros con tamaño nativos
Punteros de función
Supresión de la emisión de la marca localsinit
Características de ajuste y finalización
Expresiones new con tipo de destino
Funciones anónimas static
Expresiones condicionales con tipo de destino
Tipos de valor devueltos de covariante
Compatibilidad con extensiones GetEnumerator para bucles foreach
Parámetros de descarte lambda
Atributos en funciones locales
Compatibilidad con generadores de código
Inicializadores de módulo
Nuevas características para métodos parciales
Ola de advertencias 5

C# 9.0 es compatible con .NET 5. Para obtener más información, vea Control de
versiones del lenguaje C#.

Puede descargar el SDK de .NET más reciente de la página de descargas de .NET .

Tipos de registro
C# 9.0 introduce los tipos de registro. Se usa la palabra clave record para definir un tipo
de referencia que proporciona funcionalidad integrada para encapsular los datos. Puede
crear tipos de registros con propiedades inmutables mediante parámetros posicionales
o sintaxis de propiedades estándar:

C#

public record Person(string FirstName, string LastName);

 C#

public record Person

public string FirstName { get; init; } = default!;

public string LastName { get; init; } = default!;

};

También puede crear tipos de registros con propiedades y campos mutables:

C#

public record Person

public string FirstName { get; set; } = default!;

public string LastName { get; set; } = default!;

};

Aunque los registros pueden ser mutables, están destinados principalmente a admitir
modelos de datos inmutables. El tipo de registro ofrece las siguientes características:

Sintaxis concisa para crear un tipo de referencia con propiedades inmutables

Comportamiento útil para un tipo de referencia centrado en datos:
Igualdad de valores
Sintaxis concisa para la mutación no destructiva
Formato integrado para la presentación
Compatibilidad con las jerarquías de herencia

Puede utilizar tipos de estructura para diseñar tipos centrados en datos que
proporcionen igualdad de valores y un comportamiento escaso o inexistente. Pero, en el
caso de los modelos de datos relativamente grandes, los tipos de estructura tienen
algunas desventajas:

No admiten la herencia.
Son menos eficaces a la hora de determinar la igualdad de valores. En el caso de
los tipos de valor, el método ValueType.Equals usa la reflexión para buscar todos
los campos. En el caso de los registros, el compilador genera el método Equals . En
la práctica, la implementación de la igualdad de valores en los registros es
bastante más rápida.
Usan más memoria en algunos escenarios, ya que cada instancia tiene una copia
completa de todos los datos. Los tipos de registro son tipos de referencia, por lo
que una instancia de registro solo contiene una referencia a los datos.
Sintaxis posicional para la definición de propiedad
Puede usar parámetros posicionales para declarar propiedades de un registro e
inicializar los valores de propiedad al crear una instancia:

C#

public record Person(string FirstName, string LastName);

public static void Main()

Person person = new("Nancy", "Davolio");

Console.WriteLine(person);

// output: Person { FirstName = Nancy, LastName = Davolio }

Cuando se usa la sintaxis posicional para la definición de propiedad, el compilador crea

lo siguiente:

Una propiedad pública implementada automáticamente de solo inicialización para

cada parámetro posicional proporcionado en la declaración de registro. Una
propiedad de solo inicialización solo se puede establecer en el constructor o
mediante un inicializador de propiedad.
Un constructor primario cuyos parámetros coinciden con los parámetros
posicionales en la declaración del registro.
Un método Deconstruct con un parámetro out para cada parámetro posicional
proporcionado en la declaración de registro.

Para obtener más información, vea Sintaxis posicional en el artículo de referencia del
lenguaje C# acerca de los registros.

Inmutabilidad
Un tipo de registro no es necesariamente inmutable. Puede declarar propiedades con
descriptores de acceso set y campos que no sean readonly . Sin embargo, aunque los
registros pueden ser mutables, facilitan la creación de modelos de datos inmutables. Las
propiedades que se crean mediante la sintaxis posicional son inmutables.

La inmutabilidad puede resultar útil si quiere que un tipo centrado en datos sea seguro
para subprocesos o un código hash quede igual en una tabla hash. Puede impedir que
se produzcan errores cuando se pasa un argumento por referencia a un método y el
método cambia inesperadamente el valor del argumento.
Las características exclusivas de los tipos de registro se implementan mediante métodos
sintetizados por el compilador, y ninguno de estos métodos pone en peligro la
inmutabilidad mediante la modificación del estado del objeto.

Igualdad de valores
La igualdad de valores significa que dos variables de un tipo de registro son iguales si
los tipos coinciden y todos los valores de propiedad y campo coinciden. Para otros tipos
de referencia, la igualdad significa identidad. Es decir, dos variables de un tipo de
referencia son iguales si hacen referencia al mismo objeto.

En el ejemplo siguiente se muestra la igualdad de valores de tipos de registro:

C#

public record Person(string FirstName, string LastName, string[]

PhoneNumbers);

public static void Main()

var phoneNumbers = new string[2];

Person person1 = new("Nancy", "Davolio", phoneNumbers);

Person person2 = new("Nancy", "Davolio", phoneNumbers);

Console.WriteLine(person1 == person2); // output: True

person1.PhoneNumbers[0] = "555-1234";

Console.WriteLine(person1 == person2); // output: True

Console.WriteLine(ReferenceEquals(person1, person2)); // output: False

En los tipos class , podría invalidar manualmente los métodos y los operadores de
igualdad para lograr la igualdad de valores, pero el desarrollo y las pruebas de ese
código serían lentos y propensos a errores. Al tener esta funcionalidad integrada, se
evitan los errores que resultarían de olvidarse de actualizar el código de invalidación
personalizado cuando se agreguen o cambien propiedades o campos.

Para obtener más información, vea Igualdad de valores en el artículo de referencia del
lenguaje C# acerca de los registros.

Mutación no destructiva
Si necesita mutar propiedades inmutables de una instancia de registro, puede usar una
expresión with para lograr una mutación no destructiva. Una expresión with crea una
instancia de registro que es una copia de una instancia de registro existente, con las
propiedades y los campos especificados modificados. Use la sintaxis del inicializador de
objeto para especificar los valores que se van a cambiar, como se muestra en el ejemplo
siguiente:

C#

public record Person(string FirstName, string LastName)

public string[] PhoneNumbers { get; init; }

public static void Main()

Person person1 = new("Nancy", "Davolio") { PhoneNumbers = new string[1]

};

Console.WriteLine(person1);

// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers

= System.String[] }

Person person2 = person1 with { FirstName = "John" };

Console.WriteLine(person2);

// output: Person { FirstName = John, LastName = Davolio, PhoneNumbers =

System.String[] }

Console.WriteLine(person1 == person2); // output: False

person2 = person1 with { PhoneNumbers = new string[1] };

Console.WriteLine(person2);

// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers

= System.String[] }

Console.WriteLine(person1 == person2); // output: False

person2 = person1 with { };

Console.WriteLine(person1 == person2); // output: True

Para obtener más información, vea Mutación no destructiva en el artículo de referencia

del lenguaje C# acerca de los registros.

Formato integrado para la presentación

Los tipos de registros tienen un método ToString generado por el compilador que
muestra los nombres y los valores de las propiedades y los campos públicos. El método
ToString devuelve una cadena con el formato siguiente:

<nombre de tipo de registro> { <nombre de propiedad> = <value>, <nombre de

propiedad> = <value>, ...}
En el caso de los tipos de referencia, se muestra el nombre del tipo del objeto al que
hace referencia la propiedad en lugar del valor de propiedad. En el ejemplo siguiente, la
matriz es un tipo de referencia, por lo que se muestra System.String[] en lugar de los
valores de los elementos de matriz reales:

Person { FirstName = Nancy, LastName = Davolio, ChildNames = System.String[]

}

Para obtener más información, vea Formato integrado en el artículo de referencia del
lenguaje C# acerca de los registros.

Herencia
Un registro puede heredar de otro registro. Sin embargo, un registro no puede heredar
de una clase, y una clase no puede heredar de un registro.

En el ejemplo siguiente se muestra la herencia con la sintaxis de la propiedad posicional:

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

Console.WriteLine(teacher);

// output: Teacher { FirstName = Nancy, LastName = Davolio, Grade = 3 }

Para que dos variables de registro sean iguales, el tipo en tiempo de ejecución debe ser
el mismo. Los tipos de las variables contenedoras podrían ser diferentes. Esto se
muestra en el siguiente código de ejemplo:

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public record Student(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

Person student = new Student("Nancy", "Davolio", 3);

 Console.WriteLine(teacher == student); // output: False

Student student2 = new Student("Nancy", "Davolio", 3);

Console.WriteLine(student2 == student); // output: True

En el ejemplo, todas las instancias tienen las mismas propiedades y los mismos valores
de propiedad. Pero student == teacher devuelve False aunque ambas sean variables
de tipo Person . Y student == student2 devuelve True aunque una sea una variable
Person y otra sea una variable Student .

Todas las propiedades y los campos públicos de los tipos derivados y base se incluyen
en la salida ToString , como se muestra en el ejemplo siguiente:

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public record Student(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

Console.WriteLine(teacher);

// output: Teacher { FirstName = Nancy, LastName = Davolio, Grade = 3 }

Para obtener más información, vea Herencia en el artículo de referencia del lenguaje C#
acerca de los registros.

Establecedores de solo inicialización

Los establecedores de solo inicialización proporcionan una sintaxis coherente para
inicializar los miembros de un objeto. Los inicializadores de propiedades indican con
claridad qué valor establece cada propiedad. El inconveniente es que esas propiedades
se deben establecer. A partir de C# 9.0, puede crear descriptores de acceso init en
lugar de descriptores de acceso set para propiedades e indizadores. Los autores de la
llamada pueden usar la sintaxis de inicializador de propiedad para establecer estos
valores en expresiones de creación, pero esas propiedades son de solo lectura una vez
que se ha completado la construcción. Los establecedores de solo inicialización
proporcionan una ventana para cambiar el estado, que se cierra cuando finaliza la fase
de construcción. La fase de construcción finaliza de forma eficaz después de que se
complete toda la inicialización, incluidos los inicializadores de propiedades y las
expresiones with.

Puede declarar los establecedores de solo init en cualquier tipo que escriba. Por
ejemplo, en la estructura siguiente se define una estructura de observación
meteorológica:

C#

public struct WeatherObservation

public DateTime RecordedAt { get; init; }

public decimal TemperatureInCelsius { get; init; }

public decimal PressureInMillibars { get; init; }

public override string ToString() =>

$"At {RecordedAt:h:mm tt} on {RecordedAt:M/d/yyyy}: " +

$"Temp = {TemperatureInCelsius}, with {PressureInMillibars}

pressure";

Los autores de la llamada pueden usar la sintaxis de inicializador de propiedades para

establecer los valores, a la vez que conservan la inmutabilidad:

C#

var now = new WeatherObservation

RecordedAt = DateTime.Now,

TemperatureInCelsius = 20,

PressureInMillibars = 998.0m
};

Un intento de cambiar una observación después de la inicialización genera un error del

compilador:

C#

// Error! CS8852.

now.TemperatureInCelsius = 18;

Los establecedores de solo inicialización pueden ser útiles para establecer las
propiedades de clase base de las clases derivadas. También pueden establecer
propiedades derivadas mediante asistentes en una clase base. Los registros posicionales
declaran propiedades mediante establecedores de solo inicialización. Esos
establecedores se usan en expresiones with. Puede declarar establecedores de solo
inicialización para cualquier objeto class , struct o record que defina.

Para obtener más información, vea init (referencia de C#).

Instrucciones de nivel superior

Las instrucciones de nivel superior eliminan la complejidad innecesaria de muchas
aplicaciones. Considere el programa canónico "Hola mundo":

C#

using System;

namespace HelloWorld

class Program

static void Main(string[] args)

Console.WriteLine("Hello World!");

Solo hay una línea de código que haga algo. Con las instrucciones de nivel superior,
puede reemplazar todo lo que sea reutilizable por la directiva using y la línea única que
realiza el trabajo:

C#

using System;

Console.WriteLine("Hello World!");

Si quisiera un programa de una línea, podría quitar la directiva using y usar el nombre
de tipo completo:

C#

System.Console.WriteLine("Hello World!");

Solo un archivo de la aplicación puede usar instrucciones de nivel superior. Si el

compilador encuentra instrucciones de nivel superior en varios archivos de código
fuente, se trata de un error. También es un error si combina instrucciones de nivel
superior con un método de punto de entrada de programa declarado, normalmente
Main . En cierto sentido, puede pensar que un archivo contiene las instrucciones que
normalmente se encontrarían en el método Main de una clase Program .

Uno de los usos más comunes de esta característica es la creación de materiales

educativos. Los desarrolladores de C# principiantes pueden escribir el programa
canónico "Hola mundo" en una o dos líneas de código. No se necesitan pasos
adicionales. Pero los desarrolladores veteranos también encontrarán muchas
aplicaciones a esta característica. Las instrucciones de nivel superior permiten una
experiencia de experimentación de tipo script similar a la que proporcionan los
cuadernos de Jupyter Notebook. Las instrucciones de nivel superior son excelentes para
programas y utilidades de consola pequeños. Azure Functions es un caso de uso ideal
para las instrucciones de nivel superior.

Y sobre todo, las instrucciones de nivel superior no limitan el ámbito ni la complejidad

de la aplicación. Estas instrucciones pueden acceder a cualquier clase de .NET o usarla.
Tampoco limitan el uso de argumentos de línea de comandos ni de valores devueltos.
Las instrucciones de nivel superior pueden acceder a una matriz de cadenas
denominada args . Si las instrucciones de nivel superior devuelven un valor entero, ese
valor se convierte en el código devuelto entero de un método Main sintetizado. Las
instrucciones de nivel superior pueden contener expresiones asincrónicas. En ese caso,
el punto de entrada sintetizado devuelve un objeto Task , o Task<int> .

Para obtener más información, vea Instrucciones de nivel superior en la Guía de

programación de C#.

Mejoras de coincidencia de patrones

C# 9 incluye nuevas mejoras de coincidencia de patrones:

Los patrones de tipo coinciden con un objeto que coincide con un tipo
determinado.
Los patrones con paréntesis aplican o resaltan la prioridad de las combinaciones
de patrones
En los patrones and conjuntivos es necesario que los dos patrones coincidan.
En los patrones or disyuntivos es necesario que alguno de los patrones coincida
En los patrones not negados es necesario que un patrón no coincida.
Los patrones relacionales requieren que la entrada sea menor que, mayor que,
menor o igual que, o mayor o igual que una constante determinada.

Estos patrones enriquecen la sintaxis de los patrones. Tenga en cuenta estos ejemplos:
 C#

public static bool IsLetter(this char c) =>

c is >= 'a' and <= 'z' or >= 'A' and <= 'Z';

Con paréntesis opcionales para que quede claro que and tiene mayor prioridad que or :

C#

public static bool IsLetterOrSeparator(this char c) =>

c is (>= 'a' and <= 'z') or (>= 'A' and <= 'Z') or '.' or ',';

Uno de los usos más comunes es una nueva sintaxis para una comprobación NULL:

C#

if (e is not null)

// ...

Cualquiera de estos patrones se puede usar en cualquier contexto en el que se permitan

patrones: expresiones de patrón is , expresiones switch , patrones anidados y el patrón
de la etiqueta case de una instrucción switch .

Para obtener más información, consulte Patrones (referencia de C#).

Para obtener más información, vea las secciones Patrones relacionales y Patrones lógicos
del artículo Patrones.

Rendimiento e interoperabilidad
Tres nuevas características mejoran la compatibilidad con la interoperabilidad nativa y
las bibliotecas de bajo nivel que requieren alto rendimiento: enteros de tamaño nativo,
punteros de función y la omisión de la marca localsinit .

Los enteros de tamaño nativo, nint y nuint , son tipos enteros. Se expresan mediante
los tipos subyacentes System.IntPtr y System.UIntPtr. El compilador muestra las
conversiones y operaciones adicionales para estos tipos como enteros nativos. Los
enteros con tamaño nativo definen propiedades para MaxValue o MinValue . Estos
valores no se pueden expresar como constantes en tiempo de compilación porque
dependen del tamaño nativo de un entero en el equipo de destino. Estos valores son de
solo lectura en tiempo de ejecución. Puede usar valores constantes para nint en el
intervalo [ int.MinValue .. int.MaxValue ]. Puede usar valores constantes para nuint en el
intervalo [ uint.MinValue .. uint.MaxValue ]. El compilador realiza un plegamiento
constante para todos los operadores unarios y binarios que usan los tipos System.Int32
y System.UInt32. Si el resultado no cabe en 32 bits, la operación se ejecuta en tiempo de
ejecución y no se considera una constante. Los enteros con tamaño nativo pueden
aumentar el rendimiento en escenarios en los que se usa la aritmética de enteros y es
necesario tener el rendimiento más rápido posible. Para obtener más información,
consulte los tipos nint y nuint.

Los punteros de función proporcionan una sintaxis sencilla para acceder a los códigos
de operación de lenguaje intermedio ldftn y calli . Puede declarar punteros de
función con la nueva sintaxis de delegate* . Un tipo delegate* es un tipo de puntero. Al
invocar el tipo delegate* se usa calli , a diferencia de un delegado que usa callvirt
en el método Invoke() . Sintácticamente, las invocaciones son idénticas. La invocación
del puntero de función usa la convención de llamada managed . Agregue la palabra clave
unmanaged después de la sintaxis de delegate* para declarar que quiere la convención

de llamada unmanaged . Se pueden especificar otras convenciones de llamada mediante

atributos en la declaración de delegate* . Para obtener más información, vea Código no
seguro y tipos de puntero.

Por último, puede agregar System.Runtime.CompilerServices.SkipLocalsInitAttribute para

indicar al compilador que no emita la marca localsinit . Esta marca indica al CLR que
inicialice en cero todas las variables locales. La marca localsinit ha sido el
comportamiento predeterminado en C# desde la versión 1.0. Pero la inicialización en
cero adicional puede afectar al rendimiento en algunos escenarios. En concreto, cuando
se usa stackalloc . En esos casos, puede agregar SkipLocalsInitAttribute. Puede
agregarlo a un único método o propiedad, a un objeto class , struct , interface , o
incluso a un módulo. Este atributo no afecta a los métodos abstract ; afecta al código
generado para la implementación. Para obtener más información, vea Atributo
SkipLocalsInit.

Estas características pueden aumentar significativamente el rendimiento en algunos

escenarios. Solo se deben usar después de realizar pruebas comparativas
minuciosamente antes y después de la adopción. El código que implica enteros con
tamaño nativo se debe probar en varias plataformas de destino con distintos tamaños
de enteros. Las demás características requieren código no seguro.

Características de ajuste y finalización

Muchas de las características restantes ayudan a escribir código de forma más eficaz. En
C# 9.0, puede omitir el tipo de una expresión new cuando ya se conoce el tipo del
objeto creado. El uso más común es en las declaraciones de campo:

C#

private List<WeatherObservation> _observations = new();

El tipo de destino new también se puede usar cuando es necesario crear un objeto para
pasarlo como argumento a un método. Considere un método ForecastFor() con la
signatura siguiente:

C#

public WeatherForecast ForecastFor(DateTime forecastDate,

WeatherForecastOptions options)

Podría llamarlo de esta forma:

C#

var forecast = station.ForecastFor(DateTime.Now.AddDays(2), new());

Otra aplicación muy útil de esta característica es para combinarla con propiedades de
solo inicialización para inicializar un objeto nuevo:

C#

WeatherStation station = new() { Location = "Seattle, WA" };

Puede devolver una instancia creada por el constructor predeterminado mediante una
declaración return new(); .

Una característica similar mejora la resolución de tipos de destino de las expresiones

condicionales. Con este cambio, las dos expresiones no necesitan tener una conversión
implícita de una a otra, pero pueden tener conversiones implícitas a un tipo de destino.
Lo más probable es que no note este cambio. Lo que observará es que ahora funcionan
algunas expresiones condicionales para las que anteriormente se necesitaban
conversiones o que no se compilaban.

A partir de C# 9.0, puede agregar el modificador static a expresiones lambda o

métodos anónimos. Las expresiones lambda estáticas son análogas a las funciones
static locales: un método anónimo o una expresión lambda estáticos no puede
capturar variables locales ni el estado de la instancia. El modificador static impide la
captura accidental de otras variables.

Los tipos de valor devuelto covariantes proporcionan flexibilidad a los tipos de valor
devuelto de los métodos override. Un método override puede devolver un tipo derivado
del tipo de valor devuelto del método base invalidado. Esto puede ser útil para los
registros y para otros tipos que admiten métodos de generador o clonación virtuales.

Además, el bucle foreach reconocerá y usará un método de extensión GetEnumerator

que, de otro modo, satisface el patrón foreach . Este cambio significa que foreach es
coherente con otras construcciones basadas en patrones, como el patrón asincrónico y
la desconstrucción basada en patrones. En la práctica, esto quiere decir que puede
agregar compatibilidad con foreach a cualquier tipo. Debe limitar su uso a cuando la
enumeración de un objeto tiene sentido en el diseño.

Después, puede usar descartes como parámetros para las expresiones lambda. De esta
forma no tiene que asignar un nombre al argumento y el compilador puede evitar
usarlo. Use _ para cualquier argumento. Para más información, consulte sección sobre
parámetros de entrada de una expresión lambda en el artículo sobre expresiones
lambda.

Por último, ahora puede aplicar atributos a las funciones locales. Por ejemplo, puede
aplicar anotaciones de atributo que admiten un valor NULL a las funciones locales.

Compatibilidad con generadores de código

Dos últimas características admiten generadores de código de C#. Los generadores de
código de C# son un componente que se puede escribir y que es similar a una
corrección de código o un analizador Roslyn. La diferencia es que los generadores de
código analizan el código y escriben nuevos archivos de código fuente como parte del
proceso de compilación. Un generador de código típico busca atributos y otras
convenciones en el código.

Un generador de código lee atributos u otros elementos de código mediante las API de
análisis de Roslyn. A partir de esa información, agrega código nuevo a la compilación.
Los generadores de código fuente solo pueden agregar código; no se les permite
modificar ningún código existente en la compilación.

Las dos características agregadas a los generadores de código son extensiones de la

sintaxis de método parcial y los inicializadores de módulos. En primer lugar, los
cambios en los métodos parciales. Antes de C# 9.0, los métodos parciales eran private ,
pero no podían especificar un modificador de acceso, tener un valor devuelto void ni
parámetros out . Estas restricciones implican que si no se proporciona ninguna
implementación de método, el compilador quita todas las llamadas al método parcial.
En C# 9.0 se quitan estas restricciones, pero es necesario que las declaraciones de
métodos parciales tengan una implementación. Los generadores de código pueden
proporcionar esa implementación. Para evitar la introducción de un cambio importante,
el compilador tiene en cuenta cualquier método parcial sin un modificador de acceso
para seguir las reglas anteriores. Si el método parcial incluye el modificador de acceso
private , las nuevas reglas rigen ese método parcial. Para obtener más información, vea

partial (Método) (referencia de C#).

La segunda característica nueva de los generadores de código son los inicializadores de

módulos. Los inicializadores de módulos son métodos que tienen asociado el atributo
ModuleInitializerAttribute. El entorno de ejecución llamará a estos métodos antes de
cualquier otro acceso de campo o invocación de método en todo el módulo. Un
método de inicializador de módulo:

Debe ser estático

No debe tener parámetros
Debe devolver void
No debe ser un método genérico
No debe estar incluido en una clase genérica
Debe ser accesible desde el módulo contenedor

Ese último punto significa en realidad que el método y su clase contenedora deben ser
internos o públicos. El método no puede ser una función local. Para obtener más
información, vea Atributo ModuleInitializer.
Historia de C#
Artículo • 09/03/2023 • Tiempo de lectura: 17 minutos

En este artículo se proporciona un historial de cada versión principal del lenguaje C#. El
equipo de C# continúa innovando y agregando nuevas características. Se puede
encontrar información sobre el estado detallado de las características de lenguaje,
incluidas las características consideradas para las próximas versiones, en el repositorio
dotnet/roslyn de GitHub.

） Importante

El lenguaje C# se basa en tipos y métodos en lo que la especificación de C# define

como una biblioteca estándar para algunas de las características. La plataforma .NET
ofrece los tipos y métodos en un número de paquetes. Un ejemplo es el
procesamiento de excepciones. Cada expresión o instrucción throw se comprueba
para asegurarse de que el objeto que se genera deriva de Exception. Del mismo
modo, cada catch se comprueba para asegurarse de que el tipo que se captura
deriva de Exception. Cada versión puede agregar requisitos nuevos. Para usar las
características más recientes del lenguaje en entornos anteriores, es posible que
tenga que instalar bibliotecas específicas. Estas dependencias están documentadas
en la página de cada versión específica. Puede obtener más información sobre las
relaciones entre lenguaje y biblioteca para tener más antecedentes sobre esta
dependencia.

C# versión 11
Fecha de publicación noviembre de 2022

Se agregaron las siguientes características en C# 11:

Literales de cadena sin formato

Compatibilidad con matemáticas genéricas
Atributos genéricos
Literales de cadena UTF-8
Nuevas líneas en expresiones de interpolación de cadenas
Patrones de lista
Tipos locales de archivo
Miembros requeridos
Structs predeterminados automáticos
 Coincidencia de patrones de Span<char> en una string de constante
Ámbito nameof ampliado
IntPtr numérico
Campos ref y scoped ref
Conversión mejorada de grupo de métodos a delegado
Ola de advertencias 7

C# 11 presenta matemáticas genéricas y varias características que admiten ese objetivo.

Puede escribir algoritmos numéricos una vez para todos los tipos de números. Hay más
características para facilitar el trabajo con struct tipos, como los miembros necesarios y
las estructuras predeterminadas automáticas. Trabajar con cadenas resulta más fácil con
literales de cadena sin formato, nueva línea en interpolaciones de cadenas y literales de
cadena UTF-8. Las características como los tipos locales de archivo permiten que los
generadores de origen sean más sencillos. Por último, los patrones de lista agregan más
compatibilidad con la coincidencia de patrones.

C# versión 10
Fecha de publicación noviembre de 2021

C# 10 agrega las características y las mejoras al lenguaje C# siguientes:

Structs de registro
Mejoras de tipos de estructura
Controladores de cadena interpolada
Directivas global using
Declaración de espacios de nombres con ámbito de archivo
Patrones de propiedades extendidos
Mejoras en expresiones lambda
Se permiten cadenas interpoladas const
Los tipos de registro pueden sellar ToString()
Asignación definitiva mejorada
Se permite la asignación y la declaración en la misma desconstrucción
Se permite el atributo AsyncMethodBuilder en los métodos
Atributo CallerArgumentExpression
Pragma #line mejorado

Hay más características disponibles en el modo de vista previa. Para poder usar estas
características, debe establecer <LangVersion> en Preview en el proyecto:

Los atributos genéricos se explican más adelante en este artículo.

miembros abstractos estáticos en interfaces
C# 10 sigue trabajando en temas de eliminación de ceremonias, separación de datos de
los algoritmos y rendimiento mejorado para .NET Runtime.

Muchas de las características le permiten escribir menos código para expresar los
mismos conceptos. Los structs de registro sintetizan muchos de los mismos métodos
que las clases de registro. Los structs y los tipos anónimos son compatibles con las
expresiones. Las directivas de uso global y las declaraciones de espacio de nombres con
ámbito de archivo consiguen que exprese las dependencias y la organización del espacio
de nombres con mayor claridad. Las mejoras de lambda facilitan la declaración de
expresiones lambda en las que se usan. Los nuevos patrones de propiedad y las mejoras
de deconstrucción crean un código más conciso.

Los nuevos controladores de cadenas interpoladas y el comportamiento

AsyncMethodBuilder pueden mejorar el rendimiento. Estas características de lenguaje se
aplicaron en .NET Runtime para lograr mejoras de rendimiento en .NET 6.

C# 10 también supone un cambio más profundo en la cadencia anual de los

lanzamientos de .NET. Dado que no todas las características se pueden completar en un
período anual, puede probar un par de características en "versión preliminar" de C# 10.
Se pueden usar atributos genéricos y miembros abstractos estáticos en interfaces, pero
son características en versión preliminar y pueden cambiar antes de su versión final.

C# versión 9
Fecha de publicación noviembre de 2020

C# 9 se publicó con .NET 5. Es la versión de lenguaje predeterminada para cualquier

ensamblado que tenga como destino la versión de .NET 5. Contiene las siguientes
características nuevas y mejoradas:

Registros
Establecedores de solo inicialización
Instrucciones de nivel superior
Mejoras de coincidencia de patrones
Rendimiento e interoperabilidad
Enteros con tamaño nativos
Punteros de función
Supresión de la emisión de la marca localsinit
Características de ajuste y finalización
Expresiones new con tipo de destino
Funciones anónimas static
Expresiones condicionales con tipo de destino
 Tipos de valor devueltos de covariante
Compatibilidad con extensiones GetEnumerator para bucles foreach
Parámetros de descarte lambda
Atributos en funciones locales
Compatibilidad con generadores de código
Inicializadores de módulo
Nuevas características para métodos parciales

C# 9 continúa tres de los temas de versiones anteriores: quitar complejidad, separar
datos de algoritmos y proporcionar más patrones en más lugares.

Las instrucciones de nivel superior hacen que el programa principal sea más fácil de leer.
La complejidad es innecesaria: un espacio de nombres, una clase Program y static void
Main() son innecesarios.

La introducción de records proporciona una sintaxis concisa para los tipos de referencia
que siguen la semántica del valor para la igualdad. Usará estos tipos para definir
contenedores de datos que normalmente definen un comportamiento mínimo. Los
establecedores de solo inicialización proporcionan la funcionalidad para la mutación no
destructiva with (expresiones) en los registros. C# 9 también agrega tipos de valor
devuelto de covariante para que los registros derivados puedan invalidar los métodos
virtuales y devolver un tipo derivado del tipo de valor devuelto del método base.

Las funcionalidades de coincidencia de patrones se han expandido de varias maneras.

Los tipos numéricos ahora admiten patrones de rango. Los patrones se pueden
combinar mediante los patrones and , or y not . Se pueden agregar paréntesis para
aclarar patrones más complejos.

Otro conjunto de características admite la informática de alto rendimiento en C#:

Los tipos nint y nuint modelan los tipos enteros de tamaño nativo en la CPU de
destino.
Los punteros de función proporcionan una funcionalidad similar a la de un
delegado, al mismo tiempo que evitan las asignaciones necesarias para crear un
objeto delegado.
La instrucción localsinit se puede omitir para guardar instrucciones.

Otro conjunto de mejoras admite escenarios en los que los generadores de código
agregan funcionalidad:

Los inicializadores de módulo son métodos a los que el runtime llama cuando se
carga un ensamblado.
 Los métodos parciales admiten nuevos modificadores de acceso y tipos de valor
devuelto distintos de void. En esos casos, se debe proporcionar una
implementación.

C# 9 agrega muchas otras pequeñas características que mejoran la productividad del
desarrollador, tanto para escribir como para leer código:

Expresiones new con tipo de destino

Funciones anónimas static
Expresiones condicionales con tipo de destino
Compatibilidad con extensiones GetEnumerator() para bucles foreach
Las expresiones lambda pueden declarar parámetros de descarte
Los atributos se pueden aplicar a las funciones locales

La versión C# 9 continúa el trabajo para hacer que C# siga siendo un lenguaje de
programación moderno y de uso general. Las características siguen siendo compatibles
con cargas de trabajo y tipos de aplicación modernos.

C# versión 8.0
Fecha de publicación septiembre de 2019

C# 8.0 es la primera versión C# principal que tiene como destino específicamente .NET
Core. Algunas características se basan en nuevas funcionalidades de CLR, otras en tipos
de biblioteca agregados solo a .NET Core. C# 8.0 agrega las siguientes características y
mejoras al lenguaje C#:

Miembros de solo lectura

Métodos de interfaz predeterminados
Mejoras de coincidencia de patrones:
Expresiones switch
Patrones de propiedades
Patrones de tupla
Patrones posicionales
Declaraciones using
Funciones locales estáticas
Estructuras ref descartables
Tipos de referencia que aceptan valores null
Secuencias asincrónicas
Índices y rangos
Asignación de uso combinado de NULL
Tipos construidos no administrados
 Stackalloc en expresiones anidadas
Mejora de las cadenas textuales interpoladas

Los miembros de interfaz predeterminados requieren mejoras en CLR. Estas

características se agregaron en CLR para .NET Core 3.0. Los intervalos y los índices, y los
flujos asincrónicos requieren nuevos tipos en las bibliotecas de .NET Core 3.0. Los tipos
de referencia que aceptan valores NULL, aunque se implementan en el compilador, son
mucho más útiles cuando se anotan bibliotecas para proporcionar información
semántica relativa al estado NULL de los argumentos y los valores devueltos. Esas
anotaciones se agregan a las bibliotecas de .NET Core.

C# versión 7.3
Fecha de publicación mayo de 2018

Hay dos temas principales para la versión C# 7.3. Un tema proporciona características
que permiten al código seguro ser tan eficaz como el código no seguro. El segundo
tema proporciona mejoras incrementales en las características existentes. También se
han agregado nuevas opciones de compilador en esta versión.

Las siguientes características nuevas admiten el tema del mejor rendimiento para código
seguro:

Puede tener acceso a campos fijos sin anclar.

Puede volver a asignar variables locales ref .
Puede usar inicializadores en matrices stackalloc .
Puede usar instrucciones fixed con cualquier tipo que admita un patrón.
Puede usar restricciones más genéricas.

Se hicieron las mejoras siguientes a las características existentes:

Puede probar == y != con los tipos de tupla.

Puede usar variables de expresión en más ubicaciones.
Puede asociar atributos al campo de respaldo de las propiedades
autoimplementadas.
Se ha mejorado la resolución de métodos cuando los argumentos difieren por in .
Ahora, la resolución de sobrecarga tiene menos casos ambiguos.

Las nuevas opciones del compilador son:

-publicsign para habilitar la firma de ensamblados de software de código abierto

(OSS).
-pathmap para proporcionar una asignación para los directorios de origen.
C# versión 7.2
Fecha de publicación noviembre de 2017

C#7.2 agregó varias características de lenguaje pequeñas:

Inicializadores en matrices  stackalloc .

Uso de instrucciones  fixed con cualquier tipo que admita un patrón.
Acceso campos fijos sin anclar.
Reasignación de variables locales  ref .
Declaración de tipos readonly struct para indicar que una estructura es fija y que
debería pasarse como parámetro in a los métodos de su miembro.
Incorporación del modificador in en los parámetros para especificar que un
argumento se pasa mediante una referencia sin que el método al que se realiza
una llamada lo modifique.
Uso del modificador ref readonly en las devoluciones de método para indicar que
un método devuelve su valor mediante una referencia, pero que no permite
operaciones de escritura en el objeto.
Declaración de tipos ref struct para indicar que un tipo de estructura tiene
acceso directo a la memoria administrada y que siempre debe estar asignada a la
pila.
Uso de restricciones genéricas adicionales.
Argumentos con nombre no finales
Los argumentos con nombre pueden ir seguidos de argumentos posicionales.
Caracteres de subrayado iniciales en literales numéricos
Los literales numéricos ahora pueden tener caracteres de subrayado iniciales
antes de los dígitos impresos.
Modificador de acceso private protected
El modificador de acceso private protected permite el acceso de clases
derivadas en el mismo ensamblado.
Expresiones ref condicionales
El resultado de una expresión condicional ( ?: ) ahora puede ser una referencia.

C# versión 7.1
Fecha de publicación agosto de 2017

C# empezó a publicar versiones de punto con C# 7.1. Esta versión agregó el elemento de
configuración de selección de versión de lenguaje, tres nuevas características de
lenguaje y un nuevo comportamiento del compilador.
Las nuevas características de lenguaje de esta versión son las siguientes:

asyncMain method
El punto de entrada de una aplicación puede tener el modificador async .
Expresiones literales default
Se pueden usar expresiones literales predeterminadas en expresiones de valor
predeterminadas cuando el tipo de destino se pueda inferir.
Nombres de elementos de tupla inferidos
En muchos casos, los nombres de elementos de tupla se pueden deducir de la
inicialización de la tupla.
Coincidencia de patrones en parámetros de tipo genérico
Puede usar expresiones de coincidencia de patrones en variables cuyo tipo es
un parámetro de tipo genérico.

Por último, el compilador tiene dos opciones, -refout y -refonly, que controlan la
generación de ensamblados de referencia.

C# versión 7.0
Fecha de publicación marzo de 2017

C# versión 7.0 se comercializó con Visual Studio 2017. Esta versión tiene algunas cosas

interesantes y evolutivas en la misma línea que C# 6.0. Estas son algunas de las nuevas
características:

Variables out
Tuplas y deconstrucción
Coincidencia de patrones
Funciones locales
Miembros con forma de expresión expandidos
Variables locales de tipo ref
Devoluciones de referencias

Otras características incluidas:

Descartes
Literales binarios y separadores de dígitos
Expresiones throw

Todas estas características ofrecen capacidades nuevas para los desarrolladores y la

posibilidad de escribir un código de manera más clara que nunca. De manera destacada,
condensan la declaración de variables que se van a usar con la palabra clave out y
permiten varios valores devueltos a través de tuplas. .NET Core ahora tiene como
destino cualquier sistema operativo y tiene puesta la mirada en la nube y la
portabilidad. Por supuesto, esas nuevas capacidades ocupan las ideas y el tiempo de los
diseñadores de lenguaje, además de ofrecer nuevas características.

C# versión 6.0
Fecha de publicación julio de 2015

Versión 6.0, publicada con Visual Studio 2015, lanzó muchas características más
pequeñas que hicieron que la programación de C# sea más productiva. Estas son
algunas de ellas:

Importaciones estáticas
Filtros de excepciones
Inicializadores de propiedades automáticas
Miembros de cuerpo de expresión
Propagador de null
Interpolación de cadenas
operador nameof

Entre las otras características nuevas se incluyen estas:

Inicializadores de índice
Await en bloques catch y finally
Valores predeterminados para las propiedades solo de captador

Cada una de estas características es interesante en sí misma. Pero si las observamos en

su conjunto, vemos un patrón interesante. En esta versión, C# comenzó a eliminar el
lenguaje reutilizable para que el código sea más breve y legible. Así que, para los que
adoran el código simple y limpio, esta versión del lenguaje fue una gran aportación.

En esta versión también se hizo otra cosa, aunque no es una característica de lenguaje
tradicional: publicaron el compilador Roslyn como un servicio . Ahora, el compilador
de C# está escrito en C# y puede usarlo como parte de su trabajo de programación.

C# versión 5.0
Fecha de publicación agosto de 2012

La versión 5.0 de C#, publicada con Visual Studio 2012, era una versión centrada del
lenguaje. Casi todo el trabajo de esa versión se centró en otro concepto de lenguaje
innovador: el modelo async y await para la programación asincrónica. Estas son las
principales características:

Miembros asincrónicos
Atributos de información del llamador
Proyecto de código: Atributos de información del autor de llamada en C# 5.0

El atributo de información del autor de la llamada permite recuperar fácilmente

información sobre el contexto donde se está ejecutando sin tener que recurrir a una
gran cantidad de código de reflexión reutilizable. Tiene muchos usos en tareas de
registro y diagnóstico.

Pero async y await son los auténticos protagonistas de esta versión. Cuando estas
características salieron a la luz en 2012, C# cambió de nuevo las reglas del juego al
integrar la asincronía en el lenguaje como un participante de primera clase. Si alguna
vez ha trabajado con operaciones de larga duración y la implementación de sitios web
de devoluciones de llamada, probablemente le haya encantado esta característica del
lenguaje.

C# versión 4.0
Fecha de publicación abril de 2010

La versión 4.0 de C#, publicada con Visual Studio 2010, tuvo que lidiar con el carácter
innovador que había adquirido la versión 3.0. Esta versión introdujo algunas
características nuevas interesantes:

Enlace dinámico
Argumentos opcionales/con nombre
Covariante y contravariante de genéricos
Tipos de interoperabilidad insertados

Los tipos de interoperabilidad incrustados facilitaron el problema de implementación de

crear ensamblados de interoperabilidad COM para la aplicación. La covarianza y
contravarianza de genéricos proporcionan más capacidad para usar genéricos, pero son
más bien académicos y probablemente más valorados por autores de bibliotecas y
Framework. Los parámetros opcionales y con nombre permiten eliminar muchas
sobrecargas de métodos y proporcionan mayor comodidad. Pero ninguna de esas
características está modificando el paradigma exactamente.

La característica más importante fue la introducción de la palabra clave dynamic . Con la

palabra clave dynamic , en la versión 4.0 de C# se introdujo la capacidad de invalidar el
compilador durante la escritura en tiempo de compilación. Al usar la palabra clave
dinámica, puede crear constructos similares a los lenguajes tipados dinámicamente,
como JavaScript. Puede crear dynamic x = "a string" y luego agregarle seis, dejando
que el runtime decida qué debería suceder después.

Los enlaces dinámicos pueden dar lugar a errores, pero también otorgan un gran poder
sobre el lenguaje.

C# versión 3.0
Fecha de publicación noviembre de 2007

La versión 3.0 de C# llegó a finales de 2007, junto con Visual Studio 2008, aunque la
cartera completa de características de lenguaje no llegaría realmente hasta la versión 3.5
de .NET Framework. Esta versión marcó un cambio importante en el crecimiento de C#.
Estableció C# como un lenguaje de programación realmente formidable. Echemos un
vistazo a algunas de las principales características de esta versión:

Propiedades implementadas automáticamente

Tipos anónimos (Guía de programación de C#).
Expresiones de consulta
Expresiones lambda
Árboles de expresión
Métodos de extensión
Variables locales con asignación implícita de tipos
Métodos parciales
Inicializadores de objeto y colección

En retrospectiva, muchas de estas características parecen inevitables e indivisibles. Todas

ellas encajan estratégicamente. Se considera que la mejor característica de la versión de
C# fue la expresión de consulta, también conocida como Language-Integrated Query
(LINQ).

Una vista más matizada examina árboles de expresión, expresiones lambda y tipos
anónimos como la base sobre la que se construye LINQ. Sin embargo, en cualquier caso,
C# 3.0 presentó un concepto revolucionario. C# 3.0 había comenzado a sentar las bases
para convertir C# en un lenguaje híbrido funcional y orientado a objetos.

En concreto, permitía escribir consultas declarativas en estilo de SQL para realizar

operaciones en colecciones, entre otras cosas. En lugar de escribir un bucle de for para
calcular el promedio de una lista de enteros, permitía hacerlo fácilmente como
list.Average() . La combinación de métodos de extensión y expresiones de consulta

hizo que esa lista de enteros fuera mucho más inteligente.

C# versión 2.0
Fecha de publicación noviembre de 2005

Echemos un vistazo a algunas de las principales características de C# 2.0, que se publicó

en 2005 junto con Visual Studio 2005:

Genéricos
Tipos parciales
Métodos anónimos
Tipos de valores que aceptan valores NULL
Iteradores
Covarianza y contravarianza

Otras características de C# 2.0 agregaron capacidades a las características existentes:

Accesibilidad independiente de captador o establecedor

Conversiones de grupos de métodos (delegados)
Clases estáticas
Inferencia de delegados

Aunque puede que C# haya comenzado como un lenguaje genérico orientado a

objetos, la versión 2.0 de C# cambió esto enseguida. Con los genéricos, los tipos y
métodos pueden operar en un tipo arbitrario a la vez que conservan la seguridad de
tipos. Por ejemplo, tener List<T> nos permite tener List<string> o List<int> y realizar
operaciones de tipo seguro en esas cadenas o en enteros mientras los recorremos en
iteración. Es mejor usar genéricos que crear un tipo ListInt que derive de ArrayList o
convertir desde Object en cada operación.

C# 2.0 incorporó los iteradores. Para explicarlo brevemente, los iteradores permiten
examinar todos los elementos de List (u otros tipos enumerables) con un bucle de
foreach . Tener iteradores como una parte de primera clase del lenguaje mejoró

drásticamente la facilidad de lectura del lenguaje y la capacidad de las personas de

razonar sobre el código.

Aun así, C# seguía yendo por detrás de Java. Java ya había publicado versiones que
incluían genéricos e iteradores. Pero esto cambiaría pronto a medida que los idiomas
siguieran evolucionando.
Versión 1.2 de C#
Fecha de publicación abril de 2003

Versión 1.2 de C# incluida en Visual Studio .NET 2003. Contenía algunas pequeñas
mejoras del lenguaje. Lo más notable es que, a partir de esa versión, el código se
generaba en un bucle foreach llamado Dispose en un IEnumerator cuando ese
IEnumerator implementaba IDisposable.

C# versión 1.0
Fecha de publicación enero de 2002

Si echa la vista atrás, la versión 1.0 de C#, publicada con Visual Studio .NET 2002, se
parecía mucho a Java. Como parte de sus objetivos de diseño declarados para ECMA ,
buscaba ser un “lenguaje sencillo, moderno, orientado a objetos y de uso general”. En
aquella época, parecerse a Java suponía conseguir esos primeros objetivos de diseño.

Pero si volvemos a echarle un vistazo a C# 1.0 ahora, no lo verá tan claro. Carecía de
capacidades asincrónicas integradas y de algunas funcionalidades útiles de genéricos
que se dan por sentado. De hecho, carecía por completo de genéricos. ¿Y LINQ? Aún no
estaba disponible. Esas características tardarían unos años más en agregarse.

C# 1.0 parecía estar privado de características, en comparación con la actualidad. Lo

normal era tener que escribir código detallado. Pero aun así, hay que empezar por algo.
C# 1.0 era una alternativa viable a Java en la plataforma Windows.

Las principales características de C# 1.0 incluían lo siguiente:

Clases
Structs
Interfaces
Eventos
Propiedades
Delegados
Operadores y expresiones
Instrucciones
Atributos

Artículopublicado originalmente en el blog de NDepend , por cortesía de Erik Dietrich y

Patrick Smacchia.
Conozca los cambios más importantes
en el compilador de C#.
Artículo • 28/11/2022 • Tiempo de lectura: 2 minutos

Puede encontrar cambios importantes desde la versión de C# 10 aquí.

El equipo de Roslyn mantiene una lista de cambios importantes en los compiladores

de C# y Visual Basic. Puede encontrar información sobre esos cambios en estos vínculos
del repositorio de GitHub:

Cambios importantes en Roslyn en C# 10.0/.NET 6

Cambios importantes en Roslyn después de .NET 5
Cambios importantes en la versión 16.8 de VS2019 incorporados con .NET 5 y
C# 9.0
Cambios importantes en VS2019 Update 1 y versiones posteriores en comparación
con VS2019
Cambios importantes desde VS2017 (C# 7)
Cambios importantes en Roslyn 3.0 (VS2019) desde Roslyn 2.* (VS2017)
Cambios importantes en Roslyn 2.0 (VS2017) desde Roslyn 1.* (VS2015) y en el
compilador nativo de C# (VS2013 y anterior).
Cambios importantes en Roslyn 1.0 (VS2015) desde el compilador nativo de C#
(VS2013 y anterior).
Cambio de versión de Unicode en C# 6
Historia de C#
Artículo • 09/03/2023 • Tiempo de lectura: 17 minutos

En este artículo se proporciona un historial de cada versión principal del lenguaje C#. El
equipo de C# continúa innovando y agregando nuevas características. Se puede
encontrar información sobre el estado detallado de las características de lenguaje,
incluidas las características consideradas para las próximas versiones, en el repositorio
dotnet/roslyn de GitHub.

） Importante

El lenguaje C# se basa en tipos y métodos en lo que la especificación de C# define

como una biblioteca estándar para algunas de las características. La plataforma .NET
ofrece los tipos y métodos en un número de paquetes. Un ejemplo es el
procesamiento de excepciones. Cada expresión o instrucción throw se comprueba
para asegurarse de que el objeto que se genera deriva de Exception. Del mismo
modo, cada catch se comprueba para asegurarse de que el tipo que se captura
deriva de Exception. Cada versión puede agregar requisitos nuevos. Para usar las
características más recientes del lenguaje en entornos anteriores, es posible que
tenga que instalar bibliotecas específicas. Estas dependencias están documentadas
en la página de cada versión específica. Puede obtener más información sobre las
relaciones entre lenguaje y biblioteca para tener más antecedentes sobre esta
dependencia.

C# versión 11
Fecha de publicación noviembre de 2022

Se agregaron las siguientes características en C# 11:

Literales de cadena sin formato

Compatibilidad con matemáticas genéricas
Atributos genéricos
Literales de cadena UTF-8
Nuevas líneas en expresiones de interpolación de cadenas
Patrones de lista
Tipos locales de archivo
Miembros requeridos
Structs predeterminados automáticos
 Coincidencia de patrones de Span<char> en una string de constante
Ámbito nameof ampliado
IntPtr numérico
Campos ref y scoped ref
Conversión mejorada de grupo de métodos a delegado
Ola de advertencias 7

C# 11 presenta matemáticas genéricas y varias características que admiten ese objetivo.

Puede escribir algoritmos numéricos una vez para todos los tipos de números. Hay más
características para facilitar el trabajo con struct tipos, como los miembros necesarios y
las estructuras predeterminadas automáticas. Trabajar con cadenas resulta más fácil con
literales de cadena sin formato, nueva línea en interpolaciones de cadenas y literales de
cadena UTF-8. Las características como los tipos locales de archivo permiten que los
generadores de origen sean más sencillos. Por último, los patrones de lista agregan más
compatibilidad con la coincidencia de patrones.

C# versión 10
Fecha de publicación noviembre de 2021

C# 10 agrega las características y las mejoras al lenguaje C# siguientes:

Structs de registro
Mejoras de tipos de estructura
Controladores de cadena interpolada
Directivas global using
Declaración de espacios de nombres con ámbito de archivo
Patrones de propiedades extendidos
Mejoras en expresiones lambda
Se permiten cadenas interpoladas const
Los tipos de registro pueden sellar ToString()
Asignación definitiva mejorada
Se permite la asignación y la declaración en la misma desconstrucción
Se permite el atributo AsyncMethodBuilder en los métodos
Atributo CallerArgumentExpression
Pragma #line mejorado

Hay más características disponibles en el modo de vista previa. Para poder usar estas
características, debe establecer <LangVersion> en Preview en el proyecto:

Los atributos genéricos se explican más adelante en este artículo.

miembros abstractos estáticos en interfaces
C# 10 sigue trabajando en temas de eliminación de ceremonias, separación de datos de
los algoritmos y rendimiento mejorado para .NET Runtime.

Muchas de las características le permiten escribir menos código para expresar los
mismos conceptos. Los structs de registro sintetizan muchos de los mismos métodos
que las clases de registro. Los structs y los tipos anónimos son compatibles con las
expresiones. Las directivas de uso global y las declaraciones de espacio de nombres con
ámbito de archivo consiguen que exprese las dependencias y la organización del espacio
de nombres con mayor claridad. Las mejoras de lambda facilitan la declaración de
expresiones lambda en las que se usan. Los nuevos patrones de propiedad y las mejoras
de deconstrucción crean un código más conciso.

Los nuevos controladores de cadenas interpoladas y el comportamiento

AsyncMethodBuilder pueden mejorar el rendimiento. Estas características de lenguaje se
aplicaron en .NET Runtime para lograr mejoras de rendimiento en .NET 6.

C# 10 también supone un cambio más profundo en la cadencia anual de los

lanzamientos de .NET. Dado que no todas las características se pueden completar en un
período anual, puede probar un par de características en "versión preliminar" de C# 10.
Se pueden usar atributos genéricos y miembros abstractos estáticos en interfaces, pero
son características en versión preliminar y pueden cambiar antes de su versión final.

C# versión 9
Fecha de publicación noviembre de 2020

C# 9 se publicó con .NET 5. Es la versión de lenguaje predeterminada para cualquier

ensamblado que tenga como destino la versión de .NET 5. Contiene las siguientes
características nuevas y mejoradas:

Registros
Establecedores de solo inicialización
Instrucciones de nivel superior
Mejoras de coincidencia de patrones
Rendimiento e interoperabilidad
Enteros con tamaño nativos
Punteros de función
Supresión de la emisión de la marca localsinit
Características de ajuste y finalización
Expresiones new con tipo de destino
Funciones anónimas static
Expresiones condicionales con tipo de destino
 Tipos de valor devueltos de covariante
Compatibilidad con extensiones GetEnumerator para bucles foreach
Parámetros de descarte lambda
Atributos en funciones locales
Compatibilidad con generadores de código
Inicializadores de módulo
Nuevas características para métodos parciales

C# 9 continúa tres de los temas de versiones anteriores: quitar complejidad, separar
datos de algoritmos y proporcionar más patrones en más lugares.

Las instrucciones de nivel superior hacen que el programa principal sea más fácil de leer.
La complejidad es innecesaria: un espacio de nombres, una clase Program y static void
Main() son innecesarios.

La introducción de records proporciona una sintaxis concisa para los tipos de referencia
que siguen la semántica del valor para la igualdad. Usará estos tipos para definir
contenedores de datos que normalmente definen un comportamiento mínimo. Los
establecedores de solo inicialización proporcionan la funcionalidad para la mutación no
destructiva with (expresiones) en los registros. C# 9 también agrega tipos de valor
devuelto de covariante para que los registros derivados puedan invalidar los métodos
virtuales y devolver un tipo derivado del tipo de valor devuelto del método base.

Las funcionalidades de coincidencia de patrones se han expandido de varias maneras.

Los tipos numéricos ahora admiten patrones de rango. Los patrones se pueden
combinar mediante los patrones and , or y not . Se pueden agregar paréntesis para
aclarar patrones más complejos.

Otro conjunto de características admite la informática de alto rendimiento en C#:

Los tipos nint y nuint modelan los tipos enteros de tamaño nativo en la CPU de
destino.
Los punteros de función proporcionan una funcionalidad similar a la de un
delegado, al mismo tiempo que evitan las asignaciones necesarias para crear un
objeto delegado.
La instrucción localsinit se puede omitir para guardar instrucciones.

Otro conjunto de mejoras admite escenarios en los que los generadores de código
agregan funcionalidad:

Los inicializadores de módulo son métodos a los que el runtime llama cuando se
carga un ensamblado.
 Los métodos parciales admiten nuevos modificadores de acceso y tipos de valor
devuelto distintos de void. En esos casos, se debe proporcionar una
implementación.

C# 9 agrega muchas otras pequeñas características que mejoran la productividad del
desarrollador, tanto para escribir como para leer código:

Expresiones new con tipo de destino

Funciones anónimas static
Expresiones condicionales con tipo de destino
Compatibilidad con extensiones GetEnumerator() para bucles foreach
Las expresiones lambda pueden declarar parámetros de descarte
Los atributos se pueden aplicar a las funciones locales

La versión C# 9 continúa el trabajo para hacer que C# siga siendo un lenguaje de
programación moderno y de uso general. Las características siguen siendo compatibles
con cargas de trabajo y tipos de aplicación modernos.

C# versión 8.0
Fecha de publicación septiembre de 2019

C# 8.0 es la primera versión C# principal que tiene como destino específicamente .NET
Core. Algunas características se basan en nuevas funcionalidades de CLR, otras en tipos
de biblioteca agregados solo a .NET Core. C# 8.0 agrega las siguientes características y
mejoras al lenguaje C#:

Miembros de solo lectura

Métodos de interfaz predeterminados
Mejoras de coincidencia de patrones:
Expresiones switch
Patrones de propiedades
Patrones de tupla
Patrones posicionales
Declaraciones using
Funciones locales estáticas
Estructuras ref descartables
Tipos de referencia que aceptan valores null
Secuencias asincrónicas
Índices y rangos
Asignación de uso combinado de NULL
Tipos construidos no administrados
 Stackalloc en expresiones anidadas
Mejora de las cadenas textuales interpoladas

Los miembros de interfaz predeterminados requieren mejoras en CLR. Estas

características se agregaron en CLR para .NET Core 3.0. Los intervalos y los índices, y los
flujos asincrónicos requieren nuevos tipos en las bibliotecas de .NET Core 3.0. Los tipos
de referencia que aceptan valores NULL, aunque se implementan en el compilador, son
mucho más útiles cuando se anotan bibliotecas para proporcionar información
semántica relativa al estado NULL de los argumentos y los valores devueltos. Esas
anotaciones se agregan a las bibliotecas de .NET Core.

C# versión 7.3
Fecha de publicación mayo de 2018

Hay dos temas principales para la versión C# 7.3. Un tema proporciona características
que permiten al código seguro ser tan eficaz como el código no seguro. El segundo
tema proporciona mejoras incrementales en las características existentes. También se
han agregado nuevas opciones de compilador en esta versión.

Las siguientes características nuevas admiten el tema del mejor rendimiento para código
seguro:

Puede tener acceso a campos fijos sin anclar.

Puede volver a asignar variables locales ref .
Puede usar inicializadores en matrices stackalloc .
Puede usar instrucciones fixed con cualquier tipo que admita un patrón.
Puede usar restricciones más genéricas.

Se hicieron las mejoras siguientes a las características existentes:

Puede probar == y != con los tipos de tupla.

Puede usar variables de expresión en más ubicaciones.
Puede asociar atributos al campo de respaldo de las propiedades
autoimplementadas.
Se ha mejorado la resolución de métodos cuando los argumentos difieren por in .
Ahora, la resolución de sobrecarga tiene menos casos ambiguos.

Las nuevas opciones del compilador son:

-publicsign para habilitar la firma de ensamblados de software de código abierto

(OSS).
-pathmap para proporcionar una asignación para los directorios de origen.
C# versión 7.2
Fecha de publicación noviembre de 2017

C#7.2 agregó varias características de lenguaje pequeñas:

Inicializadores en matrices  stackalloc .

Uso de instrucciones  fixed con cualquier tipo que admita un patrón.
Acceso campos fijos sin anclar.
Reasignación de variables locales  ref .
Declaración de tipos readonly struct para indicar que una estructura es fija y que
debería pasarse como parámetro in a los métodos de su miembro.
Incorporación del modificador in en los parámetros para especificar que un
argumento se pasa mediante una referencia sin que el método al que se realiza
una llamada lo modifique.
Uso del modificador ref readonly en las devoluciones de método para indicar que
un método devuelve su valor mediante una referencia, pero que no permite
operaciones de escritura en el objeto.
Declaración de tipos ref struct para indicar que un tipo de estructura tiene
acceso directo a la memoria administrada y que siempre debe estar asignada a la
pila.
Uso de restricciones genéricas adicionales.
Argumentos con nombre no finales
Los argumentos con nombre pueden ir seguidos de argumentos posicionales.
Caracteres de subrayado iniciales en literales numéricos
Los literales numéricos ahora pueden tener caracteres de subrayado iniciales
antes de los dígitos impresos.
Modificador de acceso private protected
El modificador de acceso private protected permite el acceso de clases
derivadas en el mismo ensamblado.
Expresiones ref condicionales
El resultado de una expresión condicional ( ?: ) ahora puede ser una referencia.

C# versión 7.1
Fecha de publicación agosto de 2017

C# empezó a publicar versiones de punto con C# 7.1. Esta versión agregó el elemento de
configuración de selección de versión de lenguaje, tres nuevas características de
lenguaje y un nuevo comportamiento del compilador.
Las nuevas características de lenguaje de esta versión son las siguientes:

asyncMain method
El punto de entrada de una aplicación puede tener el modificador async .
Expresiones literales default
Se pueden usar expresiones literales predeterminadas en expresiones de valor
predeterminadas cuando el tipo de destino se pueda inferir.
Nombres de elementos de tupla inferidos
En muchos casos, los nombres de elementos de tupla se pueden deducir de la
inicialización de la tupla.
Coincidencia de patrones en parámetros de tipo genérico
Puede usar expresiones de coincidencia de patrones en variables cuyo tipo es
un parámetro de tipo genérico.

Por último, el compilador tiene dos opciones, -refout y -refonly, que controlan la
generación de ensamblados de referencia.

C# versión 7.0
Fecha de publicación marzo de 2017

C# versión 7.0 se comercializó con Visual Studio 2017. Esta versión tiene algunas cosas

interesantes y evolutivas en la misma línea que C# 6.0. Estas son algunas de las nuevas
características:

Variables out
Tuplas y deconstrucción
Coincidencia de patrones
Funciones locales
Miembros con forma de expresión expandidos
Variables locales de tipo ref
Devoluciones de referencias

Otras características incluidas:

Descartes
Literales binarios y separadores de dígitos
Expresiones throw

Todas estas características ofrecen capacidades nuevas para los desarrolladores y la

posibilidad de escribir un código de manera más clara que nunca. De manera destacada,
condensan la declaración de variables que se van a usar con la palabra clave out y
permiten varios valores devueltos a través de tuplas. .NET Core ahora tiene como
destino cualquier sistema operativo y tiene puesta la mirada en la nube y la
portabilidad. Por supuesto, esas nuevas capacidades ocupan las ideas y el tiempo de los
diseñadores de lenguaje, además de ofrecer nuevas características.

C# versión 6.0
Fecha de publicación julio de 2015

Versión 6.0, publicada con Visual Studio 2015, lanzó muchas características más
pequeñas que hicieron que la programación de C# sea más productiva. Estas son
algunas de ellas:

Importaciones estáticas
Filtros de excepciones
Inicializadores de propiedades automáticas
Miembros de cuerpo de expresión
Propagador de null
Interpolación de cadenas
operador nameof

Entre las otras características nuevas se incluyen estas:

Inicializadores de índice
Await en bloques catch y finally
Valores predeterminados para las propiedades solo de captador

Cada una de estas características es interesante en sí misma. Pero si las observamos en

su conjunto, vemos un patrón interesante. En esta versión, C# comenzó a eliminar el
lenguaje reutilizable para que el código sea más breve y legible. Así que, para los que
adoran el código simple y limpio, esta versión del lenguaje fue una gran aportación.

En esta versión también se hizo otra cosa, aunque no es una característica de lenguaje
tradicional: publicaron el compilador Roslyn como un servicio . Ahora, el compilador
de C# está escrito en C# y puede usarlo como parte de su trabajo de programación.

C# versión 5.0
Fecha de publicación agosto de 2012

La versión 5.0 de C#, publicada con Visual Studio 2012, era una versión centrada del
lenguaje. Casi todo el trabajo de esa versión se centró en otro concepto de lenguaje
innovador: el modelo async y await para la programación asincrónica. Estas son las
principales características:

Miembros asincrónicos
Atributos de información del llamador
Proyecto de código: Atributos de información del autor de llamada en C# 5.0

El atributo de información del autor de la llamada permite recuperar fácilmente

información sobre el contexto donde se está ejecutando sin tener que recurrir a una
gran cantidad de código de reflexión reutilizable. Tiene muchos usos en tareas de
registro y diagnóstico.

Pero async y await son los auténticos protagonistas de esta versión. Cuando estas
características salieron a la luz en 2012, C# cambió de nuevo las reglas del juego al
integrar la asincronía en el lenguaje como un participante de primera clase. Si alguna
vez ha trabajado con operaciones de larga duración y la implementación de sitios web
de devoluciones de llamada, probablemente le haya encantado esta característica del
lenguaje.

C# versión 4.0
Fecha de publicación abril de 2010

La versión 4.0 de C#, publicada con Visual Studio 2010, tuvo que lidiar con el carácter
innovador que había adquirido la versión 3.0. Esta versión introdujo algunas
características nuevas interesantes:

Enlace dinámico
Argumentos opcionales/con nombre
Covariante y contravariante de genéricos
Tipos de interoperabilidad insertados

Los tipos de interoperabilidad incrustados facilitaron el problema de implementación de

crear ensamblados de interoperabilidad COM para la aplicación. La covarianza y
contravarianza de genéricos proporcionan más capacidad para usar genéricos, pero son
más bien académicos y probablemente más valorados por autores de bibliotecas y
Framework. Los parámetros opcionales y con nombre permiten eliminar muchas
sobrecargas de métodos y proporcionan mayor comodidad. Pero ninguna de esas
características está modificando el paradigma exactamente.

La característica más importante fue la introducción de la palabra clave dynamic . Con la

palabra clave dynamic , en la versión 4.0 de C# se introdujo la capacidad de invalidar el
compilador durante la escritura en tiempo de compilación. Al usar la palabra clave
dinámica, puede crear constructos similares a los lenguajes tipados dinámicamente,
como JavaScript. Puede crear dynamic x = "a string" y luego agregarle seis, dejando
que el runtime decida qué debería suceder después.

Los enlaces dinámicos pueden dar lugar a errores, pero también otorgan un gran poder
sobre el lenguaje.

C# versión 3.0
Fecha de publicación noviembre de 2007

La versión 3.0 de C# llegó a finales de 2007, junto con Visual Studio 2008, aunque la
cartera completa de características de lenguaje no llegaría realmente hasta la versión 3.5
de .NET Framework. Esta versión marcó un cambio importante en el crecimiento de C#.
Estableció C# como un lenguaje de programación realmente formidable. Echemos un
vistazo a algunas de las principales características de esta versión:

Propiedades implementadas automáticamente

Tipos anónimos (Guía de programación de C#).
Expresiones de consulta
Expresiones lambda
Árboles de expresión
Métodos de extensión
Variables locales con asignación implícita de tipos
Métodos parciales
Inicializadores de objeto y colección

En retrospectiva, muchas de estas características parecen inevitables e indivisibles. Todas

ellas encajan estratégicamente. Se considera que la mejor característica de la versión de
C# fue la expresión de consulta, también conocida como Language-Integrated Query
(LINQ).

Una vista más matizada examina árboles de expresión, expresiones lambda y tipos
anónimos como la base sobre la que se construye LINQ. Sin embargo, en cualquier caso,
C# 3.0 presentó un concepto revolucionario. C# 3.0 había comenzado a sentar las bases
para convertir C# en un lenguaje híbrido funcional y orientado a objetos.

En concreto, permitía escribir consultas declarativas en estilo de SQL para realizar

operaciones en colecciones, entre otras cosas. En lugar de escribir un bucle de for para
calcular el promedio de una lista de enteros, permitía hacerlo fácilmente como
list.Average() . La combinación de métodos de extensión y expresiones de consulta

hizo que esa lista de enteros fuera mucho más inteligente.

C# versión 2.0
Fecha de publicación noviembre de 2005

Echemos un vistazo a algunas de las principales características de C# 2.0, que se publicó

en 2005 junto con Visual Studio 2005:

Genéricos
Tipos parciales
Métodos anónimos
Tipos de valores que aceptan valores NULL
Iteradores
Covarianza y contravarianza

Otras características de C# 2.0 agregaron capacidades a las características existentes:

Accesibilidad independiente de captador o establecedor

Conversiones de grupos de métodos (delegados)
Clases estáticas
Inferencia de delegados

Aunque puede que C# haya comenzado como un lenguaje genérico orientado a

objetos, la versión 2.0 de C# cambió esto enseguida. Con los genéricos, los tipos y
métodos pueden operar en un tipo arbitrario a la vez que conservan la seguridad de
tipos. Por ejemplo, tener List<T> nos permite tener List<string> o List<int> y realizar
operaciones de tipo seguro en esas cadenas o en enteros mientras los recorremos en
iteración. Es mejor usar genéricos que crear un tipo ListInt que derive de ArrayList o
convertir desde Object en cada operación.

C# 2.0 incorporó los iteradores. Para explicarlo brevemente, los iteradores permiten
examinar todos los elementos de List (u otros tipos enumerables) con un bucle de
foreach . Tener iteradores como una parte de primera clase del lenguaje mejoró

drásticamente la facilidad de lectura del lenguaje y la capacidad de las personas de

razonar sobre el código.

Aun así, C# seguía yendo por detrás de Java. Java ya había publicado versiones que
incluían genéricos e iteradores. Pero esto cambiaría pronto a medida que los idiomas
siguieran evolucionando.
Versión 1.2 de C#
Fecha de publicación abril de 2003

Versión 1.2 de C# incluida en Visual Studio .NET 2003. Contenía algunas pequeñas
mejoras del lenguaje. Lo más notable es que, a partir de esa versión, el código se
generaba en un bucle foreach llamado Dispose en un IEnumerator cuando ese
IEnumerator implementaba IDisposable.

C# versión 1.0
Fecha de publicación enero de 2002

Si echa la vista atrás, la versión 1.0 de C#, publicada con Visual Studio .NET 2002, se
parecía mucho a Java. Como parte de sus objetivos de diseño declarados para ECMA ,
buscaba ser un “lenguaje sencillo, moderno, orientado a objetos y de uso general”. En
aquella época, parecerse a Java suponía conseguir esos primeros objetivos de diseño.

Pero si volvemos a echarle un vistazo a C# 1.0 ahora, no lo verá tan claro. Carecía de
capacidades asincrónicas integradas y de algunas funcionalidades útiles de genéricos
que se dan por sentado. De hecho, carecía por completo de genéricos. ¿Y LINQ? Aún no
estaba disponible. Esas características tardarían unos años más en agregarse.

C# 1.0 parecía estar privado de características, en comparación con la actualidad. Lo

normal era tener que escribir código detallado. Pero aun así, hay que empezar por algo.
C# 1.0 era una alternativa viable a Java en la plataforma Windows.

Las principales características de C# 1.0 incluían lo siguiente:

Clases
Structs
Interfaces
Eventos
Propiedades
Delegados
Operadores y expresiones
Instrucciones
Atributos

Artículopublicado originalmente en el blog de NDepend , por cortesía de Erik Dietrich y

Patrick Smacchia.
Relaciones entre características de
lenguaje y tipos de biblioteca
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La definición del lenguaje C# exige que una biblioteca estándar tenga determinados
tipos y determinados miembros accesibles en esos tipos. El compilador genera código
que usa estos miembros y tipos necesarios para muchas características de lenguaje
diferentes. En caso necesario, hay paquetes NuGet que contienen tipos necesarios para
las versiones más recientes del lenguaje al escribir código para entornos donde esos
tipos o miembros aún no se han implementado.

Esta dependencia de la funcionalidad de la biblioteca estándar ha formado parte del

lenguaje C# desde su primera versión. En esa versión, los ejemplos incluían:

Exception: usado para todas las excepciones generadas por el compilador.

String: el tipo string de C# es sinónimo de String.
Int32: sinónimo de int .

Esa primera versión era simple: el compilador y la biblioteca estándar se distribuían

juntos y solo había una versión de cada uno.

Las versiones posteriores de C# a veces han agregado nuevos tipos o miembros a las
dependencias. Los ejemplos incluyen: INotifyCompletion, CallerFilePathAttribute y
CallerMemberNameAttribute. C# 7.0 continúa esta tendencia al agregar una
dependencia a ValueTuple para implementar la característica de lenguaje tuplas.

El equipo de diseño del lenguaje se esfuerza por minimizar el área expuesta de los tipos
y miembros necesarios en una biblioteca estándar compatible. Ese objetivo está
equilibrado con un diseño limpio donde las nuevas características de la biblioteca se
han incorporado sin problemas al lenguaje. Habrá nuevas características en versiones
futuras de C# que exijan nuevos tipos y miembros en una biblioteca estándar. Es
importante entender cómo administrar esas dependencias en el trabajo.

Administración de dependencias
Las herramientas del compilador de C# ahora se han desvinculado del ciclo de versiones
de las bibliotecas de .NET en las plataformas compatibles. De hecho, las distintas
bibliotecas de .NET tienen ciclos de versiones diferentes: .NET Framework en Windows
se distribuye como una actualización de Windows, .NET Core se distribuye conforme a
una programación independiente y las versiones de Xamarin de actualizaciones de la
biblioteca se incluyen en las herramientas de Xamarin de cada plataforma de destino.

En la mayoría de las ocasiones estos cambios no son perceptibles. Pero cuando trabaje
con una versión más reciente del lenguaje que requiera características aún no incluidas
en las bibliotecas de .NET de esa plataforma, haga referencia a los paquetes NuGet para
proporcionar esos nuevos tipos.
A medida que las plataformas que admite la aplicación
se actualicen con las nuevas instalaciones del marco de trabajo, puede quitar la
referencia adicional.

Esta desvinculación significa que puede usar nuevas características de lenguaje aun
cuando el destino sean equipos que no tengan el marco de trabajo correspondiente.
Consideraciones sobre versiones y
actualizaciones para desarrolladores de
C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La compatibilidad es un objetivo muy importante cuando se agregan nuevas

características al lenguaje C#. En la mayoría de los casos, se puede volver a compilar el
código existente con una nueva versión de compilador sin ningún problema.

Al adoptar nuevas características del lenguaje en una biblioteca, puede requerirse más
atención. Puede crear una biblioteca con características que se encuentran en la última
versión y necesita asegurarse de que las aplicaciones creadas con versiones anteriores
del compilador pueden usarla. O bien puede actualizar una biblioteca existente, con la
posibilidad de que muchos de los usuarios aún no tengan versiones actualizadas.
Cuando tome decisiones sobre la adopción de nuevas características, deberá tener en
cuenta dos variaciones de compatibilidad: la compatibilidad binaria y la compatibilidad
con el origen.

Cambios compatibles con elementos binarios

Los cambios en la biblioteca son compatibles con elementos binarios cuando se puede
usar la biblioteca actualizada sin necesidad de recompilar las aplicaciones y las
bibliotecas que la usan. No es necesario volver a compilar ensamblados dependientes ni
realizar ningún cambio en el código fuente.

Cambios compatibles con el origen

Los cambios en la biblioteca son compatibles con el origen cuando las aplicaciones y
las bibliotecas que usan la biblioteca no requieren cambios en el código fuente, pero el
origen debe recompilarse con la nueva versión para que funcione correctamente.

Cambios incompatibles
Si un cambio no es compatible con el origen ni compatible con elementos binarios, se
necesitan cambios en el código fuente junto con la recompilación en las bibliotecas y las
aplicaciones dependientes.
Evaluar la biblioteca
Estos conceptos de compatibilidad afectan a las declaraciones públicas y protegidas de
la biblioteca, no a su implementación interna. La adopción interna de nuevas
características siempre es compatible con elementos binarios.

Los cambios compatibles con elementos binarios proporcionan la nueva sintaxis que
genera el mismo código compilado para las declaraciones públicas que la sintaxis
anterior. Por ejemplo, cambiar un método a un miembro con cuerpo de expresión es un
cambio compatible con elementos binarios:

Código original:

C#

public double CalculateSquare(double value)

return value * value;

Nuevo código:

C#

public double CalculateSquare(double value) => value * value;

Los cambios compatibles con el origen presentan sintaxis que cambia el código
compilado para un miembro público, pero de una forma compatible con los sitios de
llamada existentes. Por ejemplo, cambiar una firma de método de un parámetro por
valor a un parámetro por referencia in es compatible con el origen, pero no con
elementos binarios:

Código original:

C#

public double CalculateSquare(double value) => value * value;

Nuevo código:

C#

public double CalculateSquare(in double value) => value * value;

En el artículo de novedades, observe si la inclusión de una característica que afecta a las

declaraciones públicas es compatible con el origen o con elementos binarios.
Tutorial: Exploración de la característica
de C# 11: miembros virtuales estáticos
en interfaces
Artículo • 28/11/2022 • Tiempo de lectura: 8 minutos

C# 11 y .NET 7 incluyen miembros virtuales estáticos en interfaces. Esta característica

permite definir interfaces que incluyan operadores sobrecargados u otros miembros
estáticos. Una vez que haya definido interfaces con miembros estáticos, puede usar esas
interfaces como restricciones para crear tipos genéricos que usen operadores u otros
métodos estáticos. Incluso si no crea interfaces con operadores sobrecargados, es
probable que se beneficie de esta característica y de las clases matemáticas genéricas
habilitadas por la actualización de idioma.

En este tutorial, aprenderá a:

＂ Definir interfaces con miembros estáticos.

＂ Use interfaces para definir clases que implementan interfaces con operadores
definidos.
＂ Cree algoritmos genéricos que se basen en métodos de interfaz estática.

Prerrequisitos
Deberá configurar la máquina para ejecutar .NET 7, que admite C# 11. El compilador de
C# 11 está disponible a partir de Visual Studio 2022, versión 17.3 o el SDK de .NET
7 .

Métodos de interfaz abstracta estática

Comencemos con un ejemplo. El método siguiente devuelve el punto medio de dos
double números:

C#

public static double MidPoint(double left, double right) =>

(left + right) / (2.0);

La misma lógica funcionaría para cualquier tipo numérico: int , short , long ,
float decimal o cualquier tipo que represente un número. Debe tener una manera de
usar los + operadores y / y para definir un valor para 2 . Puede usar la
System.Numerics.INumber<TSelf> interfaz para escribir el método anterior como
método genérico siguiente:

C#

public static T MidPoint<T>(T left, T right)

where T : INumber<T> => (left + right) / T.CreateChecked(2); // note:

the addition of left and right may overflow here; it's just for
demonstration purposes

Cualquier tipo que implemente la INumber<TSelf> interfaz debe incluir una definición
para operator + y para operator / . El denominador se define mediante
T.CreateChecked(2) para crear el valor 2 de cualquier tipo numérico, lo que obliga al

denominador a ser el mismo tipo que los dos parámetros.

INumberBase<TSelf>.CreateChecked<TOther>(TOther) crea una instancia del tipo a
partir del valor especificado y produce un OverflowException si el valor está fuera del
intervalo que se puede representar. (Esta implementación tiene la posibilidad de
desbordamiento si left y right son valores suficientes grandes. Hay algoritmos
alternativos que pueden evitar este posible problema).

Los miembros abstractos estáticos se definen en una interfaz con una sintaxis conocida:
se agregan los static modificadores y abstract a cualquier miembro estático que no
proporcione una implementación. En el ejemplo siguiente se define una IGetNext<T>
interfaz que se puede aplicar a cualquier tipo que invalide operator ++ :

C#

public interface IGetNext<T> where T : IGetNext<T>

static abstract T operator ++(T other);

La restricción que implementa IGetNext<T> el argumento type, T , garantiza que la firma

del operador incluya el tipo contenedor o su argumento type. Muchos operadores
aplican que sus parámetros deben coincidir con el tipo o ser el parámetro de tipo
restringido para implementar el tipo contenedor. Sin esta restricción, el ++ operador no
se pudo definir en la IGetNext<T> interfaz .

Puede crear una estructura que cree una cadena de caracteres "A", donde cada
incremento agrega otro carácter a la cadena mediante el código siguiente:

C#
 public struct RepeatSequence : IGetNext<RepeatSequence>

private const char Ch = 'A';

public string Text = new string(Ch, 1);

public RepeatSequence() {}

public static RepeatSequence operator ++(RepeatSequence other)

=> other with { Text = other.Text + Ch };

public override string ToString() => Text;

Por lo general, puede crear cualquier algoritmo en el que quiera definir ++ para que
"genere el siguiente valor de este tipo". El uso de esta interfaz genera código y
resultados claros:

C#

var str = new RepeatSequence();

for (int i = 0; i < 10; i++)

Console.WriteLine(str++);

En el ejemplo anterior se genera la siguiente salida:

PowerShell

AA

AAA

AAAA

AAAAA

AAAAAA

AAAAAAA

AAAAAAAA

AAAAAAAAA

AAAAAAAAAA

En este pequeño ejemplo se muestra la motivación de esta característica. Puede usar la

sintaxis natural para operadores, valores constantes y otras operaciones estáticas. Puede
explorar estas técnicas al crear varios tipos que dependen de miembros estáticos,
incluidos los operadores sobrecargados. Defina las interfaces que coincidan con las
funcionalidades de los tipos y, a continuación, declare la compatibilidad de esos tipos
con la nueva interfaz.
Matemáticas genéricas
El escenario motivador para permitir métodos estáticos, incluidos los operadores, en
interfaces es admitir algoritmos matemáticos genéricos . La biblioteca de clases base de
.NET 7 contiene definiciones de interfaz para muchos operadores aritméticos y
interfaces derivadas que combinan muchos operadores aritméticos en una INumber<T>
interfaz. Vamos a aplicar esos tipos para crear un Point<T> registro que pueda usar
cualquier tipo numérico para T . Algunos pueden mover XOffset el punto y YOffset
usar el + operador .

Empiece por crear una nueva aplicación de consola, ya sea mediante dotnet new o
Visual Studio. Establezca la versión del lenguaje C# en "versión preliminar", que habilita
las características en versión preliminar de C# 11. Agregue el siguiente elemento al
archivo csproj dentro de un <PropertyGroup> elemento :

XML

<LangVersion>preview</LangVersion>

７ Nota

Este elemento no se puede establecer mediante la interfaz de usuario de Visual

Studio. Debe editar el archivo del proyecto directamente.

La interfaz pública de Translation<T> y Point<T> debe tener un aspecto similar al

código siguiente:

C#

// Note: Not complete. This won't compile yet.

public record Translation<T>(T XOffset, T YOffset);

public record Point<T>(T X, T Y)

public static Point<T> operator +(Point<T> left, Translation<T> right);

Use el record tipo para los Translation<T> tipos y Point<T> : ambos almacenan dos
valores y representan el almacenamiento de datos en lugar de un comportamiento
sofisticado. La implementación de operator + tendría el siguiente aspecto:

C#
 public static Point<T> operator +(Point<T> left, Translation<T> right) =>

left with { X = left.X + right.XOffset, Y = left.Y + right.YOffset };

Para que el código anterior se compile, deberá declarar que T admite la

IAdditionOperators<TSelf, TOther, TResult> interfaz . Esa interfaz incluye el operator +

método estático. Declara tres parámetros de tipo: uno para el operando izquierdo, otro
para el operando derecho y otro para el resultado. Algunos tipos implementan + para
diferentes operandos y tipos de resultado. Agregue una declaración que el argumento
type implemente T IAdditionOperators<T, T, T> :

C#

public record Point<T>(T X, T Y) where T : IAdditionOperators<T, T, T>

Después de agregar esa restricción, la Point<T> clase puede usar para + su operador de
suma. Agregue la misma restricción en la Translation<T> declaración:

C#

public record Translation<T>(T XOffset, T YOffset) where T :

IAdditionOperators<T, T, T>;

La IAdditionOperators<T, T, T> restricción impide que un desarrollador use la clase

para crear un Translation mediante un tipo que no cumpla la restricción para la adición
a un punto. Ha agregado las restricciones necesarias al parámetro de tipo para
Translation<T> y Point<T> , por tanto, este código funciona. Puede probar agregando

código como el siguiente en las declaraciones de Translation y Point en el archivo

Program.cs :

C#

var pt = new Point<int>(3, 4);

var translate = new Translation<int>(5, 10);

var final = pt + translate;

Console.WriteLine(pt);

Console.WriteLine(translate);

Console.WriteLine(final);

Puede hacer que este código sea más reutilizable declarando que estos tipos
implementan las interfaces aritméticas adecuadas. El primer cambio que se va a realizar
es declarar que Point<T, T> implementa la IAdditionOperators<Point<T>,
Translation<T>, Point<T>> interfaz . El Point tipo usa diferentes tipos para operandos y

el resultado. El Point tipo ya implementa un operator + con esa firma, por lo que
agregar la interfaz a la declaración es todo lo que necesita:

C#

public record Point<T>(T X, T Y) : IAdditionOperators<Point<T>,

Translation<T>, Point<T>>

where T : IAdditionOperators<T, T, T>

Por último, al realizar la adición, resulta útil tener una propiedad que defina el valor de
identidad aditivo para ese tipo. Hay una nueva interfaz para esa característica:
IAdditiveIdentity<TSelf,TResult>. Una traducción de {0, 0} es la identidad de adición: el
punto resultante es el mismo que el operando izquierdo. La IAdditiveIdentity<TSelf,
TResult> interfaz define una propiedad readonly, AdditiveIdentity , que devuelve el

valor de identidad. Necesita Translation<T> algunos cambios para implementar esta

interfaz:

C#

using System.Numerics;

public record Translation<T>(T XOffset, T YOffset) :

IAdditiveIdentity<Translation<T>, Translation<T>>

where T : IAdditionOperators<T, T, T>, IAdditiveIdentity<T, T>

{

public static Translation<T> AdditiveIdentity =>

new Translation<T>(XOffset: T.AdditiveIdentity, YOffset:

T.AdditiveIdentity);

Hay algunos cambios aquí, así que vamos a recorrerlos uno por uno. En primer lugar,
declara que el Translation tipo implementa la IAdditiveIdentity interfaz :

C#

public record Translation<T>(T XOffset, T YOffset) :

IAdditiveIdentity<Translation<T>, Translation<T>>

A continuación, podría intentar implementar el miembro de interfaz tal y como se

muestra en el código siguiente:

C#
 public static Translation<T> AdditiveIdentity =>

new Translation<T>(XOffset: 0, YOffset: 0);

El código anterior no se compilará, ya que 0 depende del tipo . La respuesta: Use

IAdditiveIdentity<T>.AdditiveIdentity para 0 . Este cambio significa que las
restricciones deben incluir ahora que T implementa IAdditiveIdentity<T> . Esto da
como resultado la siguiente implementación:

C#

public static Translation<T> AdditiveIdentity =>

new Translation<T>(XOffset: T.AdditiveIdentity, YOffset:

T.AdditiveIdentity);

Ahora que ha agregado esa restricción en Translation<T> , debe agregar la misma

restricción a Point<T> :

C#

using System.Numerics;

public record Point<T>(T X, T Y) : IAdditionOperators<Point<T>,

Translation<T>, Point<T>>

where T : IAdditionOperators<T, T, T>, IAdditiveIdentity<T, T>

{

public static Point<T> operator +(Point<T> left, Translation<T> right)

=>

left with { X = left.X + right.XOffset, Y = left.Y + right.YOffset

};

Este ejemplo le ha dado un vistazo a cómo las interfaces de redacción matemática

genérica. Ha aprendido a:

＂ Escriba un método que dependa de la INumber<T> interfaz para que se pueda usar
con cualquier tipo numérico.
＂ Cree un tipo que se base en las interfaces de adición para implementar un tipo que
solo admita una operación matemática.
Ese tipo declara su compatibilidad con esas
mismas interfaces para que se pueda componer de otras maneras. Los algoritmos
se escriben con la sintaxis más natural de los operadores matemáticos.

Experimente con estas características y registre los comentarios. Puede usar el elemento
de menú Enviar comentarios en Visual Studio o crear un nuevo problema en el
repositorio roslyn en GitHub. Compile algoritmos genéricos que funcionen con
cualquier tipo numérico. Compile algoritmos con estas interfaces en las que el
argumento type solo pueda implementar un subconjunto de funcionalidades de tipo
numérico. Aunque no cree nuevas interfaces que usen estas funcionalidades, puede
experimentar con ellas en los algoritmos.

Vea también
Matemáticas genéricas
Creación de tipos de registros
Artículo • 18/01/2023 • Tiempo de lectura: 13 minutos

C# 9 incorpora registros, un nuevo tipo de referencia que se puede crear en lugar de
clases o structs. C# 10 agrega estructuras de registro para que pueda definir registros
como tipos de valor. Los registros se diferencian de las clases en que los tipos de
registros usan igualdad basada en valores. Dos variables de un tipo de registro son
iguales si las definiciones del tipo de registro son idénticas y si, en cada campo, los
valores de ambos registros son iguales. Dos variables de un tipo de clase son iguales si
los objetos a los que se hace referencia son el mismo tipo de clase y las variables hacen
referencia al mismo objeto. La igualdad basada en valores conlleva otras capacidades
que probablemente quiera en los tipos de registros. El compilador genera muchos de
esos miembros al declarar un elemento record en lugar de class . El compilador genera
esos mismos métodos para los tipos record struct .

En este tutorial, aprenderá a:

＂ Decidir si debe declarar un elemento class o record .

＂ Declarar tipos de registros y tipos de registros posicionales.
＂ Reemplazar los métodos por métodos generados por el compilador en los
registros.

Prerrequisitos
Tendrá que configurar la máquina para ejecutar .NET 6 o versiones posteriores, incluido
el compilador de C# 10 o versiones posteriores. El compilador de C# 10 está disponible
a partir de Visual Studio 2022 o del SDK de .NET 6 .

Características de los registros

Un registro se define al declarar un tipo con la palabra clave record en lugar de class o
struct . Opcionalmente, puede declarar un objeto record class para aclarar que es un
tipo de referencia. Un registro es un tipo de referencia y sigue la semántica de la
igualdad basada en valores. Puede definir un objeto record struct para crear un
registro que sea un tipo de valor. Para aplicar la semántica de valores, el compilador
genera varios métodos para el tipo de registro (para los tipos record class y record
struct ):

Una invalidación de Object.Equals(Object).

 Un método Equals virtual cuyo parámetro es el tipo de registro.
Una invalidación de Object.GetHashCode().
Métodos para operator == y operator != .
Los tipos de registros implementan System.IEquatable<T>.

Los registros también proporcionan una invalidación de Object.ToString(). El compilador

sintetiza métodos para mostrar registros mediante Object.ToString(). Va a examinar esos
miembros a medida que escribe el código de este tutorial. Los registros admiten
expresiones with para habilitar la mutación no destructiva de registros.

También puede declarar registros posicionales mediante una sintaxis más concisa. El
compilador sintetiza más métodos automáticamente cuando se declaran registros
posicionales:

Un constructor primario cuyos parámetros coinciden con los parámetros

posicionales en la declaración del registro.
Propiedades públicas para cada parámetro de un constructor primario. Estas
propiedades son de solo inicialización para los tipos record class y readonly
record struct . Para los tipos record struct , son de lectura y escritura.

Un método Deconstruct para extraer propiedades del registro.

Compilación de datos de temperatura

Los datos y las estadísticas se encuentran entre los escenarios en los que se recomienda
usar registros. En este tutorial va a compilar una aplicación que calcula grados día para
distintos usos. Los grados día son una medida de calor (o falta de él) a lo largo de un
período de días, semanas o meses. Los grados día realizan un seguimiento del uso
energético y lo predicen. Más días más cálidos significan más aire acondicionado,
mientras que más días más fríos implican un mayor uso de calefacción. Los grados día
resultan útiles para administrar la población vegetal y poner en correlación su
crecimiento a medida que cambiamos de estación. Los grados día ayudan a realizar un
seguimiento de las migraciones animales de especies que se desplazan según el clima.

La fórmula se basa en la temperatura media de un día determinado y una temperatura

de base de referencia. Para calcular los grados día a lo largo del tiempo, necesita la
temperatura mínima y máxima de cada día durante un período de tiempo. Comencemos
por crear una nueva aplicación. Cree una nueva aplicación de consola. Cree un nuevo
tipo de registro en un nuevo archivo denominado "DailyTemperature.cs":

C#
 public readonly record struct DailyTemperature(double HighTemp, double
LowTemp);

El código anterior define un registro posicional. El registro DailyTemperature es un

objeto readonly record struct , porque el objeto no se hereda de él y debe ser
inmutable. Las propiedades HighTemp y LowTemp son propiedades de solo inicialización, lo
que significa que se pueden establecer en el constructor o mediante un inicializador de
propiedad. Si quiere que los parámetros posicionales sean de lectura y escritura, declare
record struct en lugar de readonly record struct . El tipo DailyTemperature también

tiene un constructor primario con dos parámetros que coinciden con las dos
propiedades. Use el constructor primario para inicializar un registro DailyTemperature .
En el código siguiente se crea e inicializa varios registros DailyTemperature . El primero
usa parámetros con nombre para aclarar HighTemp y LowTemp . Los inicializadores
restantes usan parámetros posicionales para inicializar HighTemp y LowTemp :

C#

private static DailyTemperature[] data = new DailyTemperature[]

new DailyTemperature(HighTemp: 57, LowTemp: 30),

new DailyTemperature(60, 35),

new DailyTemperature(63, 33),

new DailyTemperature(68, 29),

new DailyTemperature(72, 47),

new DailyTemperature(75, 55),

new DailyTemperature(77, 55),

new DailyTemperature(72, 58),

new DailyTemperature(70, 47),

new DailyTemperature(77, 59),

new DailyTemperature(85, 65),

new DailyTemperature(87, 65),

new DailyTemperature(85, 72),

new DailyTemperature(83, 68),

new DailyTemperature(77, 65),

new DailyTemperature(72, 58),

new DailyTemperature(77, 55),

new DailyTemperature(76, 53),

new DailyTemperature(80, 60),

new DailyTemperature(85, 66)

};

Puede agregar sus propias propiedades o métodos a los registros, incluidos los registros
posicionales. Tiene que calcular la temperatura media de cada día. Puede agregar esa
propiedad al registro DailyTemperature :

C#
 public readonly record struct DailyTemperature(double HighTemp, double
LowTemp)

public double Mean => (HighTemp + LowTemp) / 2.0;

Vamos a asegurarnos de que puede usar estos datos. Agregue el código siguiente al
método Main :

C#

foreach (var item in data)

Console.WriteLine(item);

Ejecute la aplicación y verá un resultado similar a la siguiente pantalla (se han quitado
varias filas por motivos de espacio):

CLI de .NET

DailyTemperature { HighTemp = 57, LowTemp = 30, Mean = 43.5 }

DailyTemperature { HighTemp = 60, LowTemp = 35, Mean = 47.5 }

DailyTemperature { HighTemp = 80, LowTemp = 60, Mean = 70 }

DailyTemperature { HighTemp = 85, LowTemp = 66, Mean = 75.5 }

El código anterior muestra el resultado de la invalidación de ToString sintetizada por el

compilador. Si prefiere otro texto, puede escribir una versión propia de ToString que
impida al compilador sintetizar otra para el usuario.

Cálculo de grados día

Para calcular los grados día, tome la diferencia entre una temperatura de base de
referencia y la temperatura media de un día determinado. Para medir el calor a lo largo
del tiempo, descarte todos los días en los que la temperatura media esté por debajo de
la base de referencia. Para medir el frío a lo largo del tiempo, descarte todos los días en
los que la temperatura media esté por encima de la base de referencia. Por ejemplo, en
EE. UU. se usa 65F como base de los grados del día de calefacción y refrigeración. Esa es
la temperatura a la que no se necesita calefacción ni refrigeración. Si un día tiene una
temperatura media de 70F, ese día es 5 grados día de refrigeración y 0 grados día de
calefacción. A la inversa, si la temperatura media es de 55F, ese día es 10 grados día de
calefacción y 0 grados día de refrigeración.
Estas fórmulas se pueden expresar como una pequeña jerarquía de tipos de registros:
un tipo de grado día abstracto y dos tipos concretos de grados días de calefacción y
grados día de refrigeración. Estos tipos también pueden ser registros posicionales.
Toman una temperatura de base de referencia y una secuencia de registros de
temperatura diaria como argumentos del constructor primario:

C#

public abstract record DegreeDays(double BaseTemperature,

IEnumerable<DailyTemperature> TempRecords);

public sealed record HeatingDegreeDays(double BaseTemperature,

IEnumerable<DailyTemperature> TempRecords)

: DegreeDays(BaseTemperature, TempRecords)

public double DegreeDays => TempRecords.Where(s => s.Mean <

BaseTemperature).Sum(s => BaseTemperature - s.Mean);

public sealed record CoolingDegreeDays(double BaseTemperature,

IEnumerable<DailyTemperature> TempRecords)

: DegreeDays(BaseTemperature, TempRecords)

public double DegreeDays => TempRecords.Where(s => s.Mean >

BaseTemperature).Sum(s => s.Mean - BaseTemperature);

El registro DegreeDays abstracto es la clase base compartida de los registros

HeatingDegreeDays y CoolingDegreeDays . Las declaraciones del constructor primario en

los registros derivados muestran cómo administrar la inicialización de registros base. El

registro derivado declara parámetros para todos los parámetros del constructor
primario del registro base. El registro base declara e inicializa esas propiedades. El
registro derivado no las oculta, sino que solo crea e inicializa propiedades para los
parámetros que no se han declarado en su registro base. En este ejemplo, los registros
derivados no agregan nuevos parámetros del constructor primario. Pruebe el código
mediante la adición del código siguiente a su método Main :

C#

var heatingDegreeDays = new HeatingDegreeDays(65, data);

Console.WriteLine(heatingDegreeDays);

var coolingDegreeDays = new CoolingDegreeDays(65, data);

Console.WriteLine(coolingDegreeDays);

Se obtiene un resultado similar a la siguiente pantalla:

 CLI de .NET

HeatingDegreeDays { BaseTemperature = 65, TempRecords =

record_types.DailyTemperature[], DegreeDays = 85 }

CoolingDegreeDays { BaseTemperature = 65, TempRecords =

record_types.DailyTemperature[], DegreeDays = 71.5 }

Definición de métodos sintetizados por el

compilador
El código calcula el número correcto de grados día de calefacción y refrigeración
durante ese período de tiempo. Pero en este ejemplo se muestra por qué es
recomendable reemplazar algunos de los métodos sintetizados por registros. Puede
declarar su propia versión de cualquiera de los métodos sintetizados por el compilador
en un tipo de registro, excepto el método Clone. El método Clone tiene un nombre
generado por el compilador y no se puede proporcionar otra implementación. Estos
métodos sintetizados incluyen un constructor de copias, los miembros de la interfaz
System.IEquatable<T>, las pruebas de igualdad y desigualdad y GetHashCode(). Para los
fines de este artículo, se va a sintetizar PrintMembers . También puede declarar su propio
elemento ToString , pero PrintMembers constituye una mejor opción para los escenarios
de herencia. Para proporcionar su propia versión de un método sintetizado, la firma
debe coincidir con el método sintetizado.

El elemento TempRecords del resultado de la consola no es útil. Muestra el tipo, pero

nada más. Puede cambiar este comportamiento si proporciona su propia
implementación del método sintetizado PrintMembers . La firma depende de los
modificadores aplicados a la declaración de record :

Si un tipo de registro es sealed , o record struct , la signatura es private bool

PrintMembers(StringBuilder builder);
Si un tipo de registro no es sealed y deriva de object (es decir, no declara un
registro base), la firma es protected virtual bool PrintMembers(StringBuilder
builder);

Si un tipo de registro no es sealed y deriva de otro registro, la firma es protected

override bool PrintMembers(StringBuilder builder);

Estas reglas son más fáciles de asimilar si se entiende el propósito de PrintMembers .

PrintMembers agrega información sobre cada propiedad de un tipo de registro a una
cadena. El contrato requiere que los registros base agreguen sus miembros a la pantalla
y da por hecho que los miembros derivados van a agregar sus miembros. Cada tipo de
registro sintetiza una invalidación de ToString que es similar al ejemplo siguiente de
HeatingDegreeDays :

C#

public override string ToString()

StringBuilder stringBuilder = new StringBuilder();

stringBuilder.Append("HeatingDegreeDays");

stringBuilder.Append(" { ");

if (PrintMembers(stringBuilder))

stringBuilder.Append(" ");

stringBuilder.Append("}");

return stringBuilder.ToString();

Declare un método PrintMembers en el registro DegreeDays que no imprima el tipo de la

colección:

C#

protected virtual bool PrintMembers(StringBuilder stringBuilder)

stringBuilder.Append($"BaseTemperature = {BaseTemperature}");

return true;

La firma declara un método virtual protected para que coincida con la versión del
compilador. No se preocupe si obtiene los descriptores de acceso incorrectos; el
lenguaje aplica la firma correcta. Si olvida los modificadores correctos de cualquier
método sintetizado, el compilador emite advertencias o errores que ayudan a obtener la
firma correcta.

En C# 10 y versiones posteriores, puede declarar el método ToString como sealed en

un tipo de registro. Esto evita que los registros derivados proporcionen una
implementación nueva. Los registros derivados seguirán conteniendo la invalidación de
PrintMembers . Si no quiere que muestre el tipo de tiempo de ejecución del registro,
sellaría ToString . En el ejemplo anterior, perdería la información sobre dónde mide el
registro los días con temperaturas altas o bajas.

Mutación no destructiva
Los miembros sintetizados de una clase de registro posicional no modifican el estado
del registro. El objetivo es que se puedan crear registros inmutables más fácilmente.
Recuerde que declara una instancia de readonly record struct para crear una
estructura de registro inmutable. Vuelva a observar las declaraciones anteriores de
HeatingDegreeDays y CoolingDegreeDays . Los miembros agregados realizan cálculos en

los valores del registro, pero no mutan el estado. Los registros posicionales facilitan la
creación de tipos de referencia inmutables.

La creación de tipos de referencia inmutables significa que se recomienda usar la

mutación no destructiva. Cree nuevas instancias de registro que sean similares a las
instancias de registro existentes mediante with expresiones. Estas expresiones son una
construcción de copia con asignaciones adicionales que modifican la copia. El resultado
es una nueva instancia de registro en la que se ha copiado cada propiedad del registro
existente y, opcionalmente, se ha modificado. El registro original no se ha modificado.

Vamos a agregar un par de características al programa que muestren expresiones with .

En primer lugar, vamos a crear un nuevo registro para calcular la suma térmica con los
mismos datos. La suma térmica suele usar 41F como base de referencia y mide las
temperaturas por encima de ella. Para usar los mismos datos, puede crear un nuevo
registro similar a coolingDegreeDays , pero con otra temperatura base:

C#

// Growing degree days measure warming to determine plant growing rates

var growingDegreeDays = coolingDegreeDays with { BaseTemperature = 41 };

Console.WriteLine(growingDegreeDays);

Puede comparar el número de grados calculado con los números generados con una
temperatura de base de referencia superior. Recuerde que los registros son tipos de
referencia y estas copias son instantáneas. No se copia la matriz de los datos, sino que
ambos registros hacen referencia a los mismos datos. Ese hecho supone una ventaja en
otro escenario. En el caso de la suma térmica, es útil realizar el seguimiento del total de
los cinco días anteriores. Puede crear nuevos registros con otros datos de origen
mediante expresiones with . En el código siguiente se compila una colección de estas
acumulaciones y luego se muestran los valores:

C#

// showing moving accumulation of 5 days using range syntax

List<CoolingDegreeDays> movingAccumulation = new();

int rangeSize = (data.Length > 5) ? 5 : data.Length;

for (int start = 0; start < data.Length - rangeSize; start++)

var fiveDayTotal = growingDegreeDays with { TempRecords = data[start..

 (start + rangeSize)] };

movingAccumulation.Add(fiveDayTotal);

Console.WriteLine();

Console.WriteLine("Total degree days in the last five days");

foreach(var item in movingAccumulation)

Console.WriteLine(item);

También puede usar expresiones with para crear copias de registros. No especifique
ninguna propiedad entre las llaves de la expresión with . Eso significa crear una copia y
no cambiar ninguna propiedad:

C#

var growingDegreeDaysCopy = growingDegreeDays with { };

Ejecute la aplicación terminada para ver los resultados.

Resumen
En este tutorial se han mostrado varios aspectos de los registros. Los registros
proporcionan una sintaxis concisa para los tipos cuyo uso fundamental es el
almacenamiento de datos. En el caso de las clases orientadas a objetos, el uso
fundamental es definir responsabilidades. Este tutorial se ha centrado en los registros
posicionales, donde se puede usar una sintaxis concisa para declarar las propiedades de
un registro. El compilador sintetiza varios miembros del registro para copiar y comparar
registros. Puede agregar cualquier otro miembro que necesite para sus tipos de
registros. Puede crear tipos de registros inmutables sabiendo que ninguno de los
miembros generados por el compilador mutaría su estado. Además, las expresiones
with facilitan la compatibilidad con la mutación no destructiva.

Los registros presentan otra manera de definir tipos. Se usan definiciones class para
crear jerarquías orientadas a objetos que se centran en las responsabilidades y el
comportamiento de los objetos. Cree tipos struct para las estructuras de datos que
almacenan datos y que son lo suficientemente pequeñas como para copiarse de forma
eficaz. Cree tipos record si lo que busca son comparaciones y análisis de similitud que
se basen en valores, y quiere usar variables de referencia, pero no copiar valores. Los
tipos record struct se crean cuando se quieren las características de los registros para
un tipo lo suficientemente pequeño como para copiarlo de forma eficaz.
Puede obtener más información sobre los registros en el artículo de referencia del
lenguaje C# para el tipo de registro y la especificación de tipo de registro propuesta y la
especificación de estructura de registro.
Tutorial: Exploración de ideas mediante
instrucciones de nivel superior para
compilar código mientras aprende
Artículo • 28/11/2022 • Tiempo de lectura: 8 minutos

En este tutorial, aprenderá a:

＂ Obtener información sobre las reglas que rigen el uso de las instrucciones de nivel
superior.
＂ Usar instrucciones de nivel superior para explorar algoritmos.
＂ Refactorizar exploraciones en componentes reutilizables.

Requisitos previos
Tendrá que configurar el equipo para ejecutar .NET 6, que incluye el compilador de
C# 10. El compilador de C# 10 está disponible a partir de Visual Studio 2022 o del
SDK de .NET 6 .

En este tutorial se da por supuesto que conoce bien C# y. NET, incluidos Visual Studio o
la CLI de .NET.

Comienzo de la exploración
Las instrucciones de nivel superior permiten evitar la ceremonia adicional que requiere
colocar el punto de entrada del programa en un método estático en una clase. El punto
de partida típico de una aplicación de consola nueva es similar al código siguiente:

C#

using System;

namespace Application

class Program

static void Main(string[] args)

Console.WriteLine("Hello World!");

El código anterior es el resultado de ejecutar el comando dotnet new console y crear

una aplicación de consola. Estas 11 líneas solo contienen una línea de código ejecutable.
Puede simplificar ese programa con la nueva característica de instrucciones de nivel
superior. Esto le permite quitar todas las líneas de este programa menos dos:

C#

// See https://aka.ms/new-console-template for more information

Console.WriteLine("Hello, World!");

） Importante

Las plantillas de C# para .NET 6 usan instrucciones de nivel superior. Es posible que
la aplicación no coincida con el código de este artículo si ya ha actualizado a
.NET 6. Para obtener más información, consulte el artículo Las nuevas plantillas de
C# generan instrucciones de nivel superior.

El SDK de .NET 6 también agrega un conjunto de directivas implícitas global using

para proyectos que usan los SDK siguientes:

Microsoft.NET.Sdk
Microsoft.NET.Sdk.Web
Microsoft.NET.Sdk.Worker

Estas directivas de global using implícitas incluyen los espacios de nombres más
comunes para el tipo de proyecto.

Esta característica simplifica lo que se necesita para comenzar a explorar nuevas ideas.
Puede usar las instrucciones de nivel superior para escenarios de scripting o para
explorar. Una vez que conozca los aspectos básicos, puede empezar a refactorizar el
código y crear métodos, clases u otros ensamblados para los componentes reutilizables
que ha compilado. Las instrucciones de nivel superior permiten una experimentación
rápida y tutoriales para principiantes. También proporcionan una ruta fluida desde la
experimentación hasta la obtención de programas completos.

Las instrucciones de nivel superior se ejecutan en el orden en el que aparecen en el

archivo. Las instrucciones de nivel superior solo se pueden usar en un archivo de código
fuente de la aplicación. El compilador genera un error si se usan en más de un archivo.
Creación de un contestador automático de
.NET mágico
En este tutorial, se creará una aplicación de consola que responde a una pregunta de
tipo "sí" o "no" con una respuesta aleatoria. Compilará la funcionalidad paso a paso.
Puede centrarse en la tarea en lugar de la ceremonia necesaria para la estructura de un
programa típico. Después, una vez que esté satisfecho con la funcionalidad, puede
refactorizar la aplicación como considere oportuno.

Un buen punto de partida es escribir la pregunta de nuevo en la consola. Puede

empezar por escribir el código siguiente:

C#

Console.WriteLine(args);

No declare una variable args . Para el único archivo de código fuente que contiene las
instrucciones de nivel superior, el compilador reconoce args para indicar los
argumentos de línea de comandos. El tipo de args es string[] , como en todos los
programas de C#.

Puede ejecutar el comando dotnet run siguiente para probar el código:

CLI de .NET

dotnet run -- Should I use top level statements in all my programs?

Los argumentos después de -- en la línea de comandos se pasan al programa. Puede

ver el tipo de la variable args , ya que es lo que se imprime en la consola:

Consola

System.String[]

Para escribir la pregunta en la consola, tendrá que enumerar los argumentos y

separarlos con un espacio. Reemplace la llamada a WriteLine por el código siguiente:

C#

Console.WriteLine();

foreach(var s in args)

Console.Write(s);

 Console.Write(' ');

Console.WriteLine();

Ahora, al ejecutar el programa, mostrará correctamente la pregunta como una cadena

de argumentos.

Respuesta con una respuesta aleatoria

Después de repetir la pregunta, puede agregar el código para generar la respuesta
aleatoria. Para empezar, agregue una matriz de respuestas posibles:

C#

string[] answers =

"It is certain.", "Reply hazy, try again.", "Don’t count on

it.",

"It is decidedly so.", "Ask again later.", "My reply is no.",

"Without a doubt.", "Better not tell you now.", "My sources say
no.",

"Yes – definitely.", "Cannot predict now.", "Outlook not so

good.",

"You may rely on it.", "Concentrate and ask again.", "Very doubtful.",

"As I see it, yes.",

"Most likely.",

"Outlook good.",

"Yes.",

"Signs point to yes.",

};

Esta matriz tiene diez respuestas que son afirmativas, cinco inexpresivas y cinco
negativas. A continuación, agregue el código siguiente para generar y mostrar una
respuesta aleatoria de la matriz:

C#

var index = new Random().Next(answers.Length - 1);

Console.WriteLine(answers[index]);

Puede volver a ejecutar la aplicación para ver los resultados. Debería ver algo parecido a
la salida siguiente:

CLI de .NET

dotnet run -- Should I use top level statements in all my programs?

 Should I use top level statements in all my programs?

Better not tell you now.

Este código responde a las preguntas, pero agreguemos una característica más. Quiere
que la aplicación de preguntas simule que se piensa la respuesta. Puede hacerlo si
agrega una animación de ASCII y se detiene mientras trabaja. Agregue el código
siguiente después de la línea que reproduce la pregunta:

C#

for (int i = 0; i < 20; i++)

Console.Write("| -");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("/ \\");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("- |");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("\\ /");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.WriteLine();

También tendrá que agregar una instrucción using a la parte superior del archivo de
código fuente:

C#

using System.Threading.Tasks;

Las instrucciones using deben aparecer antes que cualquier otra del archivo. De lo
contrario, es un error del compilador. Puede volver a ejecutar el programa y ver la
animación. Eso mejora la experiencia. Experimente con la duración del retraso hasta que
le guste.

El código anterior crea un conjunto de líneas giratorias separadas por un espacio. Al

agregar la palabra clave await se le indica al compilador que genere el punto de
entrada del programa como un método con el modificador async y que devuelva
System.Threading.Tasks.Task. Este programa no devuelve un valor, por lo que el punto
de entrada del programa devuelve Task . Si el programa devuelve un valor entero,
tendría que agregar una instrucción return al final de las instrucciones de nivel superior.
Esa instrucción return especificaría el valor entero que se va a devolver. Si las
instrucciones de nivel superior incluyen una expresión await , el tipo de valor devuelto
se convierte en System.Threading.Tasks.Task<TResult>.

Refactorización para el futuro

El programa debería ser similar al código siguiente:

C#

Console.WriteLine();

foreach(var s in args)

Console.Write(s);

Console.Write(' ');

Console.WriteLine();

for (int i = 0; i < 20; i++)

Console.Write("| -");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("/ \\");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("- |");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("\\ /");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.WriteLine();

string[] answers =

"It is certain.", "Reply hazy, try again.", "Don't count on

it.",

"It is decidedly so.", "Ask again later.", "My reply is no.",

"Without a doubt.", "Better not tell you now.", "My sources say
no.",

"Yes – definitely.", "Cannot predict now.", "Outlook not so

good.",

"You may rely on it.", "Concentrate and ask again.", "Very doubtful.",

"As I see it, yes.",

"Most likely.",

"Outlook good.",

"Yes.",

"Signs point to yes.",

};

 var index = new Random().Next(answers.Length - 1);

Console.WriteLine(answers[index]);

En el código anterior es razonable. Funciona. Pero no es reutilizable. Ahora que ya tiene

la aplicación en funcionamiento, es momento de extraer los elementos reutilizables.

Un candidato es el código que muestra la animación en espera. Ese fragmento de

código se puede convertir en un método:

Puede empezar por crear una función local en el archivo. Reemplace la animación actual
por el código siguiente:

C#

await ShowConsoleAnimation();

static async Task ShowConsoleAnimation()

for (int i = 0; i < 20; i++)

Console.Write("| -");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("/ \\");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("- |");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("\\ /");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.WriteLine();

En el código anterior se crea una función local dentro del método Main. Todavía no es
reutilizable. Por tanto, extraiga ese código en una clase. Cree un archivo con el nombre
utilities.cs y agregue el código siguiente:

C#

namespace MyNamespace

public static class Utilities

public static async Task ShowConsoleAnimation()

for (int i = 0; i < 20; i++)

 Console.Write("| -");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("/ \\");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("- |");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.Write("\\ /");

await Task.Delay(50);

Console.Write("\b\b\b");

Console.WriteLine();

Un archivo que tiene instrucciones de nivel superior también puede contener espacios
de nombres y tipos al final del archivo, después de las instrucciones de nivel superior.
Pero para este tutorial, coloque el método de animación en un archivo independiente
para que sea más fácil de usar.

Por último, puede limpiar el código de animación para quitar duplicaciones:

C#

foreach (string s in new[] { "| -", "/ \\", "- |", "\\ /", })

Console.Write(s);

await Task.Delay(50);

Console.Write("\b\b\b");

Ahora tiene una aplicación completa y ha refactorizado los elementos reutilizables para
su uso posterior. Puede llamar al nuevo método de utilidad desde las instrucciones de
nivel superior, tal como se muestra a continuación en la versión finalizada del programa
principal:

C#

using MyNamespace;

Console.WriteLine();

foreach(var s in args)

Console.Write(s);

Console.Write(' ');

Console.WriteLine();

 await Utilities.ShowConsoleAnimation();

string[] answers =

"It is certain.", "Reply hazy, try again.", "Don’t count on

it.",

"It is decidedly so.", "Ask again later.", "My reply is no.",

"Without a doubt.", "Better not tell you now.", "My sources say
no.",

"Yes – definitely.", "Cannot predict now.", "Outlook not so

good.",

"You may rely on it.", "Concentrate and ask again.", "Very doubtful.",

"As I see it, yes.",

"Most likely.",

"Outlook good.",

"Yes.",

"Signs point to yes.",

};

var index = new Random().Next(answers.Length - 1);

Console.WriteLine(answers[index]);

El ejemplo anterior agrega la llamada a Utilities.ShowConsoleAnimation y una

instrucción using adicional.

Resumen
Las instrucciones de nivel superior facilitan la creación de programas sencillos para
explorar nuevos algoritmos. Puede experimentar con algoritmos si prueba otros
fragmentos de código. Una vez que haya aprendido lo que funciona, puede refactorizar
el código para que sea más fácil de mantener.

Las instrucciones de nivel superior simplifican los programas basados en aplicaciones de

consola. Esto incluye Azure Functions, las acciones de GitHub y otras utilidades
pequeñas. Para obtener más información, vea Instrucciones de nivel superior (Guía de
programación de C#).
Uso de la coincidencia de patrones para
crear el comportamiento de la clase y
mejorar el código
Artículo • 06/12/2022 • Tiempo de lectura: 11 minutos

Las características de coincidencia de patrones en C# proporcionan la sintaxis para

expresar los algoritmos. Puede usar estas técnicas para implementar el comportamiento
en las clases. Puede combinar el diseño de clases orientadas a objetos con una
implementación orientada a datos para proporcionar un código conciso al modelar
objetos del mundo real.

En este tutorial, aprenderá a:

＂ Expresar las clases orientadas a objetos mediante patrones de datos.

＂ Implementar dichos patrones con las características de coincidencia de patrones de
C#.
＂ Aprovechar los diagnósticos del compilador para validar la implementación.

Requisitos previos
Deberá configurar la máquina para ejecutar .NET 5, incluido el compilador de C# 9. El
compilador de C# 9 está disponible a partir de la versión 16.8 de Visual Studio 2019 o
del SDK de .NET 5 .

Compilación de una simulación de una esclusa

de canal
En este tutorial, compilará una clase de C# que simula una esclusa de canal . En pocas
palabras, una esclusa de canal es un dispositivo que permite que los barcos suban y
bajen cuando se mueven entre dos cuerpos de agua con distintos niveles. Una esclusa
tiene dos compuertas y algún mecanismo que permite cambiar el nivel del agua.

En su funcionamiento habitual, un barco entra por una de las compuertas mientras el

nivel del agua en la esclusa se iguala al nivel del agua del lado por donde entra el barco.
Una vez en la esclusa, se modifica el nivel del agua para igualarlo al nivel de donde el
barco saldrá de la esclusa. Cuando el nivel del agua es igual al de ese lado, se abre la
compuerta de la salida. Hay medidas de seguridad que garantizan que un operador no
pueda crear una situación de peligro en el canal. El nivel del agua solo se puede
modificar cuando ambas compuertas están cerradas. Como mucho, puede haber una
compuerta abierta. Para abrir una compuerta, el nivel del agua de la esclusa debe
coincidir con el nivel fuera de la compuerta que se está abriendo.

Es posible compilar una clase de C# que modele este comportamiento. Una clase
CanalLock podría admitir los comandos para abrir o cerrar cualquiera de las

compuertas. Tendría otros comandos para aumentar o reducir el nivel del agua. La clase
también debería admitir propiedades para leer el estado actual de ambas compuertas y
el nivel del agua. Los métodos implementan las medidas de seguridad.

Definición de una clase

Compilará una aplicación de consola para probar la clase CanalLock . Cree un proyecto
de consola nuevo para .NET 5 con Visual Studio o la CLI de .NET. Luego, agregue una
clase nueva con el nombre CanalLock . Luego, diseñe la API pública, pero deje los
métodos sin implementar:

C#

public enum WaterLevel

Low,

High

public class CanalLock

// Query canal lock state:

public WaterLevel CanalLockWaterLevel { get; private set; } =

WaterLevel.Low;

public bool HighWaterGateOpen { get; private set; } = false;

public bool LowWaterGateOpen { get; private set; } = false;

// Change the upper gate.

public void SetHighGate(bool open)

throw new NotImplementedException();

// Change the lower gate.

public void SetLowGate(bool open)

throw new NotImplementedException();

// Change water level.

public void SetWaterLevel(WaterLevel newLevel)

throw new NotImplementedException();

 public override string ToString() =>

$"The lower gate is {(LowWaterGateOpen ? "Open" : "Closed")}. " +

$"The upper gate is {(HighWaterGateOpen ? "Open" : "Closed")}. " +

$"The water level is {CanalLockWaterLevel}.";

El código anterior inicializa el objeto de manera que ambas compuertas estén cerradas y
el nivel del agua sea bajo. Luego, escriba el código de prueba siguiente en el método
Main como guía para crear una primera implementación de la clase:

C#

// Create a new canal lock:

var canalGate = new CanalLock();

// State should be doors closed, water level low:

Console.WriteLine(canalGate);

canalGate.SetLowGate(open: true);

Console.WriteLine($"Open the lower gate: {canalGate}");

Console.WriteLine("Boat enters lock from lower gate");

canalGate.SetLowGate(open: false);

Console.WriteLine($"Close the lower gate: {canalGate}");

canalGate.SetWaterLevel(WaterLevel.High);

Console.WriteLine($"Raise the water level: {canalGate}");

canalGate.SetHighGate(open: true);

Console.WriteLine($"Open the higher gate: {canalGate}");

Console.WriteLine("Boat exits lock at upper gate");

Console.WriteLine("Boat enters lock from upper gate");

canalGate.SetHighGate(open: false);

Console.WriteLine($"Close the higher gate: {canalGate}");

canalGate.SetWaterLevel(WaterLevel.Low);

Console.WriteLine($"Lower the water level: {canalGate}");

canalGate.SetLowGate(open: true);

Console.WriteLine($"Open the lower gate: {canalGate}");

Console.WriteLine("Boat exits lock at upper gate");

canalGate.SetLowGate(open: false);

Console.WriteLine($"Close the lower gate: {canalGate}");

A continuación, agregue una primera implementación de cada método en la clase

CanalLock . El código siguiente implementa los métodos de la clase sin preocuparse por
las reglas de seguridad. Más adelante agregará pruebas de seguridad:

C#

// Change the upper gate.

public void SetHighGate(bool open)

HighWaterGateOpen = open;

// Change the lower gate.

public void SetLowGate(bool open)

LowWaterGateOpen = open;

// Change water level.

public void SetWaterLevel(WaterLevel newLevel)

{

CanalLockWaterLevel = newLevel;

Las pruebas que ha escrito hasta el momento se completan correctamente. Ha

implementado los aspectos básicos. Ahora, escriba una prueba para la primera
condición de error. Al final de las pruebas anteriores, ambas compuertas están cerradas
y el nivel del agua se establece en bajo. Agregue una prueba para intentar abrir la
compuerta superior:

C#

Console.WriteLine("=============================================");

Console.WriteLine(" Test invalid commands");

// Open "wrong" gate (2 tests)

try

canalGate = new CanalLock();

canalGate.SetHighGate(open: true);

catch (InvalidOperationException)
{

Console.WriteLine("Invalid operation: Can't open the high gate. Water is

low.");

Console.WriteLine($"Try to open upper gate: {canalGate}");

Esta prueba genera un error porque la compuerta se abre. Como primera

implementación, puede corregirlo con este código:
 C#

// Change the upper gate.

public void SetHighGate(bool open)

if (open && (CanalLockWaterLevel == WaterLevel.High))

HighWaterGateOpen = true;

else if (open && (CanalLockWaterLevel == WaterLevel.Low))

throw new InvalidOperationException("Cannot open high gate when the

water is low");

Las pruebas se realizan correctamente. Pero a medida que agrega más pruebas,
agregará cada vez más cláusulas if y probará distintas propiedades. Pronto, estos
métodos resultarán demasiado complicados a medida que agregue más condicionales.

Implementación de los comandos con patrones

Una mejor manera es usar patrones para determinar si el objeto tiene un estado válido
para ejecutar un comando. Puede expresar si se permite un comando como una función
de tres variables: el estado de la compuerta, el nivel del agua y la nueva configuración:

Nueva configuración Estado de la compuerta Nivel del agua Resultado

Cerrada Cerrada Alto Cerrada

Cerrada Cerrada Bajo Cerrada

Cerrada Abrir Alto Cerrada

Closed Abrir Baja Closed

Abrir Closed Alto Abrir

Abrir Closed Bajo Cerrada (error)

Abrir Abrir Alto Abrir

Abrir Abrir Baja Cerrada (error)

La cuarta y la última fila de la tabla tienen tachado el texto porque no son válidas. El
código que va a agregar ahora debe garantizar que la compuerta superior no se abrirá
nunca si el nivel del agua es bajo. Esos estados se pueden codificar como una expresión
switch única (recuerde que false indica "Cerrada"):

C#
 HighWaterGateOpen = (open, HighWaterGateOpen, CanalLockWaterLevel) switch

(false, false, WaterLevel.High) => false,

(false, false, WaterLevel.Low) => false,

(false, true, WaterLevel.High) => false,

(false, true, WaterLevel.Low) => false, // should never happen

(true, false, WaterLevel.High) => true,

(true, false, WaterLevel.Low) => throw new

InvalidOperationException("Cannot open high gate when the water is low"),

(true, true, WaterLevel.High) => true,

(true, true, WaterLevel.Low) => false, // should never happen

};

Pruebe esta versión. Las pruebas se realizan correctamente, lo que valida el código. En la
tabla completa se muestran las combinaciones posibles de entradas y resultados. Eso
significa que tanto usted como otros desarrolladores pueden examinar rápidamente la
tabla y ver que se han cubierto todas las entradas posibles. Usar el compilador puede
hacerlo más fácil. Después de agregar el código anterior, puede ver que el compilador
genera una advertencia: CS8524 indica que la expresión switch no cubre todas las
entradas posibles. El motivo de esta advertencia es que una de las entradas es de tipo
enum . El compilador interpreta "todas las entradas posibles" como todas las entradas del

tipo subyacente, por lo general, un int . Esta expresión switch solo comprueba los
valores declarados en la enum . Para quitar la advertencia, puede agregar un patrón de
descarte comodín para el último segmento de la expresión. Esta condición genera una
excepción porque indica una entrada no válida:

C#

_ => throw new InvalidOperationException("Invalid internal state"),

El segmento modificador anterior debe ir al final de la expresión switch porque

coincide con todas las entradas. Experimente poniendo el segmento modificador antes
en la expresión. Eso generará un error de compilador CS8510 para un código
inalcanzable en un patrón. La estructura natural de las expresiones switch permite que el
compilador genere errores y advertencias en caso de posibles errores. La "red de
seguridad" del compilador facilita la creación de código correcto en menos iteraciones y
brinda la libertad de combinar segmentos modificadores con caracteres comodín. El
compilador emitirá errores si la combinación da como resultado segmentos inaccesibles
no esperados y advertencias si quita un segmento necesario.

El primer cambio consiste en combinar todos los segmentos en los que el comando va a
cerrar la compuerta; eso siempre se permite. Agregue el código siguiente como el
primer segmento de la expresión switch:
 C#

(false, _, _) => false,

Después de agregar el segmento modificador anterior, recibirá cuatro errores de

compilador, uno en cada uno de los segmentos donde el comando es false . Estos
segmentos ya los cubre el segmento recién agregado. Puede quitar sin problemas esas
cuatro líneas. Su intención era que este segmento modificador nuevo reemplazara esas
condiciones.

Luego, puede simplificar los cuatro segmentos en los que el comando indica abrir la
compuerta. En ambos casos en los que el nivel del agua es alto, se puede abrir la
compuerta. (En un caso, ya está abierta). Un caso en el que el nivel del agua es bajo
genera una excepción y el otro no debería ocurrir. Debería ser seguro generar la misma
excepción si el cierre hidráulico ya tiene un estado no válido. Puede hacer estas
simplificaciones para esos segmentos:

C#

(true, _, WaterLevel.High) => true,

(true, false, WaterLevel.Low) => throw new InvalidOperationException("Cannot

open high gate when the water is low"),

_ => throw new InvalidOperationException("Invalid internal state"),

Vuelva a ejecutar las pruebas y las completarán correctamente. Esta es la versión final
del método SetHighGate :

C#

// Change the upper gate.

public void SetHighGate(bool open)

HighWaterGateOpen = (open, HighWaterGateOpen, CanalLockWaterLevel)

switch

(false, _, _) => false,

(true, _, WaterLevel.High) => true,

(true, false, WaterLevel.Low) => throw new

InvalidOperationException("Cannot open high gate when the water is low"),

_ => throw new

InvalidOperationException("Invalid internal state"),

};

Implementación de patrones por su cuenta

Ahora que conoce la técnica, complete usted mismo los métodos SetLowGate y
SetWaterLevel . Empiece agregando el código siguiente para probar las operaciones no
válidas en esos métodos:

C#

Console.WriteLine();

Console.WriteLine();

try

canalGate = new CanalLock();

canalGate.SetWaterLevel(WaterLevel.High);

canalGate.SetLowGate(open: true);

catch (InvalidOperationException)
{

Console.WriteLine("invalid operation: Can't open the lower gate. Water

is high.");

Console.WriteLine($"Try to open lower gate: {canalGate}");

// change water level with gate open (2 tests)

Console.WriteLine();

Console.WriteLine();

try

canalGate = new CanalLock();

canalGate.SetLowGate(open: true);

canalGate.SetWaterLevel(WaterLevel.High);

catch (InvalidOperationException)
{

Console.WriteLine("invalid operation: Can't raise water when the lower

gate is open.");

Console.WriteLine($"Try to raise water with lower gate open: {canalGate}");

Console.WriteLine();

Console.WriteLine();

try

canalGate = new CanalLock();

canalGate.SetWaterLevel(WaterLevel.High);

canalGate.SetHighGate(open: true);

canalGate.SetWaterLevel(WaterLevel.Low);

catch (InvalidOperationException)
{

Console.WriteLine("invalid operation: Can't lower water when the high

gate is open.");

Console.WriteLine($"Try to lower water with high gate open: {canalGate}");

Vuelva a ejecutar la aplicación. Puede ver que se generan errores en las pruebas nuevas
y que la esclusa de canal queda en un estado no válido. Intente implementar usted
mismo el resto de los métodos. El método para establecer la compuerta inferior debe
ser similar al que se usa para establecer la compuerta superior. El método que cambia el
nivel del agua tiene otras comprobaciones, pero debe seguir una estructura similar.
Puede que le resulte útil usar el mismo proceso para el método que establece el nivel
del agua. Comience con las cuatro entradas: El estado de ambas compuertas, el estado
actual del nivel del agua y el nuevo nivel del agua solicitado. La expresión switch debe
empezar por:

C#

CanalLockWaterLevel = (newLevel, CanalLockWaterLevel, LowWaterGateOpen,

HighWaterGateOpen) switch

// elided

};

Tendrá que completar un total de 16 segmentos modificadores. Luego, realice la prueba

y simplifique.

¿Hizo métodos como este?

C#

// Change the lower gate.

public void SetLowGate(bool open)

LowWaterGateOpen = (open, LowWaterGateOpen, CanalLockWaterLevel) switch

(false, _, _) => false,

(true, _, WaterLevel.Low) => true,

(true, false, WaterLevel.High) => throw new

InvalidOperationException("Cannot open high gate when the water is low"),

_ => throw new InvalidOperationException("Invalid internal state"),

};

// Change water level.

public void SetWaterLevel(WaterLevel newLevel)

{

CanalLockWaterLevel = (newLevel, CanalLockWaterLevel, LowWaterGateOpen,

HighWaterGateOpen) switch

(WaterLevel.Low, WaterLevel.Low, true, false) => WaterLevel.Low,

(WaterLevel.High, WaterLevel.High, false, true) => WaterLevel.High,

(WaterLevel.Low, _, false, false) => WaterLevel.Low,

(WaterLevel.High, _, false, false) => WaterLevel.High,

(WaterLevel.Low, WaterLevel.High, false, true) => throw new

 InvalidOperationException("Cannot lower water when the high gate is open"),

(WaterLevel.High, WaterLevel.Low, true, false) => throw new

InvalidOperationException("Cannot raise water when the low gate is open"),

_ => throw new InvalidOperationException("Invalid internal state"),

};

Las pruebas deberían completarse correctamente y la esclusa de canal debería funcionar

de manera segura.

Resumen
En este tutorial, aprendió a usar la coincidencia de patrones para comprobar el estado
interno de un objeto antes de aplicar cualquier cambio en ese estado. Puede comprobar
combinaciones de propiedades. Una vez que cree tablas para cualquiera de esas
transiciones, probará el código y, luego, lo simplificará para su lectura y mantenimiento.
Estas refactorizaciones iniciales pueden sugerir otras refactorizaciones que validen el
estado interno o administren otros cambios de la API. En este tutorial se combinan
clases y objetos con un enfoque más orientado a datos basado en patrones para
implementar esas clases.
Tutorial: Actualización de interfaces con
métodos de interfaz predeterminados
Artículo • 28/11/2022 • Tiempo de lectura: 6 minutos

Puede definir una implementación al declarar un miembro de una interfaz. El escenario

más común es agregar de forma segura a miembros a una interfaz ya publicada y
utilizada por clientes incontables.

En este tutorial aprenderá lo siguiente:

＂ Extender interfaces de forma segura mediante la adición de métodos con

implementaciones.
＂ Crear implementaciones con parámetros para proporcionar mayor flexibilidad.
＂ Permitir que los implementadores proporcionen una implementación más
específica en forma de una invalidación.

Requisitos previos
Deberá configurar la máquina para ejecutar .NET, incluido el compilador de C#. El
compilador de C# está disponible con Visual Studio 2022 o el SDK de .NET .

Información general del escenario

Este tutorial comienza con la versión 1 de una biblioteca de relaciones con clientes.
Puede obtener la aplicación de inicio en nuestro repositorio de ejemplo en GitHub . La
empresa que creó esta biblioteca se dirigía a los clientes con aplicaciones existentes
para adoptar sus bibliotecas. Proporcionan definiciones de una interfaz mínima para que
la implemente los usuarios de su biblioteca. Esta es la definición de interfaz para un
cliente:

C#

public interface ICustomer

IEnumerable<IOrder> PreviousOrders { get; }

DateTime DateJoined { get; }

DateTime? LastOrder { get; }

string Name { get; }

IDictionary<DateTime, string> Reminders { get; }

Definieron una segunda interfaz que representa un pedido:

C#

public interface IOrder

DateTime Purchased { get; }

decimal Cost { get; }

En esas interfaces, el equipo pudo generar una biblioteca para sus usuarios con el fin de
crear una mejor experiencia para los clientes. Su objetivo era crear una relación más
estrecha con los clientes existentes y mejorar sus relaciones con los clientes nuevos.

Ahora, es momento de actualizar la biblioteca para la próxima versión. Una de las

características solicitadas permite un descuento por fidelidad para los clientes que
tienen muchos pedidos. Este nuevo descuento por fidelidad se aplica cada vez que un
cliente realiza un pedido. El descuento específico es una propiedad de cada cliente
individual. Cada implementación de ICustomer puede establecer reglas diferentes para
el descuento por fidelidad.

La forma más natural para agregar esta funcionalidad es mejorar la interfaz ICustomer
con un método para aplicar los descuentos por fidelización. Esta sugerencia de diseño
es motivo de preocupación entre los desarrolladores experimentados: "Las interfaces
son inmutables una vez que se han publicado. ¡Este es un cambio importante!"
Implementaciones de interfaz predeterminadas para actualizar interfaces. Los autores de
bibliotecas pueden agregar a nuevos miembros a la interfaz y proporcionar una
implementación predeterminada para esos miembros.

Las implementaciones de interfaces predeterminadas permiten a los desarrolladores

actualizar una interfaz mientras siguen permitiendo que los implementadores invaliden
esa implementación. Los usuarios de la biblioteca pueden aceptar la implementación
predeterminada como un cambio sin importancia. Si sus reglas de negocios son
diferentes, se puede invalidar.

Actualización con los métodos de interfaz

predeterminados
El equipo estuvo de acuerdo en la más probable implementación predeterminada: un
descuento por fidelidad para los clientes.

La actualización debe proporcionar la funcionalidad para establecer dos propiedades: el

número de pedidos necesario para poder recibir el descuento y el porcentaje del
descuento. Esto lo convierte en un escenario perfecto para los métodos de interfaz
predeterminados. Puede agregar un método a la interfaz de ICustomer y proporcionar
la implementación más probable. Todas las implementaciones existentes y nuevas
pueden usar la implementación predeterminada o proporcionar una propia.

En primer lugar, agregue el nuevo método a la interfaz, incluido su cuerpo:

C#

// Version 1:

public decimal ComputeLoyaltyDiscount()

DateTime TwoYearsAgo = DateTime.Now.AddYears(-2);

if ((DateJoined < TwoYearsAgo) && (PreviousOrders.Count() > 10))

return 0.10m;

return 0;

El autor de la biblioteca escribió una primera prueba para comprobar la

implementación:

C#

SampleCustomer c = new SampleCustomer("customer one", new DateTime(2010, 5,

31))

Reminders =

{ new DateTime(2010, 08, 12), "childs's birthday" },

{ new DateTime(1012, 11, 15), "anniversary" }

};

SampleOrder o = new SampleOrder(new DateTime(2012, 6, 1), 5m);

c.AddOrder(o);

o = new SampleOrder(new DateTime(2103, 7, 4), 25m);

c.AddOrder(o);

// Check the discount:

ICustomer theCustomer = c;

Console.WriteLine($"Current discount:
{theCustomer.ComputeLoyaltyDiscount()}");

Tenga en cuenta la siguiente parte de la prueba:

C#
 // Check the discount:

ICustomer theCustomer = c;

Console.WriteLine($"Current discount:
{theCustomer.ComputeLoyaltyDiscount()}");

La conversión de SampleCustomer a ICustomer es necesaria. La clase SampleCustomer no

necesita proporcionar una implementación para ComputeLoyaltyDiscount . La interfaz
ICustomer la proporciona. Sin embargo, la clase SampleCustomer no hereda miembros

de sus interfaces. Esa no ha cambiado. Para poder llamar a cualquier método declarado
e implementado en la interfaz, la variable debe ser del tipo de la interfaz: ICustomer en
este ejemplo.

Proporcionar parametrización
Ese es un buen inicio. Pero la implementación predeterminada es demasiado restrictiva.
Muchos consumidores de este sistema pueden elegir diferentes umbrales para el
número de compras, una longitud diferente de la pertenencia o un porcentaje diferente
del descuento. Puede proporcionar una mejor experiencia de actualización para más
clientes proporcionando una manera de establecer esos parámetros. Vamos a agregar
un método estático que establezca esos tres parámetros controlando la implementación
predeterminada:

C#

// Version 2:

public static void SetLoyaltyThresholds(

TimeSpan ago,

int minimumOrders = 10,

decimal percentageDiscount = 0.10m)

length = ago;

orderCount = minimumOrders;

discountPercent = percentageDiscount;

private static TimeSpan length = new TimeSpan(365 * 2, 0,0,0); // two years

private static int orderCount = 10;

private static decimal discountPercent = 0.10m;

public decimal ComputeLoyaltyDiscount()

DateTime start = DateTime.Now - length;

if ((DateJoined < start) && (PreviousOrders.Count() > orderCount))

return discountPercent;

 return 0;

Hay muchas funcionalidades nuevas de lenguaje que se muestran en este pequeño

fragmento de código. Las interfaces ahora pueden incluir miembros estáticos, incluidos
campos y métodos. También están habilitados diferentes modificadores de acceso. Los
campos adicionales son privados, el nuevo método es público. Todos los modificadores
están permitidos en los miembros de la interfaz.

Las aplicaciones que usan la fórmula general para calcular el descuento por fidelidad,
pero diferentes parámetros, no necesitan proporcionar una implementación
personalizada: pueden establecer los argumentos a través de un método estático. Por
ejemplo, el siguiente código establece una "apreciación de cliente" que recompensa a
cualquier cliente con más de una pertenencia al mes:

C#

ICustomer.SetLoyaltyThresholds(new TimeSpan(30, 0, 0, 0), 1, 0.25m);

Console.WriteLine($"Current discount:
{theCustomer.ComputeLoyaltyDiscount()}");

Extender la implementación predeterminada

El código que ha agregado hasta ahora ha proporcionado una implementación
adecuada para los escenarios donde los usuarios quieren algo similar a la
implementación predeterminada, o para proporcionar un conjunto de reglas no
relacionado. Para una característica final, vamos a refactorizar el código un poco para
habilitar los escenarios donde es posible que los usuarios deseen crear en la
implementación predeterminada.

Considere una startup que desea captar nuevos clientes. Ofrecen un descuento del 50 %
en el primer pedido de un cliente nuevo. De lo contrario, los clientes existentes obtienen
el descuento estándar. El autor de la biblioteca necesita mover la implementación
predeterminada a un método protected static para que cualquier clase que
implemente esta interfaz pueda reutilizar el código en su implementación. La
implementación predeterminada del miembro de la interfaz llama a este método
compartido así:

C#

public decimal ComputeLoyaltyDiscount() => DefaultLoyaltyDiscount(this);

protected static decimal DefaultLoyaltyDiscount(ICustomer c)

 DateTime start = DateTime.Now - length;

if ((c.DateJoined < start) && (c.PreviousOrders.Count() > orderCount))

return discountPercent;

return 0;

En una implementación de una clase que implementa esta interfaz, la invalidación

puede llamar al método auxiliar estático y ampliar esa lógica para proporcionar el
descuento de "cliente nuevo":

C#

public decimal ComputeLoyaltyDiscount()

if (PreviousOrders.Any() == false)

return 0.50m;

else

return ICustomer.DefaultLoyaltyDiscount(this);

Puede ver todo el código terminado en nuestro repositorio de ejemplos en GitHub .

Puede obtener la aplicación de inicio en nuestro repositorio de ejemplo en GitHub .

Estas nuevas características significan que las interfaces se pueden actualizar de forma
segura cuando hay una implementación predeterminada razonable para esos nuevos
miembros. Diseñe cuidadosamente las interfaces para expresar ideas funcionales únicas
que puedan implementarse con varias clases. Esto facilita la actualización de esas
definiciones de interfaz cuando se descubren nuevos requisitos para esa misma idea
funcional.
Tutorial: Funcionalidad de combinación
al crear clases mediante interfaces con
métodos de interfaz predeterminados
Artículo • 28/11/2022 • Tiempo de lectura: 9 minutos

Puede definir una implementación al declarar un miembro de una interfaz. Esta

característica proporciona nuevas funcionalidades en las que puede definir
implementaciones predeterminadas para las características declaradas en las interfaces.
Las clases pueden elegir cuándo invalidar la funcionalidad, cuándo usar la funcionalidad
predeterminada y cuándo no se debe declarar la compatibilidad con características
discretas.

En este tutorial aprenderá lo siguiente:

＂ Creación de interfaces con implementaciones que describen características

discretas.
＂ Creación de clases que usan las implementaciones predeterminadas.
＂ Creación de clases que invaliden algunas o todas las implementaciones
predeterminadas.

Requisitos previos
Deberá configurar la máquina para ejecutar .NET, incluido el compilador de C#. El
compilador de C# está disponible con Visual Studio 2022 , o con el SDK de .NET o
una versión posterior.

Limitaciones de los métodos de extensión

Una manera de implementar el comportamiento que aparece como parte de una
interfaz es definir métodos de extensión que proporcionan el comportamiento
predeterminado. Las interfaces declaran un conjunto mínimo de miembros mientras
proporcionan un área expuesta más grande para cualquier clase que implemente esa
interfaz. Por ejemplo, los métodos de extensión de Enumerable proporcionan la
implementación para que cualquier secuencia sea el origen de una consulta LINQ.

Los métodos de extensión se resuelven en tiempo de compilación, mediante el tipo

declarado de la variable. Las clases que implementan la interfaz pueden proporcionar
una mejor implementación para cualquier método de extensión. Las declaraciones de
variables deben coincidir con el tipo de implementación para que el compilador pueda
elegir esa implementación. Cuando el tipo en tiempo de compilación coincide con la
interfaz, las llamadas al método se resuelven en el método de extensión. Otro problema
con los métodos de extensión es que se puede tener acceso a esos métodos siempre
que se pueda tener acceso a la clase que contiene los métodos de extensión. Las clases
no pueden declarar si deben o no deben proporcionar características declaradas en los
métodos de extensión.

Puede declarar las implementaciones predeterminadas como métodos de interfaz.

Después, cada clase usa automáticamente la implementación predeterminada. Cualquier
clase que pueda proporcionar una mejor implementación puede invalidar la definición
del método de interfaz con un algoritmo mejor. En un sentido, esta técnica suena de
forma similar a como se podían usar los métodos de extensión.

En este artículo, aprenderá cómo las implementaciones de interfaces predeterminadas

habilitan nuevos escenarios.

Diseño de la aplicación
Considere una aplicación de automatización de dispositivos del hogar. Probablemente
tenga muchos tipos diferentes de luces e indicadores que podrían usarse en toda la
casa. Cada luz debe admitir las API para encenderla y apagarla, y para notificar el estado
actual. Algunas luces e indicadores pueden admitir otras características, como:

Encender la luz y apagarla después de un tiempo.

Hacer parpadear la luz durante un período.

Algunas de estas funcionalidades extendidas se pueden emular en los dispositivos que

admiten el conjunto mínimo. Lo que indica que se proporciona una implementación
predeterminada. En el caso de los dispositivos que tienen más funcionalidades
integradas, el software del dispositivo usaría las funcionalidades nativas. Para otras
luces, podrían optar por implementar la interfaz y usar la implementación
predeterminada.

Los miembros de interfaz predeterminados son una solución mejor para este escenario
que los métodos de extensión. Los autores de clases pueden controlar qué interfaces
deciden implementar. Las interfaces que elijan están disponibles como métodos.
Además, dado que los métodos de interfaz predeterminados son virtuales de forma
predeterminada, el envío del método siempre elige la implementación en la clase.

Vamos a crear el código para mostrar estas diferencias.

Creación de interfaces
Empiece por crear la interfaz que define el comportamiento de todas las luces:

C#

public interface ILight

void SwitchOn();

void SwitchOff();

bool IsOn();

Un accesorio básico de luces de techo puede implementar esta interfaz, tal como se
muestra en el código siguiente:

C#

public class OverheadLight : ILight

private bool isOn;

public bool IsOn() => isOn;

public void SwitchOff() => isOn = false;

public void SwitchOn() => isOn = true;

public override string ToString() => $"The light is {(isOn ? "on" :

"off")}";

En este tutorial, el código no dispone de dispositivos IoT, pero emula esas actividades
escribiendo mensajes en la consola. Puede explorar el código sin automatizar los
dispositivos de hogar.

A continuación, vamos a definir la interfaz para una luz que se pueda apagar
automáticamente después de un tiempo de espera:

C#

public interface ITimerLight : ILight

Task TurnOnFor(int duration);

Podría agregar una implementación básica a la luz de techo, pero una solución mejor es
modificar esta definición de interfaz para proporcionar una implementación
predeterminada virtual :

C#
 public interface ITimerLight : ILight

public async Task TurnOnFor(int duration)

Console.WriteLine("Using the default interface method for the

ITimerLight.TurnOnFor.");

SwitchOn();

await Task.Delay(duration);

SwitchOff();

Console.WriteLine("Completed ITimerLight.TurnOnFor sequence.");

Al agregar ese cambio, la clase OverheadLight puede implementar la función de

temporizador mediante la declaración de la compatibilidad con la interfaz:

C#

public class OverheadLight : ITimerLight { }

Un tipo de luz diferente puede admitir un protocolo más sofisticado. Puede

proporcionar su propia implementación de TurnOnFor , como se muestra en el código
siguiente:

C#

public class HalogenLight : ITimerLight

private enum HalogenLightState

Off,

On,

TimerModeOn

private HalogenLightState state;

public void SwitchOn() => state = HalogenLightState.On;

public void SwitchOff() => state = HalogenLightState.Off;

public bool IsOn() => state != HalogenLightState.Off;

public async Task TurnOnFor(int duration)

Console.WriteLine("Halogen light starting timer function.");

state = HalogenLightState.TimerModeOn;

await Task.Delay(duration);

state = HalogenLightState.Off;

Console.WriteLine("Halogen light finished custom timer function");

public override string ToString() => $"The light is {state}";

A diferencia de los métodos de clase virtual de invalidación, la declaración de TurnOnFor

en la clase HalogenLight no utiliza la palabra clave override .

Funcionalidades de combinación
Las ventajas de los métodos de interfaz predeterminados resultan más claras a medida
que se introducen funcionalidades más avanzadas. El uso de interfaces permite
combinar las funcionalidades. También permite que cada autor de clase elija entre la
implementación predeterminada y una implementación personalizada. Vamos a agregar
una interfaz con una implementación predeterminada para una luz parpadeante:

C#

public interface IBlinkingLight : ILight

public async Task Blink(int duration, int repeatCount)

Console.WriteLine("Using the default interface method for

IBlinkingLight.Blink.");

for (int count = 0; count < repeatCount; count++)

SwitchOn();

await Task.Delay(duration);

SwitchOff();

await Task.Delay(duration);

Console.WriteLine("Done with the default interface method for

IBlinkingLight.Blink.");

La implementación predeterminada permite que cualquier luz parpadee. La luz de techo

puede agregar las funcionalidades de temporizador y de parpadeo mediante la
implementación predeterminada:

C#

public class OverheadLight : ILight, ITimerLight, IBlinkingLight

private bool isOn;

public bool IsOn() => isOn;

public void SwitchOff() => isOn = false;

public void SwitchOn() => isOn = true;

public override string ToString() => $"The light is {(isOn ? "on" :

"off")}";

Un nuevo tipo de luz, la clase LEDLight , admite la función de temporizador y la función

de parpadeo directamente. Este estilo de luz implementa las interfaces ITimerLight y
IBlinkingLight , e invalida el método Blink :

C#

public class LEDLight : IBlinkingLight, ITimerLight, ILight

private bool isOn;

public void SwitchOn() => isOn = true;

public void SwitchOff() => isOn = false;

public bool IsOn() => isOn;

public async Task Blink(int duration, int repeatCount)

Console.WriteLine("LED Light starting the Blink function.");

await Task.Delay(duration * repeatCount);

Console.WriteLine("LED Light has finished the Blink function.");

public override string ToString() => $"The light is {(isOn ? "on" :

"off")}";

La clase ExtraFancyLight podría admitir funciones de parpadeo y de temporizador

directamente:

C#

public class ExtraFancyLight : IBlinkingLight, ITimerLight, ILight

private bool isOn;

public void SwitchOn() => isOn = true;

public void SwitchOff() => isOn = false;

public bool IsOn() => isOn;

public async Task Blink(int duration, int repeatCount)

Console.WriteLine("Extra Fancy Light starting the Blink function.");

await Task.Delay(duration * repeatCount);

Console.WriteLine("Extra Fancy Light has finished the Blink

function.");

public async Task TurnOnFor(int duration)

Console.WriteLine("Extra Fancy light starting timer function.");

await Task.Delay(duration);

Console.WriteLine("Extra Fancy light finished custom timer

function");

 public override string ToString() => $"The light is {(isOn ? "on" :

"off")}";

La clase HalogenLight que ha creado anteriormente no admite el parpadeo. Por lo tanto,

no agregue la interfaz IBlinkingLight a la lista de interfaces compatibles.

Detección de tipos de luz mediante la

coincidencia de patrones
A continuación, vamos a escribir código de prueba. Puede usar la característica de C# de
coincidencia de patrones para determinar las funcionalidades de una luz mediante el
examen de las interfaces que admite. El método siguiente ejercita las funcionalidades
admitidas por cada luz:

C#

private static async Task TestLightCapabilities(ILight light)

// Perform basic tests:

light.SwitchOn();

Console.WriteLine($"\tAfter switching on, the light is {(light.IsOn() ?

"on" : "off")}");

light.SwitchOff();

Console.WriteLine($"\tAfter switching off, the light is {(light.IsOn() ?

"on" : "off")}");

if (light is ITimerLight timer)

Console.WriteLine("\tTesting timer function");

await timer.TurnOnFor(1000);

Console.WriteLine("\tTimer function completed");

else

Console.WriteLine("\tTimer function not supported.");

if (light is IBlinkingLight blinker)

Console.WriteLine("\tTesting blinking function");

await blinker.Blink(500, 5);

Console.WriteLine("\tBlink function completed");

else

Console.WriteLine("\tBlink function not supported.");

El código siguiente en el método Main crea cada tipo de luz secuencialmente y lo

prueba:

C#

static async Task Main(string[] args)

Console.WriteLine("Testing the overhead light");

var overhead = new OverheadLight();

await TestLightCapabilities(overhead);

Console.WriteLine();

Console.WriteLine("Testing the halogen light");

var halogen = new HalogenLight();

await TestLightCapabilities(halogen);

Console.WriteLine();

Console.WriteLine("Testing the LED light");

var led = new LEDLight();

await TestLightCapabilities(led);

Console.WriteLine();

Console.WriteLine("Testing the fancy light");

var fancy = new ExtraFancyLight();

await TestLightCapabilities(fancy);

Console.WriteLine();

Cómo determina el compilador la mejor

implementación
En este escenario se muestra una interfaz base sin ninguna implementación. Agregar un
método a la interfaz ILight presenta nuevas complejidades. Las reglas del lenguaje que
rigen los métodos de interfaz predeterminados minimizan el efecto en las clases
concretas que implementan varias interfaces derivadas. Vamos a mejorar la interfaz
original con un nuevo método para mostrar cómo cambia su uso. Cada luz del indicador
puede informar de su estado de energía como un valor enumerado:

C#

public enum PowerStatus

{

NoPower,

ACPower,

FullBattery,

MidBattery,

 LowBattery

La implementación predeterminada presupone la ausencia de alimentación:

C#

public interface ILight

void SwitchOn();

void SwitchOff();

bool IsOn();

public PowerStatus Power() => PowerStatus.NoPower;

Estos cambios se compilan correctamente, aunque la clase ExtraFancyLight declara la

compatibilidad con la interfaz de ILight y las interfaces derivadas ITimerLight y
IBlinkingLight . Solo hay una implementación "más cercana" declarada en la interfaz
ILight . Cualquier clase que declare una invalidación se convertirá en la implementación

"más cercana". Ha visto ejemplos en las clases anteriores que reemplazaron los
miembros de otras interfaces derivadas.

Evite reemplazar el mismo método en varias interfaces derivadas. Al hacerlo, se crea una
llamada de método ambiguo siempre que una clase implementa ambas interfaces
derivadas. El compilador no puede elegir un solo método mejor para que emita un
error. Por ejemplo, si tanto IBlinkingLight como ITimerLight implementaron una
invalidación de PowerStatus , OverheadLight tendría que proporcionar una invalidación
más específica. De lo contrario, el compilador no puede elegir entre las
implementaciones en las dos interfaces derivadas. Normalmente, puede evitar esta
situación al mantener las definiciones de interfaz pequeñas y centradas en una
característica. En este escenario, cada funcionalidad de una luz es su propia interfaz; solo
las clases heredan varias interfaces.

En este ejemplo se muestra un escenario en el que puede definir características discretas

que se pueden combinar en clases. Declare cualquier conjunto de funcionalidades
admitidas declarando qué interfaces admite una clase. El uso de métodos de interfaz
predeterminados virtuales permite a las clases usar o definir una implementación
diferente para cualquiera de los métodos de interfaz o para todos. Esta funcionalidad
del lenguaje proporciona nuevas formas de modelar los sistemas reales que se están
compilando. Los métodos de interfaz predeterminados proporcionan una forma más
clara de expresar clases relacionadas que pueden combinar con diferentes
características mediante implementaciones virtuales de esas funcionalidades.
Índices y rangos
Artículo • 18/01/2023 • Tiempo de lectura: 8 minutos

Los intervalos e índices proporcionan una sintaxis concisa para acceder a elementos
únicos o intervalos en una secuencia.

En este tutorial aprenderá lo siguiente:

＂ Usar la sintaxis para intervalos de una secuencia.

＂ Defina implícitamente un .Range
＂ Comprender las decisiones de diseño para iniciar y finalizar cada secuencia.
＂ Descubrir escenarios para los tipos Index y Range.

Compatibilidad con idiomas para los índices y

los rangos
Los índices y rangos proporcionan una sintaxis concisa para acceder a elementos únicos
o intervalos en una secuencia.

Esta compatibilidad con lenguajes se basa en dos nuevos tipos y dos nuevos
operadores:

System.Index representa un índice en una secuencia.

Índice desde el operador final ^ , que especifica que un índice es relativo al final de
una secuencia.
System.Range representa un subrango de una secuencia.
El operador de intervalo .. , que especifica el inicio y el final de un intervalo como
sus operandos.

Comencemos con las reglas de los índices. Considere un elemento sequence de matriz.
El índice 0 es igual que sequence[0] . El índice ^0 es igual que
sequence[sequence.Length] . La expresión sequence[^0] produce una excepción, al igual

que sequence[sequence.Length] . Para cualquier número n , el índice ^n es igual que

sequence.Length - n .

C#

string[] words = new string[]

// index from start index from end

"The", // 0 ^9

"quick", // 1 ^8

 "brown", // 2 ^7

"fox", // 3 ^6

"jumps", // 4 ^5

"over", // 5 ^4

"the", // 6 ^3

"lazy", // 7 ^2

"dog" // 8 ^1

}; // 9 (or words.Length) ^0

Puede recuperar la última palabra con el índice ^1 . Agregue el código siguiente a la

inicialización:

C#

Console.WriteLine($"The last word is {words[^1]}");

Un rango especifica el inicio y el final de un intervalo. El inicio del rango es inclusivo,

pero su final es exclusivo, lo que significa que el inicio se incluye en el rango, pero el
final no. El rango [0..^0] representa todo el intervalo, al igual que
[0..sequence.Length] representa todo el intervalo.

El siguiente código crea un subrango con las palabras "quick", "brown" y "fox". Va de
words[1] a words[3] . El elemento words[4] no se encuentra en el intervalo.

C#

string[] quickBrownFox = words[1..4];

foreach (var word in quickBrownFox)

Console.Write($"< {word} >");

Console.WriteLine();

El código siguiente devuelve el rango con "lazy" y "dog". Incluye words[^2] y words[^1] .
El índice del final words[^0] no se incluye. Agregue el código siguiente también:

C#

string[] lazyDog = words[^2..^0];

foreach (var word in lazyDog)

Console.Write($"< {word} >");

Console.WriteLine();

En los ejemplos siguientes se crean rangos con final abierto para el inicio, el final o
ambos:

C#
 string[] allWords = words[..]; // contains "The" through "dog".

string[] firstPhrase = words[..4]; // contains "The" through "fox"

string[] lastPhrase = words[6..]; // contains "the", "lazy" and "dog"

foreach (var word in allWords)

Console.Write($"< {word} >");

Console.WriteLine();

foreach (var word in firstPhrase)

Console.Write($"< {word} >");

Console.WriteLine();

foreach (var word in lastPhrase)

Console.Write($"< {word} >");

Console.WriteLine();

También puede declarar rangos o índices como variables. La variable se puede usar
luego dentro de los caracteres [ y ] :

C#

Index the = ^3;

Console.WriteLine(words[the]);

Range phrase = 1..4;

string[] text = words[phrase];

foreach (var word in text)

Console.Write($"< {word} >");

Console.WriteLine();

El ejemplo siguiente muestra muchos de los motivos para esas opciones. Modifique x ,
y y z para probar diferentes combinaciones. Al experimentar, use valores donde x sea

menor que y y y sea menor que z para las combinaciones válidas. Agregue el código
siguiente a un nuevo método. Pruebe diferentes combinaciones:

C#

int[] numbers = Enumerable.Range(0, 100).ToArray();

int x = 12;

int y = 25;

int z = 36;

Console.WriteLine($"{numbers[^x]} is the same as {numbers[numbers.Length -

x]}");

Console.WriteLine($"{numbers[x..y].Length} is the same as {y - x}");

Console.WriteLine("numbers[x..y] and numbers[y..z] are consecutive and

disjoint:");

Span<int> x_y = numbers[x..y];

Span<int> y_z = numbers[y..z];

Console.WriteLine($"\tnumbers[x..y] is {x_y[0]} through {x_y[^1]},

numbers[y..z] is {y_z[0]} through {y_z[^1]}");
 Console.WriteLine("numbers[x..^x] removes x elements at each end:");

Span<int> x_x = numbers[x..^x];

Console.WriteLine($"\tnumbers[x..^x] starts with {x_x[0]} and ends with

{x_x[^1]}");

Console.WriteLine("numbers[..x] means numbers[0..x] and numbers[x..] means

numbers[x..^0]");

Span<int> start_x = numbers[..x];

Span<int> zero_x = numbers[0..x];

Console.WriteLine($"\t{start_x[0]}..{start_x[^1]} is the same as

{zero_x[0]}..{zero_x[^1]}");

Span<int> z_end = numbers[z..];

Span<int> z_zero = numbers[z..^0];

Console.WriteLine($"\t{z_end[0]}..{z_end[^1]} is the same as {z_zero[0]}..

{z_zero[^1]}");

No solo las matrices admiten índices y rangos. También puede usar índices y rangos con
string, Span<T> o ReadOnlySpan<T>.

Conversiones implícitas de expresiones de operador de

intervalo
Cuando se usa la sintaxis de expresión de operador de intervalo, el compilador convierte
implícitamente los valores inicial y final en y Index desde ellos, crea una nueva Range
instancia. En el código siguiente se muestra una conversión implícita de ejemplo de la
sintaxis de expresión de operador de intervalo y su alternativa explícita correspondiente:

C#

Range implicitRange = 3..^5;

Range explicitRange = new(

start: new Index(value: 3, fromEnd: false),

end: new Index(value: 5, fromEnd: true));

if (implicitRange.Equals(explicitRange))

Console.WriteLine(

$"The implicit range '{implicitRange}' equals the explicit range

'{explicitRange}'");

// Sample output:

// The implicit range '3..^5' equals the explicit range '3..^5'

） Importante
 Las conversiones implícitas de Int32 a inician Index cuando
ArgumentOutOfRangeException el valor es negativo. Del mismo modo, el Index
constructor produce una ArgumentOutOfRangeException excepción cuando el value
parámetro es negativo.

Compatibilidad con tipos para los índices y los

rangos
Los índices y los intervalos proporcionan una sintaxis clara y concisa para acceder a un
único elemento o a un rango de elementos de una secuencia. Normalmente, una
expresión de índice devuelve el tipo de los elementos de una secuencia. Una expresión
de rango suele devolver el mismo tipo de secuencia que la secuencia de origen.

Cualquier tipo que proporcione un indexador con un parámetro Index o Range admite
de manera explícita índices o rangos, respectivamente. Un indexador que toma un único
parámetro Range puede devolver un tipo de secuencia diferente, como
System.Span<T>.

） Importante

El rendimiento del código que usa el operador de rango depende del tipo del
operando de la secuencia.

La complejidad temporal del operador de rango depende del tipo de secuencia.

Por ejemplo, si la secuencia es un valor string o una matriz, el resultado es una
copia de la sección especificada de la entrada, por lo que la complejidad temporal
es O(N) (donde N es la longitud del rango). Por otro lado, si se trata de
System.Span<T> o System.Memory<T>, el resultado hace referencia a la misma
memoria auxiliar, lo que significa que no hay ninguna copia y que la operación es
O(1) .

Además de la complejidad temporal, esto provoca asignaciones y copias

adicionales, lo que afecta al rendimiento. En el código sensible al rendimiento,
considere la posibilidad de usar Span<T> o Memory<T> como el tipo de secuencia, ya
que el operador de rango no realiza la asignación.

Un tipo es contable si tiene una propiedad denominada Length o Count con un

captador accesible y un tipo de valor devuelto de int . Un tipo contable que no admite
índices ni rangos de manera explícita podría admitirlos implícitamente. Para más
información, consulte las secciones Compatibilidad implícita de índices y Compatibilidad
implícita de rangos de la nota de propuesta de características. Los rangos que usan la
compatibilidad implícita del rango devuelven el mismo tipo de secuencia que la
secuencia de origen.

Por ejemplo, los tipos de .NET siguientes admiten tanto índices como rangos: String,
Span<T> y ReadOnlySpan<T>. List<T> admite índices, pero no rangos.

Array tiene un comportamiento con más matices. Así, las matrices de una sola
dimensión admiten índices y rangos, Las matrices multidimensionales no admiten
indexadores o rangos. El indexador de una matriz multidimensional tiene varios
parámetros, no un parámetro único. Las matrices escalonadas, también denominadas
matriz de matrices, admiten tanto intervalos como indexadores. En el siguiente ejemplo
se muestra cómo iterar por una subsección rectangular de una matriz escalonada. Se
itera por la sección del centro, excluyendo la primera y las últimas tres filas, así como la
primera y las dos últimas columnas de cada fila seleccionada:

C#

var jagged = new int[10][]

new int[10] { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 },

new int[10] { 10,11,12,13,14,15,16,17,18,19 },

new int[10] { 20,21,22,23,24,25,26,27,28,29 },

new int[10] { 30,31,32,33,34,35,36,37,38,39 },

new int[10] { 40,41,42,43,44,45,46,47,48,49 },

new int[10] { 50,51,52,53,54,55,56,57,58,59 },

new int[10] { 60,61,62,63,64,65,66,67,68,69 },

new int[10] { 70,71,72,73,74,75,76,77,78,79 },

new int[10] { 80,81,82,83,84,85,86,87,88,89 },

new int[10] { 90,91,92,93,94,95,96,97,98,99 },

};

var selectedRows = jagged[3..^3];

foreach (var row in selectedRows)

var selectedColumns = row[2..^2];

foreach (var cell in selectedColumns)

Console.Write($"{cell}, ");

Console.WriteLine();

En todos los casos, el operador de rango para Array asigna una matriz para almacenar
los elementos devueltos.
Escenarios para los índices y los rangos
A menudo usará rangos e índices cuando quiera analizar una parte de una secuencia
más grande. La nueva sintaxis es más clara al leer exactamente qué parte de la
secuencia está implicada. La función local MovingAverage toma un Range como su
argumento. El método enumera solo ese rango al calcular el mínimo, el máximo y la
media. Pruebe con el código siguiente en su proyecto:

C#

int[] sequence = Sequence(1000);

for(int start = 0; start < sequence.Length; start += 100)

Range r = start..(start+10);

var (min, max, average) = MovingAverage(sequence, r);

Console.WriteLine($"From {r.Start} to {r.End}: \tMin: {min},\tMax:

{max},\tAverage: {average}");

for (int start = 0; start < sequence.Length; start += 100)

Range r = ^(start + 10)..^start;

var (min, max, average) = MovingAverage(sequence, r);

Console.WriteLine($"From {r.Start} to {r.End}: \tMin: {min},\tMax:

{max},\tAverage: {average}");

(int min, int max, double average) MovingAverage(int[] subSequence, Range

range) =>

subSequence[range].Min(),
subSequence[range].Max(),
subSequence[range].Average()

);

int[] Sequence(int count) =>

Enumerable.Range(0, count).Select(x => (int)(Math.Sqrt(x) *

100)).ToArray();

Apunte sobre índices de rango y matrices

Al tomar un rango de una matriz, el resultado es una matriz que se copia de la matriz
inicial, en lugar de hacer referencia a esta. Modificar los valores de la matriz resultante
no cambiará los de la inicial.

Por ejemplo:
C#

var arrayOfFiveItems = new[] { 1, 2, 3, 4, 5 };

var firstThreeItems = arrayOfFiveItems[..3]; // contains 1,2,3

firstThreeItems[0] = 11; // now contains 11,2,3

Console.WriteLine(string.Join(",", firstThreeItems));

Console.WriteLine(string.Join(",", arrayOfFiveItems));

// output:

// 11,2,3

// 1,2,3,4,5

Tutorial: Expresar la intención del diseño

con mayor claridad con tipos de
referencia que aceptan valores NULL y
que no aceptan valores NULL
Artículo • 28/11/2022 • Tiempo de lectura: 12 minutos

Los tipos de referencia que aceptan valores NULL complementan los tipos de referencia
de la misma manera que los tipos de valor que aceptan valores NULL complementan los
tipos de valor. Declarará una variable para que sea un tipo de referencia que acepta
valores NULL anexando un elemento ? al tipo. Por ejemplo, string? representa un
elemento string que acepta valores NULL. Puede utilizar estos nuevos tipos para
expresar más claramente la intención del diseño: algunas variables siempre deben tener
un valor, y a otras les puede faltar un valor.

En este tutorial aprenderá lo siguiente:

＂ Incorporar los tipos de referencia que aceptan valores NULL y que no aceptan
valores NULL en los diseños
＂ Habilitar las comprobaciones de tipos de referencia que aceptan valores NULL en
todo el código
＂ Escribir código en la parte en la que el compilador aplica esas decisiones de diseño
＂ Usar la característica de referencia que acepta valores NULL en sus propios diseños

Requisitos previos
Deberá configurar la máquina para ejecutar .NET, incluido el compilador de C#. El
compilador de C# está disponible con Visual Studio 2022 o el SDK de .NET .

En este tutorial se da por supuesto que conoce bien C# y. NET, incluidos Visual Studio o
la CLI de .NET.

Incorporación de los tipos de referencia que

aceptan valores NULL en los diseños
En este tutorial, va a crear una biblioteca que modela la ejecución de una encuesta. El
código usa tipos de referencia que aceptan valores NULL y tipos de referencia que no
aceptan valores NULL para representar los conceptos del mundo real. Las preguntas de
la encuesta nunca pueden aceptar valores NULL. Un encuestado podría preferir no
responder a una pregunta. En este caso, las respuestas podrían ser null .

El código que escriba para este ejemplo expresa dicha intención y el compilador la
exige.

Creación de la aplicación y habilitación de los

tipos de referencia que aceptan valores NULL
Cree una aplicación de consola en Visual Studio o desde la línea de comandos mediante
dotnet new console . Asigne a la aplicación el nombre NullableIntroduction . Una vez

que se haya creado la aplicación, se deberá especificar que todo el proyecto se compila
en un contexto de anotaciones que admite un valor NULL habilitado. Abra el archivo
.csproj y agregue un elemento Nullable al elemento PropertyGroup . Establezca su valor
en enable . Debe participar en la característica de tipos de referencia que aceptan
valores NULL en proyectos anteriores a C# 11. El motivo es que, una vez que la
característica está activada, las declaraciones de variables de referencia existentes se
convierten en tipos de referencia que no aceptan valores NULL. Aunque esa decisión lo
ayudará a detectar problemas donde el código existente puede no tener
comprobaciones de valores NULL adecuadas, es posible que no se refleje con precisión
la intención del diseño original:

XML

<Nullable>enable</Nullable>

Antes de .NET 6, los nuevos proyectos no incluyen el elemento Nullable . A partir de

.NET 6, los proyectos nuevos incluyen el elemento <Nullable>enable</Nullable> en el
archivo del proyecto.

Diseño de los tipos para la aplicación

Esta aplicación de encuesta requiere la creación de una serie de clases:

Una clase que modela la lista de preguntas

Una clase que modela una lista de personas contactadas para la encuesta
Una clase que modela las respuestas de una persona que realizó la encuesta

Estos tipos usarán ambas los tipos de referencia que aceptan valores NULL y los que no
aceptan valores NULL para expresar qué miembros que son necesarios y cuáles
opcionales. Los tipos de referencia que aceptan valores NULL comunican claramente esa
intención de diseño:

Las preguntas que forman parte de la encuesta nunca pueden ser NULL: no tiene
sentido formular una pregunta vacía.
Los encuestados nunca pueden aceptar valores NULL. Quiere realizar un
seguimiento de las personas contactadas, incluso de los encuestados que han
rechazado participar.
Cualquier respuesta a una pregunta puede tener valores NULL. Los encuestados
pueden negarse a responder a algunas preguntas o a todas.

Si ha programado en C#, puede estar tan acostumbrado a los tipos de referencia que
permiten valores null que puede haber perdido otras oportunidades para declarar
instancias que no admiten un valor NULL:

La colección de preguntas no debe aceptar valores NULL.

La colección de encuestados debe aceptar valores NULL.

A medida que escriba el código, verá que un tipo de referencia que no admite un valor
NULL, como el predeterminado para las referencias, evita errores comunes que podrían
generar NullReferenceException. Una lección de este tutorial es que tomó decisiones
sobre qué variables podrían ser o no null . El lenguaje no proporcionó una sintaxis para
expresar esas decisiones. Ahora sí.

La aplicación que compilará realiza los pasos siguientes:

1. Crea una encuesta y agrega preguntas a dicha encuesta.

2. Crea un conjunto de encuestados pseudoaleatorios para la encuesta.
3. Se pone en contacto con los encuestados hasta que el tamaño de la encuesta
completada alcanza el número objetivo.
4. Escribe estadísticas importantes en las respuestas de la encuesta.

Compilación de la encuesta con tipos de

referencia que aceptan y no aceptan valores
NULL
El primer código que escriba crea la encuesta. Deberá escribir clases para modelar una
pregunta de encuesta y una ejecución de encuesta. La encuesta tiene tres tipos de
preguntas, que se distinguen por el formato de la respuesta: respuestas
afirmativas/negativas, respuestas numéricas y respuestas de texto. Cree una clase public
SurveyQuestion :
 C#

namespace NullableIntroduction

public class SurveyQuestion

El compilador interpreta cada declaración de variable de tipo de referencia como un

tipo de referencia que no admite un valor NULL para el código en un contexto de
anotaciones que admite un valor NULL habilitado. Puede ver la primera advertencia
agregando propiedades para el texto de la pregunta y el tipo de pregunta, tal y como se
muestra en el código siguiente:

C#

namespace NullableIntroduction

public enum QuestionType

YesNo,

Number,

Text

public class SurveyQuestion

public string QuestionText { get; }

public QuestionType TypeOfQuestion { get; }

Dado que no ha inicializado QuestionText , el compilador emite una advertencia de que

aún no se ha inicializado una propiedad que no acepta valores NULL. Su diseño requiere
que el texto de la pregunta no acepte valores NULL, por lo que debe agregar un
constructor para inicializar ese elemento y el valor QuestionType también. La definición
de clase finalizada es similar al código siguiente:

C#

namespace NullableIntroduction;

public enum QuestionType

YesNo,

Number,

Text

public class SurveyQuestion

public string QuestionText { get; }

public QuestionType TypeOfQuestion { get; }

public SurveyQuestion(QuestionType typeOfQuestion, string text) =>

(TypeOfQuestion, QuestionText) = (typeOfQuestion, text);

Al agregar el constructor, se quita la advertencia. El argumento del constructor también

es un tipo de referencia que no acepta valores NULL, por lo que el compilador no emite
advertencias.

A continuación, cree una clase public denominada " SurveyRun ". Esta clase contiene una
lista de objetos SurveyQuestion y métodos para agregar preguntas a la encuesta, tal
como se muestra en el código siguiente:

C#

using System.Collections.Generic;

namespace NullableIntroduction

public class SurveyRun

private List<SurveyQuestion> surveyQuestions = new

List<SurveyQuestion>();

public void AddQuestion(QuestionType type, string question) =>

AddQuestion(new SurveyQuestion(type, question));

public void AddQuestion(SurveyQuestion surveyQuestion) =>

surveyQuestions.Add(surveyQuestion);

Al igual que antes, debe inicializar el objeto de lista en un valor distinto a NULL o el
compilador emitirá una advertencia. No hay ninguna comprobación de valores que
aceptan valores NULL en la segunda sobrecarga de AddQuestion porque no son
necesarias: ha declarado esa variable para que no acepte valores NULL. Su valor no
puede ser null .

Cambie a Program.cs en el editor y reemplace el contenido de Main con las siguientes

líneas de código:

C#
 var surveyRun = new SurveyRun();

surveyRun.AddQuestion(QuestionType.YesNo, "Has your code ever thrown a

NullReferenceException?");

surveyRun.AddQuestion(new SurveyQuestion(QuestionType.Number, "How many

times (to the nearest 100) has that happened?"));

surveyRun.AddQuestion(QuestionType.Text, "What is your favorite color?");

Dado que todo el proyecto está habilitado para un contexto de anotaciones que admite
un valor NULL, al pasar null a cualquier método que espera un tipo de referencia que
no admite un valor NULL, recibirá una advertencia. Pruébelo agregando la siguiente
línea a Main :

C#

surveyRun.AddQuestion(QuestionType.Text, default);

Creación de los encuestados y obtención de

respuestas a la encuesta
A continuación, escriba el código que genera respuestas a la encuesta. Este proceso
implica realizar varias pequeñas tareas:

1. Crear un método que genere objetos de encuestados. Estos representan a las

personas a las que se les ha pedido que completen la encuesta.
2. Crear una lógica para simular la realización de preguntas a un encuestado y la
recopilación de respuestas o de la ausencia de respuesta de un encuestado.
3. Repetir todo esto hasta que hayan respondido a la encuesta los suficientes
encuestados.

Necesitará una clase para representar una respuesta de encuesta, así que agréguela en
este momento. Habilite la compatibilidad con la aceptación de valores NULL. Agregue
una propiedad Id y un constructor que la inicialice, tal como se muestra en el código
siguiente:

C#

namespace NullableIntroduction

public class SurveyResponse

public int Id { get; }

public SurveyResponse(int id) => Id = id;

A continuación, agregue un método static para crear nuevos participantes mediante la

generación de un identificador aleatorio:

C#

private static readonly Random randomGenerator = new Random();

public static SurveyResponse GetRandomId() => new

SurveyResponse(randomGenerator.Next());

La responsabilidad principal de esta clase es generar las respuestas para que un

participante de las preguntas de la encuesta. Esta responsabilidad implica una serie de
pasos:

1. Solicitar la participación en la encuesta. Si la persona no da su consentimiento,

devolver una respuesta con valores ausentes (o NULL).
2. Realizar cada pregunta y registrar la respuesta. Las respuestas también pueden
tener valores ausentes (o NULL).

Agregue el siguiente código a la clase SurveyResponse :

C#

private Dictionary<int, string>? surveyResponses;

public bool AnswerSurvey(IEnumerable<SurveyQuestion> questions)

if (ConsentToSurvey())

surveyResponses = new Dictionary<int, string>();

int index = 0;

foreach (var question in questions)

var answer = GenerateAnswer(question);

if (answer != null)

surveyResponses.Add(index, answer);

index++;

return surveyResponses != null;

private bool ConsentToSurvey() => randomGenerator.Next(0, 2) == 1;

private string? GenerateAnswer(SurveyQuestion question)

 switch (question.TypeOfQuestion)

case QuestionType.YesNo:

int n = randomGenerator.Next(-1, 2);

return (n == -1) ? default : (n == 0) ? "No" : "Yes";

case QuestionType.Number:
n = randomGenerator.Next(-30, 101);

return (n < 0) ? default : n.ToString();

case QuestionType.Text:

default:

switch (randomGenerator.Next(0, 5))

case 0:
return default;

case 1:
return "Red";

case 2:
return "Green";

case 3:
return "Blue";

return "Red. No, Green. Wait.. Blue... AAARGGGGGHHH!";

El almacenamiento de las respuestas de la encuesta es una cadena Dictionary<int,

string>? , que indica que puede aceptar valores NULL. Está usando la nueva

característica de lenguaje para declarar la intención de diseño tanto para el compilador

como para cualquiera que lea el código más adelante. Si alguna vez desreferencia
surveyResponses sin comprobar el valor null en primer lugar, obtendrá una advertencia

del compilador. No recibirá una advertencia en el método AnswerSurvey porque el

compilador puede determinar que la variable surveyResponses se estableció en un valor
distinto de NULL.

Al usar null en las respuestas que faltan se resalta un punto clave para trabajar con
tipos de referencia que aceptan valores NULL: el objetivo no es quitar todos los valores
null del programa. En cambio, de lo que se trata es de garantizar que el código que
escribe expresa la intención del diseño. Los valores que faltan son un concepto
necesario para expresar en el código. El valor null es una forma clara de expresar los
valores que faltan. El intento de quitar todos los valores null solo lleva a definir alguna
otra forma de expresar esos valores que faltan sin null .

A continuación, deberá escribir el método PerformSurvey en la clase SurveyRun .

Agregue el código siguiente a la clase SurveyRun :

C#
 private List<SurveyResponse>? respondents;

public void PerformSurvey(int numberOfRespondents)

int respondentsConsenting = 0;

respondents = new List<SurveyResponse>();

while (respondentsConsenting < numberOfRespondents)

var respondent = SurveyResponse.GetRandomId();

if (respondent.AnswerSurvey(surveyQuestions))

respondentsConsenting++;

respondents.Add(respondent);

De nuevo, la elección de que un elemento List<SurveyResponse>? acepte valores NULL

indica que la respuesta puede tener valores NULL. Esto indica que la encuesta no se ha
asignado a los encuestados todavía. Tenga en cuenta que los encuestados se agregan
hasta que hayan dado su consentimiento.

El último paso para ejecutar la encuesta es agregar una llamada al realizar la encuesta al
final del método Main :

C#

surveyRun.PerformSurvey(50);

Examen de las respuestas de la encuesta

El último paso es mostrar los resultados de la encuesta. Agregará código a muchas de
las clases que ha escrito. Este código muestra el valor de distinguir entre tipos de
referencia que aceptan valores NULL y que no aceptan valores NULL. Empiece
agregando los siguientes dos miembros con forma de expresión a la clase
SurveyResponse :

C#

public bool AnsweredSurvey => surveyResponses != null;

public string Answer(int index) => surveyResponses?.GetValueOrDefault(index)

?? "No answer";

Dado que surveyResponses es un tipo de referencia que admite un valor NULL, las
comprobaciones de valores NULL son necesarias antes de desreferenciarlo. El método
Answer devuelve una cadena que no admite un valor NULL, por lo que tenemos que

cubrir el caso de que falte una respuesta mediante el operador de fusión de NULL.
A continuación, agregue estos tres miembros con forma de expresión a la clase
SurveyRun :

C#

public IEnumerable<SurveyResponse> AllParticipants => (respondents ??

Enumerable.Empty<SurveyResponse>());

public ICollection<SurveyQuestion> Questions => surveyQuestions;

public SurveyQuestion GetQuestion(int index) => surveyQuestions[index];

El miembro AllParticipants debe tener en cuenta que la variable respondents podría

ser aceptar valores NULL, pero el valor devuelto no puede ser NULL. Si cambia esa
expresión quitando ?? y la secuencia vacía de a continuación, el compilador advertirá
de que el método podría devolver null y su firma de devolución devuelve un tipo que
no acepta valores NULL.

Finalmente, agregue el siguiente bucle a la parte inferior del método Main :

C#

foreach (var participant in surveyRun.AllParticipants)

Console.WriteLine($"Participant: {participant.Id}:");

if (participant.AnsweredSurvey)

for (int i = 0; i < surveyRun.Questions.Count; i++)

var answer = participant.Answer(i);

Console.WriteLine($"\t{surveyRun.GetQuestion(i).QuestionText} :
{answer}");

else

Console.WriteLine("\tNo responses");

No necesita ninguna comprobación null en este código porque ha diseñado las

interfaces subyacentes para que devuelvan todos los tipos de referencia que no aceptan
valores NULL.

Obtención del código

Puede obtener el código del tutorial terminado en nuestro repositorio de ejemplos en
la carpeta csharp/NullableIntroduction .
Experimente cambiando las declaraciones de tipos entre tipos de referencia que aceptan
valores NULL y que no aceptan valores NULL. Vea cómo así se generan advertencias
diferentes para garantizar que no se desreferencia accidentalmente un valor null .

Pasos siguientes
Obtenga información sobre cómo usar tipos de referencia que aceptan valores NULL al
utilizar Entity Framework:

Aspectos básicos de Entity Framework Core: trabajo con tipos de referencia que
aceptan valores NULL
Tutorial: Generación y uso de secuencias
asincrónicas con C# y .NET
Artículo • 20/02/2023 • Tiempo de lectura: 10 minutos

Las secuencias asincrónicas modelan un origen de datos de streaming. Las secuencias

de datos suelen recuperar o generar elementos de forma asincrónica. Proporcionan un
modelo de programación natural para los orígenes de datos de streaming asincrónicos.

En este tutorial aprenderá lo siguiente:

＂ Crear un origen de datos que genera una secuencia de elementos de datos de

forma asincrónica.
＂ Utilizar ese origen de datos de forma asincrónica.
＂ Admitir la cancelación y los contextos capturados para secuencias asincrónicas.
＂ Reconocer cuándo la interfaz y el origen de datos nuevos son preferibles a las
secuencias de datos sincrónicas anteriores.

Requisitos previos
Deberá configurar el equipo para que ejecute .NET, incluido el compilador de C#. El
compilador de C# está disponible con Visual Studio 2022 o el SDK de .NET .

Deberá crear un token de acceso de GitHub para poder tener acceso al punto de
conexión de GraphQL de GitHub. Seleccione los siguientes permisos para el token de
acceso de GitHub:

repo:status
public_repo

Guarde el token de acceso en un lugar seguro para usarlo a fin de obtener acceso al
punto de conexión de API de GitHub.

２ Advertencia

Mantenga seguro su token de acceso personal. Cualquier software con su token de

acceso personal podría realizar llamadas de API de GitHub con sus derechos de
acceso.

En este tutorial se da por supuesto que conoce bien C# y. NET, incluidos Visual Studio o
la CLI de .NET.
Ejecución de la aplicación de inicio
Puede obtener el código para la aplicación de inicio usada en este tutorial en el
repositorio dotnet/docs de la carpeta csharp/whats-new/tutorials .

La aplicación de inicio es una aplicación de consola que usa la interfaz GraphQL de

GitHub para recuperar las incidencias recientes escritas en el repositorio
dotnet/docs . Comience por mirar el código siguiente para el método Main de la
aplicación de inicio:

C#

static async Task Main(string[] args)

//Follow these steps to create a GitHub Access Token

// https://help.github.com/articles/creating-a-personal-access-token-
for-the-command-line/#creating-a-token

//Select the following permissions for your GitHub Access Token:

// - repo:status

// - public_repo

// Replace the 3rd parameter to the following code with your GitHub
access token.

var key = GetEnvVariable("GitHubKey",

"You must store your GitHub key in the 'GitHubKey' environment

variable",

"");

var client = new GitHubClient(new

Octokit.ProductHeaderValue("IssueQueryDemo"))

Credentials = new Octokit.Credentials(key)

};

var progressReporter = new progressStatus((num) =>

Console.WriteLine($"Received {num} issues in total");

});

CancellationTokenSource cancellationSource = new

CancellationTokenSource();

try

var results = await RunPagedQueryAsync(client, PagedIssueQuery,

"docs",

cancellationSource.Token, progressReporter);

foreach(var issue in results)

Console.WriteLine(issue);

catch (OperationCanceledException)

Console.WriteLine("Work has been cancelled");

Puede establecer una variable de entorno GitHubKey para el token de acceso personal, o
bien puede reemplazar el último argumento en la llamada a GetEnvVariable por el
token de acceso personal. No coloque el código de acceso en el código fuente si va a
compartir el origen con otros usuarios. No cargue nunca códigos de acceso en un
repositorio de código fuente compartido.

Después de crear el cliente de GitHub, el código de Main crea un objeto de informe de

progreso y un token de cancelación. Una vez que se crean esos objetos, Main llama a
RunPagedQueryAsync para recuperar las 250 incidencias creadas más recientemente. Una

vez finalizada esa tarea, se muestran los resultados.

Al ejecutar la aplicación inicial, puede realizar algunas observaciones importantes acerca

de cómo se ejecuta esta aplicación. Verá el progreso notificado para cada página
devuelta desde GitHub. Puede observar una pausa marcada antes de que GitHub
devuelva cada nueva página de incidencias. Por último, se muestran las incidencias solo
después de que se hayan recuperado 10 páginas de GitHub.

Examen de la implementación
La implementación revela por qué observó el comportamiento descrito en la sección
anterior. Examine el código de RunPagedQueryAsync :

C#

private static async Task<JArray> RunPagedQueryAsync(GitHubClient client,

string queryText, string repoName, CancellationToken cancel, IProgress<int>
progress)

var issueAndPRQuery = new GraphQLRequest

Query = queryText

};

issueAndPRQuery.Variables["repo_name"] = repoName;

JArray finalResults = new JArray();

bool hasMorePages = true;

int pagesReturned = 0;

int issuesReturned = 0;

// Stop with 10 pages, because these are large repos:

while (hasMorePages && (pagesReturned++ < 10))

var postBody = issueAndPRQuery.ToJsonText();

 var response = await client.Connection.Post<string>(new

Uri("https://api.github.com/graphql"),

postBody, "application/json", "application/json");

JObject results =
JObject.Parse(response.HttpResponse.Body.ToString()!);

int totalCount = (int)issues(results)["totalCount"]!;

hasMorePages = (bool)pageInfo(results)["hasPreviousPage"]!;

issueAndPRQuery.Variables["start_cursor"] = pageInfo(results)
["startCursor"]!.ToString();

issuesReturned += issues(results)["nodes"]!.Count();

finalResults.Merge(issues(results)["nodes"]!);

progress?.Report(issuesReturned);

cancel.ThrowIfCancellationRequested();

return finalResults;

JObject issues(JObject result) => (JObject)result["data"]!

["repository"]!["issues"]!;

JObject pageInfo(JObject result) => (JObject)issues(result)

["pageInfo"]!;

Vamos a concentrarnos en el algoritmo de paginación y la estructura asincrónica del

código anterior. (Puede consultar la documentación de GraphQL de GitHub para
obtener más información sobre la API de GraphQL de GitHub). El método
RunPagedQueryAsync enumera las incidencias desde la más reciente hasta la más antigua.

Solicita 25 incidencias por página y examina la estructura pageInfo de la respuesta para

continuar con la página anterior. Eso sigue al soporte de paginación estándar de
GraphQL para respuestas de varias páginas. La respuesta incluye un objeto pageInfo
que incluye a su vez un valor hasPreviousPages y un valor startCursor usado para
solicitar la página anterior. Las incidencias se encuentran en la matriz nodes . El método
RunPagedQueryAsync anexa estos nodos a una matriz que contiene todos los resultados

de todas las páginas.

Después de recuperar y restaurar una página de resultados, RunPagedQueryAsync informa

del progreso y comprueba la cancelación. Si se ha solicitado la cancelación,
RunPagedQueryAsync lanza un OperationCanceledException.

Hay varios elementos en este código que se pueden mejorar. Lo más importante,
RunPagedQueryAsync debe asignar el almacenamiento para todas las incidencias
devueltas. Este ejemplo se detiene en 250 incidencias porque la recuperación de todas
las incidencias abiertas requeriría mucha más memoria para almacenar todas las
incidencias recuperadas. Los protocolos para admitir los informes de progreso y la
cancelación hacen que el algoritmo sea más difícil de comprender en su primera lectura.
Hay más tipos y API implicados. Debe realizar un seguimiento de las comunicaciones a
través de CancellationTokenSource y su CancellationToken asociado para comprender
dónde se solicita la cancelación y dónde se concede.

Las secuencias asincrónicas ofrecen una

manera mejor
Las secuencias asincrónicas y el lenguaje asociado abordan todas estas cuestiones. El
código que genera la secuencia ahora puede usar yield return para devolver los
elementos en un método que se declaró con el modificador async . Puede usar una
secuencia asincrónica utilizando un bucle await foreach igual que puede usar una
secuencia mediante un bucle foreach .

Estas nuevas características del lenguaje dependen de tres nuevas interfaces agregadas
a .NET Standard 2.1 e implementadas en .NET Core 3.0:

System.Collections.Generic.IAsyncEnumerable<T>
System.Collections.Generic.IAsyncEnumerator<T>
System.IAsyncDisposable

Estas tres interfaces deben resultar familiares a la mayoría de desarrolladores de C#. Se

comportan de manera similar con sus contrapartes sincrónicas:

System.Collections.Generic.IEnumerable<T>
System.Collections.Generic.IEnumerator<T>
System.IDisposable

Un tipo que podría ser desconocido es System.Threading.Tasks.ValueTask. La estructura

ValueTask proporciona una API similar a la clase System.Threading.Tasks.Task. ValueTask

se usa en estas interfaces por motivos de rendimiento.

Conversión en secuencias asincrónicas

A continuación, convierta el método RunPagedQueryAsync para generar una secuencia
asincrónica. En primer lugar, cambie la signatura de RunPagedQueryAsync para que
devuelva un IAsyncEnumerable<JToken> y quite el token de cancelación y los objetos de
progreso de la lista de parámetros como se muestra en el código siguiente:

C#

private static async IAsyncEnumerable<JToken>

RunPagedQueryAsync(GitHubClient client,

 string queryText, string repoName)

El código de inicio procesa cada página a medida que se recupera, tal como se muestra
en el código siguiente:

C#

finalResults.Merge(issues(results)["nodes"]!);

progress?.Report(issuesReturned);
cancel.ThrowIfCancellationRequested();

Reemplace esas tres líneas por el código siguiente:

C#

foreach (JObject issue in issues(results)["nodes"]!)

yield return issue;

También puede quitar la declaración de finalResults anteriormente en este método y

la instrucción return que sigue al bucle modificado.

Ha terminado los cambios para generar una secuencia asincrónica. El método finalizado
debería ser similar al código siguiente:

C#

private static async IAsyncEnumerable<JToken>

RunPagedQueryAsync(GitHubClient client,

string queryText, string repoName)

var issueAndPRQuery = new GraphQLRequest

Query = queryText

};

issueAndPRQuery.Variables["repo_name"] = repoName;

bool hasMorePages = true;

int pagesReturned = 0;

int issuesReturned = 0;

// Stop with 10 pages, because these are large repos:

while (hasMorePages && (pagesReturned++ < 10))

var postBody = issueAndPRQuery.ToJsonText();

var response = await client.Connection.Post<string>(new

Uri("https://api.github.com/graphql"),

postBody, "application/json", "application/json");

JObject results =
 JObject.Parse(response.HttpResponse.Body.ToString()!);

int totalCount = (int)issues(results)["totalCount"]!;

hasMorePages = (bool)pageInfo(results)["hasPreviousPage"]!;

issueAndPRQuery.Variables["start_cursor"] = pageInfo(results)
["startCursor"]!.ToString();

issuesReturned += issues(results)["nodes"]!.Count();

foreach (JObject issue in issues(results)["nodes"]!)

yield return issue;

JObject issues(JObject result) => (JObject)result["data"]!

["repository"]!["issues"]!;

JObject pageInfo(JObject result) => (JObject)issues(result)

["pageInfo"]!;

A continuación, cambie el código que utiliza la colección para usar la secuencia

asincrónica. Busque el código siguiente en Main que procesa la colección de incidencias:

C#

var progressReporter = new progressStatus((num) =>

Console.WriteLine($"Received {num} issues in total");

});

CancellationTokenSource cancellationSource = new CancellationTokenSource();

try

var results = await RunPagedQueryAsync(client, PagedIssueQuery, "docs",

cancellationSource.Token, progressReporter);

foreach(var issue in results)

Console.WriteLine(issue);
}

catch (OperationCanceledException)

Console.WriteLine("Work has been cancelled");

Reemplace el código por el siguiente bucle await foreach :

C#

int num = 0;

await foreach (var issue in RunPagedQueryAsync(client, PagedIssueQuery,

"docs"))

Console.WriteLine(issue);

 Console.WriteLine($"Received {++num} issues in total");

La nueva interfaz IAsyncEnumerator<T> deriva de IAsyncDisposable. Esto significa que

el bucle anterior desechará la secuencia de forma asincrónica cuando finalice el bucle.
Como imaginará, el bucle es similar al código siguiente:

C#

int num = 0;

var enumerator = RunPagedQueryAsync(client, PagedIssueQuery,

"docs").GetEnumeratorAsync();

try

while (await enumerator.MoveNextAsync())

var issue = enumerator.Current;

Console.WriteLine(issue);
Console.WriteLine($"Received {++num} issues in total");

} finally

if (enumerator != null)

await enumerator.DisposeAsync();

Los elementos de secuencia se procesan de forma predeterminada en el contexto

capturado. Si quiere deshabilitar la captura del contexto, use el método de extensión
TaskAsyncEnumerableExtensions.ConfigureAwait. Para obtener más información sobre
los contextos de sincronización y la captura del contexto actual, vea el artículo sobre el
consumo del patrón asincrónico basado en tareas.

Las secuencias asincrónicas admiten la cancelación mediante el mismo protocolo que

otros métodos async . Para admitir la cancelación, debe modificar la firma del método
de iterador asincrónico como se indica a continuación:

C#

private static async IAsyncEnumerable<JToken>

RunPagedQueryAsync(GitHubClient client,

string queryText, string repoName, [EnumeratorCancellation]

CancellationToken cancellationToken = default)

var issueAndPRQuery = new GraphQLRequest

Query = queryText

};

issueAndPRQuery.Variables["repo_name"] = repoName;

 bool hasMorePages = true;

int pagesReturned = 0;

int issuesReturned = 0;

// Stop with 10 pages, because these are large repos:

while (hasMorePages && (pagesReturned++ < 10))

var postBody = issueAndPRQuery.ToJsonText();

var response = await client.Connection.Post<string>(new

Uri("https://api.github.com/graphql"),

postBody, "application/json", "application/json");

JObject results =
JObject.Parse(response.HttpResponse.Body.ToString()!);

int totalCount = (int)issues(results)["totalCount"]!;

hasMorePages = (bool)pageInfo(results)["hasPreviousPage"]!;

issueAndPRQuery.Variables["start_cursor"] = pageInfo(results)
["startCursor"]!.ToString();

issuesReturned += issues(results)["nodes"]!.Count();

foreach (JObject issue in issues(results)["nodes"]!)

yield return issue;

JObject issues(JObject result) => (JObject)result["data"]!

["repository"]!["issues"]!;

JObject pageInfo(JObject result) => (JObject)issues(result)

["pageInfo"]!;

El atributo System.Runtime.CompilerServices.EnumeratorCancellationAttribute hace que

el compilador genere código para IAsyncEnumerator<T>, que hace que el token que se
pasa a GetAsyncEnumerator sea visible al cuerpo del iterador asincrónico como ese
argumento. En runQueryAsync , puede examinar el estado del token y cancelar el trabajo
posterior si es necesario.

Se puede usar otro método de extensión, WithCancellation, para pasar el token de

cancelación a la secuencia asincrónica. Modifique el bucle que enumera los problemas
de la siguiente manera:

C#

private static async Task EnumerateWithCancellation(GitHubClient client)

int num = 0;

var cancellation = new CancellationTokenSource();

await foreach (var issue in RunPagedQueryAsync(client, PagedIssueQuery,

"docs")

.WithCancellation(cancellation.Token))

 Console.WriteLine(issue);
Console.WriteLine($"Received {++num} issues in total");

Puede obtener el código para el tutorial finalizado en el repositorio dotnet/docs de la

carpeta csharp/whats-new/tutorials .

Ejecución de la aplicación finalizada

Vuelva a ejecutar la aplicación. Compare su comportamiento con el comportamiento de
la aplicación de inicio. La primera página de resultados se enumera en cuanto está
disponible. Hay una pausa marcada cada vez que se solicita y se recupera una página
nueva; a continuación, se enumeran rápidamente los resultados de la página siguiente.
El bloque try / catch no es necesario para controlar la cancelación: el autor de la
llamada puede detener la enumeración de la colección. El progreso se notifica
claramente porque la secuencia asincrónica genera resultados a medida que se
descarga cada página. El estado de cada problema devuelto se incluye sin problemas en
el bucle await foreach . No necesita un objeto de devolución de llamada para hacer un
seguimiento del progreso.

Puede ver mejoras en el uso de la memoria examinando el código. Ya no tiene que

asignar una colección para almacenar todos los resultados antes de que se enumeren. El
autor de la llamada puede determinar cómo consumir los resultados y si se necesita una
colección de almacenamiento.

Ejecute las aplicaciones de inicio y finalizada y podrá ver las diferencias entre las
implementaciones personalmente. Puede eliminar el token de acceso de GitHub que
creó cuando inició este tutorial cuando haya terminado. Si un atacante obtuviera acceso
a dicho token, podría tener acceso a sus API de GitHub con sus credenciales.

En este tutorial, ha usado flujos asincrónicos para leer elementos individuales de una API
de red que devuelve páginas de datos. Los flujos asincrónicos también pueden leer
"flujos que nunca terminan", como un teletipo de bolsa o un sensor. La llamada a
MoveNextAsync devuelve el siguiente elemento en cuanto está disponible.
Tutorial: Escritura de un controlador de
interpolación de cadenas personalizado
Artículo • 29/11/2022 • Tiempo de lectura: 12 minutos

En este tutorial, aprenderá a:

＂ Implementar el patrón del controlador de interpolación de cadenas.

＂ Interactuar con el receptor en una operación de interpolación de cadenas.
＂ Agregar argumentos al controlador de interpolación de cadenas.
＂ Comprender las nuevas características de la biblioteca para la interpolación de
cadenas.

Prerrequisitos
Deberá configurar la máquina para ejecutar .NET 6, incluido el compilador de C# 10. El
compilador de C# 10 está disponible a partir de Visual Studio 2022 o del SDK de
.NET 6 .

En este tutorial se da por supuesto que conoce bien C# y. NET, incluidos Visual Studio o
la CLI de .NET.

Nuevo esquema
C# 10 agrega compatibilidad con un controlador de cadenas interpoladas personalizado.
Un controlador de cadenas interpoladas es un tipo que procesa la expresión del
marcador de posición en una cadena interpolada. Sin un controlador personalizado, los
marcadores de posición se procesan de forma similar a String.Format. Cada marcador
de posición tiene formato de texto y, luego, los componentes se concatenan para
formar la cadena resultante.

Puede escribir un controlador para cualquier escenario en el que use información sobre
la cadena resultante. ¿Se usará? ¿Qué restricciones hay en el formato? Estos son algunos
ejemplos:

Es posible que no necesite que ninguna de las cadenas resultantes sea mayor de
algún límite, por ejemplo, 80 caracteres. Puede procesar las cadenas interpoladas
para rellenar un búfer de longitud fija y detener el procesamiento una vez que se
alcanza esa longitud del búfer.
Puede tener un formato tabular y cada marcador de posición debe tener una
longitud fija. Un controlador personalizado puede aplicar esto, en lugar de obligar
 a que todo el código de cliente se ajuste.

En este tutorial, creará un controlador de interpolación de cadenas para uno de los

escenarios de rendimiento principales: las bibliotecas de registro. Según el nivel de
registro configurado, se puede prescindir del trabajo para construir un mensaje de
registro. Si el registro está desactivado, no es necesario el trabajo para construir una
cadena a partir de una expresión de cadena interpolada. El mensaje nunca se imprime,
por lo que se puede omitir cualquier concatenación de cadenas. Además, no es
necesario realizar las expresiones usadas en los marcadores de posición, incluida la
generación de seguimientos de pila.

Un controlador de cadena interpolada puede determinar si se usará la cadena con

formato, y realizar solo el trabajo necesario.

Implementación inicial
Partiremos de una clase Logger básica que admite distintos niveles:

C#

public enum LogLevel

Off,

Critical,

Error,

Warning,

Information,

Trace

public class Logger

public LogLevel EnabledLevel { get; init; } = LogLevel.Error;

public void LogMessage(LogLevel level, string msg)

if (EnabledLevel < level) return;

Console.WriteLine(msg);

Este elemento Logger admite seis niveles diferentes. Cuando un mensaje no pasa el
filtro de nivel de registro, no hay ninguna salida. La API pública del registrador acepta
una cadena (con formato completo) como mensaje. Ya se ha realizado todo el trabajo
para crear la cadena.
Implementación del patrón del controlador
Este paso consiste en crear un controlador de cadenas interpoladas que vuelva a crear el
comportamiento actual. Un controlador de cadenas interpoladas es un tipo que debe
tener las siguientes características:

Tener aplicado
System.Runtime.CompilerServices.InterpolatedStringHandlerAttribute al tipo.
Un constructor que tenga dos parámetros int : literalLength y formatCount . (Se
permiten más parámetros).
Un método AppendLiteral público con la signatura public void
AppendLiteral(string s) .

Un método AppendFormatted púbico genérico con la signatura public void

AppendFormatted<T>(T t) .

Internamente, el compilador crea la cadena con formato y proporciona un miembro

para que un cliente recupere esa cadena. El código siguiente muestra un tipo
LogInterpolatedStringHandler que satisface estos requisitos:

C#

[InterpolatedStringHandler]

public ref struct LogInterpolatedStringHandler

// Storage for the built-up string

StringBuilder builder;

public LogInterpolatedStringHandler(int literalLength, int

formattedCount)

builder = new StringBuilder(literalLength);

Console.WriteLine($"\tliteral length: {literalLength},

formattedCount: {formattedCount}");

public void AppendLiteral(string s)

Console.WriteLine($"\tAppendLiteral called: {{{s}}}");

builder.Append(s);

Console.WriteLine($"\tAppended the literal string");

public void AppendFormatted<T>(T t)

Console.WriteLine($"\tAppendFormatted called: {{{t}}} is of type

{typeof(T)}");

 builder.Append(t?.ToString());

Console.WriteLine($"\tAppended the formatted object");

internal string GetFormattedText() => builder.ToString();

Ahora puede agregar una sobrecarga a LogMessage en la clase Logger para probar el
nuevo controlador de cadenas interpoladas:

C#

public void LogMessage(LogLevel level, LogInterpolatedStringHandler builder)

if (EnabledLevel < level) return;

Console.WriteLine(builder.GetFormattedText());

No es necesario quitar el método LogMessage original; el compilador prefiere un método

con un parámetro de controlador interpolado antes que un método con un parámetro
string cuando el argumento es una expresión de cadena interpolada.

Puede comprobar que se invoca el nuevo controlador mediante el código siguiente

como programa principal:

C#

var logger = new Logger() { EnabledLevel = LogLevel.Warning };

var time = DateTime.Now;

logger.LogMessage(LogLevel.Error, $"Error Level. CurrentTime: {time}. This

is an error. It will be printed.");

logger.LogMessage(LogLevel.Trace, $"Trace Level. CurrentTime: {time}. This

won't be printed.");

logger.LogMessage(LogLevel.Warning, "Warning Level. This warning is a

string, not an interpolated string expression.");

La ejecución de la aplicación genera una salida similar al texto siguiente:

PowerShell

literal length: 65, formattedCount: 1

AppendLiteral called: {Error Level. CurrentTime: }

Appended the literal string

AppendFormatted called: {10/20/2021 12:19:10 PM} is of type

System.DateTime

Appended the formatted object

AppendLiteral called: {. This is an error. It will be printed.}

 Appended the literal string

Error Level. CurrentTime: 10/20/2021 12:19:10 PM. This is an error. It will

be printed.

literal length: 50, formattedCount: 1

AppendLiteral called: {Trace Level. CurrentTime: }

Appended the literal string

AppendFormatted called: {10/20/2021 12:19:10 PM} is of type

System.DateTime

Appended the formatted object

AppendLiteral called: {. This won't be printed.}

Appended the literal string

Warning Level. This warning is a string, not an interpolated string

expression.

Al realizar el seguimiento mediante la salida, puede ver cómo el compilador agrega

código para llamar al controlador y compilar la cadena:

El compilador agrega una llamada para construir el controlador y pasa la longitud

total del texto literal en la cadena de formato y el número de marcadores de
posición.
El compilador agrega llamadas a AppendLiteral y AppendFormatted para cada
sección de la cadena literal y para cada marcador de posición.
El compilador invoca el método LogMessage utilizando
CoreInterpolatedStringHandler como argumento.

Por último, observe que la última advertencia no invoca el controlador de cadenas

interpoladas. El argumento es un valor string , por lo que la llamada invoca a la otra
sobrecarga con un parámetro de cadena.

Adición de más funcionalidades al controlador

La versión anterior del controlador de cadenas interpoladas implementa el patrón. Para
evitar el procesamiento de cada expresión de marcador de posición, necesitará más
información en el controlador. En esta sección, mejorará el controlador para que haga
menos trabajo cuando la cadena construida no se escriba en el registro. Se usará
System.Runtime.CompilerServices.InterpolatedStringHandlerArgumentAttribute para
especificar una asignación entre parámetros a una API pública y parámetros al
constructor de un controlador. De esta forma, el controlador tendrá la información
necesaria para determinar si se debe evaluar la cadena interpolada.

Comencemos con los cambios en el controlador. En primer lugar, agregue un campo

para comprobar si el controlador está habilitado. Agregue dos parámetros al
constructor: uno para especificar el nivel de registro de este mensaje y el otro una
referencia al objeto de registro:
 C#

private readonly bool enabled;

public LogInterpolatedStringHandler(int literalLength, int formattedCount,

Logger logger, LogLevel logLevel)
{

enabled = logger.EnabledLevel >= logLevel;

builder = new StringBuilder(literalLength);

Console.WriteLine($"\tliteral length: {literalLength}, formattedCount:

{formattedCount}");

A continuación, use el campo para que el controlador solo anexe literales u objetos con
formato cuando se use la cadena final:

C#

public void AppendLiteral(string s)

Console.WriteLine($"\tAppendLiteral called: {{{s}}}");

if (!enabled) return;

builder.Append(s);

Console.WriteLine($"\tAppended the literal string");

public void AppendFormatted<T>(T t)

Console.WriteLine($"\tAppendFormatted called: {{{t}}} is of type

{typeof(T)}");

if (!enabled) return;

builder.Append(t?.ToString());

Console.WriteLine($"\tAppended the formatted object");

A continuación, deberá actualizar la declaración LogMessage para que el compilador

pase los parámetros adicionales al constructor del controlador. Para ello, se usa
System.Runtime.CompilerServices.InterpolatedStringHandlerArgumentAttribute en el
argumento del controlador:

C#

public void LogMessage(LogLevel level,

[InterpolatedStringHandlerArgument("", "level")]
LogInterpolatedStringHandler builder)

if (EnabledLevel < level) return;

 Console.WriteLine(builder.GetFormattedText());

Este atributo especifica la lista de argumentos para LogMessage que se asignan a los
parámetros que siguen a los parámetros literalLength y formattedCount necesarios. La
cadena vacía (""), especifica el receptor. El compilador sustituye el valor del objeto
Logger que representa this por el siguiente argumento para el constructor del
controlador. El compilador sustituye el valor de level por el siguiente argumento.
Puede proporcionar cualquier número de argumentos para cualquier controlador que
escriba. Los argumentos que agregue son argumentos de cadena.

Puede ejecutar esta versión con el mismo código de prueba. Esta vez, verá los siguientes
resultados:

PowerShell

literal length: 65, formattedCount: 1

AppendLiteral called: {Error Level. CurrentTime: }

Appended the literal string

AppendFormatted called: {10/20/2021 12:19:10 PM} is of type

System.DateTime

Appended the formatted object

AppendLiteral called: {. This is an error. It will be printed.}

Appended the literal string

Error Level. CurrentTime: 10/20/2021 12:19:10 PM. This is an error. It will

be printed.

literal length: 50, formattedCount: 1

AppendLiteral called: {Trace Level. CurrentTime: }

AppendFormatted called: {10/20/2021 12:19:10 PM} is of type

System.DateTime

AppendLiteral called: {. This won't be printed.}

Warning Level. This warning is a string, not an interpolated string

expression.

Puede ver que se llama a los métodos AppendLiteral y AppendFormat , pero no están
haciendo nada. El controlador ha determinado que la cadena final no será necesaria, por
lo que el controlador no la compila. Todavía hay que realizar un par de mejoras.

En primer lugar, puede agregar una sobrecarga de AppendFormatted que restrinja el

argumento a un tipo que implementa System.IFormattable. Esta sobrecarga permite a
los autores de llamada agregar cadenas de formato a los marcadores de posición. Al
realizar este cambio, vamos a cambiar también el tipo de valor devuelto de los otros
métodos, AppendFormatted y AppendLiteral , de void a bool (si alguno de estos
métodos tiene tipos de valor devuelto diferentes, se producirá un error de compilación).
Ese cambio permite el cortocircuito. Los métodos devuelven false para indicar que se
debe detener el procesamiento de la expresión de cadena interpolada. Al devolver true
se indica que se debe continuar. En este ejemplo, se usa para detener el procesamiento
cuando la cadena resultante no es necesaria. El cortocircuito admite acciones más
específicas. Podría detener el procesamiento de la expresión una vez que alcance una
longitud determinada con el fin de admitir búferes de longitud fija. O bien, alguna
condición podría indicar que los elementos restantes no son necesarios.

C#

public void AppendFormatted<T>(T t, string format) where T : IFormattable

Console.WriteLine($"\tAppendFormatted (IFormattable version) called: {t}

with format {{{format}}} is of type {typeof(T)},");

builder.Append(t?.ToString(format, null));

Console.WriteLine($"\tAppended the formatted object");

Con esa adición, puede especificar cadenas de formato en la expresión de cadena

interpolada:

C#

var time = DateTime.Now;

logger.LogMessage(LogLevel.Error, $"Error Level. CurrentTime: {time}. The

time doesn't use formatting.");

logger.LogMessage(LogLevel.Error, $"Error Level. CurrentTime: {time:t}. This

is an error. It will be printed.");

logger.LogMessage(LogLevel.Trace, $"Trace Level. CurrentTime: {time:t}. This

won't be printed.");

La :t del primer mensaje especifica el "formato de hora corto" de la hora actual. En el

ejemplo anterior se mostraba una de las sobrecargas al método AppendFormatted que
puede crear para el controlador. No es necesario especificar un argumento genérico
para el objeto al que se va a dar formato. Es posible que tenga maneras más eficaces de
convertir los tipos creados en cadenas. Puede escribir sobrecargas de AppendFormatted
que toma esos tipos en lugar de un argumento genérico. El compilador elegirá la mejor
sobrecarga. El tiempo de ejecución usa esta técnica para convertir System.Span<T> en
una salida de cadena. Puede agregar un parámetro entero para especificar la alineación
de la salida, con o sin IFormattable. El elemento
System.Runtime.CompilerServices.DefaultInterpolatedStringHandler que se incluye con
.NET 6 contiene nueve sobrecargas de AppendFormatted para distintos usos. Puede
usarlo como referencia al crear un controlador para sus fines.
Ejecute el ejemplo ahora y verá que, para el mensaje Trace , solo se llama al primer
AppendLiteral :

PowerShell

literal length: 60, formattedCount: 1

AppendLiteral called: Error Level. CurrentTime:

Appended the literal string

AppendFormatted called: 10/20/2021 12:18:29 PM is of type

System.DateTime

Appended the formatted object

AppendLiteral called: . The time doesn't use formatting.

Appended the literal string

Error Level. CurrentTime: 10/20/2021 12:18:29 PM. The time doesn't use
formatting.

literal length: 65, formattedCount: 1

AppendLiteral called: Error Level. CurrentTime:

Appended the literal string

AppendFormatted (IFormattable version) called: 10/20/2021 12:18:29

PM with format {t} is of type System.DateTime,

Appended the formatted object

AppendLiteral called: . This is an error. It will be printed.

Appended the literal string

Error Level. CurrentTime: 12:18 PM. This is an error. It will be printed.

literal length: 50, formattedCount: 1

AppendLiteral called: Trace Level. CurrentTime:

Warning Level. This warning is a string, not an interpolated string

expression.

Puede realizar una actualización final del constructor del controlador que mejore la
eficacia. El controlador puede agregar un parámetro out bool final. Establecer ese
parámetro en false indica que no se debe llamar al controlador para procesar la
expresión de cadena interpolada:

C#

public LogInterpolatedStringHandler(int literalLength, int formattedCount,

Logger logger, LogLevel level, out bool isEnabled)

isEnabled = logger.EnabledLevel >= level;

Console.WriteLine($"\tliteral length: {literalLength}, formattedCount:

{formattedCount}");

builder = isEnabled ? new StringBuilder(literalLength) : default!;

Ese cambio significa que puede quitar el campo enabled . Para cambiar el tipo de valor
devuelto de AppendLiteral y AppendFormatted a void .
Ahora, al ejecutar el ejemplo, verá
el resultado siguiente:
 PowerShell

literal length: 60, formattedCount: 1

AppendLiteral called: Error Level. CurrentTime:

Appended the literal string

AppendFormatted called: 10/20/2021 12:19:10 PM is of type

System.DateTime

Appended the formatted object

AppendLiteral called: . The time doesn't use formatting.

Appended the literal string

Error Level. CurrentTime: 10/20/2021 12:19:10 PM. The time doesn't use
formatting.

literal length: 65, formattedCount: 1

AppendLiteral called: Error Level. CurrentTime:

Appended the literal string

AppendFormatted (IFormattable version) called: 10/20/2021 12:19:10

PM with format {t} is of type System.DateTime,

Appended the formatted object

AppendLiteral called: . This is an error. It will be printed.

Appended the literal string

Error Level. CurrentTime: 12:19 PM. This is an error. It will be printed.

literal length: 50, formattedCount: 1

Warning Level. This warning is a string, not an interpolated string

expression.

La única salida cuando se especificaba LogLevel.Trace era la salida del constructor. El

controlador indicaba que no está habilitado, por lo que no se invocaba ninguno de los
métodos Append .

En este ejemplo se muestra un punto importante para los controladores de cadena

interpolada, especialmente cuando se usan bibliotecas de registro. Es posible que no se
produzcan efectos secundarios en los marcadores de posición. Agregue el código
siguiente al programa principal y vea este comportamiento en acción:

C#

int index = 0;

int numberOfIncrements = 0;

for (var level = LogLevel.Critical; level <= LogLevel.Trace; level++)

Console.WriteLine(level);

logger.LogMessage(level, $"{level}: Increment index a few times

{index++}, {index++}, {index++}, {index++}, {index++}");

numberOfIncrements += 5;

Console.WriteLine($"Value of index {index}, value of numberOfIncrements:

{numberOfIncrements}");

Puede ver que la variable index se incrementa cinco veces con cada iteración del bucle.
Dado que los marcadores de posición solo se evalúan para los niveles Critical , Error y
Warning , no para Information y Trace , el valor final de index no cumple la expectativa:

PowerShell

Critical

Critical: Increment index a few times 0, 1, 2, 3, 4

Error

Error: Increment index a few times 5, 6, 7, 8, 9

Warning

Warning: Increment index a few times 10, 11, 12, 13, 14

Information

Trace

Value of index 15, value of numberOfIncrements: 25

Los controladores de cadenas interpoladas proporcionan un mayor control sobre cómo

se convierte una expresión de cadena interpolada en una cadena. El equipo del entorno
de ejecución de .NET ya ha usado esta característica para mejorar el rendimiento en
varias áreas. Puede usar la misma funcionalidad en sus propias bibliotecas. Para explorar
más a fondo, examine
System.Runtime.CompilerServices.DefaultInterpolatedStringHandler, que proporciona
una implementación más completa de la que se ha creado aquí. Verá muchas más
sobrecargas que son posibles para los métodos Append .
Uso de la interpolación de cadenas para
construir cadenas con formato
Artículo • 29/11/2022 • Tiempo de lectura: 8 minutos

En este tutorial se muestra cómo usar la interpolación de cadenas de C# para insertar

valores en una cadena de resultado única. Escriba código de C# y vea los resultados de
la compilación y la ejecución. Este tutorial contiene una serie de lecciones para
mostrarle cómo insertar valores en una cadena y dar formato a estos valores de
maneras diferentes.

En este tutorial se supone que cuenta con una máquina que puede usar para el
desarrollo. El tutorial de .NET Hola mundo en 10 minutos cuenta con instrucciones
para configurar el entorno de desarrollo local en Windows, Linux o macOS. También
puede completar la versión interactiva de este tutorial en el explorador.

Crear una cadena interpolada

Cree un directorio denominado interpolated. Conviértalo en el directorio actual y ejecute
este comando desde una ventana de consola:

CLI de .NET

dotnet new console

Este comando crea una nueva aplicación de consola de .NET Core en el directorio actual.

Abra Program.cs en su editor favorito y reemplace la línea Console.WriteLine("Hello

World!"); por el código siguiente, teniendo en cuenta que debe reemplazar <name> con

su nombre:

C#

var name = "<name>";

Console.WriteLine($"Hello, {name}. It's a pleasure to meet you!");

Pruebe este código escribiendo dotnet run en la ventana de la consola. Al ejecutar el

programa, se muestra una cadena única que incluye su nombre en el saludo. La cadena
que se incluye en la llamada al método WriteLine es una expresión de cadena
interpolada. Es un tipo de plantilla que permite construir una sola cadena (denominada
cadena de resultado) a partir de una cadena que incluye código incrustado. Las cadenas
interpoladas son especialmente útiles para insertar valores en una cadena o en cadenas
concatenadas (unidas entre sí).

Este sencillo ejemplo contiene los dos elementos que debe tener cada cadena
interpolada:

Un literal de cadena que empieza con el carácter $ antes del carácter de comillas
de apertura. No puede haber ningún espacio entre el símbolo $ y el carácter de
comillas. (Si quiere saber qué pasa si incluye uno, inserte un espacio después del
carácter $ , guarde el archivo y vuelva a ejecutar el programa escribiendo dotnet
run en la ventana de la consola. El compilador de C# mostrará un mensaje de
error: “error CS1056: Carácter inesperado ‘$’”).

Una o varias expresiones de interpolación. Una expresión de interpolación se indica

mediante una llave de apertura y de cierre ( { y } ). Puede colocar cualquier
expresión de C# que devuelva un valor (incluido null ) dentro de las llaves.

Probemos algunos ejemplos más de interpolación de cadenas con otros tipos de datos.

Incluir diferentes tipos de datos

En la sección anterior, se ha usado una interpolación de cadena para insertar una
cadena dentro de otra, pero el resultado de una expresión de interpolación puede ser
cualquier tipo de datos. Vamos a incluir valores de distintos tipos de datos en una
cadena interpolada.

En el ejemplo siguiente, en primer lugar se define un tipo de datos de clase Vegetable

que tiene una propiedad Name y un método ToString que reemplaza el comportamiento
del método Object.ToString(). El publicmodificador de acceso pone ese método a
disposición de cualquier código de cliente para obtener la representación de la cadena
de una instancia de Vegetable . En el ejemplo, el método Vegetable.ToString devuelve
el valor de la propiedad Name que se inicializa en el constructor Vegetable :

C#

public Vegetable(string name) => Name = name;

Luego se crea una instancia de la clase Vegetable denominada item al usar el operador
new y al proporcionar un parámetro de nombre para el constructor Vegetable :

C#
 var item = new Vegetable("eggplant");

Por último, se incluye la variable item en una cadena interpolada que también contiene
un valor DateTime, un valor Decimal y un valor de enumeración Unit . Reemplace todo el
código de C# en el editor con el código siguiente y, después, use el comando dotnet
run para ejecutarlo:

C#

using System;

public class Vegetable

public Vegetable(string name) => Name = name;

public string Name { get; }

public override string ToString() => Name;

public class Program

public enum Unit { item, kilogram, gram, dozen };

public static void Main()

var item = new Vegetable("eggplant");

var date = DateTime.Now;

var price = 1.99m;

var unit = Unit.item;

Console.WriteLine($"On {date}, the price of {item} was {price} per

{unit}.");

Observe que la expresión de interpolación item de la cadena interpolada se resuelve en

el texto "eggplant" en la cadena de resultado. Esto se debe a que, cuando el tipo del
resultado de la expresión no es una cadena, el resultado se resuelve en una cadena de la
siguiente manera:

Si la expresión de interpolación se evalúa en null , se usa una cadena vacía ("", o

String.Empty).

Si la expresión de interpolación no se evalúa en null , se suele llamar al método

ToString del tipo de resultado. Puede probar esto mediante la actualización de la

implementación del método Vegetable.ToString . Podría incluso no implementar el

 método ToString , puesto que cada tipo de datos tiene alguna implementación de
este método. Para probar esto, comente la definición del método
Vegetable.ToString del ejemplo (para ello, coloque delante un símbolo de

comentario // ). En el resultado, se reemplaza la cadena "eggplant" por el nombre

del tipo completo ("Vegetable" en este ejemplo), que es el comportamiento
predeterminado del método Object.ToString(). El comportamiento predeterminado
del método ToString para un valor de enumeración es devolver la representación
de cadena del valor.

En el resultado de este ejemplo, la fecha es demasiado precisa (el precio de "eggplant"

no varía por segundos) y el valor del precio no indica una unidad de moneda. En la
sección siguiente se aprende a corregir esos problemas al controlar el formato de
representaciones de cadena de los resultados de la expresión.

Control del formato de las expresiones de

interpolación
En la sección anterior, las dos cadenas con formato incorrecto se insertaron en la cadena
de resultado. Una era un valor de fecha y hora en la que solo la fecha era apropiada. La
segunda era un precio que no indicaba su unidad de moneda. Ambos problemas se
podían solucionar fácilmente. La interpolación de cadena permite especificar cadenas de
formato que controlan el formato de tipos específicos. Modifique la llamada a
Console.WriteLine del ejemplo anterior para incluir las cadenas de formato para las

expresiones de fecha y precio, como se muestra en la siguiente línea:

C#

Console.WriteLine($"On {date:d}, the price of {item} was {price:C2} per

{unit}.");

Especifique una cadena de formato al colocar dos puntos (":") después de la expresión
de interpolación y la cadena de formato. "d" es una cadena de formato de fecha y hora
estándar que representa el formato de fecha corta. "C2" es una cadena de formato
numérica estándar que representa un número como un valor de moneda con dos
dígitos después del separador decimal.

Una serie de tipos de las bibliotecas de .NET admiten un conjunto predefinido de

cadenas de formato. Esto incluye todos los tipos numéricos y los tipos de fecha y hora.
Para obtener una lista completa de los tipos que admiten cadenas de formato, vea Dar
formato a cadenas y tipos de biblioteca de clase .NET en el artículo Aplicar formato a
tipos de .NET.
Pruebe a modificar las cadenas de formato en el editor de texto y, cada vez que realice
un cambio, vuelva a ejecutar el programa para ver cómo los cambios afectan al formato
de fecha y hora y al valor numérico. Cambie "d" en {date:d} a "t" (para mostrar el
formato de hora corta), "y" (para mostrar el año y el mes) y "yyyy" (para mostrar el año
como un número de cuatro dígitos). Cambie "C2" en {price:C2} a "e" (para la notación
exponencial) y "F3" (para un valor numérico con tres dígitos después del separador
decimal).

Además de controlar el formato, también puede controlar el ancho de campo y la

alineación de las cadenas con formato incluidas en la cadena de resultado. En la
siguiente sección aprenderá a hacerlo.

Control el ancho de campo y la alineación de

expresiones de interpolación
Normalmente, cuando el resultado de una expresión de interpolación tiene formato de
cadena, esa cadena se incluye en una cadena de resultado sin espacios iniciales ni
finales. Especialmente cuando se trabaja con un conjunto de datos, poder controlar el
ancho de un campo y la alineación del texto ayuda a generar una salida más legible.
Para ver esto, reemplace todo el código en el editor de texto con el código siguiente, y
luego escriba dotnet run para ejecutar el programa:

C#

using System;

using System.Collections.Generic;

public class Example

public static void Main()

var titles = new Dictionary<string, string>()

["Doyle, Arthur Conan"] = "Hound of the Baskervilles, The",

["London, Jack"] = "Call of the Wild, The",

["Shakespeare, William"] = "Tempest, The"

};

Console.WriteLine("Author and Title List");

Console.WriteLine();

Console.WriteLine($"|{"Author",-25}|{"Title",30}|");

foreach (var title in titles)

Console.WriteLine($"|{title.Key,-25}|{title.Value,30}|");

Los nombres de los autores están alineados a la izquierda y los títulos que escribieron
están alineados a la derecha. Para especificar la alineación, se agrega una coma (",")
después de una expresión de interpolación y se designa el ancho de campo mínimo. Si
el valor especificado es un número positivo, el campo se alinea a la derecha. Si es un
número negativo, el campo se alinea a la izquierda.

Pruebe a quitar el signo negativo del código {"Author",-25} y {title.Key,-25} , y

vuelva a ejecutar el ejemplo, como hace este código:

C#

Console.WriteLine($"|{"Author",25}|{"Title",30}|");

foreach (var title in titles)

Console.WriteLine($"|{title.Key,25}|{title.Value,30}|");

Esta vez, la información del autor está alineada a la derecha.

Puede combinar un especificador de alineación y una cadena de formato en una única

expresión de interpolación. Para ello, especifique primero la alineación, seguida de dos
puntos y la cadena de formato. Reemplace todo el código dentro del método Main con
el código siguiente, que muestra tres cadenas con formato con los anchos de campo
definidos. Después, ejecute el programa escribiendo el comando dotnet run .

C#

Console.WriteLine($"[{DateTime.Now,-20:d}] Hour [{DateTime.Now,-10:HH}]

[{1063.342,15:N2}] feet");

El resultado tiene un aspecto similar a este:

Consola

[04/14/2018 ] Hour [16 ] [ 1,063.34] feet

Ha completado el tutorial sobre interpolación de cadenas.

Para más información, vea el tema Interpolación de cadenas y el tutorial Interpolación

de cadenas en C#.
Interpolación de cadenas en C#
Artículo • 28/11/2022 • Tiempo de lectura: 6 minutos

En este tutorial se explica cómo usar la interpolación de cadenas para dar formato a
resultados de expresión e incluirlos en una cadena de resultado. En los ejemplos se da
por hecho que ya está familiarizado con los conceptos básicos de C# y el formato de
tipos .NET. Si no conoce la interpolación de cadenas o el formato de tipos .NET, vea
antes el tutorial de interpolación de cadenas interactivo. Para más información sobre
cómo aplicar formato a tipos .NET, vea el tema Aplicar formato a tipos en .NET.

７ Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y

área de juegos de Try.NET . Haga clic en el botón Ejecutar para ejecutar un
ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede
modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El
código modificado se ejecuta en la ventana interactiva o, si se produce un error en
la compilación, en la ventana interactiva se muestran todos los mensajes de error
del compilador de C#.

Introducción
La característica de interpolación de cadenas se basa en la característica de formato
compuesto y proporciona una sintaxis más legible y cómoda para incluir resultados de
expresiones con formato en una cadena de resultado.

Para distinguir un literal de cadena como una cadena interpolada, antepóngale el

símbolo $ . Puede insertar cualquier expresión de C# válida que devuelva un valor en
una cadena interpolada. En el siguiente ejemplo, en cuanto la expresión se evalúa, su
resultado se convierte en una cadena y se incluye en una cadena de resultado:

C#

double a = 3;

double b = 4;

Console.WriteLine($"Area of the right triangle with legs of {a} and {b} is

{0.5 * a * b}");

Console.WriteLine($"Length of the hypotenuse of the right triangle with legs

of {a} and {b} is {CalculateHypotenuse(a, b)}");

double CalculateHypotenuse(double leg1, double leg2) => Math.Sqrt(leg1 *

leg1 + leg2 * leg2);

 // Expected output:

// Area of the right triangle with legs of 3 and 4 is 6

// Length of the hypotenuse of the right triangle with legs of 3 and 4 is 5

Como se ilustra en el ejemplo, para incluir una expresión en una cadena interpolada hay
que meterla entre llaves:

C#

{<interpolationExpression>}

Las cadenas interpoladas admiten todas las funcionalidades de la característica de

formato compuesto de cadena. Esto las convierte en una alternativa más legible al uso
del método String.Format.

Cómo especificar una cadena de formato para

una expresión de interpolación
Para especificar una cadena de formato compatible con el tipo de resultado de
expresión, coloque después de la expresión de interpolación dos puntos (":") y la cadena
de formato:

C#

{<interpolationExpression>:<formatString>}

En el siguiente ejemplo se muestra cómo especificar cadenas de formato estándar y

personalizadas para expresiones que generan resultados numéricos o de fecha y hora:

C#

var date = new DateTime(1731, 11, 25);

Console.WriteLine($"On {date:dddd, MMMM dd, yyyy} Leonhard Euler introduced

the letter e to denote {Math.E:F5} in a letter to Christian Goldbach.");

// Expected output:

// On Sunday, November 25, 1731 Leonhard Euler introduced the letter e to

denote 2.71828 in a letter to Christian Goldbach.

Para más información, vea la sección Format String (Componente) del tema Formatos
compuestos. En esa sección encontrará vínculos a temas en los que se describen las
cadenas de formato estándar y personalizadas compatibles con los tipos base .NET.
Cómo controlar el ancho de campo y la
alineación de las expresiones de interpolación
con formato
Para especificar el ancho de campo mínimo y la alineación del resultado de expresión
con formato, coloque después de la expresión de interpolación una coma (",") y la
expresión constante:

C#

{<interpolationExpression>,<alignment>}

Si el valor de alignment es positivo, el resultado de la expresión con formato se alineará

a la derecha y, si es negativo, lo hará a la izquierda.

En caso de que haya que especificar una alineación y una cadena de formato, comience
por el componente de alineación:

C#

{<interpolationExpression>,<alignment>:<formatString>}

En el siguiente ejemplo se muestra cómo especificar la alineación y se emplean

caracteres de barra vertical ("|") para delimitar los campos de texto:

C#

const int NameAlignment = -9;

const int ValueAlignment = 7;

double a = 3;

double b = 4;

Console.WriteLine($"Three classical Pythagorean means of {a} and {b}:");

Console.WriteLine($"|{"Arithmetic",NameAlignment}|{0.5 * (a +
b),ValueAlignment:F3}|");

Console.WriteLine($"|{"Geometric",NameAlignment}|{Math.Sqrt(a *
b),ValueAlignment:F3}|");

Console.WriteLine($"|{"Harmonic",NameAlignment}|{2 / (1 / a + 1 /
b),ValueAlignment:F3}|");

// Expected output:

// Three classical Pythagorean means of 3 and 4:

// |Arithmetic| 3.500|

// |Geometric| 3.464|

// |Harmonic | 3.429|

Tal y como refleja la salida del ejemplo, si la longitud del resultado de expresión con
formato supera el ancho de campo especificado, se omitirá el valor de alignment.

Para más información, vea la sección Alignment (Componente) del tema Formatos
compuestos.

Cómo usar secuencias de escape en una cadena

interpolada
Las cadenas interpoladas admiten todas las secuencias de escape que se usan en los
literales de cadena ordinarios. Para más información, vea Secuencias de escape de
cadena.

Para interpretar las secuencias de escape literalmente, use un literal de cadena textual.
Las cadenas textuales interpoladas comienzan por el carácter $ , seguido del carácter @ .
Puede usar los $ tokens y @ en cualquier orden: y $@"..." @$"..." son cadenas
textuales interpoladas válidas.

Para incluir una llave ("{" o "}") en una cadena de resultado, use dos llaves ("{{" o "}}").
Para más información, vea la sección Llaves de escape del tema Formatos compuestos.

En el siguiente ejemplo se muestra cómo incluir llaves en una cadena de resultado y

cómo construir una cadena interpolada textual:

C#

var xs = new int[] { 1, 2, 7, 9 };

var ys = new int[] { 7, 9, 12 };

Console.WriteLine($"Find the intersection of the {{{string.Join(", ",xs)}}}

and {{{string.Join(", ",ys)}}} sets.");

var userName = "Jane";

var stringWithEscapes = $"C:\\Users\\{userName}\\Documents";

var verbatimInterpolated = $@"C:\Users\{userName}\Documents";

Console.WriteLine(stringWithEscapes);

Console.WriteLine(verbatimInterpolated);

// Expected output:

// Find the intersection of the {1, 2, 7, 9} and {7, 9, 12} sets.

// C:\Users\Jane\Documents

// C:\Users\Jane\Documents

Cómo usar un operador condicional ternario

?: en una expresión de interpolación
Dado que los dos puntos (:) tienen un significado especial en un elemento con una
expresión de interpolación, para poder usar un operador condicional en una expresión
de este tipo habrá que ponerlo entre paréntesis, como vemos en el siguiente ejemplo:

C#

var rand = new Random();

for (int i = 0; i < 7; i++)

Console.WriteLine($"Coin flip: {(rand.NextDouble() < 0.5 ? "heads" :

"tails")}");

Cómo crear una cadena de resultado específica

de la referencia cultural con interpolación de
cadenas
Las cadenas interpoladas usan de forma predeterminada la referencia cultural definida
actualmente por la propiedad CultureInfo.CurrentCulture en todas las operaciones de
formato. Use la conversión implícita de una cadena interpolada en una instancia de
System.FormattableString y llame al método ToString(IFormatProvider) correspondiente
para crear una cadena de resultado específica de referencia cultural. En el siguiente
ejemplo se muestra cómo hacerlo:

C#

var cultures = new System.Globalization.CultureInfo[]

System.Globalization.CultureInfo.GetCultureInfo("en-US"),

System.Globalization.CultureInfo.GetCultureInfo("en-GB"),

System.Globalization.CultureInfo.GetCultureInfo("nl-NL"),

System.Globalization.CultureInfo.InvariantCulture

};

var date = DateTime.Now;

var number = 31_415_926.536;

FormattableString message = $"{date,20}{number,20:N3}";

foreach (var culture in cultures)

var cultureSpecificMessage = message.ToString(culture);

Console.WriteLine($"{culture.Name,-10}{cultureSpecificMessage}");

// Expected output is like:

// en-US 5/17/18 3:44:55 PM 31,415,926.536

// en-GB 17/05/2018 15:44:55 31,415,926.536

 // nl-NL 17-05-18 15:44:55 31.415.926,536

// 05/17/2018 15:44:55 31,415,926.536

Tal y como se muestra en el ejemplo, se puede usar una instancia de FormattableString

para generar varias cadenas de resultado para varias referencias culturales.

Cómo crear una cadena de resultado usando la

referencia de cultura invariable
Puede usar el método estático FormattableString.Invariant junto con el método
FormattableString.ToString(IFormatProvider) para resolver una cadena interpolada en
una cadena de resultado de InvariantCulture. En el siguiente ejemplo se muestra cómo
hacerlo:

C#

string messageInInvariantCulture = FormattableString.Invariant($"Date and

time in invariant culture: {DateTime.Now}");

Console.WriteLine(messageInInvariantCulture);

// Expected output is like:

// Date and time in invariant culture: 05/17/2018 15:46:24

Conclusión
En este tutorial se han descrito escenarios habituales en los que se usa la interpolación
de cadenas. Para más información sobre la interpolación de cadenas, vea el tema
Interpolación de cadenas. Para más información sobre cómo aplicar formato a tipos
.NET, vea los temas Aplicar formato a tipos en .NET y Formatos compuestos.

Vea también
String.Format
System.FormattableString
System.IFormattable
Cadenas
Aplicación de consola
Artículo • 14/02/2023 • Tiempo de lectura: 11 minutos

En este tutorial se enseña una serie de características de .NET y el lenguaje C#.

Aprenderá a realizar los siguientes procedimientos:

Conceptos básicos de la CLI de .NET

La estructura de una aplicación de consola en C#
E/S de consola
Aspectos básicos de las API de E/S de archivo en .NET
Aspectos básicos de la programación asincrónica basada en tareas en .NET

Creará una aplicación que lea un archivo de texto y refleje el contenido de ese archivo
de texto en la consola. El ritmo de la salida a la consola se ajusta para que coincida con
la lectura en voz alta. Para aumentar o reducir el ritmo, presione las teclas "<" (menor
que) o ">" (mayor que). Puede ejecutar esta aplicación en Windows, Linux, macOS o en
un contenedor de Docker.

Hay muchas características en este tutorial. Vamos a compilarlas una a una.

Requisitos previos
SDK DE .NET 6
Un editor de código

Creación de la aplicación
El primer paso es crear una nueva aplicación. Abra un símbolo del sistema y cree un
nuevo directorio para la aplicación. Conviértalo en el directorio actual. Escriba el
comando dotnet new console en el símbolo del sistema. Esta acción crea los archivos de
inicio para una aplicación básica "Hola mundo".

Antes de empezar a realizar modificaciones, vamos a ejecutar la aplicación sencilla Hola

mundo. Después de crear la aplicación, escriba dotnet run en el símbolo del sistema.
Este comando ejecuta el proceso de restauración de paquetes NuGet, crea el archivo
ejecutable de la aplicación y lo ejecuta.

Todo el código de la aplicación sencilla Hola mundo está en Program.cs. Abra ese
archivo con el editor de texto de su elección. Reemplace el código de Program.cs por el
código siguiente:
 C#

namespace TeleprompterConsole;

internal class Program

static void Main(string[] args)

Console.WriteLine("Hello World!");

En la parte superior del archivo, verá una instrucción namespace . Al igual que otros
lenguajes orientados a objetos que pueda haber usado, C# utiliza espacios de nombres
para organizar los tipos. Este programa Hola mundo no es diferente. Se puede ver que
el programa está incluido en el espacio de nombres con el nombre
TeleprompterConsole .

Lectura y reflejo del archivo

La primera característica que se va a agregar es la capacidad de leer un archivo de texto
y visualizar todo ese texto en la consola. En primer lugar, vamos a agregar un archivo de
texto. Copie el archivo sampleQuotes.txt del repositorio de GitHub de este ejemplo
en su directorio del proyecto. Servirá como script para la aplicación. Para obtener
información sobre cómo descargar la aplicación de ejemplo de este tutorial, vea las
instrucciones en Ejemplos y tutoriales.

Luego, agregue el siguiente método a la clase Program (justo debajo del método Main ):

C#

static IEnumerable<string> ReadFrom(string file)

string? line;

using (var reader = File.OpenText(file))

while ((line = reader.ReadLine()) != null)

yield return line;

Este método es un tipo especial de método de C# llamado método de iterador. Los

métodos de iterador devuelven secuencias que se evalúan de forma diferida. Eso
significa que cada elemento de la secuencia se genera como lo solicita el código que
consume la secuencia. Los métodos de iterador son métodos que contienen una o
varias instrucciones yield return. El objeto que devuelve el método ReadFrom contiene el
código para generar cada elemento en la secuencia. En este ejemplo, que implica la
lectura de la siguiente línea de texto del archivo de origen y la devolución de esa
cadena, cada vez que el código de llamada solicita el siguiente elemento de la
secuencia, el código lee la siguiente línea de texto del archivo y la devuelve. Cuando el
archivo se ha leído completamente, la secuencia indica que no hay más elementos.

Hay dos elementos de la sintaxis de C# con los que podría no estar familiarizado. La
instrucción using de este método administra la limpieza de recursos. La variable que se
inicializa en la instrucción using ( reader , en este ejemplo) debe implementar la interfaz
IDisposable. Esa interfaz define un único método, Dispose , que se debe llamar cuando
sea necesario liberar el recurso. El compilador genera esa llamada cuando la ejecución
llega a la llave de cierre de la instrucción using . El código generado por el compilador
garantiza que el recurso se libera incluso si se produce una excepción desde el código
en el bloqueo definido mediante la instrucción using.

La variable reader se define mediante la palabra clave var . var define una variable local
con tipo implícito. Esto significa que el tipo de la variable viene determinado por el tipo
en tiempo de compilación del objeto asignado a la variable. Aquí, ese es el valor
devuelto por el método OpenText(String), que es un objeto StreamReader.

Ahora, vamos a rellenar el código para leer el archivo en el método Main :

C#

var lines = ReadFrom("sampleQuotes.txt");

foreach (var line in lines)

Console.WriteLine(line);

Ejecute el programa (mediante dotnet run ) y podrá ver cada línea impresa en la
consola.

Adición de retrasos y formato de salida

Lo que tiene se va a mostrar lejos, demasiado rápido para leerlo en voz alta. Ahora debe
agregar los retrasos en la salida. Cuando empiece, estará creando parte del código
principal que permite el procesamiento asincrónico. Sin embargo, a estos primeros
pasos le seguirán algunos antipatrones. Los antipatrones se señalan en los comentarios
cuando se agrega el código y el código se actualizará en los pasos posteriores.

Hay dos pasos hasta esta sección. Primero, actualizará el método Iterator para devolver
palabras sueltas en lugar de líneas enteras. Para ello, son necesarias estas
modificaciones. Reemplace la instrucción yield return line; por el código siguiente:

C#

var words = line.Split(' ');

foreach (var word in words)

yield return word + " ";

yield return Environment.NewLine;

A continuación, debe modificar el modo en que se consumen las líneas del archivo y
agregar un retraso después de escribir cada palabra. Reemplace la instrucción
Console.WriteLine(line) del método Main por el bloqueo siguiente:

C#

Console.Write(line);

if (!string.IsNullOrWhiteSpace(line))

var pause = Task.Delay(200);

// Synchronously waiting on a task is an

// anti-pattern. This will get fixed in later

// steps.

pause.Wait();

Ejecute el ejemplo y compruebe la salida. Ahora, se imprime cada palabra suelta,

seguido de un retraso de 200 ms. Sin embargo, la salida mostrada indica algunos
problemas porque el archivo de texto de origen tiene varias líneas con más de 80
caracteres sin un salto de línea. Este texto puede ser difícil de leer al desplazarse por él.
Esto es fácil de corregir. Simplemente realizará el seguimiento de la longitud de cada
línea y generará una nueva línea cada vez que la longitud de la línea alcance un
determinado umbral. Declare una variable local después de la declaración de words en
el método ReadFrom que contiene la longitud de línea:

C#

var lineLength = 0;

A continuación, agregue el código siguiente después de la instrucción yield return

word + " "; (antes de la llave de cierre):

C#

lineLength += word.Length + 1;

if (lineLength > 70)

yield return Environment.NewLine;

lineLength = 0;

Ejecute el ejemplo y podrá leer en alto a su ritmo preconfigurado.

Tareas asincrónicas
En este paso final, agregará el código para escribir la salida de manera asincrónica en
una tarea, mientras se ejecuta también otra tarea para leer la entrada del usuario si
quiere aumentar o reducir la velocidad de la pantalla de texto, o detendrá la
presentación del texto por completo. Incluye unos cuantos pasos y, al final, tendrá todas
las actualizaciones que necesita. El primer paso es crear un método de devolución Task
asincrónico que represente el código que ha creado hasta el momento para leer y
visualizar el archivo.

Agregue este método a su clase Program (se toma del cuerpo del método Main ):

C#

private static async Task ShowTeleprompter()

var words = ReadFrom("sampleQuotes.txt");

foreach (var word in words)

Console.Write(word);

if (!string.IsNullOrWhiteSpace(word))

await Task.Delay(200);

Advertirá dos cambios. Primero, en el cuerpo del método, en lugar de llamar a Wait()
para esperar a que finalice una tarea de manera sincrónica, esta versión usa la palabra
clave await . Para ello, debe agregar el modificador async a la signatura del método.
Este método devuelve un objeto Task . Observe que no hay ninguna instrucción Return
que devuelva un objeto Task . En su lugar, ese objeto Task se crea mediante el código
que genera el compilador cuando usa el operador await . Puede imaginar que este
método devuelve cuando alcanza un valor de await . El valor devuelto de Task indica
que el trabajo no ha finalizado. El método se reanuda cuando se completa la tarea en
espera. Cuando se ha ejecutado hasta su finalización, el valor de Task devuelto indica
que se ha completado.
El código de llamada puede supervisar ese valor de Task
devuelto para determinar cuándo se ha completado.

Agregue una palabra clave await antes de la llamada a ShowTeleprompter :

C#

await ShowTeleprompter();

Esto requiere que cambie la firma del método Main a:

C#

static async Task Main(string[] args)

Obtenga más información sobre el método async Main en nuestra sección de aspectos
básicos.

A continuación, debe escribir el segundo método asincrónico para leer desde la Consola
y controlar las teclas "<" (menor que), ">" (mayor que), "X" o "x". Este es el método que
agrega para esa tarea:

C#

private static async Task GetInput()

var delay = 200;

Action work = () =>

do {

var key = Console.ReadKey(true);

if (key.KeyChar == '>')

delay -= 10;

else if (key.KeyChar == '<')

delay += 10;

else if (key.KeyChar == 'X' || key.KeyChar == 'x')

break;

} while (true);

};

await Task.Run(work);

Esto crea una expresión lambda que representa un delegado de Action que lee una
clave de la Consola y modifica una variable local que representa el retraso que se da
cuando el usuario presiona las teclas "<" (menor que) o ">" (mayor que). El método de
delegado finaliza cuando el usuario presiona las teclas "X" o "x", que permiten al usuario
detener la presentación del texto en cualquier momento. Este método usa ReadKey()
para bloquear y esperar a que el usuario presione una tecla.

Para finalizar esta característica, debe crear un nuevo método de devolución async Task
que inicie estas dos tareas ( GetInput y ShowTeleprompter ) y también administre los
datos compartidos entre ellas.

Es hora de crear una clase que controle los datos compartidos entre estas dos tareas.
Esta clase contiene dos propiedades públicas: el retraso y una marca Done para indicar
que el archivo se ha leído completamente:

C#

namespace TeleprompterConsole;

internal class TelePrompterConfig

public int DelayInMilliseconds { get; private set; } = 200;

public void UpdateDelay(int increment) // negative to speed up

var newDelay = Min(DelayInMilliseconds + increment, 1000);

newDelay = Max(newDelay, 20);

DelayInMilliseconds = newDelay;

public bool Done { get; private set; }

public void SetDone()

Done = true;

Coloque esa clase en un archivo nuevo e inclúyala en el espacio de nombres

TeleprompterConsole , tal como se ha mostrado anteriormente. También deberá agregar

una instrucción using static en la parte superior del archivo para que pueda hacer
referencia a los métodos Min y Max sin la clase incluida o los nombres de espacio de
nombres. Una instrucción using static importa los métodos de una clase, Esto contrasta
con la instrucción using sin static , que importa todas las clases de un espacio de
nombres.

C#

using static System.Math;

A continuación, debe actualizar los métodos ShowTeleprompter y GetInput para usar el

nuevo objeto config . Escriba un método final async de devolución de Task para iniciar
ambas tareas y salir cuando la primera tarea finalice:

C#

private static async Task RunTeleprompter()

var config = new TelePrompterConfig();

var displayTask = ShowTeleprompter(config);

var speedTask = GetInput(config);

await Task.WhenAny(displayTask, speedTask);

El método nuevo aquí es la llamada a WhenAny(Task[]). Dicha llamada crea un valor de

Task que finaliza en cuanto alguna de las tareas de su lista de argumentos se completa.

A continuación, debe actualizar los métodos ShowTeleprompter y GetInput para usar el

objeto config para el retraso:

C#

private static async Task ShowTeleprompter(TelePrompterConfig config)

var words = ReadFrom("sampleQuotes.txt");

foreach (var word in words)

Console.Write(word);

if (!string.IsNullOrWhiteSpace(word))

await Task.Delay(config.DelayInMilliseconds);

config.SetDone();

private static async Task GetInput(TelePrompterConfig config)

Action work = () =>

 do {

var key = Console.ReadKey(true);

if (key.KeyChar == '>')

config.UpdateDelay(-10);

else if (key.KeyChar == '<')

config.UpdateDelay(10);

else if (key.KeyChar == 'X' || key.KeyChar == 'x')

config.SetDone();
} while (!config.Done);

};

await Task.Run(work);

Esta nueva versión de ShowTeleprompter llama a un nuevo método de la clase

TeleprompterConfig . Ahora, debe actualizar Main para llamar a RunTeleprompter en

lugar de a ShowTeleprompter :

C#

await RunTeleprompter();

Conclusión
En este tutorial se han mostrado varias características en torno al lenguaje C# y las
bibliotecas .NET Core, relacionadas con el trabajo en aplicaciones de consola. Puede
partir de este conocimiento para explorar más sobre el lenguaje y las clases aquí
presentadas. Ha visto los conceptos básicos de E/S de archivo y consola, el uso con
bloqueo y sin bloqueo de la programación asincrónica basada en tareas, un paseo por
el lenguaje C# y cómo se organizan los programas en C#. También ha conocido la
interfaz de la línea de comandos y la CLI de .NET.

Para obtener más información sobre la E/S de archivo, vea E/S de archivos y secuencias.
Para obtener más información sobre el modelo de programación asincrónica que se ha
usado en este tutorial, vea Programación asincrónica basada en tareas y Programación
asincrónica.
Tutorial: Realización de solicitudes HTTP
en una aplicación de consola de .NET
mediante C#
Artículo • 05/10/2022 • Tiempo de lectura: 8 minutos

En este tutorial se crea una aplicación que emite solicitudes HTTP a un servicio REST en
GitHub. La aplicación lee información en formato JSON y convierte la respuesta JSON en
objetos de C#. La conversión de JSON en objetos de C# se conoce como deserialización.

En el tutorial se muestra cómo hacer lo siguiente:

＂ Enviar solicitudes HTTP

＂ Deserializar respuestas JSON
＂ Configurar la deserialización con atributos

Si prefiere seguir las explicaciones con el ejemplo final del tutorial, puede descargarlo.
Para obtener instrucciones de descarga, vea Ejemplos y tutoriales.

Requisitos previos
SDK de .NET 6.0 o versiones posteriores .
Un editor de código como Visual Studio Code , que es un editor multiplataforma
de código abierto. Puede ejecutar la aplicación de ejemplo en Windows, Linux o
macOS, o bien en un contenedor de Docker.

Creación de la aplicación cliente

1. Abra un símbolo del sistema y cree un directorio para la aplicación. Conviértalo en
el directorio actual.

2. Escriba el siguiente comando en la ventana de consola:

CLI de .NET

dotnet new console --name WebAPIClient

Este comando crea los archivos de inicio para una aplicación básica "Hola mundo".
El nombre del proyecto es "WebAPIClient".

3. Vaya al directorio "WebAPIClient" y ejecute la aplicación.

 CLI de .NET

cd WebAPIClient

CLI de .NET

dotnet run

dotnet run ejecuta automáticamente dotnet restore para restaurar las

dependencias que necesita la aplicación. También ejecuta dotnet build si es
necesario.

Realización de solicitudes HTTP

Esta aplicación llama a la API de GitHub para obtener información sobre los proyectos
incluidos bajo el paraguas de .NET Foundation. El extremo es
https://api.github.com/orgs/dotnet/repos . Para recuperar información, realiza una
solicitud HTTP GET. Los exploradores también realizan solicitudes HTTP GET, por lo que
puede pegar esa dirección URL en la barra de direcciones del explorador para ver la
información que recibirá y procesará.

Use la clase HttpClient para realizar solicitudes HTTP. HttpClient solo admite métodos
asincrónicos para sus API de larga duración. Por lo tanto, los pasos siguientes crean un
método asincrónico y lo llaman desde el método Main.

1. Abra el archivo Program.cs en el directorio del proyecto y agregue el siguiente

método asincrónico a la clase Program :

C#

private static async Task ProcessRepositories()

2. Agregue una directiva using en la parte superior del archivo Program.cs para que
el compilador de C# reconozca el tipo Task:

C#

using System.Threading.Tasks;

 Si ejecuta dotnet build en este momento, la compilación se realiza correctamente,

pero advierte de que este método no contiene ningún operador await y, por
tanto, se ejecuta sincrónicamente. Agregará los operadores await más adelante, a
medida que rellene el método.

3. Reemplace el método Main con el código siguiente:

C#

static async Task Main(string[] args)

await ProcessRepositories();

Este código:

Cambia la firma de Main al agregar el modificador async y cambiar el tipo de

valor devuelto a Task .
Reemplaza la instrucción Console.WriteLine por una llamada a
ProcessRepositories que usa la palabra clave await .

4. En la clase Program , cree una instancia estática de HttpClient para controlar las
solicitudes y las respuestas.

C#

namespace WebAPIClient

class Program

private static readonly HttpClient client = new HttpClient();

static async Task Main(string[] args)

//...

5. En el método ProcessRepositories , llame al punto de conexión de GitHub que

devuelve una lista de todos los repositorios de la organización de .NET Foundation:

C#

private static async Task ProcessRepositories()

client.DefaultRequestHeaders.Accept.Clear();

 client.DefaultRequestHeaders.Accept.Add(

new
MediaTypeWithQualityHeaderValue("application/vnd.github.v3+json"));

client.DefaultRequestHeaders.Add("User-Agent", ".NET Foundation

Repository Reporter");

var stringTask =
client.GetStringAsync("https://api.github.com/orgs/dotnet/repos");

var msg = await stringTask;

Console.Write(msg);

Este código:

Configura encabezados HTTP para todas las solicitudes:

Un encabezado Accept para aceptar respuestas JSON.
Encabezado de User-Agent .
Estos encabezados se comprueban
mediante el código de servidor de GitHub y son necesarios para recuperar
información de GitHub.
Llama a HttpClient.GetStringAsync(String) para realizar una solicitud web y
recuperar la respuesta. Este método inicia una tarea que realiza la solicitud
web. Cuando la solicitud se devuelve, la tarea lee el flujo de respuesta y
extrae el contenido de la secuencia. El cuerpo de la respuesta se devuelve
como un elemento String, que está disponible cuando se completa la tarea.
Espera la tarea hasta que devuelve la cadena de respuesta e imprime la
respuesta en la consola.

6. Agregue dos directivas using en la parte superior del archivo:

C#

using System.Net.Http;

using System.Net.Http.Headers;

7. Compile la aplicación y ejecútela.

CLI de .NET

dotnet run

No hay ninguna advertencia de compilación porque ProcessRepositories ahora

contiene un operador await .

La salida es una larga presentación de texto JSON.

Deserialización del resultado JSON
Los pasos siguientes convierten la respuesta JSON en objetos de C#. La clase
System.Text.Json.JsonSerializer se usa para deserializar JSON en objetos.

1. Cree un archivo con el nombre repo.cs y agregue el código siguiente:

C#

using System;

namespace WebAPIClient

public class Repository

public string name { get; set; }

El código anterior define una clase para representar el objeto JSON devuelto desde
la API de GitHub. Usará esta clase para mostrar una lista de nombres de
repositorio.

El objeto JSON de un objeto de repositorio contiene docenas de propiedades,

pero solo se deserializará la propiedad name . El serializador omite
automáticamente las propiedades JSON para las que no hay ninguna coincidencia
en la clase de destino. Esta característica facilita la creación de tipos que funcionan
con solo un subconjunto de campos de un paquete JSON grande.

La convención de C# es poner en mayúscula la primera letra de los nombres de

propiedad, pero la propiedad name comienza aquí con minúscula porque coincide
exactamente con lo que hay en JSON. Más adelante verá cómo usar nombres de
propiedad de C# que no coinciden con los nombres de propiedad JSON.

2. Use el serializador para convertir JSON en objetos de C#. Reemplace la llamada a

GetStringAsync(String) en el método ProcessRepositories por las líneas siguientes:

C#

var streamTask =
client.GetStreamAsync("https://api.github.com/orgs/dotnet/repos");
var repositories = await
JsonSerializer.DeserializeAsync<List<Repository>>(await streamTask);

 El código actualizado reemplaza GetStringAsync(String) por

GetStreamAsync(String). Este método del serializador usa como origen una
secuencia, en lugar de una cadena.

El primer argumento para JsonSerializer.DeserializeAsync<TValue>(Stream,

JsonSerializerOptions, CancellationToken) es una expresión await . Las expresiones
await pueden aparecer prácticamente en cualquier parte del código, aunque hasta

ahora solo las ha visto como parte de una instrucción de asignación. Los otros dos
parámetros, JsonSerializerOptions y CancellationToken , son opcionales y se
omiten en el fragmento de código.

El método DeserializeAsync es genérico, lo que significa es necesario proporcionar

argumentos de tipo para el tipo de objetos que se debe crear a partir del texto
JSON. En este ejemplo, se va a deserializar a en List<Repository> , que es otro
objeto genérico, System.Collections.Generic.List<T>. La clase List<T> administra
una colección de objetos. El argumento de tipo declara el tipo de objetos
almacenados en List<T> . El argumento de tipo es la clase Repository , porque el
texto JSON representa una colección de objetos de repositorio.

3. Agregue código para mostrar el nombre de cada repositorio. Reemplace las líneas
donde pone:

C#

var msg = await stringTask;

Console.Write(msg);

por el siguiente:

C#

foreach (var repo in repositories)

Console.WriteLine(repo.name);

4. Agregue las siguientes directivas using al principio del archivo:

C#

using System.Collections.Generic;
using System.Text.Json;

5. Ejecutar la aplicación.
 CLI de .NET

dotnet run

La salida es una lista con los nombres de los repositorios que forman parte de
.NET Foundation.

Configuración de la deserialización
1. En repo.cs, cambie la propiedad name a Name y agregue un atributo
[JsonPropertyName] para especificar cómo aparece esta propiedad en JSON.

C#

[JsonPropertyName("name")]

public string Name { get; set; }

2. Agregue el espacio de nombres System.Text.Json.Serialization a las directivas

using :

C#

using System.Text.Json.Serialization;

3. En Program.cs, actualice el código para aplicar el nuevo uso de las mayúsculas de

la propiedad Name :

C#

Console.WriteLine(repo.Name);

4. Ejecutar la aplicación.

La salida es la misma.

Refactorizar el código
El método ProcessRepositories puede realizar el trabajo asincrónico y devolver una
colección de los repositorios. Cambie ese método para devolver List<Repository> y
mueva el código que escribe la información al método Main .
 1. Cambie la signatura de ProcessRepositories para devolver una tarea cuyo
resultado sea una lista de objetos Repository :

C#

private static async Task<List<Repository>> ProcessRepositories()

2. Devuelva los repositorios después de procesar la respuesta JSON:

C#

var streamTask =
client.GetStreamAsync("https://api.github.com/orgs/dotnet/repos");
var repositories = await
JsonSerializer.DeserializeAsync<List<Repository>>(await streamTask);

return repositories;

El compilador genera el objeto Task<T> para el valor devuelto porque ha marcado

este método como async .

3. Modifique el método Main para capturar los resultados y escribir cada nombre de
repositorio en la consola. El método Main tiene el aspecto siguiente:

C#

public static async Task Main(string[] args)

var repositories = await ProcessRepositories();

foreach (var repo in repositories)

Console.WriteLine(repo.Name);

4. Ejecutar la aplicación.

La salida es la misma.

Deserialización de más propiedades

En los pasos siguientes se agrega código para procesar más propiedades del paquete
JSON recibido. Probablemente no le interesará procesar todas las propiedades, pero si
agrega algunas más verá una demostración de otras características de C#.

1. Agregue las propiedades siguientes a la definición de clase Repository :

 C#

[JsonPropertyName("description")]

public string Description { get; set; }

[JsonPropertyName("html_url")]

public Uri GitHubHomeUrl { get; set; }

[JsonPropertyName("homepage")]

public Uri Homepage { get; set; }

[JsonPropertyName("watchers")]

public int Watchers { get; set; }

Los tipos Uri y int tienen una funcionalidad integrada para convertir a y desde la
representación de cadena. No se necesita código adicional para deserializar desde
el formato de cadena de JSON a esos tipos de destino. Si el paquete JSON
contiene datos que no se convierten en un tipo de destino, la acción de
serialización genera una excepción.

2. Actualice el método Main para mostrar los valores de propiedad:

C#

foreach (var repo in repositories)

Console.WriteLine(repo.Name);
Console.WriteLine(repo.Description);

Console.WriteLine(repo.GitHubHomeUrl);

Console.WriteLine(repo.Homepage);

Console.WriteLine(repo.Watchers);

Console.WriteLine();

3. Ejecutar la aplicación.

La lista ahora incluye las propiedades adicionales.

Incorporación de una propiedad de fecha

La fecha de la última operación de inserción presenta este formato en la respuesta
JSON:

JSON

2016-02-08T21:27:00Z

Este es el formato de la hora universal coordinada (UTC), por lo que el resultado de la

deserialización es un valor DateTime cuya propiedad Kind es Utc.

Para que una fecha y hora se represente en su zona horaria, debe escribir un método de
conversión personalizado.

1. En repo.cs, agregue una propiedad public para la representación UTC de la fecha y

hora y una propiedad LastPush readonly que devuelva la fecha convertida en la
hora local:

C#

[JsonPropertyName("pushed_at")]

public DateTime LastPushUtc { get; set; }

public DateTime LastPush => LastPushUtc.ToLocalTime();

La propiedad LastPush se define utilizando un miembro con forma de expresión

para el descriptor de acceso get . No hay ningún descriptor de acceso set . La
omisión del descriptor de acceso set es una forma de definir una propiedad read-
only en C#. (Sí, puede crear propiedades de solo escritura en C#, pero su valor es
limitado).

2. Agregue de nuevo otra instrucción de salida en Program.cs:

C#

Console.WriteLine(repo.LastPush);

3. Ejecutar la aplicación.

La salida incluye la fecha y hora de la última inserción en cada repositorio.

Pasos siguientes
En este tutorial, ha creado una aplicación que realiza solicitudes web y analiza los
resultados. La versión de la aplicación debe coincidir ahora con el ejemplo terminado.

Obtenga más información sobre cómo configurar la serialización JSON en

Procedimiento para serializar y deserializar (calcular referencias y resolver referencias)
JSON en .NET.
Uso de Language-Integrated Query
(LINQ)
Artículo • 22/09/2022 • Tiempo de lectura: 16 minutos

Introducción
En este tutorial aprenderá varias características de .NET Core y el lenguaje C#.
Aprenderá a:

Generar secuencias con LINQ.

Escribir métodos que puedan usarse fácilmente en las consultas LINQ.
Distinguir entre evaluación diligente y diferida.

Aprenderá estas técnicas mediante la creación de una aplicación que muestra uno de
los conocimientos básicos de cualquier mago: el orden aleatorio faro . En resumen, el
orden aleatorio faro es una técnica basada en dividir la baraja exactamente por la mitad;
a continuación, el orden aleatorio intercala cada carta de cada mitad de la baraja hasta
volver a crear la original.

Los magos usan esta técnica porque cada carta está en una ubicación conocida después
de cada orden aleatorio, y el orden sigue un patrón de repetición.

Para el propósito sobre el que trata este artículo, resulta divertido ocuparnos de la
manipulación de secuencias de datos. La aplicación que se va a crear compilará una
baraja de cartas y después realizará una secuencia de órdenes aleatorios, que escribirá
cada vez la secuencia completa. También podrá comparar el orden actualizado con el
original.

Este tutorial consta de varios pasos. Después de cada paso, puede ejecutar la aplicación
y ver el progreso. También puede ver el ejemplo completo en el repositorio
dotnet/samples de GitHub. Para obtener instrucciones de descarga, vea Ejemplos y
tutoriales.

Requisitos previos
Deberá configurar la máquina para ejecutar .NET Core. Puede encontrar las
instrucciones de instalación en la página Descarga de .NET Core . Puede ejecutar esta
aplicación en Windows, Ubuntu Linux, OS X o en un contenedor de Docker. Deberá
instalar su editor de código favorito. En las siguientes descripciones se usa Visual Studio
Code , que es un editor multiplataforma de código abierto. Sin embargo, puede usar
las herramientas que le resulten más cómodas.

Crear la aplicación
El primer paso es crear una nueva aplicación. Abra un símbolo del sistema y cree un
nuevo directorio para la aplicación. Conviértalo en el directorio actual. Escriba el
comando dotnet new console en el símbolo del sistema. Esta acción crea los archivos de
inicio para una aplicación básica "Hola mundo".

Si nunca ha usado C# antes, en este tutorial se explica la estructura de un programa con

C#. Puede leerlo y después volver aquí para obtener más información sobre LINQ.

Creación del conjunto de datos

Antes de empezar, asegúrese de que las líneas siguientes se encuentran al principio del
archivo Program.cs generado por dotnet new console :

C#

// Program.cs

using System;

using System.Collections.Generic;
using System.Linq;

Si estas tres líneas (instrucciones using ) no se encuentran al principio del archivo,

nuestro programa no se compilará.

Ahora que tiene todas las referencias que necesitará, tenga en cuenta lo que constituye
una baraja de cartas. Habitualmente, una baraja de cartas tiene cuatro palos y cada palo
tiene trece valores. Normalmente, podría plantearse crear una clase Card directamente
del archivo bat y rellenar manualmente una colección de objetos Card . Con LINQ,
puede ser más conciso que de costumbre al tratar con la creación de una baraja de
cartas. En lugar de crear una clase Card , puede crear dos secuencias para representar
los palos y rangos, respectivamente. Podrá crear un par sencillo de métodos iterator que
generará las clasificaciones y palos como objetos IEnumerable<T> de cadenas:

C#

// Program.cs

// The Main() method

static IEnumerable<string> Suits()

yield return "clubs";

yield return "diamonds";

yield return "hearts";

yield return "spades";

static IEnumerable<string> Ranks()

yield return "two";

yield return "three";

yield return "four";

yield return "five";

yield return "six";

yield return "seven";

yield return "eight";

yield return "nine";

yield return "ten";

yield return "jack";

yield return "queen";

yield return "king";

yield return "ace";

Colóquelos debajo del método Main en el archivo Program.cs . Estos dos métodos
utilizan la sintaxis yield return para generar una secuencia mientras se ejecutan. El
compilador crea un objeto que implementa IEnumerable<T> y genera la secuencia de
cadenas conforme se solicitan.

Ahora, puede usar estos métodos iterator para crear la baraja de cartas. Insertará la
consulta LINQ en nuestro método Main . Aquí tiene una imagen:

C#

// Program.cs

static void Main(string[] args)

var startingDeck = from s in Suits()

from r in Ranks()

select new { Suit = s, Rank = r };

// Display each card that we've generated and placed in startingDeck in

the console

foreach (var card in startingDeck)

Console.WriteLine(card);

Las cláusulas múltiples from generan una salida SelectMany, que crea una única
secuencia a partir de la combinación de cada elemento de la primera secuencia con
cada elemento de la segunda secuencia. El orden es importante para nuestros
propósitos. El primer elemento de la primera secuencia de origen (palos) se combina
con todos los elementos de la segunda secuencia (clasificaciones). Esto genera las trece
cartas del primer palo. Dicho proceso se repite con cada elemento de la primera
secuencia (palos). El resultado final es una baraja de cartas ordenadas por palos,
seguidos de valores.

Es importante tener en cuenta que si decide escribir las instrucciones LINQ en la sintaxis
de consulta usada anteriormente o utilizar la sintaxis de método en su lugar, siempre es
posible pasar de una forma de sintaxis a la otra. La consulta anterior escrita en la sintaxis
de consulta puede escribirse en la sintaxis de método como:

C#

var startingDeck = Suits().SelectMany(suit => Ranks().Select(rank => new {

Suit = suit, Rank = rank }));

El compilador convierte las instrucciones LINQ escritas en la sintaxis de consulta a la

sintaxis de llamada de método equivalente. Por consiguiente, independientemente de la
sintaxis que prefiera, las dos versiones de la consulta producen el mismo resultado. Elija
la sintaxis más adecuada a su situación: por ejemplo, si trabaja en un equipo en el que
algunos de sus miembros tienen dificultades con la sintaxis de método, procure usar la
sintaxis de consulta.

Continúe y ejecute el ejemplo que se ha creado en este punto. Mostrará todas las 52
cartas de la baraja. Puede ser muy útil ejecutar este ejemplo en un depurador para
observar cómo se ejecutan los métodos Suits() y Ranks() . Puede ver claramente que
cada cadena de cada secuencia se genera solo según sea necesario.
Manipulación del orden
Seguidamente, céntrese en cómo va a establecer el orden aleatorio de las cartas de la
baraja. El primer paso en cualquier orden aleatorio consiste en dividir la baraja en dos.
Los métodos Take y Skip que forman parte de las LINQ API le ofrecen esa característica:
Colóquelos debajo del bucle foreach :

C#

// Program.cs

public static void Main(string[] args)

var startingDeck = from s in Suits()

from r in Ranks()

select new { Suit = s, Rank = r };

foreach (var c in startingDeck)

Console.WriteLine(c);

// 52 cards in a deck, so 52 / 2 = 26

var top = startingDeck.Take(26);

var bottom = startingDeck.Skip(26);

Pero no existe ningún método de orden aleatorio en la biblioteca estándar que pueda
aprovechar, por lo que tendrá que escribir el suyo propio. El método de orden aleatorio
que cree mostrará varias técnicas que se utilizan con programas basados en LINQ, por
lo que cada parte de este proceso se explica en pasos.

Para agregar alguna funcionalidad a la forma de interactuar con el elemento

IEnumerable<T> que obtendrá de las consultas LINQ, tendrá que escribir algunos tipos
especiales de métodos llamados métodos de extensión. En resumen, un método de
extensión es un método estático con una finalidad específica que agrega nueva
funcionalidad a un tipo existente sin tener que modificar el tipo original al que quiere
agregar la funcionalidad.

Proporcione un nuevo espacio a sus métodos de extensión agregando un nuevo archivo

de clase estática al programa denominado Extensions.cs y comience a compilar el
primer método de extensión:

C#

// Extensions.cs

using System;

using System.Collections.Generic;
using System.Linq;

namespace LinqFaroShuffle

public static class Extensions

public static IEnumerable<T> InterleaveSequenceWith<T>(this

IEnumerable<T> first, IEnumerable<T> second)

// Your implementation will go here soon enough

Mire la firma del método por un momento, concretamente los parámetros:

C#

public static IEnumerable<T> InterleaveSequenceWith<T> (this IEnumerable<T>

first, IEnumerable<T> second)

Puede ver la incorporación del modificador this del primer argumento al método. Esto
significa que se llama al método como si fuese un método de miembro del tipo del
primer argumento. Esta declaración de método también sigue una expresión estándar
donde los tipos de entrada y salida son IEnumerable<T> . Dicha práctica permite que los
métodos LINQ se encadenen entre sí para realizar consultas más complejas.
Naturalmente, dado que dividió la baraja en mitades, tendrá que unir esas mitades. En el
código, esto significa que enumerará las dos secuencias adquiridas a través de Take y
Skip a la vez, interleaving los elementos y crear una sola secuencia: su baraja de cartas
recién ordenada aleatoriamente. Escribir un método LINQ que funciona con dos
secuencias requiere que comprenda cómo funciona IEnumerable<T>.

La interfaz IEnumerable<T> tiene un método: GetEnumerator. El objeto devuelto por

GetEnumerator tiene un método para desplazarse al siguiente elemento, así como una
propiedad que recupera el elemento actual de la secuencia. Utilizará estos dos
miembros para enumerar la colección y devolver los elementos. Este método de
intercalación será un método iterador, por lo que en lugar de crear una colección y
devolverla, usará la sintaxis yield return anterior.

A continuación se muestra la implementación de ese método:

C#

public static IEnumerable<T> InterleaveSequenceWith<T>

(this IEnumerable<T> first, IEnumerable<T> second)

var firstIter = first.GetEnumerator();

var secondIter = second.GetEnumerator();

while (firstIter.MoveNext() && secondIter.MoveNext())

yield return firstIter.Current;

yield return secondIter.Current;

Ahora que ha escrito este método, vuelva al método Main y ordene la baraja
aleatoriamente una vez:

C#

// Program.cs

public static void Main(string[] args)

var startingDeck = from s in Suits()

from r in Ranks()

select new { Suit = s, Rank = r };

foreach (var c in startingDeck)

Console.WriteLine(c);

var top = startingDeck.Take(26);

 var bottom = startingDeck.Skip(26);

var shuffle = top.InterleaveSequenceWith(bottom);

foreach (var c in shuffle)

Console.WriteLine(c);

Comparaciones
¿Cuántos órdenes aleatorios se necesitan para devolver la baraja a su orden original?
Para averiguarlo, debe escribir un método que determine si dos secuencias son iguales.
Cuando ya disponga del método, debe colocar el código que ordena la baraja
aleatoriamente en un bucle y comprobarlo para ver cuándo la baraja vuelve a tener su
orden original.

Debe ser sencillo escribir un método para determinar si las dos secuencias son iguales.
Presenta una estructura similar al método que se escribió para ordenar la baraja
aleatoriamente. Solo que esta vez, en lugar de aplicar yield return a cada elemento, se
compararán los elementos coincidentes de cada secuencia. Después de que se haya
enumerado la secuencia completa, si cada elemento coincide, las secuencias son las
mismas:

C#

public static bool SequenceEquals<T>

(this IEnumerable<T> first, IEnumerable<T> second)

var firstIter = first.GetEnumerator();

var secondIter = second.GetEnumerator();

while (firstIter.MoveNext() && secondIter.MoveNext())

if (!firstIter.Current.Equals(secondIter.Current))

return false;

return true;

Esto muestra una segunda expresión LINQ: los métodos de terminal. Adoptan una
secuencia como entrada (o, en este caso, dos secuencias) y devuelven un único valor
escalar. Cuando se utilizan métodos de terminal, siempre son el método final en una
cadena de métodos para una consulta LINQ, de ahí el nombre "terminal".

Puede ver esto en acción cuando lo usa para determinar cuándo la baraja vuelve a tener
su orden original. Coloque el código de orden aleatorio dentro de un bucle y deténgalo
cuando la secuencia vuelva a su orden original, mediante la aplicación del método
SequenceEquals() . Puede observar que siempre se tratará del método final de cualquier

consulta, porque devuelve un único valor en lugar de una secuencia:

C#

// Program.cs

static void Main(string[] args)

// Query for building the deck

// Shuffling using InterleaveSequenceWith<T>();

var times = 0;

// We can re-use the shuffle variable from earlier, or you can make a
new one

shuffle = startingDeck;

do

shuffle = shuffle.Take(26).InterleaveSequenceWith(shuffle.Skip(26));

foreach (var card in shuffle)

Console.WriteLine(card);

Console.WriteLine();

times++;

} while (!startingDeck.SequenceEquals(shuffle));

Console.WriteLine(times);

Ejecute el código que tenga hasta el momento y tome nota de cómo la baraja se
reorganiza en cada orden aleatorio. Después de ocho órdenes aleatorios (iteraciones del
bucle do-while), la baraja vuelve a la configuración original en que se encontraba
cuando la creó a partir la consulta LINQ inicial.

Optimizaciones
El ejemplo creado hasta el momento se ejecuta en orden no aleatorio, donde las cartas
superiores e inferiores son las mismas en cada ejecución. Vamos a realizar un cambio:
utilizaremos una ejecución en orden aleatorio en su lugar, donde las 52 cartas cambian
de posición. Si se trata de un orden aleatorio, intercale la baraja de tal forma que la
primera carta de la mitad inferior sea la primera carta de la baraja. Esto significa que la
última carta de la mitad superior será la carta inferior. Se trata de un cambio simple en
una única línea de código. Actualice la consulta de orden aleatorio actual cambiando las
posiciones de Take y Skip. Se cambiará al orden de las mitades superior e inferior de la
baraja:

C#

shuffle = shuffle.Skip(26).InterleaveSequenceWith(shuffle.Take(26));

Vuelva a ejecutar el programa y verá que, para que la baraja se reordene, se necesitan
52 iteraciones. También empezará a observar algunas degradaciones graves de
rendimiento a medida que el programa continúa en ejecución.

Esto se debe a varias razones. Puede que se trate de una de las principales causas de
este descenso de rendimiento: un uso ineficaz de la evaluación diferida.

En pocas palabras, la evaluación diferida indica que no se realiza la evaluación de una

instrucción hasta que su valor es necesario. Las consultas LINQ son instrucciones se
evalúan de forma diferida. Las secuencias se generan solo a medida que se solicitan los
elementos. Normalmente, es una ventaja importante de LINQ. Sin embargo, en un uso
como el que hace este programa, se produce un aumento exponencial del tiempo de
ejecución.

Recuerde que la baraja original se generó con una consulta LINQ. Cada orden aleatorio
se genera mediante la realización de tres consultas LINQ sobre la baraja anterior. Todas
se realizan de forma diferida. Eso también significa que se vuelven a llevar a cabo cada
vez que se solicita la secuencia. Cuando llegue a la iteración número 52, habrá
regenerado la baraja original demasiadas veces. Se va a escribir un registro para mostrar
este comportamiento. A continuación, podrá corregirlo.

En su archivo Extensions.cs , escriba o copie el siguiente método. Este método de

extensión crea otro archivo denominado debug.log en el directorio del proyecto y
registra la consulta que se ejecuta actualmente en el archivo de registro. Este método de
extensión se puede anexar a una consulta para marcar que se ha ejecutado.

C#

public static IEnumerable<T> LogQuery<T>

(this IEnumerable<T> sequence, string tag)

// File.AppendText creates a new file if the file doesn't exist.

 using (var writer = File.AppendText("debug.log"))

writer.WriteLine($"Executing Query {tag}");

return sequence;

Verá un subrayado en zigzag rojo bajo File , lo que indica que no existe. No se
compilará, ya que el compilador no sabe qué es File . Para solucionar este problema,
asegúrese de agregar la siguiente línea de código bajo la primera línea de
Extensions.cs :

C#

using System.IO;

Esto debería resolver el problema y el error en rojo debería desaparecer.

A continuación, instrumente la definición de cada consulta con un mensaje de registro:

C#

// Program.cs

public static void Main(string[] args)

var startingDeck = (from s in Suits().LogQuery("Suit Generation")

from r in Ranks().LogQuery("Rank Generation")

select new { Suit = s, Rank = r

}).LogQuery("Starting Deck");

foreach (var c in startingDeck)

Console.WriteLine(c);

Console.WriteLine();

var times = 0;

var shuffle = startingDeck;

do

// Out shuffle

/*

shuffle = shuffle.Take(26)

.LogQuery("Top Half")
.InterleaveSequenceWith(shuffle.Skip(26)

.LogQuery("Bottom Half"))

.LogQuery("Shuffle");
*/

 // In shuffle

shuffle = shuffle.Skip(26).LogQuery("Bottom Half")

.InterleaveSequenceWith(shuffle.Take(26).LogQuery("Top
Half"))

.LogQuery("Shuffle");

foreach (var c in shuffle)

Console.WriteLine(c);
}

times++;

Console.WriteLine(times);
} while (!startingDeck.SequenceEquals(shuffle));

Console.WriteLine(times);

Observe que no se genera un registro cada vez que accede a una consulta. El registro
solo se genera cuando crea la consulta original. El programa todavía tarda mucho
tiempo en ejecutarse, pero ahora puede ver por qué. Si se le agota la paciencia al
ejecutar el orden aleatorio interno con los registros activados, vuelva al orden aleatorio
externo. Aún puede ver los efectos de la evaluación diferida. En una ejecución, ejecuta
2592 consultas, incluida toda la generación de palos y valores.

Aquí puede mejorar el rendimiento del código para reducir el número de ejecuciones
que realiza. Una corrección sencilla que puede hacer es almacenar en caché los
resultados de la consulta LINQ original que construye la baraja de cartas. Actualmente,
ejecuta las consultas una y otra vez siempre que el bucle do-while pasa por una
iteración, lo que vuelve a construir la baraja de cartas y cambia continuamente el orden
aleatorio. Para almacenar en caché la baraja de cartas, puede aprovechar los métodos
LINQ ToArray y ToList; cuando los anexe a las consultas, realizarán las mismas acciones
que les ha indicado que hagan, pero ahora almacenarán los resultados en una matriz o
una lista, según el método al que elija llamar. Anexe el método ToArray de LINQ a las
dos consultas y ejecute de nuevo el programa:

C#

public static void Main(string[] args)

var startingDeck = (from s in Suits().LogQuery("Suit Generation")

from r in Ranks().LogQuery("Value Generation")

select new { Suit = s, Rank = r })

.LogQuery("Starting Deck")

.ToArray();

foreach (var c in startingDeck)

Console.WriteLine(c);

Console.WriteLine();

var times = 0;

var shuffle = startingDeck;

do

/*

shuffle = shuffle.Take(26)

.LogQuery("Top Half")
.InterleaveSequenceWith(shuffle.Skip(26).LogQuery("Bottom
Half"))

.LogQuery("Shuffle")

.ToArray();

*/

shuffle = shuffle.Skip(26)

.LogQuery("Bottom Half")

.InterleaveSequenceWith(shuffle.Take(26).LogQuery("Top Half"))

.LogQuery("Shuffle")

.ToArray();

foreach (var c in shuffle)

Console.WriteLine(c);
}

times++;

Console.WriteLine(times);
} while (!startingDeck.SequenceEquals(shuffle));

Console.WriteLine(times);

Ahora el orden aleatorio externo se reduce a 30 consultas. Vuelva a ejecutarlo con el

orden aleatorio interno y verá mejoras similares: ahora ejecuta 162 consultas.

Este ejemplo está diseñado para resaltar los casos de uso en que la evaluación diferida
puede generar dificultades de rendimiento. Si bien es importante ver dónde la
evaluación diferida puede afectar al rendimiento del código, es igualmente importante
entender que no todas las consultas deben ejecutarse de manera diligente. El resultado
de rendimiento en el que incurre sin usar ToArray se debe a que cada nueva disposición
de la baraja de cartas se crea a partir de la disposición anterior. La evaluación diferida
supone que cada nueva configuración de la baraja se realiza a partir de la baraja
original, incluso con la ejecución del código que crea el elemento startingDeck . Esto
conlleva una gran cantidad de trabajo adicional.
En la práctica, algunos algoritmos se ejecutan bien con la evaluación diligente y otros,
con la evaluación diferida. Para el uso diario, la evaluación diferida suele ser una mejor
opción cuando el origen de datos es un proceso independiente, como un motor de
base de datos. Para las bases de datos, la evaluación diferida permite realizar consultas
más complejas que ejecuten un solo recorrido de ida y vuelta al procesamiento de la
base de datos y vuelvan al resto del código. LINQ es flexible tanto si decide usar la
evaluación diligente como la diferida, así que calibre sus procesos y elija el tipo de
evaluación que le ofrece el mejor rendimiento.

Conclusión
En este proyecto ha tratado lo siguiente:

Uso de consultas LINQ para agregar datos a una secuencia significativa

Escritura de métodos de extensión para agregar nuestra propia funcionalidad
personalizada a las consultas LINQ
Localización de áreas en nuestro código donde nuestras consultas LINQ pueden
tener problemas de rendimiento como la degradación de la velocidad
Evaluación diligente y diferida en lo que respecta a las consultas LINQ y las
implicaciones que podrían tener en el rendimiento de la consulta

Aparte de LINQ, ha aprendido algo sobre una técnica que los magos utilizan para hacer
trucos de cartas. Los magos usan el orden aleatorio Faro porque les permite controlar
dónde está cada carta en la baraja. Ahora que lo conoce, no se lo estropee a los demás.

Para más información sobre LINQ, vea:

Language-Integrated Query (LINQ)

Introducción a LINQ
Operaciones básicas de consulta LINQ (C#)
Transformaciones de datos con LINQ (C#)
Sintaxis de consultas y sintaxis de métodos en LINQ (C#)
Características de C# compatibles con LINQ
Uso de Atributos en C#
Artículo • 29/11/2022 • Tiempo de lectura: 7 minutos

Los atributos proporcionan una manera de asociar la información con el código de

manera declarativa. También pueden proporcionar un elemento reutilizable que se
puede aplicar a diversos destinos.

Considere el atributo [Obsolete] . Se puede aplicar a clases, structs, métodos,

constructores y más. Declara que el elemento está obsoleto. Es decisión del compilador
de C# buscar este atributo y realizar alguna acción como respuesta.

En este tutorial, se le introducirá a cómo agregar atributos al código, cómo crear y usar
sus propios atributos y cómo usar algunos atributos que se integran en .NET Core.

Requisitos previos
Deberá configurar la máquina para ejecutar .NET Core. Puede encontrar las
instrucciones de instalación en la página Descargas de .NET Core .
Puede ejecutar esta
aplicación en Windows, Ubuntu Linux, macOS o en un contenedor de Docker.
Deberá
instalar su editor de código favorito. En las siguientes descripciones se usa Visual Studio
Code , que es un editor multiplataforma de código abierto. Sin embargo, puede usar
las herramientas que le resulten más cómodas.

Crear la aplicación
Ahora que ha instalado todas las herramientas, cree una nueva aplicación de .NET Core.
Para usar el generador de línea de comandos, ejecute el siguiente comando en su shell
favorito:

dotnet new console

Este comando creará archivos de proyecto esenciales de .NET Core. Debe ejecutar
dotnet restore para restaurar las dependencias necesarias para compilar este proyecto.

No es necesario ejecutar dotnet restore porque lo ejecutan implícitamente todos los

comandos que necesitan que se produzca una restauración, como dotnet new , dotnet
build , dotnet run , dotnet test , dotnet publish y dotnet pack . Para deshabilitar la
restauración implícita, use la opción --no-restore .

El comando dotnet restore sigue siendo válido en algunos escenarios donde tiene
sentido realizar una restauración explícita, como las compilaciones de integración
continua en Azure DevOps Services o en los sistemas de compilación que necesitan
controlar explícitamente cuándo se produce la restauración.

Para obtener información sobre cómo administrar fuentes de NuGet, vea la

documentación de dotnet restore.

Para ejecutar el programa, use dotnet run . Deberá ver la salida "Hola a todos" a la
consola.

Cómo agregar atributos al código

En C#, los atributos son clases que se heredan de la clase base Attribute . Cualquier
clase que se hereda de Attribute puede usarse como una especie de "etiqueta" en
otros fragmentos de código.
Por ejemplo, hay un atributo llamado ObsoleteAttribute ,
que se usa para indicar que el código está obsoleto y ya no debe utilizarse. Puede
colocar este atributo en una clase, por ejemplo, mediante corchetes.

C#

[Obsolete]

public class MyClass

Tenga en cuenta que, mientras que la clase se denomina ObsoleteAttribute , solo es

necesario usar [Obsolete] en el código. Se trata de una convención que sigue C#.
Puede usar el nombre completo [ObsoleteAttribute] si así lo prefiere.

Cuando se marca una clase como obsoleta, es una buena idea proporcionar alguna
información de por qué es obsoleta, o qué usar en su lugar. Para ello se pasa un
parámetro de cadena al atributo obsoleto.

C#

[Obsolete("ThisClass is obsolete. Use ThisClass2 instead.")]

public class ThisClass

La cadena se pasa como argumento a un constructor ObsoleteAttribute , como si

estuviera escribiendo var attr = new ObsoleteAttribute("some string") .
Los parámetros a un constructor de atributos se limitan a literales o tipos simples: bool,
int, double, string, Type, enums, etc y matrices de esos tipos.
No se puede usar una
expresión o una variable. Es libre de usar parámetros posicionales o con nombre.

Cómo crear su propio atributo

Crear un atributo es tan sencillo como heredarlo de la clase base Attribute .

C#

public class MySpecialAttribute : Attribute

Con lo anterior, ahora puedo usar [MySpecial] (o [MySpecialAttribute] ) como un

atributo en otra parte de la base de código.

C#

[MySpecial]

public class SomeOtherClass

Los atributos de la biblioteca de clases base de .NET como ObsoleteAttribute

desencadenan ciertos comportamientos en el compilador. Sin embargo, cualquier
atributo que cree funcionará como metadatos y no tendrá como resultado ningún
código dentro de la clase de atributo que se ejecuta. Es decisión suya actuar sobre esos
metadatos en otra parte del código (más adelante en este tutorial se hablará sobre ello).

Aquí hay un problema que se debe vigilar. Como se mencionó anteriormente, solo
determinados tipos se puedan pasar como argumentos al usar atributos. Sin embargo,
al crear un tipo de atributo, el compilador de C# no le impedirá crear esos parámetros.
En el ejemplo siguiente, he creado un atributo con un constructor que se compila
correctamente.

C#

public class GotchaAttribute : Attribute

public GotchaAttribute(Foo myClass, string str)

Sin embargo, no podrá usar este constructor con una sintaxis de atributo.

C#

[Gotcha(new Foo(), "test")] // does not compile

public class AttributeFail

Lo anterior provocará un error de compilador como Attribute constructor parameter

'myClass' has type 'Foo', which is not a valid attribute parameter type .

Cómo restringir el uso de atributos

Los atributos pueden usarse en varios destinos. Los ejemplos anteriores los muestran en
las clases, pero ahora se pueden usar en:

Ensamblado
Clase
Constructor
Delegar
Enumeración
evento
Campo
GenericParameter
Interfaz
Método
Módulo
Parámetro
Propiedad.
ReturnValue
Estructura

Cuando se crea una clase de atributo, de forma predeterminada C# podrá usar ese
atributo en cualquiera de los destinos de atributo posibles. Si desea restringir el atributo
a determinados destinos, puede hacerlo mediante la clase de atributo
AttributeUsageAttribute . ¡Sí, un atributo en un atributo!

C#

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
public class MyAttributeForClassAndStructOnly : Attribute

Si intenta colocar el atributo anterior en algo que no sea una clase o un struct, obtendrá
un error del compilador como Attribute 'MyAttributeForClassAndStructOnly' is not
valid on this declaration type. It is only valid on 'class, struct' declarations .

C#

public class Foo

// if the below attribute was uncommented, it would cause a compiler

error

// [MyAttributeForClassAndStructOnly]

public Foo()

{ }

Cómo usar los atributos asociados a un

elemento de código
Los atributos actúan como metadatos. Sin algo de fuerza exterior, no harían realmente
nada.

Para buscar y actuar sobre los atributos, se requiere en general reflexión. En este tutorial
no se tratará la reflexión de forma detallada, pero la idea básica es que la reflexión le
permite escribir código en C# que examina otro código.

Por ejemplo, puede usar reflexión para obtener información sobre una clase (agregue
using System.Reflection; al principio del código):

C#

TypeInfo typeInfo = typeof(MyClass).GetTypeInfo();

Console.WriteLine("The assembly qualified name of MyClass is " +

typeInfo.AssemblyQualifiedName);

La salida será algo como esto: The assembly qualified name of MyClass is
ConsoleApplication.MyClass, attributes, Version=1.0.0.0, Culture=neutral,

PublicKeyToken=null .

Una vez que tenga un objeto TypeInfo (o un elemento MemberInfo , FieldInfo , etc.),
puede usar el método GetCustomAttributes . Este devolverá una colección de objetos
Attribute .
También puede usar GetCustomAttribute y especificar un tipo de atributo.

Este es un ejemplo del uso de GetCustomAttributes en una instancia de MemberInfo para

MyClass (que anteriormente vimos que contiene un atributo [Obsolete] ).

C#

var attrs = typeInfo.GetCustomAttributes();

foreach(var attr in attrs)

Console.WriteLine("Attribute on MyClass: " + attr.GetType().Name);

Eso se imprimirá en la consola: Attribute on MyClass: ObsoleteAttribute . Intente

agregar otros atributos a MyClass .

Es importante tener en cuenta que se crean instancias de estos objetos Attribute de

forma diferida. Es decir, no podrá crea una instancia de ellos hasta que use
GetCustomAttribute o GetCustomAttributes .
También se crea una instancia de ellos cada

vez. Al llamar a GetCustomAttributes dos veces en una fila se devuelven dos instancias
diferentes de ObsoleteAttribute .

Atributos comunes en la biblioteca de clases

base (BCL)
Muchas herramientas y marcos de trabajo emplean atributos. NUnit usa atributos como
[Test] y [TestFixture] que son utilizados por la serie de pruebas NUnit. ASP.NET MVC

usa atributos como [Authorize] y proporciona un marco de filtro de acción para

ejecutar problemas transversales en acciones de MVC. PostSharp usa la sintaxis de
atributo para permitir la programación en C# orientada a aspectos.

Estos son algunos atributos importantes integrados en las bibliotecas de clases base de
.NET Core:

[Obsolete] . Este se usó en los ejemplos anteriores, y se encuentra en el espacio de

nombres System . Es útil proporcionar documentación declarativa sobre una base

de código cambiante. Se puede proporcionar un mensaje en forma de cadena, y se
puede usar otro parámetro booleano para escalarlo de una advertencia del
compilador a un error del compilador.

[Conditional] . Este atributo está en el espacio de nombres System.Diagnostics .

Este atributo se puede aplicar a métodos (o clases de atributos). Debe pasar una
cadena al constructor.
Si esa cadena no coincide con una directiva #define , el
 compilador de C# quitará las llamadas a ese método (pero no el método
propiamente dicho). Normalmente se usa con fines de depuración (diagnósticos).

[CallerMemberName] . Este atributo se puede usar en parámetros, y reside en el

espacio de nombres System.Runtime.CompilerServices . Es un atributo que se usa

para inyectar el nombre del método que llama a otro método. Esto se usa
normalmente como una manera de eliminar "cadenas mágicas" al implementar
INotifyPropertyChanged en distintos marcos de interfaz de usuario. Por ejemplo:

C#

public class MyUIClass : INotifyPropertyChanged

public event PropertyChangedEventHandler PropertyChanged;

public void RaisePropertyChanged([CallerMemberName] string propertyName

= null)

PropertyChanged?.Invoke(this, new
PropertyChangedEventArgs(propertyName));

private string _name;

public string Name

get { return _name;}

set

if (value != _name)

_name = value;

RaisePropertyChanged(); // notice that "Name" is not

needed here explicitly

En el código anterior, no necesita tener una cadena "Name" de literal. Esto puede ayudar
a impedir errores relacionados con los tipos y también agiliza los procesos de
refactorización o cambio de nombre.

Resumen
Los atributos traen la eficacia declarativa a C#, pero son una forma de metadatos de
código y no actúan por sí mismos.
Tipos de referencia que aceptan valores
NULL
Artículo • 20/02/2023 • Tiempo de lectura: 20 minutos

En un contexto "oblivious" que acepta valores NULL, todos los tipos de referencia
aceptaban valores null. Los tipos de referencia que aceptan valores NULL hacen
referencia a un grupo de características habilitadas en un contexto que admite un valor
NULL que minimizan las probabilidades de que el código haga que el tiempo de
ejecución genere System.NullReferenceException. Los tipos de referencia que aceptan
valores NULL incluyen tres características que ayudan a evitar estas excepciones, incluida
la capacidad de marcar explícitamente un tipo de referencia como que acepta valores
NULL:

El análisis de flujo estático mejorado que determina si una variable puede estar
null antes de desreferenciarla.

Los atributos que anotan las API para que el análisis de flujo determine el null-
state.
Las anotaciones de variables que los desarrolladores usan para declarar
explícitamente el null-state previsto para una variable.

El análisis de null-state y las anotaciones de variables están deshabilitados de forma

predeterminada en los proyectos existentes, lo que significa que todos los tipos de
referencia siguen aceptando valores NULL. A partir de .NET 6, están habilitados de
forma predeterminada en los proyectos nuevos. Para obtener información sobre cómo
habilitar estas características mediante la declaración de un contexto de anotación que
acepta valores NULL, vea Contextos que aceptan valores NULL.

En el resto de este artículo se describe cómo funcionan esas tres áreas de características
para generar advertencias cuando el código puede estar desreferenciando un valor
null . Desreferenciar una variable significa acceder a uno de sus miembros mediante el
operador . (punto), como se muestra en el ejemplo siguiente:

C#

string message = "Hello, World!";

int length = message.Length; // dereferencing "message"

Al desreferenciar una variable cuyo valor es null , el entorno de ejecución produce una
excepción System.NullReferenceException.
También puede explorar estos conceptos en nuestro módulo de aprendizaje sobre
Seguridad sobre la aceptación de valores NULL en C#.

Análisis del null-state

El análisis de null-state realiza el seguimiento del elemento null-state de las referencias.
Este análisis estático emite advertencias cuando puede que el código desreferencie
null . Puede solucionar estas advertencias para minimizar las incidencias cuando el
entorno de ejecución produce una excepción System.NullReferenceException. El
compilador usa el análisis estático para determinar el estado null-state de una variable.
Una variable puede ser not-null o maybe-null. El compilador determina que una variable
es not-null de dos maneras:

1. Se ha asignado un valor a la variable que se sabe que no es NULL.

2. La variable se ha comprobado con null y no se ha modificado desde esa
comprobación.

Cualquier variable que el compilador no haya determinado como not-null se considera

maybe-null. El análisis proporciona advertencias en situaciones en las que puede
desreferenciar accidentalmente un valor null . El compilador genera advertencias
basadas en el estado null-state.

Cuando una variable es not-null, esa variable se puede desreferenciar de forma

segura.
Cuando una variable es maybe-null, se debe comprobar esa variable para
asegurarse de que no sea null antes de desreferenciarla.

Considere el ejemplo siguiente:

C#

string message = null;

// warning: dereference null.

Console.WriteLine($"The length of the message is {message.Length}");

var originalMessage = message;

message = "Hello, World!";

// No warning. Analysis determined "message" is not null.

Console.WriteLine($"The length of the message is {message.Length}");

// warning!

Console.WriteLine(originalMessage.Length);

En el ejemplo anterior, el compilador determina que message es maybe-null cuando se

imprime el primer mensaje. No hay ninguna advertencia para el segundo mensaje. La
línea de código final genera una advertencia porque originalMessage podría ser NULL.
En el ejemplo siguiente se muestra un uso más práctico para recorrer un árbol de nodos
hasta la raíz y procesar cada nodo durante el recorrido:

C#

void FindRoot(Node node, Action<Node> processNode)

for (var current = node; current != null; current = current.Parent)

processNode(current);

El código anterior no genera advertencias para desreferenciar la variable current . El

análisis estático determina que current nunca se desreferencie cuando es maybe-null.
La variable current se comprueba con null antes de acceder a current.Parent y antes
de pasar current a la acción ProcessNode . En los ejemplos anteriores se muestra cómo
el compilador determina el estado null-state de las variables locales cuando se
inicializan, se asignan o se comparan con null .

El análisis del estado NULL no realiza un seguimiento de los métodos llamados. Como
resultado, los campos inicializados en un método auxiliar común llamado por
constructores generarán una advertencia con la plantilla siguiente:

La propiedad "name" que no acepta valores NULL debe contener un valor distinto
de NULL al salir del constructor.

Puede solucionar estas advertencias de una de estas dos maneras: encadenamiento de

constructores o atributos que aceptan valores NULL en el método auxiliar. En el código
siguiente se muestra un ejemplo de cada caso. La clase Person usa un constructor
común al que llaman todos los demás constructores. La clase Student tiene un método
auxiliar anotado con el atributo
System.Diagnostics.CodeAnalysis.MemberNotNullAttribute:

C#

using System.Diagnostics.CodeAnalysis;

public class Person

 public string FirstName { get; set; }

public string LastName { get; set; }

public Person(string firstName, string lastName)

FirstName = firstName;

LastName = lastName;

public Person() : this("John", "Doe") { }

public class Student : Person

public string Major { get; set; }

public Student(string firstName, string lastName, string major)

: base(firstName, lastName)

SetMajor(major);

public Student(string firstName, string lastName) :

base(firstName, lastName)

SetMajor();

public Student()

SetMajor();

[MemberNotNull(nameof(Major))]

private void SetMajor(string? major = default)

Major = major ?? "Undeclared";

７ Nota

Se agregaron varias mejoras para la asignación definitiva y el análisis de estado

NULL en C# 10. Al actualizar a C# 10, es posible que encuentre menos advertencias
que admiten un valor NULL que son falsos positivos. Puede obtener más
información sobre las mejoras en la especificación de características para las
mejoras de la asignación definitiva.

El análisis de estado que acepta valores NULL y las advertencias que genera el
compilador ayudan a evitar errores de programa mediante la anulación de la referencia
a null . En el artículo sobre cómo resolver advertencias que aceptan valores NULL se
proporcionan técnicas para corregir las advertencias que probablemente verá en el
código.

Atributos en firmas de API

El análisis del estado null-state necesita sugerencias de los desarrolladores para
comprender la semántica de las API. Algunas API proporcionan comprobaciones NULL y
deben cambiar el estado null-state de una variable de maybe-null a not-null. Otras API
devuelven expresiones que son not-null o maybe-null en función del estado null-state
de los argumentos de entrada. Por ejemplo, considere el siguiente código que muestra
un mensaje:

C#

public void PrintMessage(string message)

if (!string.IsNullOrWhiteSpace(message))

Console.WriteLine($"{DateTime.Now}: {message}");
}

En función de la inspección, cualquier desarrollador consideraría que este código es

seguro y no debería generar advertencias. El compilador no sabe que
IsNullOrWhiteSpace proporciona una comprobación de valores NULL. Cuando

IsNullOrWhitespace devuelve false, , el estado null de la cadena es not-null. Cuando

IsNullOrWhitespace devuelve true , el estado null no cambia. En el ejemplo anterior, la

firma incluye NotNullWhen para indicar el estado null-state de message :

C#

public static bool IsNullOrWhiteSpace([NotNullWhen(false)] string message);

Los atributos proporcionan información detallada sobre el estado null-state de los

argumentos, los valores devueltos y los miembros de la instancia de objeto utilizada
para invocar a un miembro. Los detalles de cada atributo se pueden encontrar en el
artículo de referencia del lenguaje sobre los atributos de referencia que aceptan valores
NULL. Todas las API del entorno de ejecución de .NET se han anotado en .NET 5. Para
mejorar el análisis estático, se anotan las API para proporcionar información semántica
sobre el estado null-state de los argumentos y los valores devueltos.
Anotaciones de variables que aceptan valores
NULL
El análisis de null-state proporciona un análisis sólido para la mayoría de las variables. El
compilador necesita más información de usted para las variables de miembro. El
compilador no puede hacer suposiciones sobre el orden en el que se accede a los
miembros públicos. Se puede acceder a cualquier miembro público en cualquier orden.
Cualquiera de los constructores accesibles se podría usar para inicializar el objeto. Si un
campo de miembro se puede establecer alguna vez en null , el compilador debe
suponer que su null-state es maybe-null al principio de cada método.

Se usan anotaciones que pueden declarar si una variable es un tipo de referencia que
acepta valores NULL o un tipo de referencia que no acepta valores NULL. Estas
anotaciones hacen instrucciones importantes sobre el estado null-state de las variables:

Se supone que una referencia no debe ser NULL. El estado predeterminado de

una variable de referencia que no acepta valores NULL es not-null. El compilador
aplica reglas que garantizan que sea seguro desreferenciar dichas variables sin
comprobar primero que no se trata de un valor NULL:
La variable debe inicializarse como un valor distinto a NULL.
No se puede asignar el valor null a la variable. El compilador emite una
advertencia cuando el código asigna una expresión maybe-null a una variable
que no debería ser NULL.
Una referencia puede ser NULL. El estado predeterminado de una variable de
referencia que acepta valores NULL es maybe-null. El compilador aplica reglas para
garantizar que haya comprobado correctamente una referencia null :
Solo se puede desreferenciar la variable si el compilador puede garantizar que
el valor no sea null .
Estas variables se pueden inicializar con el valor null predeterminado, y se les
puede asignar el valor null en otro código.
El compilador no emite advertencias cuando el código asigna una expresión
maybe-null a una variable que podría ser NULL.

Cualquier variable de referencia que no se suponga que es null tiene un estado null-
state de not-null. Cualquier variable de referencia que pueda ser null inicialmente tiene
el estado null-state de maybe-null.

Un tipo de referencia que acepta valores NULL se anota con la misma sintaxis que los
tipos de valor que aceptan valores NULL: se agrega ? junto al tipo de la variable. Por
ejemplo, la siguiente declaración de variable representa una variable de cadena que
acepta valores NULL, name :
 C#

string? name;

Cualquier variable en la que ? no se anexe al nombre de tipo es un tipo de referencia

que no acepta valores NULL. Esto incluye todas las variables de tipo de referencia en el
código existente en el momento en el que se habilita esta característica. Sin embargo,
cualquier variable local con tipo implícito (declarada mediante var ) es un tipo de
referencia que acepta valores NULL. Como se ha mostrado en las secciones anteriores,
el análisis estático determina el estado null-state de las variables locales para determinar
si son maybe-null.

En algunas ocaciones, debe invalidar una advertencia si sabe que una variable no es
NULL pero el compilador determina que su null-state es maybe-null. Use el operador
null-forgiving ! después de un nombre de variable para forzar que null-state sea not-
null. Por ejemplo, si sabe que la variable name no es null , pero el compilador genera
una advertencia, puede escribir el código siguiente para invalidar el análisis del
compilador:

C#

name!.Length;

Los tipos de referencia que aceptan valores NULL y los tipos de valor que aceptan
valores NULL proporcionan un concepto semántico similar: una variable puede
representar un valor u objeto, o esa variable puede ser null . Sin embargo, los tipos de
referencia que aceptan valores NULL y los tipos de valor que aceptan valores NULL se
implementan de forma diferente: los tipos de valor que aceptan valores NULL se
implementan mediante System.Nullable<T> y los tipos de referencia que aceptan
valores NULL se implementan mediante atributos leídos por el compilador. Por ejemplo,
string? y  string se representan mediante el mismo tipo: System.String. Sin embargo,
int? y int se representan mediante System.Nullable<System.Int32> y System.Int32,

respectivamente.

Los tipos de referencia no nulas son una característica de tiempo de compilación. Esto
significa que es posible que los autores de llamadas ignoren las advertencias, utilizando
intencionadamente null como argumento de un método que espera una referencia no
nula. Los autores de bibliotecas deben incluir comprobaciones en tiempo de ejecución
con valores de argumento NULL. ArgumentNullException.ThrowIfNull es la opción
preferida para comparar un parámetro con NULL en tiempo de ejecución.
 ） Importante

La habilitación de anotaciones nulas puede cambiar la forma en que Entity

Framework Core determina si se requiere un miembro de datos. Puede obtener
más información en el artículo sobre aspectos básicos de Entity Framework:
Trabajar con tipos de referencia nula.

Genéricos
Los genéricos requieren reglas detalladas para controlar T? para cualquier parámetro
de tipo T . Las reglas se detallan necesariamente debido al historial y a la
implementación diferente para un tipo de valor que acepta valores NULL y un tipo de
referencia que acepta valores NULL. Los tipos de valor que aceptan valores NULL se
implementan mediante la estructura System.Nullable<T>. Los tipos de referencia que
aceptan valores NULL se implementan como anotaciones de tipo que proporcionan
reglas semánticas al compilador.

Si el argumento de tipo de T es un tipo de referencia, T? hace referencia al tipo

de referencia que acepta valores NULL correspondiente. Por ejemplo, si T es un
elemento string , entonces T? es un elemento string? .
Si el argumento de tipo de T es un tipo de valor, T? hace referencia al mismo tipo
de valor, T . Por ejemplo, si T es un elemento int , T? también es un elemento
int .
Si el argumento de tipo de T es un tipo de referencia que acepta valores NULL, T?
hace referencia a ese mismo tipo de referencia que acepta valores NULL. Por
ejemplo, si T es un elemento string? , entonces T? también es un elemento
string? .

Si el argumento de tipo de T es un tipo de valor que acepta valores NULL, T? hace

referencia a ese mismo tipo de valor que acepta valores NULL. Por ejemplo, si T es
un elemento int? , entonces T? también es un elemento int? .

Para los valores devueltos, T? es equivalente a [MaybeNull]T ; para los valores de

argumento, T? es equivalente a [AllowNull]T . Para obtener más información, consulte
el artículo sobre Atributos para el análisis de estado NULL en la referencia del lenguaje.

Puede especificar un comportamiento diferente mediante restricciones:

La restricción class significa que T debe ser un tipo de referencia que no acepta
valores NULL (por ejemplo, string ). El compilador genera una advertencia si se
 usa un tipo de referencia que acepta valores NULL, como string? para T .
La restricción class? significa que T debe ser un tipo de referencia, ya sea un tipo
de referencia que no acepta valores NULL ( string ) o un tipo de referencia que
acepta valores NULL (por ejemplo, string? ). Cuando el parámetro de tipo es un
tipo de referencia que acepta valores NULL, como string? , una expresión de T?
hace referencia a ese mismo tipo de referencia que acepta valores NULL, como
string? .
La restricción notnull significa que T debe ser un tipo de referencia que no
acepta valores NULL o un tipo de valor que no acepta valores NULL. Si usa un tipo
de referencia que acepta valores NULL o un tipo de valor que acepta valores NULL
para el parámetro de tipo, el compilador genera una advertencia. Además, cuando
T es un tipo de valor, el valor devuelto es ese tipo de valor, no el tipo de valor que
acepta valores NULL correspondiente.

Estas restricciones ayudan a proporcionar más información al compilador sobre cómo se

usará T . Esto ayuda cuando los desarrolladores eligen el tipo para T y proporciona un
mejor análisis de null-state cuando se usa una instancia del tipo genérico.

Contextos que aceptan valores NULL

Las nuevas características que protegen contra la generación de un elemento
System.NullReferenceException pueden ser perjudiciales cuando están activadas en un
código base existente:

Todas las variables de referencia con tipo explícito se interpretan como tipos de
referencia que no aceptan valores NULL.
El significado de la restricción class en genéricos cambió para significar un tipo
de referencia que no acepta valores NULL.
Se generan nuevas advertencias debido a estas nuevas reglas.

Debe elegir expresamente usar estas características en los proyectos existentes. Esto
proporciona una ruta de migración y conserva la compatibilidad con versiones
anteriores. Los contextos que aceptan valores NULL permiten un control preciso sobre
cómo interpreta el compilador las variables de tipos de referencia. El contexto de
anotación que acepta valores NULL determina el comportamiento del compilador. Hay
cuatro valores para el contexto de anotación que acepta valores NULL:

disable: el código es "oblivious" que admite un valor NULL.

Las advertencias que aceptan valores NULL están deshabilitadas.
Todas las variables de tipo de referencia son tipos de referencia que aceptan
valores NULL.
 No se puede declarar una variable como un tipo de referencia que acepta
valores NULL mediante el sufijo ? en el tipo.
Puede usar el operador que permite un valor NULL, ! , pero no tiene ningún
efecto.
enable: el compilador permite todo el análisis de referencias nulas y todas las
características del lenguaje.
Todas las nuevas advertencias que aceptan valores NULL están habilitadas.
Puede usar el sufijo ? para declarar un tipo de referencia que acepta valores
NULL.
Todas las demás variables de tipo de referencia son tipos de referencia que no
aceptan valores NULL.
El operador que permite valores NULL elimina las advertencias de una posible
asignación a null .
warnings: el compilador realiza todos los análisis de valores NULL y emite
advertencias cuando el código pueda desreferenciar null .
Todas las nuevas advertencias que aceptan valores NULL están habilitadas.
El uso del sufijo ? para declarar un tipo de referencia que acepta valores NULL
genera una advertencia.
Todas las variables de tipo de referencia pueden ser NULL. Sin embargo, los
miembros tienen el estado null-state de not-null en la llave de apertura de
todos los métodos, a menos que se declaren con el sufijo ? .
Puede usar el operador que permite valores NULL, ! .
annotations: el compilador no realiza análisis de valores NULL ni emite
advertencias cuando el código pueda desreferenciar null .
Todas las nuevas advertencias que aceptan valores NULL están deshabilitadas.
Puede usar el sufijo ? para declarar un tipo de referencia que acepta valores
NULL.
Todas las demás variables de tipo de referencia son tipos de referencia que no
aceptan valores NULL.
Puede usar el operador que permite un valor NULL, ! , pero no tiene ningún
efecto.

Tanto el contexto de anotación que acepta valores NULL como el contexto de

advertencia que acepta valores NULL pueden establecerse en un proyecto con el
elemento <Nullable> del archivo .csproj. Este elemento configura la forma en la que el
compilador interpreta la nulabilidad de los tipos y las advertencias que se generan. En la
tabla siguiente se muestran los valores permitidos y se resumen los contextos que
dichos valores especifican.
 Context Advertencias de Advertencias Tipos de Sufijo ? Operador !
desreferenciación de referencia
asignación

disable Disabled Disabled Todos aceptan No se No tiene

valores NULL. puede usar. ningún
efecto.

enable habilitado habilitado No acepta Declara un Suprime las

valores NULL a tipo que advertencias
menos que se acepta relativas a
declare con ? . valores una posible
NULL. asignación
null .

warnings habilitado No aplicable Todos aceptan Genera una Suprime las

valores NULL, advertencia. advertencias
pero los relativas a
miembros se una posible
consideran no asignación
NULL en la null .
llave de
apertura de los
métodos.

annotations Disabled Disabled No acepta Declara un No tiene

valores NULL a tipo que ningún
menos que se acepta efecto.
declare con ? . valores
NULL.

Las variables de tipo de referencia en el código compilado en un contexto deshabilitado

son nullable-oblivious. Puede asignar un valor null literal o una variable maybe-null a
una variable que es nullable-oblivious. Sin embargo, el estado predeterminado de una
variable nullable-oblivious es not-null.

Puede elegir qué configuración es la mejor para el proyecto:

Elija disable para los proyectos heredados que no quiere actualizar en función de
diagnósticos o nuevas características.
Elija warnings para determinar dónde el código puede producir
System.NullReferenceException. Puede solucionar esas advertencias antes de
modificar el código para habilitar tipos de referencia que no aceptan valores NULL.
Elija annotations para expresar la intención de diseño antes de habilitar las
advertencias.
Elija enable para nuevos proyectos y proyectos activos en los que quiera
protegerse de excepciones de referencia nula.
Ejemplo:

XML

<Nullable>enable</Nullable>

También puede usar directivas para establecer los mismos contextos en cualquier lugar
del código fuente: Son muy útiles cuando se migra un código base grande.

#nullable enable : establece el contexto de anotación nula y el contexto de

advertencia nula en enable.
#nullable disable : establece el contexto de anotación nula y el contexto de

advertencia nula en disable.

#nullable restore : restaura el contexto de anotación que acepta valores NULL y el

contexto de advertencia que acepta valores NULL según la configuración del

proyecto.
#nullable disable warnings : establezca el contexto de advertencia nula en

disable.
#nullable enable warnings : establece el contexto de advertencia nula en enable.

#nullable restore warnings : restaura el contexto de advertencia que acepta

valores NULL según la configuración del proyecto.
#nullable disable annotations : establece el contexto de anotación nula en
disable.
#nullable enable annotations : establece el contexto de anotación nula en enable.

#nullable restore annotations : restaura el contexto de advertencia de anotación

según la configuración del proyecto.

Para cualquier línea de código, puede establecer cualquiera de las siguientes

combinaciones:

Contexto de Contexto de Uso

advertencia anotación

proyecto proyecto Valor predeterminado

predeterminado predeterminado

enable disable Corrección de advertencias de análisis

enable proyecto Corrección de advertencias de análisis

predeterminado

proyecto enable Adición de anotaciones de tipo

predeterminado
 Contexto de Contexto de Uso
advertencia anotación

enable enable Código ya migrado

disable enable Anotación de código antes de corregir

advertencias

disable disable Adición de código heredado al proyecto

migrado

proyecto disable Raramente

predeterminado

disable proyecto Raramente

predeterminado

Esas nueve combinaciones proporcionan un control preciso sobre los diagnósticos que
el compilador emite para el código. Puede habilitar más características en cualquier área
que esté actualizando sin ver advertencias adicionales que aún no está listo para
abordar.

） Importante

El contexto global que admite un valor NULL no se aplica a los archivos de código
generado. En cualquier estrategia, el contexto que admite un valor NULL está
deshabilitado para cualquier archivo de código fuente marcado como generado.
Esto significa que las API de los archivos generados no se anotan. Hay cuatro
maneras de marcar un archivo como generado:

1. En el archivo .editorconfig, especifique generated_code = true en una sección

que se aplique a ese archivo.
2. Coloque <auto-generated> o <auto-generated/> en un comentario en la parte
superior del archivo. Puede estar en cualquier línea de ese comentario, pero el
bloque de comentario debe ser el primer elemento del archivo.
3. Inicie el nombre de archivo con TemporaryGeneratedFile_
4. Finalice el nombre de archivo con .designer.cs, .generated.cs, .g.cs o .g.i.cs.

Los generadores pueden optar por usar la directiva de preprocesador #nullable.

De forma predeterminada, los contextos de advertencias y anotaciones que aceptan

valores NULL están deshabilitados. Esto implica que el código existente se compila sin
cambios y sin generar ninguna advertencia nueva. A partir de .NET 6, los proyectos
nuevos incluyen el elemento <Nullable>enable</Nullable> en todas las plantillas de
proyecto.

Estas opciones proporcionan dos estrategias distintas para actualizar un código base
existente para usar tipos de referencia que aceptan valores NULL.

Problemas conocidos
Las matrices y estructuras que contienen tipos de referencia son dificultades conocidas
en las referencias que aceptan valores NULL y el análisis estático que determina la
seguridad de los valores NULL. En ambas situaciones, se puede inicializar una referencia
que no acepta valores NULL en null sin generar advertencias.

Estructuras
Una estructura que contiene tipos de referencia que no aceptan valores NULL permite
asignarle default sin ninguna advertencia. Considere el ejemplo siguiente:

C#

using System;

#nullable enable

public struct Student

public string FirstName;

public string? MiddleName;

public string LastName;

public static class Program

public static void PrintStudent(Student student)

Console.WriteLine($"First name: {student.FirstName.ToUpper()}");

Console.WriteLine($"Middle name: {student.MiddleName?.ToUpper()}");

Console.WriteLine($"Last name: {student.LastName.ToUpper()}");

public static void Main() => PrintStudent(default);

En el ejemplo anterior, no hay ninguna advertencia en PrintStudent(default) mientras

que los tipos de referencia que no aceptan valores NULL FirstName y LastName son
NULL.
Otro caso más común es cuando se trata de estructuras genéricas. Considere el ejemplo
siguiente:

C#

#nullable enable

public struct Foo<T>

public T Bar { get; set; }

public static class Program

public static void Main()

string s = default(Foo<string>).Bar;

En el ejemplo anterior, la propiedad Bar será null en tiempo de ejecución y se asigna a

una cadena que no acepta valores NULL sin ninguna advertencia.

Matrices
Las matrices también son un problema conocido en los tipos de referencia que aceptan
valores NULL. Considere el ejemplo siguiente, que no genera ninguna advertencia:

C#

using System;

#nullable enable

public static class Program

public static void Main()

string[] values = new string[10];

string s = values[0];

Console.WriteLine(s.ToUpper());

En el ejemplo anterior, la declaración de la matriz muestra que contiene cadenas que no

aceptan valores NULL, mientras que todos sus elementos se inicializan en null .
Después, a la variable s se le asigna un valor null (el primer elemento de la matriz). Por
último, se desreferencia la variable s , lo que genera una excepción en tiempo de
ejecución.

Vea también
Tipos de referencia que aceptan valores NULL: propuesta
Borrador de especificación de tipos de referencia que aceptan valores NULL
Anotaciones de parámetros de tipo sin restricciones
Tutorial de introducción a las referencias que no aceptan valores NULL
Nullable (opción del compilador de C#)
Actualización de un código base con
tipos de referencia que admiten un
valor NULL para mejorar las
advertencias sobre diagnósticos nulos
Artículo • 15/02/2023 • Tiempo de lectura: 8 minutos

Los tipos de referencia que admiten un valor NULL permiten declarar si a las variables
de un tipo de referencia se les debe asignar o no un valor null . El análisis estático y las
advertencias del compilador cuando el código podría desreferenciar null son la ventaja
más importante de esta característica. Una vez habilitado, el compilador genera
advertencias que ayudan a evitar que se genere una excepción
System.NullReferenceException cuando se ejecuta el código.

Si el código base es relativamente pequeño, puede activar la característica en el

proyecto, resolver advertencias y disfrutar de las ventajas que ofrecen los diagnósticos
mejorados. Los códigos base más grandes pueden requerir un enfoque más
estructurado para resolver advertencias a lo largo del tiempo, habilitar la característica
para algunos a medida que usted resuelve advertencias en distintos tipos o archivos. En
este artículo se describen distintas estrategias para actualizar un código base y las
contrapartidas asociadas a estas estrategias. Antes de iniciar la migración, lea la
introducción conceptual de los tipos de referencia que admiten un valor NULL. En ella se
trata el análisis estático del compilador, los valores null-state de maybe-null y not-null y
las anotaciones que admiten un valor NULL. Una vez que se haya familiarizado con esos
conceptos y términos, podrá migrar su código.

Planeación de la migración
Independientemente de cómo actualice su código base, el objetivo es que las
advertencias y anotaciones que admiten un valor NULL estén habilitadas en su proyecto.
Una vez que alcance ese objetivo, tendrá el valor <nullable>Enable</nullable> en su
proyecto. No necesitará ninguna de las directivas del preprocesador para ajustar la
configuración en otro lugar.

La primera opción es establecer el valor predeterminado para el proyecto. Las opciones

son:

1. ‘Disable’ que admite valores NULL como valor predeterminado: disable es el

predeterminado si no se agrega ningún elemento Nullable a su archivo de
 proyecto. Use este valor predeterminado cuando no esté agregando activamente
nuevos archivos al código base. La actividad principal es actualizar la biblioteca
para que utilice tipos de referencia que admiten un valor NULL. Si se usa este valor
predeterminado, se agrega una directiva de preprocesador que admite un valor
NULL a cada archivo a medida que actualice su código.
2. ‘Enable’ que admite valores NULL como valor predeterminado: Establezca este
valor predeterminado al desarrollar activamente características nuevas. Quiere que
todo el código nuevo se beneficie de los tipos de referencia y análisis estáticos que
admiten un valor NULL. Si usa este valor predeterminado, deberá agregar un valor
#nullable disable en la parte superior de cada archivo. Quitará estas directivas de

preprocesador a medida que aborde las advertencias de cada archivo.

3. Advertencias que admiten valores NULL como valor predeterminado: Elija este
valor predeterminado para una migración de dos fases. En la primera fase, resuelva
las advertencias. En la segunda fase, active las anotaciones para declarar el valor
null-state que se espera de una variable. Si usa este valor predeterminado, deberá
agregar un valor #nullable disable en la parte superior de cada archivo.
4. Anotaciones que admiten valores NULL como valor predeterminado. Anote el
código antes de resolver las advertencias.

Al habilitar una opción que admite un valor NULL como predeterminada, se genera más
trabajo previo para agregar las directivas del preprocesador a cada archivo. La ventaja es
que todos los archivos de código nuevos que se agreguen al proyecto estarán
habilitados para aceptar valores NULL. Cualquier trabajo nuevo admitirá valores NULL;
solo se debe actualizar el código existente. Si se deshabilita la opción que admite un
valor NULL, este proceso funcionará mejor si la biblioteca es estable y el objetivo
principal del desarrollo es adoptar tipos de referencia que admiten un valor NULL. Los
tipos de referencia que aceptan valores NULL se habilitan al anotar las API. Cuando haya
terminado, habilite los tipos de referencia que aceptan valores NULL para todo el
proyecto. Al crear un archivo nuevo, debe agregar las directivas del preprocesador y
hacer que sea compatible con los valores NULL. Si alguno de los desarrolladores de su
equipo se olvida de hacerlo, ese nuevo código se sumará al trabajo pendiente para
hacer que todo el código admita valores NULL.

La elección de una estrategia u otra dependerá de la cantidad de desarrollo activo que

haya en el proyecto. Cuanto más desarrollado esté y más estable sea su proyecto, más
adecuada será la segunda estrategia. Cuantas más características se estén desarrollando,
más apropiada será la primera estrategia.

） Importante
 El contexto global que admite un valor NULL no se aplica a los archivos de código
generado. En cualquier estrategia, el contexto que admite un valor NULL está
deshabilitado para cualquier archivo de código fuente marcado como generado.
Esto significa que las API de los archivos generados no se anotan. Hay cuatro
maneras de marcar un archivo como generado:

1. En el archivo .editorconfig, especifique generated_code = true en una sección

que se aplique a ese archivo.
2. Coloque <auto-generated> o <auto-generated/> en un comentario en la parte
superior del archivo. Puede estar en cualquier línea de ese comentario, pero el
bloque de comentario debe ser el primer elemento del archivo.
3. Inicie el nombre de archivo con TemporaryGeneratedFile_
4. Finalice el nombre de archivo con .designer.cs, .generated.cs, .g.cs o .g.i.cs.

Los generadores pueden optar por usar la directiva de preprocesador #nullable.

Información sobre contextos y advertencias

Si se habilitan las advertencias y las anotaciones, se controlará cómo el compilador
visualiza los tipos de referencia y la nulabilidad. Cada tipo tiene una de las tres
nulabilidades:

oblivious: todos los tipos de referencia son de tipo oblivious que admiten un valor
NULL cuando el contexto de anotación de deshabilita.
nonnullable: tipo de referencia no anotado; C es nonnullable cuando el contexto
de anotación se habilite.
nullable: tipo de referencia anotado; C? es de tipo nullable, pero puede que se
genere una advertencia cuando el contexto de anotación se deshabilite. Las
variables declaradas con var son de tipo nullable cuando el contexto de anotación
se habilita.

El compilador genera advertencias en función de esa nulabilidad:

Los tipos nonnullable generan advertencias si se les asigna un valor null

potencial.
Los tipos nullable generan advertencias si se desreferencian en el caso maybe-null.
Los tipos oblivious generan advertencias si se desreferencian en el caso maybe-null
y el contexto de advertencia está habilitado.

Cada variable tiene un estado predeterminado que admite un valor NULL que depende
de su nulabilidad:
 Las variables que admiten un valor NULL tienen un estado predeterminado null-
state de maybe-null.
Las variables que no admiten un valor NULL tienen un estado predeterminado
null-state de not-null.
Las variables de tipo "oblivious" que admiten un valor NULL tienen un estado
predeterminado null-state de not-null.

Antes de habilitar los tipos de referencia que aceptan valores NULL, todas las
declaraciones del código base son de tipo nullable oblivious. Esto es importante porque
significa que todos los tipos de referencia tienen in estado predeterminado null-state de
not-null.

Resolución de advertencias
Si su proyecto usa Entity Framework Core, debe leer sus guías sobre cómo trabajar con
tipos de referencia que admiten un valor NULL.

Al iniciar la migración, debe empezar habilitando solo las advertencias. Todas las
declaraciones siguen siendo de tipo nullable oblivious, pero se le mostrarán advertencias
cuando desreferencie un valor después de que su estado null-state cambie a maybe-
null. A medida que se resuelvan estas advertencias, realizará comprobaciones de NULL
en más ubicaciones, y su código base será más resistente. Para obtener información
sobre técnicas específicas para diferentes situaciones, vea el artículo sobre Técnicas para
resolver advertencias que admiten un valor NULL.

Puede resolver advertencias y habilitar anotaciones en cada archivo o clase antes de

continuar con otro código. Sin embargo, a menudo resulta más eficaz resolver las
advertencias generadas mientras el contexto es warnings para poder habilitar las
anotaciones de tipo. De esta forma, todos los tipos serán oblivious hasta que haya
resuelto el primer conjunto de advertencias.

Habilitación de anotaciones de tipo

Después de resolver el primer conjunto de advertencias, podrá habilitar el contexto de
anotación. Así, se cambiarán los tipos de referencia de oblivious a nonnullable. Todas las
variables declaradas con var son de tipo nullable. Con este cambio se suelen generar
nuevas advertencias. El primer paso para resolver las advertencias del compilador es
usar anotaciones ? en los tipos de parámetros y de valores devueltos para indicar si los
argumentos o los valores devueltos pueden ser null . A medida que realiza esta tarea,
su objetivo no es solo resolver las advertencias; el objetivo más importante es hacer que
el compilador entienda su intención de admitir posibles valores NULL.
Atributos para complementar a las anotaciones
de tipo
Se han agregado varios atributos para expresar información adicional sobre el estado
NULL de las variables. Es probable que las reglas de sus API sean más complicadas que
not-null o maybe-null para todos los parámetros y valores devueltos. Muchas de las API
tienen reglas más complejas para cuando las variables pueden ser null o no. En estos
casos, usará atributos para expresar dichas reglas. Los atributos que describen la
semántica de su API se encuentran en el artículo sobre los Atributos que afectan a los
análisis que admiten un valor NULL.

Pasos siguientes
Una vez que haya resuelto todas las advertencias después de habilitar las anotaciones,
podrá establecer el contexto predeterminado para su proyecto en enabled. Si ha
agregado alguna pragma a su código para la anotación que admite un valor NULL o el
contexto de advertencia, la podrá eliminar. Con el tiempo, es posible que se le muestren
nuevas advertencias. Puede escribir código que introduzca advertencias. Una
dependencia de biblioteca se puede actualizar para los tipos de referencia que aceptan
valores NULL. Esas actualizaciones cambiarán los tipos de esa biblioteca de nullable
oblivious a nonnullable o nullable.

También puede explorar estos conceptos en nuestro módulo de aprendizaje sobre

Seguridad sobre la aceptación de valores NULL en C#.
Resolución de advertencias sobre los
valores NULL
Artículo • 16/11/2022 • Tiempo de lectura: 21 minutos

En este artículo se tratan las siguientes advertencias del compilador:

CS8602 - Desreferencia de una referencia posiblemente nula.

CS8670 - Inicializador de objeto o colección desreferencia implícitamente miembros
posiblemente NULL.
CS8601 - Posible asignación de referencia nula.
CS8605 - Desboxing a un valor posiblemente NULL.
CS8603 - Posible devolución de referencia nula.
CS8604 - Posible argumento de referencia null para el parámetro .
CS8600 - Convertir un literal nulo o un posible valor NULL en un tipo que no acepta
valores NULL.
CS8597 - El valor producido puede ser NULL.
CS8625 - No se puede convertir un literal nulo en un tipo de referencia que no
acepta valores NULL.
CS8629 - El tipo de valor que acepta valores NULL puede ser NULL.
CS8618 - La variable que no acepta valores NULL debe contener un valor distinto de
NULL al salir del constructor. Considere la posibilidad de declararlo como que acepta
valores NULL.
CS8762 - El parámetro debe tener un valor distinto de NULL al salir.
CS8619 - La nulabilidad de los tipos de referencia en value no coincide con el tipo de
destino.
CS8621 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el delegado de destino (posiblemente debido a atributos de nulabilidad).
CS8622 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el delegado de destino (posiblemente debido a atributos de nulabilidad).
CS8631 - El tipo no se puede usar como parámetro de tipo en el tipo o método
genéricos. La nulabilidad del argumento de tipo no coincide con el tipo de restricción.
CS8634 - El tipo no se puede usar como parámetro de tipo en el tipo o método
genéricos. La nulabilidad del argumento de tipo no coincide con la restricción 'class'.
CS8714 - El tipo no se puede usar como parámetro de tipo en el tipo o método
genéricos. La nulabilidad del argumento de tipo no coincide con la restricción
'notnull'.
CS8608 - La nulabilidad de los tipos de referencia en el tipo no coincide con el
miembro invalidado.
CS8609 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro invalidado.
CS8819 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con la declaración de método parcial.
CS8610 - La nulabilidad de los tipos de referencia en el parámetro de tipo no
coincide con el miembro invalidado.
CS8611 - La nulabilidad de los tipos de referencia en el parámetro de tipo no
coincide con la declaración de método parcial.
CS8612 - La nulabilidad de los tipos de referencia en el tipo no coincide con el
miembro implementado implícitamente.
CS8613 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro implementado implícitamente.
CS8614 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el miembro implementado implícitamente.
CS8615 - La nulabilidad de los tipos de referencia en el tipo no coincide con el
miembro implementado.
CS8616 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro implementado.
CS8617 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el miembro implementado.
CS8633 - La nulabilidad en las restricciones para el parámetro de tipo del método
no coincide con las restricciones del parámetro de tipo del método de interfaz.
Considere la posibilidad de usar una implementación de interfaz explícita en su
lugar.
CS8643 - La nulabilidad de los tipos de referencia en el especificador de interfaz
explícito no coincide con la interfaz implementada por el tipo.
CS8644 - El tipo no implementa el miembro de interfaz. La nulabilidad de los tipos
de referencia en la interfaz implementada por el tipo base no coincide.
CS8620 - No se puede usar el argumento para el parámetro debido a diferencias en
la nulabilidad de los tipos de referencia.
CS8624 - El argumento no se puede usar como salida debido a diferencias en la
nulabilidad de los tipos de referencia.
CS8645 - El miembro ya aparece en la lista de interfaz en el tipo con una
nulabilidad diferente de los tipos de referencia.
CS8667 - Las declaraciones de método parcial tienen nulabilidad incoherente en las
restricciones para el parámetro de tipo.
CS8764 - La nulabilidad del tipo de valor devuelto no coincide con el miembro
invalidado (posiblemente debido a atributos de nulabilidad).
CS8765 - La nulabilidad del tipo de parámetro no coincide con el miembro
invalidado (posiblemente debido a atributos de nulabilidad).
 CS8768 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro implementado (posiblemente debido a atributos de
nulabilidad).
CS8767 - La nulabilidad de los tipos de referencia en el tipo de parámetro de no
coincide con el miembro implementado implícitamente (posiblemente debido a los
atributos de nulabilidad).
CS8766 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto de no
coincide con el miembro implementado implícitamente (posiblemente debido a
atributos de nulabilidad).
CS8769 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el miembro implementado (posiblemente debido a atributos de
nulabilidad).
CS8607 - Es posible que no se use un valor NULL posible para un tipo marcado con
[NotNull] o [DisallowNull]
CS8763 - Un método marcado [DoesNotReturn] no debe devolverse.
CS8770 - El método carece de [DoesNotReturn] anotación para que coincida con el
miembro implementado o invalidado.
CS8774 - El miembro debe tener un valor distinto de NULL al salir.
CS8776 - El miembro no se puede usar en este atributo.
CS8775 - El miembro debe tener un valor distinto de NULL al salir.
CS87777 - El parámetro debe tener un valor distinto de NULL al salir.
CS8824 - El parámetro debe tener un valor distinto de NULL al salir porque el
parámetro no es NULL.
CS8825 - El valor devuelto debe ser distinto de NULL porque el parámetro no es
NULL.
CS8655 - La expresión switch no controla algunas entradas nulas (no es exhaustiva).
CS8847 - La expresión switch no controla algunas entradas nulas (no es exhaustiva).
Sin embargo, un patrón con una cláusula "when" podría coincidir correctamente con
este valor.

El propósito de las advertencias que aceptan valores NULL es minimizar la posibilidad

de que la aplicación produzca una System.NullReferenceException excepción cuando se
ejecute. Para lograr este objetivo, el compilador usa análisis estáticos y emite
advertencias cuando el código tiene construcciones que pueden provocar excepciones
de referencias nulas. Para proporcionar al compilador información sobre su análisis
estático, aplique anotaciones y atributos de tipo. Estas anotaciones y atributos describen
la nulabilidad de argumentos, parámetros y miembros de los tipos. En este artículo,
aprenderá diferentes técnicas para solucionar las advertencias sobre los valores NULL
que el compilador genera a partir de su análisis estático. Las técnicas que se describen
aquí son para código de C# en general. Aprenda a trabajar con tipos de referencia que
aceptan valores NULL y con Entity Framework Core en Trabajar con tipos de referencia
que aceptan valores NULL.

Solucionará casi todas las advertencias usando una de estas cuatro técnicas:

Agregar las comprobaciones necesarias sobre los valores NULL.

Agregar las anotaciones ? o ! , que aceptan valores NULL.
Agregar atributos que describen la semántica NULL.
Inicializar las variables correctamente.

Posible desreferencia de los valores NULL

Este conjunto de advertencias le avisa de que va a desreferenciar una variable cuyo
estado null es maybe-null. Estas advertencias son:

CS8602 - Desreferencia de una referencia posiblemente nula.

CS8670 - Inicializador de objeto o colección desreferencia implícitamente miembros
posiblemente NULL.

En el código siguiente se muestra un ejemplo de cada una de las advertencias

anteriores:

C#

class Container

public List<string>? States { get; set; }

internal void PossibleDereferenceNullExamples(string? message)

Console.WriteLine(message.Length); // CS8602

var c = new Container { States = { "Red", "Yellow", "Green" } }; //

CS8670

En el ejemplo anterior, la advertencia es porque Container , c puede tener un valor NULL

para la States propiedad . La asignación de nuevos estados a una colección que podría
ser NULL provoca la advertencia.

Para quitar estas advertencias, debe agregar código para cambiar el null-state de esa
variable a not-null (no es NULL) antes de desreferenciarla. La advertencia del
inicializador de colección puede ser más difícil de detectar. El compilador detecta que la
colección maybe-null cuando el inicializador le agrega elementos.
En muchos casos, puede corregir estas advertencias comprobando que una variable no
es NULL antes de desreferenciarla. Precisamente, el ejemplo anterior se podría reescribir
como:

C#

void WriteMessageLength(string? message)

if (message is not null)

Console.WriteLine(message.Length);

En algunos casos, estas advertencias pueden ser falsos positivos. Es posible que tenga
un método de utilidad privada que haga pruebas sobre los valores NULL. El compilador
no sabe que el método proporciona una comprobación de valores NULL. Fíjese en este
ejemplo, que usa un método de utilidad privada, IsNotNull :

C#

public void WriteMessage(string? message)

if (IsNotNull(message))

Console.WriteLine(message.Length);

El compilador advierte de que puede estar desreferenciando un valor NULL cuando se

escribe la propiedad message.Length , porque su análisis estático determina que message
puede ser null . Es posible que sepa que IsNotNull proporciona una comprobación de
valores NULL y, cuando devuelve true , el null-state de message debe ser not-null. Debe
indicar esos datos al compilador. Una forma de hacerlo es usando el operador que
permite valores NULL, ! . Puede cambiar la instrucción WriteLine para que coincida con
el código siguiente:

C#

Console.WriteLine(message!.Length);

El operador que permite valores NULL hace que la expresión sea not-null incluso si era
maybe-null antes de aplicar ! . En este ejemplo, una solución mejor es agregar un
atributo a la firma de IsNotNull :

C#
 private static bool IsNotNull([NotNullWhen(true)] object? obj) => obj !=
null;

System.Diagnostics.CodeAnalysis.NotNullWhenAttribute informa al compilador de que

el argumento utilizado para el parámetro obj es not-null cuando el método devuelve
true . Cuando el método devuelve false , el argumento tiene el mismo null-state que

tenía antes de la llamada al método.

 Sugerencia

Hay un amplio conjunto de atributos que puede usar para describir cómo afectan
los métodos y propiedades al null-state. Puede obtener información sobre ellos en
el artículo de referencia del lenguaje sobre Atributos de análisis estático que
aceptan valores NULL.

La corrección de una advertencia para desreferenciar una variable maybe-null implica

una de estas tres técnicas:

Agregar una comprobación de valores NULL que falte.

Agregar atributos de análisis de valores NULL en las API para afectar al análisis
estático de null-state del compilador. Estos atributos informan al compilador sobre
si un valor devuelto o un argumento debe ser maybe-null o not-null después de
llamar al método.
Aplicar el operador ! , que permite valores NULL, a la expresión para forzar que el
estado sea not-null.

Posible valor NULL asignado a una referencia

que no acepta valores NULL
Este conjunto de advertencias le avisa de que va a asignar una variable cuyo tipo no es
null a una expresión cuyo estado null es tal vez null. Estas advertencias son:

CS8601 - Posible asignación de referencia nula.

CS8605 - Desboxing a un valor posiblemente NULL.
CS8603 - Posible devolución de referencia nula.
CS8604 - Posible argumento de referencia null para el parámetro .
CS8600 - Convertir un literal nulo o un posible valor NULL en un tipo que no acepta
valores NULL.
CS8597 - El valor producido puede ser NULL.
 CS8625 - No se puede convertir un literal nulo en un tipo de referencia que no
acepta valores NULL.
CS8629 - El tipo de valor que acepta valores NULL puede ser NULL.

El compilador emite estas advertencias al intentar asignar una expresión maybe-null a

una variable que no acepta valores NULL. Por ejemplo:

C#

string? TryGetMessage(int id) => "";

string msg = TryGetMessage(42); // Possible null assignment.

Las distintas advertencias indican detalles sobre el código, como la asignación, la

asignación unboxing, las instrucciones return, los argumentos para los métodos y las
expresiones throw.

Puede realizar una de estas tres acciones para solucionar estas advertencias. Una opción
es agregar la anotación ? para convertir la variable en un tipo de referencia que acepta
valores NULL. Ese cambio puede provocar otras advertencias. Cambiar una variable de
una referencia que no acepta valores NULL a una que sí los acepta cambia su null-state
predeterminado de not-null a maybe-null. El análisis estático del compilador puede
encontrar instancias en las que se desreferencia una variable que es maybe-null.

El resto de acciones indican al compilador que el lado derecho de la asignación es not-

null. La expresión del lado derecho podría comprobarse en null antes de la asignación,
como se muestra en el ejemplo siguiente:

C#

string notNullMsg = TryGetMessage(42) ?? "Unknown message id: 42";

En los ejemplos anteriores se muestra la asignación del valor devuelto de un método.

Puede anotar el método (o la propiedad) para indicar las situaciones en las que un
método devuelve un valor not-null.
System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute a menudo especifica que un
valor devuelto es not-null cuando un argumento de entrada es not-null. Otra alternativa
es agregar el operador que permite valores NULL, ! , en el lado derecho:

C#

string msg = TryGetMessage(42)!;

La corrección de una advertencia para asignar una expresión maybe-null a una variable
not-null implica una de estas cuatro técnicas:

Cambiar el lado izquierdo de la asignación a un tipo que acepte valores NULL. Esta
acción puede introducir nuevas advertencias al desreferenciar esa variable.
Proporcionar una comprobación de valores NULL antes de la asignación.
Anotar la API que genera el lado derecho de la asignación.
Agregar el operador que permite valores NULL al lado derecho de la asignación.

Referencia que no acepta valores NULL no

inicializada
Este conjunto de advertencias le alerta de que va a asignar una variable cuyo tipo no
acepta valores NULL a una expresión cuyo estado null es maybe-null. Estas advertencias
son:

CS8618 - La variable que no acepta valores NULL debe contener un valor distinto de
NULL al salir del constructor. Considere la posibilidad de declararlo como que acepta
valores NULL.
CS8762 - El parámetro debe tener un valor distinto de NULL al salir.

Fíjese en la clase siguiente a modo de ejemplo:

C#

public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

No se garantiza la inicialización de FirstName ni de LastName . Si este código es nuevo,

considere la posibilidad de cambiar la interfaz pública. El ejemplo anterior podría
actualizarse de la siguiente manera:

C#

public class Person

public Person(string first, string last)

FirstName = first;

LastName = last;

 public string FirstName { get; set; }

public string LastName { get; set; }

Si necesita crear un objeto Person antes de establecer el nombre, puede inicializar las
propiedades mediante un valor no NULL predeterminado:

C#

public class Person

public string FirstName { get; set; } = string.Empty;

public string LastName { get; set; } = string.Empty;

Otra alternativa puede ser cambiar esos miembros a tipos de referencia que aceptan
valores NULL. La clase Person se puede definir de la siguiente manera si null debe
permitirse para el nombre:

C#

public class Person

public string? FirstName { get; set; }

public string? LastName { get; set; }

El código existente puede necesitar otros cambios para informar al compilador sobre la
semántica NULL de esos miembros. Es posible que haya creado varios constructores y
que la clase tenga un método auxiliar privado que inicialice uno o varios miembros.
Puede mover el código de inicialización a un único constructor y asegurarse de que
todos los constructores llaman al que tiene el código de inicialización común. O puede
usar los atributos System.Diagnostics.CodeAnalysis.MemberNotNullAttribute y
System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute. Estos atributos
informan al compilador de que un miembro es not-null después de que se llame al
método. En el código siguiente se muestra un ejemplo de cada caso. La clase Person
usa un constructor común al que llaman todos los demás constructores. La clase
Student tiene un método auxiliar anotado con el atributo
System.Diagnostics.CodeAnalysis.MemberNotNullAttribute:

C#

using System.Diagnostics.CodeAnalysis;

 public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

public Person(string firstName, string lastName)

FirstName = firstName;

LastName = lastName;

public Person() : this("John", "Doe") { }

public class Student : Person

public string Major { get; set; }

public Student(string firstName, string lastName, string major)

: base(firstName, lastName)

SetMajor(major);

public Student(string firstName, string lastName) :

base(firstName, lastName)

SetMajor();

public Student()

SetMajor();

[MemberNotNull(nameof(Major))]

private void SetMajor(string? major = default)

Major = major ?? "Undeclared";

Por último, puede usar el operador que permite valores NULL para indicar que un
miembro se inicializa en otro código. Por dar otro ejemplo, fíjese en las siguientes clases
que representan un modelo de Entity Framework Core:

C#

public class TodoItem

public long Id { get; set; }

public string? Name { get; set; }

public bool IsComplete { get; set; }

public class TodoContext : DbContext

public TodoContext(DbContextOptions<TodoContext> options)

: base(options)
{

public DbSet<TodoItem> TodoItems { get; set; } = null!;

La propiedad DbSet se inicializa en null! . Esto indica al compilador que la propiedad

está establecida en un valor not-null. De hecho, la base DbContext realiza la inicialización
del conjunto. El análisis estático del compilador no lo capta. Para más información sobre
cómo trabajar con tipos de referencia que aceptan valores NULL y Entity Framework
Core, consulte el artículo Cómo trabajar con tipos de referencia que aceptan valores
NULL en EF Core.

La corrección de una advertencia de que no se ha inicializado un miembro que no

acepta valores NULL implica una de estas cuatro técnicas:

Cambiar los constructores o inicializadores de campo para asegurarse de que se

inicializan todos los miembros que no aceptan valores NULL.
Cambiar uno o varios miembros para que sean tipos que aceptan valores NULL.
Anotar los métodos auxiliares para indicar qué miembros están asignados.
Agregar un inicializador a null! para indicar que el miembro se inicializa en otro
código.

Error de coincidencia en la declaración de

nulabilidad
Muchas advertencias indican discrepancias de nulabilidad entre firmas para métodos,
delegados o parámetros de tipo.

CS8619 - La nulabilidad de los tipos de referencia en value no coincide con el tipo de

destino.
CS8621 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el delegado de destino (posiblemente debido a atributos de nulabilidad).
CS8622 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el delegado de destino (posiblemente debido a atributos de nulabilidad).
CS8631 - El tipo no se puede usar como parámetro de tipo en el tipo o método
genéricos. La nulabilidad del argumento de tipo no coincide con el tipo de restricción.
CS8634 - El tipo no se puede usar como parámetro de tipo en el tipo o método
genéricos. La nulabilidad del argumento de tipo no coincide con la restricción 'class'.
CS8714 - El tipo no se puede usar como parámetro de tipo en el tipo o método
genéricos. La nulabilidad del argumento de tipo no coincide con la restricción
'notnull'.
CS8608 - La nulabilidad de los tipos de referencia en el tipo no coincide con el
miembro invalidado.
CS8609 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro invalidado.
CS8819 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con la declaración de método parcial.
CS8610 - La nulabilidad de los tipos de referencia en el parámetro de tipo no
coincide con el miembro invalidado.
CS8611 - La nulabilidad de los tipos de referencia en el parámetro de tipo no
coincide con la declaración de método parcial.
CS8612 - La nulabilidad de los tipos de referencia en el tipo no coincide con el
miembro implementado implícitamente.
CS8613 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro implementado implícitamente.
CS8614 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el miembro implementado implícitamente.
CS8615 - La nulabilidad de los tipos de referencia en el tipo no coincide con el
miembro implementado.
CS8616 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro implementado.
CS8617 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el miembro implementado.
CS8633 - La nulabilidad en las restricciones para el parámetro de tipo del método
no coincide con las restricciones del parámetro de tipo del método de interfaz.
Considere la posibilidad de usar una implementación de interfaz explícita en su
lugar.
CS8643 - La nulabilidad de los tipos de referencia en el especificador de interfaz
explícito no coincide con la interfaz implementada por el tipo.
CS8644 - El tipo no implementa el miembro de interfaz. La nulabilidad de los tipos
de referencia en la interfaz implementada por el tipo base no coincide.
CS8620 - No se puede usar el argumento para el parámetro debido a diferencias en
la nulabilidad de los tipos de referencia.
CS8624 - El argumento no se puede usar como salida debido a diferencias en la
nulabilidad de los tipos de referencia.
 CS8645 - El miembro ya aparece en la lista de interfaz en el tipo con una
nulabilidad diferente de los tipos de referencia.
CS8667 - Las declaraciones de método parcial tienen nulabilidad incoherente en las
restricciones para el parámetro de tipo.
CS8764 - La nulabilidad del tipo de valor devuelto no coincide con el miembro
invalidado (posiblemente debido a atributos de nulabilidad).
CS8765 - La nulabilidad del tipo de parámetro no coincide con el miembro
invalidado (posiblemente debido a atributos de nulabilidad).
CS8768 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto no
coincide con el miembro implementado (posiblemente debido a atributos de
nulabilidad).
CS8767 - La nulabilidad de los tipos de referencia en el tipo de parámetro de no
coincide con el miembro implementado implícitamente (posiblemente debido a los
atributos de nulabilidad).
CS8766 - La nulabilidad de los tipos de referencia en el tipo de valor devuelto de no
coincide con el miembro implementado implícitamente (posiblemente debido a
atributos de nulabilidad).
CS8769 - La nulabilidad de los tipos de referencia en el tipo de parámetro no
coincide con el miembro implementado (posiblemente debido a atributos de
nulabilidad).

El código siguiente muestra la advertencia CS8764:

C#

public class B

public virtual string GetMessage(string id) => string.Empty;

public class D : B

public override string? GetMessage(string? id) => default;

En el ejemplo anterior se muestra un método virtual en una clase base y un override

con una nulabilidad diferente. La clase base devuelve una cadena que no acepta valores
NULL, pero la clase derivada devuelve una cadena que sí los acepta. Si string y string?
se invierten, se permitirá porque la clase derivada es más restrictiva. De forma similar, las
declaraciones de parámetros deben coincidir. Los parámetros del método de
invalidación pueden permitir valores NULL incluso cuando la clase base no los permite.

Otras situaciones pueden generar estas advertencias. Es posible que tenga un error de
coincidencia entre una declaración del método de interfaz y la implementación de ese
método. O bien, un tipo de delegado y la expresión de ese delegado pueden diferir. Un
parámetro de tipo y el argumento de tipo pueden diferir en su nulabilidad.

Para corregir estas advertencias, actualice la declaración adecuada.

El código no coincide con la declaración de

atributo
En las secciones anteriores se ha explicado cómo puede usar Atributos para el análisis
estático que acepta valores NULL para informar al compilador sobre la semántica NULL
del código. El compilador le advierte si el código no cumple las promesas de ese
atributo:

CS8607 - Es posible que no se use un valor NULL posible para un tipo marcado con
[NotNull] o [DisallowNull]
CS8763 - Un método marcado [DoesNotReturn] no debe devolverse.
CS8770 - El método carece de [DoesNotReturn] anotación para que coincida con el
miembro implementado o invalidado.
CS8774 - El miembro debe tener un valor distinto de NULL al salir.
CS8776 - El miembro no se puede usar en este atributo.
CS8775 - El miembro debe tener un valor distinto de NULL al salir.
CS87777 - El parámetro debe tener un valor distinto de NULL al salir.
CS8824 - El parámetro debe tener un valor distinto de NULL al salir porque el
parámetro no es NULL.
CS8825 - El valor devuelto debe ser distinto de NULL porque el parámetro no es
NULL.

Observe el método siguiente:

C#

public bool TryGetMessage(int id, [NotNullWhen(true)] out string? message)

message = null;

return true;

El compilador genera una advertencia porque se asigna el parámetro message null y el

método devuelve true . El atributo NotNullWhen indica que eso no debe ocurrir.

Para solucionar estas advertencias, actualice el código para que coincida con las
expectativas de los atributos que ha aplicado. Puede cambiar los atributos o el
algoritmo.

Expresión de modificador exhaustiva

Las expresiones switch deben ser exhaustivas, lo que significa que se deben controlar
todos los valores de entrada. Incluso para los tipos de referencia que no aceptan valores
NULL, se debe tener en cuenta el null valor. El compilador emite advertencias cuando
no se controla el valor NULL:

CS8655 - La expresión switch no controla algunas entradas nulas (no es exhaustiva).

CS8847 - La expresión switch no controla algunas entradas nulas (no es exhaustiva).
Sin embargo, un patrón con una cláusula "when" podría coincidir correctamente con
este valor.

El código de ejemplo siguiente muestra esta condición:

C#

int AsScale(string status) =>

status switch

"Red" => 0,

"Yellow" => 5,

"Green" => 10,

{ } => -1

};

La expresión de entrada es , string no . string? El compilador sigue generando esta

advertencia. El { } patrón controla todos los valores no NULL, pero no coincide con
null . Para solucionar estos errores, puede agregar un caso explícito null o reemplazar

por { } el _ patrón (descartar). El patrón de descarte coincide con null, así como con
cualquier otro valor.
Métodos de C#
Artículo • 14/02/2023 • Tiempo de lectura: 23 minutos

Un método es un bloque de código que contiene una serie de instrucciones. Un

programa hace que se ejecuten las instrucciones al llamar al método y especificando los
argumentos de método necesarios. En C#, todas las instrucciones ejecutadas se realizan
en el contexto de un método. El método Main es el punto de entrada para cada
aplicación de C# y se llama mediante Common Language Runtime (CLR) cuando se
inicia el programa.

７ Nota

En este tema se analizan los métodos denominados. Para obtener información

sobre las funciones anónimas, consulte Expresiones lambda.

Firmas de método
Los métodos se declaran en un elemento class , record o struct al especificar lo
siguiente:

Un nivel de acceso opcional, como, por ejemplo, public o private . De manera

predeterminada, es private .
Modificadores opcionales, como, por ejemplo, abstract o sealed .
El valor devuelto o, si el método no tiene ninguno, void .
El nombre del método.
Los parámetros del método. Los parámetros de método se encierran entre
paréntesis y se separan por comas. Los paréntesis vacíos indican que el método no
requiere parámetros.

Todas estas partes forman la firma del método.

） Importante

Un tipo de valor devuelto de un método no forma parte de la firma del método

con el objetivo de sobrecargar el método. Sin embargo, forma parte de la firma del
método al determinar la compatibilidad entre un delegado y el método que señala.

En el siguiente ejemplo se define una clase denominada Motorcycle que contiene cinco
métodos:
 C#

using System;

abstract class Motorcycle

// Anyone can call this.

public void StartEngine() {/* Method statements here */ }

// Only derived classes can call this.

protected void AddGas(int gallons) { /* Method statements here */ }

// Derived classes can override the base class implementation.

public virtual int Drive(int miles, int speed) { /* Method statements
here */ return 1; }

// Derived classes can override the base class implementation.

public virtual int Drive(TimeSpan time, int speed) { /* Method
statements here */ return 0; }

// Derived classes must implement this.

public abstract double GetTopSpeed();

Tenga en cuenta que la clase Motorcycle incluye un método sobrecargado, Drive . Dos
métodos tienen el mismo nombre, pero se deben diferenciar en sus tipos de
parámetros.

Invocación de método
Los métodos pueden ser de instancia o estáticos. Para invocar un método de instancia es
necesario crear una instancia de un objeto y llamar al método del objeto; el método de
una instancia actúa en dicha instancia y sus datos. Si quiere invocar un método estático,
haga referencia al nombre del tipo al que pertenece el método; los métodos estáticos
no actúan en datos de instancia. Al intentar llamar a un método estático mediante una
instancia de objeto se genera un error del compilador.

Llamar a un método es como acceder a un campo. Después del nombre de objeto (si
llama a un método de instancia) o el nombre de tipo (si llama a un método static ),
agregue un punto, el nombre del método y paréntesis. Los argumentos se enumeran
entre paréntesis y se separan mediante comas.

La definición del método especifica los nombres y tipos de todos los parámetros
necesarios. Cuando un autor de llamada invoca el método, proporciona valores
concretos denominados argumentos para cada parámetro. Los argumentos deben ser
compatibles con el tipo de parámetro, pero el nombre de argumento, si se usa alguno
en el código de llamada, no tiene que ser el mismo que el del parámetro con nombre
definido en el método. En el ejemplo siguiente, el método Square incluye un parámetro
único de tipo int denominado i. La primera llamada de método pasa al método Square
una variable de tipo int denominada num; la segunda, una constante numérica; y la
tercera, una expresión.

C#

public class SquareExample

public static void Main()

// Call with an int variable.

int num = 4;

int productA = Square(num);

// Call with an integer literal.

int productB = Square(12);

// Call with an expression that evaluates to int.

int productC = Square(productA * 3);

static int Square(int i)

// Store input argument in a local variable.

int input = i;

return input * input;

La forma más común de invocación de método usa argumentos posicionales;

proporciona argumentos en el mismo orden que los parámetros de método. Los
métodos de la clase Motorcycle se pueden llamar como en el ejemplo siguiente. Por
ejemplo, la llamada al método Drive incluye dos argumentos que se corresponden con
los dos parámetros de la sintaxis del método. El primero se convierte en el valor del
parámetro miles y el segundo en el valor del parámetro speed .

C#

class TestMotorcycle : Motorcycle

public override double GetTopSpeed()

return 108.4;

static void Main()

 TestMotorcycle moto = new TestMotorcycle();

moto.StartEngine();

moto.AddGas(15);

moto.Drive(5, 20);

double speed = moto.GetTopSpeed();

Console.WriteLine("My top speed is {0}", speed);

También se pueden usar argumentos con nombre en lugar de argumentos posicionales

al invocar un método. Cuando se usan argumentos con nombre, el nombre del
parámetro se especifica seguido de dos puntos (":") y el argumento. Los argumentos del
método pueden aparecer en cualquier orden, siempre que todos los argumentos
necesarios están presentes. En el ejemplo siguiente se usan argumentos con nombre
para invocar el método TestMotorcycle.Drive . En este ejemplo, los argumentos con
nombre se pasan en orden inverso desde la lista de parámetros del método.

C#

using System;

class TestMotorcycle : Motorcycle

public override int Drive(int miles, int speed)

return (int)Math.Round(((double)miles) / speed, 0);

public override double GetTopSpeed()

return 108.4;

static void Main()

TestMotorcycle moto = new TestMotorcycle();

moto.StartEngine();

moto.AddGas(15);

var travelTime = moto.Drive(speed: 60, miles: 170);

Console.WriteLine("Travel time: approx. {0} hours", travelTime);

// The example displays the following output:

// Travel time: approx. 3 hours

Un método se puede invocar con argumentos posicionales y argumentos con nombre.

Pero los argumentos con nombre solo pueden ir detrás de argumentos posicionales si
están en la posición correcta. En el ejemplo siguiente se invoca el método
TestMotorcycle.Drive del ejemplo anterior con un argumento posicional y un
argumento con nombre.

C#

var travelTime = moto.Drive(170, speed: 55);

Métodos heredados e invalidados

Además de los miembros que se definen explícitamente en un tipo, un tipo hereda
miembros definidos en sus clases base. Dado que todos los tipos en el sistema de tipo
administrado heredan directa o indirectamente de la clase Object, todos los tipos
heredan sus miembros, como Equals(Object), GetType() y ToString(). En el ejemplo
siguiente se define una clase Person , se crean instancias de dos objetos Person y se
llama al método Person.Equals para determinar si los dos objetos son iguales. El
método Equals , sin embargo, no se define en la clase Person ; se hereda de Object.

C#

using System;

public class Person

public String FirstName;

public class ClassTypeExample

public static void Main()

var p1 = new Person();

p1.FirstName = "John";

var p2 = new Person();

p2.FirstName = "John";

Console.WriteLine("p1 = p2: {0}", p1.Equals(p2));

// The example displays the following output:

// p1 = p2: False

Los tipos pueden invalidar miembros heredados usando la palabra clave override y
proporcionando una implementación para el método invalidado. La firma del método
debe ser igual a la del método invalidado. El ejemplo siguiente es similar al anterior,
salvo que invalida el método Equals(Object). (También invalida el método
GetHashCode(), ya que los dos métodos están diseñados para proporcionar resultados
coherentes).

C#

using System;

public class Person

public String FirstName;

public override bool Equals(object obj)

var p2 = obj as Person;

if (p2 == null)

return false;

else

return FirstName.Equals(p2.FirstName);

public override int GetHashCode()

return FirstName.GetHashCode();

public class Example

public static void Main()

var p1 = new Person();

p1.FirstName = "John";

var p2 = new Person();

p2.FirstName = "John";

Console.WriteLine("p1 = p2: {0}", p1.Equals(p2));

// The example displays the following output:

// p1 = p2: True

Pasar parámetros
Todos los tipos de C# son tipos de valor o tipos de referencia. Para obtener una lista de
tipos de valor integrados, vea Tipos. De forma predeterminada, los tipos de valor y los
tipos de referencia se pasan a un método por valor.

Pasar parámetros por valor

Cuando un tipo de valor se pasa a un método por valor, se pasa una copia del objeto y
no el propio objeto. Por lo tanto, los cambios realizados en el objeto en el método
llamado no tienen ningún efecto en el objeto original cuando el control vuelve al autor
de la llamada.

En el ejemplo siguiente se pasa un tipo de valor a un método por valor, y el método

llamado intenta cambiar el valor del tipo de valor. Define una variable de tipo int , que
es un tipo de valor, inicializa su valor en 20 y lo pasa a un método denominado
ModifyValue que cambia el valor de la variable a 30. Pero cuando el método vuelve, el

valor de la variable no cambia.

C#

using System;

public class ByValueExample

public static void Main()

int value = 20;

Console.WriteLine("In Main, value = {0}", value);

ModifyValue(value);

Console.WriteLine("Back in Main, value = {0}", value);

static void ModifyValue(int i)

i = 30;

Console.WriteLine("In ModifyValue, parameter value = {0}", i);

return;

// The example displays the following output:

// In Main, value = 20

// In ModifyValue, parameter value = 30

// Back in Main, value = 20

Cuando un objeto de un tipo de referencia se pasa a un método por valor, se pasa por
valor una referencia al objeto. Es decir, el método no recibe el objeto concreto, sino un
argumento que indica la ubicación del objeto. Si cambia un miembro del objeto
mediante esta referencia, el cambio se reflejará en el objeto cuando el control vuelva al
método de llamada. Pero el reemplazo del objeto pasado al método no tendrá ningún
efecto en el objeto original cuando el control vuelva al autor de la llamada.

En el ejemplo siguiente se define una clase (que es un tipo de referencia) denominada

SampleRefType . Crea una instancia de un objeto SampleRefType , asigna 44 a su campo

value y pasa el objeto al método ModifyObject . Fundamentalmente, este ejemplo hace

lo mismo que el ejemplo anterior: pasa un argumento por valor a un método. Pero,
debido a que se usa un tipo de referencia, el resultado es diferente. La modificación que
se lleva a cabo en ModifyObject para el campo obj.value cambia también el campo
value del argumento, rt , en el método Main a 33, tal y como muestra el resultado del
ejemplo.

C#

using System;

public class SampleRefType

public int value;

public class ByRefTypeExample

public static void Main()

var rt = new SampleRefType();

rt.value = 44;

ModifyObject(rt);

Console.WriteLine(rt.value);

static void ModifyObject(SampleRefType obj)

obj.value = 33;
}

Pasar parámetros por referencia

Pase un parámetro por referencia cuando quiera cambiar el valor de un argumento en
un método y reflejar ese cambio cuando el control vuelva al método de llamada. Para
pasar un parámetro por referencia, use las palabras clave ref o out. También puede
pasar un valor por referencia para evitar la copia, pero impedir modificaciones
igualmente usando la palabra clave in.

El ejemplo siguiente es idéntico al anterior, salvo que el valor se pasa por referencia al
método ModifyValue . Cuando se modifica el valor del parámetro en el método
ModifyValue , el cambio del valor se refleja cuando el control vuelve al autor de la
llamada.

C#
 using System;

public class ByRefExample

public static void Main()

int value = 20;

Console.WriteLine("In Main, value = {0}", value);

ModifyValue(ref value);

Console.WriteLine("Back in Main, value = {0}", value);

static void ModifyValue(ref int i)

i = 30;

Console.WriteLine("In ModifyValue, parameter value = {0}", i);

return;

// The example displays the following output:

// In Main, value = 20

// In ModifyValue, parameter value = 30

// Back in Main, value = 30

Un patrón común que se usa en parámetros ref implica intercambiar los valores de
variables. Se pasan dos variables a un método por referencia y el método intercambia su
contenido. En el ejemplo siguiente se intercambian valores enteros.

C#

using System;

public class RefSwapExample

static void Main()

int i = 2, j = 3;

System.Console.WriteLine("i = {0} j = {1}" , i, j);

Swap(ref i, ref j);

System.Console.WriteLine("i = {0} j = {1}" , i, j);

static void Swap(ref int x, ref int y)

int temp = x;

x = y;

y = temp;

// The example displays the following output:

 // i = 2 j = 3

// i = 3 j = 2

Pasar un parámetro de tipo de referencia le permite cambiar el valor de la propia

referencia, en lugar del valor de sus campos o elementos individuales.

Matrices de parámetros
A veces, el requisito de especificar el número exacto de argumentos al método es
restrictivo. El uso de la palabra clave params para indicar que un parámetro es una
matriz de parámetros permite llamar al método con un número variable de argumentos.
El parámetro etiquetado con la palabra clave params debe ser un tipo de matriz y ser el
último parámetro en la lista de parámetros del método.

Un autor de llamada puede luego invocar el método de una de las tres maneras
siguientes:

Si se pasa una matriz del tipo adecuado que contenga el número de elementos
que se quiera.
Si se pasa una lista separada por comas de los argumentos individuales del tipo
adecuado para el método.
Pasando null .
Si no se proporciona un argumento a la matriz de parámetros.

En el ejemplo siguiente se define un método denominado GetVowels que devuelve

todas las vocales de una matriz de parámetros. El método Main muestra las cuatro
formas de invocar el método. Los autores de llamadas no deben proporcionar
argumentos para los parámetros que incluyen el modificador params . En ese caso, el
parámetro es una matriz vacía.

C#

using System;

using System.Linq;

class ParamsExample

static void Main()

string fromArray = GetVowels(new[] { "apple", "banana", "pear" });

Console.WriteLine($"Vowels from array: '{fromArray}'");

string fromMultipleArguments = GetVowels("apple", "banana", "pear");

Console.WriteLine($"Vowels from multiple arguments:

'{fromMultipleArguments}'");

string fromNull = GetVowels(null);

Console.WriteLine($"Vowels from null: '{fromNull}'");

string fromNoValue = GetVowels();

Console.WriteLine($"Vowels from no value: '{fromNoValue}'");

static string GetVowels(params string[] input)

if (input == null || input.Length == 0)

return string.Empty;

var vowels = new char[] { 'A', 'E', 'I', 'O', 'U' };

return string.Concat(

input.SelectMany(

word => word.Where(letter =>

vowels.Contains(char.ToUpper(letter)))));

// The example displays the following output:

// Vowels from array: 'aeaaaea'

// Vowels from multiple arguments: 'aeaaaea'

// Vowels from null: ''

// Vowels from no value: ''

Argumentos y parámetros opcionales

La definición de un método puede especificar que sus parámetros son necesarios o que
son opcionales. Los parámetros son necesarios de forma predeterminada. Para
especificar parámetros opcionales se incluye el valor predeterminado del parámetro en
la definición del método. Cuando se llama al método, si no se proporciona ningún
argumento para un parámetro opcional, se usa el valor predeterminado.

El valor predeterminado del parámetro debe asignarse con uno de los siguientes tipos
de expresiones:

Una constante, como una cadena literal o un número.

Una expresión con el formato default(SomeType) , donde SomeType puede ser un

tipo de valor o un tipo de referencia. Si es un tipo de referencia, es efectivamente
lo mismo que especificar null . Puede usar el literal default , ya que el compilador
puede inferir el tipo de la declaración del parámetro.
 Una expresión con el formato new ValType() , donde ValType es un tipo de valor.
Esta acción invoca el constructor sin parámetros implícito del tipo de valor, que no
es un miembro real del tipo.

７ Nota

En C# 10 y versiones posteriores, cuando una expresión con el formato new

ValType() invoca el constructor sin parámetros definido explícitamente de un

tipo de valor, el compilador genera un error, ya que el valor del parámetro

predeterminado debe ser una constante en tiempo de compilación. Use la
expresión default(ValType) o el literal default para proporcionar el valor de
parámetro predeterminado. Para más información sobre los constructores sin
parámetros, consulte la sección Inicialización de estructuras y valores
predeterminados del artículo Tipos de estructuras.

Si un método incluye parámetros necesarios y opcionales, los parámetros opcionales se

definen al final de la lista de parámetros, después de todos los parámetros necesarios.

En el ejemplo siguiente se define un método, ExampleMethod , que tiene un parámetro

necesario y dos opcionales.

C#

using System;

public class Options

public void ExampleMethod(int required, int optionalInt = default,

string? description = default)

var msg = $"{description ?? "N/A"}: {required} + {optionalInt} =

{required + optionalInt}";

Console.WriteLine(msg);

Si se invoca un método con varios argumentos opcionales mediante argumentos

posicionales, el autor de la llamada debe proporcionar un argumento para todos los
parámetros opcionales, del primero al último, a los que se proporcione un argumento.
Por ejemplo, en el caso del método ExampleMethod , si el autor de la llamada proporciona
un argumento para el parámetro description , también debe proporcionar uno para el
parámetro optionalInt . opt.ExampleMethod(2, 2, "Addition of 2 and 2"); es una
llamada de método válida; opt.ExampleMethod(2, , "Addition of 2 and 0"); genera un
error del compilador, "Falta un argumento".

Si se llama a un método mediante argumentos con nombre o una combinación de

argumentos posicionales y con nombre, el autor de la llamada puede omitir los
argumentos que siguen al último argumento posicional en la llamada al método.

En el ejemplo siguiente se llama tres veces al método ExampleMethod . Las dos primeras
llamadas al método usan argumentos posicionales. La primera omite los dos
argumentos opcionales, mientras que la segunda omite el último argumento. La tercera
llamada de método proporciona un argumento posicional para el parámetro necesario,
pero usa un argumento con nombre para proporcionar un valor al parámetro
description mientras omite el argumento optionalInt .

C#

public class OptionsExample

public static void Main()

var opt = new Options();

opt.ExampleMethod(10);

opt.ExampleMethod(10, 2);

opt.ExampleMethod(12, description: "Addition with zero:");

// The example displays the following output:

// N/A: 10 + 0 = 10

// N/A: 10 + 2 = 12

// Addition with zero:: 12 + 0 = 12

El uso de parámetros opcionales incide en la resolución de sobrecarga o en la manera en

que el compilador de C# determina qué sobrecarga en particular debe invocar una
llamada al método, como sigue:

Un método, indexador o constructor es un candidato para la ejecución si cada uno

de sus parámetros es opcional o corresponde, por nombre o por posición, a un
solo argumento de la instrucción de llamada y el argumento se puede convertir al
tipo del parámetro.
Si se encuentra más de un candidato, se aplican las reglas de resolución de
sobrecarga de las conversiones preferidas a los argumentos que se especifican
explícitamente. Los argumentos omitidos en parámetros opcionales se ignoran.
Si dos candidatos se consideran igualmente correctos, la preferencia pasa a un
candidato que no tenga parámetros opcionales cuyos argumentos se hayan
 omitido en la llamada. Se trata de una consecuencia de una preferencia general en
la resolución de sobrecarga para los candidatos con menos parámetros.

Valores devueltos
Los métodos pueden devolver un valor al autor de llamada. Si el tipo de valor devuelto
(el tipo que aparece antes del nombre de método) no es void , el método puede
devolver el valor mediante la palabra clave return . Una instrucción con la palabra clave
return seguida de una variable, una constante o una expresión que coincide con el tipo

de valor devuelto devolverá este valor al autor de la llamada al método. Los métodos
con un tipo de valor devuelto no nulo son necesarios para usar la palabra clave return
para devolver un valor. La palabra clave return también detiene la ejecución del
método.

Si el tipo de valor devuelto es void , una instrucción return sin un valor también es útil
para detener la ejecución del método. Sin la palabra clave return , el método dejará de
ejecutarse cuando alcance el final del bloque de código.

Por ejemplo, estos dos métodos utilizan la palabra clave return para devolver enteros:

C#

class SimpleMath

public int AddTwoNumbers(int number1, int number2)

return number1 + number2;

public int SquareANumber(int number)

return number * number;

Para utilizar un valor devuelto de un método, el método de llamada puede usar la

llamada de método en cualquier lugar; un valor del mismo tipo sería suficiente. También
puede asignar el valor devuelto a una variable. Por ejemplo, los dos siguientes ejemplos
de código logran el mismo objetivo:

C#

int result = obj.AddTwoNumbers(1, 2);

result = obj.SquareANumber(result);

 // The result is 9.

Console.WriteLine(result);

C#

result = obj.SquareANumber(obj.AddTwoNumbers(1, 2));

// The result is 9.

Console.WriteLine(result);

Usar una variable local, en este caso, result , para almacenar un valor es opcional. La
legibilidad del código puede ser útil, o puede ser necesaria si debe almacenar el valor
original del argumento para todo el ámbito del método.

A veces, quiere que el método devuelva más que un solo valor. Puede hacer esto
fácilmente utilizando tipos de tupla y literales de tupla. El tipo de tupla define los tipos
de datos de los elementos de la tupla. Los literales de tupla proporcionan los valores
reales de la tupla devuelta. En el ejemplo siguiente, (string, string, string, int)
define el tipo de tupla que devuelve el método GetPersonalInfo . La expresión
(per.FirstName, per.MiddleName, per.LastName, per.Age) es el literal de tupla; el
método devuelve el nombre, los apellidos y la edad de un objeto PersonInfo .

C#

public (string, string, string, int) GetPersonalInfo(string id)

PersonInfo per = PersonInfo.RetrieveInfoById(id);

return (per.FirstName, per.MiddleName, per.LastName, per.Age);

}

Luego, el autor de la llamada puede usar la tupla devuelta con código como el
siguiente:

C#

var person = GetPersonalInfo("111111111");

Console.WriteLine($"{person.Item1} {person.Item3}: age = {person.Item4}");

También se pueden asignar nombres a los elementos de tupla en la definición de tipo

de tupla. En el ejemplo siguiente se muestra una versión alternativa del método
GetPersonalInfo que usa elementos con nombre:

C#
 public (string FName, string MName, string LName, int Age)
GetPersonalInfo(string id)

PersonInfo per = PersonInfo.RetrieveInfoById(id);

return (per.FirstName, per.MiddleName, per.LastName, per.Age);

}

La llamada anterior al método GetPersonalInfo se puede modificar luego de la manera

siguiente:

C#

var person = GetPersonalInfo("111111111");

Console.WriteLine($"{person.FName} {person.LName}: age = {person.Age}");

Si se pasa a un método una matriz como argumento y se modifica el valor de elementos

individuales, no es necesario que el método devuelva la matriz, aunque puede que sea
preferible hacerlo para conseguir un buen estilo o el flujo funcional de valores. Esto se
debe a que C# pasa todos los tipos de referencia por valor, y el valor de una referencia a
la matriz es el puntero a la matriz. En el ejemplo siguiente, los cambios al contenido de
la matriz values que se realizan en el método DoubleValues los puede observar
cualquier código que tenga una referencia a la matriz.

C#

using System;

public class ArrayValueExample

static void Main(string[] args)

int[] values = { 2, 4, 6, 8 };
DoubleValues(values);

foreach (var value in values)

Console.Write("{0} ", value);

public static void DoubleValues(int[] arr)

for (int ctr = 0; ctr <= arr.GetUpperBound(0); ctr++)

arr[ctr] = arr[ctr] * 2;

// The example displays the following output:

// 4 8 12 16

Métodos de extensión
Normalmente, hay dos maneras de agregar un método a un tipo existente:

Modificar el código fuente del tipo. Es obvio que no puede hacerlo si no es

propietario del código fuente del tipo. Y esto supone un cambio sustancial si
también agrega los campos de datos privados para admitir el método.
Definir el nuevo método en una clase derivada. No se puede agregar un método
de este modo usando la herencia para otros tipos, como estructuras y
enumeraciones. Tampoco se puede usar para agregar un método a una clase
sealed.

Los métodos de extensión permiten agregar un método a un tipo existente sin

modificar el propio tipo o implementar el nuevo método en un tipo heredado. El
método de extensión tampoco tiene que residir en el mismo ensamblado que el tipo
que extiende. Llame a un método de extensión como si fuera miembro de un tipo
definido.

Para obtener más información, vea Métodos de extensión.

Métodos asincrónicos
Mediante la característica asincrónica, puede invocar métodos asincrónicos sin usar
definiciones de llamada explícitas ni dividir manualmente el código en varios métodos o
expresiones lambda.

Si marca un método con el modificador async, puede usar el operador await en el

método. Cuando el control llega a una expresión await en el método asincrónico, el
control se devuelve al autor de la llamada si la tarea en espera no se ha completado y se
suspende el progreso del método con la palabra clave await hasta que dicha tarea se
complete. Cuando se completa la tarea, la ejecución puede reanudarse en el método.

７ Nota

Un método asincrónico vuelve al autor de la llamada cuando encuentra el primer

objeto esperado que aún no se ha completado o cuando llega al final del método
asincrónico, lo que ocurra primero.

Un método asincrónico normalmente tiene un tipo de valor devuelto de Task<TResult>,

Task, IAsyncEnumerable<T> o void . El tipo de valor devuelto void se usa
principalmente para definir controladores de eventos, donde se requiere un tipo de
valor devuelto void . No se puede esperar un método asincrónico que devuelve void y
el autor de llamada a un método que no devuelve ningún valor no puede capturar
ninguna excepción producida por este. Un método asincrónico puede tener cualquier
tipo de valor devuelto que sea como una tarea.

En el ejemplo siguiente, DelayAsync es un método asincrónico que contiene una

instrucción return que devuelve un entero. Como se trata de un método asincrónico, su
declaración de método debe tener un tipo de valor devuelto de Task<int> . Dado que el
tipo de valor devuelto es Task<int> , la evaluación de la expresión await en
DoSomethingAsync genera un entero, como se demuestra en la instrucción int result =
await delayTask siguiente.

C#

class Program

static Task Main() => DoSomethingAsync();

static async Task DoSomethingAsync()

Task<int> delayTask = DelayAsync();

int result = await delayTask;

// The previous two statements may be combined into

// the following statement.

//int result = await DelayAsync();

Console.WriteLine($"Result: {result}");

static async Task<int> DelayAsync()

await Task.Delay(100);

return 5;

// Example output:

// Result: 5

Un método asincrónico no puede declarar ningún parámetro in, ref o out, pero puede
llamar a los métodos que tienen estos parámetros.

Para obtener más información sobre los métodos asincrónicos, consulte los artículos
Programación asincrónica con async y await y Tipos de valor devueltos asincrónicos.

Miembros con forma de expresión

Es habitual tener definiciones de método que simplemente hacen las devoluciones de
forma inmediata con el resultado de una expresión, o que tienen una sola instrucción
como cuerpo del método. Hay un acceso directo de sintaxis para definir este método
mediante => :

C#

public Point Move(int dx, int dy) => new Point(x + dx, y + dy);

public void Print() => Console.WriteLine(First + " " + Last);

// Works with operators, properties, and indexers too.

public static Complex operator +(Complex a, Complex b) => a.Add(b);

public string Name => First + " " + Last;

public Customer this[long id] => store.LookupCustomer(id);

Si el método devuelve void o se trata de un método asincrónico, el cuerpo del método

debe ser una expresión de instrucción (igual que con las expresiones lambda). En el caso
de las propiedades y los indexadores, solo deben leerse, y no se debe usar la palabra
clave de descriptor de acceso get .

Iterators
Un iterador realiza una iteración personalizada en una colección, como una lista o
matriz. Un iterador utiliza la instrucción yield return para devolver cada elemento de uno
en uno. Cuando se llega a una instrucción yield return , se recuerda la ubicación actual
para que el autor de la llamada pueda solicitar el siguiente elemento en la secuencia.

El tipo de valor devuelto de un iterador puede ser IEnumerable, IEnumerable<T>,

IAsyncEnumerable<T>, IEnumerator o IEnumerator<T>.

Para obtener más información, consulta Iteradores.

Consulte también
Modificadores de acceso
Clases estáticas y sus miembros
Herencia
Clases y miembros de clase abstractos y sellados
params
out
ref
in
Pasar parámetros
Propiedades
Artículo • 15/02/2023 • Tiempo de lectura: 11 minutos

Las propiedades son ciudadanos de primera clase en C#. El lenguaje define la sintaxis
que permite a los desarrolladores escribir código que exprese con precisión su intención
de diseño.

Las propiedades se comportan como campos cuando se obtiene acceso a ellas. Pero, a
diferencia de los campos, las propiedades se implementan con descriptores de acceso
que definen las instrucciones que se ejecutan cuando se tiene acceso a una propiedad o
se asigna.

Sintaxis de las propiedades

La sintaxis para propiedades es una extensión natural de los campos. Un campo define
una ubicación de almacenamiento:

C#

public class Person

public string FirstName;

// Omitted for brevity.

Una definición de propiedad contiene las declaraciones para un descriptor de acceso

get y set que recupera y asigna el valor de esa propiedad:

C#

public class Person

public string FirstName { get; set; }

// Omitted for brevity.

La sintaxis anterior es la sintaxis de propiedades automáticas. El compilador genera la

ubicación de almacenamiento para el campo que respalda a la propiedad. El compilador
también implementa el cuerpo de los descriptores de acceso get y set .
A veces, necesita inicializar una propiedad en un valor distinto del predeterminado para
su tipo. C# permite esto estableciendo un valor después de la llave de cierre de la
propiedad. Puede que prefiera que el valor inicial para la propiedad FirstName sea la
cadena vacía en lugar de null . Debe especificarlo como se muestra a continuación:

C#

public class Person

public string FirstName { get; set; } = string.Empty;

// Omitted for brevity.

La inicialización específica es más útil en las propiedades de solo lectura, como verá
posteriormente en este artículo.

También puede definir su propio almacenamiento, como se muestra a continuación:

C#

public class Person

public string FirstName

get { return _firstName; }

set { _firstName = value; }

private string _firstName;

// Omitted for brevity.

Cuando una implementación de propiedad es una expresión única, puede usar

miembros con forma de expresión para el captador o establecedor:

C#

public class Person

public string FirstName

get => _firstName;

set => _firstName = value;

private string _firstName;

// Omitted for brevity.

Esta sintaxis simplificada se usará cuando sea necesario en todo el artículo.

La definición de propiedad anterior es una propiedad de lectura y escritura. Observe la

palabra clave value en el descriptor de acceso set. El descriptor de acceso set siempre
tiene un único parámetro denominado value . El descriptor de acceso get tiene que
devolver un valor que se pueda convertir al tipo de la propiedad ( string en este
ejemplo).

Estos son los conceptos básicos de la sintaxis. Hay muchas variantes distintas que
admiten diversos lenguajes de diseño diferentes. Vamos a explorarlas y a aprender las
opciones de sintaxis de cada una.

Validación
Los ejemplos anteriores mostraron uno de los casos más simples de definición de
propiedad: una propiedad de lectura y escritura sin validación. Al escribir el código que
quiere en los descriptores de acceso get y set , puede crear muchos escenarios
diferentes.

Puede escribir código en el descriptor de acceso set para asegurarse de que los valores
representados por una propiedad siempre son válidos. Por ejemplo, suponga que una
regla para la clase Person es que el nombre no puede estar en blanco ni tener espacios
en blanco. Se escribiría de esta forma:

C#

public class Person

public string FirstName

get => _firstName;

set

if (string.IsNullOrWhiteSpace(value))

throw new ArgumentException("First name must not be blank");

_firstName = value;

private string _firstName;

// Omitted for brevity.

El ejemplo anterior se puede simplificar usando una expresión throw como parte de la
validación del establecedor de propiedad:

C#

public class Person

public string FirstName

get => _firstName;

set => _firstName = (!string.IsNullOrWhiteSpace(value)) ? value :

throw new ArgumentException("First name must not be blank");

private string _firstName;

// Omitted for brevity.

En el ejemplo anterior, se aplica la regla de que el nombre no debe estar en blanco ni

tener espacios en blanco. Si un desarrollador escribe:

C#

hero.FirstName = "";

Esa asignación produce una excepción ArgumentException . Dado que un descriptor de

acceso set de propiedad debe tener un tipo de valor devuelto void, los errores se
notifican en el descriptor de acceso set iniciando una excepción.

Se puede extender esta misma sintaxis para todo lo que se necesite en el escenario. Se
pueden comprobar las relaciones entre las diferentes propiedades o validar con
respecto a cualquier condición externa. Todas las instrucciones de C# válidas son válidas
en un descriptor de acceso de propiedad.

Control de acceso
Hasta ahora, todas las definiciones de propiedad que se vieron son propiedades de
lectura y escritura con descriptores de acceso públicos. No es la única accesibilidad
válida para las propiedades. Se pueden crear propiedades de solo lectura, o
proporcionar accesibilidad diferente a los descriptores de acceso set y get. Suponga que
su clase Person solo debe habilitar el cambio del valor de la propiedad FirstName desde
otros métodos de esa clase. Podría asignar al descriptor de acceso set la accesibilidad
private en lugar de public :
 C#

public class Person

public string FirstName { get; private set; }

// Omitted for brevity.

Ahora, se puede obtener acceso a la propiedad FirstName desde cualquier código, pero
solo puede asignarse desde otro código de la clase Person .

Puede agregar cualquier modificador de acceso restrictivo al descriptor de acceso set o

get. Ningún modificador de acceso que se coloque en el descriptor de acceso concreto
debe ser más limitado que el modificador de acceso en la definición de la propiedad. El
ejemplo anterior es válido porque la propiedad FirstName es public , pero el descriptor
de acceso set es private . No se puede declarar una propiedad private con un
descriptor de acceso public . Las declaraciones de propiedad también se pueden
declarar como protected , internal , protected internal o incluso private .

También es válido colocar el modificador más restrictivo en el descriptor de acceso get .

Por ejemplo, se podría tener una propiedad public , pero restringir el descriptor de
acceso get a private . Ese escenario raramente se aplica en la práctica.

Solo lectura
También puede restringir las modificaciones de una propiedad, de manera que solo
pueda establecerse en un constructor. Puede modificar la clase Person de la manera
siguiente:

C#

public class Person

public Person(string firstName) => FirstName = firstName;

public string FirstName { get; }

// Omitted for brevity.

Solo inicialización
En el ejemplo anterior se requieren llamadas para usar el constructor que incluye el
parámetro FirstName . Los autores de llamadas no pueden usar inicializadores de
objetos para asignar un valor a la propiedad. Para admitir inicializadores, puede
convertir el descriptor de acceso set en un descriptor de acceso init , como se muestra
en el código siguiente:

C#

public class Person

public Person() { }

public Person(string firstName) => FirstName = firstName;

public string FirstName { get; init; }

// Omitted for brevity.

En el ejemplo anterior se permite que un autor de la llamada cree Person mediante el

constructor predeterminado, incluso cuando ese código no establece la propiedad
FirstName . A partir de C# 11, puede requerir que los autores de llamadas establezcan

esa propiedad:

C#

public class Person

public Person() { }

[SetsRequiredMembers]

public Person(string firstName) => FirstName = firstName;

public required string FirstName { get; init; }

// Omitted for brevity.

El código anterior realiza dos adiciones a la clase Person . En primer lugar, la declaración
de la propiedad FirstName incluye el modificador required . Esto significa que cualquier
código que cree un nuevo Person debe establecer esta propiedad. En segundo lugar, el
constructor que toma un parámetro firstName tiene el atributo
System.Diagnostics.CodeAnalysis.SetsRequiredMembersAttribute. Este atributo informa
al compilador de que este constructor establece todos los miembros de required .

） Importante
 No confunda required con que no acepta valores NULL. Es válido establecer una
propiedad required en null o default . Si el tipo no acepta valores NULL, como
string en estos ejemplos, el compilador emite una advertencia.

Los autores de llamadas deben usar el constructor con SetsRequiredMembers o

establecer la propiedad FirstName mediante un inicializador de objeto, como se
muestra en el código siguiente:

C#

var person = new VersionNinePoint2.Person("John");

person = new VersionNinePoint2.Person{ FirstName = "John"};

// Error CS9035: Required member `Person.FirstName` must be set:

//person = new VersionNinePoint2.Person();

Propiedades calculadas
Una propiedad no tiene por qué devolver únicamente el valor de un campo de
miembro. Se pueden crear propiedades que devuelvan un valor calculado. Vamos a
ampliar el objeto Person para que devuelva el nombre completo, que se calcula
mediante la concatenación del nombre y el apellido:

C#

public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

public string FullName { get { return $"{FirstName} {LastName}"; } }

En el ejemplo anterior se usa la característica de interpolación de cadenas para crear la

cadena con formato para el nombre completo.

También se pueden usar un miembro con forma de expresión, que proporciona una
manera más concisa de crear la propiedad FullName calculada:

C#

public class Person

public string FirstName { get; set; }

 public string LastName { get; set; }

public string FullName => $"{FirstName} {LastName}";

Los miembros con forma de expresión usan la sintaxis de expresión lambda para definir
métodos que contienen una única expresión. En este caso, esa expresión devuelve el
nombre completo para el objeto person.

Propiedades de evaluación en caché

Se puede combinar el concepto de una propiedad calculada con almacenamiento de
información y crear una propiedad de evaluación en caché. Por ejemplo, se podría
actualizar la propiedad FullName para que la cadena de formato solo apareciera la
primera vez que se obtuvo acceso a ella:

C#

public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

private string _fullName;

public string FullName

get

if (_fullName is null)

_fullName = $"{FirstName} {LastName}";

return _fullName;

Pero el código anterior contiene un error. Si el código actualiza el valor de la propiedad

FirstName o LastName , el campo evaluado previamente fullName no es válido. Hay que
modificar los descriptores de acceso set de la propiedad FirstName y LastName para
que el campo fullName se calcule de nuevo:

C#

public class Person

private string _firstName;

 public string FirstName

get => _firstName;

set

_firstName = value;

_fullName = null;

private string _lastName;

public string LastName

get => _lastName;

set

_lastName = value;

_fullName = null;

private string _fullName;

public string FullName

get

if (_fullName is null)

_fullName = $"{FirstName} {LastName}";

return _fullName;

Esta versión final da como resultado la propiedad FullName solo cuando sea necesario.
Si la versión calculada previamente es válida, es la que se usa. Si otro cambio de estado
invalida la versión calculada previamente, se vuelve a calcular. No es necesario que los
desarrolladores que usan esta clase conozcan los detalles de la implementación.
Ninguno de estos cambios internos afectan al uso del objeto Person. Es el motivo
principal para usar propiedades para exponer los miembros de datos de un objeto.

Asociar atributos a propiedades

implementadas automáticamente
Los atributos de campo se pueden conectar al campo de respaldo generado por el
compilador en las propiedades implementadas automáticamente. Por ejemplo,
pensemos en una revisión de la clase Person que agrega una propiedad Id de entero
único. Escribe la propiedad Id usando una propiedad implementada automáticamente,
pero el diseño no requiere que la propiedad Id se conserve. NonSerializedAttribute
solo se puede asociar a campos, no a propiedades. NonSerializedAttribute se puede
asociar al campo de respaldo de la propiedad Id usando el especificador field: en el
atributo, como se muestra en el siguiente ejemplo:

C#

public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

[field:NonSerialized]

public int Id { get; set; }

public string FullName => $"{FirstName} {LastName}";

Esta técnica funciona con cualquier atributo que se asocie al campo de respaldo en la
propiedad implementada automáticamente.

Implementar INotifyPropertyChanged
Un último escenario donde se necesita escribir código en un descriptor de acceso de
propiedad es para admitir la interfaz INotifyPropertyChanged que se usa para notificar a
los clientes de enlace de datos el cambio de un valor. Cuando se cambia el valor de una
propiedad, el objeto genera el evento INotifyPropertyChanged.PropertyChanged para
indicar el cambio. A su vez, las bibliotecas de enlace de datos actualizan los elementos
de visualización en función de ese cambio. El código siguiente muestra cómo se
implementaría INotifyPropertyChanged para la propiedad FirstName de esta clase
person.

C#

public class Person : INotifyPropertyChanged

public string FirstName

get => _firstName;

set

if (string.IsNullOrWhiteSpace(value))

throw new ArgumentException("First name must not be blank");

if (value != _firstName)

 _firstName = value;

PropertyChanged?.Invoke(this,

new PropertyChangedEventArgs(nameof(FirstName)));

private string _firstName;

public event PropertyChangedEventHandler PropertyChanged;

El operador ?. se denomina operador condicional NULL. Comprueba si existe una

referencia nula antes de evaluar el lado derecho del operador. El resultado final es que si
no hay ningún suscriptor para el evento PropertyChanged , no se ejecuta el código para
generar el evento. En ese caso, se producirá una NullReferenceException sin esta
comprobación. Para obtener más información, vea events. En este ejemplo también se
usa el nuevo operador nameof para convertir el símbolo de nombre de propiedad en su
representación de texto. Con nameof se pueden reducir los errores en los que no se
escribió correctamente el nombre de la propiedad.

De nuevo, la implementación de INotifyPropertyChanged es un ejemplo de un caso en

el que se puede escribir código en los descriptores de acceso para admitir los escenarios
que se necesitan.

Resumen
Las propiedades son una forma de campos inteligentes en una clase o un objeto. Desde
fuera del objeto, parecen campos en el objeto. Pero las propiedades pueden
implementarse mediante la paleta completa de funcionalidad de C#. Se puede
proporcionar validación, tipos diferentes de accesibilidad, evaluación diferida o los
requisitos que se necesiten para cada escenario.
Indizadores
Artículo • 22/09/2022 • Tiempo de lectura: 9 minutos

Los indizadores son similares a las propiedades. Muchas veces, los indizadores se basan
en las mismas características del lenguaje que las propiedades. Los indizadores permiten
las propiedades indizadas: propiedades a las que se hace referencia mediante uno o
más argumentos. Estos argumentos proporcionan un índice en alguna colección de
valores.

Sintaxis del indizador

Se obtiene acceso a un indizador usando un nombre de variable y corchetes. Los
argumentos del indizador se colocan dentro de los corchetes:

C#

var item = someObject["key"];

someObject["AnotherKey"] = item;

Los indizadores se declaran con la palabra clave this como nombre de la propiedad y
declarando los argumentos entre corchetes. Esta declaración coincidiría con el uso que
se muestra en el párrafo anterior:

C#

public int this[string key]

get { return storage.Find(key); }

set { storage.SetAt(key, value); }

En este ejemplo inicial puede ver la relación existente entre la sintaxis de las
propiedades y los indizadores. Esta analogía lleva a cabo la mayoría de las reglas de
sintaxis de los indizadores. Los indizadores pueden tener cualquier modificador de
acceso válido (público, interno protegido, protegido, interno, privado o privado
protegido). Pueden ser sellados, virtuales o abstractos. Al igual que con las propiedades,
puede especificar distintos modificadores de acceso para los descriptores de acceso get
y set en un indizador.
También puede especificar indizadores de solo lectura (omitiendo
el descriptor de acceso set) o indizadores de solo escritura (omitiendo el descriptor de
acceso get).
Puede aplicar a los indizadores casi todo lo que aprenda al trabajar con propiedades. La
única excepción a esta regla son las propiedades implementadas automáticamente. El
compilador no siempre puede generar el almacenamiento correcto para un indizador.

La presencia de argumentos para hacer referencia a un elemento en un conjunto de

elementos distingue los indizadores de las propiedades. Puede definir varios indizadores
en un tipo, mientras que las listas de argumentos de cada indizador son únicas. Vamos a
explorar escenarios diferentes en los que puede usar uno o varios indizadores en una
definición de clase.

Escenarios
Tendría que definir indizadores en el tipo si su API modela alguna colección en la que se
definen los argumentos de esa colección. Los indizadores pueden (o no) asignarse
directamente a los tipos de colección que forman parte del marco de trabajo principal
de .NET. El tipo puede tener otras responsabilidades, además de tener que modelar una
colección.
Los indizadores le permiten proporcionar la API que coincida con la
abstracción de su tipo sin tener que exponer la información interna de cómo se
almacenan o se calculan los valores de dicha abstracción.

Veamos algunos de los escenarios habituales en los que se usan los indizadores. Puede
obtener acceso a la carpeta de ejemplo para indexadores . Para obtener instrucciones
de descarga, vea Ejemplos y tutoriales.

Matrices y vectores
Uno de los escenarios más comunes para crear indizadores es cuando el tipo modela
una matriz o un vector. Puede crear un indizador para modelar una lista ordenada de
datos.

La ventaja de crear su propio indizador es que puede definir el almacenamiento de esa

colección para satisfacer sus necesidades. Piense en un escenario en el que el tipo
modela datos históricos que tienen un tamaño demasiado grande para poder cargarlos
en la memoria de una vez. Debe cargar y descargar secciones de la colección en función
del uso. En el ejemplo siguiente se modela este comportamiento. Informa sobre el
número de puntos de datos existente, crea páginas para incluir secciones de los datos a
petición y quita páginas de la memoria para dejar espacio para las páginas necesarias
para las solicitudes más recientes.

C#
public class DataSamples

private class Page

private readonly List<Measurements> pageData = new

List<Measurements>();

private readonly int startingIndex;

private readonly int length;

private bool dirty;

private DateTime lastAccess;

public Page(int startingIndex, int length)

this.startingIndex = startingIndex;

this.length = length;

lastAccess = DateTime.Now;

// This stays as random stuff:

var generator = new Random();

for(int i=0; i < length; i++)

var m = new Measurements

HiTemp = generator.Next(50, 95),

LoTemp = generator.Next(12, 49),

AirPressure = 28.0 + generator.NextDouble() * 4

};

pageData.Add(m);

public bool HasItem(int index) =>

((index >= startingIndex) &&

(index < startingIndex + length));

public Measurements this[int index]

get

lastAccess = DateTime.Now;

return pageData[index - startingIndex];

set

pageData[index - startingIndex] = value;

dirty = true;

lastAccess = DateTime.Now;

public bool Dirty => dirty;

public DateTime LastAccess => lastAccess;

private readonly int totalSize;

 private readonly List<Page> pagesInMemory = new List<Page>();

public DataSamples(int totalSize)

this.totalSize = totalSize;

public Measurements this[int index]

get

if (index < 0)

throw new IndexOutOfRangeException("Cannot index less than

0");

if (index >= totalSize)

throw new IndexOutOfRangeException("Cannot index past the

end of storage");

var page = updateCachedPagesForAccess(index);

return page[index];

set

if (index < 0)

throw new IndexOutOfRangeException("Cannot index less than

0");

if (index >= totalSize)

throw new IndexOutOfRangeException("Cannot index past the

end of storage");

var page = updateCachedPagesForAccess(index);

page[index] = value;

private Page updateCachedPagesForAccess(int index)

foreach (var p in pagesInMemory)

if (p.HasItem(index))

return p;

var startingIndex = (index / 1000) * 1000;

var newPage = new Page(startingIndex, 1000);

addPageToCache(newPage);

return newPage;

private void addPageToCache(Page p)

if (pagesInMemory.Count > 4)

// remove oldest non-dirty page:

 var oldest = pagesInMemory

.Where(page => !page.Dirty)

.OrderBy(page => page.LastAccess)

.FirstOrDefault();

// Note that this may keep more than 5 pages in memory

// if too much is dirty

if (oldest != null)

pagesInMemory.Remove(oldest);

pagesInMemory.Add(p);

Puede seguir esta expresión de diseño para modelar cualquier tipo de colección cuando
haya motivos de peso para no cargar todo el conjunto de datos en una colección en
memoria. Observe que la clase Page es una clase anidada privada que no forma parte
de la interfaz pública. Estos datos se ocultan a los usuarios de esta clase.

Diccionarios
Otro escenario habitual es cuando necesita modelar un diccionario o una asignación. En
este escenario, el tipo almacena valores en función de la clave (normalmente claves de
texto). En este ejemplo se crea un diccionario que asigna argumentos de la línea de
comandos a expresiones lambda que administran estas opciones. En el ejemplo
siguiente se muestran dos clases: una clase ArgsActions , que asigna una opción de la
línea de comandos a un delegado Action ; y ArgsProcessor , que usa ArgsActions para
ejecutar cada Action cuando encuentra esa opción.

C#

public class ArgsProcessor

private readonly ArgsActions actions;

public ArgsProcessor(ArgsActions actions)

this.actions = actions;

public void Process(string[] args)

foreach(var arg in args)

actions[arg]?.Invoke();

 public class ArgsActions

readonly private Dictionary<string, Action> argsActions = new

Dictionary<string, Action>();

public Action this[string s]

get

Action action;

Action defaultAction = () => {} ;

return argsActions.TryGetValue(s, out action) ? action :

defaultAction;

public void SetOption(string s, Action a)

argsActions[s] = a;

En este ejemplo, la colección ArgsAction está estrechamente relacionada con la

colección subyacente.
get determina si se ha configurado una opción determinada. Si
es así, devuelve la Action asociada a esa opción. Si no, devuelve una Action que no
hace nada. El descriptor de acceso público no incluye ningún descriptor de acceso set ,
En su lugar, el diseño usa un método público para establecer opciones.

Asignaciones multidimensionales
Puede crear indizadores que usen varios argumentos. Además, estos argumentos no se
restringen para que sean del mismo tipo. Veamos dos ejemplos.

En el primer ejemplo se muestra una clase que genera valores para el conjunto
Mandelbrot. Para obtener más información sobre las matemáticas subyacentes en el
conjunto, lea este artículo .
El indizador usa dos valores double para definir un punto
en el plano X, Y.
El descriptor de acceso get calcula el número de iteraciones existente
hasta que se determina que un punto no está en el conjunto. Si se alcanza el número
máximo de iteraciones, el punto está en el conjunto y se devuelve el valor maxIterations
de la clase (Las imágenes generadas por un equipo popularizadas para el conjunto
Mandelbrot definen colores para el número de iteraciones que son necesarias para
determinar que un punto en concreto está fuera del conjunto).

C#

public class Mandelbrot

{

 readonly private int maxIterations;

public Mandelbrot(int maxIterations)

this.maxIterations = maxIterations;

public int this [double x, double y]

get

var iterations = 0;

var x0 = x;

var y0 = y;

while ((x*x + y * y < 4) &&

(iterations < maxIterations))

var newX = x * x - y * y + x0;

y = 2 * x * y + y0;

x = newX;

iterations++;

return iterations;

El conjunto Mandelbrot define valores en cada coordenada (x o y) para los valores

numéricos reales.
Con esto se define un diccionario que puede contener un número
infinito de valores. Por lo tanto, no hay ningún almacenamiento detrás del conjunto. En
su lugar, esta clase calcula el valor de cada punto cuando el código llama al descriptor
de acceso get , por lo que no se usa ningún almacenamiento subyacente.

Vamos a examinar un último uso de los indizadores, en el que el indizador toma varios
argumentos de distintos tipos. Imagínese un programa que administra datos históricos
de temperaturas. Este indizador usa una ciudad y una fecha para establecer u obtener
las temperaturas máximas y mínimas de ese lugar:

C#

using DateMeasurements =

System.Collections.Generic.Dictionary<System.DateTime,
IndexersSamples.Common.Measurements>;

using CityDataMeasurements =

System.Collections.Generic.Dictionary<string,
System.Collections.Generic.Dictionary<System.DateTime,
IndexersSamples.Common.Measurements>>;

public class HistoricalWeatherData

 readonly CityDataMeasurements storage = new CityDataMeasurements();

public Measurements this[string city, DateTime date]

get

var cityData = default(DateMeasurements);

if (!storage.TryGetValue(city, out cityData))

throw new ArgumentOutOfRangeException(nameof(city), "City

not found");

// strip out any time portion:

var index = date.Date;

var measure = default(Measurements);

if (cityData.TryGetValue(index, out measure))

return measure;

throw new ArgumentOutOfRangeException(nameof(date), "Date not

found");

set

var cityData = default(DateMeasurements);

if (!storage.TryGetValue(city, out cityData))

cityData = new DateMeasurements();

storage.Add(city, cityData);

// Strip out any time portion:

var index = date.Date;

cityData[index] = value;

Este ejemplo crea un indizador que asigna los datos meteorológicos en dos argumentos
diferentes: una ciudad (representada por string ) y una fecha (representada por
DateTime ). El almacenamiento interno usa dos clases Dictionary para representar el
diccionario bidimensional. La API pública ya no representa el almacenamiento
subyacente. En su lugar, las características del lenguaje de los indizadores le permiten
crear una interfaz pública que representa la abstracción, aunque el almacenamiento
subyacente debe usar distintos tipos de colección básica.

Hay dos partes de este código que pueden resultar desconocidas para algunos
desarrolladores, Estas dos directivas using :

C#
 using DateMeasurements =
System.Collections.Generic.Dictionary<System.DateTime,
IndexersSamples.Common.Measurements>;

using CityDataMeasurements = System.Collections.Generic.Dictionary<string,

System.Collections.Generic.Dictionary<System.DateTime,
IndexersSamples.Common.Measurements>>;

Estas instrucciones crean un alias para un tipo genérico construido y permiten que el
código use después los nombres DateMeasurements y CityDataMeasurements (más
descriptivos) en vez de la construcción genérica de Dictionary<DateTime, Measurements>
y Dictionary<string, Dictionary<DateTime, Measurements> > .
Esta construcción requiere
el uso de los nombres completos de tipo en el lado derecho del signo = .

La segunda técnica consiste en quitar las partes de tiempo de cualquier objeto DateTime
usado para indizarse en las colecciones. .NET no incluye un tipo de solo fecha.
Los
desarrolladores usan el tipo DateTime , aunque emplean la propiedad Date para
asegurarse de que cualquier objeto DateTime de ese día sea igual.

Resumen
Debe crear indizadores siempre que tenga un elemento de propiedad en la clase, en la
que dicha propiedad no representa un valor único, sino una serie de valores donde cada
elemento se identifica mediante un conjunto de argumentos. Estos argumentos
únicamente pueden identificar el elemento al que se debe hacer referencia en la
colección.
Los indizadores amplían el concepto de las propiedades, en las que un
miembro se trata como un elemento de datos desde fuera de la clase, pero como un
método desde dentro. Los indizadores permiten que los argumentos busquen un solo
elemento en una propiedad que representa un conjunto de elementos.
Iterators
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Prácticamente todos los programas que escriba tendrán alguna necesidad de recorrer
en iteración una colección. Va a escribir código que examine cada elemento de una
colección.

También va a crear métodos de iterador, que son los métodos que genera un iterador
para los elementos de esa clase. Un iterador es un objeto que atraviesa un contenedor,
especialmente las listas. Los iteradores se pueden usar para:

Realizar una acción en cada elemento de una colección.

Enumerar una colección personalizada.
Extender LINQ u otras bibliotecas.
Crear una canalización de datos en la que los datos fluyan de forma eficaz
mediante métodos de iterador.

El lenguaje C# proporciona características para generar y consumir secuencias. Estas

secuencias se pueden generar y consumir de forma sincrónica o asincrónica. Este
artículo proporciona información general sobre esas características.

Iteración con foreach

Enumerar una colección es sencillo: la palabra clave foreach enumera una colección,
ejecutando la instrucción incrustada una vez para cada elemento de la colección:

C#

foreach (var item in collection)

Console.WriteLine(item?.ToString());

That's all. (Esto es todo) Para recorrer en iteración todo el contenido de una colección, la
instrucción foreach es todo lo que necesita. Pero la instrucción foreach no es mágica.
Depende de dos interfaces genéricas definidas en la biblioteca de .NET Core para
generar el código necesario para recorrer en iteración una colección: IEnumerable<T> e
IEnumerator<T> . Este mecanismo se explica con más detalle a continuación.

Ambas interfaces tienen también homólogas no genéricas: IEnumerable e IEnumerator .

Para el código moderno se prefieren las versiones genéricas.
Cuando se genera una secuencia de forma asincrónica, puede usar la instrucción await
foreach para consumir la secuencia de forma asincrónica:

C#

await foreach (var item in asyncSequence)

Console.WriteLine(item?.ToString());

Cuando una secuencia es System.Collections.Generic.IEnumerable<T>, se usa foreach .

Cuando una secuencia es System.Collections.Generic.IAsyncEnumerable<T>, se usa
await foreach . En el último caso, la secuencia se genera de forma asincrónica.

Orígenes de enumeración con métodos de

iterador
Otra magnífica característica del lenguaje C# permite generar métodos que crean un
origen para una enumeración. Estos métodos se conocen como métodos de iterador. Un
método de iterador define cómo generar los objetos de una secuencia cuando se
solicita. Para definir un método de iterador se usan las palabras clave contextuales yield
return .

Podría escribir este método para generar la secuencia de enteros de 0 a 9:

C#

public IEnumerable<int> GetSingleDigitNumbers()

yield return 0;

yield return 1;

yield return 2;

yield return 3;

yield return 4;

yield return 5;

yield return 6;

yield return 7;

yield return 8;

yield return 9;

El código anterior muestra instrucciones distintivas yield return para resaltar el hecho
de que se pueden usar varias instrucciones discretas yield return en un método de
iterador. Puede usar (y hágalo a menudo) otras construcciones de lenguaje para
simplificar el código de un método de iterador. La definición del método siguiente
genera la misma secuencia de números:

C#

public IEnumerable<int> GetSingleDigitNumbersLoop()

int index = 0;

while (index < 10)

yield return index++;

No tiene que elegir entre una y otra. Puede tener tantas instrucciones yield return
como sea necesario para satisfacer las necesidades del método:

C#

public IEnumerable<int> GetSetsOfNumbers()

int index = 0;

while (index < 10)

yield return index++;

yield return 50;

index = 100;

while (index < 110)

yield return index++;

Todos estos ejemplos anteriores tendrían un homólogo asincrónico. En cada caso,

reemplazaría el tipo de valor devuelto de IEnumerable<T> por un elemento
IAsyncEnumerable<T> . Por ejemplo, el ejemplo anterior tendría la siguiente versión

asincrónica:

C#

public async IAsyncEnumerable<int> GetSetsOfNumbersAsync()

int index = 0;

while (index < 10)

yield return index++;

await Task.Delay(500);

yield return 50;

await Task.Delay(500);

 index = 100;

while (index < 110)

yield return index++;

Esta es la sintaxis de los iteradores sincrónicos y asincrónicos. Veamos un ejemplo del

mundo real. Imagine que se encuentra en un proyecto de IoT y los sensores del
dispositivo generan un flujo de datos muy grande. Para hacerse una idea de los datos,
podría escribir un método que tomara muestras de cada enésimo elemento de datos.
Este pequeño método de iterador lo hace:

C#

public static IEnumerable<T> Sample<T>(this IEnumerable<T> sourceSequence,

int interval)

int index = 0;

foreach (T item in sourceSequence)

if (index++ % interval == 0)

yield return item;

Si la lectura desde el dispositivo IoT genera una secuencia asincrónica, modificaría el

método como se muestra en el método siguiente:

C#

public static async IAsyncEnumerable<T> Sample<T>(this IAsyncEnumerable<T>

sourceSequence, int interval)

int index = 0;

await foreach (T item in sourceSequence)

if (index++ % interval == 0)

yield return item;

Hay una restricción importante en los métodos de iterador: no puede tener una
instrucción return y una instrucción yield return en el mismo método. El código
siguiente no se compilará:

C#

public IEnumerable<int> GetSingleDigitNumbers()

 int index = 0;

while (index < 10)

yield return index++;

yield return 50;

// generates a compile time error:

var items = new int[] {100, 101, 102, 103, 104, 105, 106, 107, 108, 109
};

return items;

Normalmente esta restricción no supone un problema. Tiene la opción de usar yield

return en todo el método o de separar el método original en varios métodos, unos con

return y otros con yield return .

Puede modificar el último método ligeramente para usar yield return en todas partes:

C#

public IEnumerable<int> GetFirstDecile()

int index = 0;

while (index < 10)

yield return index++;

yield return 50;

var items = new int[] {100, 101, 102, 103, 104, 105, 106, 107, 108, 109
};

foreach (var item in items)

yield return item;

A veces, la respuesta correcta es dividir un método de iterador en dos métodos

distintos. Uno que use return y un segundo que use yield return . Imagine una
situación en la que quiera devolver una colección vacía, o los cinco primeros números
impares, basándose en un argumento booleano. Eso se podría escribir como estos dos
métodos:

C#

public IEnumerable<int> GetSingleDigitOddNumbers(bool getCollection)

if (getCollection == false)

return new int[0];

else

return IteratorMethod();

 private IEnumerable<int> IteratorMethod()

int index = 0;

while (index < 10)

if (index % 2 == 1)

yield return index;

index++;

Observe los métodos anteriores. El primero usa la instrucción estándar return para
devolver una colección vacía o el iterador creado por el segundo método. El segundo
método usa la instrucción yield return para crear la secuencia solicitada.

Profundización en foreach
La instrucción foreach se expande en un elemento estándar que usa las interfaces
IEnumerable<T> e IEnumerator<T> para recorrer en iteración todos los elementos de una

colección. También minimiza los errores cometidos por los desarrolladores al no

administrar correctamente los recursos.

El compilador traduce el bucle foreach que se muestra en el primer ejemplo en algo

similar a esta construcción:

C#

IEnumerator<int> enumerator = collection.GetEnumerator();

while (enumerator.MoveNext())

var item = enumerator.Current;

Console.WriteLine(item.ToString());

El código exacto generado por el compilador es más complicado y controla las

situaciones en las que el objeto devuelto por GetEnumerator() implementa la interfaz
IDisposable . La expansión completa genera código más parecido al siguiente:

C#

var enumerator = collection.GetEnumerator();

try

while (enumerator.MoveNext())

var item = enumerator.Current;

Console.WriteLine(item.ToString());

finally

// dispose of enumerator.
}

El compilador traduce el primer ejemplo asincrónico en algo similar a esta construcción:

C#

var enumerator = collection.GetAsyncEnumerator();

try

while (await enumerator.MoveNextAsync())

var item = enumerator.Current;

Console.WriteLine(item.ToString());

finally

// dispose of async enumerator.

La manera en que el enumerador se elimina depende de las características del tipo de

enumerator . En el caso sincrónico general, la cláusula finally se expande a:

C#

finally

(enumerator as IDisposable)?.Dispose();

El caso asincrónico general se expande a:

C#

finally

if (enumerator is IAsyncDisposable asyncDisposable)

await asyncDisposable.DisposeAsync();

Sin embargo, si el tipo de enumerator es un tipo sellado y no hay conversión implícita

del tipo de enumerator a IDisposable o IAsyncDisposable , la cláusula finally se
expande en un bloque vacío:

C#

finally

Si hay una conversión implícita del tipo de enumerator a IDisposable , y enumerator es

un tipo de valor que no acepta valores Null, la cláusula finally se expande en:

C#

finally

((IDisposable)enumerator).Dispose();

Afortunadamente, no es necesario recordar todos estos detalles. La instrucción foreach

controla todos esos matices. El compilador generará el código correcto para cualquiera
de estas construcciones.
Introducción a delegados y eventos en
C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los delegados proporcionan un mecanismo de enlace en tiempo de ejecución en .NET.

Un enlace en tiempo de ejecución significa que se crea un algoritmo en el que el
llamador también proporciona al menos un método que implementa parte del
algoritmo.

Por ejemplo, considere la ordenación de una lista de estrellas en una aplicación de

astronomía.
Puede decidir ordenar las estrellas por su distancia con respecto a la Tierra,
por la magnitud de la estrella o por su brillo percibido.

En todos estos casos, el método Sort() hace básicamente lo mismo: organiza los
elementos en la lista en función de una comparación. El código que compara dos
estrellas es diferente para cada uno de los criterios de ordenación.

Este tipo de soluciones se ha usado en software durante aproximadamente medio siglo.

El concepto de delegado del lenguaje C# proporciona compatibilidad con el lenguaje de
primera clase y seguridad de tipos en torno a este concepto.

Como verá más adelante en esta serie, el código de C# que escriba para algoritmos
como este tiene seguridad de tipos. El compilador garantiza que los tipos coincidan con
los argumentos y los tipos de valor devuelto.

Se han agregado punteros de función a C# 9 para escenarios similares, donde se

necesita más control sobre la convención de llamadas. El código asociado a un
delegado se invoca mediante un método virtual agregado a un tipo de delegado.
Mediante los punteros de función puede especificar otras convenciones.

Objetivos del diseño de lenguaje para los

delegados
Los diseñadores de lenguaje enumeraron varios objetivos para la característica que se
acabó convirtiendo en los delegados.

El equipo aspiraba a crear una construcción de lenguaje común que pudiera usarse para
cualquier algoritmo de enlace en tiempo de ejecución. Los delegados permiten a los
desarrolladores aprender un concepto y usarlo en muchos problemas de software
diferentes.
En segundo lugar, el equipo quería que se admitiesen llamadas a métodos únicos y
multidifusión. (Los delegados de multidifusión son delegados que encadenan varias
llamadas de método. Verá ejemplos más adelante en esta serie).

El equipo quería que los delegados admitiesen la misma seguridad de tipos que los
desarrolladores esperan de todas las construcciones C#.

Por último, el equipo reconocía que un patrón de eventos es un patrón específico en el

que los delegados, o cualquier algoritmo de enlace en tiempo de ejecución, resultan
útiles. El equipo quería garantizar que el código de los delegados proporcionase una
base para el patrón de eventos de .NET.

El resultado de todo ese trabajo fue la compatibilidad con los delegados y los eventos
en C# y .NET.

Los artículos restantes de esta serie tratarán sobre las características del lenguaje, la
compatibilidad con bibliotecas y las expresiones comunes que se usan al trabajar con
los delegados y eventos.
Obtendrá información sobre:

La palabra clave delegate y el código que genera.

Las características de la clase System.Delegate y la manera en que se usan estas
características.
Cómo crear delegados con seguridad de tipos.
Cómo crear métodos que se puedan invocar mediante delegados.
Cómo trabajar con delegados y eventos mediante expresiones lambda.
Cómo los delegados se convierten en uno de los bloques de creación para LINQ.
Cómo los delegados son la base del patrón de eventos de .NET y en qué se
diferencian.

Comencemos.

Siguiente
System.Delegate y la palabra clave
delegate
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

Anterior

En este artículo se tratan las clases de .NET que admiten delegados y sobre cómo se
asignan a la palabra clave delegate .

Definición de los tipos delegados

Comencemos con la palabra clave "delegate", ya que es lo que usará principalmente al
trabajar con delegados. El código que genere el compilador cuando se usa la palabra
clave delegate se asignará a las llamadas de método que invocan a miembros de las
clases Delegate y MulticastDelegate.

Para definir un tipo de delegado, se usa una sintaxis similar a la definición de una firma
de método. Solo hace falta agregar la palabra clave delegate a la definición.

Vamos a usar el método List.Sort() como ejemplo. El primer paso consiste en crear un
tipo para el delegado de comparación:

C#

// From the .NET Core library

// Define the delegate type:

public delegate int Comparison<in T>(T left, T right);

El compilador genera una clase derivada de System.Delegate que coincide con la firma
usada (en este caso, un método que devuelve un entero y tiene dos argumentos). El tipo
de ese delegado es Comparison . El tipo de delegado Comparison es un tipo genérico.
Aquí puede obtener más información sobre los genéricos.

Observe que puede parecer que la sintaxis declara una variable, pero en realidad declara
un tipo. Puede definir tipos de delegado dentro de clases, directamente dentro de
espacios de nombres o incluso en el espacio de nombres global.

７ Nota
 No se recomienda declarar tipos de delegado (u otros tipos) directamente en el
espacio de nombres global.

El compilador también genera controladores de adición y eliminación para este nuevo

tipo, de modo que los clientes de esta clase puedan agregar y quitar métodos de la lista
de invocación de una instancia. El compilador forzará que la firma del método que se
agrega o se quita coincida con la firma usada al declarar el método.

Declaración de instancias de delegados

Después de definir el delegado, puede crear una instancia de ese tipo.
Al igual que
todas las variables en C#, no puede declarar instancias de delegados directamente en
un espacio de nombres o en el espacio de nombres global.

C#

// inside a class definition:

// Declare an instance of that type:

public Comparison<T> comparator;

El tipo de la variable es Comparison<T> , el tipo de delegado definido anteriormente. El

nombre de la variable es comparator .

El fragmento de código anterior declara una variable de miembro dentro de una clase.
También puede declarar variables de delegado que sean variables locales o argumentos
para los métodos.

Invocación de delegados
Para invocar los métodos que se encuentran en la lista de invocación de un delegado,
llame a dicho delegado. Dentro del método Sort() , el código llamará al método de
comparación para determinar en qué orden colocará los objetos:

C#

int result = comparator(left, right);

En la línea anterior, el código invoca al método asociado al delegado.

La variable se trata
como un nombre de método y se invoca mediante la sintaxis de llamada de método
normal.
Esta línea de código realiza una suposición arriesgada, ya que no hay ninguna garantía
de que se haya agregado un destino al delegado. Si no se ha asociado ningún destino,
la línea anterior haría que se produjese una NullReferenceException . Las expresiones
que se usan para resolver este problema son más complicadas que una simple
comprobación de null y se tratan más adelante en esta serie.

Asignación, adición y eliminación de destinos

de invocación
Hemos visto cómo se define un tipo de delegado y cómo se declaran y se invocan las
instancias de delegado.

Los programadores que quieran usar el método List.Sort() deben definir un método
cuya firma coincida con la definición del tipo de delegado y asignarlo al delegado usado
por el método de ordenación. Esta asignación agrega el método a la lista de invocación
de ese objeto de delegado.

Supongamos que quiera ordenar una lista de cadenas por su duración. La función de
comparación podría ser la siguiente:

C#

private static int CompareLength(string left, string right) =>

left.Length.CompareTo(right.Length);

El método se ha declarado como un método privado. Esto es correcto, ya que tal vez no
le interese que este método forme parte de la interfaz pública. Aun así, puede usarse
como método de comparación cuando se asocia a un delegado. El código de llamada
tendrá este método asociado a la lista de destino del objeto de delegado y puede tener
acceso a él a través de ese delegado.

Para crear esta relación, pase ese método al método List.Sort() :

C#

phrases.Sort(CompareLength);

Observe que se usa el nombre del método sin paréntesis. Al usar el método como un
argumento, le indica al compilador que convierta la referencia del método en una
referencia que se puede usar como un destino de invocación del delegado y que asocie
ese método como un destino de invocación.
También podría haber declarado de forma explícita una variable de tipo
Comparison<string> y realizado una asignación:

C#

Comparison<string> comparer = CompareLength;

phrases.Sort(comparer);

En los casos en los que el método que se usa como destino del delegado es un método
pequeño, es habitual usar la sintaxis de expresión lambda para realizar la asignación:

C#

Comparison<string> comparer = (left, right) =>

left.Length.CompareTo(right.Length);

phrases.Sort(comparer);

El uso de expresiones lambda para destinos de delegados se explica con más detalle en
una sección posterior.

En el ejemplo de Sort() se suele asociar un método de destino único al delegado, pero

los objetos delegados admiten listas de invocación que tienen varios métodos de
destino asociados a un objeto delegado.

Clases Delegate y MulticastDelegate

La compatibilidad de lenguaje descrita anteriormente proporciona las características y la
compatibilidad que normalmente necesitará para trabajar con delegados. Estas
características están integradas en dos clases en .NET Core Framework: Delegate y
MulticastDelegate.

La clase System.Delegate y su única subclase directa System.MulticastDelegate

proporcionan la compatibilidad con el marco para crear delegados, registrar métodos
como destinos de delegados e invocar todos los métodos que se registran como un
destino del delegado.

Curiosamente, las clases System.Delegate y System.MulticastDelegate no son tipos de

delegado, pero proporcionan la base para todos los tipos de delegado específicos. El
propio proceso de diseño del lenguaje dictaba que no se puede declarar una clase que
derive de Delegate o MulticastDelegate . Las reglas del lenguaje C# lo prohíben.

En cambio, el compilador de C# crea instancias de una clase derivada de

MulticastDelegate cuando se usa la palabra clave del lenguaje C# para declarar tipos de
delegado.

Este diseño tiene sus orígenes en la primera versión de C# y. NET. Uno de los objetivos
del equipo de diseño era asegurarse de que el lenguaje aplicaba seguridad de tipos al
usar delegados. Esto significaba que debían asegurarse no solo de que los delegados se
invocaban con el tipo y el número adecuados de argumentos, sino de que todos los
tipos de valor devueltos se indicaban correctamente en tiempo de compilación. Los
delegados formaban parte de la versión 1.0 .NET, que apareció antes que los genéricos.

La mejor manera de aplicar la seguridad de tipos era que el compilador crease las clases
de delegado concretas que representasen la firma del método que se usaba.

Aunque usted no puede crear clases derivadas directamente, usará los métodos
definidos en estas clases. Vamos a ver los métodos más comunes que usará al trabajar
con delegados.

Lo primero que debe recordar es que cada delegado con el que trabaje se deriva de
MulticastDelegate . Un delegado multidifusión significa que se puede invocar más de un
destino de método al invocar en un delegado. El diseño original consideraba la
posibilidad de establecer una distinción entre los delegados en los que solo se podía
asociar e invocar un método de destino y los delegados en los que se podía asociar e
invocar varios métodos de destino. Esa distinción resultó ser menos útil en la práctica de
lo que se pensaba. Las dos clases ya estaban creadas y se han conservado en el marco
de trabajo desde la versión pública inicial.

Los métodos que usará más a menudo con los delegados son Invoke() y BeginInvoke()
/ EndInvoke() . Invoke() invocará todos los métodos que se han asociado a una
instancia de delegado en concreto. Como ya hemos visto anteriormente, por lo general
los delegados se invocan mediante la sintaxis de llamada de método en la variable de
delegado. Como verá más adelante en esta serie, hay patrones que funcionan
directamente con estos métodos.

Ahora que ha visto la sintaxis del lenguaje y las clases que admiten delegados,
examinemos cómo se usan, se crean y se invocan delegados fuertemente tipados.

Siguiente
Delegados fuertemente tipados
Artículo • 04/01/2023 • Tiempo de lectura: 3 minutos

Anterior

En el artículo anterior pudo ver que con la palabra clave delegate se crean tipos de
delegados concretos.

La clase abstracta Delegate proporciona la infraestructura para el acoplamiento flexible

y la invocación. Los tipos de delegado concretos se hacen mucho más útiles al adoptar y
aplicar la seguridad de tipos para los métodos agregados a la lista de invocación de un
objeto de delegado. Cuando se usa palabra clave delegate y se define un tipo de
delegado concreto, el compilador genera esos métodos.

En la práctica, esto daría lugar a la creación de nuevos tipos de delegado siempre que
necesitara otra firma de método. Este trabajo podría resultar tedioso pasado un tiempo.
Cada nueva característica exige nuevos tipos de delegado.

Afortunadamente, esto no es necesario. .NET Core Framework contiene varios tipos que
puede volver a usar siempre que necesite tipos de delegado. Son definiciones genéricas,
por lo que puede declarar personalizaciones cuando necesite nuevas declaraciones de
método.

El primero de estos tipos es el tipo Action y distintas variaciones:

C#

public delegate void Action();

public delegate void Action<in T>(T arg);

public delegate void Action<in T1, in T2>(T1 arg1, T2 arg2);

// Other variations removed for brevity.

El modificador in del argumento de tipo genérico se trata en el artículo sobre la

covarianza.

Hay variaciones del delegado Action que contienen hasta 16 argumentos, como
Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16>.
Es importante que
estas definiciones usen argumentos genéricos distintos para cada uno de los
argumentos del delegado: eso proporciona la máxima flexibilidad. Los argumentos de
método no tienen que ser, aunque pueden ser, del mismo tipo.

Use uno de los tipos Action para cualquier tipo de delegado que tenga un tipo de valor
devuelto void.
.NET Framework también incluye varios tipos de delegado genéricos que se pueden usar
para los tipos de delegado que devuelven valores:

C#

public delegate TResult Func<out TResult>();

public delegate TResult Func<in T1, out TResult>(T1 arg);

public delegate TResult Func<in T1, in T2, out TResult>(T1 arg1, T2 arg2);

// Other variations removed for brevity

El modificador out del argumento de tipo genérico result se trata en el artículo sobre la
covarianza.

Hay variaciones del delegado Func con hasta 16 argumentos de entrada, como
Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,TResult>.
Por convención,
el tipo del resultado siempre es el último parámetro de tipo de todas las declaraciones
Func .

Use uno de los tipos Func para cualquier tipo de delegado que devuelva un valor.

También hay un tipo Predicate<T> especializado para un delegado que devuelva una
prueba en un valor único:

C#

public delegate bool Predicate<in T>(T obj);

Es posible que observe que para cualquier tipo Predicate existe un tipo Func
estructuralmente equivalente, por ejemplo:

C#

Func<string, bool> TestForString;

Predicate<string> AnotherTestForString;

Podría llegar a pensar que estos dos tipos son equivalentes, pero no lo son.
Estas dos
variables no se pueden usar indistintamente. A una variable de un tipo no se le puede
asignar el otro tipo. El sistema de tipos de C# usa los nombres de los tipos definidos, no
la estructura.

Todas estas definiciones de tipos de delegado de la biblioteca de .NET Core deberían

significar que no es necesario definir ningún tipo de delegado nuevo para cualquier
característica nueva creada que exija delegados. Estas definiciones genéricas deberían
proporcionar todos los tipos de delegado necesarios para la mayoría de las situaciones.
Puede simplemente crear instancias de uno de estos tipos con los parámetros de tipo
necesarios. En el caso de los algoritmos que se pueden convertir en genéricos, estos
delegados se pueden usar como tipos genéricos.

Esto debería ahorrar tiempo y minimizar el número de nuevos tipos que es necesario
crear para poder trabajar con delegados.

En el siguiente artículo se verán varios patrones comunes para trabajar con delegados
en la práctica.

Siguiente
Patrones comunes para delegados
Artículo • 15/02/2023 • Tiempo de lectura: 8 minutos

Anterior

Los delegados proporcionan un mecanismo que permite que los diseños de software
supongan un acoplamiento mínimo entre los componentes.

Un ejemplo excelente de este tipo de diseño es LINQ. El patrón de expresión de

consulta LINQ se basa en los delegados para todas sus características. Considere este
ejemplo sencillo:

C#

var smallNumbers = numbers.Where(n => n < 10);

Se filtra la secuencia solo de los números que son inferiores al valor 10.
El método
Where usa un delegado que determina qué elementos de una secuencia pasan el filtro.
Cuando crea una consulta LINQ, proporciona la implementación del delegado para este
fin específico.

El prototipo para el método Where es:

C#

public static IEnumerable<TSource> Where<TSource> (this IEnumerable<TSource>

source, Func<TSource, bool> predicate);

Este ejemplo se repite con todos los métodos que forman parte de LINQ. Todos se
basan en delegados para el código que administra la consulta específica. Este modelo
de diseño de API es eficaz para obtener información y comprender.

En este ejemplo sencillo se ilustra cómo los delegados necesitan muy poco
acoplamiento entre componentes. No necesita crear una clase que derive de una clase
base determinada. No necesita implementar una interfaz específica.
El único requisito
consiste en proporcionar la implementación de un método que sea fundamental para la
tarea que nos ocupa.

Creación de sus propios componentes con

delegados
Vamos a aprovechar ese ejemplo creando un componente con un diseño que se base en
delegados.

Vamos a definir un componente que pueda usarse para mensajes de registro en un

sistema grande. Los componentes de la biblioteca pueden usarse en muchos entornos
diferentes, en varias plataformas diferentes. Existen muchas características comunes en
el componente que administra los registros. Necesitará aceptar mensajes de cualquier
componente del sistema. Esos mensajes tendrán diferentes prioridades, que el
componente principal puede administrar. Los mensajes deben tener marcas de tiempo
en su forma de archivado final. Para escenarios más avanzados, puede filtrar mensajes
por el componente de origen.

Hay un aspecto de la característica que cambiará a menudo: el lugar donde se escriben

los mensajes. En algunos entornos, pueden escribirse en la consola de errores. En otros,
en un archivo. Otras posibilidades incluyen el almacenamiento de bases de datos, los
registros de eventos del sistema operativo u otro almacenamiento de documentos.

También hay combinaciones de salida que pueden usarse en escenarios diferentes.

Puede que quiera escribir mensajes en la consola y en un archivo.

Un diseño basado en delegados proporcionará una gran flexibilidad y facilitará la

compatibilidad de mecanismos de almacenamiento que pueden agregarse en el futuro.

Con este diseño, el componente de registro principal puede ser una clase no virtual,
incluso sellada. Puede conectar cualquier conjunto de delegados para escribir los
mensajes en un medio de almacenamiento diferente. La compatibilidad integrada para
los delegados multidifusión facilita la compatibilidad de escenarios donde los mensajes
deben escribirse en varias ubicaciones (un archivo y una consola).

Una primera implementación

Comencemos poco a poco: la implementación inicial aceptará mensajes nuevos y los
escribirá con cualquier delegado asociado. Puede comenzar con un delegado que
escriba mensajes en la consola.

C#

public static class Logger

public static Action<string> WriteMessage;

public static void LogMessage(string msg)

WriteMessage(msg);

La clase estática anterior es lo más sencillo que puede funcionar. Necesitamos escribir
solo la implementación para el método que escribe mensajes en la consola:

C#

public static class LoggingMethods

public static void LogToConsole(string message)

Console.Error.WriteLine(message);

Por último, necesita conectar el delegado asociándolo al delegado WriteMessage que se

declara en el registrador:

C#

Logger.WriteMessage += LoggingMethods.LogToConsole;

Procedimientos
Hasta ahora nuestro ejemplo es bastante sencillo, pero sigue mostrando algunas
instrucciones importantes para los diseños que involucran a los delegados.

Con los tipos de delegado definidos en el marco de trabajo principal es más sencillo
para los usuarios trabajar con los delegados. No necesita definir tipos nuevos, y los
desarrolladores que usen su biblioteca no necesitan aprender nuevos tipos de delegado
especializados.

Las interfaces que se han usado son tan mínimas y flexibles como es posible: para crear
un registrador de salida nuevo, debe crear un método. Ese método puede ser un
método estático o un método de instancia. Puede tener cualquier acceso.

Formato de salida
Vamos a hacer esta primera versión un poco más sólida y, después, empezaremos a
crear otros mecanismos de registro.
Después, vamos a agregar algunos argumentos al método LogMessage() de manera que
su clase de registro cree más mensajes estructurados:

C#

public enum Severity

Verbose,

Trace,

Information,

Warning,

Error,

Critical

C#

public static class Logger

public static Action<string> WriteMessage;

public static void LogMessage(Severity s, string component, string msg)

var outputMsg = $"{DateTime.Now}\t{s}\t{component}\t{msg}";

WriteMessage(outputMsg);

A continuación, vamos a usar ese argumento Severity para filtrar los mensajes que se
envían a la salida del registro.

C#

public static class Logger

public static Action<string> WriteMessage;

public static Severity LogLevel {get;set;} = Severity.Warning;

public static void LogMessage(Severity s, string component, string msg)

if (s < LogLevel)

return;

var outputMsg = $"{DateTime.Now}\t{s}\t{component}\t{msg}";

WriteMessage(outputMsg);

Procedimientos
Ha agregado características nuevas a la infraestructura de registro. Como el
componente del registrador se acopla débilmente a cualquier mecanismo de salida,
estas características nuevas pueden agregarse sin afectar a ningún código que
implementa el delegado del registrador.

A medida que siga creando esto, verá más ejemplos de cómo este acoplamiento débil
permite una mayor flexibilidad en la actualización de las partes del sitio sin que haya
cambios en otras ubicaciones. De hecho, en una aplicación más grande, las clases de
salida del registrador pueden estar en un ensamblado diferente, y ni siquiera necesitan
volver a crearse.

Creación de un segundo motor de salida

El componente de registro se está desarrollando correctamente. Vamos a agregar un
motor de salida más que registre mensajes en un archivo. Este será un motor de salida
ligeramente más involucrado. Será una clase que encapsule las operaciones de archivo y
garantice que el archivo esté siempre cerrado después de cada escritura. Eso garantiza
que todos los datos se vacíen en el disco después de que se genere cada mensaje.

Aquí se muestra ese registrador basado en archivos:

C#

public class FileLogger

{

private readonly string logPath;

public FileLogger(string path)

logPath = path;

Logger.WriteMessage += LogMessage;

public void DetachLog() => Logger.WriteMessage -= LogMessage;

// make sure this can't throw.

private void LogMessage(string msg)

try

using (var log = File.AppendText(logPath))

log.WriteLine(msg);

log.Flush();

catch (Exception)

// Hmm. We caught an exception while

// logging. We can't really log the

// problem (since it's the log that's failing).

// So, while normally, catching an exception

// and doing nothing isn't wise, it's really the

// only reasonable option here.

Una vez que haya creado esta clase, puede inicializarla y esta asocia su método
LogMessage al componente de registrador:

C#

var file = new FileLogger("log.txt");

Estos dos no son mutuamente exclusivos. Puede asociar ambos métodos de registro y
generar mensajes en la consola y en un archivo:

C#

var fileOutput = new FileLogger("log.txt");

Logger.WriteMessage += LoggingMethods.LogToConsole; // LoggingMethods is the

static class we utilized earlier

Después, incluso en la misma aplicación, puede quitar uno de los delegados sin
ocasionar ningún otro problema en el sistema:

C#

Logger.WriteMessage -= LoggingMethods.LogToConsole;

Procedimientos
Ahora, ha agregado un segundo controlador de salida para el subsistema de registro.
Este necesita un poco más de infraestructura para admitir correctamente el sistema de
archivos. El delegado es un método de instancia. También es un método privado.
No
existe ninguna necesidad de una mayor accesibilidad porque la infraestructura de
delegado puede conectarse a los delegados.

En segundo lugar, el diseño basado en delegados permite varios métodos de salida sin
ningún código adicional. No necesita crear ninguna infraestructura adicional para
admitir varios métodos de salida. Simplemente se convierten en otro método en la lista
de invocación.

Preste una atención especial al código del método de salida de registro de archivo. Se
codifica para garantizar que no produce ninguna excepción. Aunque esto no siempre es
estrictamente necesario, a menudo es un buen procedimiento. Si cualquiera de los
métodos de delegado produce una excepción, los delegados restantes que se
encuentran en la invocación no se invocarán.

Como última observación, el registrador de archivos debe administrar sus recursos

abriendo y cerrando el archivo en cada mensaje de registro. Puede optar por mantener
el archivo abierto e implementar IDisposable para cerrar el archivo cuando termine.
Cualquier método tiene sus ventajas e inconvenientes. Ambos crean un poco más de
acoplamiento entre las clases.

Ninguna parte del código de la clase Logger tendrá que actualizarse para admitir
cualquiera de los escenarios.

Control de delegados null

Por último, vamos a actualizar el método LogMessage de manera que sea sólido para
esos casos en los que no se selecciona ningún mecanismo de salida. La implementación
actual producirá NullReferenceException cuando el delegado WriteMessage no tenga
una lista de invocación asociada.
Puede que prefiera un diseño que continúe
silenciosamente cuando no se haya asociado ningún método. Esto es sencillo con el
operador condicional NULL, combinado con el método Delegate.Invoke() :

C#

public static void LogMessage(string msg)

WriteMessage?.Invoke(msg);

El operador condicional NULL ( ?. ) crea un cortocircuito cuando el operando izquierdo

( WriteMessage en este caso) es NULL, lo que significa que no se realiza ningún intento
para registrar un mensaje.

No encontrará el método Invoke() en la documentación de System.Delegate o

System.MulticastDelegate . El compilador genera un método Invoke con seguridad de
tipos para cualquier tipo de delegado declarado. En este ejemplo, eso significa que
Invoke toma un solo argumento string y tiene un tipo de valor devuelto void.
Resumen de procedimientos
Ha observado los comienzos de un componente de registro que puede expandirse con
otros sistemas de escritura y otras características. Al usar delegados en el diseño, estos
distintos componentes están acoplados débilmente. Esto ofrece varias ventajas. Es
sencillo crear mecanismos de salida nuevos y asociarlos al sistema. Estos otros
mecanismos solo necesitan un método: el método que escribe el mensaje de registro. Es
un diseño que es resistente cuando se agregan características nuevas. El contrato que se
necesita para cualquier sistema de escritura es implementar un método. Ese método
puede ser un método estático o de instancia. Puede ser público, privado o de cualquier
otro acceso legal.

La clase de registrador puede realizar cualquier número de cambios o mejoras sin

producir cambios importantes. Como cualquier clase, no puede modificar la API pública
sin el riesgo de que se produzcan cambios importantes. Pero, como el acoplamiento
entre el registrador y cualquier motor de salida se realiza solo mediante el delegado,
ningún otro tipo (como interfaces o clases base) está involucrado. El acoplamiento es lo
más pequeño posible.

Siguiente
Introducción a los eventos
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Anterior

Los eventos son, como los delegados, un mecanismo de enlace en tiempo de ejecución.
De hecho, los eventos se crean con compatibilidad de lenguaje para los delegados.

Los eventos son una manera para que un objeto difunda (a todos los componentes
interesados del sistema) que algo ha sucedido. Cualquier otro componente puede
suscribirse al evento, y recibir una notificación cuando se genere uno.

Probablemente ha usado eventos en alguna programación. Muchos sistemas gráficos

tienen un modelo de eventos para notificar la interacción del usuario. Estos eventos
notificarán movimiento del mouse, pulsaciones de botón e interacciones similares. Ese
es uno de los más comunes, pero realmente no es el único escenario donde se usan
eventos.

Puede definir eventos que deben generarse para las clases. Una consideración
importante a la hora de trabajar con eventos es que puede que no haya ningún objeto
registrado para un evento determinado. Debe escribir el código de manera que no
genere eventos cuando no esté configurado ningún agente de escucha.

La suscripción a un evento también crea un acoplamiento entre dos objetos (el origen
del evento y el receptor del evento). Necesita asegurarse de que el receptor del evento
cancela la suscripción del origen del evento cuando ya no está interesado en eventos.

Diseño de objetivos para la compatibilidad con

eventos
El diseño del lenguaje para eventos tiene como destino estos objetivos:

Permita un acoplamiento mínimo entre un origen de eventos y un receptor de

eventos. Estos dos componentes puede que no se hayan escrito por la misma
organización e incluso pueden actualizarse en programaciones totalmente
diferentes.

Debe ser muy sencillo suscribirse a un evento y cancelar la suscripción de este.

Los orígenes de eventos deben admitir varios suscriptores de eventos. También

deben admitir no tener ningún suscriptor de eventos asociado.
Puede observar que los objetivos de los eventos son muy similares a los de los
delegados.
Este es el motivo por el que la compatibilidad del lenguaje de eventos se
basa en la compatibilidad del lenguaje de delegados.

Compatibilidad del lenguaje para eventos

La sintaxis para definir eventos, y suscribirse o cancelar la suscripción de eventos, es una
extensión de la sintaxis de los delegados.

Para definir un evento, use la palabra clave event :

C#

public event EventHandler<FileListArgs> Progress;

El tipo del evento ( EventHandler<FileListArgs> en este ejemplo) debe ser un tipo de

delegado. Existen varias convenciones que debe seguir al declarar un evento.
Normalmente, el tipo de delegado de eventos tiene un valor devuelto void.
Las
declaraciones de eventos deben ser un verbo o una frase verbal.
Use un tiempo verbal
pasado cuando el evento notifique algo que ha ocurrido. Use un tiempo verbal presente
(por ejemplo, Closing ) para notificar algo que está a punto de suceder. A menudo, el
uso del tiempo presente indica que su clase admite algún tipo de comportamiento de
personalización. Uno de los escenarios más comunes es admitir la cancelación. Por
ejemplo, un evento Closing puede incluir un argumento que indicará si la operación de
cierre debe continuar o no. Otros escenarios pueden permitir que los autores de la
llamada modifiquen el comportamiento actualizando propiedades de los argumentos
de eventos. Puede generar un evento para indicar la siguiente acción propuesta que
realizará un algoritmo. El controlador de eventos puede exigir una acción diferente
modificando las propiedades del argumento de eventos.

Cuando quiera generar el evento, llame a los controladores de eventos mediante la

sintaxis de invocación del delegado:

C#

Progress?.Invoke(this, new FileListArgs(file));

Como se ha tratado en la sección sobre delegados, el operador ?.

hace que se garantice
más fácilmente que no intenta generar el evento cuando no existen suscriptores en este.

Se suscribe a un evento con el operador += :

 C#

EventHandler<FileListArgs> onProgress = (sender, eventArgs) =>

Console.WriteLine(eventArgs.FoundFile);

fileLister.Progress += onProgress;

El método de controlador normalmente tiene el prefijo "On" seguido del nombre del
evento, como se ha mostrado anteriormente.

Cancela la suscripción con el operador -= :

C#

fileLister.Progress -= onProgress;

Es importante que declare una variable local para la expresión que representa el
controlador de eventos. Eso garantiza que la cancelación de la suscripción quita el
controlador.
Si, en su lugar, ha usado el cuerpo de la expresión lambda, está intentando
quitar un controlador que nunca ha estado asociado, lo que no produce ninguna acción.

En el artículo siguiente, obtendrá más información sobre los modelos de eventos típicos
y las diferentes variaciones de este ejemplo.

Siguiente
Patrón de eventos estándar de .NET
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

Anterior

Los eventos de .NET generalmente siguen unos patrones conocidos. Estandarizar sobre
estos patrones significa que los desarrolladores pueden aprovechar el conocimiento de
esos patrones estándar, que se pueden aplicar a cualquier programa de evento de .NET.

Vamos a analizar los patrones estándar, para que tenga todos los conocimientos
necesarios para crear orígenes de eventos estándar y suscribirse y procesar eventos
estándar en el código.

Firmas de delegado de eventos

La firma estándar de un delegado de eventos de .NET es:

C#

void EventRaised(object sender, EventArgs args);

El tipo de valor devuelto es void. Los eventos se basan en delegados y son delegados de
multidifusión. Eso admite varios suscriptores para cualquier origen de eventos. El único
valor devuelto de un método no escala a varios suscriptores de eventos. ¿Qué valor
devuelto ve el origen de evento después de generar un evento? Más adelante en este
artículo verá cómo crear protocolos de evento que admiten suscriptores de eventos que
notifican información al origen del evento.

La lista de argumentos contiene dos argumentos: el remitente y los argumentos del

evento. El tipo de tiempo de compilación de sender es System.Object , aunque
probablemente conozca un tipo más derivado que siempre será correcto. Por
convención, use object .

Típicamente, el segundo argumento era un tipo que se derivaba de System.EventArgs .

(Verá en la sección siguiente que esta convención ya no se aplica). Si el tipo de evento
no necesita ningún argumento adicional, seguirá proporcionando ambos argumentos.
Hay un valor especial, EventArgs.Empty , que debe usarse para indicar que el evento no
contiene ninguna información adicional.

Vamos a crear una clase que enumera los archivos en un directorio, o cualquiera de sus
subdirectorios que siguen un patrón. Este componente genera un evento para cada
archivo encontrado que coincida con el modelo.

El uso de un modelo de eventos proporciona algunas ventajas de diseño. Se pueden

crear varios agentes de escucha de eventos que realicen acciones diferentes cuando se
encuentre un archivo buscado. La combinación de los distintos agentes de escucha
puede crear algoritmos más sólidos.

Esta es la declaración del argumento de evento inicial para buscar un archivo buscado:

C#

public class FileFoundArgs : EventArgs

public string FoundFile { get; }

public FileFoundArgs(string fileName) => FoundFile = fileName;

Aunque este tipo parece un tipo pequeño exclusivo para datos, debe seguir la
convención y convertirlo en un tipo de referencia ( class ). Esto significa que el objeto de
argumento se pasará por referencia y que todos los suscriptores verán las
actualizaciones de los datos. La primera versión es un objeto inmutable. Es preferible
hacer que las propiedades en el tipo de argumento de evento sean inmutables. De ese
modo, un suscriptor no puede cambiar los valores antes de que los vea otro suscriptor.
(Hay excepciones, como verá a continuación).

Después, debemos crear la declaración de evento en la clase FileSearcher.

Aprovechando el tipo EventHandler<T> , no es necesario crear otra definición de tipo
más. Simplemente se puede usar una especialización genérica.

Vamos a rellenar la clase FileSearcher para buscar archivos que coincidan con un patrón
y generar el evento correcto cuando se detecte una coincidencia.

C#

public class FileSearcher

public event EventHandler<FileFoundArgs> FileFound;

public void Search(string directory, string searchPattern)

foreach (var file in Directory.EnumerateFiles(directory,

searchPattern))

RaiseFileFound(file);
}

private void RaiseFileFound(string file) =>

FileFound?.Invoke(this, new FileFoundArgs(file));

Definición y generación de eventos similares a

campos
La manera más sencilla de agregar un evento a la clase es declarar ese evento como un
campo público, como en el ejemplo anterior:

C#

public event EventHandler<FileFoundArgs> FileFound;

Parece que se está declarando un campo público, lo que podría parecer una práctica
orientada a objetos incorrecta. Quiere proteger el acceso a los datos a través de
propiedades o métodos. Aunque esto puede parecer una mala práctica, el código
generado por el compilador crea contenedores para que solo se pueda acceder de
forma segura a los objetos de evento. Las únicas operaciones disponibles en un evento
con aspecto de campo son las de agregar controlador:

C#

var fileLister = new FileSearcher();

int filesFound = 0;

EventHandler<FileFoundArgs> onFileFound = (sender, eventArgs) =>

Console.WriteLine(eventArgs.FoundFile);

filesFound++;

};

fileLister.FileFound += onFileFound;

y quitar controlador:

C#

fileLister.FileFound -= onFileFound;

Tenga en cuenta que hay una variable local para el controlador. Si usó el cuerpo de la
expresión lambda, la eliminación no funcionará correctamente. Sería una instancia
diferente del delegado y, en modo silencioso, no se hace nada.
El código fuera de la clase no puede generar el evento, ni puede realizar otras
operaciones.

Devolución de valores de suscriptores de

eventos
La versión simple funciona correctamente. Vamos a agregar otra característica: la
cancelación.

Cuando se genera el evento encontrado, los agentes de escucha deberían ser capaces
de detener el procesamiento, si este archivo es el último que se busca.

Los controladores de eventos no devuelven un valor, por lo que se necesita comunicarlo

de otra forma. El patrón de eventos estándar usa el objeto EventArgs para incluir
campos que los suscriptores de eventos pueden usar para comunicar la cancelación.

Existen dos patrones diferentes que podrían usarse, basándose en la semántica del
contrato de cancelación. En ambos casos, se agrega un campo booleano a
EventArguments para el evento del archivo encontrado.

Uno de los patrones permitiría a cualquier suscriptor cancelar la operación. Para este
patrón, el nuevo campo se inicializa en false . Los suscriptores pueden cambiarlo a
true . Después de que todos los suscriptores hayan visto el evento generado, el

componente FileSearcher examina el valor booleano y toma medidas.

El segundo patrón solo debería cancelar la operación si todos los suscriptores quieren
que se cancele. En este patrón, el nuevo campo se inicializa para indicar que se debe
cancelar la operación y cualquier suscriptor puede modificarlo para indicar que la
operación debe continuar. Después de que todos los suscriptores hayan visto el evento
generado, el componente FileSearcher examina el valor booleano y toma medidas. Hay
un paso adicional en este patrón: el componente necesita saber si los suscriptores
vieron el evento. Si no hay ningún suscriptor, el campo indicaría incorrectamente una
cancelación.

Vamos a implementar la primera versión de este ejemplo. Debe agregar un campo

booleano denominado CancelRequested al tipo FileFoundArgs :

C#

public class FileFoundArgs : EventArgs

public string FoundFile { get; }

public bool CancelRequested { get; set; }

 public FileFoundArgs(string fileName) => FoundFile = fileName;

Este nuevo campo se inicializa automáticamente en false , el valor predeterminado de

un campo Boolean , por lo que no se cancela accidentalmente. El otro cambio en el
componente consiste en comprobar el indicador después de generar el evento para ver
si alguno de los suscriptores solicitó una cancelación:

C#

private void SearchDirectory(string directory, string searchPattern)

foreach (var file in Directory.EnumerateFiles(directory, searchPattern))

FileFoundArgs args = RaiseFileFound(file);

if (args.CancelRequested)
{

break;

private FileFoundArgs RaiseFileFound(string file)

var args = new FileFoundArgs(file);

FileFound?.Invoke(this, args);

return args;

Una ventaja de este patrón es que no supone un cambio brusco. Ninguno de los
suscriptores solicitó una cancelación antes y siguen sin hacerlo. No debe actualizarse el
código de ningún suscriptor a menos que quieran admitir el nuevo protocolo de
cancelación. Está acoplado muy holgadamente.

Vamos a actualizar el suscriptor para que solicite una cancelación una vez que encuentra
el primer ejecutable:

C#

EventHandler<FileFoundArgs> onFileFound = (sender, eventArgs) =>

Console.WriteLine(eventArgs.FoundFile);

eventArgs.CancelRequested = true;

};

Adición de otra declaración de evento

Vamos a agregar una característica más y demostrar otras expresiones de lenguaje para
los eventos. Vamos a agregar una sobrecarga del método Search que recorre todos los
subdirectorios en busca de archivos.

Podría llegar a ser una operación de larga duración si el directorio tuviese muchos
subdirectorios. Vamos a agregar un evento que se genera cuando comienza cada nueva
búsqueda en el directorio. Esto permite a los suscriptores realizar el seguimiento y
actualizar al usuario sobre el progreso. Todos los ejemplos creados hasta ahora son
públicos. Convertiremos este evento en un evento interno. Eso significa que también se
pueden convertir en internos los tipos que se usan para los argumentos.

Comenzará creando la nueva clase derivada de EventArgs para informar del nuevo
directorio y del progreso.

C#

internal class SearchDirectoryArgs : EventArgs

internal string CurrentSearchDirectory { get; }

internal int TotalDirs { get; }

internal int CompletedDirs { get; }

internal SearchDirectoryArgs(string dir, int totalDirs, int

completedDirs)

CurrentSearchDirectory = dir;

TotalDirs = totalDirs;

CompletedDirs = completedDirs;

De nuevo, puede seguir las recomendaciones para crear un tipo de referencia inmutable
para los argumentos de evento.

Después, defina el evento. Esta vez, usará una sintaxis diferente. Además de usar la
sintaxis de campos, puede crear explícitamente la propiedad con controladores add y
remove. En este ejemplo, no necesitará código adicional en los controladores, pero aquí
se muestra cómo se crean.

C#

internal event EventHandler<SearchDirectoryArgs> DirectoryChanged

add { _directoryChanged += value; }

remove { _directoryChanged -= value; }

private EventHandler<SearchDirectoryArgs> _directoryChanged;

En muchos aspectos, el código que se escribe aquí refleja el código que genera el
compilador para las definiciones de evento de campo que se vieron anteriormente. El
evento se crea mediante una sintaxis muy similar a la que se usó para las propiedades.
Tenga en cuenta que los controladores tienen nombres diferentes: add y remove . Se
llaman para suscribirse al evento o para cancelar la suscripción al evento. Tenga en
cuenta que también debe declarar un campo de respaldo privado para almacenar la
variable de evento. Se inicializa en null.

Después, se agregará la sobrecarga del método Search que recorre los subdirectorios y
genera los dos eventos. La manera más fácil de hacerlo consiste en usar un argumento
predeterminado para especificar que se quiere buscar en todos los directorios:

C#

public void Search(string directory, string searchPattern, bool

searchSubDirs = false)

if (searchSubDirs)

var allDirectories = Directory.GetDirectories(directory, "*.*",

SearchOption.AllDirectories);

var completedDirs = 0;

var totalDirs = allDirectories.Length + 1;

foreach (var dir in allDirectories)

RaiseSearchDirectoryChanged(dir, totalDirs, completedDirs++);

// Search 'dir' and its subdirectories for files that match the
search pattern:

SearchDirectory(dir, searchPattern);

// Include the Current Directory:

RaiseSearchDirectoryChanged(directory, totalDirs, completedDirs++);

SearchDirectory(directory, searchPattern);

else

SearchDirectory(directory, searchPattern);

private void SearchDirectory(string directory, string searchPattern)

foreach (var file in Directory.EnumerateFiles(directory, searchPattern))

FileFoundArgs args = RaiseFileFound(file);

if (args.CancelRequested)
 {

break;

private void RaiseSearchDirectoryChanged(

string directory, int totalDirs, int completedDirs) =>

_directoryChanged?.Invoke(

this,

new SearchDirectoryArgs(directory, totalDirs, completedDirs));

private FileFoundArgs RaiseFileFound(string file)

var args = new FileFoundArgs(file);

FileFound?.Invoke(this, args);

return args;

En este punto, puede ejecutar la aplicación mediante la llamada a la sobrecarga para

buscar en todos los subdirectorios. No hay ningún suscriptor en el nuevo evento
DirectoryChanged , pero al usar el elemento ?.Invoke() se garantiza que esto funciona

correctamente.

Vamos a agregar un controlador para escribir una línea que muestre el progreso en la
ventana de la consola.

C#

fileLister.DirectoryChanged += (sender, eventArgs) =>

Console.Write($"Entering '{eventArgs.CurrentSearchDirectory}'.");

Console.WriteLine($" {eventArgs.CompletedDirs} of {eventArgs.TotalDirs}

completed...");

};

Ha visto los patrones que se siguen en todo el ecosistema de. NET. El aprendizaje de
estos patrones y convenciones le permitirá escribir elementos de C# y .NET
rápidamente.

Vea también
Introducción a los eventos
Diseño de eventos
Control y generación de eventos
Más adelante verá algunos cambios en estos patrones en la versión más reciente de.
NET.

Siguiente
Patrón de eventos actualizado de .NET
Core
Artículo • 14/02/2023 • Tiempo de lectura: 4 minutos

Anterior

En el artículo anterior se describían los patrones de eventos más comunes. .NET Core
tiene un patrón menos estricto. En esta versión, la definición EventHandler<TEventArgs>
ya no tiene la restricción que obliga a que TEventArgs sea una clase derivada de
System.EventArgs .

Esto aumenta la flexibilidad y es compatible con versiones anteriores. Comencemos con

la flexibilidad. La clase System.EventArgs introduce un método, MemberwiseClone() , que
crea una copia superficial del objeto.
Dicho método debe usar la reflexión para
implementar su función en cualquier clase derivada de EventArgs . Esta funcionalidad es
más fácil de crear en una clase derivada concreta. Esto significa que derivar de
System.EventArgs es una restricción que limita los diseños, pero no proporciona
ninguna ventaja adicional.
De hecho, puede cambiar las definiciones de FileFoundArgs y
SearchDirectoryArgs para que no deriven de EventArgs .
El programa funcionará

exactamente igual.

También puede cambiar SearchDirectoryArgs a un struct si realiza un cambio más:

C#

internal struct SearchDirectoryArgs

internal string CurrentSearchDirectory { get; }

internal int TotalDirs { get; }

internal int CompletedDirs { get; }

internal SearchDirectoryArgs(string dir, int totalDirs, int

completedDirs) : this()
{

CurrentSearchDirectory = dir;

TotalDirs = totalDirs;

CompletedDirs = completedDirs;

El cambio adicional consiste en llamar al constructor sin parámetros antes de entrar en

el constructor que inicializa todos los campos. Sin esta adición, las reglas de C#
informarán de que se está teniendo acceso a las propiedades antes de que se hayan
asignado.

No debe cambiar FileFoundArgs de una clase (tipo de referencia) a un struct (tipo de

valor). Esto se debe a que el protocolo para controlar la cancelación requiere que los
argumentos de evento se pasen por referencia. Si realizase el mismo cambio, la clase de
búsqueda de archivos no podría observar nunca los cambios realizados por ninguno de
los suscriptores de eventos. Se usaría una nueva copia de la estructura para cada
suscriptor, y dicha copia sería diferente de la que ve el objeto de búsqueda de archivos.

Ahora veamos cómo este cambio puede ser compatible con versiones anteriores.
La
eliminación de la restricción no afecta al código existente. Los tipos de argumento de
evento existentes siguen derivando de System.EventArgs .
La compatibilidad con
versiones anteriores es uno de los motivos principales por los que siguen derivando de
System.EventArgs . Los suscriptores de eventos existentes serán suscriptores a un evento

que haya seguido el patrón clásico.

Según una lógica similar, cualquier tipo de argumento de evento creado ahora no
tendría ningún suscriptor en el código base existente. Los nuevos tipos de evento que
no deriven de System.EventArgs no interrumpirán ese código base.

Eventos con suscriptores Async

Todavía debe aprender un último patrón: cómo escribir correctamente suscriptores de
eventos que llaman a código asincrónico. Este reto se describe en el artículo sobre async
y await. Los métodos asincrónicos pueden tener un tipo de valor devuelto void, pero
esto no es recomendable. Cuando el código de suscriptor de eventos llama a un
método asincrónico, no le queda otra opción que crear un método async void , ya que
lo requiere la firma del controlador de eventos.

Debe conciliar estas instrucciones contradictorias. De alguna manera, debe crear un

método async void seguro. A continuación se muestran los aspectos básicos del patrón
que debe implementar:

C#

worker.StartWorking += async (sender, eventArgs) =>

try

await DoWorkAsync();

catch (Exception e)

 //Some form of logging.

Console.WriteLine($"Async task failure: {e.ToString()}");

// Consider gracefully, and quickly exiting.

};

En primer lugar, observe que el controlador está marcado como un controlador

asincrónico. Dado que se va a asignar a un tipo de delegado de controlador de eventos,
tendrá un tipo de valor devuelto void. Esto significa que debe seguir el patrón que se
muestra en el controlador y no debe permitir que se produzca ninguna excepción fuera
del contexto del controlador asincrónico. Como no devuelve una tarea, no hay ninguna
tarea que pueda notificar el error entrando en el estado de error. Dado que el método
es asincrónico, no puede producir la excepción. (El método de llamada tiene una
ejecución continua porque es async ). El comportamiento real del entorno de ejecución
se definirá de forma diferente para distintos entornos. Se puede terminar el subproceso
o el proceso que posee el subproceso, o dejar el proceso en un estado indeterminado.
Todas estas salidas potenciales son altamente no deseables.

Por eso debe encapsular la instrucción await para la tarea asincrónica en su propio
bloque try. Si esto genera una tarea con error, puede registrar el error. Si se produce un
error del que no se puede recuperar la aplicación, puede salir del programa de forma
rápida y correctamente.

Estas son las principales actualizaciones del patrón de eventos de .NET. Verá numerosos
ejemplos de las versiones anteriores de las bibliotecas con las que trabaje. Aun así,
también debe entender los patrones más recientes.

El siguiente artículo de esta serie le ayudará a distinguir entre el uso de delegates y

events en los diseños. Dado que se trata de conceptos similares, el artículo le ayudará a

tomar la mejor decisión para sus programas.

Siguiente
Distinción de delegados y eventos
Artículo • 04/01/2023 • Tiempo de lectura: 3 minutos

Anterior

Los desarrolladores que son nuevos en la plataforma de NET Core a menudo tienen
problemas para decidir entre un diseño basado en delegates y uno basado en events .
La elección de delegados o eventos suele ser difícil, ya que las dos características de
lenguaje son similares. Los eventos incluso se crean con compatibilidad de lenguaje
para los delegados.

Ambos ofrecen un escenario de enlace en tiempo de ejecución: permiten escenarios

donde un componente se comunica llamando a un método que solo se conoce en
tiempo de ejecución. Ambos admiten métodos de suscriptor único y múltiple. Puede
que se haga referencia a estos términos como compatibilidad con multidifusión o de
conversión única. Ambos admiten una sintaxis similar para agregar y quitar
controladores. Por último, para generar un evento y llamar a un delegado se usa
exactamente la misma sintaxis de llamada de método. Incluso los dos admiten la misma
sintaxis del método Invoke() para su uso con el operador ?. .

Con todas estas similitudes, es fácil tener problemas para determinar cuándo usar cada
uno.

La escucha de eventos es opcional

La consideración más importante para determinar qué característica de lenguaje usar es
si debe haber o no un suscriptor adjunto. Si el código debe llamar al código
proporcionado por el suscriptor, debe usar un diseño basado en delegados donde
necesita implementar la devolución de llamada. Si el código puede completar todo su
trabajo sin llamar a ningún suscriptor, debe usar un diseño basado en eventos.

Tenga en cuenta los ejemplos que se crean en esta sección. Al código que ha creado
con List.Sort() se le debe proporcionar una función de comparador para ordenar los
elementos de manera adecuada. Las consultas LINQ deben proporcionarse con
delegados para determinar qué elementos se van a devolver. Ambos han usado un
diseño creado con delegados.

Considere el evento Progress . Notifica el progreso de una tarea.

La tarea continúa haya
o no agentes de escucha.
FileSearcher es otro ejemplo. Todavía buscaría y encontraría
todos los archivos que se han solicitado, incluso sin ningún suscriptor de eventos
adjunto.
Los controles de UX todavía funcionan correctamente, incluso cuando no hay
ningún suscriptor escuchando los eventos. Ambos usan diseños basados en eventos.

Los valores devueltos necesitan delegados

Otra consideración es el prototipo del método que quiere para el método delegado.
Como ha visto, todos los delegados que se han usado para los eventos tienen un tipo
de valor devuelto void. También ha visto que hay elementos para crear controladores de
eventos que pasan información de nuevo a los orígenes de eventos mediante la
modificación de las propiedades del objeto de argumento del evento. Aunque estos
elementos funcionan, no son tan naturales como la devolución de un valor de un
método.

Observe que estas dos heurísticas suelen estar presentes: si el método delegado
devuelve un valor, lo más probable es que afecte de algún modo al algoritmo.

Los eventos tienen invocación privada

Las clases distintas de la clase en la que se encuentra un evento solo pueden agregar y
quitar clientes de escucha de eventos; solo la clase que contiene el evento puede
invocarlo. Los eventos suelen ser miembros de clase públicos.
En cambio, a menudo los
delegados se pasan como parámetros y se almacenan como miembros de clase privada
si no están almacenados.

Los agentes de escucha de eventos a menudo

tienen una vigencia mayor
El hecho de que esos clientes de escucha de eventos tengan una duración más larga es
una justificación ligeramente más débil. En cambio, puede encontrar que los diseños
basados en eventos son más naturales cuando el origen de eventos generará eventos
durante un período de tiempo largo. Puede ver ejemplos de diseño basado en eventos
para los controles de la experiencia del usuario en muchos sistemas. Cuando se suscriba
a un evento, el origen de eventos puede generar eventos durante la vigencia del
programa.
(Puede anular la suscripción de los eventos cuando ya no los necesite).

Compare eso con muchos diseños basados en delegados, donde un delegado se usa
como un argumento para un método, y el delegado no se usa después de que se
devuelva ese método.
Evaluar cuidadosamente
Las consideraciones anteriores no son reglas rápidas ni estrictas. En su lugar,
representan instrucciones que pueden ayudarle a decidir qué opción es mejor para su
uso particular. Como son similares, incluso puede crear un prototipo de los dos y
considerar con cuál sería más natural trabajar. Ambos controlan escenarios de enlace en
tiempo de ejecución correctamente. Use el que comunique mejor su diseño.
Language-Integrated Query (LINQ)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Language-Integrated Query (LINQ) es el nombre de un conjunto de tecnologías basadas

en la integración de capacidades de consulta directamente en el lenguaje C#.
Tradicionalmente, las consultas con datos se expresaban como cadenas simples sin
comprobación de tipos en tiempo de compilación ni compatibilidad con IntelliSense.
Además, tendrá que aprender un lenguaje de consulta diferente para cada tipo de
origen de datos: bases de datos SQL, documentos XML, varios servicios web y así
sucesivamente. Con LINQ, una consulta es una construcción de lenguaje de primera
clase, como clases, métodos y eventos.

Para un desarrollador que escribe consultas, la parte más visible de "lenguaje integrado"
de LINQ es la expresión de consulta. Las expresiones de consulta se escriben con una
sintaxis de consulta declarativa. Con la sintaxis de consulta, puede realizar operaciones
de filtrado, ordenación y agrupamiento en orígenes de datos con el mínimo código.
Utilice los mismos patrones de expresión de consulta básica para consultar y
transformar datos de bases de datos SQL, conjuntos de datos de ADO .NET, secuencias
y documentos XML y colecciones. NET.

En el ejemplo siguiente se muestra la operación de consulta completa. La operación

completa incluye crear un origen de datos, definir la expresión de consulta y ejecutar la
consulta en una instrucción foreach .

C#

// Specify the data source.

int[] scores = { 97, 92, 81, 60 };

// Define the query expression.

IEnumerable<int> scoreQuery =

from score in scores

where score > 80

select score;

// Execute the query.

foreach (int i in scoreQuery)

Console.Write(i + " ");

// Output: 97 92 81

Información general sobre la expresión de

consulta
Las expresiones de consulta se pueden utilizar para consultar y transformar los
datos de cualquier origen de datos habilitado para LINQ. Por ejemplo, una sola
consulta puede recuperar datos de una base de datos SQL y generar una secuencia
XML como salida.

Las expresiones de consulta son fáciles de controlar porque usan muchas

construcciones familiares del lenguaje C#.

Todas las variables de una expresión de consulta están fuertemente tipadas,

aunque en muchos casos no es necesario proporcionar el tipo explícitamente
porque el compilador puede deducirlo. Para más información, vea Relaciones entre
tipos en operaciones de consulta LINQ.

Una consulta no se ejecuta hasta que no se realiza la iteración a través de la

variable de consulta, por ejemplo, en una instrucción foreach . Para más
información, vea Introducción a las consultas LINQ.

En tiempo de compilación, las expresiones de consulta se convierten en llamadas

al método de operador de consulta estándar según las reglas establecidas en la
especificación de C#. Cualquier consulta que se puede expresar con sintaxis de
consulta también se puede expresar mediante sintaxis de método. Sin embargo, en
la mayoría de los casos, la sintaxis de consulta es más legible y concisa. Para más
información, vea Especificación del lenguaje C# e Información general sobre
operadores de consulta estándar.

Como regla al escribir consultas LINQ, se recomienda utilizar la sintaxis de consulta

siempre que sea posible y la sintaxis de método cuando sea necesario. No hay
diferencias semánticas ni de rendimiento entre estas dos formas diversas. Las
expresiones de consulta suelen ser más legibles que las expresiones equivalentes
escritas con la sintaxis de método.

Algunas operaciones de consulta, como Count o Max, no tienen ninguna cláusula

de expresión de consulta equivalente, de modo que deben expresarse como una
llamada de método. La sintaxis de método se puede combinar con la sintaxis de
consulta de varias maneras. Para más información, vea Sintaxis de consultas y
sintaxis de métodos en LINQ.

Las expresiones de consulta pueden compilarse en árboles de expresión o en

delegados, en función del tipo al que se aplica la consulta. Las consultas
 IEnumerable<T> se compilan en delegados. Las consultas IQueryable y
IQueryable<T> se compilan en árboles de expresión. Para más información, vea
Árboles de expresión.

Pasos siguientes
Para obtener más información sobre LINQ, empiece a familiarizarse con algunos
conceptos básicos en Conceptos básicos de las expresiones de consultas y, después, lea
la documentación de la tecnología de LINQ en la que esté interesado:

Documentos XML: LINQ to XML

ADO.NET Entity Framework: LINQ to Entities

Colecciones .NET, archivos y cadenas, entre otros: LINQ to Objects

Para comprender mejor los aspectos generales de LINQ, vea LINQ in C# (LINQ en C#).

Para empezar a trabajar con LINQ en C#, vea el tutorial Trabajar con LINQ.
Conceptos básicos de las expresiones de
consultas
Artículo • 15/02/2023 • Tiempo de lectura: 13 minutos

En este artículo se presentan los conceptos básicos relacionados con las expresiones de
consulta en C#.

¿Qué es una consulta y qué hace?

Una consulta es un conjunto de instrucciones que describen qué datos se recuperan de
uno o varios orígenes de datos determinados y qué forma y qué organización deben
tener los datos devueltos. Una consulta es distinta de los resultados que genera.

Por lo general, los datos de origen se organizan lógicamente como una secuencia de
elementos del mismo tipo. Por ejemplo, una tabla de base de datos SQL contiene una
secuencia de filas. En un archivo XML, hay una "secuencia" de elementos XML (aunque
estos se organizan jerárquicamente en una estructura de árbol). Una colección en
memoria contiene una secuencia de objetos.

Desde el punto de vista de la aplicación, el tipo y la estructura específicos de los datos

de origen originales no es importante. La aplicación siempre ve los datos de origen
como una colección IEnumerable<T> o IQueryable<T>. Por ejemplo, en LINQ to XML,
los datos de origen se hacen visibles como IEnumerable <XElement>.

Dada esta secuencia de origen, una consulta puede hacer una de estas tres cosas:

Recuperar un subconjunto de los elementos para generar una nueva secuencia sin
modificar los elementos individuales. Después, la consulta puede ordenar o
agrupar la secuencia devuelta de varias maneras, como se muestra en el ejemplo
siguiente (supongamos que scores es int[] ):

C#

IEnumerable<int> highScoresQuery =

from score in scores

where score > 80

orderby score descending

select score;

Recuperar una secuencia de elementos como en el ejemplo anterior, pero

transformándolos en un nuevo tipo de objeto. Por ejemplo, una consulta puede
recuperar solo los apellidos de ciertos registros de clientes de un origen de datos.
También puede recuperar el registro completo y, luego, usarlo para construir otro
tipo de objeto en memoria, o incluso datos XML, antes de generar la secuencia de
resultado final. En el ejemplo siguiente muestra una proyección de int a string .
Observe el nuevo tipo de highScoresQuery .

C#

IEnumerable<string> highScoresQuery2 =

from score in scores

where score > 80

orderby score descending

select $"The score is {score}";

Recuperar un valor singleton sobre los datos de origen, por ejemplo:

El número de elementos que coinciden con una condición determinada.

El elemento que tiene el mayor o el menor valor.

El primer elemento que coincide con una condición, o bien la suma de

determinados valores de un conjunto de elementos especificado. Por ejemplo,
la consulta siguiente devuelve el número de resultados mayor que 80 de la
matriz de enteros scores :

C#

int highScoreCount = (

from score in scores

where score > 80

select score

).Count();

En el ejemplo anterior, observe el uso de los paréntesis alrededor de la

expresión de consulta antes de llamar al método Count . Esto también se puede
expresar mediante una nueva variable para almacenar el resultado concreto.
Esta técnica es más legible porque hace que la variable que almacena la
consulta se mantenga separada de la consulta que almacena un resultado.

C#

IEnumerable<int> highScoresQuery3 =

from score in scores

where score > 80

select score;

 int scoreCount = highScoresQuery3.Count();

En el ejemplo anterior, la consulta se ejecuta en la llamada a Count , ya que Count debe

iterar los resultados para determinar el número de elementos devueltos por
highScoresQuery .

¿Qué es una expresión de consulta?

Una expresión de consulta es una consulta que se expresa en sintaxis de consulta. Una
expresión de consulta es una construcción de lenguaje de primera clase. Es igual que
cualquier otra expresión y puede usarse en cualquier contexto en el que una expresión
de C# sea válida. Una expresión de consulta consta de un conjunto de cláusulas escritas
en una sintaxis declarativa similar a SQL o XQuery. Cada cláusula contiene una o más
expresiones de C#, y estas expresiones pueden ser una expresión de consulta en sí
mismas o bien contener una expresión de consulta.

Una expresión de consulta debe comenzar con una cláusula from y debe terminar con
una cláusula select o group. Entre la primera cláusula from y la última cláusula select o
group , puede contener una o varias de estas cláusulas opcionales: where, orderby, join,
let e incluso cláusulas from adicionales. También puede usar la palabra clave into para
que el resultado de una cláusula join o group actúe como el origen de las cláusulas de
consulta adicionales en la misma expresión de consulta.

Variable de consulta
En LINQ, una variable de consulta es cualquier variable que almacene una consulta en
lugar de los resultados de una consulta. Más concretamente, una variable de consulta es
siempre un tipo enumerable que generará una secuencia de elementos cuando se itere
en una instrucción foreach o en una llamada directa a su método
IEnumerator.MoveNext .

En el ejemplo de código siguiente se muestra una expresión de consulta simple con un

origen de datos, una cláusula de filtrado, una cláusula de clasificación y ninguna
transformación en los elementos de origen. La cláusula select finaliza la consulta.

C#

// Data source.

int[] scores = { 90, 71, 82, 93, 75, 82 };

// Query Expression.

 IEnumerable<int> scoreQuery = //query variable

from score in scores //required

where score > 80 // optional

orderby score descending // optional

select score; //must end with select or group

// Execute the query to produce the results

foreach (int testScore in scoreQuery)

Console.WriteLine(testScore);
}

// Output: 93 90 82 82

En el ejemplo anterior, scoreQuery es una variable de consulta, que a veces se conoce

simplemente como una consulta. La variable de consulta no almacena datos de
resultado reales, que se producen en el bucle foreach . Cuando se ejecuta la instrucción
foreach , los resultados de la consulta no se devuelven a través de la variable de
consulta scoreQuery , sino a través de la variable de iteración testScore . La variable
scoreQuery se puede iterar en un segundo bucle foreach . Siempre y cuando ni esta ni el
origen de datos se hayan modificado, producirá los mismos resultados.

Una variable de consulta puede almacenar una consulta expresada en sintaxis de

consulta, en sintaxis de método o en una combinación de ambas. En los ejemplos
siguientes, queryMajorCities y queryMajorCities2 son variables de consulta:

C#

//Query syntax

IEnumerable<City> queryMajorCities =

from city in cities

where city.Population > 100000

select city;

// Method-based syntax

IEnumerable<City> queryMajorCities2 = cities.Where(c => c.Population >

100000);

Por otro lado, en los dos ejemplos siguientes se muestran variables que no son de
consulta, a pesar de que se inicialicen con una consulta. No son variables de consulta
porque almacenan resultados:

C#

int highestScore = (

from score in scores

select score

 ).Max();

// or split the expression

IEnumerable<int> scoreQuery =

from score in scores

select score;

int highScore = scoreQuery.Max();

// the following returns the same result

highScore = scores.Max();

C#

List<City> largeCitiesList = (

from country in countries

from city in country.Cities

where city.Population > 10000

select city

).ToList();

// or split the expression

IEnumerable<City> largeCitiesQuery =

from country in countries

from city in country.Cities

where city.Population > 10000

select city;

List<City> largeCitiesList2 = largeCitiesQuery.ToList();

Para obtener más información sobre las distintas formas de expresar consultas, vea
Query syntax and method syntax in LINQ (Sintaxis de consulta y sintaxis de método en
LINQ).

Asignación implícita y explícita de tipos de variables de consulta

En esta documentación se suele proporcionar el tipo explícito de la variable de consulta

para mostrar las relaciones de tipo entre la variable de consulta y la cláusula select. Pero
también se puede usar la palabra clave var para indicarle al compilador que infiera el
tipo de una variable de consulta (u otra variable local) en tiempo de compilación. Por
ejemplo, la consulta de ejemplo que se mostró anteriormente en este tema también se
puede expresar mediante la asignación implícita de tipos:

C#

// Use of var is optional here and in all queries.

// queryCities is an IEnumerable<City> just as

// when it is explicitly typed.

var queryCities =

 from city in cities

where city.Population > 100000

select city;

Para obtener más información, vea Implicitly typed local variables (Variables locales con
asignación implícita de tipos) y Type relationships in LINQ query operations (Relaciones
entre tipos en las operaciones de consulta de LINQ).

Iniciar una expresión de consulta

Una expresión de consulta debe comenzar con una cláusula from , que especifica un
origen de datos junto con una variable de rango. La variable de rango representa cada
elemento sucesivo de la secuencia de origen a medida que esta se recorre. La variable
de rango está fuertemente tipada en función del tipo de elementos del origen de datos.
En el ejemplo siguiente, como countries es una matriz de objetos Country , la variable
de rango también está tipada como Country . Dado que la variable de rango está
fuertemente tipada, se puede usar el operador punto para tener acceso a cualquier
miembro disponible del tipo.

C#

IEnumerable<Country> countryAreaQuery =

from country in countries

where country.Area > 500000 //sq km

select country;

La variable de rango está en el ámbito hasta que se cierra la consulta con un punto y
coma o con una cláusula de continuación.

Una expresión de consulta puede contener varias cláusulas from . Use más cláusulas
from cuando cada elemento de la secuencia de origen sea una colección en sí mismo o

contenga una colección. Por ejemplo, supongamos que tiene una colección de objetos
Country , cada uno de los cuales contiene una colección de objetos City denominados

Cities . Para consultar los objetos City de cada Country , use dos cláusulas from , como
se muestra aquí:

C#

IEnumerable<City> cityQuery =

from country in countries

from city in country.Cities

where city.Population > 10000

select city;

Para obtener más información, vea from clause (Cláusula from).

Finalizar una expresión de consulta

Una expresión de consulta debe finalizar con una cláusula group o select .

group (cláusula)

Use la cláusula group para generar una secuencia de grupos organizados por la clave
que especifique. La clave puede ser cualquier tipo de datos. Por ejemplo, la siguiente
consulta crea una secuencia de grupos que contienen uno o más objetos Country y
cuya clave es un tipo char con un valor que es la primera letra del nombre de un país.

C#

var queryCountryGroups =

from country in countries

group country by country.Name[0];

Para obtener más información sobre la agrupación, vea group clause (Cláusula group).

select (cláusula)

Use la cláusula select para generar todos los demás tipos de secuencias. Una cláusula
select simple solo genera una secuencia del mismo tipo de objetos que los objetos

contenidos en el origen de datos. En este ejemplo, el origen de datos contiene objetos

Country . La cláusula orderby simplemente ordena los elementos con un orden nuevo y
la cláusula select genera una secuencia con los objetos Country reordenados.

C#

IEnumerable<Country> sortedQuery =

from country in countries

orderby country.Area

select country;

La cláusula select puede usarse para transformar los datos de origen en secuencias de
nuevos tipos. Esta transformación también se denomina proyección. En el ejemplo
siguiente, la cláusula select proyecta una secuencia de tipos anónimos que solo
contiene un subconjunto de los campos del elemento original. Tenga en cuenta que los
nuevos objetos se inicializan mediante un inicializador de objeto.
 C#

// Here var is required because the query

// produces an anonymous type.

var queryNameAndPop =

from country in countries

select new

Name = country.Name,

Pop = country.Population

};

Para obtener más información sobre todas las formas en que se puede usar una cláusula
select para transformar datos de origen, vea select clause (Cláusula select).

Continuaciones con into

Puede usar la palabra clave into en una cláusula select o group para crear un
identificador temporal que almacene una consulta. Hágalo cuando deba realizar
operaciones de consulta adicionales en una consulta después de una operación de
agrupación o selección. En el siguiente ejemplo se agrupan los objetos countries según
su población en intervalos de 10 millones. Una vez que se han creado estos grupos, las
cláusulas adicionales filtran algunos grupos y, después, ordenan los grupos en orden
ascendente. Para realizar esas operaciones adicionales, es necesaria la continuación
representada por countryGroup .

C#

// percentileQuery is an IEnumerable<IGrouping<int, Country>>

var percentileQuery =

from country in countries

let percentile = (int)country.Population / 10_000_000

group country by percentile into countryGroup

where countryGroup.Key >= 20

orderby countryGroup.Key

select countryGroup;

// grouping is an IGrouping<int, Country>

foreach (var grouping in percentileQuery)

Console.WriteLine(grouping.Key);

foreach (var country in grouping)

Console.WriteLine(country.Name + ":" + country.Population);

Para obtener más información, vea into.

Filtrar, ordenar y combinar

Entre la cláusula de inicio from y la cláusula de finalización select o group , todas las
demás cláusulas ( where , join , orderby , from , let ) son opcionales. Cualquiera de las
cláusulas opcionales puede usarse cero o varias veces en el cuerpo de una consulta.

where (cláusula)

Use la cláusula where para filtrar los elementos de los datos de origen en función de
una o varias expresiones de predicado. La cláusula where del ejemplo siguiente tiene un
predicado con dos condiciones.

C#

IEnumerable<City> queryCityPop =

from city in cities

where city.Population < 200000 && city.Population > 100000

select city;

Para obtener más información, vea where (Cláusula).

orderby (cláusula)
Use la cláusula orderby para ordenar los resultados en orden ascendente o
descendente. También puede especificar criterios de ordenación secundaria. En el
ejemplo siguiente se realiza una ordenación primaria de los objetos country mediante
la propiedad Area . Después, se realiza una ordenación secundaria mediante la
propiedad Population .

C#

IEnumerable<Country> querySortedCountries =

from country in countries

orderby country.Area, country.Population descending

select country;

La palabra clave ascending es opcional; es el criterio de ordenación predeterminado si

no se especifica ningún orden. Para obtener más información, vea orderby (Cláusula).
join (cláusula)
Use la cláusula join para asociar o combinar elementos de un origen de datos con
elementos de otro origen de datos en función de una comparación de igualdad entre
las claves especificadas en cada elemento. En LINQ, las operaciones de combinación se
realizan en secuencias de objetos cuyos elementos son de tipos diferentes. Después de
combinar dos secuencias, debe usar una instrucción select o group para especificar
qué elemento se va a almacenar en la secuencia de salida. También puede usar un tipo
anónimo para combinar propiedades de cada conjunto de elementos asociados en un
nuevo tipo para la secuencia de salida. En el ejemplo siguiente se asocian objetos prod
cuya propiedad Category coincide con una de las categorías de la matriz de cadenas
categories . Los productos cuyo valor Category no coincida con ninguna cadena de
categories se filtrarán. La instrucción select proyecta un nuevo tipo cuyas propiedades

se toman de cat y prod .

C#

var categoryQuery =

from cat in categories

join prod in products on cat equals prod.Category

select new

Category = cat,

Name = prod.Name

};

También puede realizar una combinación agrupada. Para ello, almacene los resultados
de la operación join en una variable temporal mediante el uso de la palabra clave into.
Para obtener más información, vea join (Cláusula, Referencia de C#).

let (cláusula)

Use la cláusula let para almacenar el resultado de una expresión, como una llamada de
método, en una nueva variable de rango. En el ejemplo siguiente, la variable de rango
firstName almacena el primer elemento de la matriz de cadenas devuelta por Split .

C#

string[] names = { "Svetlana Omelchenko", "Claire O'Donnell", "Sven

Mortensen", "Cesar Garcia" };

IEnumerable<string> queryFirstNames =

from name in names

let firstName = name.Split(' ')[0]

select firstName;

 foreach (string s in queryFirstNames)

Console.Write(s + " ");

//Output: Svetlana Claire Sven Cesar

Para obtener más información, vea let (Cláusula).

Subconsultas en una expresión de consulta

Una cláusula de consulta puede contener una expresión de consulta, en ocasiones
denominada subconsulta. Cada subconsulta comienza con su propia cláusula from que
no necesariamente hace referencia al mismo origen de datos de la primera cláusula
from . Por ejemplo, la consulta siguiente muestra una expresión de consulta que se usa

en la instrucción select para recuperar los resultados de una operación de agrupación.

C#

var queryGroupMax =

from student in students

group student by student.Year into studentGroup

select new

Level = studentGroup.Key,
HighestScore = (

from student2 in studentGroup

select student2.ExamScores.Average()

).Max()

};

Para más información, consulte Realizar una subconsulta en una operación de

agrupación.

Vea también
Guía de programación de C#
Language-Integrated Query (LINQ)
Palabras clave de consultas (LINQ)
Información general sobre operadores de consulta estándar
LINQ en C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Esta sección contiene vínculos a temas que ofrecen información más detallada sobre
LINQ.

En esta sección
Introducción a las consultas LINQ

Describe las tres partes de la operación de consulta LINQ básica que son comunes a
todos los lenguajes y orígenes de datos.

LINQ y tipos genéricos

Ofrece una breve introducción a los tipos genéricos, tal como se usan en LINQ.

Transformaciones de datos con LINQ

Describe las diversas formas de transformar datos recuperados en las consultas.

Relaciones entre tipos en las operaciones de consulta LINQ

Describe cómo se mantienen o transforman los tipos en las tres partes de una operación
de consulta LINQ.

Sintaxis de consulta y sintaxis de método en LINQ

Compara la sintaxis de métodos y la sintaxis de consultas como dos maneras de

expresar una consulta LINQ.

Características de C# compatibles con LINQ

Describe las construcciones de lenguaje de C# compatibles con LINQ.

Secciones relacionadas
Expresiones de consulta LINQ

Incluye información general sobre las consultas en LINQ y ofrece vínculos a recursos
adicionales.

Información general sobre operadores de consulta estándar

Presenta los métodos estándar de LINQ.

Escribir consultas LINQ en C#
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

En este artículo se muestran las tres formas de escribir una consulta LINQ en C#:

1. Usar sintaxis de consulta.

2. Usar sintaxis de método.

3. Usar una combinación de sintaxis de consulta y sintaxis de método.

Los ejemplos siguientes muestran algunas consultas LINQ sencillas mediante cada
enfoque enumerado anteriormente. En general, la regla es usar (1) siempre que sea
posible y usar (2) y (3) cuando sea necesario.

７ Nota

Estas consultas funcionan en colecciones en memoria simples, pero la sintaxis

básica es idéntica a la empleada en LINQ to Entities y LINQ to XML.

Ejemplo: Sintaxis de consulta

La manera recomendada de escribir la mayoría de las consultas es usar sintaxis de
consulta para crear expresiones de consulta. En el siguiente ejemplo se muestran tres
expresiones de consulta. La primera expresión de consulta muestra cómo filtrar o
restringir los resultados mediante la aplicación de condiciones con una cláusula where .
Devuelve todos los elementos de la secuencia de origen cuyos valores sean mayores
que 7 o menores que 3. La segunda expresión muestra cómo ordenar los resultados
devueltos. La tercera expresión muestra cómo agrupar los resultados según una clave.
Esta consulta devuelve dos grupos en función de la primera letra de la palabra.

C#

List<int> numbers = new() { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

// The query variables can also be implicitly typed by using var

// Query #1.

IEnumerable<int> filteringQuery =

from num in numbers

where num < 3 || num > 7

select num;

 // Query #2.

IEnumerable<int> orderingQuery =

from num in numbers

where num < 3 || num > 7

orderby num ascending

select num;

// Query #3.

string[] groupingQuery = { "carrots", "cabbage", "broccoli", "beans",

"barley" };

IEnumerable<IGrouping<char, string>> queryFoodGroups =

from item in groupingQuery

group item by item[0];

Tenga en cuenta que el tipo de las consultas es IEnumerable<T>. Todas estas consultas
podrían escribirse mediante var como se muestra en el ejemplo siguiente:

var query = from num in numbers...

En cada ejemplo anterior, las consultas no se ejecutan realmente hasta que se recorre en
iteración la variable de consulta en una instrucción foreach o cualquier otra instrucción.
Para más información, vea Introduction to LINQ Queries (Introducción a las consultas
LINQ).

Ejemplo: Sintaxis de método

Algunas operaciones de consulta deben expresarse como una llamada a método. Los
más comunes de dichos métodos son los que devuelven valores numéricos de
singleton, como Sum, Max, Min, Average y así sucesivamente. A estos métodos siempre
se los debe llamar en último lugar en cualquier consulta porque representan un solo
valor y no pueden servir como origen para una operación de consulta adicional. En el
ejemplo siguiente se muestra una llamada a método en una expresión de consulta:

C#

List<int> numbers1 = new() { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

List<int> numbers2 = new() { 15, 14, 11, 13, 19, 18, 16, 17, 12, 10 };

// Query #4.

double average = numbers1.Average();

// Query #5.

IEnumerable<int> concatenationQuery = numbers1.Concat(numbers2);

Si el método tiene parámetros Action o Func, se proporcionan en forma de expresión

lambda, como se muestra en el ejemplo siguiente:
 C#

// Query #6.

IEnumerable<int> largeNumbersQuery = numbers2.Where(c => c > 15);

En las consultas anteriores, solo la número 4 se ejecuta inmediatamente. Esto se debe a

que devuelve un valor único, y no una colección IEnumerable<T> genérica. El propio
método tiene que usar foreach para calcular su valor.

Cada una de las consultas anteriores puede escribirse mediante tipos implícitos con var,
como se muestra en el ejemplo siguiente:

C#

// var is used for convenience in these queries

var average = numbers1.Average();

var concatenationQuery = numbers1.Concat(numbers2);

var largeNumbersQuery = numbers2.Where(c => c > 15);

Ejemplo: Sintaxis de consulta y método

combinada
En este ejemplo se muestra cómo usar la sintaxis de método en los resultados de una
cláusula de consulta. Simplemente escriba entre paréntesis la expresión de consulta y
luego aplique el operador punto y llame al método. En el ejemplo siguiente la consulta
número 7 devuelve un recuento de los números cuyo valor está comprendido entre 3 y
7. Pero en general es mejor usar una segunda variable para almacenar el resultado de la
llamada a método. De esta manera es menos probable que la consulta se confunda con
los resultados de la consulta.

C#

// Query #7.

// Using a query expression with method syntax

int numCount1 = (

from num in numbers1

where num < 3 || num > 7

select num

).Count();

// Better: Create a new variable to store

// the method call result

IEnumerable<int> numbersQuery =

from num in numbers1

 where num < 3 || num > 7

select num;

int numCount2 = numbersQuery.Count();

Dado que la consulta número 7 devuelve un solo valor y no una colección, se ejecuta
inmediatamente.

La consulta anterior puede escribirse mediante tipos implícitos con var como sigue:

C#

var numCount = (from num in numbers...

Puede escribirse en sintaxis de método como sigue:

C#

var numCount = numbers.Where(n => n < 3 || n > 7).Count();

Puede escribirse mediante tipos explícitos como sigue:

C#

int numCount = numbers.Where(n => n < 3 || n > 7).Count();

Consulte también
Tutorial: Escribir consultas en C#
Language-Integrated Query (LINQ)
where (cláusula)
Consultar una colección de objetos
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

En este tema se muestra un ejemplo de cómo realizar una consulta simple en una lista
de objetos Student . Cada objeto Student contiene información básica sobre el alumno
y una lista que representa las puntuaciones del alumno en cuatro exámenes.

７ Nota

Muchos otros ejemplos de esta sección usan la misma clase Student y colección
students .

C#

class Student

public string FirstName { get; set; }

public string LastName { get; set; }

public int ID { get; set; }

public GradeLevel? Year { get; set; }

public List<int> ExamScores { get; set; }

public Student(string FirstName, string LastName, int ID, GradeLevel

Year, List<int> ExamScores)

this.FirstName = FirstName;

this.LastName = LastName;
this.ID = ID;

this.Year = Year;

this.ExamScores = ExamScores;

public Student(string FirstName, string LastName, int StudentID,

List<int>? ExamScores = null)

this.FirstName = FirstName;

this.LastName = LastName;
ID = StudentID;

this.ExamScores = ExamScores ?? Enumerable.Empty<int>().ToList();

public static List<Student> students = new()

new(

FirstName: "Terry", LastName: "Adams", ID: 120,

Year: GradeLevel.SecondYear,

ExamScores: new() { 99, 82, 81, 79 }

),

new(

"Fadi", "Fakhouri", 116,

GradeLevel.ThirdYear,
new() { 99, 86, 90, 94 }

),

new(

"Hanying", "Feng", 117,

GradeLevel.FirstYear,
new() { 93, 92, 80, 87 }

),

new(

"Cesar", "Garcia", 114,

GradeLevel.FourthYear,

new() { 97, 89, 85, 82 }

),

new(

"Debra", "Garcia", 115,

GradeLevel.ThirdYear,
new() { 35, 72, 91, 70 }

),

new(

"Hugo", "Garcia", 118,

GradeLevel.SecondYear,

new() { 92, 90, 83, 78 }

),

new(

"Sven", "Mortensen", 113,

GradeLevel.FirstYear,
new() { 88, 94, 65, 91 }

),

new(

"Claire", "O'Donnell", 112,

GradeLevel.FourthYear,

new() { 75, 84, 91, 39 }

),

new(

"Svetlana", "Omelchenko", 111,

GradeLevel.SecondYear,

new() { 97, 92, 81, 60 }

),

new(

"Lance", "Tucker", 119,

GradeLevel.ThirdYear,
new() { 68, 79, 88, 92 }

),

new(

"Michael", "Tucker", 122,

GradeLevel.FirstYear,
new() { 94, 92, 91, 91 }

),

new(

"Eugene", "Zabokritski", 121,

GradeLevel.FourthYear,

new() { 96, 85, 91, 60 }

 };

enum GradeLevel

FirstYear = 1,

SecondYear,

ThirdYear,

FourthYear

};

Ejemplo
La consulta siguiente devuelve los alumnos que reciben una puntuación de 90 o más en
su primer examen.

C#

void QueryHighScores(int exam, int score)

var highScores =

from student in students

where student.ExamScores[exam] > score

select new

Name = student.FirstName,

Score = student.ExamScores[exam]

};

foreach (var item in highScores)

Console.WriteLine($"{item.Name,-15}{item.Score}");

QueryHighScores(1, 90);

Esta consulta es deliberadamente simple para permitirle experimentar. Por ejemplo,

puede probar otras condiciones en la cláusula where o usar una cláusula orderby para
ordenar los resultados.

Vea también
Language-Integrated Query (LINQ)
Interpolación de cadenas
Cómo devolver una consulta de un
método
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo devolver una consulta desde un método como un
valor devuelto y como un parámetro out .

Los objetos de consulta admiten composición, lo que significa que puede devolver una
consulta desde un método. Los objetos que representan consultas no almacenan la
colección resultante, sino los pasos para generar los resultados cuando sea necesario. La
ventaja de devolver objetos de consulta desde métodos es que se pueden componer o
modificar todavía más. Por lo tanto, cualquier valor devuelto o parámetro out de un
método que devuelve una consulta también debe tener ese tipo. Si un método
materializa una consulta en un tipo concreto List<T> o Array, se considera que está
devolviendo los resultados de la consulta en lugar de la propia consulta. Una variable de
consulta que se devuelve desde un método sigue pudiendo componerse o modificarse.

Ejemplo
En el ejemplo siguiente, el primer método devuelve una consulta como un valor
devuelto y el segundo método devuelve una consulta como un parámetro out . Tenga
en cuenta que, en ambos casos, se trata de una consulta que se devuelve, no de los
resultados de la consulta.

C#

// QueryMethod1 returns a query as its value.

IEnumerable<string> QueryMethod1(int[] ints) =>

from i in ints

where i > 4

select i.ToString();

// QueryMethod2 returns a query as the value of the out parameter returnQ

void QueryMethod2(int[] ints, out IEnumerable<string> returnQ) =>

returnQ =

from i in ints

where i < 4

select i.ToString();

int[] nums = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };

// QueryMethod1 returns a query as the value of the method.

var myQuery1 = QueryMethod1(nums);

 // Query myQuery1 is executed in the following foreach loop.

Console.WriteLine("Results of executing myQuery1:");

// Rest the mouse pointer over myQuery1 to see its type.

foreach (var s in myQuery1)

Console.WriteLine(s);

// You also can execute the query returned from QueryMethod1

// directly, without using myQuery1.

Console.WriteLine("\nResults of executing myQuery1 directly:");

// Rest the mouse pointer over the call to QueryMethod1 to see its

// return type.

foreach (var s in QueryMethod1(nums))

Console.WriteLine(s);

// QueryMethod2 returns a query as the value of its out parameter.

QueryMethod2(nums, out IEnumerable<string> myQuery2);

// Execute the returned query.

Console.WriteLine("\nResults of executing myQuery2:");

foreach (var s in myQuery2)

Console.WriteLine(s);

// You can modify a query by using query composition. In this case, the

// previous query object is used to create a new query object; this new
object

// will return different results than the original query object.

myQuery1 =

from item in myQuery1

orderby item descending

select item;

// Execute the modified query.

Console.WriteLine("\nResults of executing modified myQuery1:");

foreach (var s in myQuery1)

Console.WriteLine(s);

Vea también
Language-Integrated Query (LINQ)
Almacenar los resultados de una
consulta en memoria
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Una consulta es básicamente un conjunto de instrucciones sobre cómo recuperar y

organizar los datos. Las consultas se ejecutan de forma diferida, ya que se solicita cada
elemento subsiguiente del resultado. Cuando se usa foreach para iterar los resultados,
los elementos se devuelven a medida que se tiene acceso a ellos. Para evaluar una
consulta y almacenar los resultados sin ejecutar un bucle foreach , simplemente llame a
uno de los métodos siguientes en la variable de consulta:

ToList

ToArray

ToDictionary

ToLookup

Recomendamos que, al almacenar los resultados de consulta, asigne el objeto de

colección devuelto a una nueva variable tal como se muestra en el ejemplo siguiente:

Ejemplo
C#

List<int> numbers = new() { 1, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };

IEnumerable<int> queryFactorsOfFour =

from num in numbers

where num % 4 == 0

select num;

// Store the results in a new variable

// without executing a foreach loop.

List<int> factorsofFourList = queryFactorsOfFour.ToList();

// Read and write from the newly created list to demonstrate that it holds
data.

Console.WriteLine(factorsofFourList[2]);

factorsofFourList[2] = 0;

Console.WriteLine(factorsofFourList[2]);

Vea también
Language-Integrated Query (LINQ)
Agrupar los resultados de consultas
Artículo • 11/02/2023 • Tiempo de lectura: 5 minutos

La agrupación es una de las capacidades más eficaces de LINQ. Los ejemplos siguientes
muestran cómo agrupar datos de varias maneras:

Por una sola propiedad.

Por la primera letra de una propiedad de cadena.

Por un intervalo numérico calculado.

Por un predicado booleano u otra expresión.

Por una clave compuesta.

Además, las dos últimas consultas proyectan sus resultados en un nuevo tipo anónimo
que solo contiene el nombre y los apellidos del estudiante. Para obtener más
información, vea la cláusula group.

７ Nota

En los ejemplos de este tema se usa la clase Student y la lista students del código
de ejemplo incluido en Consulta de una colección de objetos.

Ejemplo de agrupación por propiedad única

En el ejemplo siguiente se muestra cómo agrupar elementos de origen mediante una
propiedad única del elemento como la clave de grupo. En este caso, la clave es una
string , el apellido del alumno. También es posible usar una subcadena para la clave;

consulte el siguiente ejemplo . La operación de agrupación usa al comparador de

igualdad predeterminado para el tipo.

C#

// Variable groupByLastNamesQuery is an IEnumerable<IGrouping<string,

// DataClass.Student>>.

var groupByLastNamesQuery =

from student in students

group student by student.LastName into newGroup

orderby newGroup.Key

select newGroup;

foreach (var nameGroup in groupByLastNamesQuery)

Console.WriteLine($"Key: {nameGroup.Key}");

foreach (var student in nameGroup)

Console.WriteLine($"\t{student.LastName}, {student.FirstName}");

/* Output:

Key: Adams

Adams, Terry

Key: Fakhouri

Fakhouri, Fadi

Key: Feng

Feng, Hanying

Key: Garcia

Garcia, Cesar

Garcia, Debra

Garcia, Hugo

Key: Mortensen

Mortensen, Sven

Key: O'Donnell

O'Donnell, Claire

Key: Omelchenko

Omelchenko, Svetlana

Key: Tucker

Tucker, Lance

Tucker, Michael

Key: Zabokritski

Zabokritski, Eugene

*/

Ejemplo de agrupación por valor

En el ejemplo siguiente se muestra cómo agrupar elementos de origen mediante algo
distinto a una propiedad del objeto para la clave de grupo. En este ejemplo, la clave es
la primera letra del apellido del alumno.

C#

var groupByFirstLetterQuery =

from student in students

group student by student.LastName[0];

foreach (var studentGroup in groupByFirstLetterQuery)

Console.WriteLine($"Key: {studentGroup.Key}");

// Nested foreach is required to access group items.

foreach (var student in studentGroup)

Console.WriteLine($"\t{student.LastName}, {student.FirstName}");

/* Output:

Key: A

Adams, Terry

Key: F

Fakhouri, Fadi

Feng, Hanying

Key: G

Garcia, Cesar

Garcia, Debra

Garcia, Hugo

Key: M

Mortensen, Sven

Key: O

O'Donnell, Claire

Omelchenko, Svetlana

Key: T

Tucker, Lance

Tucker, Michael

Key: Z

Zabokritski, Eugene

*/

Ejemplo de agrupación por intervalo

En el ejemplo siguiente se muestra cómo agrupar elementos de origen mediante un
intervalo numérico como la clave de grupo. Después, la consulta proyecta los resultados
en un tipo anónimo que solo contiene el nombre, los apellidos y el intervalo de percentil
al que pertenece el alumno. Se usa un tipo anónimo porque no es necesario usar el
objeto Student completo para mostrar los resultados. GetPercentile es una función del
asistente que calcula un percentil basado en la puntuación media del alumno. El método
devuelve un entero entre 0 y 10.

C#

int GetPercentile(Student s)

double avg = s.ExamScores.Average();

return avg > 0 ? (int)avg / 10 : 0;

var groupByPercentileQuery =

from student in students

let percentile = GetPercentile(student)

group new

student.FirstName,

 student.LastName

} by percentile into percentGroup

orderby percentGroup.Key

select percentGroup;

// Nested foreach required to iterate over groups and group items.

foreach (var studentGroup in groupByPercentileQuery)

Console.WriteLine($"Key: {studentGroup.Key * 10}");

foreach (var item in studentGroup)

Console.WriteLine($"\t{item.LastName}, {item.FirstName}");

/* Output:

Key: 60

Garcia, Debra

Key: 70

O'Donnell, Claire

Key: 80

Adams, Terry

Feng, Hanying

Garcia, Cesar

Garcia, Hugo

Mortensen, Sven

Omelchenko, Svetlana

Tucker, Lance

Zabokritski, Eugene

Key: 90

Fakhouri, Fadi

Tucker, Michael

*/

Ejemplo de agrupación por comparación

En el ejemplo siguiente se muestra cómo agrupar elementos de origen usando una
expresión de comparación booleana. En este ejemplo, la expresión booleana comprueba
si la puntuación media del examen de un alumno es mayor de 75. Como en los
ejemplos anteriores, los resultados se proyectan en un tipo anónimo porque el
elemento de origen completo no es necesario. Tenga en cuenta que las propiedades del
tipo anónimo se convierten en propiedades en el miembro Key y puede tener acceso a
ellas por nombre cuando se ejecuta la consulta.

C#

var groupByHighAverageQuery =

from student in students

group new

student.FirstName,

student.LastName

} by student.ExamScores.Average() > 75 into studentGroup

select studentGroup;

foreach (var studentGroup in groupByHighAverageQuery)

Console.WriteLine($"Key: {studentGroup.Key}");

foreach (var student in studentGroup)

Console.WriteLine($"\t{student.FirstName} {student.LastName}");

/* Output:

Key: True

Terry Adams

Fadi Fakhouri

Hanying Feng

Cesar Garcia

Hugo Garcia

Sven Mortensen

Svetlana Omelchenko

Lance Tucker

Michael Tucker

Eugene Zabokritski

Key: False

Debra Garcia

Claire O'Donnell

*/

Agrupación por tipo anónimo

En el ejemplo siguiente se muestra cómo usar un tipo anónimo para encapsular una
clave que contiene varios valores. En este ejemplo, el primer valor de clave es la primera
letra del apellido del alumno. El segundo valor de clave es un valor booleano que
especifica si el alumno obtuvo una nota superior a 85 en el primer examen. Los grupos
se pueden ordenar por cualquier propiedad de la clave.

C#

var groupByCompoundKey =

from student in students

group student by new

FirstLetter = student.LastName[0],

IsScoreOver85 = student.ExamScores[0] > 85

} into studentGroup

orderby studentGroup.Key.FirstLetter

 select studentGroup;

foreach (var scoreGroup in groupByCompoundKey)

string s = scoreGroup.Key.IsScoreOver85 == true ? "more than 85" : "less

than 85";

Console.WriteLine($"Name starts with {scoreGroup.Key.FirstLetter} who

scored {s}");

foreach (var item in scoreGroup)

Console.WriteLine($"\t{item.FirstName} {item.LastName}");

/* Output:

Name starts with A who scored more than 85

Terry Adams

Name starts with F who scored more than 85

Fadi Fakhouri

Hanying Feng

Name starts with G who scored more than 85

Cesar Garcia

Hugo Garcia

Name starts with G who scored less than 85

Debra Garcia

Name starts with M who scored more than 85

Sven Mortensen

Name starts with O who scored less than 85

Claire O'Donnell

Name starts with O who scored more than 85

Svetlana Omelchenko

Name starts with T who scored less than 85

Lance Tucker

Name starts with T who scored more than 85

Michael Tucker

Name starts with Z who scored more than 85

Eugene Zabokritski

*/

Vea también
GroupBy
IGrouping<TKey,TElement>
Language-Integrated Query (LINQ)
group (cláusula)
Tipos anónimos
Realizar una subconsulta en una operación de agrupación
Crear un grupo anidado
Agrupar datos
Crear un grupo anidado
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En el ejemplo siguiente se muestra cómo crear grupos anidados en una expresión de

consulta LINQ. Cada grupo creado a partir del nivel académico o del año de los
estudiantes se subdivide en grupos según sus nombres.

Ejemplo

７ Nota

En el ejemplo de este tema se usa la clase y Student la lista students del código de
ejemplo incluido en Consulta de una colección de objetos.

C#

var nestedGroupsQuery =

from student in students

group student by student.Year into newGroup1

from newGroup2 in (
from student in newGroup1

group student by student.LastName

group newGroup2 by newGroup1.Key;

// Three nested foreach loops are required to iterate

// over all elements of a grouped group. Hover the mouse

// cursor over the iteration variables to see their actual type.

foreach (var outerGroup in nestedGroupsQuery)

Console.WriteLine($"DataClass.Student Level = {outerGroup.Key}");

foreach (var innerGroup in outerGroup)

Console.WriteLine($"\tNames that begin with: {innerGroup.Key}");

foreach (var innerGroupElement in innerGroup)

Console.WriteLine($"\t\t{innerGroupElement.LastName}
{innerGroupElement.FirstName}");

/* Output:

DataClass.Student Level = SecondYear

Names that begin with: Adams

Adams Terry

Names that begin with: Garcia

 Garcia Hugo

Names that begin with: Omelchenko

Omelchenko Svetlana

DataClass.Student Level = ThirdYear

Names that begin with: Fakhouri

Fakhouri Fadi
Names that begin with: Garcia

Garcia Debra

Names that begin with: Tucker

Tucker Lance

DataClass.Student Level = FirstYear

Names that begin with: Feng

Feng Hanying

Names that begin with: Mortensen

Mortensen Sven

Names that begin with: Tucker

Tucker Michael

DataClass.Student Level = FourthYear

Names that begin with: Garcia

Garcia Cesar

Names that begin with: O'Donnell

O'Donnell Claire

Names that begin with: Zabokritski

Zabokritski Eugene

*/

Tenga en cuenta que se necesitan tres bucles foreach anidados para recorrer en
iteración los elementos internos de un grupo anidado.

Vea también
Language-Integrated Query (LINQ)
Realizar una subconsulta en una
operación de agrupación
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este artículo se muestran dos maneras diferentes de crear una consulta que ordena
los datos de origen en grupos y, luego, realiza una subconsulta en cada grupo de forma
individual. La técnica básica de cada ejemplo consiste en agrupar los elementos de
origen usando una continuación denominada newGroup y después generar una nueva
subconsulta en newGroup . Esta subconsulta se ejecuta en cada uno de los nuevos grupos
creados por la consulta externa. Tenga en cuenta que en este ejemplo concreto el
resultado final no es un grupo, sino una secuencia plana de tipos anónimos.

Para obtener más información sobre cómo agrupar, consulte Cláusula group.

Para obtener más información sobre continuaciones, consulte into. En el ejemplo

siguiente se usa una estructura de datos en memoria como origen de datos, pero se
aplican los mismos principios para cualquier tipo de origen de datos LINQ.

Ejemplo

７ Nota

En los ejemplos de este tema se usa la clase Student y la lista students del código
de ejemplo incluido en Consulta de una colección de objetos.

C#

var queryGroupMax =

from student in students

group student by student.Year into studentGroup

select new

Level = studentGroup.Key,
HighestScore = (

from student2 in studentGroup

select student2.ExamScores.Average()

).Max()

};

int count = queryGroupMax.Count();

Console.WriteLine($"Number of groups = {count}");

foreach (var item in queryGroupMax)

Console.WriteLine($" {item.Level} Highest Score={item.HighestScore}");

La consulta del fragmento de código anterior también se puede escribir con la sintaxis
de método. El siguiente fragmento de código tiene una consulta semánticamente
equivalente escrita con sintaxis de método.

C#

var queryGroupMax =

students

.GroupBy(student => student.Year)

.Select(studentGroup => new

Level = studentGroup.Key,

HighestScore = studentGroup.Select(student2 =>

student2.ExamScores.Average()).Max()

});

int count = queryGroupMax.Count();

Console.WriteLine($"Number of groups = {count}");

foreach (var item in queryGroupMax)

Console.WriteLine($" {item.Level} Highest Score={item.HighestScore}");

Vea también
Language-Integrated Query (LINQ)
Agrupar resultados por claves contiguas
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

En el ejemplo siguiente se muestra cómo agrupar elementos en fragmentos que

representan subsecuencias de claves contiguas. Por ejemplo, suponga que tiene la
siguiente secuencia de pares clave-valor:

Clave Value

A We

A think

A that

B Linq

C is

A really

B cool

B !

Los siguientes grupos se crearán en este orden:

1. We, think, that

2. Linq
3. is
4. really
5. cool, !

La solución se implementa como un método de extensión seguro para subprocesos que

devuelve sus resultados mediante transmisión por secuencias. Es decir, genera sus
grupos a medida que se desplaza por la secuencia de origen. A diferencia de los
operadores group u orderby , puede comenzar a devolver grupos al llamador antes de
que se haya leído toda la secuencia.

La seguridad de subprocesos se logra realizando una copia de cada grupo o fragmento

a medida que se recorre en iteración la secuencia de origen, tal y como se explica en los
comentarios del código fuente. Si la secuencia de origen tiene una secuencia grande de
elementos contiguos, Common Language Runtime puede producir una excepción
OutOfMemoryException.
Ejemplo
En el ejemplo siguiente se muestran el método de extensión y el código de cliente que
lo usa:

C#

public static class ChunkExtensions

public static IEnumerable<IGrouping<TKey, TSource>> ChunkBy<TSource,

TKey>(

this IEnumerable<TSource> source,

Func<TSource, TKey> keySelector

) =>

source.ChunkBy(keySelector, EqualityComparer<TKey>.Default);

public static IEnumerable<IGrouping<TKey, TSource>> ChunkBy<TSource,

TKey>(

this IEnumerable<TSource> source,

Func<TSource, TKey> keySelector,

IEqualityComparer<TKey> comparer

// Flag to signal end of source sequence.

const bool noMoreSourceElements = true;

// Auto-generated iterator for the source array.

var enumerator = source.GetEnumerator();

// Move to the first element in the source sequence.

if (!enumerator.MoveNext())

yield break;

// Iterate through source sequence and create a copy of each Chunk.

// On each pass, the iterator advances to the first element of the

next "Chunk"

// in the source sequence. This loop corresponds to the outer

foreach loop that

// executes the query.

Chunk<TKey, TSource> current = null;

while (true)

// Get the key for the current Chunk. The source iterator will
churn through

// the source sequence until it finds an element with a key that

doesn't match.

var key = keySelector(enumerator.Current);

// Make a new Chunk (group) object that initially has one

GroupItem, which is a copy of the current source element.

current = new Chunk<TKey, TSource>(key, enumerator, value =>

comparer.Equals(key, keySelector(value)));

// Return the Chunk. A Chunk is an IGrouping<TKey,TSource>,

which is the return value of the ChunkBy method.

// At this point the Chunk only has the first element in its
source sequence. The remaining elements will be

// returned only when the client code foreach's over this chunk.
See Chunk.GetEnumerator for more info.

yield return current;

// Check to see whether (a) the chunk has made a copy of all its
source elements or

// (b) the iterator has reached the end of the source sequence.
If the caller uses an inner

// foreach loop to iterate the chunk items, and that loop ran to
completion,

// then the Chunk.GetEnumerator method will already have made

// copies of all chunk items before we get here. If the

Chunk.GetEnumerator loop did not

// enumerate all elements in the chunk, we need to do it here to

avoid corrupting the iterator

// for clients that may be calling us on a separate thread.

if (current.CopyAllChunkElements() == noMoreSourceElements)

yield break;

// A Chunk is a contiguous group of one or more source elements that have

the same key. A Chunk

// has a key and a list of ChunkItem objects, which are copies of the
elements in the source sequence.

class Chunk<TKey, TSource> : IGrouping<TKey, TSource>

// INVARIANT: DoneCopyingChunk == true ||

// (predicate != null && predicate(enumerator.Current) &&

current.Value == enumerator.Current)

// A Chunk has a linked list of ChunkItems, which represent the elements

in the current chunk. Each ChunkItem

// has a reference to the next ChunkItem in the list.

class ChunkItem

public ChunkItem(TSource value)

Value = value;

public readonly TSource Value;

public ChunkItem? Next = null;

// Stores a reference to the enumerator for the source sequence

 private IEnumerator<TSource> enumerator;

// A reference to the predicate that is used to compare keys.

private Func<TSource, bool> predicate;

// Stores the contents of the first source element that

// belongs with this chunk.

private readonly ChunkItem head;

// End of the list. It is repositioned each time a new

// ChunkItem is added.

private ChunkItem tail;

// Flag to indicate the source iterator has reached the end of the
source sequence.

internal bool isLastSourceElement = false;

// Private object for thread syncronization

private readonly object m_Lock;

// REQUIRES: enumerator != null && predicate != null

public Chunk(TKey key, IEnumerator<TSource> enumerator, Func<TSource,

bool> predicate)

Key = key;

this.enumerator = enumerator;

this.predicate = predicate;

// A Chunk always contains at least one element.

head = new ChunkItem(enumerator.Current);

// The end and beginning are the same until the list contains > 1
elements.

tail = head;

m_Lock = new object();

// Indicates that all chunk elements have been copied to the list of
ChunkItems,

// and the source enumerator is either at the end, or else on an element

with a new key.

// the tail of the linked list is set to null in the

CopyNextChunkElement method if the

// key of the next element does not match the current chunk's key, or
there are no more elements in the source.

private bool DoneCopyingChunk => tail == null;

// Adds one ChunkItem to the current group

// REQUIRES: !DoneCopyingChunk && lock(this)

private void CopyNextChunkElement()

// Try to advance the iterator on the source sequence.

// If MoveNext returns false we are at the end, and

isLastSourceElement is set to true

 isLastSourceElement = !enumerator.MoveNext();

// If we are (a) at the end of the source, or (b) at the end of the
current chunk

// then null out the enumerator and predicate for reuse with the
next chunk.

if (isLastSourceElement || !predicate(enumerator.Current))

enumerator = null;

predicate = null;

else

tail.Next = new ChunkItem(enumerator.Current);

// tail will be null if we are at the end of the chunk elements

// This check is made in DoneCopyingChunk.

tail = tail.Next!;

// Called after the end of the last chunk was reached. It first checks
whether

// there are more elements in the source sequence. If there are, it

// Returns true if enumerator for this chunk was exhausted.

internal bool CopyAllChunkElements()

while (true)

lock (m_Lock)

if (DoneCopyingChunk)

// If isLastSourceElement is false,

// it signals to the outer iterator

// to continue iterating.

return isLastSourceElement;

else

CopyNextChunkElement();

public TKey Key { get; }

// Invoked by the inner foreach loop. This method stays just one step
ahead

// of the client requests. It adds the next element of the chunk only
after

// the clients requests the last element in the list so far.

public IEnumerator<TSource> GetEnumerator()

 //Specify the initial element to enumerate.

ChunkItem current = head;

// There should always be at least one ChunkItem in a Chunk.

while (current != null)

// Yield the current item in the list.

yield return current.Value;

// Copy the next item from the source sequence,

// if we are at the end of our local list.

lock (m_Lock)

if (current == tail)

CopyNextChunkElement();

// Move to the next ChunkItem in the list.

current = current.Next;

System.Collections.IEnumerator
System.Collections.IEnumerable.GetEnumerator() => GetEnumerator();

public static class GroupByContiguousKeys

// The source sequence.

static readonly KeyValuePair<string, string>[] list = {

new("A","We"),

new("A","think"),

new("A","that"),

new("B","LINQ"),

new("C","is"),

new ("A","really"),

new("B","cool"),

new("B","!")

};

// Query variable declared as class member to be available

// on different threads.

static readonly IEnumerable<IGrouping<string, KeyValuePair<string,

string>>> query =

list.ChunkBy(p => p.Key);

public static void GroupByContiguousKeys1()

// ChunkBy returns IGrouping objects, therefore a nested

// foreach loop is required to access the elements in each "chunk".

foreach (var item in query)

Console.WriteLine($"Group key = {item.Key}");

 foreach (var inner in item)

Console.WriteLine($"\t{inner.Value}");

Vea también
Language-Integrated Query (LINQ)
Especificación de filtros con predicado
de forma dinámica en tiempo de
ejecución
Artículo • 09/03/2023 • Tiempo de lectura: 2 minutos

En algunos casos, no se conoce cuántos predicados hay que aplicar a los elementos de
origen de la cláusula where hasta el tiempo de ejecución. Una forma de especificar
dinámicamente varios filtros con predicado es usar el método Contains, como se
muestra en el ejemplo siguiente. La consulta devolverá resultados distintos en función
del valor de id al ejecutarse la consulta.

C#

int[] ids = { 111, 114, 112 };

var queryNames =

from student in students

where ids.Contains(student.ID)

select new

student.LastName,

student.ID

};

foreach (var name in queryNames)

Console.WriteLine($"{name.LastName}: {name.ID}");

/* Output:

Garcia: 114

O'Donnell: 112

Omelchenko: 111

*/

// Change the ids.

ids = new[] { 122, 117, 120, 115 };

// The query will now return different results

foreach (var name in queryNames)

Console.WriteLine($"{name.LastName}: {name.ID}");

/* Output:

Adams: 120

Feng: 117

 Garcia: 115

Tucker: 122

*/

Uso de consultas diferentes en tiempo de

ejecución
Puede usar instrucciones de flujo de control, como if... else o switch , para
seleccionar entre consultas alternativas predeterminadas. En el ejemplo siguiente,
studentQuery usa una cláusula where diferente si el valor en tiempo de ejecución de

oddYear es true o false .

C#

void FilterByYearType(bool oddYear)

IEnumerable<Student> studentQuery;

if (oddYear)

studentQuery =

from student in students

where student.Year == GradeLevel.FirstYear || student.Year ==

GradeLevel.ThirdYear

select student;

else

studentQuery =

from student in students

where student.Year == GradeLevel.SecondYear || student.Year ==

GradeLevel.FourthYear

select student;

string descr = oddYear ? "odd" : "even";

Console.WriteLine($"The following students are at an {descr} year

level:");

foreach (Student name in studentQuery)

Console.WriteLine($"{name.LastName}: {name.ID}");

FilterByYearType(true);

/* Output:

The following students are at an odd year level:

Fakhouri: 116

Feng: 117

 Garcia: 115

Mortensen: 113

Tucker: 119

Tucker: 122

*/

FilterByYearType(false);

/* Output:

The following students are at an even year level:

Adams: 120

Garcia: 114

Garcia: 118

O'Donnell: 112

Omelchenko: 111

Zabokritski: 121

*/

Vea también
Language-Integrated Query (LINQ)
where (cláusula)
Consultas basadas en el estado del entorno de ejecución
Realizar combinaciones internas
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

En términos de la base de datos relacional, una combinación interna genera un conjunto

de resultados en el que cada elemento de la primera colección aparece una vez para
cada elemento coincidente en la segunda colección. Si un elemento de la primera
colección no tiene ningún elemento coincidente, no aparece en el conjunto de
resultados. El método Join, que se llama mediante la cláusula join de C#, implementa
una combinación interna.

En este artículo se muestra cómo realizar cuatro variaciones de una combinación

interna:

Una combinación interna simple que correlaciona elementos de dos orígenes de

datos según una clave simple.

Una combinación interna que correlaciona elementos de dos orígenes de datos

según una clave compuesta. Una clave compuesta, que es una clave formada por
más de un valor, permite correlacionar elementos en función de más de una
propiedad.

Una combinación múltiple en la que las sucesivas operaciones de combinación se

anexan entre sí.

Una combinación interna que se implementa mediante una combinación

agrupada.

７ Nota

Los ejemplos de este tema utilizan las siguientes clases de datos:

C#

record Person(string FirstName, string LastName);

record Pet(string Name, Person Owner);

record Employee(string FirstName, string LastName, int EmployeeID);

record Cat(string Name, Person Owner) : Pet(Name, Owner);

record Dog(string Name, Person Owner) : Pet(Name, Owner);

así como la clase Student de Consulta de una colección de objetos.

Ejemplo: Combinación de clave simple
En el ejemplo siguiente se crean dos colecciones que contienen objetos de dos tipos
definidos por el usuario, Person y Pet . La consulta usa la cláusula join de C# para
emparejar objetos Person con objetos Pet cuyo Owner sea ese Person . La cláusula
select de C# define el aspecto que tendrán los objetos resultantes. En este ejemplo, los

objetos resultantes son tipos anónimos que consisten en el nombre de propietario y el

nombre de mascota.

C#

Person magnus = new(FirstName: "Magnus", LastName: "Hedlund");

Person terry = new("Terry", "Adams");

Person charlotte = new("Charlotte", "Weiss");

Person arlene = new("Arlene", "Huff");

Person rui = new("Rui", "Raposo");

List<Person> people = new() { magnus, terry, charlotte, arlene, rui };

List<Pet> pets = new()

new(Name: "Barley", Owner: terry),

new("Boots", terry),

new("Whiskers", charlotte),

new("Blue Moon", rui),

new("Daisy", magnus),

};

// Create a collection of person-pet pairs. Each element in the collection

// is an anonymous type containing both the person's name and their pet's
name.

var query =

from person in people

join pet in pets on person equals pet.Owner

select new

OwnerName = person.FirstName,

PetName = pet.Name

};

foreach (var ownerAndPet in query)

Console.WriteLine($"\"{ownerAndPet.PetName}\" is owned by
{ownerAndPet.OwnerName}");

/* Output:

"Daisy" is owned by Magnus

"Barley" is owned by Terry

"Boots" is owned by Terry

"Whiskers" is owned by Charlotte

 "Blue Moon" is owned by Rui

*/

Tenga en cuenta que el objeto Person cuyo LastName es "Huff" no aparece en el

conjunto de resultados porque no hay ningún objeto Pet que tenga Pet.Owner igual
que Person .

Ejemplo: Combinación de clave compuesta

En lugar de correlacionar elementos en función de una sola propiedad, puede usar una
clave compuesta para comparar elementos según varias propiedades. Para ello,
especifique la función del selector de claves de cada colección para que devuelva un
tipo anónimo que conste de las propiedades que quiere comparar. Si etiqueta las
propiedades, deben tener la misma etiqueta de tipo anónimo en cada clave. Las
propiedades también deben aparecer en el mismo orden.

En el ejemplo siguiente se usa una lista de objetos Employee y una lista de objetos
Student para determinar qué empleados son también alumnos. Estos dos tipos tienen

una propiedad FirstName y una propiedad LastName de tipo String. Las funciones que
crean las claves de combinación de los elementos de cada lista devuelven un tipo
anónimo formado por las propiedades FirstName y LastName de cada elemento. La
operación de combinación compara la igualdad de estas claves compuestas y devuelve
pares de objetos de cada lista en los que el nombre y el apellido coinciden.

C#

List<Employee> employees = new()

new(FirstName: "Terry", LastName: "Adams", EmployeeID: 522459),

new("Charlotte", "Weiss", 204467),

new("Magnus", "Hedland", 866200),

new("Vernette", "Price", 437139)

};

List<Student> students = new()

new(FirstName: "Vernette", LastName: "Price", StudentID: 9562),

new("Terry", "Earls", 9870),

new("Terry", "Adams", 9913)

};

// Join the two data sources based on a composite key consisting of first
and last name,

// to determine which employees are also students.

var query =

from employee in employees

 join student in students on new

employee.FirstName,

employee.LastName

} equals new

student.FirstName,

student.LastName

select employee.FirstName + " " + employee.LastName;

Console.WriteLine("The following people are both employees and students:");

foreach (string name in query)

Console.WriteLine(name);

/* Output:

The following people are both employees and students:

Terry Adams

Vernette Price

*/

Ejemplo: Combinación múltiple

Se puede anexar cualquier número de operaciones de combinación entre sí para realizar
una combinación múltiple. Cada cláusula join de C# correlaciona un origen de datos
especificado con los resultados de la combinación anterior.

En el ejemplo siguiente se crean tres colecciones: una lista de objetos Person , una lista
de objetos Cat y una lista de objetos Dog .

La primera cláusula join de C# empareja personas y gatos según un objeto Person que
coincida con Cat.Owner . Devuelve una secuencia de tipos anónimos que contienen el
objeto Person y Cat.Name .

La segunda cláusula join de C# correlaciona los tipos anónimos devueltos por la

primera combinación con objetos Dog de la lista de perros proporcionada, según una
clave compuesta formada por la propiedad Owner de tipo Person y la primera letra del
nombre del animal. Devuelve una secuencia de tipos anónimos que contienen las
propiedades Cat.Name y Dog.Name de cada par coincidente. Como se trata de una
combinación interna, solo se devuelven los objetos del primer origen de datos que
tienen una correspondencia en el segundo origen de datos.

C#
Person magnus = new(FirstName: "Magnus", LastName: "Hedlund");

Person terry = new("Terry", "Adams");

Person charlotte = new("Charlotte", "Weiss");

Person arlene = new("Arlene", "Huff");

Person rui = new("Rui", "Raposo");

Person phyllis = new("Phyllis", "Harris");

List<Person> people = new() { magnus, terry, charlotte, arlene, rui, phyllis

};

List<Cat> cats = new()

new(Name: "Barley", Owner: terry),

new("Boots", terry),

new("Whiskers", charlotte),

new("Blue Moon", rui),

new("Daisy", magnus),

};

List<Dog> dogs = new()

new(Name: "Four Wheel Drive", Owner: phyllis),

new("Duke", magnus),

new("Denim", terry),

new("Wiley", charlotte),

new("Snoopy", rui),
new("Snickers", arlene),

};

// The first join matches Person and Cat.Owner from the list of people and

// cats, based on a common Person. The second join matches dogs whose names
start

// with the same letter as the cats that have the same owner.

var query =

from person in people

join cat in cats on person equals cat.Owner

join dog in dogs on new

Owner = person,

Letter = cat.Name.Substring(0, 1)

} equals new

dog.Owner,

Letter = dog.Name.Substring(0, 1)

select new

CatName = cat.Name,

DogName = dog.Name

};

foreach (var obj in query)

Console.WriteLine(

 $"The cat \"{obj.CatName}\" shares a house, and the first letter of

their name, with \"{obj.DogName}\"."

);

/* Output:

The cat "Daisy" shares a house, and the first letter of their name,
with "Duke".

The cat "Whiskers" shares a house, and the first letter of their name,
with "Wiley".

*/

Ejemplo: Combinación interna mediante

combinación agrupada
El ejemplo siguiente muestra cómo implementar una combinación interna mediante una
combinación agrupada.

En query1 , la lista de objetos Person forma una combinación agrupada con la lista de
objetos Pet según el Person que coincide con la propiedad Pet.Owner . La combinación
agrupada crea una colección de grupos intermedios, donde cada grupo consta de un
objeto Person y una secuencia de objetos Pet coincidentes.

Al agregar una segunda cláusula from a la consulta, esta secuencia de secuencias se

combina (se acopla) en una secuencia mayor. El tipo de los elementos de la secuencia
final se especifica con la cláusula select . En este ejemplo, ese tipo es un tipo anónimo
que consta de las propiedades Person.FirstName y Pet.Name de cada par coincidente.

El resultado de query1 es equivalente al conjunto de resultados que se habría obtenido

con la cláusula join sin la cláusula into para realizar una combinación interna. La
variable query2 muestra esta consulta equivalente.

C#

Person magnus = new(FirstName: "Magnus", LastName: "Hedlund");

Person terry = new("Terry", "Adams");

Person charlotte = new("Charlotte", "Weiss");

Person arlene = new("Arlene", "Huff");

List<Person> people = new() { magnus, terry, charlotte, arlene };

List<Pet> pets = new()

new(Name: "Barley", Owner: terry),

new("Boots", terry),

new("Whiskers", charlotte),

 new("Blue Moon", terry),

new("Daisy", magnus),

};

var query1 =

from person in people

join pet in pets on person equals pet.Owner into gj

from subpet in gj

select new

OwnerName = person.FirstName,

PetName = subpet.Name

};

Console.WriteLine("Inner join using GroupJoin():");

foreach (var v in query1)

Console.WriteLine($"{v.OwnerName} - {v.PetName}");

var query2 =

from person in people

join pet in pets on person equals pet.Owner

select new

OwnerName = person.FirstName,

PetName = pet.Name

};

Console.WriteLine();

Console.WriteLine("The equivalent operation using Join():");

foreach (var v in query2)

Console.WriteLine($"{v.OwnerName} - {v.PetName}");

/* Output:

Inner join using GroupJoin():

Magnus - Daisy

Terry - Barley

Terry - Boots

Terry - Blue Moon

Charlotte - Whiskers

The equivalent operation using Join():

Magnus - Daisy

Terry - Barley

Terry - Boots

Terry - Blue Moon

Charlotte - Whiskers

*/

Consulte también
Join
GroupJoin
Realizar combinaciones agrupadas
Realizar operaciones de combinación externa izquierda
Tipos anónimos (Guía de programación de C#).
Realizar combinaciones agrupadas
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

La combinación agrupada resulta útil para generar estructuras de datos jerárquicas.

Empareja cada elemento de la primera colección con un conjunto de elementos
correlacionados de la segunda colección.

Por ejemplo, una clase o una tabla de base de datos relacional denominada Student
podría contener dos campos: Id y Name . Una segunda clase o tabla de base de datos
relacional denominada Course podría contener dos campos: StudentId y CourseTitle .
Una combinación agrupada de estos dos orígenes de datos, basada en la combinación
de Student.Id y Course.StudentId , agruparía cada Student con una colección de
objetos Course (que podrían estar vacíos).

７ Nota

Cada elemento de la primera colección aparece en el conjunto de resultados de

una combinación agrupada, independientemente de si se encuentran elementos
correlacionados en la segunda colección. En el caso de que no se encuentren
elementos correlacionados, la secuencia de elementos correlacionados para ese
elemento estaría vacía. Por consiguiente, el selector de resultados tiene acceso a
cada uno de los elementos de la primera colección. Esto difiere del selector de
resultados en una combinación no agrupada, que no puede acceder a los
elementos de la primera colección que no tienen ninguna coincidencia en la
segunda colección.

２ Advertencia

Enumerable.GroupJoin no tiene ningún equivalente directo en términos de base

de datos relacional tradicional. Sin embargo, este método implementa un
superconjunto de combinaciones internas y combinaciones externas izquierdas.
Ambas operaciones se pueden escribir en términos de una combinación agrupada.
Para obtener más información, consulte Operaciones de combinación y Entity
Framework Core, GroupJoin.

En el primer ejemplo de este artículo se muestra cómo realizar una combinación

agrupada. En el segundo ejemplo se muestra cómo usar una combinación agrupada
para crear elementos XML.
 ７ Nota

En los ejemplos de este tema se usan las clases de datos Person y Pet de
Realización de combinaciones internas.

Ejemplo: Combinación agrupada

En el ejemplo siguiente se realiza una combinación agrupada de objetos de tipo Person
y Pet basada en la coincidencia de Person con la propiedad Pet.Owner . A diferencia de
una combinación no agrupada, que generaría un par de elementos para cada
coincidencia, la combinación agrupada produce un único objeto resultante para cada
elemento de la primera colección, que en este ejemplo es un objeto Person . Los
elementos correspondientes de la segunda colección, que en este ejemplo son objetos
Pet , se agrupan en una colección. Por último, la función de selector de resultados crea
un tipo anónimo para cada coincidencia formada por Person.FirstName y una colección
de objetos Pet .

C#

Person magnus = new(FirstName: "Magnus", LastName: "Hedlund");

Person terry = new("Terry", "Adams");

Person charlotte = new("Charlotte", "Weiss");

Person arlene = new("Arlene", "Huff");

List<Person> people = new() { magnus, terry, charlotte, arlene };

List<Pet> pets = new()

new(Name: "Barley", Owner: terry),

new("Boots", terry),

new("Whiskers", charlotte),

new("Blue Moon", terry),

new("Daisy", magnus),

};

// Create a list where each element is an anonymous type

// that contains the person's first name and a collection of

// pets that are owned by them.

var query =

from person in people

join pet in pets on person equals pet.Owner into gj

select new

OwnerName = person.FirstName,

Pets = gj

};

 foreach (var v in query)

// Output the owner's name.

Console.WriteLine($"{v.OwnerName}:");

// Output each of the owner's pet's names.

foreach (var pet in v.Pets)

Console.WriteLine($" {pet.Name}");

/* Output:

Magnus:

Daisy

Terry:

Barley

Boots

Blue Moon

Charlotte:

Whiskers

Arlene:

*/

Ejemplo: Combinación agrupada para crear

XML
Las combinaciones agrupadas resultan ideales para crear XML con LINQ to XML. El
siguiente ejemplo es similar al anterior, pero en lugar de crear tipos anónimos, la
función de selector de resultados crea elementos XML que representan los objetos
combinados.

C#

// using System.Xml.Linq;

Person magnus = new(FirstName: "Magnus", LastName: "Hedlund");

Person terry = new("Terry", "Adams");

Person charlotte = new("Charlotte", "Weiss");

Person arlene = new("Arlene", "Huff");

List<Person> people = new() { magnus, terry, charlotte, arlene };

List<Pet> pets = new()

new(Name: "Barley", Owner: terry),

new("Boots", terry),

new("Whiskers", charlotte),

new("Blue Moon", terry),

new("Daisy", magnus),

 };

XElement ownersAndPets = new("PetOwners",

from person in people

join pet in pets on person equals pet.Owner into gj

select new XElement("Person",

new XAttribute("FirstName", person.FirstName),

new XAttribute("LastName", person.LastName),

from subpet in gj

select new XElement("Pet", subpet.Name)

);

Console.WriteLine(ownersAndPets);

/* Output:

<PetOwners>

<Person FirstName="Magnus" LastName="Hedlund">

<Pet>Daisy</Pet>

</Person>

<Person FirstName="Terry" LastName="Adams">

<Pet>Barley</Pet>

<Pet>Boots</Pet>

<Pet>Blue Moon</Pet>

</Person>

<Person FirstName="Charlotte" LastName="Weiss">

<Pet>Whiskers</Pet>

</Person>

<Person FirstName="Arlene" LastName="Huff" />

</PetOwners>

*/

Vea también
Join
GroupJoin
Realizar combinaciones internas
Realizar operaciones de combinación externa izquierda
Tipos anónimos (Guía de programación de C#).
Realizar operaciones de combinación
externa izquierda
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Una combinación externa izquierda es una combinación en la que se devuelve cada

elemento de la primera colección, independientemente de si tiene elementos
correlacionados en la segunda colección. Puede usar LINQ para realizar una
combinación externa izquierda llamando al método DefaultIfEmpty en los resultados de
una combinación agrupada.

７ Nota

En el ejemplo de este tema se usan las clases de datos Pet y Person de Realizar
combinaciones internas.

Ejemplo
En el ejemplo siguiente se muestra cómo usar el método DefaultIfEmpty en los
resultados de una combinación agrupada para realizar una combinación externa
izquierda.

El primer paso para generar una combinación externa izquierda de dos colecciones
consiste en realizar una combinación interna usando una combinación agrupada.
(Consulte Realizar combinaciones internas para obtener una explicación de este
proceso). En este ejemplo, la lista de objetos Person está combinada internamente con
la lista de objetos Pet en función de un objeto Person que coincide con Pet.Owner .

El segundo paso consiste en incluir cada elemento de la primera colección (izquierda) en

el conjunto de resultados, incluso cuando no haya coincidencias en la colección
derecha. Esto se realiza llamando a DefaultIfEmpty en cada secuencia de elementos
coincidentes de la combinación agrupada. En este ejemplo, se llama a DefaultIfEmpty en
cada secuencia de objetos Pet coincidentes. El método devuelve una colección que
contiene un único, valor predeterminado si la secuencia de objetos Pet coincidentes
está vacía para cualquier objeto Person , con lo que cada objeto Person se representa en
la colección de resultados.

７ Nota
 El valor predeterminado para un tipo de referencia es null ; por consiguiente, el
ejemplo busca una referencia NULL antes de tener acceso a cada elemento de cada
colección de Pet .

C#

Person magnus = new("Magnus", "Hedlund");

Person terry = new("Terry", "Adams");

Person charlotte = new("Charlotte", "Weiss");

Person arlene = new("Arlene", "Huff");

Pet barley = new("Barley", terry);

Pet boots = new("Boots", terry);

Pet whiskers = new("Whiskers", charlotte);

Pet bluemoon = new("Blue Moon", terry);

Pet daisy = new("Daisy", magnus);

// Create two lists.

List<Person> people = new() { magnus, terry, charlotte, arlene };

List<Pet> pets = new() { barley, boots, whiskers, bluemoon, daisy };

var query =

from person in people

join pet in pets on person equals pet.Owner into gj

from subpet in gj.DefaultIfEmpty()

select new

person.FirstName,

PetName = subpet?.Name ?? string.Empty

};

foreach (var v in query)

Console.WriteLine($"{v.FirstName + ":",-15}{v.PetName}");

record class Person(string FirstName, string LastName);

record class Pet(string Name, Person Owner);

// This code produces the following output:

//

// Magnus: Daisy

// Terry: Barley

// Terry: Boots

// Terry: Blue Moon

// Charlotte: Whiskers

// Arlene:

Vea también
Join
GroupJoin
Realizar combinaciones internas
Realizar combinaciones agrupadas
Tipos anónimos (Guía de programación de C#).
Ordenar los resultados de una cláusula
join
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo ordenar los resultados de una operación de

combinación. Observe que la ordenación se realiza después de la combinación. Aunque
puede usar una cláusula orderby con una o varias de las secuencias de origen antes de
la combinación, normalmente no se recomienda. Algunos proveedores LINQ podrían no
conservar esa ordenación después de la combinación.

７ Nota

El ejemplo de este tema usa las siguientes clases de datos:

C#

record Product(string Name, int CategoryID);

record Category(string Name, int ID);

Ejemplo
Esta consulta crea una combinación agrupada y luego ordena los grupos según el
elemento categoría, que todavía está en el ámbito. Dentro del inicializador de tipo
anónimo, una subconsulta ordena todos los elementos coincidentes de la secuencia de
productos.

C#

List<Category> categories = new()

new(Name: "Beverages", ID: 001),

new("Condiments", 002),

new("Vegetables", 003),

new("Grains", 004),

new("Fruit", 005)

};

List<Product> products = new()

new(Name: "Cola", CategoryID: 001),

new("Tea", 001),

new("Mustard", 002),

 new("Pickles", 002),

new("Carrots", 003),

new("Bok Choy", 003),

new("Peaches", 005),

new("Melons", 005),

};

var groupJoinQuery2 =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

orderby category.Name

select new

Category = category.Name,
Products =

from prod2 in prodGroup

orderby prod2.Name

select prod2

};

foreach (var productGroup in groupJoinQuery2)

Console.WriteLine(productGroup.Category);

foreach (var prodItem in productGroup.Products)

Console.WriteLine($" {prodItem.Name,-10} {prodItem.CategoryID}");

/* Output:

Beverages

Cola 1

Tea 1

Condiments

Mustard 2

Pickles 2

Fruit

Melons 5

Peaches 5

Grains

Vegetables

Bok Choy 3

Carrots 3

*/

Vea también
Language-Integrated Query (LINQ)
orderby (cláusula)
join (cláusula)
Realizar una unión usando claves
compuestas
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo realizar operaciones de combinación en las que se

quiere usar más de una clave para definir a una coincidencia. Esto se logra mediante una
clave compuesta. Una clave compuesta se crea como un tipo anónimo o un nombre con
tipo con los valores que se quieren comparar. Si la variable de consulta se pasará a
través de límites de método, use un tipo con nombre que invalida Equals y
GetHashCode para la clave. Los nombres de las propiedades y el orden en que aparecen
deben ser idénticos en cada clave.

Ejemplo
En el ejemplo siguiente se muestra cómo usar una clave compuesta para combinar
datos de tres tablas:

C#

var query = from o in db.Orders

from p in db.Products

join d in db.OrderDetails

on new {o.OrderID, p.ProductID} equals new {d.OrderID, d.ProductID}

into details

from d in details

select new {o.OrderID, p.ProductID, d.UnitPrice};

La inferencia de tipos en las claves compuestas depende de los nombres de las

propiedades de las claves y el orden en que aparecen. Si las propiedades de las
secuencias de origen no tienen los mismos nombres, deberá asignar nombres nuevos
en las claves. Por ejemplo, si la tabla Orders y la tabla OrderDetails usan nombres
diferentes para las columnas, se podrían crear claves compuestas asignando nombres
idénticos a los tipos anónimos:

C#

join...on new {Name = o.CustomerName, ID = o.CustID} equals

new {Name = d.CustName, ID = d.CustID }

Las claves compuestas también se pueden usar en una cláusula group .

Vea también
Language-Integrated Query (LINQ)
join (cláusula)
group (cláusula)
Realizar operaciones de combinación
personalizadas
Artículo • 10/02/2023 • Tiempo de lectura: 4 minutos

En este ejemplo se muestra cómo realizar operaciones de combinación que no son

posibles con la cláusula join . En una expresión de consulta, la cláusula join se limita a
combinaciones de igualdad (y se optimiza para estas), que son con diferencia el tipo
más común de operación de combinación. Al realizar una combinación de igualdad,
probablemente obtendrá siempre el mejor rendimiento con la cláusula join .

En cambio, la cláusula join no se puede usar en los siguientes casos:

Cuando la combinación se basa en una expresión de desigualdad (una

combinación que no es de igualdad).

Cuando la combinación se basa en más de una expresión de igualdad o

desigualdad.

Cuando tenga que introducir una variable de rango temporal para la secuencia de
la derecha (interior) antes de la operación de combinación.

Para realizar combinaciones que no son de igualdad, puede usar varias cláusulas from
para presentar cada origen de datos de forma independiente. Después, aplique una
expresión de predicado de una cláusula where a la variable de rango para cada origen.
La expresión también puede adoptar la forma de una llamada de método.

７ Nota

No confunda este tipo de operación de combinación personalizada con el uso de

varias cláusulas from para acceder a colecciones internas. Para obtener más
información, vea join (Cláusula, Referencia de C#).

Combinación cruzada

７ Nota

En este ejemplo y en el que le sigue se usan las definiciones Product y Category de

Ordenar los resultados de una cláusula “join”.
Esta consulta muestra una combinación cruzada simple. Las combinaciones cruzadas se
deben usar con precaución porque pueden generar conjuntos de resultados muy
grandes. En cambio, pueden resultar útiles en algunos escenarios para crear secuencias
de origen en las que se ejecutan consultas adicionales.

C#

List<Category> categories = new()

new(Name: "Beverages", ID: 001),

new("Condiments", 002),

new("Vegetables", 003)

};

List<Product> products = new()

new(Name: "Tea", CategoryID: 001),

new("Mustard", 002),

new("Pickles", 002),

new("Carrots", 003),

new("Bok Choy", 003),

new("Peaches", 005),

new("Melons", 005),

new("Ice Cream", 007),

new("Mackerel", 012)

};

var crossJoinQuery =

from c in categories

from p in products

select new

c.ID,

p.Name

};

Console.WriteLine("Cross Join Query:");

foreach (var v in crossJoinQuery)

Console.WriteLine($"{v.ID,-5}{v.Name}");

/* Output:

Cross Join Query:

1 Tea

1 Mustard

1 Pickles

1 Carrots

1 Bok Choy

1 Peaches

1 Melons

1 Ice Cream

1 Mackerel

2 Tea

 2 Mustard

2 Pickles

2 Carrots

2 Bok Choy

2 Peaches

2 Melons

2 Ice Cream

2 Mackerel

3 Tea

3 Mustard

3 Pickles

3 Carrots

3 Bok Choy

3 Peaches

3 Melons

3 Ice Cream

3 Mackerel

*/

Combinaciones de desigualdad
Esta consulta genera una secuencia de todos los productos cuyo Id. de categoría
aparece en la lista de categorías en el lado izquierdo. Observe el uso de la cláusula let
y el método Contains para crear una matriz temporal. También se puede crear la matriz
antes de la consulta y eliminar la primera cláusula from .

C#

var nonEquijoinQuery =

from p in products

let catIds =

from c in categories

select c.ID

where catIds.Contains(p.CategoryID) == true

select new

Product = p.Name,

p.CategoryID

};

Console.WriteLine("Non-equijoin query:");

foreach (var v in nonEquijoinQuery)

Console.WriteLine($"{v.CategoryID,-5}{v.Product}");

/* Output:

Non-equijoin query:

1 Tea

2 Mustard

 2 Pickles

3 Carrots

3 Bok Choy

*/

Combinar archivos CSV

En el ejemplo siguiente, la consulta debe combinar dos secuencias basándose en las
claves coincidentes que, en el caso de la secuencia interna (lado derecho), no se pueden
obtener antes de la propia cláusula de combinación. Si esta combinación se realizara
con una cláusula join , se tendría que llamar al método Split para cada elemento. El
uso de varias cláusulas from permite a la consulta evitar la sobrecarga que supone la
llamada al método repetida. En cambio, puesto que join está optimizada, en este caso
particular puede que siga resultando más rápido que usar varias cláusulas from . Los
resultados variarán dependiendo principalmente de cuántos recursos requiera la
llamada de método.

C#

string[] names = File.ReadAllLines(@"csv/names.csv");

string[] scores = File.ReadAllLines(@"csv/scores.csv");

// Merge the data sources using a named type.

// You could use var instead of an explicit type for the query.

IEnumerable<Student> queryNamesScores =

// Split each line in the data files into an array of strings.

from name in names

let x = name.Split(',')

from score in scores

let s = score.Split(',')

// Look for matching IDs from the two data files.

where x[2] == s[0]

// If the IDs match, build a Student object.

select new Student(

FirstName: x[0],

LastName: x[1],

StudentID: int.Parse(x[2]),

ExamScores: (

from scoreAsText in s.Skip(1)

select int.Parse(scoreAsText)

).ToList()

);

// Optional. Store the newly created student objects in memory

// for faster access in future queries

List<Student> students = queryNamesScores.ToList();

foreach (var student in students)

Console.WriteLine($"The average score of {student.FirstName}

{student.LastName} is {student.ExamScores.Average()}.");

/* Output:

The average score of Omelchenko Svetlana is 82.5.

The average score of O'Donnell Claire is 72.25.

The average score of Mortensen Sven is 84.5.

The average score of Garcia Cesar is 88.25.

The average score of Garcia Debra is 67.

The average score of Fakhouri Fadi is 92.25.

The average score of Feng Hanying is 88.

The average score of Garcia Hugo is 85.75.

The average score of Tucker Lance is 81.75.

The average score of Adams Terry is 85.25.

The average score of Zabokritski Eugene is 83.

The average score of Tucker Michael is 92.

*/

Vea también
Language-Integrated Query (LINQ)
join (cláusula)
Ordenar los resultados de una cláusula join
Controlar valores nulos en expresiones
de consulta
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo controlar los posibles valores nulos en colecciones de
origen. Una colección de objetos como IEnumerable<T> puede contener elementos
cuyo valor es NULL. Si una colección de origen es null o contiene un elemento cuyo
valor es null , y la consulta no controla los valores null , se iniciará un elemento
NullReferenceException cuando se ejecute la consulta.

Se pueden codificar de forma defensiva para evitar una excepción de referencia nula, tal
y como se muestra en el ejemplo siguiente:

C#

var query1 =

from c in categories

where c != null

join p in products on c.ID equals p?.CategoryID

select new

Category = c.Name,

Name = p.Name

};

En el ejemplo anterior, la cláusula where filtra todos los elementos nulos de la secuencia
de categorías. Esta técnica es independiente de la comprobación de null en la cláusula
join. La expresión condicional con NULL de este ejemplo funciona porque
Products.CategoryID es de tipo int? , que es una abreviatura de Nullable<int> .

En una cláusula join, si solo una de las claves de comparación es de un tipo que acepta
valores NULL, puede convertir la otra en un tipo que acepta valores NULL en la
expresión de consulta. En el ejemplo siguiente, suponga que EmployeeID es una
columna que contiene valores de tipo int? :

C#

void TestMethod(Northwind db)

var query =

from o in db.Orders

join e in db.Employees

on o.EmployeeID equals (int?)e.EmployeeID

 select new { o.OrderID, e.FirstName };

En cada uno de los ejemplos, se usa la palabra clave de consulta equals . C# 9 agrega
una coincidencia de patrones, que incluye patrones para is null y is not null . Estos
patrones no se recomiendan en las consultas LINQ porque es posible que los
proveedores de consultas no interpreten correctamente la sintaxis nueva de C#. Un
proveedor de consultas es una biblioteca que traduce expresiones de consulta de C# a
un formato de datos nativo, como Entity Framework Core. Los proveedores de consultas
implementan la interfaz System.Linq.IQueryProvider para crear orígenes de datos que
implementan la interfaz System.Linq.IQueryable<T>.

Vea también
Nullable<T>
Language-Integrated Query (LINQ)
Tipos de valores que aceptan valores NULL
Controlar excepciones en expresiones
de consulta
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Es posible llamar a cualquier método en el contexto de una expresión de consulta. Pero

se recomienda evitar llamar a cualquier método en una expresión de consulta que
pueda crear un efecto secundario, como modificar el contenido del origen de datos o
producir una excepción. En este ejemplo se muestra cómo evitar que se produzcan
excepciones al llamar a métodos en una expresión de consulta sin infringir las
instrucciones generales de .NET sobre el control de excepciones. En esas instrucciones
se indica que es aceptable detectar una excepción concreta cuando se comprende por
qué se produce en un contexto determinado. Para obtener más información, vea
Procedimientos recomendados para excepciones.

En el último ejemplo se muestra cómo controlar los casos en los que se debe producir
una excepción durante la ejecución de una consulta.

Ejemplo 1
En el ejemplo siguiente se muestra cómo mover código de control de excepciones fuera
de una expresión de consulta. Esto solo es posible cuando el método no depende de
ninguna variable local de la consulta.

C#

// A data source that is very likely to throw an exception!

IEnumerable<int> GetData() => throw new InvalidOperationException();

// DO THIS with a datasource that might

// throw an exception. It is easier to deal with

// outside of the query expression.

IEnumerable<int>? dataSource = null;

try

dataSource = GetData();

catch (InvalidOperationException)
{

// Handle (or don't handle) the exception

// in the way that is appropriate for your application.

Console.WriteLine("Invalid operation");

if (dataSource is not null)

// If we get here, it is safe to proceed.

var query =

from i in dataSource

select i * i;

foreach (var i in query)

Console.WriteLine(i.ToString());

Ejemplo 2
En algunos casos, la mejor respuesta a una excepción que se produce dentro de una
consulta podría ser detener la ejecución de la consulta inmediatamente. En el ejemplo
siguiente se muestra cómo controlar las excepciones que pueden producirse desde el
cuerpo de una consulta. Supongamos que SomeMethodThatMightThrow puede producir
una excepción que requiere que se detenga la ejecución de la consulta.

Tenga en cuenta que el bloque try encierra el bucle foreach y no la propia consulta.
Esto es porque el bucle foreach es el punto en el que se ejecuta realmente la consulta.
Para más información, vea Introducción a las consultas LINQ.

C#

// Not very useful as a general purpose method.

string SomeMethodThatMightThrow(string s) =>

s[4] == 'C' ?

throw new InvalidOperationException() :

@"C:\newFolder\" + s;

// Data source.

string[] files = { "fileA.txt", "fileB.txt", "fileC.txt" };

// Demonstration query that throws.

var exceptionDemoQuery =

from file in files

let n = SomeMethodThatMightThrow(file)

select n;

// The runtime exception will only be thrown when the query is executed.

// Therefore they must be handled in the foreach loop.

try

foreach (var item in exceptionDemoQuery)

Console.WriteLine($"Processing {item}");

// Catch whatever exception you expect to raise

// and/or do any necessary cleanup in a finally block

catch (InvalidOperationException e)

Console.WriteLine(e.Message);
}

/* Output:

Processing C:\newFolder\fileA.txt

Processing C:\newFolder\fileB.txt

Operation is not valid due to the current state of the object.

*/

Vea también
Language-Integrated Query (LINQ)
Reduce memory allocations using new
C# features
Artículo • 14/02/2023 • Tiempo de lectura: 8 minutos

） Importante

The techniques described in this section improve performance when applied to hot
paths in your code. Hot paths are those sections of your codebase that are
executed often and repeatedly in normal operations. Applying these techniques to
code that isn't often executed will have minimal impact. Before making any
changes to improve performance, it's critical to measure a baseline. Then, analyze
that baseline to determine where memory bottlenecks occur. You can learn about
many cross platform tools to measure your application's performance in the section
on Diagnostics and instrumentation. You can practice a profiling session in the
tutorial to Measure memory usage in the Visual Studio documentation.

Once you've measured memory usage and have determined that you can reduce
allocations, use the techniques in this section to reduce allocations. After each
successive change, measure memory usage again. Make sure each change has a
positive impact on the memory usage in your application.

Performance work in .NET often means removing allocations from your code. Every
block of memory you allocate must eventually be freed. Fewer allocations reduce time
spent in garbage collection. It allows for more predictable execution time by removing
garbage collections from specific code paths.

A common tactic to reduce allocations is to change critical data structures from class
types to struct types. This change impacts the semantics of using those types.
Parameters and returns are now passed by value instead of by reference. The cost of
copying a value is negligible if the types are small, three words or less. It's measurable
and can have real performance impact for larger types. To combat the effect of copying,
developers can pass these types by ref to get back the intended semantics.

The C# ref features give you the ability to express the desired semantics for struct
types without negatively impacting their overall usability. Prior to these enhancements,
developers needed to resort to unsafe constructs with pointers and raw memory to
achieve the same performance impact. The compiler generates verifiably safe code for
the new ref related features. Verifiably safe code means the compiler detects possible
buffer overruns or accessing unallocated or freed memory. The compiler detects and
prevents some errors.

Pass and return by reference

Variables in C# store values. In struct types, the value is the contents of an instance of
the type. In class types, the value is a reference to a block of memory that stores an
instance of the type. Adding the ref modifier means that the variable stores the
reference to the value. In struct types, the reference points to the storage containing
the value. In class types, the reference points to the storage containing the reference to
the block of memory.

In C#, parameters to methods are passed by value, and return values are return by value.
The value of the argument is passed to the method. The value of the return argument is
the return value.

The ref , in , or out modifier indicates that parameter is passed by reference. The
reference to the storage location is passed to the method. Adding ref to the method
signature means the return value is returned by reference. The reference to the storage
location is the return value.

You can also use ref assignment to have a variable refer to another variable. A typical
assignment copies the value of the right hand side to the variable on the left hand side
of the assignment. A ref assignment copies the memory location of the variable on the
right hand side to the variable on the left hand side. The ref now refers to the original
variable:

C#

int anInteger = 42; // assignment.

ref int location = ref anInteger; // ref assignment.

ref int sameLocation = ref location; // ref assignment

Console.WriteLine(location); // output: 42

sameLocation = 19; // assignment

Console.WriteLine(anInteger); // output: 19

When you assign a variable, you change its value. When you ref assign a variable, you
change what it refers to.
You can work directly with the storage for values using ref variables, pass by reference,
and ref assignment. Scope rules enforced by the compiler ensure safety when working
directly with storage.

Ref safe to escape scope

C# includes rules for ref expressions to ensure that a ref expression can't be accessed
where the storage it refers to is no longer valid. Consider the following example:

C#

public ref int CantEscape()

int index = 42;

return ref index; // Error: index's ref safe to escape scope is the body
of CantEscape

The compiler reports an error because you can't return a reference to a local variable
from a method. The caller can't access the storage being referred to. The ref safe to
escape scope defines the scope in which a ref expression is safe to access or modify.
The following table lists the ref safe to escape scopes for variable types. ref fields can't
be declared in a class or a non-ref struct , so those those rows aren't in the table:

Declaration ref safe to escape scope

non-ref local block where local is declared

non-ref parameter current method

ref , in parameter calling method

out parameter current method

class field calling method

non-ref struct field current method

ref field of ref struct calling method

A variable can be ref returned if its ref safe to escape scope is the calling method. If its
ref safe to escape scope is the current method or a block, ref return is disallowed. The
following snippet shows two examples. A member field can be accessed from the scope
calling a method, so a class or struct field's ref safe to escape scope is the calling method.
The ref safe to escape scope for a parameter with the ref , or in modifiers is the entire
method. Both can be ref returned from a member method:

C#

private int anIndex;

public ref int RetrieveIndexRef()

return ref anIndex;

public ref int RefMin(ref int left, ref int right)

if (left < right)

return ref left;

else

return ref right;

７ Nota

When the in modifier is applied to a parameter, that parameter can be returned by

ref readonly , not ref .

The compiler ensures that a reference can't escape its ref safe to escape scope. You can
use ref parameters, ref return and ref local variables safely because the compiler
detects if you've accidentally written code where a ref expression could be accessed
when its storage isn't valid.

Safe to escape scope and ref structs

ref struct types require more rules to ensure they can be used safely. A ref struct
type may include ref fields. That requires the introduction of a safe to escape scope. For
most types, the safe to escape scope is the calling method. In other words, a value that's
not a ref struct can always be returned from a method.

Informally, the safe to escape scope for a ref struct is the scope where all of its ref
fields can be accessed. In other words, it's the intersection of the ref safe to escape
scopes of all its ref fields. The following method returns a ReadOnlySpan<char> to a
member field, so its safe to escape scope is the method:

C#
 private string longMessage = "This is a long message";

public ReadOnlySpan<char> Safe()

var span = longMessage.AsSpan();

return span;

In contrast, the following code emits an error because the ref field member of the
Span<int> refers to the stack allocated array of integers. It can't escape the method:

C#

public Span<int> M()

int length = 3;

Span<int> numbers = stackalloc int[length];

for (var i = 0; i < length; i++)

numbers[i] = i;

return numbers; // Error! numbers can't escape this method.

Unify memory types

The introduction of System.Span<T> and System.Memory<T> provide a unified model
for working with memory. System.ReadOnlySpan<T> and System.ReadOnlyMemory<T>
provide readonly versions for accessing memory. They all provide an abstraction over a
block of memory storing an array of similar elements. The difference is that Span<T> and
ReadOnlySpan<T> are ref struct types whereas Memory<T> and ReadOnlyMemory<T> are

struct types. Spans contain a ref field . Therefore instances of a span can't leave its
safe to escape scope. The safe to escape scope of a ref struct is the ref safe to escape
scope of its ref field . The implementation of Memory<T> and ReadOnlyMemory<T>
remove this restriction. You use these types to directly access memory buffers.

Improve performance with ref safety

Using these features to improve performance involves these tasks:

Avoid allocations: When you change a type from a class to a struct , you change
how it's stored. Local variables are stored on the stack. Members are stored inline
when the container object is allocated. This change means fewer allocations and
 that decreases the work the garbage collector does. It may also decrease memory
pressure so the garbage collector runs less often.
Preserve reference semantics: Changing a type from a class to a struct changes
the semantics of passing a variable to a method. Code that modified the state of
its parameters needs modification. Now that the parameter is a struct , the
method is modifying a copy of the original object. You can restore the original
semantics by passing that parameter as a ref parameter. After that change, the
method modifies the original struct again.
Avoid copying data: Copying larger struct types can impact performance in some
code paths. You can also add the ref modifier to pass larger data structures to
methods by reference instead of by value.
Restrict modifications: When a struct type is passed by reference, the called
method could modify the state of the struct. You can replace the ref modifier with
the in modifier to indicate that the argument can't be modified. You can also
create readonly struct types or struct types with readonly members to provide
more control over what members of a struct can be modified.
Directly manipulate memory: Some algorithms are most efficient when treating
data structures as a block of memory containing a sequence of elements. The Span
and Memory types provide safe access to blocks of memory.

None of these techniques require unsafe code. Used wisely, you can get performance
characteristics from safe code that was previously only possible by using unsafe
techniques. You can try the techniques yourself in the tutorial on reducing memory
allocations
Expression Trees
Artículo • 09/03/2023 • Tiempo de lectura: 4 minutos

Expression trees represent code in a tree-like data structure, where each node is an
expression, for example, a method call or a binary operation such as x < y .

If you have used LINQ, you have experience with a rich library where the Func types are
part of the API set. (If you aren't familiar with LINQ, you probably want to read the LINQ
tutorial and the article about lambda expressions before this one.) Expression Trees
provide richer interaction with the arguments that are functions.

You write function arguments, typically using Lambda Expressions, when you create
LINQ queries. In a typical LINQ query, those function arguments are transformed into a
delegate the compiler creates.

You've likely already written code that uses Expression trees. Entity Framework's LINQ
APIs accept Expression trees as the arguments for the LINQ Query Expression Pattern.
That enables Entity Framework to translate the query you wrote in C# into SQL that
executes in the database engine. Another example is Moq , which is a popular
mocking framework for .NET.

When you want to have a richer interaction, you need to use Expression Trees. Expression
Trees represent code as a structure that you examine, modify, or execute. These tools
give you the power to manipulate code during run time. You write code that examines
running algorithms, or injects new capabilities. In more advanced scenarios, you modify
running algorithms and even translate C# expressions into another form for execution in
another environment.

You compile and run code represented by expression trees. Building and running
expression trees enables dynamic modification of executable code, the execution of
LINQ queries in various databases, and the creation of dynamic queries. For more
information about expression trees in LINQ, see How to use expression trees to build
dynamic queries.

Expression trees are also used in the dynamic language runtime (DLR) to provide
interoperability between dynamic languages and .NET and to enable compiler writers to
emit expression trees instead of Microsoft intermediate language (MSIL). For more
information about the DLR, see Dynamic Language Runtime Overview.

You can have the C# or Visual Basic compiler create an expression tree for you based on
an anonymous lambda expression, or you can create expression trees manually by using
the System.Linq.Expressions namespace.
When a lambda expression is assigned to a variable of type Expression<TDelegate>, the
compiler emits code to build an expression tree that represents the lambda expression.

The C# compiler generates expression trees only from expression lambdas (or single-
line lambdas). It can't parse statement lambdas (or multi-line lambdas). For more
information about lambda expressions in C#, see Lambda Expressions.

The following code examples demonstrate how to have the C# compiler create an
expression tree that represents the lambda expression num => num < 5 .

C#

Expression<Func<int, bool>> lambda = num => num < 5;

You create expression trees in your code. You build the tree by creating each node and
attaching the nodes into a tree structure. You learn how to create expressions in the
article on building expression trees.

Expression trees are immutable. If you want to modify an expression tree, you must
construct a new expression tree by copying the existing one and replacing nodes in it.
You use an expression tree visitor to traverse the existing expression tree. For more
information, see the article on translating expression trees.

Once you build an expression tree, you execute the code represented by the expression
tree.

Limitations
There are some newer C# language elements that don't translate well into expression
trees. Expression trees can't contain await expressions, or async lambda expressions.
Many of the features added in C# 6 and later don't appear exactly as written in
expression trees. Instead, newer features are exposed in expression trees in the
equivalent, earlier syntax, where possible. Other constructs aren't available. It means that
code that interprets expression trees works the same when new language features are
introduced. However, the expression trees Even with these limitations, expression trees
do enable you to create dynamic algorithms that rely on interpreting and modifying
code that is represented as a data structure. It enables rich libraries such as Entity
Framework to accomplish what they do.

Expression trees won't support new expression node types. It would be a breaking
change for all libraries interpreting expression trees to introduce new node types. The
following list includes most C# language elements that can't be used:
Conditional methods that have been removed
base access
Method group expressions, including address-of (&) a method group, and
anonymous method expressions
References to local functions
Statements, including assignment ( = ) and statement bodied expressions
Partial methods with only a defining declaration
Unsafe pointer operations
dynamic operations
Coalescing operators with null or default literal left side, null coalescing
assignment, and the null propagating operator (?.)
Multi-dimensional array initializers, indexed properties, and dictionary initializers
throw expressions
Accessing static virtual or abstract interface members
Lambda expressions that have attributes
Interpolated strings
UTF-8 string conversions or UTF-8 string literals
Method invocations using variable arguments, named arguments or optional
arguments
Expressions using System.Index or System.Range, index "from end" (^) operator or
range expressions (..)
async lambda expressions or await expressions, including await foreach and await
using
Tuple literals, tuple conversions, tuple == or !=, or with expressions
Discards (_), deconstructing assignment, pattern matching is operator or the
pattern matching switch expression
COM call with ref omitted on the arguments
ref, in or out parameters, ref return values, out arguments, or any values of ref
struct type
Árboles de expresión: datos que definen
el código
Artículo • 13/03/2023 • Tiempo de lectura: 4 minutos

Los árboles de expresiones son estructuras de datos que definen código. Los árboles de
expresión se basan en las mismas estructuras que usa un compilador para analizar el
código y generar el resultado compilado. A medida que lea este artículo, observará
cierta similitud entre los árboles de expresiones y los tipos usados en las API de Roslyn
para compilar analizadores y correcciones de código . (Los analizadores y las
correcciones de código son paquetes de NuGet que realizan un análisis estático en
código y sugieren posibles correcciones para un desarrollador). Los conceptos son
similares y el resultado final es una estructura de datos que permite examinar el código
fuente de forma significativa. En cambio, los árboles de expresiones se basan en un
conjunto de clases y API diferente a las API de Roslyn. Aquí tiene una línea de código:

C#

var sum = 1 + 2;

Si analiza el código anterior como un árbol de expresión, el árbol contiene varios nodos.
El nodo más externo es una instrucción de declaración de variable con asignación ( var
sum = 1 + 2; ). Ese nodo exterior contiene varios nodos secundarios: una declaración de

variable, un operador de asignación y una expresión que representa el lado derecho del
signo igual. Esa expresión se subdivide aún más en expresiones que representan la
operación de suma, y los operandos izquierdo y derecho de la suma.

Vamos a profundizar un poco más en las expresiones que constituyen el lado derecho
del signo igual. La expresión es 1 + 2 , una expresión binaria. Concretamente, es una
expresión binaria de suma. Una expresión binaria de suma tiene dos elementos
secundarios, que representan los nodos izquierdo y derecho de la expresión de suma.
En este caso, ambos nodos son expresiones constantes: el operando izquierdo es el
valor 1 y el operando derecho es el valor 2 .

Visualmente, toda la instrucción es un árbol: puede empezar en el nodo raíz y

desplazarse a cada uno de los nodos del árbol para ver el código que compone la
instrucción:

Instrucción de declaración de variable con asignación ( var sum = 1 + 2; )

Declaración de tipo de variable implícita ( var sum )
Palabra clave var implícita ( var )
 Declaración de nombre de variable ( sum )
Operador de asignación ( = )
Expresión binaria de suma ( 1 + 2 )
Operando izquierdo ( 1 )
Operador de suma ( + )
Operando derecho ( 2 )

El árbol anterior puede parecer complicado, pero es muy versátil. Siguiendo el mismo
proceso, descompone expresiones mucho más complicadas. Tomemos esta expresión
como ejemplo:

C#

var finalAnswer = this.SecretSauceFunction(

currentState.createInterimResult(), currentState.createSecondValue(1,
2),

decisionServer.considerFinalOptions("hello")) +

MoreSecretSauce('A', DateTime.Now, true);

La expresión anterior también es una declaración de variable con una asignación. En

este caso, el lado derecho de la asignación es un árbol mucho más complicado. No va a
descomponer esta expresión, pero tenga en cuenta lo que podrían ser los distintos
nodos. Hay llamadas de método que usan el objeto actual como un receptor, una que
tiene un receptor this explícito y otra que no. Hay llamadas de método que usan otros
objetos de receptor, así como argumentos constantes de tipos diferentes. Y, por último,
hay un operador binario de suma. Según el tipo de valor devuelto de
SecretSauceFunction() o MoreSecretSauce() , ese operador binario de suma puede ser

una llamada de método a un operador de suma invalidado, que se resuelva en una

llamada de método estático al operador binario de suma definido para una clase.

A pesar de esta aparente complejidad, la expresión anterior crea una estructura de árbol
por la que se navega con tanta facilidad como en el primer ejemplo. Siga recorriendo
los nodos secundarios para buscar nodos hoja en la expresión. Los nodos primarios
tienen referencias a sus elementos secundarios y cada nodo tiene una propiedad que
describe de qué tipo es.

La estructura de los árboles de expresiones es muy coherente. Una vez que conozca los
aspectos básicos, puede entender incluso el código más complejo cuando esté
representado como un árbol de expresión. La elegancia de la estructura de datos explica
cómo el compilador de C# analiza los programas de C# más complejos y crea resultados
correctos a partir de código fuente complicado.
Una vez que esté familiarizado con la estructura de los árboles de expresiones, verá que
los conocimientos que ha adquirido le permiten trabajar rápidamente con muchos
escenarios más avanzados. Los árboles de expresiones ofrecen posibilidades increíbles.

Además de traducir algoritmos para ejecutarlos en otros entornos, los árboles de

expresiones facilitan la escritura de algoritmos que inspeccionan el código antes de
ejecutarlo. Escriba un método cuyos argumentos sean expresiones y, a continuación,
examine esas expresiones antes de ejecutar el código. El árbol de expresión es una
representación completa del código: se ven los valores de cualquier subexpresión. Ve los
nombres de propiedad y método. Ve el valor de las expresiones constantes. Convierte
un árbol de expresión en un delegado ejecutable y ejecutar el código.

Las API de los árboles de expresiones permiten crear árboles que representan casi
cualquier construcción de código válida. En cambio, para que todo resulte lo más
sencillo posible, algunas expresiones de C# no se pueden crear en un árbol de
expresión. Un ejemplo son las expresiones asincrónicas (mediante las palabras clave
async y await ). Si necesita algoritmos sincrónicos, tendría que manipular los objetos

Task directamente, en lugar de confiar en la compatibilidad del compilador. Otro

ejemplo es en la creación de bucles. Normalmente, puede crearlos usando bucles for ,

foreach , while o do . Como verá más adelante en esta serie, las API de los árboles de

expresiones admiten una expresión de bucle individual, con expresiones break y

continue que controlan la repetición del bucle.

Lo único lo que no se puede hacer es modificar un árbol de expresión. Los árboles de

expresiones son estructuras de datos inmutables. Si quiere mutar (cambiar) un árbol de
expresión, debe crear un nuevo árbol que sea una copia del original, pero con los
cambios que quiera.
Compatibilidad del entorno de
ejecución de .NET con árboles de
expresión
Artículo • 13/03/2023 • Tiempo de lectura: 3 minutos

Hay una amplia lista de clases en el entorno de ejecución de .NET que funcionan con
árboles de expresiones. En System.Linq.Expressions puede ver la lista completa. En lugar
de enumerar la lista completa, vamos a explicar cómo se han diseñado las clases del
entorno de ejecución.

En el diseño del lenguaje, una expresión es un cuerpo de código que se evalúa y

devuelve un valor. Las expresiones pueden ser muy sencillas: la expresión constante 1
devuelve el valor constante de 1. También pueden ser más complicadas: la expresión (-
B + Math.Sqrt(B*B - 4 * A * C)) / (2 * A) devuelve una raíz de una ecuación

cuadrática (en el caso en el que la ecuación tenga una solución).

System.Linq.Expression y tipos derivados

Una de las complejidades de trabajar con árboles de expresiones es que muchos tipos
de expresiones distintos son válidos en muchos lugares de los programas. Piense en una
expresión de asignación. El lado derecho de una asignación podría ser un valor
constante, una variable, una expresión de llamada de método u otros elementos. Esa
flexibilidad del lenguaje significa que puede encontrarse con muchos tipos de
expresiones diferentes en cualquier parte de los nodos de un árbol al atravesar un árbol
de expresión. Por lo tanto, lo más sencillo consiste en trabajar con el tipo de expresión
base. En cambio, en ocasiones necesitará saber más. La clase de expresión base contiene
una propiedad NodeType para ello. Esta devuelve un elemento ExpressionType , que es
una enumeración de tipos de expresiones posibles. Una vez que sepa el tipo del nodo,
lo convierte en ese tipo y realiza acciones específicas sabiendo el tipo del nodo de
expresión. Puede buscar determinados tipos de nodo y, luego, trabajar con las
propiedades específicas de ese tipo de expresión.

Por ejemplo, este código imprime el nombre de una variable para una expresión de
acceso a la variable. El siguiente código muestra la práctica de comprobar el tipo de
nodo, convertirlo en una expresión de acceso a la variable y después comprobar las
propiedades del tipo de expresión específico:

C#
 Expression<Func<int, int>> addFive = (num) => num + 5;

if (addFive.NodeType == ExpressionType.Lambda)

var lambdaExp = (LambdaExpression)addFive;

var parameter = lambdaExp.Parameters.First();

Console.WriteLine(parameter.Name);

Console.WriteLine(parameter.Type);

Creación de árboles de expresión

La clase System.Linq.Expression también contiene muchos métodos estáticos para
crear expresiones. Estos métodos crean un nodo de expresión al usar los argumentos
proporcionados para sus elementos secundarios. De esta manera, se crea una expresión
a partir de sus nodos hoja. Por ejemplo, este código genera una expresión de agregar:

C#

// Addition is an add expression for "1 + 2"

var one = Expression.Constant(1, typeof(int));

var two = Expression.Constant(2, typeof(int));

var addition = Expression.Add(one, two);

En este sencillo ejemplo puede ver que hay muchos tipos implicados a la hora de crear
árboles de expresiones y trabajar con ellos. Esta complejidad resulta necesaria para
proporcionar las capacidades del vocabulario variado que ofrece el lenguaje C#.

Navegación por las API

Hay tipos de nodos de expresión que se asignan a casi todos los elementos de sintaxis
del lenguaje C#. Cada tipo tiene métodos específicos para ese tipo de elemento del
lenguaje. Es mucha información como para recordarla toda. En lugar de intentar
memorizar todo, estas son las técnicas que se usan para trabajar con árboles de
expresiones:

1. Fíjese en los miembros de la enumeración ExpressionType para determinar los

posibles nodos que debe examinar. Esta lista ayuda cuando quiere atravesar y
comprender un árbol de expresión.
2. Fíjese en los miembros estáticos de la clase Expression para crear una expresión.
Esos métodos pueden crear cualquier tipo de expresión a partir de un conjunto de
 sus nodos secundarios.
3. Fíjese en la clase ExpressionVisitor para crear un árbol de expresión modificado.

Encontrará más información a medida que observe cada una de esas tres áreas. Siempre
encontrará lo que necesita empezando con uno de esos tres pasos.
Ejecución de árboles de expresión
Artículo • 13/03/2023 • Tiempo de lectura: 7 minutos

Un árbol de expresión es una estructura de datos que representa un código. No es

código compilado y ejecutable. Si quiere ejecutar el código de .NET representado
mediante un árbol de expresión, debe convertirlo en instrucciones de lenguaje
intermedio ejecutables. La ejecución de un árbol de expresión puede devolver un valor
o simplemente realizar una acción, como llamar a un método.

Solo se pueden ejecutar los árboles de expresiones que representan expresiones

lambda. Los árboles de expresiones que representan expresiones lambda son de tipo
LambdaExpression o Expression<TDelegate>. Para ejecutar estos árboles de
expresiones, llame al método Compile para crear un delegado ejecutable y, después,
invoque el delegado.

７ Nota

Si el tipo del delegado es desconocido, es decir, la expresión lambda es de tipo

LambdaExpression y no Expression<TDelegate>, llame al método DynamicInvoke
en el delegado en lugar de invocarlo directamente.

Si un árbol de expresión no representa una expresión lambda, puede crear una nueva
expresión lambda que tenga el árbol de expresión original como su cuerpo llamando al
método Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>). Luego
puede ejecutar la expresión lambda tal y como se ha descrito anteriormente en esta
sección.

Expresiones lambda a funciones

Puede convertir cualquier objeto LambdaExpression o cualquier tipo derivado de
LambdaExpression en lenguaje intermedio ejecutable. Otros tipos de expresión no se
pueden convertir directamente a código. Esta restricción tiene poco efecto en la
práctica. Las expresiones lambda son los únicos tipos de expresiones que podría querer
ejecutar mediante la conversión a lenguaje intermedio (IL) ejecutable. (Piense en lo que
significaría ejecutar directamente un elemento
System.Linq.Expressions.ConstantExpression. ¿Significaría algo útil?) Cualquier árbol de
expresión que sea un elemento System.Linq.Expressions.LambdaExpression o un tipo
derivado de LambdaExpression se puede convertir en IL. El tipo de expresión
System.Linq.Expressions.Expression<TDelegate> es el único ejemplo concreto en las
bibliotecas de .NET Core. Se usa para representar una expresión que se asigna a
cualquier tipo de delegado. Dado que este tipo se asigna a un tipo de delegado, .NET
puede examinar la expresión y generar el lenguaje intermedio de un delegado
adecuado que coincida con la firma de la expresión lambda. El tipo de delegado se basa
en el tipo de expresión. Debe conocer el tipo de valor devuelto y la lista de argumentos
si quiere usar el objeto de delegado de una forma fuertemente tipada. El método
LambdaExpression.Compile() devuelve el tipo Delegate . Tiene que convertirlo al tipo de
delegado correcto para que las herramientas de tiempo de compilación comprueben la
lista de argumentos del tipo de valor devuelto.

En la mayoría de los casos, existe una asignación simple entre una expresión y su
delegado correspondiente. Por ejemplo, un árbol de expresión que se representa por
Expression<Func<int>> se convertiría a un delegado del tipo Func<int> . Para una
expresión lambda con cualquier tipo de valor devuelto y lista de argumentos, existe un
tipo de delegado que es el tipo de destino para el código ejecutable representado por
esa expresión lambda.

El tipo System.Linq.Expressions.LambdaExpression contiene los miembros

LambdaExpression.Compile y LambdaExpression.CompileToMethod que se usarían para
convertir un árbol de expresión en código ejecutable. El método Compile crea un
delegado. El método CompileToMethod actualiza un objeto
System.Reflection.Emit.MethodBuilder con el lenguaje intermedio que representa la
salida compilada del árbol de expresión.

） Importante

CompileToMethod solo está disponible en .NET Framework, no en .NET Core o .NET 5

y versiones posteriores.

Como opción, también puede proporcionar un

System.Runtime.CompilerServices.DebugInfoGenerator que recibe la información de
depuración de símbolos para el objeto de delegado generado. DebugInfoGenerator
proporciona información de depuración completa sobre el delegado generado.

Para convertir una expresión en un delegado se usaría el siguiente código:

C#

Expression<Func<int>> add = () => 1 + 2;

var func = add.Compile(); // Create Delegate

var answer = func(); // Invoke Delegate

Console.WriteLine(answer);

En el ejemplo de código siguiente se muestran los tipos concretos que se usan al

compilar y ejecutar un árbol de expresión.

C#

Expression<Func<int, bool>> expr = num => num < 5;

// Compiling the expression tree into a delegate.

Func<int, bool> result = expr.Compile();

// Invoking the delegate and writing the result to the console.

Console.WriteLine(result(4));

// Prints True.

// You can also use simplified syntax

// to compile and run an expression tree.

// The following line can replace two previous statements.

Console.WriteLine(expr.Compile()(4));

// Also prints True.

En el ejemplo de código siguiente se muestra cómo ejecutar un árbol de expresión que

representa la elevación de un número a una potencia mediante la creación de una
expresión lambda y su posterior ejecución. Se muestra el resultado, que representa el
número elevado a la potencia.

C#

// The expression tree to execute.

BinaryExpression be = Expression.Power(Expression.Constant(2d),
Expression.Constant(3d));

// Create a lambda expression.

Expression<Func<double>> le = Expression.Lambda<Func<double>>(be);

// Compile the lambda expression.

Func<double> compiledExpression = le.Compile();

// Execute the lambda expression.

double result = compiledExpression();

// Display the result.

Console.WriteLine(result);

// This code produces the following output:

// 8

Ejecución y duraciones
El código se ejecuta mediante la invocación del delegado que se crea al llamar a
LambdaExpression.Compile() . El código anterior, add.Compile() , devuelve un delegado.

Para invocar ese delegado, llame a func() , que ejecuta el código.

Ese delegado representa el código en el árbol de expresión. Se puede conservar el

identificador a ese delegado e invocarlo más adelante. No es necesario compilar el árbol
de expresión cada vez que se quiera ejecutar el código que representa. (Recuerde que
los árboles de expresión son inmutables y que compilar el mismo árbol de expresión
más adelante crea un delegado que ejecuta el mismo código).

Ｕ Precaución

No cree ningún mecanismo de almacenamiento en caché más sofisticado para

aumentar el rendimiento evitando llamadas innecesarias de compilación. La
comparación de dos árboles de expresión arbitrarios para determinar si
representan el mismo algoritmo es una operación que consume mucho tiempo de
ejecución. Probablemente el tiempo de proceso que se ahorra al evitar llamadas
adicionales a LambdaExpression.Compile() será consumido por el tiempo de
ejecución de código que determina si dos árboles de expresión diferentes
devuelven el mismo código ejecutable.

Advertencias
Compilar una expresión lambda en un delegado e invocar ese delegado es una de las
operaciones más simples que se pueden realizar con un árbol de expresión. Pero incluso
con esta sencilla operación, hay advertencias que debe conocer.

Las expresiones lambda crean clausuras sobre las variables locales a las que se hace
referencia en la expresión. Debe garantizar que las variables que formarían parte del
delegado se pueden usar en la ubicación desde la que se llama a Compile , y cuando se
ejecuta el delegado resultante. El compilador garantiza que las variables estén en el
ámbito. Pero si la expresión tiene acceso a una variable que implementa IDisposable , es
posible que el código deseche el objeto mientras se sigue manteniendo en el árbol de
expresión.

Por ejemplo, este código funciona bien porque int no implementa IDisposable :

C#
 private static Func<int, int> CreateBoundFunc()

var constant = 5; // constant is captured by the expression tree

Expression<Func<int, int>> expression = (b) => constant + b;

var rVal = expression.Compile();

return rVal;

El delegado capturó una referencia a la variable local constant . Esa variable es accesible
en cualquier momento posterior, cuando se ejecuta la función devuelta por
CreateBoundFunc .

Pero considere la siguiente clase (bastante artificiosa) que implementa

System.IDisposable:

C#

public class Resource : IDisposable

private bool isDisposed = false;

public int Argument

get

if (!isDisposed)

return 5;

else throw new ObjectDisposedException("Resource");

public void Dispose()

isDisposed = true;

Si se usa en una expresión como se muestra en el siguiente código, obtiene una

System.ObjectDisposedException al ejecutar el código al que hace referencia la
propiedad Resource.Argument :

C#

private static Func<int, int> CreateBoundResource()

using (var constant = new Resource()) // constant is captured by the

expression tree

Expression<Func<int, int>> expression = (b) => constant.Argument +

 b;

var rVal = expression.Compile();

return rVal;

El delegado devuelto por este método se clausuró sobre el objeto constant , que se
eliminó. (Se eliminó porque se declaró en una instrucción using ).

Ahora, al ejecutar el delegado devuelto desde este método, se produce una excepción
ObjectDisposedException en el punto de ejecución.

Parece extraño tener un error en tiempo de ejecución que representa una construcción
de tiempo de compilación, pero es el mundo al que entra cuando trabaja con árboles de
expresión.

Hay numerosas permutaciones de este problema, por lo que resulta difícil ofrecer
instrucciones generales para evitarlo. Tenga cuidado al obtener acceso a las variables
locales al definir expresiones y al obtener acceso al estado en el objeto actual
(representado por this ) al crear un árbol de expresión devuelto por una API pública.

El código de la expresión puede hacer referencia a métodos o propiedades de otros

ensamblados. Ese ensamblado debe ser accesible cuando se define la expresión, cuando
se compila y cuando se invoca el delegado resultante. En los casos en los que no esté
presente, se produce una excepción ReferencedAssemblyNotFoundException .

Resumen
Los árboles de expresión que representan expresiones lambda se pueden compilar para
crear un delegado que se puede ejecutar. Los árboles de expresión proporcionan un
mecanismo para ejecutar el código representado por un árbol de expresión.

El árbol de expresión representa el código que se ejecutaría para cualquier construcción

que se cree. Mientras que el entorno donde se compile y ejecute el código coincida con
el entorno donde se crea la expresión, todo funciona según lo esperado. Cuando eso no
sucede, los errores son predecibles y se detectan en las primeras pruebas de cualquier
código que use los árboles de expresión.
Interpretación de expresiones
Artículo • 13/03/2023 • Tiempo de lectura: 14 minutos

En el siguiente ejemplo de código se muestra cómo la expresión del árbol que

representa la expresión lambda num => num < 5 se puede descomponer en partes.

C#

// Add the following using directive to your code file:

// using System.Linq.Expressions;

// Create an expression tree.

Expression<Func<int, bool>> exprTree = num => num < 5;

// Decompose the expression tree.

ParameterExpression param = (ParameterExpression)exprTree.Parameters[0];

BinaryExpression operation = (BinaryExpression)exprTree.Body;

ParameterExpression left = (ParameterExpression)operation.Left;

ConstantExpression right = (ConstantExpression)operation.Right;

Console.WriteLine("Decomposed expression: {0} => {1} {2} {3}",

param.Name, left.Name, operation.NodeType, right.Value);

// This code produces the following output:

// Decomposed expression: num => num LessThan 5

Ahora, vamos a escribir código para examinar la estructura de un árbol de expresión.

Cada nodo de un árbol de expresión es un objeto de una clase derivada de Expression .

Ese diseño hace que la visita de todos los nodos de un árbol de expresión sea una
operación recursiva relativamente sencilla. La estrategia general es comenzar en el nodo
raíz y determinar qué tipo de nodo es.

Si el tipo de nodo tiene elementos secundarios, visítelos recursivamente. En cada nodo

secundario, repita el proceso que ha usado en el nodo raíz: determine el tipo, y si el tipo
tiene elementos secundarios, visite cada uno de ellos.

Examen de una expresión sin elementos

secundarios
Empecemos visitando cada nodo en un árbol de expresión sencillo. Aquí se muestra el
código que crea una expresión constante y, después, examina sus propiedades:
 C#

var constant = Expression.Constant(24, typeof(int));

Console.WriteLine($"This is a/an {constant.NodeType} expression type");

Console.WriteLine($"The type of the constant value is {constant.Type}");

Console.WriteLine($"The value of the constant value is {constant.Value}");

El código anterior imprime la siguiente salida:

Resultados

This is a/an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 24

Ahora, vamos a escribir el código que examinará esta expresión y también algunas
propiedades importantes sobre este.

Expresión de suma
Comencemos con el ejemplo de adición de la instrucción de esta sección.

C#

Expression<Func<int>> sum = () => 1 + 2;

７ Nota

No use var para declarar este árbol de expresión, porque el tipo natural del
delegado es Func<int> , no Expression<Func<int>> .

El nodo raíz es LambdaExpression . Para obtener el código que nos interesa en el lado
derecho del operador => , hay que buscar uno de los elementos secundarios de
LambdaExpression . Hace esto con todas las expresiones de esta sección. El nodo

primario nos ayuda a encontrar el tipo de valor devuelto de LambdaExpression .

Para examinar cada nodo de esta expresión, necesitaremos visitar recursivamente varios
nodos. Aquí se muestra una primera implementación sencilla:

C#
 Expression<Func<int, int, int>> addition = (a, b) => a + b;

Console.WriteLine($"This expression is a {addition.NodeType} expression

type");

Console.WriteLine($"The name of the lambda is {((addition.Name == null) ? "

<null>" : addition.Name)}");

Console.WriteLine($"The return type is {addition.ReturnType.ToString()}");

Console.WriteLine($"The expression has {addition.Parameters.Count}

arguments. They are:");

foreach (var argumentExpression in addition.Parameters)

Console.WriteLine($"\tParameter Type:
{argumentExpression.Type.ToString()}, Name: {argumentExpression.Name}");

var additionBody = (BinaryExpression)addition.Body;

Console.WriteLine($"The body is a {additionBody.NodeType} expression");

Console.WriteLine($"The left side is a {additionBody.Left.NodeType}

expression");

var left = (ParameterExpression)additionBody.Left;

Console.WriteLine($"\tParameter Type: {left.Type.ToString()}, Name:

{left.Name}");

Console.WriteLine($"The right side is a {additionBody.Right.NodeType}

expression");

var right = (ParameterExpression)additionBody.Right;

Console.WriteLine($"\tParameter Type: {right.Type.ToString()}, Name:

{right.Name}");

Este ejemplo imprime el siguiente resultado:

Resultados

This expression is a/an Lambda expression type

The name of the lambda is <null>

The return type is System.Int32

The expression has 2 arguments. They are:

Parameter Type: System.Int32, Name: a

Parameter Type: System.Int32, Name: b

The body is a/an Add expression

The left side is a Parameter expression

Parameter Type: System.Int32, Name: a

The right side is a Parameter expression

Parameter Type: System.Int32, Name: b

Observará mucha repetición en el ejemplo de código anterior. Vamos a limpiarlo y a

crear un visitante del nodo de expresión con una finalidad más general. Para ello vamos
a necesitar escribir un algoritmo recursivo. Cualquier nodo puede ser de un tipo que
pueda tener elementos secundarios. Cualquier nodo que tenga elementos secundarios
necesita que los visitemos y determinemos cuál es ese nodo. Aquí se muestra una
versión limpia que usa la recursividad para visitar las operaciones de adición:

C#

using System.Linq.Expressions;

namespace Visitors;

// Base Visitor class:

public abstract class Visitor

private readonly Expression node;

protected Visitor(Expression node) => this.node = node;

public abstract void Visit(string prefix);

public ExpressionType NodeType => node.NodeType;

public static Visitor CreateFromExpression(Expression node) =>

node.NodeType switch

ExpressionType.Constant => new

ConstantVisitor((ConstantExpression)node),

ExpressionType.Lambda => new

LambdaVisitor((LambdaExpression)node),

ExpressionType.Parameter => new

ParameterVisitor((ParameterExpression)node),

ExpressionType.Add => new BinaryVisitor((BinaryExpression)node),

_ => throw new NotImplementedException($"Node not processed yet:

{node.NodeType}"),

};

// Lambda Visitor

public class LambdaVisitor : Visitor

private readonly LambdaExpression node;

public LambdaVisitor(LambdaExpression node) : base(node) => this.node =

node;

public override void Visit(string prefix)

Console.WriteLine($"{prefix}This expression is a {NodeType}

expression type");

Console.WriteLine($"{prefix}The name of the lambda is {((node.Name

== null) ? "<null>" : node.Name)}");

Console.WriteLine($"{prefix}The return type is {node.ReturnType}");

Console.WriteLine($"{prefix}The expression has

{node.Parameters.Count} argument(s). They are:");

// Visit each parameter:

foreach (var argumentExpression in node.Parameters)

var argumentVisitor = CreateFromExpression(argumentExpression);

argumentVisitor.Visit(prefix + "\t");

Console.WriteLine($"{prefix}The expression body is:");

// Visit the body:

var bodyVisitor = CreateFromExpression(node.Body);

bodyVisitor.Visit(prefix + "\t");

// Binary Expression Visitor:

public class BinaryVisitor : Visitor

private readonly BinaryExpression node;

public BinaryVisitor(BinaryExpression node) : base(node) => this.node =

node;

public override void Visit(string prefix)

Console.WriteLine($"{prefix}This binary expression is a {NodeType}

expression");

var left = CreateFromExpression(node.Left);

Console.WriteLine($"{prefix}The Left argument is:");

left.Visit(prefix + "\t");

var right = CreateFromExpression(node.Right);

Console.WriteLine($"{prefix}The Right argument is:");

right.Visit(prefix + "\t");

// Parameter visitor:

public class ParameterVisitor : Visitor

private readonly ParameterExpression node;

public ParameterVisitor(ParameterExpression node) : base(node)

this.node = node;

public override void Visit(string prefix)

Console.WriteLine($"{prefix}This is an {NodeType} expression type");

Console.WriteLine($"{prefix}Type: {node.Type}, Name: {node.Name},

ByRef: {node.IsByRef}");

// Constant visitor:

public class ConstantVisitor : Visitor

private readonly ConstantExpression node;

public ConstantVisitor(ConstantExpression node) : base(node) =>

this.node = node;

public override void Visit(string prefix)

Console.WriteLine($"{prefix}This is an {NodeType} expression type");

 Console.WriteLine($"{prefix}The type of the constant value is

{node.Type}");

Console.WriteLine($"{prefix}The value of the constant value is

{node.Value}");

Este algoritmo es la base de un algoritmo que visita cualquier LambdaExpression

arbitrario. El código que creó solo busca una muestra pequeña de los posibles
conjuntos de nodos de árbol de expresión que puede encontrar. En cambio, todavía
puede aprender bastante de lo que genera. (El caso predeterminado en el método
Visitor.CreateFromExpression imprime un mensaje en la consola de error cuando se

encuentra un tipo de nodo nuevo. De este modo, sabe que se va a agregar un tipo de
expresión nuevo).

Cuando ejecuta este visitante en la expresión anterior, obtiene la siguiente salida:

Resultados

This expression is a/an Lambda expression type

The name of the lambda is <null>

The return type is System.Int32

The expression has 2 argument(s). They are:

This is an Parameter expression type

Type: System.Int32, Name: a, ByRef: False

This is an Parameter expression type

Type: System.Int32, Name: b, ByRef: False

The expression body is:

This binary expression is a Add expression

The Left argument is:

This is an Parameter expression type

Type: System.Int32, Name: a, ByRef: False

The Right argument is:

This is an Parameter expression type

Type: System.Int32, Name: b, ByRef: False

Ahora que ha creado una implementación de visitante más general, puede visitar y
procesar muchos más tipos de expresiones diferentes.

Expresión de suma con más operandos

Vamos a probar un ejemplo más complicado, todavía limitando los tipos de nodo solo a
los de adición:

C#

Expression<Func<int>> sum = () => 1 + 2 + 3 + 4;

Antes de que ejecute estos ejemplos en el algoritmo de visitante, haga un ejercicio de

reflexión para calcular cuál podría ser el resultado. Recuerde que el operador + es un
operador binario: debe tener dos elementos secundarios, que representen los operandos
izquierdo y derecho. Existen varias maneras posibles de construir un árbol que pueda
ser correcto:

C#

Expression<Func<int>> sum1 = () => 1 + (2 + (3 + 4));

Expression<Func<int>> sum2 = () => ((1 + 2) + 3) + 4;

Expression<Func<int>> sum3 = () => (1 + 2) + (3 + 4);

Expression<Func<int>> sum4 = () => 1 + ((2 + 3) + 4);

Expression<Func<int>> sum5 = () => (1 + (2 + 3)) + 4;

Puede ver la separación en dos respuestas posibles para resaltar la más prometedora. La
primera representa las expresiones asociativas por la derecha. La segunda representa las
expresiones asociativas por la izquierda. La ventaja de los dos formatos es que el
formato escala a cualquier número arbitrario de expresiones de adición.

Si ejecuta esta expresión a través del visitante, verá este resultado y comprobará que la
expresión de adición simple es asociativa por la izquierda.

Para ejecutar este ejemplo, y ver el árbol de expresión completo, realiza un cambio en el
árbol de expresión de origen. Cuando el árbol de expresión contiene todas las
constantes, el árbol resultante simplemente contiene el valor constante de 10 . El
compilador realiza toda la adición y reduce la expresión a su forma más simple.
Simplemente con agregar una variable a la expresión es suficiente para ver el árbol
original:

C#

Expression<Func<int, int>> sum = (a) => 1 + a + 3 + 4;

Cree un visitante para esta suma y ejecute el visitante para ver esta salida:

Resultados

This expression is a/an Lambda expression type

The name of the lambda is <null>

The return type is System.Int32

The expression has 1 argument(s). They are:

This is an Parameter expression type

Type: System.Int32, Name: a, ByRef: False

 The expression body is:

This binary expression is a Add expression

The Left argument is:

This binary expression is a Add expression

The Left argument is:

This binary expression is a Add expression

The Left argument is:

This is an Constant expression type

The type of the constant value is

System.Int32

The value of the constant value is 1

The Right argument is:

This is an Parameter expression type

Type: System.Int32, Name: a, ByRef: False

The Right argument is:

This is an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 3

The Right argument is:

This is an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 4

Puede ejecutar cualquiera de los otros ejemplos a través del código de visitante y ver
qué árbol representa. Aquí se muestra un ejemplo de la expresión sum3 anterior (con un
parámetro adicional para evitar que el compilador calcule la constante):

C#

Expression<Func<int, int, int>> sum3 = (a, b) => (1 + a) + (3 + b);

Aquí se muestra el resultado del visitante:

Resultados

This expression is a/an Lambda expression type

The name of the lambda is <null>

The return type is System.Int32

The expression has 2 argument(s). They are:

This is an Parameter expression type

Type: System.Int32, Name: a, ByRef: False

This is an Parameter expression type

Type: System.Int32, Name: b, ByRef: False

The expression body is:

This binary expression is a Add expression

The Left argument is:

This binary expression is a Add expression

The Left argument is:

This is an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 1

 The Right argument is:

This is an Parameter expression type

Type: System.Int32, Name: a, ByRef: False

The Right argument is:

This binary expression is a Add expression

The Left argument is:

This is an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 3

The Right argument is:

This is an Parameter expression type

Type: System.Int32, Name: b, ByRef: False

Tenga en cuenta que los paréntesis no forman parte de la salida. No existen nodos en el
árbol de expresión que representen los paréntesis en la expresión de entrada. La
estructura del árbol de expresión contiene toda la información necesaria para comunicar
la precedencia.

Ampliación de este ejemplo

El ejemplo trata solo los árboles de expresión más básicos. El código que ha visto en
esta sección solo controla enteros constantes y el operador binario + . Como último
ejemplo, vamos a actualizar el visitante para que controle una expresión más
complicada. Vamos a hacer que funcione para la siguiente expresión factorial:

C#

Expression<Func<int, int>> factorial = (n) =>

n == 0 ?

1 :

Enumerable.Range(1, n).Aggregate((product, factor) => product * factor);

Este código representa una posible implementación para la función factorial

matemática. La manera en que ha escrito este código resalta dos limitaciones en la
creación de árboles de expresión asignando expresiones lambda a las expresiones. En
primer lugar, las expresiones lambda de instrucción no están permitidas. Eso significa
que no puede usar bucles, bloques, instrucciones IF/ELSE ni otras estructuras de control
comunes en C#. Estoy limitado al uso de expresiones. En segundo lugar, no puede
llamar recursivamente a la misma expresión. Podría si ya fuera un delegado, pero no
puede llamarla en su forma de árbol de expresión. En la sección sobre la creación de
árboles de expresión, obtiene las técnicas para superar estas limitaciones.

En esta expresión, encuentra nodos de todos estos tipos:

1. Equal (expresión binaria)

 2. Multiply (expresión binaria)
3. Conditional (la expresión ? : )
4. Expresión de llamada a método (con la llamada a Range() y Aggregate() )

Una manera de modificar el algoritmo de visitante es seguir ejecutándolo y escribir el

tipo de nodo cada vez que llegue a su cláusula default . Después de varias iteraciones,
ha visto cada uno de los nodos potenciales. Después, tiene todo lo que necesita. El
resultado será similar al siguiente:

C#

public static Visitor CreateFromExpression(Expression node) =>

node.NodeType switch

ExpressionType.Constant => new

ConstantVisitor((ConstantExpression)node),

ExpressionType.Lambda => new

LambdaVisitor((LambdaExpression)node),

ExpressionType.Parameter => new

ParameterVisitor((ParameterExpression)node),

ExpressionType.Add => new

BinaryVisitor((BinaryExpression)node),

ExpressionType.Equal => new

BinaryVisitor((BinaryExpression)node),

ExpressionType.Multiply => new BinaryVisitor((BinaryExpression)

node),

ExpressionType.Conditional => new

ConditionalVisitor((ConditionalExpression) node),

ExpressionType.Call => new

MethodCallVisitor((MethodCallExpression) node),

_ => throw new NotImplementedException($"Node not processed yet:

{node.NodeType}"),

};

ConditionalVisitor y MethodCallVisitor procesan esos dos nodos:

C#

public class ConditionalVisitor : Visitor

private readonly ConditionalExpression node;

public ConditionalVisitor(ConditionalExpression node) : base(node)

this.node = node;

public override void Visit(string prefix)

Console.WriteLine($"{prefix}This expression is a {NodeType}

expression");

 var testVisitor = Visitor.CreateFromExpression(node.Test);

Console.WriteLine($"{prefix}The Test for this expression is:");

testVisitor.Visit(prefix + "\t");

var trueVisitor = Visitor.CreateFromExpression(node.IfTrue);

Console.WriteLine($"{prefix}The True clause for this expression

is:");

trueVisitor.Visit(prefix + "\t");

var falseVisitor = Visitor.CreateFromExpression(node.IfFalse);

Console.WriteLine($"{prefix}The False clause for this expression

is:");

falseVisitor.Visit(prefix + "\t");

public class MethodCallVisitor : Visitor

private readonly MethodCallExpression node;

public MethodCallVisitor(MethodCallExpression node) : base(node)

this.node = node;

public override void Visit(string prefix)

Console.WriteLine($"{prefix}This expression is a {NodeType}

expression");

if (node.Object == null)

Console.WriteLine($"{prefix}This is a static method call");

else

Console.WriteLine($"{prefix}The receiver (this) is:");

var receiverVisitor = Visitor.CreateFromExpression(node.Object);

receiverVisitor.Visit(prefix + "\t");

var methodInfo = node.Method;

Console.WriteLine($"{prefix}The method name is

{methodInfo.DeclaringType}.{methodInfo.Name}");

// There is more here, like generic arguments, and so on.

Console.WriteLine($"{prefix}The Arguments are:");

foreach (var arg in node.Arguments)

var argVisitor = Visitor.CreateFromExpression(arg);

argVisitor.Visit(prefix + "\t");

Y el resultado del árbol de expresión será:

Resultados
This expression is a/an Lambda expression type

The name of the lambda is <null>

The return type is System.Int32

The expression has 1 argument(s). They are:

This is an Parameter expression type

Type: System.Int32, Name: n, ByRef: False

The expression body is:

This expression is a Conditional expression

The Test for this expression is:

This binary expression is a Equal expression

The Left argument is:

This is an Parameter expression type

Type: System.Int32, Name: n, ByRef: False

The Right argument is:

This is an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 0

The True clause for this expression is:

This is an Constant expression type

The type of the constant value is System.Int32

The value of the constant value is 1

The False clause for this expression is:

This expression is a Call expression

This is a static method call

The method name is System.Linq.Enumerable.Aggregate

The Arguments are:

This expression is a Call expression

This is a static method call

The method name is System.Linq.Enumerable.Range

The Arguments are:

This is an Constant expression type

The type of the constant value is

System.Int32

The value of the constant value is 1

This is an Parameter expression type

Type: System.Int32, Name: n, ByRef: False

This expression is a Lambda expression type

The name of the lambda is <null>

The return type is System.Int32

The expression has 2 arguments. They are:

This is an Parameter expression type

Type: System.Int32, Name: product, ByRef:

False

This is an Parameter expression type

Type: System.Int32, Name: factor, ByRef:

False

The expression body is:

This binary expression is a Multiply

expression

The Left argument is:

This is an Parameter expression type

Type: System.Int32, Name: product,

ByRef: False

The Right argument is:

 This is an Parameter expression type

Type: System.Int32, Name: factor,

ByRef: False

Ampliación de la biblioteca de ejemplo

Los ejemplos de esta sección muestran las técnicas principales para visitar y examinar
nodos de un árbol de expresión. Ha simplificado los tipos de nodos que encontrará para
concentrarse en las tareas principales de visitar y acceder a los nodos en un árbol de
expresiones.

En primer lugar, los visitantes solo controlan constantes que son enteros. Los valores
constantes pueden ser cualquier otro tipo numérico, y el lenguaje de C# admite
conversiones y promociones entre esos tipos. Una versión más sólida de este código
reflejará todas esas capacidades.

Incluso en el último ejemplo se reconoce un subconjunto de los tipos de nodo posibles.

Todavía puede proporcionarle muchas expresiones que provocarán que se produzca un
error. En .NET Standard se incluye una implementación completa con el nombre
ExpressionVisitor que puede controlar todos los tipos de nodo posibles.

Por último, la biblioteca usada en este artículo se ha creado con fines de demostración y
aprendizaje. No está optimizada. Aclara las estructuras y resalta las técnicas usadas para
visitar los nodos y analizar lo que hay ahí.

Incluso con esas limitaciones, se encuentra en el camino correcto para escribir

algoritmos que lean y comprendan árboles de expresión.
Creación de árboles de expresión
Artículo • 13/03/2023 • Tiempo de lectura: 6 minutos

El compilador de C# creó todos los árboles de expresión que ha visto hasta ahora. Ha
creado una expresión lambda asignaba a una variable de tipo Expression<Func<T>> o de
algún tipo similar. En muchos escenarios, crea una expresión en memoria en tiempo de
ejecución.

Los árboles de expresión son inmutables. Inmutable significa que debe crear el árbol
desde las hojas hasta la raíz. Las API que usa para crear los árboles de expresión reflejan
este hecho: los métodos que usa para crear un nodo toman todos sus elementos
secundarios como argumentos. Veamos algunos ejemplos para mostrarle las técnicas.

Creación de nodos
Empezaremos con la expresión de adición con la que ha estado trabajando en estas
secciones:

C#

Expression<Func<int>> sum = () => 1 + 2;

Para crear ese árbol de expresión, primero cree los nodos hoja. Los nodos hoja son
constantes. Use el método Constant para crear los nodos:

C#

var one = Expression.Constant(1, typeof(int));

var two = Expression.Constant(2, typeof(int));

Después, cree la expresión de adición:

C#

var addition = Expression.Add(one, two);

Una vez que haya creado la expresión de adición, se crea la expresión lambda:

C#

var lambda = Expression.Lambda(addition);

Esta expresión lambda no contiene argumentos. Posteriormente en esta sección, verá

cómo asignar argumentos a parámetros y crear expresiones más complicadas.

Para las expresiones como esta, puede combinar todas las llamadas en una sola
instrucción:

C#

var lambda2 = Expression.Lambda(

Expression.Add(

Expression.Constant(1, typeof(int)),

Expression.Constant(2, typeof(int))

);

Creación de un árbol
En la sección anterior se muestran los conceptos básicos de la creación de un árbol de
expresión en memoria. Los árboles más complejos implican normalmente más tipos de
nodo y más nodos en el árbol. Vamos a analizar un ejemplo más y a mostrar dos tipos
de nodo que crea normalmente al crear árboles de expresión: los nodos de argumentos
y los nodos de llamada al método. Vamos a crear un árbol de expresión para crear esta
expresión:

C#

Expression<Func<double, double, double>> distanceCalc =

(x, y) => Math.Sqrt(x * x + y * y);

Comienza creando expresiones de parámetro para x y y :

C#

var xParameter = Expression.Parameter(typeof(double), "x");

var yParameter = Expression.Parameter(typeof(double), "y");

La creación de expresiones de adición y multiplicación sigue el patrón que ya ha visto:

C#

var xSquared = Expression.Multiply(xParameter, xParameter);

var ySquared = Expression.Multiply(yParameter, yParameter);

var sum = Expression.Add(xSquared, ySquared);

Después, necesita crear una expresión de llamada al método para la llamada a

Math.Sqrt .

C#

var sqrtMethod = typeof(Math).GetMethod("Sqrt", new[] { typeof(double) }) ??

throw new InvalidOperationException("Math.Sqrt not found!");

var distance = Expression.Call(sqrtMethod, sum);

La llamada GetMethod podría devolver null si no se encuentra el método. Lo más

probable es que se deba a que ha escrito mal el nombre del método. De otro modo,
podría significar que el ensamblado necesario no se carga. Por último, coloque la
llamada al método en una expresión lambda y asegúrese de definir los argumentos en
dicha expresión:

C#

var distanceLambda = Expression.Lambda(

distance,

xParameter,

yParameter);

En este ejemplo más complejo, verá un par de técnicas más que necesitará a menudo
para crear árboles de expresión.

Primero, necesita crear los objetos que representan parámetros o variables locales antes
de usarlos. Una vez que haya creado esos objetos, puede usarlos en su árbol de
expresión siempre que los necesite.

Después, necesita usar un subconjunto de las API de reflexión para crear un objeto
System.Reflection.MethodInfo, de manera que pueda crear un árbol de expresión para
tener acceso a ese método. Debe limitarse al subconjunto de las API de reflexión que
están disponibles en la plataforma de .NET Core. De nuevo, estas técnicas se extienden a
otros árboles de expresión.

Compilación de código en profundidad

No está limitado en lo que puede crear con estas API. En cambio, cuánto más
complicado sea el árbol de expresión que quiera crear, más difícil será la administración
y la lectura del código.

Vamos a crear un árbol de expresión que sea equivalente a este código:

 C#

Func<int, int> factorialFunc = (n) =>

var res = 1;

while (n > 1)

res = res * n;

n--;

return res;

};

El código anterior no ha compilado el árbol de expresiones, sino simplemente el

delegado. Con la clase Expression no puede crear expresiones lambda de instrucción.
Aquí se muestra el código necesario para crear la misma función. No existe una API para
crear un bucle while . En su lugar necesita crear un bucle que contenga una prueba
condicional y un destino de la etiqueta para salir del bucle.

C#

var nArgument = Expression.Parameter(typeof(int), "n");

var result = Expression.Variable(typeof(int), "result");

// Creating a label that represents the return value

LabelTarget label = Expression.Label(typeof(int));

var initializeResult = Expression.Assign(result, Expression.Constant(1));

// This is the inner block that performs the multiplication,

// and decrements the value of 'n'

var block = Expression.Block(

Expression.Assign(result,

Expression.Multiply(result, nArgument)),

Expression.PostDecrementAssign(nArgument)

);

// Creating a method body.

BlockExpression body = Expression.Block(

new[] { result },

initializeResult,

Expression.Loop(

Expression.IfThenElse(

Expression.GreaterThan(nArgument, Expression.Constant(1)),

block,

Expression.Break(label, result)

),

label

);

El código para crear el árbol de expresión para la función factorial es bastante más
largo, más complicado y está lleno de etiquetas, instrucciones Break y otros elementos
que le gustaría evitar en nuestras tareas de codificación diarias.

En esta sección, también actualiza el código del visitante para visitar cada nodo de este
árbol de expresión y escribir información sobre los nodos que se crean en este ejemplo.
Puede ver o descargar el código de ejemplo en el repositorio dotnet/docs de GitHub.
Pruébelo compilando y ejecutando los ejemplos.

Asignación de construcciones de código a

expresiones
En el siguiente ejemplo de código se muestra un árbol de expresión que represente la
expresión lambda num => num < 5 mediante la API.

C#

// Manually build the expression tree for

// the lambda expression num => num < 5.

ParameterExpression numParam = Expression.Parameter(typeof(int), "num");

ConstantExpression five = Expression.Constant(5, typeof(int));

BinaryExpression numLessThanFive = Expression.LessThan(numParam, five);

Expression<Func<int, bool>> lambda1 =

Expression.Lambda<Func<int, bool>>(

numLessThanFive,

new ParameterExpression[] { numParam });

La API de árboles de expresión admite también asignaciones y expresiones de flujo de

control como bucles, bloques condicionales y bloques try-catch . Con la API, se pueden
crear árboles de expresión más complejos que los que pueden crear el compilador de
C# a partir de expresiones lambda. En el siguiente ejemplo se indica cómo crear un
árbol de expresión que calcula el factorial de un número.

C#

// Creating a parameter expression.

ParameterExpression value = Expression.Parameter(typeof(int), "value");

// Creating an expression to hold a local variable.

ParameterExpression result = Expression.Parameter(typeof(int), "result");

// Creating a label to jump to from a loop.

LabelTarget label = Expression.Label(typeof(int));

// Creating a method body.

BlockExpression block = Expression.Block(

 // Adding a local variable.

new[] { result },

// Assigning a constant to a local variable: result = 1

Expression.Assign(result, Expression.Constant(1)),

// Adding a loop.

Expression.Loop(

// Adding a conditional block into the loop.

Expression.IfThenElse(
// Condition: value > 1

Expression.GreaterThan(value, Expression.Constant(1)),

// If true: result *= value --

Expression.MultiplyAssign(result,

Expression.PostDecrementAssign(value)),

// If false, exit the loop and go to the label.

Expression.Break(label, result)

),

// Label to jump to.

label

);

// Compile and execute an expression tree.

int factorial = Expression.Lambda<Func<int, int>>(block, value).Compile()

(5);

Console.WriteLine(factorial);

// Prints 120.

Para obtener más información, consulte Generating Dynamic Methods with Expression
Trees in Visual Studio 2010 (Generar métodos dinámicos con árboles de expresión en
Visual Studio 2010), que también se aplica a las últimas versiones de Visual Studio.
Traslado de árboles de expresión
Artículo • 13/03/2023 • Tiempo de lectura: 7 minutos

En este artículo, obtendrá información sobre cómo visitar cada nodo en un árbol de
expresión, mientras se crea una copia modificada de ese árbol de expresión. Trasladará
los árboles de expresión para comprender los algoritmos para poder trasladarlos a otro
entorno. Cambiará el algoritmo que se ha creado. Podría agregar el registro, interceptar
las llamadas de método y realizar un seguimiento de ellas, o con otros fines.

El código que se compila para trasladar un árbol de expresión es una extensión de lo

que ya se vio para visitar todos los nodos de un árbol. Al trasladar un árbol de
expresión, se visitan todos los nodos y mientras se visitan, se crea el árbol nuevo. El
nuevo árbol puede contener referencias a los nodos originales o a nodos nuevos que
haya colocado en el árbol.

Visitaremos un árbol de expresión y crearemos un árbol nuevo con varios nodos de

reemplazo. En este ejemplo, se van a sustituir todas las constantes con una constante
que es diez veces mayor. De lo contrario, dejará el árbol de expresión intacto. En lugar
de leer el valor de la constante y reemplazarlo con una constante nueva, hará este
cambio reemplazando el nodo constante con un nuevo nodo que realiza la
multiplicación.

Aquí, una vez que se encuentre un nodo constante, se crea un nuevo nodo de
multiplicación cuyos elementos secundarios son la constante original y la constante 10 :

C#

private static Expression ReplaceNodes(Expression original)

if (original.NodeType == ExpressionType.Constant)

return Expression.Multiply(original, Expression.Constant(10));

else if (original.NodeType == ExpressionType.Add)

var binaryExpression = (BinaryExpression)original;

return Expression.Add(

ReplaceNodes(binaryExpression.Left),

ReplaceNodes(binaryExpression.Right));

return original;

Cree un nuevo árbol reemplazando el nodo original por el sustituto. Puede comprobar
los cambios mediante la compilación y ejecución del árbol reemplazado.
 C#

var one = Expression.Constant(1, typeof(int));

var two = Expression.Constant(2, typeof(int));

var addition = Expression.Add(one, two);

var sum = ReplaceNodes(addition);

var executableFunc = Expression.Lambda(sum);

var func = (Func<int>)executableFunc.Compile();

var answer = func();

Console.WriteLine(answer);

La creación de un árbol nuevo es una combinación de visitar los nodos del árbol
existente y crear nodos nuevos e insertarlos en el árbol. En el ejemplo anterior se
muestra la importancia de la inmutabilidad de los árboles de expresión. Observe que el
nuevo árbol creado anteriormente contiene una mezcla de los nodos recién creados y
los nodos del árbol existente. Los nodos se pueden usar en ambos árboles porque los
nodos del árbol existente no se pueden modificar. La reutilización de nodos da lugar a
importantes eficiencias de memoria. Los mismos nodos se pueden usar en un árbol o en
varios árboles de expresión. Dado que los nodos no se pueden modificar, se puede
volver a usar el mismo nodo siempre que sea necesario.

Recorrer y ejecutar una adición

Vamos a comprobar el nuevo árbol mediante la creación de un segundo visitante que
recorre el árbol de nodos de adición y calcula el resultado. Haga algunas modificaciones
en el visitante visto hasta el momento. En esta nueva versión, el visitante devolverá la
suma parcial de la operación de adición hasta este punto. Para una expresión constante,
es simplemente el valor de la expresión constante. Para una expresión de adición, el
resultado es la suma de los operandos izquierdo y derecho, una vez que se recorren
esos árboles.

C#

var one = Expression.Constant(1, typeof(int));

var two = Expression.Constant(2, typeof(int));

var three = Expression.Constant(3, typeof(int));

var four = Expression.Constant(4, typeof(int));

var addition = Expression.Add(one, two);

var add2 = Expression.Add(three, four);

var sum = Expression.Add(addition, add2);

// Declare the delegate, so you can call it

// from itself recursively:

Func<Expression, int> aggregate = null!;

// Aggregate, return constants, or the sum of the left and right operand.

 // Major simplification: Assume every binary expression is an addition.

aggregate = (exp) =>

exp.NodeType == ExpressionType.Constant ?

(int)((ConstantExpression)exp).Value :

aggregate(((BinaryExpression)exp).Left) +
aggregate(((BinaryExpression)exp).Right);

var theSum = aggregate(sum);

Console.WriteLine(theSum);

Aquí hay gran cantidad de código, pero los conceptos son accesibles. Este código visita
los elementos secundarios en una primera búsqueda de profundidad. Cuando encuentra
un nodo constante, el visitante devuelve el valor de la constante. Tras la visita a los dos
elementos secundarios por parte del visitante, dichos elementos han obtenido la suma
calculada para ese subárbol. El nodo de adición ahora puede calcular la suma. Una vez
que se visiten todos los nodos en el árbol de expresión, se habrá calculado la suma. Se
puede hacer el seguimiento de la ejecución ejecutando el ejemplo en el depurador y
realizando el seguimiento de la ejecución.

Vamos a facilitar el seguimiento de cómo se analizan los nodos y cómo se calcula la

suma mediante el recorrido del árbol. Esta es una versión actualizada del método
agregado que incluye gran cantidad de información de seguimiento:

C#

private static int Aggregate(Expression exp)

if (exp.NodeType == ExpressionType.Constant)

var constantExp = (ConstantExpression)exp;

Console.Error.WriteLine($"Found Constant: {constantExp.Value}");

if (constantExp.Value is int value)

return value;

else

return 0;

else if (exp.NodeType == ExpressionType.Add)

var addExp = (BinaryExpression)exp;

Console.Error.WriteLine("Found Addition Expression");

Console.Error.WriteLine("Computing Left node");

var leftOperand = Aggregate(addExp.Left);

Console.Error.WriteLine($"Left is: {leftOperand}");

Console.Error.WriteLine("Computing Right node");

var rightOperand = Aggregate(addExp.Right);

Console.Error.WriteLine($"Right is: {rightOperand}");

 var sum = leftOperand + rightOperand;

Console.Error.WriteLine($"Computed sum: {sum}");

return sum;

else throw new NotSupportedException("Haven't written this yet");

Al ejecutarla en la expresión sum , produce el siguiente resultado:

Resultados

10

Found Addition Expression

Computing Left node

Found Addition Expression

Computing Left node

Found Constant: 1

Left is: 1

Computing Right node

Found Constant: 2

Right is: 2

Computed sum: 3

Left is: 3

Computing Right node

Found Addition Expression

Computing Left node

Found Constant: 3

Left is: 3

Computing Right node

Found Constant: 4

Right is: 4

Computed sum: 7

Right is: 7

Computed sum: 10

10

Realice el seguimiento del resultado y siga el código anterior. Debería poder averiguar
cómo el código visita cada nodo y calcula la suma mientras recorre el árbol y busca la
suma.

Ahora, veremos una ejecución diferente, con la expresión proporcionada por sum1 :

C#

Expression<Func<int>> sum1 = () => 1 + (2 + (3 + 4));

Este es el resultado de examinar esta expresión:

Resultados
 Found Addition Expression

Computing Left node

Found Constant: 1

Left is: 1

Computing Right node

Found Addition Expression

Computing Left node

Found Constant: 2

Left is: 2

Computing Right node

Found Addition Expression

Computing Left node

Found Constant: 3

Left is: 3

Computing Right node

Found Constant: 4

Right is: 4

Computed sum: 7

Right is: 7

Computed sum: 9

Right is: 9

Computed sum: 10

10

Aunque la respuesta final es la misma, el recorrido del árbol es diferente. Los nodos se
recorren en un orden diferente, porque el árbol se construyó con diferentes operaciones
que se producen en primer lugar.

Creación de una copia modificada

Cree un nuevo proyecto de aplicación de consola. Agregue una directiva using al
archivo para el espacio de nombres System.Linq.Expressions . Agregue la clase
AndAlsoModifier al proyecto.

C#

public class AndAlsoModifier : ExpressionVisitor

public Expression Modify(Expression expression)

return Visit(expression);

protected override Expression VisitBinary(BinaryExpression b)

if (b.NodeType == ExpressionType.AndAlso)

Expression left = this.Visit(b.Left);

Expression right = this.Visit(b.Right);

 // Make this binary expression an OrElse operation instead of an

AndAlso operation.

return Expression.MakeBinary(ExpressionType.OrElse, left, right,

b.IsLiftedToNull, b.Method);

return base.VisitBinary(b);

Esta clase hereda la clase ExpressionVisitor y está especializada en la modificación de

expresiones que representan operaciones AND condicionales. Cambia estas operaciones
de una expresión AND condicional a una expresión OR condicional. La clase invalida el
método VisitBinary del tipo base, porque las expresiones AND condicionales se
representan como expresiones binarias. En el método VisitBinary , si la expresión que
se pasa representa una operación AND condicional, el código construye una nueva
expresión que contiene el operador OR condicional en lugar del operador AND
condicional. Si la expresión que se pasa a VisitBinary no representa una operación AND
condicional, el método defiere a la implementación de la case base. Los métodos de
clase base construyen nodos que son como los árboles de expresiones que se pasan,
pero los subárboles de los nodos se reemplazan por los árboles de expresiones que
genera de forma recursiva el visitante.

Agregue una directiva using al archivo para el espacio de nombres

System.Linq.Expressions . Agregue código al método Main en el archivo Program.cs
para crear un árbol de expresión y pasarlo al método que lo modifica.

C#

Expression<Func<string, bool>> expr = name => name.Length > 10 &&

name.StartsWith("G");

Console.WriteLine(expr);

AndAlsoModifier treeModifier = new AndAlsoModifier();

Expression modifiedExpr = treeModifier.Modify((Expression)expr);

Console.WriteLine(modifiedExpr);

/* This code produces the following output:

name => ((name.Length > 10) && name.StartsWith("G"))

name => ((name.Length > 10) || name.StartsWith("G"))

*/

El código crea una expresión que contiene una operación AND condicional. Luego crea
una instancia de la clase AndAlsoModifier y pasa la expresión al método Modify de esta
clase. Se generan los árboles de expresiones tanto originales como modificados para
mostrar el cambio. Compile y ejecute la aplicación.

Más información
En este ejemplo se muestra un pequeño subconjunto del código que se compilaría para
recorrer e interpretar los algoritmos representados por un árbol de expresión. Para
información sobre la compilación de una biblioteca de propósito general que traduce
árboles de expresión a otro lenguaje, lea esta serie de Matt Warren. Describe en detalle
cómo traducir cualquier código que es posible encontrar en un árbol de expresión.

Ahora ha visto la verdadera eficacia de los árboles de expresión. Examine un conjunto

de código, realice los cambios que quiera en ese código y ejecute la versión modificada.
Como los árboles de expresión son inmutables, crea árboles nuevos mediante el uso de
los componentes de árboles existentes. La reutilización de los nodos minimiza la
cantidad de memoria necesaria para crear árboles de expresión modificados.
Expression Trees
Artículo • 09/03/2023 • Tiempo de lectura: 4 minutos

Expression trees represent code in a tree-like data structure, where each node is an
expression, for example, a method call or a binary operation such as x < y .

If you have used LINQ, you have experience with a rich library where the Func types are
part of the API set. (If you aren't familiar with LINQ, you probably want to read the LINQ
tutorial and the article about lambda expressions before this one.) Expression Trees
provide richer interaction with the arguments that are functions.

You write function arguments, typically using Lambda Expressions, when you create
LINQ queries. In a typical LINQ query, those function arguments are transformed into a
delegate the compiler creates.

You've likely already written code that uses Expression trees. Entity Framework's LINQ
APIs accept Expression trees as the arguments for the LINQ Query Expression Pattern.
That enables Entity Framework to translate the query you wrote in C# into SQL that
executes in the database engine. Another example is Moq , which is a popular
mocking framework for .NET.

When you want to have a richer interaction, you need to use Expression Trees. Expression
Trees represent code as a structure that you examine, modify, or execute. These tools
give you the power to manipulate code during run time. You write code that examines
running algorithms, or injects new capabilities. In more advanced scenarios, you modify
running algorithms and even translate C# expressions into another form for execution in
another environment.

You compile and run code represented by expression trees. Building and running
expression trees enables dynamic modification of executable code, the execution of
LINQ queries in various databases, and the creation of dynamic queries. For more
information about expression trees in LINQ, see How to use expression trees to build
dynamic queries.

Expression trees are also used in the dynamic language runtime (DLR) to provide
interoperability between dynamic languages and .NET and to enable compiler writers to
emit expression trees instead of Microsoft intermediate language (MSIL). For more
information about the DLR, see Dynamic Language Runtime Overview.

You can have the C# or Visual Basic compiler create an expression tree for you based on
an anonymous lambda expression, or you can create expression trees manually by using
the System.Linq.Expressions namespace.
When a lambda expression is assigned to a variable of type Expression<TDelegate>, the
compiler emits code to build an expression tree that represents the lambda expression.

The C# compiler generates expression trees only from expression lambdas (or single-
line lambdas). It can't parse statement lambdas (or multi-line lambdas). For more
information about lambda expressions in C#, see Lambda Expressions.

The following code examples demonstrate how to have the C# compiler create an
expression tree that represents the lambda expression num => num < 5 .

C#

Expression<Func<int, bool>> lambda = num => num < 5;

You create expression trees in your code. You build the tree by creating each node and
attaching the nodes into a tree structure. You learn how to create expressions in the
article on building expression trees.

Expression trees are immutable. If you want to modify an expression tree, you must
construct a new expression tree by copying the existing one and replacing nodes in it.
You use an expression tree visitor to traverse the existing expression tree. For more
information, see the article on translating expression trees.

Once you build an expression tree, you execute the code represented by the expression
tree.

Limitations
There are some newer C# language elements that don't translate well into expression
trees. Expression trees can't contain await expressions, or async lambda expressions.
Many of the features added in C# 6 and later don't appear exactly as written in
expression trees. Instead, newer features are exposed in expression trees in the
equivalent, earlier syntax, where possible. Other constructs aren't available. It means that
code that interprets expression trees works the same when new language features are
introduced. However, the expression trees Even with these limitations, expression trees
do enable you to create dynamic algorithms that rely on interpreting and modifying
code that is represented as a data structure. It enables rich libraries such as Entity
Framework to accomplish what they do.

Expression trees won't support new expression node types. It would be a breaking
change for all libraries interpreting expression trees to introduce new node types. The
following list includes most C# language elements that can't be used:
Conditional methods that have been removed
base access
Method group expressions, including address-of (&) a method group, and
anonymous method expressions
References to local functions
Statements, including assignment ( = ) and statement bodied expressions
Partial methods with only a defining declaration
Unsafe pointer operations
dynamic operations
Coalescing operators with null or default literal left side, null coalescing
assignment, and the null propagating operator (?.)
Multi-dimensional array initializers, indexed properties, and dictionary initializers
throw expressions
Accessing static virtual or abstract interface members
Lambda expressions that have attributes
Interpolated strings
UTF-8 string conversions or UTF-8 string literals
Method invocations using variable arguments, named arguments or optional
arguments
Expressions using System.Index or System.Range, index "from end" (^) operator or
range expressions (..)
async lambda expressions or await expressions, including await foreach and await
using
Tuple literals, tuple conversions, tuple == or !=, or with expressions
Discards (_), deconstructing assignment, pattern matching is operator or the
pattern matching switch expression
COM call with ref omitted on the arguments
ref, in or out parameters, ref return values, out arguments, or any values of ref
struct type
Interoperability Overview
Artículo • 25/02/2023 • Tiempo de lectura: 3 minutos

Interoperability enables you to preserve and take advantage of existing investments in

unmanaged code. Code that runs under the control of the common language runtime
(CLR) is managed code, and code that runs outside the CLR is unmanaged code. COM,
COM+, C++ components, ActiveX components, and Microsoft Windows API are
examples of unmanaged code.

.NET enables interoperability with unmanaged code through platform invoke services,
the System.Runtime.InteropServices namespace, C++ interoperability, and COM
interoperability (COM interop).

Platform Invoke
Platform invoke is a service that enables managed code to call unmanaged functions
implemented in dynamic link libraries (DLLs), such as the Microsoft Windows API. It
locates and invokes an exported function and marshals its arguments (integers, strings,
arrays, structures, and so on) across the interoperation boundary as needed.

For more information, see Consuming Unmanaged DLL Functions and How to use
platform invoke to play a WAV file.

７ Nota

The Common Language Runtime (CLR) manages access to system resources.

Calling unmanaged code that is outside the CLR bypasses this security mechanism,
and therefore presents a security risk. For example, unmanaged code might call
resources in unmanaged code directly, bypassing CLR security mechanisms. For
more information, see Security in .NET.

C++ Interop
You can use C++ interop, also known as It Just Works (IJW), to wrap a native C++ class.
C++ interop enables code authored in C# or another .NET language to access it. You
write C++ code to wrap a native DLL or COM component. Unlike other .NET languages,
Visual C++ has interoperability support that enables managed and unmanaged code in
the same application and even in the same file. You then build the C++ code by using
the /clr compiler switch to produce a managed assembly. Finally, you add a reference to
the assembly in your C# project and use the wrapped objects just as you would use
other managed classes.

Exposing COM Components to C#

You can consume a COM component from a C# project. The general steps are as
follows:

1. Locate a COM component to use and register it. Use regsvr32.exe to register or
un–register a COM DLL.
2. Add to the project a reference to the COM component or type library.
When you
add the reference, Visual Studio uses the Tlbimp.exe (Type Library Importer), which
takes a type library as input, to output a .NET interop assembly. The assembly, also
named a runtime callable wrapper (RCW), contains managed classes and interfaces
that wrap the COM classes and interfaces that are in the type library. Visual Studio
adds to the project a reference to the generated assembly.
3. Create an instance of a class defined in the RCW. Creating an instance of that class
creates an instance of the COM object.
4. Use the object just as you use other managed objects. When the object is
reclaimed by garbage collection, the instance of the COM object is also released
from memory.

For more information, see Exposing COM Components to the .NET Framework.

Exposing C# to COM
COM clients can consume C# types that have been correctly exposed. The basic steps to
expose C# types are as follows:

1. Add interop attributes in the C# project.

You can make an assembly COM visible by
modifying C# project properties. For more information, see Assembly Information
Dialog Box.
2. Generate a COM type library and register it for COM usage.
You can modify C#
project properties to automatically register the C# assembly for COM interop.
Visual Studio uses the Regasm.exe (Assembly Registration Tool), using the /tlb
command-line switch, which takes a managed assembly as input, to generate a
type library. This type library describes the public types in the assembly and adds
registry entries so that COM clients can create managed classes.

For more information, see Exposing .NET Framework Components to COM and Example
COM Class.
See also
Improving Interop Performance
Introduction to Interoperability between COM and .NET
Introduction to COM Interop in Visual Basic
Marshaling between Managed and Unmanaged Code
Interoperating with Unmanaged Code
Control de versiones en C#
Artículo • 18/02/2023 • Tiempo de lectura: 6 minutos

En este tutorial, obtendrá información sobre qué significa el control de versiones en

.NET. También obtendrá información sobre los factores que deben tenerse en cuenta
para controlar las versiones de su biblioteca así como para actualizar a una versión
nueva de esta.

Creación de bibliotecas
Como desarrollador que ha creado bibliotecas de .NET para uso público, probablemente
se ha encontrado en situaciones en las que tiene que implementar nuevas
actualizaciones. Cómo realizar este proceso es muy importante, ya que necesita
asegurarse de que existe una transición sin problemas del código existente a la versión
nueva de su biblioteca. Aquí se muestran algunos aspectos para tener en cuenta a la
hora de crear una versión nueva:

Control de versiones semántico

Control de versiones semántico (SemVer para abreviar) es una convención de
nomenclatura que se aplica a las versiones de su biblioteca para indicar eventos
importantes específicos.
De manera ideal, la información de la versión que proporciona
a la biblioteca debe ayudar a los desarrolladores a determinar la compatibilidad con sus
proyectos que usan versiones anteriores de la misma biblioteca.

El enfoque más sencillo de SemVer es el formato de 3 componentes MAJOR.MINOR.PATCH ,

donde:

MAJOR se incrementa cuando realiza cambios de API incompatibles

MINOR se incrementa cuando agrega funciones de manera compatible con

versiones anteriores
PATCH se incrementa cuando realiza correcciones de errores compatibles con

versiones anteriores

También existen maneras de especificar otros escenarios, por ejemplo, versiones

preliminares, al aplicar información de la versión a su biblioteca .NET.

Compatibilidad con versiones anteriores

A medida que presente versiones nuevas de su biblioteca, la compatibilidad con las
versiones anteriores será probablemente una de sus mayores preocupaciones.
Una
versión nueva de su biblioteca es compatible en su origen con una versión anterior si el
código que depende de la versión anterior, puede, cuando se vuelve a compilar, trabajar
con la versión nueva.
Una versión nueva de su biblioteca tiene compatibilidad binaria si
una aplicación que dependía de la versión anterior, puede, sin que se vuelva a compilar,
trabajar con la versión nueva.

Aquí se muestran algunos aspectos a tener en cuenta al intentar mantener la

compatibilidad con versiones anteriores de su biblioteca:

Métodos virtuales: cuando hace que un método virtual sea no virtual en la versión
nueva, significa que los proyectos que reemplacen ese método tendrán que
actualizarse. Esto es un cambio brusco enorme y se desaconseja totalmente.
Firmas de método: cuando actualizar un comportamiento del método requiere que
también se cambie su firma, en su lugar se debe crear una sobrecarga de manera
que el código que llama a ese método siga funcionando.
Siempre puede
manipular la firma del método anterior para llamar a la firma del método nuevo,
de manera que la implementación siga siendo coherente.
Atributo obsoleto: puede usar este atributo en el código para especificar clases o
miembros de clases que han quedado obsoletos y que probablemente se quiten
en versiones futuras. Esto garantiza que los desarrolladores que usen su biblioteca
estén mejor preparados para los cambios bruscos.
Argumentos de método opcionales: cuando hace que los argumentos de método
opcionales anteriores sean obligatorios o cambien su valor predeterminado, se
tendrá que actualizar todo el código que no proporcione esos argumentos.

７ Nota

Hacer que los argumentos obligatorios sean opcionales debe tener un efecto muy
pequeño, especialmente si no cambia el comportamiento del método.

Cuánto más facilite la actualización a la nueva versión de la biblioteca a sus usuarios,

más rápidamente la actualizarán.

Archivo de configuración de aplicación

Como desarrollador de .NET, existe una posibilidad muy alta de que haya encontrado el
archivo app.config en la mayoría de tipos de proyecto.
Este sencillo archivo de
configuración puede hacer mucho por mejorar la implementación de las actualizaciones
nuevas. Generalmente, debe diseñar sus bibliotecas de tal manera que la información
que es probable que cambie regularmente se almacene en el archivo app.config , de
esta manera, cuando dicha información se actualice, el archivo de configuración de las
versiones anteriores solo necesita reemplazarse por el nuevo sin necesidad de volver a
compilar la biblioteca.

Consumo de bibliotecas
Como desarrollador que consume bibliotecas .NET creadas por otros desarrolladores, es
probable que sea consciente de que una nueva versión de una biblioteca puede que no
sea completamente compatible con su proyecto y, a menudo, puede que tenga que
actualizar su código para trabajar con esos cambios.

Por suerte, C# y el ecosistema de .NET incluyen características y técnicas que nos

permiten actualizar fácilmente nuestra aplicación para que funcione con las versiones
nuevas de bibliotecas que pueden presentar cambios bruscos.

Redirección de enlace de ensamblados

Puede usar el archivo app.config para actualizar la versión de una biblioteca que use su
aplicación. Al agregar lo que se denomina una redirección de enlace, se puede usar la
nueva versión de la biblioteca sin tener que volver a compilar la aplicación. En el
siguiente ejemplo se muestra cómo actualizaría el archivo app.config de la aplicación
para usar la versión de revisión 1.0.1 de ReferencedLibrary , en lugar de la versión
1.0.0 con la que se ha compilado originalmente.

XML

<dependentAssembly>

<assemblyIdentity name="ReferencedLibrary"
publicKeyToken="32ab4ba45e0a69a1" culture="en-us" />

<bindingRedirect oldVersion="1.0.0" newVersion="1.0.1" />

</dependentAssembly>

７ Nota

Este enfoque solo funcionará si la versión nueva de ReferencedLibrary tiene

compatibilidad binaria con su aplicación.
Vea la sección anterior Compatibilidad
con versiones anteriores para ver los cambios que debe tener en cuenta al
determinar la compatibilidad.
new
Use el modificador new para ocultar los miembros heredados de una clase base. Esta es
una manera en la que las clases derivadas pueden responder a las actualizaciones en
clases base.

Considere el ejemplo siguiente:

C#

public class BaseClass

public void MyMethod()

Console.WriteLine("A base method");

public class DerivedClass : BaseClass

public new void MyMethod()

Console.WriteLine("A derived method");

public static void Main()

BaseClass b = new BaseClass();

DerivedClass d = new DerivedClass();

b.MyMethod();

d.MyMethod();

Salida

Consola

A base method

A derived method

En el ejemplo anterior puede ver cómo DerivedClass oculta el método MyMethod

presente en BaseClass .
Esto significa que cuando una clase base en la versión nueva de
una biblioteca agrega un miembro que ya existe en su clase derivada, simplemente
puede usar el modificador new en su miembro de clase derivada para ocultar el
miembro de clase base.
Cuando no se especifica ningún modificador new , una clase derivada ocultará de
manera predeterminada los miembros en conflicto de una clase base, aunque se
generará una advertencia del compilador, el código se compilará. Esto significa que
agregar simplemente miembros nuevos a una clase existente, hace que la versión nueva
de su biblioteca tenga compatibilidad binaria y de origen con el código que depende de
ella.

override
El modificador override significa que una implementación derivada extiende la
implementación de un miembro de clase base en lugar de ocultarlo. El miembro de
clase base necesita que se le aplique el modificador virtual .

C#

public class MyBaseClass

public virtual string MethodOne()

return "Method One";

public class MyDerivedClass : MyBaseClass

public override string MethodOne()

return "Derived Method One";

public static void Main()

MyBaseClass b = new MyBaseClass();

MyDerivedClass d = new MyDerivedClass();

Console.WriteLine("Base Method One: {0}", b.MethodOne());

Console.WriteLine("Derived Method One: {0}", d.MethodOne());

Salida

Consola

Base Method One: Method One

Derived Method One: Derived Method One

El modificador override se evalúa en tiempo de compilación y el compilador producirá

un error si no encuentra un miembro virtual que reemplazar.

Su conocimiento de las técnicas que se han tratado y su comprensión de las situaciones

en las cuales usarlas, contribuirá en gran medida a facilitar la transición entre las
versiones de una biblioteca.
Procedimientos (C#)
Artículo • 09/02/2023 • Tiempo de lectura: 3 minutos

En la sección de procedimientos de la guía de C# puede encontrar respuestas rápidas a

preguntas frecuentes. En algunos casos, los artículos pueden mostrarse en varias
secciones. Hemos querido que sean fáciles de encontrar en diferentes rutas de
búsqueda.

Conceptos generales de C#
Hay varios trucos y sugerencias que son habituales entre los desarrolladores de C#:

Inicialice los objetos usando un inicializador de objeto.

Obtenga información sobre las diferencias entre pasar una estructura o una clase a
un método.
Use la sobrecarga de operadores.
Implemente e invoque un método de extensión personalizado.
Cree un nuevo método para un tipo enum mediante métodos de extensión.

Miembros de clase, registro y estructura

Para implementar un programa se usan clases, registros y estructuras. Estas técnicas
suelen usarse al escribir clases, registros o estructuras.

Declare propiedades de implementación automática.

Declare y use propiedades de lectura y escritura.
Defina las constantes.
Invalide el método ToString para proporcionar la salida de la cadena.
Defina las propiedades abstractas.
Use las características de documentación XML para documentar el código.
Implemente explícitamente miembros de interfaz para que su interfaz pública sea
concisa.
Implemente explícitamente miembros de dos interfaces.

Trabajar con colecciones

Estos artículos le ayudarán a trabajar con colecciones de datos.

Inicialice un diccionario con un inicializador de colección.

Trabajo con cadenas
Las cadenas son el tipo de datos básico que se usa para mostrar o manipular texto. En
estos artículos se muestran prácticas habituales con cadenas.

Compare cadenas.
Modifique el contenido de una cadena.
Determine si una cadena representa un número.
Use String.Split para separar cadenas.
Combine varias cadenas en una.
Busque texto en una cadena.

Conversión entre tipos

Puede que deba convertir un objeto a otro tipo.

Determine si una cadena representa un número.

Realice conversiones entre cadenas que representen números hexadecimales y el
número.
Convierta una cadena en un valor DateTime.
Convierta una matriz de bytes en un valor int.
Convierta una cadena en un número.
Use la coincidencia de patrones y los operadores as y is para una conversión
segura a otro tipo.
Definición de las conversiones de tipos personalizadas.
Determine si un tipo es un tipo de valor que acepta valores NULL.
Realice conversiones entre tipos de valores que aceptan valores NULL y tipos que
no.

Comparaciones de igualdad y ordenación

Puede crear tipos que definan sus propias reglas para la igualdad o que definan una
ordenación natural entre los objetos de ese tipo.

Pruebe la igualdad basada en referencias.

Defina la igualdad basada en valores de un tipo.

Control de excepciones
Los programas de .NET informan de que un método no se ha ejecutado correctamente y
de que se han generado excepciones. En estos artículos aprenderá a trabajar con
excepciones.

Controle excepciones mediante try y catch.

Limpie recursos con cláusulas finally.
Recupere excepciones no conformes a CLS (Common Language Specification).

Delegados y eventos
Los delegados y los eventos proporcionan capacidad para las estrategias que implican
bloques de código sin una conexión directa.

Declare y use delegados, y cree instancias de estos.

Combine delegados multidifusión.

Los eventos son un mecanismo para publicar notificaciones o suscribirse a ellas.

Suscríbase a eventos y cancele la suscripción a estos.

Implemente eventos declarados en interfaces.
Garantice la conformidad a las directrices de .NET cuando el código publica los
eventos.
Genere eventos definidos en las clases base a partir de clases derivadas.
Implemente descriptores de acceso de eventos personalizados.

Prácticas de LINQ
LINQ permite escribir código para consultar cualquier origen de datos que admita su
patrón de expresión de consultas. Estos artículos le ayudarán a comprender el patrón y
a trabajar con orígenes de datos diferentes.

Consulte una colección.

Use var en expresiones de consulta.
Devuelva subconjuntos de propiedades de elementos de una consulta.
Escriba consultas con filtrado complejo.
Ordene los elementos de un origen de datos.
Ordene elementos en varias claves.
Controle el tipo de una proyección.
Cuente las repeticiones de un valor en una secuencia de origen.
Calcule valores intermedios.
Combine datos de varios orígenes.
Encuentre la diferencia de conjuntos entre dos secuencias.
Depure los resultados vacíos de una consulta.
Agregue métodos personalizados para las consultas de LINQ.
Varios subprocesos y procesamiento
asincrónico
Los programas modernos suelen usar operaciones asincrónicas. Estos artículos le
ayudarán a aprender a usar estas técnicas.

Mejore el rendimiento asíncrono usando System.Threading.Tasks.Task.WhenAll.

Realice varias solicitudes web en paralelo usando async y await.
Use un grupo de subprocesos.

Argumentos de línea de comandos para el

programa
Normalmente, los programas de C# tienen argumentos de línea de comandos. En estos
artículos se explica cómo obtener acceso a los argumentos de línea de comandos,
además de cómo procesarlos.

Recupere todos los argumentos de línea de comandos con for.

Procedimiento para separar cadenas
mediante String.Split en C#
Artículo • 28/11/2022 • Tiempo de lectura: 2 minutos

El método String.Split crea una matriz de subcadenas mediante la división de la cadena

de entrada en función de uno o varios delimitadores. A menudo, este método es la
manera más fácil de separar una cadena en límites de palabras. También sirve para
dividir las cadenas en otras cadenas o caracteres específicos.

７ Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y

área de juegos de Try.NET . Haga clic en el botón Ejecutar para ejecutar un
ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede
modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El
código modificado se ejecuta en la ventana interactiva o, si se produce un error en
la compilación, en la ventana interactiva se muestran todos los mensajes de error
del compilador de C#.

Este código divide una frase común en una matriz de cadenas para cada palabra.

C#

string phrase = "The quick brown fox jumps over the lazy dog.";

string[] words = phrase.Split(' ');

foreach (var word in words)

System.Console.WriteLine($"<{word}>");

Todas las instancias de un carácter separador generan un valor en la matriz devuelta. Los
caracteres separadores consecutivos generan la cadena vacía como un valor en la matriz
devuelta. Puede ver cómo se crea una cadena vacía en el ejemplo siguiente, en el que se
usa el carácter de espacio como separador.

C#

string phrase = "The quick brown fox jumps over the lazy dog.";

string[] words = phrase.Split(' ');

foreach (var word in words)

System.Console.WriteLine($"<{word}>");

Este comportamiento facilita formatos como los de los archivos de valores separados
por comas (CSV) que representan datos tabulares. Las comas consecutivas representan
una columna en blanco.

Puede pasar un parámetro StringSplitOptions.RemoveEmptyEntries opcional para excluir

cualquier cadena vacía en la matriz devuelta. Para un procesamiento más complicado de
la colección devuelta, puede usar LINQ para manipular la secuencia de resultados.

String.Split puede usar varios caracteres separadores.

En este ejemplo se usan espacios,
comas, puntos, dos puntos y tabulaciones como caracteres de separación, que se pasan
a Split en una matriz.
En el bucle al final del código se muestra cada una de las palabras
de la matriz devuelta.

C#

char[] delimiterChars = { ' ', ',', '.', ':', '\t' };

string text = "one\ttwo three:four,five six seven";

System.Console.WriteLine($"Original text: '{text}'");

string[] words = text.Split(delimiterChars);

System.Console.WriteLine($"{words.Length} words in text:");

foreach (var word in words)

System.Console.WriteLine($"<{word}>");

Las instancias consecutivas de cualquier separador generan la cadena vacía en la matriz

de salida:

C#

char[] delimiterChars = { ' ', ',', '.', ':', '\t' };

string text = "one\ttwo :,five six seven";

System.Console.WriteLine($"Original text: '{text}'");

string[] words = text.Split(delimiterChars);

System.Console.WriteLine($"{words.Length} words in text:");

foreach (var word in words)

System.Console.WriteLine($"<{word}>");

String.Split puede tomar una matriz de cadenas (secuencias de caracteres que actúan
como separadores para analizar la cadena de destino, en lugar de caracteres
individuales).

C#

string[] separatingStrings = { "<<", "..." };

string text = "one<<two......three<four";

System.Console.WriteLine($"Original text: '{text}'");

string[] words = text.Split(separatingStrings,

System.StringSplitOptions.RemoveEmptyEntries);

System.Console.WriteLine($"{words.Length} substrings in text:");

foreach (var word in words)

System.Console.WriteLine(word);

Vea también
Extracción de elementos de una cadena
Guía de programación de C#
Cadenas
Expresiones regulares de .NET
Procedimiento para concatenar varias
cadenas (Guía de C#)
Artículo • 22/09/2022 • Tiempo de lectura: 4 minutos

Concatenación es el proceso de anexar una cadena al final de otra cadena. Las cadenas
se concatenan con el operador + . En el caso de los literales y las constantes de cadena,
la concatenación se produce en tiempo de compilación, y no en tiempo de ejecución. En
cambio, para las variables de cadena, la concatenación solo se produce en tiempo de
ejecución.

７ Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y

área de juegos de Try.NET . Haga clic en el botón Ejecutar para ejecutar un
ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede
modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El
código modificado se ejecuta en la ventana interactiva o, si se produce un error en
la compilación, en la ventana interactiva se muestran todos los mensajes de error
del compilador de C#.

Literales de cadena
En el ejemplo siguiente se divide un literal de cadena larga en cadenas más pequeñas
para mejorar la legibilidad en el código fuente. El código concatena las cadenas más
pequeñas para crear el literal de cadena larga. Los elementos se concatenan en una sola
cadena en tiempo de compilación. No existe ningún costo de rendimiento en tiempo de
ejecución independientemente del número de cadenas implicadas.

C#

// Concatenation of literals is performed at compile time, not run time.

string text = "Historically, the world of data and the world of objects " +

"have not been well integrated. Programmers work in C# or Visual Basic " +

"and also in SQL or XQuery. On the one side are concepts such as classes, "
+

"objects, fields, inheritance, and .NET Framework APIs. On the other side "
+

"are tables, columns, rows, nodes, and separate languages for dealing with "
+

"them. Data types often require translation between the two worlds; there
are " +

 "different standard functions. Because the object world has no notion of

query, a " +

"query can only be represented as a string without compile-time type

checking or " +

"IntelliSense support in the IDE. Transferring data from SQL tables or XML
trees to " +

"objects in memory is often tedious and error-prone.";

System.Console.WriteLine(text);

Operadores + y +=
Para concatenar variables de cadena, puede usar los operadores + o += , la
interpolación de cadena o los métodos String.Format, String.Concat, String.Join o
StringBuilder.Append. El operador + es sencillo de usar y genera un código intuitivo.
Aunque use varios operadores + en una instrucción, el contenido de la cadena se
copiará solo una vez. En el código siguiente se muestran ejemplos del uso de los
operadores + y += para concatenar cadenas:

C#

string userName = "<Type your name here>";

string dateString = DateTime.Today.ToShortDateString();

// Use the + and += operators for one-time concatenations.

string str = "Hello " + userName + ". Today is " + dateString + ".";

System.Console.WriteLine(str);

str += " How are you today?";

System.Console.WriteLine(str);

Interpolación de cadenas
En algunas expresiones, es más fácil concatenar cadenas mediante la interpolación de
cadena, como se muestra en este código:

C#

string userName = "<Type your name here>";

string date = DateTime.Today.ToShortDateString();

// Use string interpolation to concatenate strings.

string str = $"Hello {userName}. Today is {date}.";

System.Console.WriteLine(str);

 str = $"{str} How are you today?";

System.Console.WriteLine(str);

７ Nota

En operaciones de concatenación de cadenas, el compilador de C# trata una

cadena NULL igual que una cadena vacía.

A partir de C# 10, se puede utilizar la interpolación de cadenas para inicializar una

cadena constante cuando todas las expresiones utilizadas para los marcadores de
posición son también cadenas constantes.

String.Format
Otro método para concatenar cadenas es String.Format. Este método funciona bien
cuando se crea una cadena a partir de un número reducido de cadenas de componente.

StringBuilder
En otros casos, puede combinar cadenas en un bucle, donde no sabe cuántas cadenas
de origen se combinan, y el número real de cadenas de origen puede ser elevado. La
clase StringBuilder se diseñó para estos escenarios. El código siguiente usa el método
Append de la clase StringBuilder para concatenar cadenas.

C#

// Use StringBuilder for concatenation in tight loops.

var sb = new System.Text.StringBuilder();

for (int i = 0; i < 20; i++)

sb.AppendLine(i.ToString());

System.Console.WriteLine(sb.ToString());

Puede obtener más información sobre las razones para elegir la concatenación de
cadenas o sobre la clase StringBuilder.

String.Concat o String.Join
Otra opción para combinar cadenas a partir de una colección consiste en usar el
método String.Concat. Use el método String.Join si las cadenas de origen se deben
separar con un delimitador. El código siguiente combina una matriz de palabras usando
ambos métodos:

C#

string[] words = { "The", "quick", "brown", "fox", "jumps", "over", "the",

"lazy", "dog." };

var unreadablePhrase = string.Concat(words);

System.Console.WriteLine(unreadablePhrase);

var readablePhrase = string.Join(" ", words);

System.Console.WriteLine(readablePhrase);

LINQ y Enumerable.Aggregate
Por último, puede usar LINQ y el método Enumerable.Aggregate para combinar cadenas
a partir de una colección. Este método combina las cadenas de origen mediante una
expresión lambda. La expresión lambda realiza el trabajo de agregar cada cadena a la
acumulación existente. En el ejemplo siguiente se combina una matriz de palabras y se
agrega un espacio entre cada palabra de la matriz:

C#

string[] words = { "The", "quick", "brown", "fox", "jumps", "over", "the",

"lazy", "dog." };

var phrase = words.Aggregate((partialPhrase, word) =>$"{partialPhrase}

{word}");

System.Console.WriteLine(phrase);

Esta opción puede provocar más asignaciones que otros métodos para concatenar
colecciones, ya que crea una cadena intermedia para cada iteración. Si la optimización
del rendimiento es fundamental, considere la clase StringBuilder o los métodos
String.Concat o String.Join para concatenar una colección, en vez de
Enumerable.Aggregate .

Vea también
String
StringBuilder
Guía de programación de C#
Cadenas
Cómo buscar cadenas
Artículo • 15/11/2022 • Tiempo de lectura: 4 minutos

Puede usar dos estrategias principales para buscar texto en cadenas. Los métodos de la
clase String buscan un texto concreto. Las expresiones regulares buscan patrones en el
texto.

７ Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y

área de juegos de Try.NET . Haga clic en el botón Ejecutar para ejecutar un
ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede
modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El
código modificado se ejecuta en la ventana interactiva o, si se produce un error en
la compilación, en la ventana interactiva se muestran todos los mensajes de error
del compilador de C#.

El tipo string, que es un alias de la clase System.String, proporciona una serie de

métodos útiles para buscar el contenido de una cadena. Entre ellos se encuentran
Contains, StartsWith, EndsWith, IndexOf y LastIndexOf. La clase
System.Text.RegularExpressions.Regex proporciona un vocabulario completo para buscar
patrones en el texto. En este artículo, aprenderá estas técnicas y a elegir el mejor
método para sus necesidades.

¿Una cadena contiene texto?

Los métodos String.Contains, String.StartsWith y String.EndsWith buscan texto concreto
en una cadena. En el ejemplo siguiente, se muestra cada uno de estos métodos y una
variación que usa una búsqueda que no distingue mayúsculas de minúsculas:

C#

string factMessage = "Extension methods have all the capabilities of regular

static methods.";

// Write the string and include the quotation marks.

Console.WriteLine($"\"{factMessage}\"");

// Simple comparisons are always case sensitive!

bool containsSearchResult = factMessage.Contains("extension");

Console.WriteLine($"Contains \"extension\"? {containsSearchResult}");

 // For user input and strings that will be displayed to the end user,

// use the StringComparison parameter on methods that have it to specify how

to match strings.

bool ignoreCaseSearchResult = factMessage.StartsWith("extension",

System.StringComparison.CurrentCultureIgnoreCase);

Console.WriteLine($"Starts with \"extension\"? {ignoreCaseSearchResult}

(ignoring case)");

bool endsWithSearchResult = factMessage.EndsWith(".",

System.StringComparison.CurrentCultureIgnoreCase);

Console.WriteLine($"Ends with '.'? {endsWithSearchResult}");

En el ejemplo anterior, se muestra un aspecto importante del uso de estos métodos. De

manera predeterminada, las búsquedas distinguen mayúsculas de minúsculas. El valor
de enumeración StringComparison.CurrentCultureIgnoreCase se usa para especificar
que se trata de una búsqueda que no distingue mayúsculas de minúsculas.

¿Dónde se encuentra el texto buscado en una

cadena?
Los métodos IndexOf y LastIndexOf también buscan texto en cadenas. Estos métodos
devuelven la ubicación del texto que se busca. Si no se encuentra el texto, devuelven
-1 . En el ejemplo siguiente, se muestra una búsqueda de la primera y última aparición

de la palabra "methods" y muestra el texto que hay en medio.

C#

string factMessage = "Extension methods have all the capabilities of regular

static methods.";

// Write the string and include the quotation marks.

Console.WriteLine($"\"{factMessage}\"");

// This search returns the substring between two strings, so

// the first index is moved to the character just after the first string.

int first = factMessage.IndexOf("methods") + "methods".Length;

int last = factMessage.LastIndexOf("methods");

string str2 = factMessage.Substring(first, last - first);

Console.WriteLine($"Substring between \"methods\" and \"methods\":

'{str2}'");

Buscar texto concreto mediante expresiones

regulares
La clase System.Text.RegularExpressions.Regex se puede usar para buscar cadenas. Estas
búsquedas pueden abarcar una complejidad que va desde patrones de texto simples
hasta otros complejos.

En el ejemplo de código siguiente, se busca la palabra "the" o "their" en una oración, sin
distinción entre mayúsculas y minúsculas. El método estático Regex.IsMatch realiza la
búsqueda. Se proporciona la cadena de búsqueda y un patrón de búsqueda. En este
caso, un tercer argumento especifica que la búsqueda no distingue mayúsculas de
minúsculas. Para obtener más información, vea
System.Text.RegularExpressions.RegexOptions.

El patrón de búsqueda describe el texto que se busca. En la tabla siguiente, se describe

cada elemento del patrón de búsqueda. (En la tabla siguiente se usa un único símbolo
\ , que en una cadena de C# debe escribirse como \\ ).

Modelo Significado

the busca coincidencias con el texto "the"

(eir)? busca coincidencias con 0 o 1 apariciones de "eir"

\s busca coincidencias con un carácter de espacio en blanco

C#

string[] sentences =

"Put the water over there.",

"They're quite thirsty.",

"Their water bottles broke."

};

string sPattern = "the(ir)?\\s";

foreach (string s in sentences)

Console.Write($"{s,24}");

if (System.Text.RegularExpressions.Regex.IsMatch(s, sPattern,
System.Text.RegularExpressions.RegexOptions.IgnoreCase))

Console.WriteLine($" (match for '{sPattern}' found)");

else

Console.WriteLine();

  Sugerencia

Los métodos string suelen ser mejores opciones cuando se busca una cadena
exacta. Las expresiones regulares son más adecuadas cuando se busca algún
patrón en una cadena de origen.

¿Una cadena sigue un patrón?

El código siguiente usa expresiones regulares para validar el formato de cada cadena de
una matriz. La validación requiere que cada cadena tenga la forma de un número de
teléfono en el que tres grupos de dígitos se separan por guiones. Los dos primeros
grupos contienen tres dígitos y el tercero, cuatro. El patrón de búsqueda usa la
expresión regular ^\\d{3}-\\d{3}-\\d{4}$ . Para obtener más información, consulte
Lenguaje de expresiones regulares: Referencia rápida.

Modelo Significado

^ busca coincidencias con el principio de la cadena

\d{3} busca coincidencias con exactamente 3 caracteres de dígitos

- busca coincidencias con el carácter “-”

\d{4} busca coincidencias con exactamente 4 caracteres de dígitos

$ busca coincidencias con el final de la cadena

C#

string[] numbers =

"123-555-0190",

"444-234-22450",

"690-555-0178",

"146-893-232",

"146-555-0122",

"4007-555-0111",

"407-555-0111",

"407-2-5555",

"407-555-8974",

"407-2ab-5555",

"690-555-8148",

"146-893-232-"

};

string sPattern = "^\\d{3}-\\d{3}-\\d{4}$";

 foreach (string s in numbers)

Console.Write($"{s,14}");

if (System.Text.RegularExpressions.Regex.IsMatch(s, sPattern))
{

Console.WriteLine(" - valid");

else

Console.WriteLine(" - invalid");

Este patrón de búsqueda sencillo coincide con muchas cadenas válidas. Las expresiones
regulares son mejores para buscar o validar con respecto a un patrón, en lugar de una
cadena de texto sencilla.

Vea también
Guía de programación de C#
Cadenas
LINQ y cadenas
System.Text.RegularExpressions.Regex
Expresiones regulares de .NET
Lenguaje de expresiones regulares: referencia rápida
Procedimientos recomendados para el uso de cadenas en .NET
Procedimiento para modificar el
contenido de cadenas en C#
Artículo • 29/11/2022 • Tiempo de lectura: 6 minutos

En este artículo se muestran varias técnicas para producir una string modificando una
string existente. Todas las técnicas mostradas devuelven el resultado de las

modificaciones como un objeto string nuevo. Para demostrar que las cadenas
originales y modificadas son instancias distintas, los ejemplos almacenan el resultado en
una variable nueva. Al ejecutar cada ejemplo, se puede examinar tanto el objeto string
original como el objeto string nuevo y modificado.

７ Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y

área de juegos de Try.NET . Haga clic en el botón Ejecutar para ejecutar un
ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede
modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El
código modificado se ejecuta en la ventana interactiva o, si se produce un error en
la compilación, en la ventana interactiva se muestran todos los mensajes de error
del compilador de C#.

En este artículo se muestran varias técnicas. Puede reemplazar el texto existente. Puede
buscar patrones y reemplazar el texto coincidente por otro texto. Puede tratar una
cadena con una secuencia de caracteres. También puede usar métodos de conveniencia
para eliminar espacios en blanco. Elija la técnica con mayor coincidencia con el
escenario.

Reemplazo de texto
Con el código siguiente se crea una cadena mediante el reemplazo de texto con un
sustituto.

C#

string source = "The mountains are behind the clouds today.";

// Replace one substring with another with String.Replace.

// Only exact matches are supported.

var replacement = source.Replace("mountains", "peaks");

 Console.WriteLine($"The source string is <{source}>");

Console.WriteLine($"The updated string is <{replacement}>");

En el código anterior se muestra esta propiedad inmutable de las cadenas. En el ejemplo

anterior puede ver que la cadena original, source , no se ha modificado. Con el método
String.Replace se crea una string que contiene las modificaciones.

Con el método Replace se pueden reemplazar cadenas o caracteres únicos. En ambos

casos, se reemplazan todas las instancias del texto buscado. En el siguiente ejemplo se
reemplazan todos los caracteres " " por "_":

C#

string source = "The mountains are behind the clouds today.";

// Replace all occurrences of one char with another.

var replacement = source.Replace(' ', '_');

Console.WriteLine(source);

Console.WriteLine(replacement);

La cadena de origen se mantiene y se devuelve una cadena nueva con los reemplazos.

Recorte de espacios en blanco

Puede usar los métodos String.Trim, String.TrimStart, y String.TrimEnd para quitar los
espacios en blanco al inicio y al final. En el código siguiente se muestra un ejemplo de
cada caso. La cadena de origen no cambia; con estos métodos se devuelve una cadena
nueva con el contenido modificado.

C#

// Remove trailing and leading white space.

string source = " I'm wider than I need to be. ";

// Store the results in a new string variable.

var trimmedResult = source.Trim();

var trimLeading = source.TrimStart();

var trimTrailing = source.TrimEnd();

Console.WriteLine($"<{source}>");

Console.WriteLine($"<{trimmedResult}>");

Console.WriteLine($"<{trimLeading}>");

Console.WriteLine($"<{trimTrailing}>");

Eliminación de texto
Puede quitar texto de una cadena con el método String.Remove. Este método quita un
número de caracteres que comienzan con un índice específico. En el siguiente ejemplo
se muestra cómo usar String.IndexOf seguido por Remove para quitar texto de una
cadena:

C#

string source = "Many mountains are behind many clouds today.";

// Remove a substring from the middle of the string.

string toRemove = "many ";

string result = string.Empty;

int i = source.IndexOf(toRemove);

if (i >= 0)

result= source.Remove(i, toRemove.Length);

Console.WriteLine(source);

Console.WriteLine(result);

Reemplazo de patrones de coincidencia

Puede usar expresiones regulares para reemplazar texto que coincida con patrones por
texto nuevo, posiblemente definido por un patrón. En el ejemplo siguiente se usa la
clase System.Text.RegularExpressions.Regex para encontrar un patrón en una cadena de
origen y reemplazarlo con un uso de mayúsculas y minúsculas adecuado. Con el
método Regex.Replace(String, String, MatchEvaluator, RegexOptions) se usa una función
que proporciona la lógica del reemplazo de uno de los argumentos. En este ejemplo, la
función LocalReplaceMatchCase es una función local declarada dentro del método de
ejemplo. LocalReplaceMatchCase usa la clase System.Text.StringBuilder para crear la
cadena de reemplazo con un uso de mayúsculas y minúsculas adecuado.

Las expresiones regulares son más útiles al buscar y reemplazar texto que sigue un
patrón, en vez de texto que ya conoce. Para obtener más información, vea
Procedimiento para buscar cadenas. Con el patrón de búsqueda "the\s" se busca la
palabra "the" seguida de un carácter de espacio en blanco. Con esa parte del patrón se
asegura de que no se busca "there" en la cadena de origen. Para obtener más
información sobre los elementos de lenguaje de expresiones regulares, vea Lenguaje de
expresiones regulares - Referencia rápida.

C#

string source = "The mountains are still there behind the clouds today.";

// Use Regex.Replace for more flexibility.

// Replace "the" or "The" with "many" or "Many".

 // using System.Text.RegularExpressions

string replaceWith = "many ";

source = System.Text.RegularExpressions.Regex.Replace(source, "the\\s",

LocalReplaceMatchCase,

System.Text.RegularExpressions.RegexOptions.IgnoreCase);

Console.WriteLine(source);

string LocalReplaceMatchCase(System.Text.RegularExpressions.Match
matchExpression)

// Test whether the match is capitalized

if (Char.IsUpper(matchExpression.Value[0]))

// Capitalize the replacement string

System.Text.StringBuilder replacementBuilder = new

System.Text.StringBuilder(replaceWith);

replacementBuilder[0] = Char.ToUpper(replacementBuilder[0]);

return replacementBuilder.ToString();

else

return replaceWith;

Con el método StringBuilder.ToString se devuelve una cadena inmutable con el

contenido del objeto StringBuilder.

Modificación de caracteres individuales

Puede producir un matriz de caracteres a partir de una cadena, modificar el contenido
de la matriz y crear después una cadena a partir del contenido modificado de la matriz.

En el siguiente ejemplo se muestra cómo reemplazar un conjunto de caracteres en una

cadena. En primer lugar, se usa el método String.ToCharArray() para crear una matriz de
caracteres. Se usa el método IndexOf para encontrar el índice de inicio de la palabra
"fox". Los siguientes tres caracteres se reemplazan por otra palabra. Por último, se
construye una cadena nueva a partir de la matriz de carácter actualizada.

C#

string phrase = "The quick brown fox jumps over the fence";

Console.WriteLine(phrase);

char[] phraseAsChars = phrase.ToCharArray();

int animalIndex = phrase.IndexOf("fox");

if (animalIndex != -1)

phraseAsChars[animalIndex++] = 'c';

 phraseAsChars[animalIndex++] = 'a';

phraseAsChars[animalIndex] = 't';

string updatedPhrase = new string(phraseAsChars);

Console.WriteLine(updatedPhrase);

Creación mediante programación del

contenido de la cadena
Dado que las cadenas son inmutables, en los ejemplos anteriores se crean cadenas
temporales o matrices de caracteres. En escenarios de alto rendimiento, puede ser
conveniente evitar estas asignaciones de montón. .NET Core proporciona un método
String.Create que permite rellenar mediante programación el contenido de los
caracteres de una cadena a través de una devolución de llamada, a la vez que evita las
asignaciones de cadenas temporales intermedias.

C#

// constructing a string from a char array, prefix it with some additional

characters

char[] chars = { 'a', 'b', 'c', 'd', '\0' };

int length = chars.Length + 2;

string result = string.Create(length, chars, (Span<char> strContent, char[]

charArray) =>

strContent[0] = '0';

strContent[1] = '1';

for (int i = 0; i < charArray.Length; i++)

strContent[i + 2] = charArray[i];

});

Console.WriteLine(result);

Puede modificar una cadena en un bloque fijo con código no seguro, pero es
totalmente desaconsejable modificar el contenido de la cadena una vez que se ha
creado. Si lo hace, puede haber problemas imprevisibles. Por ejemplo, si alguien se
conecta a una cadena que tiene el mismo contenido que la suya, esa persona obtendrá
la copia de usted y no esperará que usted modifique la cadena.

Vea también
Expresiones regulares de .NET
Lenguaje de expresiones regulares: referencia rápida
Cómo comparar cadenas en C#
Artículo • 22/09/2022 • Tiempo de lectura: 11 minutos

Las cadenas se comparan para responder a una de estas dos preguntas: "¿Son estas dos
cadenas iguales?" o "¿En qué orden deben colocarse estas cadenas al ordenarlas?"

Esas dos preguntas se complican por factores que influyen en las comparaciones de
cadenas:

Puede elegir una comparación ordinal o lingüística.

Puede elegir si distingue entre mayúsculas y minúsculas.
Puede elegir comparaciones específicas de referencia cultural.
Las comparaciones lingüísticas dependen de la plataforma y la referencia cultural.

７ Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y

área de juegos de Try.NET . Haga clic en el botón Ejecutar para ejecutar un
ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede
modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El
código modificado se ejecuta en la ventana interactiva o, si se produce un error en
la compilación, en la ventana interactiva se muestran todos los mensajes de error
del compilador de C#.

Cuando se comparan cadenas, se define un orden entre ellas. Las comparaciones se

usan para ordenar una secuencia de cadenas. Una vez que la secuencia está en un orden
conocido, es más fácil hacer búsquedas, tanto para el software como para las personas.
Otras comparaciones pueden comprobar si las cadenas son iguales. Estas
comprobaciones de similitud son parecidas a la igualdad, pero pueden omitirse algunas
diferencias, como las diferencias entre mayúsculas y minúsculas.

Comparaciones de ordinales predeterminadas

De forma predeterminada, las operaciones más comunes:

String.Equals
String.Equality y String.Inequality; es decir, los operadores de igualdad== y !=,
respectivamente,
realizan una comparación de ordinales que distingue mayúsculas de minúsculas. En el
caso de String.Equals, se puede proporcionar un argumento StringComparison para
alterar sus reglas de ordenación. En el siguiente ejemplo se muestra que:

C#

string root = @"C:\users";

string root2 = @"C:\Users";

bool result = root.Equals(root2);

Console.WriteLine($"Ordinal comparison: <{root}> and <{root2}> are {(result
? "equal." : "not equal.")}");

result = root.Equals(root2, StringComparison.Ordinal);

Console.WriteLine($"Ordinal comparison: <{root}> and <{root2}> are {(result

? "equal." : "not equal.")}");

Console.WriteLine($"Using == says that <{root}> and <{root2}> are {(root ==

root2 ? "equal" : "not equal")}");

La comparación de ordinales predeterminada no tiene en cuenta reglas lingüísticas

cuando se comparan cadenas. Compara el valor binario de cada objeto Char en dos
cadenas. Como resultado, la comparación de ordinales predeterminada también
distingue mayúsculas de minúsculas.

La prueba de igualdad con String.Equals y los operadores == y != es diferente de la

comparación de cadenas que usa los métodos String.CompareTo y Compare(String,
String). Todas realizan una comparación que distingue mayúsculas de minúsculas. Sin
embargo, aunque las pruebas de igualdad realizan una comparación ordinal, los
métodos CompareTo y Compare realizan una comparación lingüística, que tiene en cuenta
la referencia cultural, mediante la referencia cultural actual. Puesto que estos métodos
de comparación predeterminados cambian en la forma en la que comparan cadenas, le
recomendamos que deje siempre clara la intención de su código llamando a una
sobrecarga que especifique el tipo de comparación que se realizará.

Comparaciones de ordinales sin distinción

entre mayúsculas y minúsculas
Con el método String.Equals(String, StringComparison) puede especificar un valor
StringComparison de StringComparison.OrdinalIgnoreCase para una comparación
ordinal que no distingue entre mayúsculas y minúsculas. También hay un método
String.Compare(String, String, StringComparison) estático que realiza una comparación
ordinal que distingue mayúsculas de minúsculas. Para usarlo, debe especificar un valor
de StringComparison.OrdinalIgnoreCase para el argumento StringComparison. Se
muestran en este código:

C#

string root = @"C:\users";

string root2 = @"C:\Users";

bool result = root.Equals(root2, StringComparison.OrdinalIgnoreCase);

bool areEqual = String.Equals(root, root2,

StringComparison.OrdinalIgnoreCase);

int comparison = String.Compare(root, root2, comparisonType:

StringComparison.OrdinalIgnoreCase);

Console.WriteLine($"Ordinal ignore case: <{root}> and <{root2}> are {(result

? "equal." : "not equal.")}");

Console.WriteLine($"Ordinal static ignore case: <{root}> and <{root2}> are

{(areEqual ? "equal." : "not equal.")}");

if (comparison < 0)

Console.WriteLine($"<{root}> is less than <{root2}>");

else if (comparison > 0)

Console.WriteLine($"<{root}> is greater than <{root2}>");

else

Console.WriteLine($"<{root}> and <{root2}> are equivalent in order");

Al realizar una comparación ordinal que distingue mayúsculas de minúsculas, estos

métodos usarán las convenciones de mayúsculas y minúsculas de la referencia cultural
invariable.

Comparaciones lingüísticas
También se pueden ordenar cadenas mediante reglas lingüísticas para la referencia
cultural actual.
A veces, esto se denomina “criterio de ordenación de palabras”. Cuando
se realiza una comparación lingüística, algunos caracteres Unicode no alfanuméricos
pueden tener asignados pesos especiales. Por ejemplo, el guion ("-") podría tener
asignado un peso pequeño, por lo que las cadenas "coop" y "co-op" aparecerían una
junto a la otra en una ordenación. Además, algunos caracteres Unicode pueden ser
equivalentes a una secuencia de instancias de Char. En el ejemplo siguiente se usa la
frase "Ellos bailan en la calle" en alemán. Usa "ss" (U+0073 U+0073) en una cadena y "ß"
(U+00DF) en otra. Lingüísticamente (en Windows), "ss" es igual que el carácter "ß" en
alemán en las referencias culturales "en-US" y "de-DE".

C#

string first = "Sie tanzen auf der Straße.";

string second = "Sie tanzen auf der Strasse.";

 Console.WriteLine($"First sentence is <{first}>");

Console.WriteLine($"Second sentence is <{second}>");

bool equal = String.Equals(first, second,

StringComparison.InvariantCulture);

Console.WriteLine($"The two strings {(equal == true ? "are" : "are not")}

equal.");

showComparison(first, second);

string word = "coop";

string words = "co-op";

string other = "cop";

showComparison(word, words);

showComparison(word, other);

showComparison(words, other);

void showComparison(string one, string two)

int compareLinguistic = String.Compare(one, two,

StringComparison.InvariantCulture);

int compareOrdinal = String.Compare(one, two, StringComparison.Ordinal);

if (compareLinguistic < 0)

Console.WriteLine($"<{one}> is less than <{two}> using invariant

culture");

else if (compareLinguistic > 0)

Console.WriteLine($"<{one}> is greater than <{two}> using invariant

culture");

else

Console.WriteLine($"<{one}> and <{two}> are equivalent in order

using invariant culture");

if (compareOrdinal < 0)

Console.WriteLine($"<{one}> is less than <{two}> using ordinal

comparison");

else if (compareOrdinal > 0)

Console.WriteLine($"<{one}> is greater than <{two}> using ordinal

comparison");

else

Console.WriteLine($"<{one}> and <{two}> are equivalent in order

using ordinal comparison");

En Windows, antes de .NET 5, el criterio de ordenación de "cop", "coop" y "co-op" varía

al cambiar de una comparación lingüística a una comparación ordinal. Las dos frases en
alemán también se comparan de manera diferente mediante tipos de comparación
diferentes.
Esto se debe a que, antes de .NET 5, las API de globalización de .NET usaban
bibliotecas de compatibilidad con idiomas nacionales (NLS). En .NET 5 y versiones
posteriores, las API de globalización de .NET usan componentes internacionales para
bibliotecas de Unicode (ICU) , que unifican el comportamiento de globalización de
NET en todos los sistemas operativos compatibles.
Comparaciones con referencias culturales
específicas
En esta muestra se almacenan los objetos CultureInfo de las referencias culturales en-US
y de-DE.
Las comparaciones se realizan con el objeto CultureInfo para garantizar una
comparación específica de la referencia cultural.

La referencia cultural usada afecta a las comparaciones lingüísticas. En este ejemplo se

muestra el resultado de comparar las dos frases en alemán usando la referencia cultural
"en-US" y la referencia cultural "de-DE":

C#

string first = "Sie tanzen auf der Straße.";

string second = "Sie tanzen auf der Strasse.";

Console.WriteLine($"First sentence is <{first}>");

Console.WriteLine($"Second sentence is <{second}>");

var en = new System.Globalization.CultureInfo("en-US");

// For culture-sensitive comparisons, use the String.Compare

// overload that takes a StringComparison value.

int i = String.Compare(first, second, en,

System.Globalization.CompareOptions.None);

Console.WriteLine($"Comparing in {en.Name} returns {i}.");

var de = new System.Globalization.CultureInfo("de-DE");

i = String.Compare(first, second, de,

System.Globalization.CompareOptions.None);

Console.WriteLine($"Comparing in {de.Name} returns {i}.");

bool b = String.Equals(first, second, StringComparison.CurrentCulture);

Console.WriteLine($"The two strings {(b ? "are" : "are not")} equal.");

string word = "coop";

string words = "co-op";

string other = "cop";

showComparison(word, words, en);

showComparison(word, other, en);

showComparison(words, other, en);

void showComparison(string one, string two, System.Globalization.CultureInfo
culture)

int compareLinguistic = String.Compare(one, two, en,

System.Globalization.CompareOptions.None);

int compareOrdinal = String.Compare(one, two, StringComparison.Ordinal);

if (compareLinguistic < 0)

Console.WriteLine($"<{one}> is less than <{two}> using en-US

culture");

 else if (compareLinguistic > 0)

Console.WriteLine($"<{one}> is greater than <{two}> using en-US

culture");

else

Console.WriteLine($"<{one}> and <{two}> are equivalent in order

using en-US culture");

if (compareOrdinal < 0)

Console.WriteLine($"<{one}> is less than <{two}> using ordinal

comparison");

else if (compareOrdinal > 0)

Console.WriteLine($"<{one}> is greater than <{two}> using ordinal

comparison");

else

Console.WriteLine($"<{one}> and <{two}> are equivalent in order

using ordinal comparison");

Las comparaciones dependientes de la referencia cultural se usan normalmente para

comparar y ordenar cadenas escritas por usuarios con otras cadenas escritas por
usuarios. Los caracteres y las convenciones de ordenación de estas cadenas pueden
variar según la configuración regional del equipo del usuario. Incluso las cadenas que
contienen caracteres idénticos podrían ordenarse de forma diferente en función de la
referencia cultural del subproceso actual.

Ordenación lingüística y búsqueda de cadenas

en matrices
En estos ejemplos se muestra cómo ordenar y buscar cadenas en una matriz mediante
una comparación lingüística que depende de la referencia cultural actual. Use los
métodos Array estáticos que toman un parámetro System.StringComparer.

En este ejemplo se muestra cómo ordenar una matriz de cadenas con la referencia
cultural actual:

C#

string[] lines = new string[]

@"c:\public\textfile.txt",

@"c:\public\textFile.TXT",

@"c:\public\Text.txt",

@"c:\public\testfile2.txt"

};

Console.WriteLine("Non-sorted order:");

foreach (string s in lines)

 Console.WriteLine($" {s}");

Console.WriteLine("\n\rSorted order:");

// Specify Ordinal to demonstrate the different behavior.

Array.Sort(lines, StringComparer.CurrentCulture);

foreach (string s in lines)

Console.WriteLine($" {s}");

Una vez que se ordena la matriz, puede buscar entradas mediante una búsqueda
binaria. Una búsqueda binaria empieza en medio de la colección para determinar qué
mitad de la colección debe contener la cadena buscada. Cada comparación posterior
divide la parte restante de la colección por la mitad. La matriz se ordena con el
elemento StringComparer.CurrentCulture. La función local ShowWhere muestra
información sobre dónde se encuentra la cadena. Si no se encuentra la cadena, el valor
devuelto indica dónde estaría si se encontrara.

C#

string[] lines = new string[]

@"c:\public\textfile.txt",

@"c:\public\textFile.TXT",

@"c:\public\Text.txt",

@"c:\public\testfile2.txt"

};

Array.Sort(lines, StringComparer.CurrentCulture);

string searchString = @"c:\public\TEXTFILE.TXT";

Console.WriteLine($"Binary search for <{searchString}>");

int result = Array.BinarySearch(lines, searchString,

StringComparer.CurrentCulture);

ShowWhere<string>(lines, result);

Console.WriteLine($"{(result > 0 ? "Found" : "Did not find")}

{searchString}");

void ShowWhere<T>(T[] array, int index)

if (index < 0)

index = ~index;

Console.Write("Not found. Sorts between: ");

if (index == 0)
Console.Write("beginning of sequence and ");

 else

Console.Write($"{array[index - 1]} and ");

if (index == array.Length)

Console.WriteLine("end of sequence.");

else

Console.WriteLine($"{array[index]}.");

else

Console.WriteLine($"Found at index {index}.");

Ordenación de ordinales y búsqueda en

colecciones
Este código usa la clase de colección System.Collections.Generic.List<T> para almacenar
cadenas. Las cadenas se ordenan mediante el método List<T>.Sort. Este método
necesita un delegado que compare y ordene dos cadenas. El método String.CompareTo
proporciona esa función de comparación. Ejecute el ejemplo y observe el orden. Esta
operación de ordenación usa una ordenación ordinal con distinción entre mayúsculas y
minúsculas. Tendría que usar los métodos estáticos String.Compare para especificar
reglas de comparación distintas.

C#

List<string> lines = new List<string>

@"c:\public\textfile.txt",

@"c:\public\textFile.TXT",

@"c:\public\Text.txt",

@"c:\public\testfile2.txt"

};

Console.WriteLine("Non-sorted order:");

foreach (string s in lines)

Console.WriteLine($" {s}");

Console.WriteLine("\n\rSorted order:");

lines.Sort((left, right) => left.CompareTo(right));

foreach (string s in lines)

Console.WriteLine($" {s}");

Una vez realizada la ordenación, se pueden hacer búsquedas en la lista de cadenas

mediante una búsqueda binaria. En el ejemplo siguiente se muestra cómo buscar en la
lista ordenada con la misma función de comparación. La función local ShowWhere
muestra dónde está o debería estar el texto buscado:

C#

List<string> lines = new List<string>

@"c:\public\textfile.txt",

@"c:\public\textFile.TXT",

@"c:\public\Text.txt",

@"c:\public\testfile2.txt"

};

lines.Sort((left, right) => left.CompareTo(right));

string searchString = @"c:\public\TEXTFILE.TXT";

Console.WriteLine($"Binary search for <{searchString}>");

int result = lines.BinarySearch(searchString);

ShowWhere<string>(lines, result);

Console.WriteLine($"{(result > 0 ? "Found" : "Did not find")}

{searchString}");

void ShowWhere<T>(IList<T> collection, int index)

if (index < 0)

index = ~index;

Console.Write("Not found. Sorts between: ");

if (index == 0)
Console.Write("beginning of sequence and ");

else

Console.Write($"{collection[index - 1]} and ");

if (index == collection.Count)

Console.WriteLine("end of sequence.");

else

Console.WriteLine($"{collection[index]}.");

else

Console.WriteLine($"Found at index {index}.");

Asegúrese siempre de usar el mismo tipo de comparación para la ordenación y la

búsqueda. Si se usan distintos tipos de comparación para la ordenación y la búsqueda
se producen resultados inesperados.
Las clases de colección como System.Collections.Hashtable,
System.Collections.Generic.Dictionary<TKey,TValue> y
System.Collections.Generic.List<T> tienen constructores que toman un parámetro
System.StringComparer cuando el tipo de los elementos o claves es string . En general,
debe usar estos constructores siempre que sea posible y especificar
StringComparer.Ordinal u StringComparer.OrdinalIgnoreCase.

Igualdad de referencia e internamiento de

cadena
Ninguno de los ejemplos ha usado ReferenceEquals. Este método determina si dos
cadenas son el mismo objeto, lo que puede provocar resultados incoherentes en las
comparaciones de cadenas. En este ejemplo se muestra la característica de
internamiento de cadenas de C#. Cuando un programa declara dos o más variables de
cadena idénticas, el compilador lo almacena todo en la misma ubicación. Mediante una
llamada al método ReferenceEquals, puede ver que las dos cadenas realmente hacen
referencia al mismo objeto en memoria. Use el método String.Copy para evitar el
internamiento. Después de hacer la copia, las dos cadenas tienen diferentes ubicaciones
de almacenamiento, aunque tengan el mismo valor. Ejecute este ejemplo para mostrar
que las cadenas a y b son internadas, lo que significa que comparten el mismo
almacenamiento. Las cadenas a y c no lo son.

C#

string a = "The computer ate my source code.";

string b = "The computer ate my source code.";

if (String.ReferenceEquals(a, b))
Console.WriteLine("a and b are interned.");

else

Console.WriteLine("a and b are not interned.");

string c = String.Copy(a);

if (String.ReferenceEquals(a, c))
Console.WriteLine("a and c are interned.");

else

Console.WriteLine("a and c are not interned.");

７ Nota

Cuando se prueba la igualdad de cadenas, debe usar los métodos que especifican
explícitamente el tipo de comparación que va a realizar. El código se vuelve mucho
 más legible y fácil de mantener. Use sobrecargas de los métodos de las clases
System.String y System.Array que toman un parámetro de enumeración
StringComparison. Especifique qué tipo de comparación se va a realizar. Evite usar
los operadores == y != cuando pruebe la igualdad. Los métodos de instancia
String.CompareTo siempre realizan una comparación ordinal con distinción entre
mayúsculas y minúsculas. Son adecuados principalmente para ordenar
alfabéticamente las cadenas.

Puede internalizar una cadena o recuperar una referencia a una cadena internalizada
existente llamando al método String.Intern. Para determinar si una cadena se aplica el
método Intern, llame al método String.IsInterned.

Vea también
System.Globalization.CultureInfo
System.StringComparer
Cadenas
Comparación de cadenas
Globalizar y localizar aplicaciones
Procedimiento para detectar
excepciones no compatibles con CLS
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Algunos lenguajes. NET, incluido C++/CLI, permiten que los objetos inicien excepciones
que no se derivan de Exception. Dichas excepciones se denominan excepciones de no
compatibilidad con CLS o no excepciones. En C# no se pueden producir excepciones de
no compatibilidad con CLS, pero se pueden detectar de dos formas:

Dentro de un bloque catch (RuntimeWrappedException e) .

De forma predeterminada, un ensamblado de Visual C# detecta las excepciones de

no compatibilidad con CLS como excepciones ajustadas. Use este método si
necesita tener acceso a la excepción original, a la que se puede tener acceso a
través de la propiedad RuntimeWrappedException.WrappedException. El
procedimiento mostrado más adelante en este tema explica cómo detectar las
excepciones de esta manera.

Dentro de un bloque catch general (un bloque catch sin un tipo de excepción
especificado) que se coloca detrás de todos los demás bloques catch .

Use este método cuando quiera realizar alguna acción (como escribir en un
archivo de registro) en respuesta a las excepciones de no compatibilidad con CLS y
no necesita tener acceso a la información de excepción. De forma predeterminada,
el Common Language Runtime ajusta todas las excepciones. Para deshabilitar este
comportamiento, agregue este atributo de nivel de ensamblado en el código,
normalmente en el archivo AssemblyInfo.cs: [assembly:
RuntimeCompatibilityAttribute(WrapNonExceptionThrows = false)] .

Para detectar una excepción de no compatibilidad con

CLS
Dentro de un bloque catch(RuntimeWrappedException e) , se accede a la excepción
original mediante la propiedad RuntimeWrappedException.WrappedException.

Ejemplo
En el ejemplo siguiente se muestra cómo detectar una excepción de no compatibilidad
con CLS iniciada desde una biblioteca de clases escrita en C++/CLI. Tenga en cuenta que
en este ejemplo, el código de cliente de C# conoce por adelantado que el tipo de
excepción que se inicia es System.String. Puede convertir la propiedad
RuntimeWrappedException.WrappedException de vuelta a su tipo original siempre que
el tipo sea accesible desde su código.

C#

// Class library written in C++/CLI.

var myClass = new ThrowNonCLS.Class1();

try

// throws gcnew System::String(

// "I do not derive from System.Exception!");

myClass.TestThrow();

catch (RuntimeWrappedException e)
{

String s = e.WrappedException as String;

if (s != null)

Console.WriteLine(s);

Consulte también
RuntimeWrappedException
Excepciones y control de excepciones
SDK de .NET Compiler Platform
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

Los compiladores crean un modelo detallado de código de aplicación a medida que

validan la sintaxis y semántica de ese código. Utilizan este modelo para generar la salida
ejecutable desde el código fuente. El SDK de .NET Compiler Platform proporciona
acceso a este modelo. Cada vez confiamos más en las características del entorno de
desarrollo integrado (IDE), como IntelliSense, la refactorización, el cambio de nombre
inteligente, "Buscar todas las referencias" e "Ir a definición" para aumentar la
productividad. Nos basamos en herramientas de análisis de código para mejorar la
calidad de nuestro código y en generadores de código para ayudar en la construcción
de la aplicación. A medida que la inteligencia de estas herramientas aumenta, cada vez
necesitan más acceso del modelo que solo los compiladores crean cuando procesan el
código de la aplicación. Es la misión principal de las API de Roslyn: abrir las cajas negras
y permitir que herramientas y usuarios finales compartan la gran cantidad de
información que los compiladores tienen sobre el código.
En lugar de actuar como
traductores opacos de código fuente de entrada en código objeto de salida, con Roslyn,
los compiladores se convierten en plataformas: API que puede usar para tareas
relacionadas con el código en las herramientas y aplicaciones.

Conceptos del SDK de .NET Compiler Platform

El SDK de .NET Compiler Platform reduce notablemente la barrera de entrada para crear
herramientas y aplicaciones centradas en código. Crea numerosas oportunidades para la
innovación en áreas como la metaprogramación, la generación y la transformación de
código, el uso interactivo de los lenguajes C# y Visual Basic, y la inserción de C# y
Visual Basic en lenguajes específicos del dominio.

El SDK de .NET Compiler Platform le permite crear analizadores y correcciones de

código que buscan y corrigen errores de codificación. Los analizadores comprenden la
sintaxis (estructura del código) y la semántica, y detectan las prácticas que se deben
corregir. Las correcciones de código sugieren una o varias correcciones para tratar los
errores de codificación que encuentran los analizadores o los diagnósticos del
compilador. Por lo general, un analizador y las correcciones de código asociadas se
empaquetan conjuntamente en un solo proyecto.

Los analizadores y las correcciones de código usan el análisis estático para comprender
el código. No ejecutan el código o proporcionan otras ventajas de pruebas. Sin
embargo, pueden señalar prácticas que suelen dar lugar a errores, código que no se
puede mantener o validación de guías estándar.
Además de los analizadores y las correcciones de código, el SDK de
.NET Compiler Platform también le permite compilar refactorizaciones de código.
También proporciona un único conjunto de API que le permite examinar y entender un
código base de C# o Visual Basic. Dado que puede usar este código base único, puede
escribir analizadores y correcciones de código más fácilmente aprovechando las API de
análisis sintáctico y semántico que proporciona el SDK de .NET Compiler Platform. Una
vez liberado de la ardua tarea de replicar el análisis realizado por el compilador, puede
concentrarse en la tarea más específica de encontrar y corregir errores de codificación
comunes para el proyecto o la biblioteca.

Una ventaja menor es que los analizadores y las correcciones de código son más
pequeños y usan muchos menos memoria cuando se cargan en Visual Studio que si
escribiera su propio código base para entender el código de un proyecto.
Aprovechando las mismas clases que usa el compilador y Visual Studio, puede crear sus
propias herramientas de análisis estático. Esto significa que el equipo puede usar los
analizadores y las correcciones de código sin un impacto perceptible en el rendimiento
del IDE.

Hay tres escenarios principales para escribir analizadores y correcciones de código:

1. Aplicar estándares de codificación de equipo

2. Proporcionar instrucciones con paquetes de biblioteca
3. Suministro de una guía general

Aplicación de estándares de codificación de

equipo
Muchos equipos tienen estándares de codificación que se aplican a través de revisiones
del código con otros miembros del equipo. Los analizadores y las correcciones de
código pueden hacer este proceso mucho más eficiente. Las revisiones de código se
producen cuando un desarrollador comparte su trabajo con otros usuarios en el equipo.
Dicho desarrollador habrá invertido todo el tiempo necesario para completar una nueva
característica antes de obtener los comentarios. Pueden pasar semanas mientras que
refuerza los hábitos que no coinciden con las prácticas del equipo.

Los analizadores se ejecutan a medida que un desarrollador escribe código. Obtiene

comentarios al instante que animan a seguir la guía de inmediato. Crea hábitos para
escribir código compatible tan pronto como comienza la creación de prototipos.
Cuando la característica está lista para que las personas la revisen, se habrá aplicado
toda la guía estándar.
Los equipos pueden crear analizadores y correcciones de código que busquen las
prácticas más comunes que infringen las prácticas de codificación del equipo. Se
pueden instalar en el equipo del desarrollador para aplicar los estándares.

 Sugerencia

Antes de compilar su propio analizador, consulte los integrados. Para obtener más
información, vea Reglas de estilo del código.

Suministro de instrucciones con paquetes de

biblioteca
Hay una gran cantidad de bibliotecas disponibles para los desarrolladores de .NET en
NuGet.
Algunos de ellas proceden de Microsoft, algunas de compañías de terceros y
otras de voluntarios y miembros de la comunidad. Estas bibliotecas consiguen más
adopción y revisiones superiores cuando los desarrolladores pueden tener éxito con
ellas.

Además de proporcionar documentación, puede proporcionar analizadores y

correcciones de código que busquen y corrijan los usos incorrectos habituales de la
biblioteca. Estas correcciones inmediatas ayudarán a los desarrolladores a tener éxito
más rápidamente.

Puede empaquetar los analizadores y las correcciones de código con la biblioteca en

NuGet. En ese escenario, todos los desarrolladores que instalan el paquete de NuGet
también instalarán el paquete de analizador. Todos los programadores que utilicen la
biblioteca obtendrán instrucciones de su equipo al instante en forma de comentarios
inmediatos sobre errores y correcciones sugeridas.

Suministro de una guía general

La comunidad de desarrolladores de .NET ha detectado patrones de experiencia que
funcionan bien y patrones que es mejor evitar. Varios miembros de la comunidad han
creado analizadores que aplican esos patrones recomendados. A medida que
aprendemos más, siempre hay espacio para nuevas ideas.

Estos analizadores se puedan cargar en Visual Studio Marketplace y los

desarrolladores los pueden descargar mediante Visual Studio. Los recién llegados al
lenguaje y a la plataforma aprenden rápidamente las prácticas aceptadas y consiguen
ser productivos antes en su recorrido por .NET. A medida que su uso se amplía, la
comunidad adopta estas prácticas.

Pasos siguientes
El SDK de .NET Compiler Platform incluye los modelos de objetos de idioma más
recientes para generación de código, análisis y refactorización. Esta sección proporciona
información general conceptual del SDK de .NET Compiler Platform. Encontrará más
detalles en las secciones de guías de inicio rápido, ejemplos y tutoriales.

Puede obtener más información sobre los conceptos del SDK de .NET Compiler Platform
en estos cinco temas:

Exploración de código con el visualizador de sintaxis

Entender el modelo de API de compilador
Trabajar con sintaxis
Trabajar con semántica
Trabajar con un área de trabajo

Para empezar, debe instalar el SDK de .NET Compiler Platform:

Instrucciones de instalación: Instalador de

Visual Studio
Hay dos maneras distintas de buscar el SDK de .NET Compiler Platform en el Instalador
de Visual Studio:

Instalación con el Instalador de Visual Studio:

visualización de cargas de trabajo
El SDK de .NET Compiler Platform no se selecciona automáticamente como parte de la
carga de trabajo de desarrollo de extensiones de Visual Studio. Se debe seleccionar
como un componente opcional.

1. Ejecute el Instalador de Visual Studio.

2. Selección de Modificar
3. Active la carga de trabajo Desarrollo de extensiones de Visual Studio.
4. Abra el nodo Desarrollo de extensiones de Visual Studio en el árbol de resumen.
5. Active la casilla SDK de .NET Compiler Platform. La encontrará en última posición
bajo los componentes opcionales.
Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el
visualizador:

1. Abra el nodo Componentes individuales en el árbol de resumen.

2. Active la casilla Editor de DGML.

Instalación con el Instalador de Visual Studio: pestaña

Componentes individuales
1. Ejecute el Instalador de Visual Studio.
2. Selección de Modificar
3. Haga clic en la pestaña Componentes individuales.
4. Active la casilla SDK de .NET Compiler Platform. La encontrará en la parte superior
bajo la sección Compiladores, herramientas de compilación y tiempos de
ejecución.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Active la casilla Editor de DGML. La encontrará en la sección Herramientas de

código.
Descripción del modelo del SDK de .NET
Compiler Platform
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Los compiladores procesan el código que se escribe conforme a reglas estructuradas

que a menudo se diferencian de la forma en que los seres humanos lo leen y lo
entienden. Una comprensión básica del modelo usado por los compiladores resulta
fundamental para entender las API que se usan al compilar herramientas basadas en
Roslyn.

Áreas funcionales de canalización de

compilador
El SDK de .NET Compiler Platform expone el análisis de código de los compiladores de
C# y Visual Basic al proporcionar una capa de API que refleja una canalización de
compilador tradicional.

Cada fase de esta canalización es un componente independiente. En primer lugar, la

fase de análisis acorta y analiza el texto de origen en la sintaxis que sigue la gramática
del lenguaje. En segundo lugar, la fase de declaración analiza los metadatos importados
y de origen para formar símbolos con nombre. Luego, la fase de enlace combina los
identificadores del código con los símbolos. Por último, en la fase de emisión se emite
un ensamblado con toda la información generada por el compilador.
En correspondencia a cada una de esas fases, el SDK de .NET Compiler Platform expone
un modelo de objetos que permite el acceso a la información en esa fase. La fase de
análisis expone un árbol de sintaxis, la fase de declaración expone una tabla de símbolos
jerárquica, la fase de enlace expone el resultado del análisis semántico del compilador y
la fase de emisión es una API que genera códigos de bytes de IL.

Cada compilador combina estos componentes como un único todo.

Estas API son las mismas que usa Visual Studio. Por ejemplo, las características de
formato y esquema del código usan los árboles de sintaxis, las características de
navegación y el Examinador de objetos usan la tabla de símbolos, las refactorizaciones
e Ir a definición usan el modelo semántico, y Editar y continuar usa todos ellos, incluida
la API de emisión.

Capas de API
El SDK del compilador de .NET consta de varias capas de API: de compilador, de
diagnóstico, de scripting y de área de trabajo.

API de compilador
La capa de compilador contiene los modelos de objetos que corresponden con la
información expuesta en cada fase de la canalización de compilador, sintáctica y
semántica. La capa de compilador también contiene una instantánea inmutable de una
sola invocación de un compilador, incluidas las referencias de ensamblado, las opciones
del compilador y los archivos de código fuente. Hay dos API distintas que representan el
lenguaje C# y el lenguaje Visual Basic. Las dos API son similares en forma, aunque están
adaptadas para lograr una alta fidelidad con cada lenguaje. Esta capa no tiene
dependencias en componentes de Visual Studio.

API de diagnóstico
Como parte de su análisis, el compilador puede generar un conjunto de diagnósticos
que abarcan desde errores de sintaxis, semántica y asignación definitiva hasta distintas
advertencias y diagnósticos informativos. La capa de la API de compilador expone
diagnósticos a través de una API extensible que permite incluir analizadores definidos
por el usuario en el proceso de compilación. Permite generar diagnósticos definidos por
el usuario, como los de herramientas como StyleCop, junto con diagnósticos definidos
por el compilador. La generación de diagnósticos de este modo tiene la ventaja de
integrarse de forma natural con herramientas como MSBuild y Visual Studio, que
dependen de diagnósticos de experiencias como detener una compilación según una
directiva y mostrar subrayados ondulados activos en el editor y sugerir correcciones de
código.

API de scripting
Las API de hospedaje y scripting forman parte de la capa de compilador. Puede usarlas
para ejecutar fragmentos de código y acumular un contexto de ejecución en tiempo de
ejecución.
El REPL (bucle de lectura, evaluación e impresión) interactivo de C# usa estas
API. El REPL permite usar C# como lenguaje de scripting, al ejecutar el código de forma
interactiva mientras se escribe.

API de áreas de trabajo

La capa de áreas de trabajo contiene la API de área de trabajo, que es el punto de
partida para realizar análisis de código y refactorización de soluciones completas. Ayuda
a organizar toda la información sobre los proyectos de una solución en un modelo de
objetos único, lo que ofrece acceso directo a los modelos de objetos de capa de
compilador sin necesidad de analizar archivos, configurar opciones ni administrar
dependencias entre proyectos.

Además, la capa de áreas de trabajo expone un conjunto de API que se usa al

implementar las herramientas de análisis de código y refactorización que funcionan en
un entorno de host como el IDE de Visual Studio. Los ejemplos incluyen las API Buscar
todas las referencias, Formato y Generación de código.

Esta capa no tiene dependencias en componentes de Visual Studio.

Trabajar con sintaxis
Artículo • 15/02/2023 • Tiempo de lectura: 8 minutos

El árbol de sintaxis es una estructura de datos fundamental e inmutable expuesta por las
API del compilador. Estos árboles representan la estructura léxica y sintáctica del código
fuente. Tienen dos importantes finalidades:

Permitir herramientas, como un IDE, complementos, herramientas de análisis de

código y refactorizaciones, y ver y procesar la estructura sintáctica del código
fuente del proyecto de un usuario.
Habilitar herramientas, como refactorizaciones y un IDE, para crear, modificar y
reorganizar el código fuente de forma natural sin tener que usar ediciones de texto
directas. Al crear y manipular árboles, las herramientas pueden crear y reorganizar
fácilmente el código fuente.

Árboles de sintaxis
Los árboles de sintaxis son la estructura principal usada para la compilación, el análisis
de código, los enlaces, la refactorización, las características de IDE y la generación de
código. Ninguna parte del código fuente se entiende sin que primero se haya
identificado y clasificado en alguno de los elementos de lenguaje estructural conocidos.

Los árboles de sintaxis tienen tres atributos clave:

Contienen toda la información de origen con fidelidad completa. Esto significa que
el árbol de sintaxis contiene cada fragmento de información del texto de origen,
cada construcción gramatical, cada token léxico y todo lo demás, incluidos los
espacios en blanco, los comentarios y las directivas de preprocesador. Por ejemplo,
cada literal mencionado en el origen se representa exactamente como se ha
escrito. Los árboles de sintaxis también capturan los errores del código fuente
cuando el programa está incompleto o tiene un formato incorrecto mediante la
representación de los tokens omitidos o que faltan.
Pueden generar el texto exacto mediante el que se analizaron. Es posible obtener
la representación de texto del subárbol cuya raíz está en ese nodo desde cualquier
nodo de sintaxis. Esta posibilidad significa que los árboles de sintaxis se pueden
usar como una manera de crear y editar texto de origen. Al crear un árbol, de
manera implícita, ha creado el texto equivalente, mientras que, al crear uno a partir
de los cambios en uno existente, ha editado realmente el texto.
Son inmutables y seguros para subprocesos. Una vez obtenido un árbol, es una
instantánea del estado actual del código y nunca cambia. Esto permite que varios
 usuarios interactúen con el mismo árbol de sintaxis a la vez en distintos
subprocesos sin que se produzca ningún bloqueo ni duplicación. Dado que los
árboles son inmutables y no permiten ninguna modificación directa, los métodos
de fábrica ayudan a crear y modificar los árboles de sintaxis mediante la creación
de instantáneas adicionales del árbol. Los árboles son eficaces en su forma de
volver a usar nodos subyacentes, así que es posible volver a crear una nueva
versión rápidamente y con poca memoria adicional.

Un árbol de sintaxis es literalmente una estructura de datos de árbol donde los

elementos estructurales no terminales son primarios con respecto a otros elementos.
Cada árbol de sintaxis se compone de nodos, tokens y curiosidades.

Nodos de sintaxis
Los nodos de sintaxis son uno de los elementos principales de los árboles de sintaxis.
Estos nodos representan construcciones sintácticas como declaraciones, instrucciones,
cláusulas y expresiones. Cada categoría de nodos de sintaxis se representa mediante
una clase independiente derivada de Microsoft.CodeAnalysis.SyntaxNode. El conjunto
de clases de nodos no es extensible.

Todos los nodos de sintaxis son nodos no terminales del árbol de sintaxis, lo que
significa que siempre tienen otros nodos y tokens como elementos secundarios. Como
elemento secundario de otro nodo, cada nodo tiene un nodo principal al que se puede
acceder mediante la propiedad SyntaxNode.Parent. Dado que los nodos y los árboles
son inmutables, el elemento principal de un nodo nunca cambia. La raíz del árbol tiene
un elemento principal nulo.

Cada nodo tiene un método SyntaxNode.ChildNodes() que devuelve una lista de nodos
secundarios en orden secuencial según su posición en el texto de origen. Esta lista no
contiene tokens. Cada nodo también tiene métodos para examinar descendientes, como
DescendantNodes, DescendantTokens o DescendantTrivia, que representan una lista de
todos los nodos, tokens o curiosidades que existen en el subárbol cuya raíz está en ese
nodo.

Además, cada subclase de nodos de sintaxis expone los mismos elementos secundarios
mediante propiedades fuertemente tipadas. Por ejemplo, una clase de nodos
BinaryExpressionSyntax tiene tres propiedades adicionales específicas de los operadores
binarios: Left, OperatorToken y Right. El tipo de Left y Right es ExpressionSyntax, y el
tipo de OperatorToken es SyntaxToken.

Algunos nodos de sintaxis tienen elementos secundarios opcionales. Por ejemplo,

IfStatementSyntax tiene un elemento opcional ElseClauseSyntax. Si el elemento
secundario no está presente, la propiedad devuelve null.

Tokens de sintaxis
Los tokens de sintaxis son los terminales de la gramática del lenguaje y representan los
fragmentos sintácticos más pequeños del código. Nunca son elementos principales de
otros nodos o tokens. Los tokens de sintaxis constan de palabras clave, identificadores,
literales y signos de puntuación.

Por eficacia, el tipo SyntaxToken es un tipo de valor CLR. Por tanto, a diferencia de los
nodos de sintaxis, solo hay una estructura para todos los tipos de tokens con una
mezcla de propiedades que tienen significado según el tipo de token que se va a
representar.

Por ejemplo, un token de literal entero representa un valor numérico. Además del texto
de origen sin formato que abarca el token, el token de literal tiene una propiedad Value
que indica el valor entero descodificado exacto. El tipo de esta propiedad se considera
Object, ya que puede ser alguno de los tipos primitivos.

La propiedad ValueText transmite la misma información que la propiedad Value; pero el

tipo de esta propiedad siempre es String. Un identificador en el texto de origen C#
puede incluir caracteres de escape Unicode, aunque la sintaxis de la propia secuencia de
escape no se considera parte del nombre del identificador. Por tanto, aunque el texto
sin formato que abarca el token incluye la secuencia de escape, la propiedad ValueText
no. En su lugar, incluye los caracteres Unicode que identifica el escape. Por ejemplo, si el
texto de origen contiene un identificador escrito como \u03C0 , la propiedad ValueText
de este token devuelve π .

Curiosidades de sintaxis
Las curiosidades de sintaxis representan las partes del texto de origen que no son
realmente significativas para la correcta comprensión del código, como los espacios en
blanco, los comentarios y las directivas de preprocesador. Al igual que los tokens de
sintaxis, las curiosidades son tipos de valor. Se usa el tipo único
Microsoft.CodeAnalysis.SyntaxTrivia para describir todos los tipos de curiosidades.

Dado que las curiosidades no forman parte de la sintaxis normal del lenguaje y pueden
aparecer en cualquier lugar entre dos tokens, no se incluyen en el árbol de sintaxis
como elemento secundario de un nodo. Pero dado que son importantes a la hora de
implementar una característica como la refactorización y de mantener la plena fidelidad
con el texto de origen, existen como parte del árbol de sintaxis.
Puede acceder a las curiosidades si inspecciona las colecciones
SyntaxToken.LeadingTrivia o SyntaxToken.TrailingTrivia de un token. Cuando se analiza el
texto de origen, las secuencias de curiosidades se asocian a los tokens. En general, un
token es propietario de cualquier curiosidad que le preceda en la misma línea hasta el
siguiente token. Cualquier curiosidad situada después de esa línea se asocia al token
siguiente. El primer token del archivo de origen obtiene todas las curiosidades iniciales,
mientras que la última secuencia de curiosidades del archivo se agrega al último token
del archivo, que, de lo contrario, tiene ancho de cero.

A diferencia de los nodos y los tokens de sintaxis, las curiosidades de sintaxis no tienen
elementos principales. Pero, dado que forman parte del árbol y cada una está asociada a
un token único, se puede acceder al token con el que está asociada mediante la
propiedad SyntaxTrivia.Token.

Intervalos
Cada nodo, token o curiosidad conoce su posición dentro del texto de origen y el
número de caracteres del que se compone. Una posición de texto se representa como
un entero de 32 bits, que es un índice char de base cero. Un objeto TextSpan es la
posición inicial y un recuento de caracteres, ambos representados como enteros. Si
TextSpan tiene una longitud cero, hace referencia a una ubicación entre dos caracteres.

Cada nodo tiene dos propiedades TextSpan: Span y FullSpan.

La propiedad Span es el intervalo de texto desde el principio del primer token del
subárbol del nodo al final del último token. Este intervalo no incluye ninguna curiosidad
inicial ni final.

La propiedad FullSpan es el intervalo de texto que incluye el intervalo normal del nodo,
así como el intervalo de cualquier curiosidad inicial o final.

Por ejemplo:

C#

if (x > 3)

|| // this is bad

|throw new Exception("Not right.");| // better exception?||

El nodo de la instrucción dentro del bloque tiene un intervalo indicado por las plecas (|).
Incluye los caracteres throw new Exception("Not right."); . Las plecas dobles (||) indican
el intervalo completo. Incluye los mismos caracteres que el intervalo y los caracteres
asociados a las curiosidades inicial y final.

Tipos
Cada nodo, token o curiosidad tiene una propiedad SyntaxNode.RawKind, de tipo
System.Int32, que identifica el elemento de sintaxis exacto representado. Este valor se
puede convertir en una enumeración específica del lenguaje. Cada lenguaje, C# o Visual
Basic, tiene una sola enumeración SyntaxKind
(Microsoft.CodeAnalysis.CSharp.SyntaxKind y
Microsoft.CodeAnalysis.VisualBasic.SyntaxKind, respectivamente) que enumera todos los
posibles nodos, tokens y curiosidades de la gramática. Dicha conversión se puede
realizar automáticamente. Para ello, es necesario acceder a los métodos de extensión
CSharpExtensions.Kind o VisualBasicExtensions.Kind.

La propiedad RawKind permite anular fácilmente la ambigüedad de los tipos de nodos

de sintaxis que comparten la misma clase de nodos. En el caso de los tokens y las
curiosidades, esta propiedad es la única manera de distinguir un tipo de elemento de
otro.

Por ejemplo, una sola clase BinaryExpressionSyntax tiene Left, OperatorToken y Right
como elementos secundarios. La propiedad Kind distingue si es un tipo AddExpression,
SubtractExpression o MultiplyExpression de nodo de sintaxis.

 Sugerencia

Se recomienda comprobar los tipos con los métodos de extensión IsKind (para C#)
o IsKind (para VB).

Errores
Aunque el texto de origen contenga errores de sintaxis, se expone un árbol de sintaxis
completo con recorrido de ida y vuelta al origen. Si el analizador detecta código que no
se ajusta a la sintaxis definida del lenguaje, usa una de estas dos técnicas para crear un
árbol de sintaxis.

Si el analizador espera un determinado tipo de token, pero no lo encuentra, puede

insertar un token que falta en el árbol de sintaxis en la ubicación esperada del
token. Un token que falta representa el token real esperado, aunque tiene un
intervalo vacío y su propiedad SyntaxNode.IsMissing devuelve true .
El analizador puede omitir tokens hasta encontrar uno en el que pueda seguir
analizando. En este caso, los tokens omitidos se adjuntan como un nodo de
curiosidades con el tipo SkippedTokensTrivia.
Trabajar con semántica
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Los árboles de sintaxis representan la estructura léxica y sintáctica del código fuente.
Aunque esta información por sí misma basta para describir todas las declaraciones y la
lógica del origen, no es suficiente para identificar aquello a lo que se hace referencia. Un
nombre puede representar:

un tipo
un campo
un método
una variable local

Aunque cada uno de ellos es exclusivamente diferente, determinar a cuál hace

referencia realmente un identificador suele exigir una comprensión profunda de las
reglas del lenguaje.

Hay elementos de programa representados en el código fuente y, además, los

programas pueden hacer referencia a bibliotecas compiladas anteriormente,
empaquetadas en archivos de ensamblado. Aunque no hay ningún código fuente y, por
tanto, ningún nodo ni árbol de sintaxis, disponible para los ensamblados, los programas
aún pueden hacer referencia a los elementos incluidos en ellos.

Para esas tareas necesita el modelo semántico.

Además de un modelo sintáctico del código fuente, un modelo semántico encapsula las
reglas del lenguaje, lo que le ofrece una manera sencilla de combinar correctamente los
identificadores con el elemento de programa correcto al que se hace referencia.

Compilación
Una compilación es una representación de todo lo necesario para compilar un
programa de C# o Visual Basic, lo que incluye todas las referencias de ensamblado, las
opciones de compilador y los archivos de origen.

Dado que toda esta información está en un solo lugar, los elementos incluidos en el
código fuente pueden describirse con más detalle. La compilación representa cada tipo
declarado, miembro o variable como un símbolo. La compilación contiene una serie de
métodos que ayudan a encontrar y relacionar los símbolos que se han declarado en el
código fuente o importado como metadatos desde un ensamblado.
Al igual que los árboles de sintaxis, las compilaciones son inmutables. Después de crear
una compilación, ni el usuario ni nadie con quien la comparta puede modificarla. Pero
puede crear una nueva compilación a partir de una existente, al especificar un cambio a
medida que lo realiza. Por ejemplo, podría crear una compilación igual en todos los
sentidos a una compilación existente, salvo que podría incluir un archivo de origen
adicional o una referencia de ensamblado.

Símbolos
Un símbolo representa un elemento diferenciado declarado por el código fuente o
importado desde un ensamblado como metadatos. Cada espacio de nombres, tipo,
método, propiedad, campo, evento, parámetro o variable local se representa mediante
un símbolo.

Una serie de métodos y propiedades del tipo Compilation ayudan a encontrar símbolos.
Por ejemplo, puede buscar el símbolo de un tipo declarado por su nombre de
metadatos común. También puede acceder a la tabla de símbolos completa como un
árbol de símbolos enraizado por el espacio de nombres global.

Los símbolos también contienen información adicional que el compilador determina

desde el origen o los metadatos, como otros símbolos referenciados. Cada tipo de
símbolo se representa mediante una interfaz independiente derivada de ISymbol, cada
una con sus propios métodos y propiedades que detallan la información recopilada por
el compilador. Muchas de estas propiedades hacen referencia directamente a otros
símbolos. Por ejemplo, la propiedad IMethodSymbol.ReturnType indica el símbolo de
tipo real que devuelve el método.

Los símbolos presentan una representación común de espacios de nombres, tipos y

miembros, entre el código fuente y los metadatos. Por ejemplo, un método que se ha
declarado en el código fuente y un método que se ha importado desde los metadatos
se representan mediante un elemento IMethodSymbol con las mismas propiedades.

Los símbolos son similares en concepto al sistema de tipos de CLR representado por la
API System.Reflection, aunque son mejores en el aspecto de que modelan algo más que
tipos. Los espacios de nombres, las variables locales y las etiquetas son todos símbolos.
Además, los símbolos son una representación de conceptos del lenguaje, no de
conceptos de CLR. Hay mucha superposición, pero también muchas distinciones
significativas. Por ejemplo, un método Iterator de C# o Visual Basic es un único símbolo.
Pero si el método Iterator se traduce a metadatos de CLR, es un tipo y varios métodos.

Modelo semántico
Un modelo semántico representa toda la información semántica de un solo archivo de
origen. Puede usarlo para descubrir lo siguiente:

Los símbolos a los que se hace referencia en una ubicación concreta del origen.
El tipo resultante de cualquier expresión.
Todos los diagnósticos, que son errores y advertencias.
Cómo fluyen las variables hacia y desde las regiones del origen.
Las respuestas a preguntas más especulativas.
Trabajar con un área de trabajo
Artículo • 10/02/2023 • Tiempo de lectura: 3 minutos

La capa Áreas de trabajo es el punto de partida para realizar análisis de código y

refactorización de soluciones completas. En esta capa, la API de área de trabajo ayuda a
organizar toda la información sobre los proyectos de una solución en un modelo de
objetos único, lo que ofrece acceso directo a modelos de objetos de capa de
compilador como texto de origen, árboles de sintaxis, modelos semánticos y
compilaciones sin necesidad de analizar archivos, configurar opciones ni administrar
dependencias entre proyectos.

Los entornos de host, como un IDE, proporcionan un área de trabajo que corresponde a
la solución abierta. También es posible usar este modelo fuera de un IDE con solo cargar
un archivo de solución.

Área de trabajo
Un área de trabajo es una representación activa de la solución como una colección de
proyectos, cada uno con una colección de documentos. Normalmente, un área de
trabajo está asociada a un entorno de host en continuo cambio a medida que el usuario
escribe o manipula las propiedades.

Workspace proporciona acceso al modelo actual de la solución. Cuando se produce un

cambio en el entorno de host, el área de trabajo desencadena los eventos
correspondientes y la propiedad Workspace.CurrentSolution se actualiza. Por ejemplo,
cuando el usuario escribe en un editor de texto correspondiente a uno de los
documentos de origen, el área de trabajo usa un evento para indicar que ha cambiado
el modelo general de la solución y qué documento se ha modificado. Luego puede
reaccionar a esos cambios mediante el análisis de la corrección del nuevo modelo,
resaltando las áreas de importancia o realizando una sugerencia para un cambio de
código.

También puede crear áreas de trabajo independientes desconectadas del entorno de

host o que se usen en una aplicación sin entorno de host.

Soluciones, proyectos y documentos

Aunque un área de trabajo puede cambiar cada vez que se pulsa una tecla, puede
trabajar con el modelo de la solución de forma aislada.
Una solución es un modelo inmutable de los proyectos y los documentos. Esto significa
que el modelo se puede compartir sin que haya bloqueo ni duplicación. Después de
obtener una instancia de solución de la propiedad Workspace.CurrentSolution, esa
instancia no cambia nunca. Pero, al igual que con los árboles de sintaxis y las
compilaciones, puede modificar soluciones mediante la creación de nuevas instancias
basadas en soluciones existentes y cambios concretos. Para que el área de trabajo
refleje los cambios, debe aplicar explícitamente la solución modificada al área de
trabajo.

Un proyecto es una parte del modelo de solución general inmutable. Representa todos
los documentos de código de origen, las opciones de análisis y compilación, y las
referencias de ensamblado y de proyecto a proyecto. Desde un proyecto puede acceder
a la compilación correspondiente sin necesidad de determinar las dependencias del
proyecto ni de analizar los archivos de origen.

Un documento también es una parte del modelo de solución general inmutable. Un

documento representa un solo archivo de origen desde el que se puede acceder al texto
del archivo, el árbol de sintaxis y el modelo semántico.

El diagrama siguiente es una representación de la relación entre el área de trabajo y el

entorno de host, las herramientas y cómo se realizan las modificaciones.

Resumen
Roslyn expone un conjunto de API de compilador y API de áreas de trabajo que
proporciona información detallada sobre el código fuente y que tiene plena fidelidad
con los lenguajes C# y Visual Basic. El SDK de .NET Compiler Platform reduce
notablemente la barrera para crear herramientas y aplicaciones centradas en el código.
Crea numerosas oportunidades para la innovación en áreas como la metaprogramación,
la generación y la transformación de código, el uso interactivo de los lenguajes C# y
Visual Basic, y la inserción de C# y Visual Basic en lenguajes específicos del dominio.
Explorar código con el Visualizador de
sintaxis Roslyn en Visual Studio
Artículo • 11/10/2022 • Tiempo de lectura: 10 minutos

En este artículo se ofrece información general de la herramienta Visualizador de sintaxis

que se incluye como parte del SDK de .NET Compiler Platform ("Roslyn"). El Visualizador
de sintaxis es una ventana de herramientas con la que puede inspeccionar y explorar
árboles de sintaxis. Es una herramienta esencial para comprender los modelos de
código que quiere analizar. También es útil para la depuración al desarrollar sus propias
aplicaciones con el SDK de .NET Compiler Platform (“Roslyn”). Abra esta herramienta
cuando vaya a crear sus primeros analizadores. Con el visualizador comprenderá los
modelos usados por las API. También puede usar herramientas como SharpLab o
LINQPad para inspeccionar el código y comprender los árboles de sintaxis.

Instrucciones de instalación: Instalador de

Visual Studio
Hay dos maneras distintas de buscar el SDK de .NET Compiler Platform en el Instalador
de Visual Studio:

Instalación con el Instalador de Visual Studio:

visualización de cargas de trabajo
El SDK de .NET Compiler Platform no se selecciona automáticamente como parte de la
carga de trabajo de desarrollo de extensiones de Visual Studio. Se debe seleccionar
como un componente opcional.

1. Ejecute el Instalador de Visual Studio.

2. Selección de Modificar
3. Active la carga de trabajo Desarrollo de extensiones de Visual Studio.
4. Abra el nodo Desarrollo de extensiones de Visual Studio en el árbol de resumen.
5. Active la casilla SDK de .NET Compiler Platform. La encontrará en última posición
bajo los componentes opcionales.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Abra el nodo Componentes individuales en el árbol de resumen.

2. Active la casilla Editor de DGML.
Instalación con el Instalador de Visual Studio: pestaña
Componentes individuales
1. Ejecute el Instalador de Visual Studio.
2. Selección de Modificar
3. Haga clic en la pestaña Componentes individuales.
4. Active la casilla SDK de .NET Compiler Platform. La encontrará en la parte superior
bajo la sección Compiladores, herramientas de compilación y tiempos de
ejecución.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Active la casilla Editor de DGML. La encontrará en la sección Herramientas de

código.

Para familiarizarse con los conceptos usados en el SDK de .NET Compiler Platform, lea el
artículo introductorio. Proporciona una introducción a los árboles de sintaxis, los nodos,
los tokens y algunas curiosidades.

Visualizador de sintaxis
Syntax Visualizer permite inspeccionar el árbol de sintaxis del archivo de código de C#
o Visual Basic en la ventana del editor activo actual en el IDE de Visual Studio. El
visualizador se puede iniciar haciendo clic en Vista>Other Windows (Otras
ventanas)>Syntax Visualizer (Visualizador de sintaxis) . También puede usar la barra de
herramientas Inicio rápido en la esquina superior derecha. Escriba "syntax" y se
mostrará el comando para abrir el Visualizador de sintaxis.

Este comando abre el Visualizador de sintaxis como una ventana de herramientas

flotante. Si no tiene abierta ninguna ventana de editor de código, la presentación está
en blanco, tal como se muestra en esta imagen.
Acople esta ventana de herramienta en una ubicación cómoda dentro de Visual Studio,
como por ejemplo, en el lado izquierdo. El visualizador muestra información sobre el
archivo de código actual.

Cree un nuevo proyecto con los comandos Archivo>Nuevo proyecto. Puede crear un
proyecto de Visual Basic o C#. Cuando Visual Studio abre el principal archivo de código
para este proyecto, el visualizador muestra el árbol de sintaxis correspondiente. Puede
abrir cualquier archivo de C# o Visual Basic existente en esta instancia de Visual Studio y
el visualizador mostrará el árbol de sintaxis de ese archivo. Si tiene varios archivos de
código abiertos dentro de Visual Studio, el visualizador muestra el árbol de sintaxis para
el archivo de código activo (el archivo de código que tiene el foco de teclado).

C#
Como se muestra en las imágenes anteriores, la ventana de herramientas del
visualizador muestra el árbol de sintaxis en la parte superior y una cuadrícula de
propiedades en la parte inferior. La cuadrícula de propiedades muestra las propiedades
del elemento que está seleccionado actualmente en el árbol, incluido el Tipo de .NET y
la Variante (SyntaxKind) del elemento.

Los árboles de sintaxis incluyen tres tipos de elementos: nodos, tokens y curiosidades.
Encontrará más información sobre estos tipos en el artículo Trabajar con sintaxis. Los
elementos de cada tipo se representan mediante un color diferente. Haga clic en el
botón “Leyenda” para saber más sobre los colores usados.

Cada elemento del árbol también muestra su propio intervalo. El intervalo está
comprendido por los índices (la posición inicial y la final) de ese nodo en el archivo de
texto. En el anterior ejemplo de C#, el token “UsingKeyword [0..5)” seleccionado tiene un
intervalo de cinco caracteres de ancho [0..5). La notación “[.)” significa que el índice
inicial forma parte del intervalo, pero el índice final no.

Se puede navegar por el árbol de dos maneras:

Expandir el árbol o hacer clic en él. El visualizador selecciona automáticamente el

texto correspondiente al intervalo de este elemento en el editor de código.
Hacer clic en el texto o seleccionarlo en el editor de código. En el ejemplo de
Visual Basic anterior, si selecciona la línea que contiene "Module Module1" en el
editor de código, el visualizador navega automáticamente al nodo
ModuleStatement correspondiente en el árbol.
El visualizador resalta el elemento en el árbol cuyo intervalo coincide mejor con el
intervalo del texto seleccionado en el editor.

El visualizador actualiza el árbol para coincidir con las modificaciones en el archivo de

código activo. Agregue una llamada a Console.WriteLine() dentro de Main() . A medida
que escribe, el visualizador actualiza el árbol.

Pare de escribir en cuanto escriba Console. . Verá que el árbol ha marcado en rosa
algunos elementos. En este momento, hay errores (también denominados
“diagnósticos”) en el código escrito. Estos errores se adjuntan a los nodos, los tokens y
las curiosidades en el árbol de sintaxis. El visualizador muestra qué elementos tienen
errores adjuntados a ellos resaltando el fondo en color rosa. Puede inspeccionar los
errores en cualquier elemento marcado en rosa si desplaza el puntero sobre el
elemento. El visualizador muestra solo los errores sintácticos (los errores relacionados
con la sintaxis del código escrito) y no muestra los errores semánticos.

Gráficos de sintaxis
Haga clic con el botón derecho en cualquier elemento del árbol y haga clic en View
Directed Syntax Graph (Ver gráfico de sintaxis dirigido).

C#

El visualizador muestra una representación gráfica del subárbol cuya raíz se

encuentra en el elemento seleccionado. Siga estos pasos para el nodo
MethodDeclaration correspondiente al método Main() en el ejemplo de C#. El
visualizador muestra un gráfico de sintaxis que tiene este aspecto:
El visor de gráficos de sintaxis tiene una opción para mostrar una leyenda para su
esquema de color. También puede pasar el puntero sobre determinados elementos en el
gráfico de sintaxis para ver las propiedades correspondientes a ese elemento.

Puede ver gráficos de sintaxis de elementos diferentes en el árbol de manera repetida y

los gráficos siempre se mostrarán en la misma ventana dentro de Visual Studio. Puede
acoplar esta ventana en una ubicación cómoda en Visual Studio para no tener que
cambiar entre pestañas para ver un nuevo gráfico de sintaxis. La parte inferior, debajo
de las ventanas del editor de código, suele resultar cómoda.

Este es el diseño de acoplamiento que se usa con la ventana del visualizador y la

ventana del gráfico de sintaxis:

Otra opción consiste en colocar la ventana del gráfico de sintaxis en un segundo

monitor, en una configuración de monitor dual.

Semántica de inspección
El Visualizador de sintaxis permite realizar una inspección rudimentaria de símbolos e
información semántica. Escriba double x = 1 + 1; dentro de Main() en el ejemplo de
C#. Después, seleccione la expresión 1 + 1 en la ventana del editor de código. El
visualizador resalta el nodo AddExpression en el visualizador. Haga clic con el botón
derecho en AddExpression y elija View Symbol (if any) [Ver símbolo (si existe)]. Tenga
en cuenta que la mayoría de los elementos de menú tienen el calificador "si existe". El
Visualizador de sintaxis inspecciona las propiedades de un nodo, incluidas las
propiedades que es posible que no estén presentes para todos los nodos.

La cuadrícula de propiedades del visualizador se actualiza tal como se muestra en la

figura siguiente: El símbolo de la expresión es un símbolo
SynthesizedIntrinsicOperatorSymbol con Kind = Method.
Intente View TypeSymbol (if any) [Ver TypeSymbol (si existe)] para el mismo nodo
AddExpression. La cuadrícula de propiedades del visualizador se actualiza como se
muestra en esta imagen, que indica que el tipo de la expresión seleccionada es Int32 .

Intente View Converted TypeSymbol (if any) [Ver TypeSymbol convertido (si existe)]
para el mismo nodo AddExpression. La cuadrícula de propiedades se actualiza para
indicar que, aunque el tipo de la expresión es Int32 , el tipo convertido de la expresión
es Double , como se muestra en esta imagen. Este nodo incluye información de símbolo
de tipo convertido porque la expresión Int32 se produce en un contexto donde se
debe convertir a Double . Esta conversión satisface el tipo Double especificado para la
variable x en el lado izquierdo del operador de asignación.

Por último, intente View Constant Value (if any) [Ver valor de constante (si existe)] para
el mismo nodo AddExpression. La cuadrícula de propiedades muestra que el valor de la
expresión es una constante en tiempo de compilación con el valor 2 .
El ejemplo anterior también se puede replicar en Visual Basic. Escriba Dim x As Double =
1 + 1 en un archivo de Visual Basic. Seleccione la expresión 1 + 1 en la ventana del
editor de código. El visualizador resalta el nodo AddExpression correspondiente en el
visualizador. Repita los pasos anteriores para AddExpression y deberían mostrarse
resultados idénticos.

Examine más código en Visual Basic. Actualice el archivo principal de Visual Basic con
este código:

VB

Imports C = System.Console

Module Program

Sub Main(args As String())

C.WriteLine()

End Sub

End Module

Este código incluye un alias llamado C que se asigna al tipo System.Console en la parte
superior del archivo y usa este alias en Main() . Seleccione el uso de este alias, C en
C.WriteLine() , dentro del método Main() . El visualizador selecciona el nodo

IdentifierName correspondiente en el visualizador. Haga clic con el botón derecho en

este nodo y elija View Symbol (if any) [Ver símbolo (si existe)]. La cuadrícula de
propiedades indica que este identificador está enlazado al tipo System.Console tal como
se muestra en esta imagen:

Intente View AliasSymbol (if any) [Ver AliasSymbol (si existe)] para el mismo nodo
IdentifierName. La cuadrícula de propiedades indica que el identificador es un alias con
el nombre C que está enlazado al destino System.Console . En otras palabras, la
cuadrícula de propiedades proporciona información sobre el AliasSymbol
correspondiente al identificador C .
Inspeccione el símbolo correspondiente a cualquier tipo, método o propiedad
declarados. Seleccione el nodo correspondiente en el visualizador y haga clic en View
Symbol (if any) [Ver símbolo (si existe)]. Seleccione el método Sub Main() , incluido el
cuerpo del método. Haga clic en View Symbol (if any) [Ver símbolo (si existe)] para el
nodo SubBlock correspondiente en el visualizador. La cuadrícula de propiedades
muestra que MethodSymbol para este nodo SubBlock tiene el nombre Main con el tipo
de valor devuelto Void .
Los ejemplos de Visual Basic anteriores se pueden replicar fácilmente en C#. Escriba
using C = System.Console; en lugar de Imports C = System.Console para el alias. Los
pasos anteriores en C# producen resultados idénticos en la ventana del visualizador.

Las operaciones de inspección semántica solo están disponibles en los nodos. No están
disponibles en tokens o curiosidades. No todos los nodos tienen información semántica
interesante que inspeccionar. Cuando un nodo no tiene información semántica
interesante, al hacer clic en View * Symbol (if any) [Ver símbolo * (si existe)] se muestra
una cuadrícula de propiedades en blanco.

Puede leer más sobre las API para realizar análisis semánticos en el documento
introductorio Trabajar con semántica.

Cerrar el Visualizador de sintaxis

Puede cerrar la ventana del visualizador cuando no esté usándolo para examinar el
código fuente. Syntax Visualizer se actualiza a medida que navega por el código, y
modifica o cambia el código fuente. Puede distraerse cuando no esté usándolo.
Generadores de origen
Artículo • 28/11/2022 • Tiempo de lectura: 9 minutos

En este artículo se ofrece información general sobre los generadores de código fuente
que se incluye como parte del SDK de .NET Compiler Platform ("Roslyn"). Los
generadores de código fuente permiten a los desarrolladores de C# inspeccionar el
código de usuario a medida que se compila. El generador puede crear nuevos archivos
de código fuente de C# sobre la marcha que se agregan a la compilación del usuario.
De este modo, tiene código que se ejecuta durante la compilación. Además, inspecciona
el programa para generar archivos de código fuente adicionales que se compilan junto
con el resto del código.

Un generador de código fuente es un nuevo tipo de componente que los

desarrolladores de C# pueden escribir y que le permite hacer dos cosas principales:

1. Recuperar un objeto de compilación que representa todo el código de usuario que

se está compilando. Este objeto se puede inspeccionar, y puede escribir código
que funcione con la sintaxis y los modelos semánticos del código que se compila,
al igual que con los analizadores de hoy en día.

2. Genere archivos de código fuente de C# que se puedan agregar a un objeto de

compilación durante la compilación. En otras palabras, puede proporcionar código
fuente adicional como una entrada en una compilación mientras se compila el
código.

Cuando se combinan, estas dos cosas son las que hacen que los generadores de código
fuente sean tan útiles. Puede inspeccionar el código de usuario con todos los metadatos
enriquecidos que el compilador crea durante la compilación. Después, el generador
vuelve a emitir código de C# en la misma compilación que se basa en los datos que ha
analizado. Si está familiarizado con los analizadores de Roslyn, puede pensar en los
generadores de código fuente como analizadores que pueden emitir código fuente de
C#.

Los generadores de código fuente se ejecutan como una fase de compilación que se
visualiza a continuación:
 

Un generador de código fuente es un ensamblado de .NET Standard 2.0 que el

compilador carga junto con cualquier analizador. Se puede usar en entornos en los que
se pueden cargar y ejecutar los componentes de .NET Standard.

） Importante

Actualmente, solo se pueden usar ensamblados de .NET Standard 2.0 como

generadores de origen.

Escenarios frecuentes
Existen tres enfoques generales para inspeccionar el código de usuario y generar
información o código basado en ese análisis que usan las tecnologías de hoy en día:

Reflexión en tiempo de ejecución.

Tareas de MSBuild pendientes.
Tejido de lenguaje intermedio (IL) (no se describe en este artículo).

Los generadores de código fuente pueden mejorar cada enfoque.

Reflexión en tiempo de ejecución

La reflexión en tiempo de ejecución es una tecnología eficaz que se agregó a .NET hace
mucho tiempo. Existen incontables escenarios para usarla. Un escenario común es
realizar algún análisis del código de usuario cuando se inicia una aplicación y usar los
datos para generar elementos.

Por ejemplo, ASP.NET Core usa la reflexión cuando el servicio web se ejecuta por
primera vez para detectar las construcciones que ha definido para que pueda "conectar"
elementos, como controladores y Razor Pages. Aunque este escenario le permite escribir
código sencillo con abstracciones eficaces, viene acompañado de una penalización de
rendimiento en tiempo de ejecución: cuando el servicio web o la aplicación se inician
por primera vez, no pueden aceptar ninguna solicitud hasta que todo el código de
reflexión en tiempo de ejecución que descubre información sobre el código termine de
ejecutarse. Aunque esta penalización de rendimiento no es enorme, es un costo fijo que
no puede mejorar por sí mismo en su propia aplicación.

Con un generador de código fuente, la fase de detección del controlador de inicio

podría producirse en tiempo de compilación. Un generador puede analizar el código
fuente y emitir el código que necesita para "conectar" la aplicación. El uso de
generadores de código fuente podría dar lugar a tiempos de inicio más rápidos, ya que
una acción que está teniendo lugar en tiempo de ejecución podría insertarse en tiempo
de compilación.

Tareas de MSBuild pendientes

Los generadores de origen pueden mejorar el rendimiento de formas que no se limitan
a la reflexión en tiempo de ejecución para descubrir tipos también. Algunos escenarios
implican llamar a la tarea de C# de MSBuild (denominada CSC) varias veces para que
puedan inspeccionar los datos desde una compilación. Como puede imaginar, llamar al
compilador más de una vez afecta al tiempo total que se tarda en compilar la aplicación.
Estamos investigando cómo se pueden usar los generadores de código fuente para
obviar la necesidad de realizar tareas de MSBuild como esta, ya que los generadores de
código fuente no solo ofrecen algunas ventajas de rendimiento, sino que también
permiten que las herramientas funcionen en el nivel de abstracción correcto.

Otra funcionalidad que los generadores de código fuente pueden ofrecer es obviar el
uso de algunas API "fuertemente tipadas"; por ejemplo, el modo en que funciona el
enrutamiento de ASP.NET Core entre controladores y Razor Pages. Con un generador de
código fuente, el enrutamiento puede estar fuertemente tipado con la generación de las
cadenas necesarias como un detalle en tiempo de compilación. Esto reduciría la
cantidad de veces que un literal de cadena mal escrito genera una solicitud que no llega
al controlador correcto.

Introducción a los generadores de código

fuente
En esta guía, explorará la creación de un generador de código fuente mediante la API
ISourceGenerator.

1. Creación de una aplicación de consola .NET Este ejemplo usa .NET 6.

2. Reemplace la clase Program por el siguiente código. El código siguiente no usa
instrucciones de nivel superior. La forma clásica es necesaria porque este primer
generador de código fuente escribe un método parcial en esa clase Program :

C#

namespace ConsoleApp;

partial class Program

static void Main(string[] args)

HelloFrom("Generated Code");

static partial void HelloFrom(string name);

７ Nota

Puede ejecutar este ejemplo tal y como está, pero todavía no ocurrirá nada.

3. A continuación, crearemos un proyecto de generador de origen que implementará

el método partial void HelloFrom equivalente.

4. Cree un proyecto de biblioteca .NET Standard que se dirija al moniker de la

plataforma de destino (TFM) netstandard2.0 . Agregue los paquetes NuGet
Microsoft.CodeAnalysis.Analyzers y Microsoft.CodeAnalysis.CSharp:

XML

<Project Sdk="Microsoft.NET.Sdk">

<PropertyGroup>

<TargetFramework>netstandard2.0</TargetFramework>

</PropertyGroup>

<ItemGroup>

<PackageReference Include="Microsoft.CodeAnalysis.CSharp"
Version="4.4.0" PrivateAssets="all" />

<PackageReference Include="Microsoft.CodeAnalysis.Analyzers"
Version="3.3.3">

<PrivateAssets>all</PrivateAssets>

<IncludeAssets>runtime; build; native; contentfiles; analyzers;

buildtransitive</IncludeAssets>

</PackageReference>

</ItemGroup>

 </Project>

 Sugerencia

El proyecto del generador de origen debe tener como destino el TFM

netstandard2.0 ; de lo contrario, no funcionará.

5. Cree un archivo de C# denominado HelloSourceGenerator.cs que especifique su

propio generador de origen de la siguiente manera:

C#

using Microsoft.CodeAnalysis;

namespace SourceGenerator

[Generator]

public class HelloSourceGenerator : ISourceGenerator

public void Execute(GeneratorExecutionContext context)

// Code generation goes here

public void Initialize(GeneratorInitializationContext context)

// No initialization required for this one

Un generador de origen debe implementar la interfaz

Microsoft.CodeAnalysis.ISourceGenerator y tener
Microsoft.CodeAnalysis.GeneratorAttribute. No todos los generadores de código
fuente requieren inicialización, y es el caso de esta implementación de ejemplo,
donde el objeto ISourceGenerator.Initialize está vacío.

6. Reemplace el contenido del método ISourceGenerator.Execute, con la siguiente

implementación:

C#

using Microsoft.CodeAnalysis;

namespace SourceGenerator

 [Generator]

public class HelloSourceGenerator : ISourceGenerator

public void Execute(GeneratorExecutionContext context)

// Find the main method

var mainMethod =
context.Compilation.GetEntryPoint(context.CancellationToken);

// Build up the source code

string source = $@"// <auto-generated/>

using System;

namespace {mainMethod.ContainingNamespace.ToDisplayString()}

{{

public static partial class {mainMethod.ContainingType.Name}

{{

static partial void HelloFrom(string name) =>

Console.WriteLine($""Generator says: Hi from '{{name}}'"");

}}

}}

";

var typeName = mainMethod.ContainingType.Name;

// Add the source code to the compilation

context.AddSource($"{typeName}.g.cs", source);

public void Initialize(GeneratorInitializationContext context)

// No initialization required for this one

A partir del objeto context , se puede acceder al punto de entrada de las

compilaciones o al método Main . La instancia mainMethod es IMethodSymbol, y
representa un método o un símbolo de tipo método (incluido el constructor,
destructor, operador o descriptor de acceso de propiedad/evento). El método
Microsoft.CodeAnalysis.Compilation.GetEntryPoint devuelve el objeto
IMethodSymbol del punto de entrada del programa. Otros métodos permiten
buscar cualquier símbolo del método en un proyecto. A partir de este objeto,
podemos razonar sobre el espacio de nombres que lo contiene (si hay alguno) y el
tipo. El objeto source de este ejemplo es una cadena interpolada que crea
plantillas para el código fuente que se va a generar, donde los marcadores
interpolados se rellenan con el espacio de nombres que los contiene y la
información de tipo. source se agrega a context con un nombre de sugerencia. En
este ejemplo, el generador crea un nuevo archivo de código fuente generado que
contiene una implementación del método partial en la aplicación de consola.
 Puede escribir generadores de código fuente para agregar cualquier código fuente
que desee.

 Sugerencia

El parámetro hintName del método GeneratorExecutionContext.AddSource

puede ser cualquier nombre único. Es habitual proporcionar una extensión de
archivo de C# explícita, como ".g.cs" o ".generated.cs" para el nombre. El
nombre de archivo ayuda a identificar el archivo como generado en el origen.

7. Ahora tenemos un generador en funcionamiento, pero es necesario conectarlo a

nuestra aplicación de consola. Edite el proyecto de aplicación de consola original y
agregue lo siguiente, reemplazando la ruta de acceso del proyecto por la del
proyecto de .NET Standard que creó anteriormente:

XML

<!-- Add this as a new ItemGroup, replacing paths and names

appropriately -->

<ItemGroup>

<ProjectReference Include="..\PathTo\SourceGenerator.csproj"

OutputItemType="Analyzer"

ReferenceOutputAssembly="false" />
</ItemGroup>

La nueva referencia no es una referencia de proyecto tradicional y se debe editar

manualmente para incluir los atributos OutputItemType y ReferenceOutputAssembly .
Para más información sobre los atributos OutputItemType y
ReferenceOutputAssembly de ProjectReference , consulte Elementos comunes de

proyectos de MSBuild: ProjectReference.

8. Ahora, al ejecutar la aplicación de consola, debería ver que el código generado se

ejecuta e imprime en la pantalla. La propia aplicación de consola no implementa el
método HelloFrom , sino que es el código fuente generado durante la compilación
desde el proyecto del generador de código fuente. El texto siguiente es un
ejemplo de resultado de la aplicación:

Consola

Generator says: Hi from 'Generated Code'

７ Nota
 Es posible que deba reiniciar Visual Studio para ver IntelliSense y deshacerse
de los errores a medida que se mejora activamente la experiencia con las
herramientas.

9. Si usa Visual Studio, puede ver los archivos generados del origen. En la ventana
Explorador de soluciones, expanda
Dependencias>Analizadores>SourceGenerator>SourceGenerator.HelloSourceGe
nerator y haga doble clic en el archivo Program.g.cs.

Al abrir este archivo generado, Visual Studio indicará que el archivo se genera

automáticamente y que no se puede editar.

10. También puede establecer propiedades de compilación para guardar el archivo

generado y controlar dónde se almacenan los archivos generados. En el archivo de
proyecto de la aplicación de consola, agregue el elemento
 <EmitCompilerGeneratedFiles> a un objeto <PropertyGroup> y establezca su valor

en true . Vuelva a compilar el proyecto. Ahora, los archivos generados se crean en

obj/Debug/net6.0/generated/SourceGenerator/SourceGenerator.HelloSourceGenerat
or. Los componentes de la ruta de acceso se asignan a la configuración de
compilación, la plataforma de destino, el nombre del proyecto del generador de
código fuente y el nombre de tipo completo del generador. Puede elegir una
carpeta de salida más conveniente agregando el elemento
<CompilerGeneratedFilesOutputPath> al archivo de proyecto de la aplicación.

Pasos siguientes
En la guía paso a paso de los generadores de código fuente se abordan algunos de
estos ejemplos con algunos enfoques recomendados para resolverlos. Además, tenemos
un conjunto de ejemplos disponibles en GitHub que puede probar por su cuenta.

Puede aprender más sobre los generadores de código fuente en estos artículos:

Documento de diseño de los generadores de código fuente

Guía paso a paso de los generadores de código fuente
Introducción al análisis de sintaxis
Artículo • 22/09/2022 • Tiempo de lectura: 14 minutos

En este tutorial, explorará la API de sintaxis. La API de sintaxis proporciona acceso a las
estructuras de datos que describen un programa de C# o Visual Basic. Estas estructuras
de datos tienen suficientes detalles para representar completamente un programa de
cualquier tamaño. Estas estructuras pueden describir programas completos que se
compilen y ejecuten correctamente. También pueden describir programas incompletos,
conforme los escribe, en el editor.

Para habilitar esta expresión completa, las estructuras de datos y las API que constituyen
la API de sintaxis son necesariamente complejas. Empecemos con el aspecto de la
estructura de datos para el programa típico “Hola mundo”:

C#

using System;

using System.Collections.Generic;
using System.Linq;

namespace HelloWorld

class Program

static void Main(string[] args)

Console.WriteLine("Hello World!");

Mire el texto del programa anterior. Reconoce elementos conocidos. Todo el texto
representa un único archivo de código fuente o una unidad de compilación. Las tres
primeras líneas del archivo de código fuente son directivas using. El código fuente
restante se encuentra en una declaración de espacio de nombres. La declaración de
espacio de nombres contiene una declaración de clase secundaria. La declaración de
clase contiene una declaración de método.

La API de sintaxis crea una estructura de árbol y la raíz representa la unidad de

compilación. Los nodos del árbol representan las directivas using, la declaración del
espacio de nombres y todos los demás elementos del programa. La estructura de árbol
continúa hasta los niveles más bajos: la cadena "Hello World!" (Hola mundo) es un
token literal de cadena que es un descendiente de un argumento. La API de sintaxis
proporciona acceso a la estructura del programa. Puede consultar los procedimientos
de código concretos, recorrer el árbol completo para entender el código y crear árboles
al modificar el árbol existente.

Esa descripción breve proporciona información general sobre el tipo de información

accesible mediante la API de sintaxis. La API de sintaxis no es nada más que una API
formal que describe las construcciones de código que ya conoce de C#. Entre las
funcionalidades completas, se incluye información sobre cómo se da formato al código,
incluidos los saltos de línea, los espacios en blanco y la sangría. Con esta información,
puede representar por completo el código tal y como lo escriben y leen los
programadores humanos o el compilador. Con esta estructura, puede interactuar con el
código fuente de forma muy significativa. Ya no son cadenas de texto, sino datos que
representan la estructura de un programa de C#.

Para empezar, debe instalar el SDK de .NET Compiler Platform:

Instrucciones de instalación: Instalador de

Visual Studio
Hay dos maneras distintas de buscar el SDK de .NET Compiler Platform en el Instalador
de Visual Studio:

Instalación con el Instalador de Visual Studio:

visualización de cargas de trabajo
El SDK de .NET Compiler Platform no se selecciona automáticamente como parte de la
carga de trabajo de desarrollo de extensiones de Visual Studio. Se debe seleccionar
como un componente opcional.

1. Ejecute el Instalador de Visual Studio.

2. Selección de Modificar
3. Active la carga de trabajo Desarrollo de extensiones de Visual Studio.
4. Abra el nodo Desarrollo de extensiones de Visual Studio en el árbol de resumen.
5. Active la casilla SDK de .NET Compiler Platform. La encontrará en última posición
bajo los componentes opcionales.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Abra el nodo Componentes individuales en el árbol de resumen.

2. Active la casilla Editor de DGML.
Instalación con el Instalador de Visual Studio: pestaña
Componentes individuales
1. Ejecute el Instalador de Visual Studio.
2. Selección de Modificar
3. Haga clic en la pestaña Componentes individuales.
4. Active la casilla SDK de .NET Compiler Platform. La encontrará en la parte superior
bajo la sección Compiladores, herramientas de compilación y tiempos de
ejecución.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Active la casilla Editor de DGML. La encontrará en la sección Herramientas de

código.

Comprender los árboles de sintaxis

Use la API de sintaxis para cualquier análisis de la estructura del código de C#. La API de
sintaxis expone los analizadores, los árboles de sintaxis y las utilidades para analizar y
construir árboles de sintaxis. Es la forma en que busca en el código cualquier elemento
de sintaxis específica o lee el código de un programa.

Un árbol de sintaxis es una estructura de datos que usan los compiladores de C# y

Visual Basic para comprender los programas de C# y Visual Basic. Los árboles de sintaxis
los produce el mismo analizador que se ejecuta cuando se compila un proyecto o un
programador presiona F5. Los árboles de sintaxis tienen una fidelidad completa con el
lenguaje; cada bit de información en un archivo de código se representa en el árbol.
Escribir un árbol de sintaxis en texto reproduce el texto original exacto que se ha
analizado. Los árboles de sintaxis también son inmutables; una vez creado un árbol de
sintaxis, nunca se puede modificar. Los consumidores de los árboles pueden analizarlos
en varios subprocesos, sin bloqueos ni otras medidas de simultaneidad, sabiendo que
los datos nunca cambian. Puede usar las API para crear árboles que sean el resultado de
modificar un árbol existente.

Los cuatro pilares principales de los árboles de sintaxis son los siguientes:

La clase Microsoft.CodeAnalysis.SyntaxTree, una instancia de lo que representa un

árbol de análisis completo. SyntaxTree es una clase abstracta que tiene derivados
específicos del lenguaje. Use los métodos de análisis de la clase
Microsoft.CodeAnalysis.CSharp.CSharpSyntaxTree (o
 Microsoft.CodeAnalysis.VisualBasic.VisualBasicSyntaxTree) para analizar texto en C#
o (Visual Basic).
La clase Microsoft.CodeAnalysis.SyntaxNode, instancias de lo que representan las
construcciones sintácticas como declaraciones, instrucciones, cláusulas y
expresiones.
La estructura Microsoft.CodeAnalysis.SyntaxToken, que representa una palabra
clave, identificador, operador o puntuación individuales.
Por último, la estructura Microsoft.CodeAnalysis.SyntaxTrivia, que representa
sintácticamente bits de información insignificante, como el espacio en blanco entre
tokens, las directivas de preprocesamiento y los comentarios.

La trivialidad, los tokens y los nodos se componen de forma jerárquica para formar un
árbol que representa por completo todo lo que hay en un fragmento de código de
Visual Basic o C#. Puede ver esta estructura mediante la ventana Syntax Visualizer
(Visualizador de sintaxis). En Visual Studio, elija Vista>Otras ventanas>Syntax Visualizer
(Visualizador de sintaxis). Por ejemplo, el archivo de código fuente de C# anterior
examinado con Syntax Visualizer (Visualizador de sintaxis) tiene el mismo aspecto que
en la siguiente ilustración:
SyntaxNode: Azul | SyntaxToken: Verde | SyntaxTrivia: Rojo

Si se desplaza por esta estructura de árbol, podrá encontrar cualquier instrucción,

expresión, token o bit de espacio en blanco en un archivo de código.

Aunque puede buscar cualquier elemento en un archivo de código mediante las API de
sintaxis, la mayoría de los escenarios implican examinar pequeños fragmentos de
código o buscar instrucciones o fragmentos concretos. Los dos ejemplos siguientes
muestran usos típicos para examinar la estructura del código o buscar instrucciones
únicas.

Recorrer árboles
Puede examinar los nodos de un árbol de sintaxis de dos maneras. Puede recorrer el
árbol para examinar cada nodo o puede consultar elementos o nodos concretos.

Recorrido manual
Puede ver el código terminado de este ejemplo en nuestro repositorio de GitHub .

７ Nota

Los tipos de árbol de sintaxis usan la herencia para describir los diferentes
elementos de sintaxis que son válidos en diferentes ubicaciones del programa. A
menudo, usar estas API significa convertir propiedades o miembros de colección en
tipos derivados concretos. En los ejemplos siguientes, la asignación y las
conversiones son instrucciones independientes, con variables con tipo explícito.
Puede leer el código para ver los tipos de valor devuelto de la API y el tipo de
motor de ejecución de los objetos devueltos. En la práctica, es más habitual usar
variables con tipo implícito y basarse en nombres de API para describir el tipo de
los objetos que se examinan.

Cree un proyecto de Stand-Alone Code Analysis Tool (Herramienta de análisis de

código independiente) de C#:

En Visual Studio, elija Archivo>Nuevo>Proyecto para mostrar el cuadro de

diálogo Nuevo proyecto.
En Visual C#>Extensibilidad, elija Stand-Alone Code Analysis Tool (Herramienta
de análisis de código independiente).
Asigne al proyecto el nombre "SyntaxTreeManualTraversal" y haga clic en Aceptar.

Va a analizar el programa básico "Hola mundo" mostrado anteriormente.

Agregue el
texto para el programa Hola mundo como una constante en su clase Program :

C#

const string programText =

@"using System;

using System.Collections;

using System.Linq;

using System.Text;

namespace HelloWorld

class Program

static void Main(string[] args)

Console.WriteLine(""Hello, World!"");

}";

A continuación, agregue el código siguiente para crear el árbol de sintaxis para el texto
del código de la constante programText . Agregue la línea siguiente al método Main :

C#

SyntaxTree tree = CSharpSyntaxTree.ParseText(programText);

CompilationUnitSyntax root = tree.GetCompilationUnitRoot();

Estas dos líneas crean el árbol y recuperan su nodo raíz. Ahora puede examinar los
nodos del árbol. Agregue estas líneas al método Main para mostrar algunas de las
propiedades del nodo raíz en el árbol:

C#

WriteLine($"The tree is a {root.Kind()} node.");

WriteLine($"The tree has {root.Members.Count} elements in it.");

WriteLine($"The tree has {root.Usings.Count} using statements. They are:");

foreach (UsingDirectiveSyntax element in root.Usings)

WriteLine($"\t{element.Name}");

Ejecute la aplicación para ver lo que ha detectado el código sobre el nodo raíz de este
árbol.

Normalmente, recorrería el árbol para obtener información sobre el código. En este

ejemplo, analiza código que conoce para explorar las API. Agregue el código siguiente
para examinar el primer miembro del nodo root :

C#

MemberDeclarationSyntax firstMember = root.Members[0];

WriteLine($"The first member is a {firstMember.Kind()}.");

var helloWorldDeclaration = (NamespaceDeclarationSyntax)firstMember;

Ese miembro es una

Microsoft.CodeAnalysis.CSharp.Syntax.NamespaceDeclarationSyntax. Representa todo lo
que se incluye en el ámbito de la declaración namespace HelloWorld . Agregue el código
siguiente para examinar qué nodos se declaran en el espacio de nombres HelloWorld :

C#
 WriteLine($"There are {helloWorldDeclaration.Members.Count} members declared
in this namespace.");

WriteLine($"The first member is a

{helloWorldDeclaration.Members[0].Kind()}.");

Ejecute el programa para ver lo que ha aprendido.

Ahora que sabe que la declaración es una

Microsoft.CodeAnalysis.CSharp.Syntax.ClassDeclarationSyntax, declare una nueva
variable de ese tipo para examinar la declaración de clase. Esta clase solo contiene un
miembro: el método Main . Agregue el código siguiente para buscar el método Main y
conviértalo en una Microsoft.CodeAnalysis.CSharp.Syntax.MethodDeclarationSyntax.

C#

var programDeclaration =
(ClassDeclarationSyntax)helloWorldDeclaration.Members[0];

WriteLine($"There are {programDeclaration.Members.Count} members declared in

the {programDeclaration.Identifier} class.");

WriteLine($"The first member is a {programDeclaration.Members[0].Kind()}.");

var mainDeclaration =
(MethodDeclarationSyntax)programDeclaration.Members[0];

El nodo de declaración de método contiene toda la información sintáctica sobre el

método. Vamos a mostrar el tipo de valor devuelto del método Main , el número y los
tipos de los argumentos, y el texto del cuerpo del método. Agregue el código siguiente:

C#

WriteLine($"The return type of the {mainDeclaration.Identifier} method is

{mainDeclaration.ReturnType}.");

WriteLine($"The method has {mainDeclaration.ParameterList.Parameters.Count}

parameters.");

foreach (ParameterSyntax item in mainDeclaration.ParameterList.Parameters)

WriteLine($"The type of the {item.Identifier} parameter is

{item.Type}.");

WriteLine($"The body text of the {mainDeclaration.Identifier} method

follows:");

WriteLine(mainDeclaration.Body.ToFullString());

var argsParameter = mainDeclaration.ParameterList.Parameters[0];

Ejecute el programa para ver toda la información que ya conoce sobre este programa:

text
 The tree is a CompilationUnit node.

The tree has 1 elements in it.

The tree has 4 using statements. They are:

System

System.Collections

System.Linq

System.Text

The first member is a NamespaceDeclaration.

There are 1 members declared in this namespace.

The first member is a ClassDeclaration.

There are 1 members declared in the Program class.

The first member is a MethodDeclaration.

The return type of the Main method is void.

The method has 1 parameters.

The type of the args parameter is string[].

The body text of the Main method follows:

Console.WriteLine("Hello, World!");

Métodos de consulta
Además de recorrer árboles, también puede explorar el árbol de sintaxis mediante los
métodos de consulta definidos en Microsoft.CodeAnalysis.SyntaxNode. Cualquier
persona que conozca XPath debería conocer estos métodos. Puede usarlos con LINQ
para buscar elementos rápidamente en un árbol. SyntaxNode tiene métodos de consulta
como DescendantNodes, AncestorsAndSelf y ChildNodes.

Puede usar estos métodos de consulta para buscar el argumento para el método Main
como una alternativa a navegar por el árbol. Agregue el siguiente código en la parte
inferior del método Main :

C#

var firstParameters = from methodDeclaration in root.DescendantNodes()

.OfType<MethodDeclarationSyntax>()

where methodDeclaration.Identifier.ValueText == "Main"

select
methodDeclaration.ParameterList.Parameters.First();

var argsParameter2 = firstParameters.Single();

WriteLine(argsParameter == argsParameter2);

La primera instrucción usa una expresión LINQ y el método DescendantNodes para

buscar el mismo parámetro que en el ejemplo anterior.
Ejecute el programa y compruebe que la expresión LINQ ha encontrado el mismo
parámetro que se encuentra al navegar por el árbol de forma manual.

En el ejemplo, se usan instrucciones WriteLine para mostrar información sobre los

árboles de sintaxis conforme se recorren. Puede obtener mucha más información si
ejecuta el programa terminado en el depurador. Puede examinar más propiedades y
métodos que forman parte del árbol de sintaxis creado para el programa Hola mundo.

Rastreadores de sintaxis
A menudo, quiere buscar todos los nodos de un tipo concreto en un árbol de sintaxis,
por ejemplo, todas las declaraciones de propiedad de un archivo. Si extiende la clase
Microsoft.CodeAnalysis.CSharp.CSharpSyntaxWalker e invalida el método
VisitPropertyDeclaration(PropertyDeclarationSyntax), se procesan todas las
declaraciones de propiedad de un árbol de sintaxis sin conocer su estructura de
antemano. CSharpSyntaxWalker es un tipo determinado de CSharpSyntaxVisitor que
visita de forma recurrente un nodo y todos sus elementos secundarios.

En este ejemplo, se implementa un CSharpSyntaxWalker que examina un árbol de

sintaxis. Recopila directivas using que determina que no implementan un espacio de
nombres System .

Cree un proyecto de Stand-Alone Code Analysis Tool (Herramienta de análisis de

código independiente) de C# y asígnele el nombre “SyntaxWalker”.

Puede ver el código terminado de este ejemplo en nuestro repositorio de GitHub . El

ejemplo de GitHub contiene los dos proyectos que se describen en este tutorial.

Como en el ejemplo anterior, puede definir una constante de cadena para que contenga
el texto del programa que se va a analizar:

C#

const string programText =

@"using System;

using System.Collections.Generic;
using System.Linq;

using System.Text;

using Microsoft.CodeAnalysis;

using Microsoft.CodeAnalysis.CSharp;

namespace TopLevel

using Microsoft;

using System.ComponentModel;

 namespace Child1

using Microsoft.Win32;

using System.Runtime.InteropServices;

class Foo { }

namespace Child2

using System.CodeDom;

using Microsoft.CSharp;

class Bar { }

}";

Este texto de origen contiene directivas using dispersas por cuatro ubicaciones
diferentes: el nivel de archivo, en el espacio de nombres de nivel superior y en los dos
espacios de nombres anidados. En este ejemplo, se destaca un escenario principal para
usar la clase CSharpSyntaxWalker en el código de la consulta. Sería complejo visitar
todos los nodos del árbol de sintaxis raíz para buscar las declaraciones using. En su
lugar, cree una clase derivada y reemplace el método al que se llama solo cuando el
nodo actual del árbol sea una directiva using. El visitante no hace ningún trabajo en
ningún otro tipo de nodo. Este método único examina todas las instrucciones using y
compila una colección de los espacios de nombres que no están en el espacio de
nombres System . Compile un CSharpSyntaxWalker que examine todas las instrucciones
using , pero solo las instrucciones using .

Ahora que ha definido el texto del programa, debe crear un SyntaxTree y obtener la raíz
de ese árbol:

C#

SyntaxTree tree = CSharpSyntaxTree.ParseText(programText);

CompilationUnitSyntax root = tree.GetCompilationUnitRoot();

A continuación, cree una clase. En Visual Studio, elija Proyecto>Agregar nuevo

elemento. En el cuadro de diálogo Agregar nuevo elemento, escriba UsingCollector.cs
como nombre de archivo.

Implemente la funcionalidad del visitante using en la clase UsingCollector . Para

empezar, haga que la clase UsingCollector derive de CSharpSyntaxWalker.

C#
 class UsingCollector : CSharpSyntaxWalker

Necesita almacenamiento para contener los nodos del espacio de nombres que está
recopilando. Declare una propiedad pública de solo lectura en la clase UsingCollector ;
use esta variable para almacenar los nodos UsingDirectiveSyntax que encuentre:

C#

public ICollection<UsingDirectiveSyntax> Usings { get; } = new

List<UsingDirectiveSyntax>();

La clase base, CSharpSyntaxWalker, implementa la lógica para visitar todos los nodos del
árbol de sintaxis. La clase derivada reemplaza los métodos llamados por los nodos
específicos que le interesan. En este caso, le interesa cualquier directiva using . Por
tanto, debe invalidar el método VisitUsingDirective(UsingDirectiveSyntax). El único
argumento de este método es un objeto
Microsoft.CodeAnalysis.CSharp.Syntax.UsingDirectiveSyntax. Se trata de una ventaja
importante de usar los visitantes: llaman a los métodos invalidados con argumentos que
ya se han convertido al tipo de nodo concreto. La clase
Microsoft.CodeAnalysis.CSharp.Syntax.UsingDirectiveSyntax tiene una propiedad Name
que almacena el nombre del espacio de nombres que se va a importar. Es una
Microsoft.CodeAnalysis.CSharp.Syntax.NameSyntax. Agregue el código siguiente en la
invalidación VisitUsingDirective(UsingDirectiveSyntax):

C#

public override void VisitUsingDirective(UsingDirectiveSyntax node)

WriteLine($"\tVisitUsingDirective called with {node.Name}.");

if (node.Name.ToString() != "System" &&

!node.Name.ToString().StartsWith("System."))

WriteLine($"\t\tSuccess. Adding {node.Name}.");

this.Usings.Add(node);

Como con el ejemplo anterior, ha agregado una variedad de instrucciones WriteLine

para ayudar a comprender este método. Puede ver cuándo se llama y qué argumentos
se le pasan cada vez.

Por último, debe agregar dos líneas de código para crear el UsingCollector y hacer que
visite el nodo raíz y recopile todas las instrucciones using . A continuación, agregue un
bucle foreach para que muestre todas las instrucciones using que encuentre el
recopilador:

C#

var collector = new UsingCollector();

collector.Visit(root);

foreach (var directive in collector.Usings)

WriteLine(directive.Name);

Compile y ejecute el programa. Debería ver los siguientes resultados:

Consola

VisitUsingDirective called with System.

VisitUsingDirective called with System.Collections.Generic.

VisitUsingDirective called with System.Linq.

VisitUsingDirective called with System.Text.

VisitUsingDirective called with Microsoft.CodeAnalysis.

Success. Adding Microsoft.CodeAnalysis.

VisitUsingDirective called with Microsoft.CodeAnalysis.CSharp.

Success. Adding Microsoft.CodeAnalysis.CSharp.

VisitUsingDirective called with Microsoft.

Success. Adding Microsoft.

VisitUsingDirective called with System.ComponentModel.

VisitUsingDirective called with Microsoft.Win32.

Success. Adding Microsoft.Win32.

VisitUsingDirective called with System.Runtime.InteropServices.

VisitUsingDirective called with System.CodeDom.

VisitUsingDirective called with Microsoft.CSharp.

Success. Adding Microsoft.CSharp.

Microsoft.CodeAnalysis

Microsoft.CodeAnalysis.CSharp

Microsoft

Microsoft.Win32

Microsoft.CSharp

Press any key to continue . . .

¡Enhorabuena! Ha usado la API de sintaxis para buscar tipos concretos de instrucciones

y declaraciones de C# en el código fuente de C#.
Introducción al análisis semántico
Artículo • 28/11/2022 • Tiempo de lectura: 9 minutos

En este tutorial, se asume que conoce la API de sintaxis. En el artículo Introducción al

análisis de sintaxis se proporciona una introducción suficiente.

En este tutorial, explorará las API de símbolo y enlace. Estas API ofrecen información
sobre el significado semántico de un programa. Le permiten formular y responder
preguntas sobre los tipos representados por cualquier símbolo en el programa.

Deberá instalar el SDK de .NET Compiler Platform:

Instrucciones de instalación: Instalador de

Visual Studio
Hay dos maneras distintas de buscar el SDK de .NET Compiler Platform en el Instalador
de Visual Studio:

Instalación con el Instalador de Visual Studio:

visualización de cargas de trabajo
El SDK de .NET Compiler Platform no se selecciona automáticamente como parte de la
carga de trabajo de desarrollo de extensiones de Visual Studio. Se debe seleccionar
como un componente opcional.

1. Ejecute el Instalador de Visual Studio.

2. Selección de Modificar
3. Active la carga de trabajo Desarrollo de extensiones de Visual Studio.
4. Abra el nodo Desarrollo de extensiones de Visual Studio en el árbol de resumen.
5. Active la casilla SDK de .NET Compiler Platform. La encontrará en última posición
bajo los componentes opcionales.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Abra el nodo Componentes individuales en el árbol de resumen.

2. Active la casilla Editor de DGML.

Instalación con el Instalador de Visual Studio: pestaña

Componentes individuales
 1. Ejecute el Instalador de Visual Studio.
2. Selección de Modificar
3. Haga clic en la pestaña Componentes individuales.
4. Active la casilla SDK de .NET Compiler Platform. La encontrará en la parte superior
bajo la sección Compiladores, herramientas de compilación y tiempos de
ejecución.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Active la casilla Editor de DGML. La encontrará en la sección Herramientas de

código.

Comprender las compilaciones y los símbolos

Conforme trabaja más con el SDK de .NET Compiler, empieza a familiarizarse con las
diferencias entre la API de sintaxis y la API semántica. La API de sintaxis le permite
buscar en la estructura de un programa. En cambio, a menudo quiere una información
más completa sobre la semántica o el significado de un programa. Aunque un
fragmento de código o archivo de código dinámico de Visual Basic o C# se puede
analizar sintácticamente de forma aislada, no tiene sentido formular preguntas como
"¿cuál es el tipo de esta variable?" de manera unilateral. El significado de un nombre de
tipo puede depender de las referencias de ensamblado, las importaciones de espacio de
nombres u otros archivos de código. Esas preguntas se responden mediante la API
semántica, concretamente la clase Microsoft.CodeAnalysis.Compilation.

Una instancia de Compilation es análoga a un único proyecto, tal como muestra el

compilador y representa todo lo necesario para compilar un programa de Visual Basic o
C#. La compilación incluye el conjunto de archivos de código fuente que se compilarán,
las referencias de ensamblado y las opciones del compilador. Puede analizar el
significado del código con toda la demás información en este contexto. Una
Compilation permite buscar símbolos (entidades como tipos, espacios de nombres,
miembros y variables a los que hacen referencia nombres y otras expresiones). El
proceso de asociar los nombres y las expresiones con símbolos se denomina enlace.

Como Microsoft.CodeAnalysis.SyntaxTree, Compilation es una clase abstracta con

derivados específicos del lenguaje. Al crear una instancia de la compilación, debe
invocar un método de generador en la clase
Microsoft.CodeAnalysis.CSharp.CSharpCompilation (o
Microsoft.CodeAnalysis.VisualBasic.VisualBasicCompilation).
Consultar símbolos
En este tutorial, volverá a examinar el programa "Hola mundo". En esta ocasión,
consultará los símbolos del programa para comprender qué tipos representan esos
símbolos. Consultará los tipos en un espacio de nombres y aprenderá a buscar los
métodos disponibles en un tipo.

Puede ver el código terminado de este ejemplo en nuestro repositorio de GitHub .

７ Nota

Los tipos de árbol de sintaxis usan la herencia para describir los diferentes
elementos de sintaxis que son válidos en diferentes ubicaciones del programa. A
menudo, usar estas API significa convertir propiedades o miembros de colección en
tipos derivados concretos. En los ejemplos siguientes, la asignación y las
conversiones son instrucciones independientes, con variables con tipo explícito.
Puede leer el código para ver los tipos de valor devuelto de la API y el tipo de
motor de ejecución de los objetos devueltos. En la práctica, es más habitual usar
variables con tipo implícito y basarse en nombres de API para describir el tipo de
los objetos que se examinan.

Cree un proyecto de Stand-Alone Code Analysis Tool (Herramienta de análisis de

código independiente) de C#:

En Visual Studio, elija Archivo>Nuevo>Proyecto para mostrar el cuadro de

diálogo Nuevo proyecto.
En Visual C#>Extensibilidad, elija Stand-Alone Code Analysis Tool (Herramienta
de análisis de código independiente).
Asigne al proyecto el nombre "SemanticQuickStart" y haga clic en Aceptar.

Va a analizar el programa básico "Hola mundo!" mostrado anteriormente.

Agregue el
texto para el programa Hola mundo como una constante en su clase Program :

C#

const string programText =

@"using System;

using System.Collections.Generic;
using System.Text;

namespace HelloWorld

class Program

 static void Main(string[] args)

Console.WriteLine(""Hello, World!"");

}";

A continuación, agregue el código siguiente para crear el árbol de sintaxis para el texto
del código de la constante programText . Agregue la línea siguiente al método Main :

C#

SyntaxTree tree = CSharpSyntaxTree.ParseText(programText);

CompilationUnitSyntax root = tree.GetCompilationUnitRoot();

A continuación, compile una CSharpCompilation del árbol que ya ha creado. El ejemplo

"Hola mundo" se basa en los tipos String y Console. Debe hacer referencia al
ensamblado que declara esos dos tipos en la compilación. Agregue la siguiente línea a
su método Main para crear una compilación de su árbol de sintaxis, incluida la
referencia al ensamblado adecuado:

C#

var compilation = CSharpCompilation.Create("HelloWorld")

.AddReferences(MetadataReference.CreateFromFile(

typeof(string).Assembly.Location))

.AddSyntaxTrees(tree);

El método CSharpCompilation.AddReferences agrega referencias a la compilación. El

método MetadataReference.CreateFromFile carga un ensamblado como referencia.

Consultar el modelo semántico

Una vez que tenga una Compilation, puede pedirle un SemanticModel para cualquier
SyntaxTree incluido en esa Compilation. Puede considerar el modelo semántico como el
origen de toda la información que normalmente obtendría de IntelliSense. Un
SemanticModel puede responder a preguntas como "¿Qué nombres entran en el
ámbito de esta ubicación?", "¿A qué miembros se puede acceder desde este método?",
"¿Qué variables se usan en este bloque de texto?" y "¿A qué hace referencia este
nombre o expresión?". Agregue esta instrucción para crear el modelo semántico:

C#
 SemanticModel model = compilation.GetSemanticModel(tree);

Enlazar un nombre
La Compilation crea el SemanticModel desde el SyntaxTree. Después de crear el modelo,
puede consultarlo para buscar la primera directiva using y recuperar la información de
símbolo del espacio de nombres System . Agregue estas dos líneas en su método Main
para crear el modelo semántico y recuperar el símbolo de la primera instrucción using:

C#

// Use the syntax tree to find "using System;"

UsingDirectiveSyntax usingSystem = root.Usings[0];

NameSyntax systemName = usingSystem.Name;

// Use the semantic model for symbol information:

SymbolInfo nameInfo = model.GetSymbolInfo(systemName);

En el código anterior se muestra cómo enlazar el nombre de la primera directiva de

using para recuperar un Microsoft.CodeAnalysis.SymbolInfo para el espacio de nombres

System . El código anterior también muestra que usa el modelo de sintaxis para buscar

la estructura del código y usa el modelo semántico para entender su significado. El

modelo de sintaxis busca la cadena System en la instrucción using. El modelo
semántico tiene toda la información sobre los tipos definidos en el espacio de nombres
System .

Desde el objeto SymbolInfo puede obtener el Microsoft.CodeAnalysis.ISymbol mediante

la propiedad SymbolInfo.Symbol. Esta propiedad devuelve el símbolo al que hace
referencia esta expresión. Para las expresiones que no hacen referencia a ningún
elemento (por ejemplo, los literales numéricos), esta propiedad es null . Cuando el
SymbolInfo.Symbol no es NULL, el ISymbol.Kind denota el tipo del símbolo. En este
ejemplo, la propiedad ISymbol.Kind es un SymbolKind.Namespace. Agregue el código
siguiente al método Main . Recupera el símbolo del espacio de nombres System y,
después, muestra todos los espacios de nombres secundarios que se declaran en el
espacio de nombres System :

C#

var systemSymbol = (INamespaceSymbol)nameInfo.Symbol;

foreach (INamespaceSymbol ns in systemSymbol.GetNamespaceMembers())

 Console.WriteLine(ns);

Ejecute el programa y debería ver la siguiente salida:

Resultados

System.Collections

System.Configuration

System.Deployment

System.Diagnostics

System.Globalization

System.IO

System.Numerics

System.Reflection

System.Resources

System.Runtime

System.Security

System.StubHelpers

System.Text

System.Threading

Press any key to continue . . .

７ Nota

La salida no incluye todos los espacios de nombres que son secundarios del
espacio de nombres System . Muestra cada espacio de nombres que se encuentra
en esta compilación, que solo hace referencia al ensamblado donde se declara
System.String . Esta compilación no conoce ningún espacio de nombres declarado
en otros ensamblados.

Enlazar una expresión

El código anterior muestra cómo buscar un símbolo al enlazarlo a un nombre. Hay otras
expresiones en un programa de C# que se pueden enlazar que no son nombres. Para
demostrar esta funcionalidad, accederemos al enlace a un literal de cadena sencillo.

El programa "Hola mundo" contiene una

Microsoft.CodeAnalysis.CSharp.Syntax.LiteralExpressionSyntax, la cadena "Hola,
¡mundo!" que se muestra en la consola.

Para encontrar la cadena "Hola, ¡mundo!", busque el literal de cadena único en el

programa. A continuación, una vez que haya encontrado el nodo de sintaxis, obtenga la
información de tipo de ese nodo del modelo semántico. Agregue el código siguiente al
método Main :

C#

// Use the syntax model to find the literal string:

LiteralExpressionSyntax helloWorldString = root.DescendantNodes()

.OfType<LiteralExpressionSyntax>()

.Single();

// Use the semantic model for type information:

TypeInfo literalInfo = model.GetTypeInfo(helloWorldString);

La estructura Microsoft.CodeAnalysis.TypeInfo incluye una propiedad TypeInfo.Type que

permite el acceso a la información semántica sobre el tipo del literal. En este ejemplo, es
el tipo string . Agregue una declaración que asigne esta propiedad a una variable local:

C#

var stringTypeSymbol = (INamedTypeSymbol)literalInfo.Type;

Para finalizar este tutorial, crearemos una consulta LINQ que crea una secuencia de
todos los métodos públicos declarados en el tipo string que devuelven una string .
Esta consulta es más compleja, así que la compilaremos línea a línea y, después, la
volveremos a construir como una única consulta. El origen de esta consulta es la
secuencia de todos los miembros declarados en el tipo string :

C#

var allMembers = stringTypeSymbol.GetMembers();

Esa secuencia de origen contiene todos los miembros, incluidas las propiedades y los
campos, de modo que tiene que filtrarlos con el método ImmutableArray<T>.OfType
para buscar los elementos que son objetos Microsoft.CodeAnalysis.IMethodSymbol:

C#

var methods = allMembers.OfType<IMethodSymbol>();

A continuación, agregue otro filtro para devolver solo aquellos métodos que son
públicos y devuelven una string :

C#
 var publicStringReturningMethods = methods

.Where(m => m.ReturnType.Equals(stringTypeSymbol) &&

m.DeclaredAccessibility == Accessibility.Public);

Seleccione solo la propiedad name y solo los nombres distintos; para ello, elimine las
sobrecargas:

C#

var distinctMethods = publicStringReturningMethods.Select(m =>

m.Name).Distinct();

También puede compilar la consulta completa con la sintaxis de consulta LINQ y,

después, mostrar todos los nombres de método en la consola:

C#

foreach (string name in (from method in stringTypeSymbol

.GetMembers().OfType<IMethodSymbol>()

where method.ReturnType.Equals(stringTypeSymbol) &&

method.DeclaredAccessibility ==
Accessibility.Public

select method.Name).Distinct())

Console.WriteLine(name);

Compile y ejecute el programa. Debería aparecer la siguiente salida:

Resultados

Join

Substring

Trim

TrimStart

TrimEnd

Normalize

PadLeft

PadRight

ToLower

ToLowerInvariant

ToUpper

ToUpperInvariant

ToString

Insert

Replace

Remove

Format

Copy

 Concat

Intern

IsInterned

Press any key to continue . . .

Ha usado la API semántica para buscar y mostrar información sobre los símbolos que
forman parte de este programa.
Introducción a la transformación de
sintaxis
Artículo • 15/02/2023 • Tiempo de lectura: 13 minutos

Este tutorial se basa en conceptos y técnicas explorados en los tutoriales rápidos

Introducción al análisis de sintaxis e Introducción al análisis semántico. Si aún no lo ha
hecho, debería completar esos tutoriales antes de comenzar con este.

En este tutorial rápido, se exploran las técnicas para crear y transformar árboles de
sintaxis. En combinación con las técnicas que aprendió en los tutoriales anteriores,
podrá crear la primera refactorización de línea de comandos.

Instrucciones de instalación: Instalador de

Visual Studio
Hay dos maneras distintas de buscar el SDK de .NET Compiler Platform en el Instalador
de Visual Studio:

Instalación con el Instalador de Visual Studio:

visualización de cargas de trabajo
El SDK de .NET Compiler Platform no se selecciona automáticamente como parte de la
carga de trabajo de desarrollo de extensiones de Visual Studio. Se debe seleccionar
como un componente opcional.

1. Ejecute el Instalador de Visual Studio.

2. Selección de Modificar
3. Active la carga de trabajo Desarrollo de extensiones de Visual Studio.
4. Abra el nodo Desarrollo de extensiones de Visual Studio en el árbol de resumen.
5. Active la casilla SDK de .NET Compiler Platform. La encontrará en última posición
bajo los componentes opcionales.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Abra el nodo Componentes individuales en el árbol de resumen.

2. Active la casilla Editor de DGML.
Instalación con el Instalador de Visual Studio: pestaña
Componentes individuales
1. Ejecute el Instalador de Visual Studio.
2. Selección de Modificar
3. Haga clic en la pestaña Componentes individuales.
4. Active la casilla SDK de .NET Compiler Platform. La encontrará en la parte superior
bajo la sección Compiladores, herramientas de compilación y tiempos de
ejecución.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Active la casilla Editor de DGML. La encontrará en la sección Herramientas de

código.

Inmutabilidad y .NET Compiler Platform

La inmutabilidad es un principio fundamental de .NET Compiler Platform. Las
estructuras de datos inmutables no se pueden cambiar una vez creadas. Las estructuras
de datos inmutables se pueden compartir y someter al análisis de varios consumidores
al mismo tiempo sin riesgo alguno. No se corre el peligro de que la acción de un
consumidor afecte a otro de manera impredecible. El analizador no necesita bloqueos u
otras medidas de simultaneidad. Esta regla se aplica a los árboles de sintaxis, las
compilaciones, los símbolos, los modelos semánticos y cualquier otra estructura de
datos que encuentre. En lugar de modificar las estructuras existentes, las API crean
nuevos objetos según las diferencias especificadas en los antiguos. Este concepto se
aplica a los árboles de sintaxis para crear nuevos árboles que usan transformaciones.

Creación y transformación de árboles

Elija una de las dos estrategias para las transformaciones de sintaxis. Los patrones de
diseño Factory Method son útiles cuando se buscan nodos específicos para reemplazar,
o ubicaciones específicas donde desea insertar el nuevo código. Las reescrituras son la
mejor opción si desea buscar patrones de código que se van a reemplazar en todo un
proyecto.

Creación de nodos con patrones de diseño Factory

Method
En la primera transformación de sintaxis se muestran los patrones de diseño Factory
Method. Va a reemplazar una instrucción using System.Collections; por una
instrucción using System.Collections.Generic; . En este ejemplo se muestra cómo crear
objetos Microsoft.CodeAnalysis.CSharp.CSharpSyntaxNode mediante los patrones de
diseño Factory Method Microsoft.CodeAnalysis.CSharp.SyntaxFactory. Para cada tipo de
nodo, token o curiosidades hay un patrón Factory Method que crea una instancia de
ese tipo. Creará árboles de sintaxis mediante la composición de nodos jerárquicamente
de abajo arriba. A continuación, transformará el programa existente reemplazando los
nodos existentes por el nuevo árbol que ha creado.

Inicie Visual Studio y cree un proyecto de Stand-Alone Code Analysis Tool (Herramienta
de análisis de código independiente) de C#. En Visual Studio, elija
Archivo>Nuevo>Proyecto para mostrar el cuadro de diálogo Nuevo proyecto. En Visual
C#>Extensibilidad, elija Stand-Alone Code Analysis Tool (Herramienta de análisis de
código independiente). Este tutorial rápido tiene dos proyectos de ejemplo, así que
llame a la solución SyntaxTransformationQuickStart y al proyecto ConstructionCS.
Haga clic en Aceptar.

Este proyecto usa los métodos de clase Microsoft.CodeAnalysis.CSharp.SyntaxFactory

para construir un Microsoft.CodeAnalysis.CSharp.Syntax.NameSyntax que representa el
espacio de nombres System.Collections.Generic .

Agregue esta directiva a la parte superior de Program.cs .

C#

using static Microsoft.CodeAnalysis.CSharp.SyntaxFactory;

using static System.Console;

Creará nodos de sintaxis de nombre para generar el árbol que representa la instrucción
using System.Collections.Generic; . NameSyntax es la clase base para los cuatro tipos

de nombres que aparecen en C#. Junte estos cuatro tipos de nombres para crear
cualquier nombre que pueda aparecer en el lenguaje C#:

Microsoft.CodeAnalysis.CSharp.Syntax.NameSyntax, que representa los nombres

de identificador único simple, como System y Microsoft .
Microsoft.CodeAnalysis.CSharp.Syntax.GenericNameSyntax, que representa un
nombre de tipo o método genérico, como List<int> .
Microsoft.CodeAnalysis.CSharp.Syntax.QualifiedNameSyntax, que representa un
nombre completo del formulario <left-name>.<right-identifier-or-generic-
name> , como System.IO .
 Microsoft.CodeAnalysis.CSharp.Syntax.AliasQualifiedNameSyntax, que representa
un nombre que usa un alias de ensamblado externo, como LibraryV2::Foo .

Use el método IdentifierName(String) para crear un nodo NameSyntax. Agregue el

código siguiente al método Main en Program.cs :

C#

NameSyntax name = IdentifierName("System");

WriteLine($"\tCreated the identifier {name}");

El código anterior crea un objeto IdentifierNameSyntax y lo asigna a la variable name .

Muchas de las API de Roslyn devuelven clases base para que sea más fácil trabajar con
tipos relacionados. La variable name , NameSyntax, puede volver a usarse al crear
QualifiedNameSyntax. No use la inferencia de tipo al crear el ejemplo. Podrá
automatizar ese paso en este proyecto.

Ha creado el nombre. Ahora, es el momento de crear más nodos en el árbol mediante la

creación de QualifiedNameSyntax. El nuevo árbol usa name como parte izquierda del
nombre, y un nuevo IdentifierNameSyntax para el espacio de nombres Collections
como parte derecha de QualifiedNameSyntax. Agrega el código siguiente a program.cs :

C#

name = QualifiedName(name, IdentifierName("Collections"));

WriteLine(name.ToString());

Vuelva a ejecutar el código y observe los resultados. Está creando un árbol de nodos
que representa código. Continuará con este patrón para compilar QualifiedNameSyntax
para el espacio de nombres System.Collections.Generic . Agrega el código siguiente a
Program.cs :

C#

name = QualifiedName(name, IdentifierName("Generic"));

WriteLine(name.ToString());

Ejecute el programa de nuevo para ver si ha creado el árbol para agregar el código.

Creación de un árbol modificado

Ha creado un pequeño árbol de sintaxis que contiene una instrucción. Las API para crear
nuevos nodos son la opción correcta para crear instrucciones únicas u otros bloques de
código pequeño. Sin embargo, para generar bloques más grandes de código, debe usar
los métodos que reemplazan nodos o insertan nodos en un árbol existente. Recuerde
que los árboles de sintaxis son inmutables. La API de sintaxis no proporciona ningún
mecanismo para modificar un árbol de sintaxis existente después de la construcción. En
su lugar, proporciona métodos que generan nuevos árboles en función de los cambios
en los existentes. Se han definido métodos With* en clases concretas que se derivan de
SyntaxNode o en métodos de extensión declarados en la clase SyntaxNodeExtensions.
Estos métodos crean un nuevo nodo al aplicar cambios a las propiedades del elemento
secundario de un nodo existente. Además, el método de extensión ReplaceNode se
puede utilizar para reemplazar un nodo descendiente en un subárbol. Este método
también actualiza el elemento primario para que apunte al formulario secundario recién
creado y repite este proceso por todo el árbol: un proceso conocido como volver a
hacer girar el árbol.

El siguiente paso consiste en crear un árbol que representa todo un programa

(pequeño) y, a continuación, modificarlo. Agregue el siguiente código al principio de la
clase Program :

C#

private const string sampleCode =

@"using System;

using System.Collections;

using System.Linq;

using System.Text;

namespace HelloWorld

class Program

static void Main(string[] args)

Console.WriteLine(""Hello, World!"");

}";

７ Nota

El código de ejemplo utiliza el espacio de nombres System.Collections y no el

espacio de nombres System.Collections.Generic .
A continuación, agregue el código siguiente a la parte inferior del método Main para
analizar el texto y crear un árbol:

C#

SyntaxTree tree = CSharpSyntaxTree.ParseText(sampleCode);

var root = (CompilationUnitSyntax)tree.GetRoot();

En este ejemplo se utiliza el método WithName(NameSyntax) para reemplazar el

nombre de un nodo UsingDirectiveSyntax por el que se creó en el código anterior.

Cree un nuevo nodo UsingDirectiveSyntax mediante el método WithName(NameSyntax)

para actualizar el nombre System.Collections con el nombre que creó en el código
anterior. Agregue el siguiente código en la parte inferior del método Main :

C#

var oldUsing = root.Usings[1];

var newUsing = oldUsing.WithName(name);

WriteLine(root.ToString());

Ejecute el programa y observe con detenimiento el resultado. newUsing todavía no se ha

colocado en el árbol de la raíz. No se ha modificado el árbol original.

Agregue el siguiente código utilizando el método de extensión ReplaceNode para crear

un nuevo árbol. El nuevo árbol es el resultado de reemplazar la importación existente
por el nodo newUsing actualizado. Asigne este nuevo árbol a la variable root existente:

C#

root = root.ReplaceNode(oldUsing, newUsing);

WriteLine(root.ToString());

Ejecute el programa otra vez. Esta vez el árbol importa correctamente el espacio de
nombres System.Collections.Generic .

Transformación de árboles mediante SyntaxRewriters

Los métodos With* y ReplaceNode proporcionan un medio cómodo para transformar
ramas individuales de un árbol de sintaxis. La clase
Microsoft.CodeAnalysis.CSharp.CSharpSyntaxRewriter realiza varias transformaciones en
un árbol de sintaxis. La clase Microsoft.CodeAnalysis.CSharp.CSharpSyntaxRewriter es
una subclase de Microsoft.CodeAnalysis.CSharp.CSharpSyntaxVisitor<TResult>.
CSharpSyntaxRewriter aplica una transformación a un tipo específico de SyntaxNode.
Puede aplicar transformaciones a varios tipos de objetos SyntaxNode dondequiera que
aparezcan en un árbol de sintaxis. En el segundo proyecto de este tutorial rápido se crea
una refactorización de línea de comandos que quita tipos explícitos en declaraciones de
variable local en cualquier lugar en que pudiera utilizarse una inferencia de tipos.

Cree un proyecto de Stand-Alone Code Analysis Tool (Herramienta de análisis de

código independiente) de C#. En Visual Studio, haga clic en el nodo de la solución
SyntaxTransformationQuickStart . Elija Agregar>Nuevo proyecto para mostrar el cuadro

de diálogo Nuevo proyecto. En Visual C#>Extensibilidad, elija Stand-Alone Code

Analysis Tool (Herramienta de análisis de código independiente). Proporcione un
nombre al proyecto TransformationCS y haga clic en Aceptar.

El primer paso es crear una clase que se derive de CSharpSyntaxRewriter para realizar las
transformaciones. Agregue un nuevo archivo de clase al proyecto. En Visual Studio, elija
Proyecto>Agregar clase... . En el cuadro de diálogo Agregar nuevo elemento, escriba
TypeInferenceRewriter.cs como nombre de archivo.

Agregue las siguientes directivas using al archivo TypeInferenceRewriter.cs :

C#

using Microsoft.CodeAnalysis;

using Microsoft.CodeAnalysis.CSharp;

using Microsoft.CodeAnalysis.CSharp.Syntax;

A continuación, haga que la clase TypeInferenceRewriter se extienda a la clase

CSharpSyntaxRewriter:

C#

public class TypeInferenceRewriter : CSharpSyntaxRewriter

Agregue el código siguiente para declarar un campo privado de solo lectura para que
contenga un SemanticModel e inicializarlo en el constructor. Necesitará este campo más
adelante para determinar donde se puede usar la inferencia de tipos:

C#

private readonly SemanticModel SemanticModel;

public TypeInferenceRewriter(SemanticModel semanticModel) => SemanticModel =

semanticModel;

Invalide el método VisitLocalDeclarationStatement(LocalDeclarationStatementSyntax):

C#

public override SyntaxNode

VisitLocalDeclarationStatement(LocalDeclarationStatementSyntax node)

７ Nota

Muchas de las API de Roslyn declaran tipos de valor devuelto que son clases base
de los tipos en tiempo de ejecución reales devueltos. En muchos escenarios, un
tipo de nodo puede reemplazarse por otro tipo de nodo por completo, e incluso
eliminarse. En este ejemplo, el método
VisitLocalDeclarationStatement(LocalDeclarationStatementSyntax) devuelve un
SyntaxNode, en vez del tipo derivado de LocalDeclarationStatementSyntax. Este
sistema de reescritura devuelve un nuevo nodo LocalDeclarationStatementSyntax
basado en el existente.

Este tutorial rápido controla las declaraciones de variable locales. Puede ampliarlo para
otras declaraciones como bucles foreach , bucles for , expresiones LINQ y expresiones
lambda. Además, este sistema de reescritura transformará solo las declaraciones de la
forma más sencilla:

C#

Type variable = expression;

Si desea explorar por su cuenta, considere la posibilidad de extender el ejemplo

finalizado para estos tipos de declaraciones de variable:

C#

// Multiple variables in a single declaration.

Type variable1 = expression1,

variable2 = expression2;

// No initializer.

Type variable;

Agregue el código siguiente al cuerpo del método VisitLocalDeclarationStatement

para que omita la reescritura de estas formas de declaraciones:
 C#

if (node.Declaration.Variables.Count > 1)

return node;

if (node.Declaration.Variables[0].Initializer == null)

return node;

El método indica que no se realiza la reescritura mediante la devolución del parámetro

node sin modificar. Si ninguna de esas expresiones if son verdaderas, el nodo

representa una declaración posible con la inicialización. Agregue estas instrucciones

para extraer el nombre del tipo especificado en la declaración y asócielo con el campo
SemanticModel para obtener un símbolo de tipo:

C#

var declarator = node.Declaration.Variables.First();

var variableTypeName = node.Declaration.Type;

var variableType = (ITypeSymbol)SemanticModel

.GetSymbolInfo(variableTypeName)

.Symbol;

Ahora, agregue esta instrucción para enlazar la expresión de inicializador:

C#

var initializerInfo =
SemanticModel.GetTypeInfo(declarator.Initializer.Value);

Por último, agregue la siguiente instrucción if para reemplazar el nombre de tipo

existente por la palabra clave var si el tipo de la expresión de inicializador coincide con
el tipo especificado:

C#

if (SymbolEqualityComparer.Default.Equals(variableType,
initializerInfo.Type))

TypeSyntax varTypeName = SyntaxFactory.IdentifierName("var")

.WithLeadingTrivia(variableTypeName.GetLeadingTrivia())

.WithTrailingTrivia(variableTypeName.GetTrailingTrivia());

return node.ReplaceNode(variableTypeName, varTypeName);

else

return node;

El atributo condicional es necesario porque la declaración puede convertir la expresión

de inicializador en una interfaz o clase base. Si se desea, los tipos del lado izquierdo y
derecho de la asignación no coinciden. El hecho de quitar el tipo explícito en estos
casos también cambiaría la semántica de un programa. var se especifica como un
identificador en lugar de una palabra clave porque var es una palabra clave contextual.
Las curiosidades iniciales y finales (espacios en blanco) se transfieren desde el nombre
de tipo anterior a la palabra clave var para mantener el espacio en blanco vertical y la
sangría. Es más fácil utilizar ReplaceNode en lugar de With* para transformar el
LocalDeclarationStatementSyntax porque el nombre de tipo es realmente el
descendiente del elemento secundario de la instrucción de declaración.

Ha terminado el TypeInferenceRewriter . Ahora vuelva a su archivo Program.cs para

finalizar el ejemplo. Cree una prueba Compilation y obtenga SemanticModel de ella. Use
ese SemanticModel para probar su TypeInferenceRewriter . Llevará a cabo este último
paso. Mientras tanto, declare una variable de marcador de posición que represente la
compilación de prueba:

C#

Compilation test = CreateTestCompilation();

Después de un momento de pausa, debería aparecer un subrayado ondulado de error

que indica que no existe ningún método CreateTestCompilation . Presione CTRL+Punto
para abrir la bombilla y, a continuación, presione Entrar para invocar el comando
Generar código auxiliar del método. Este comando generará un código auxiliar para el
método CreateTestCompilation en la clase Program . Podrá volver a rellenar este método
más adelante:
Escriba el código siguiente para recorrer en iteración cada SyntaxTree en la prueba
Compilation. Para cada una de ellas, inicialice un nuevo TypeInferenceRewriter con el
SemanticModel para ese árbol:

C#

foreach (SyntaxTree sourceTree in test.SyntaxTrees)

SemanticModel model = test.GetSemanticModel(sourceTree);

TypeInferenceRewriter rewriter = new TypeInferenceRewriter(model);

SyntaxNode newSource = rewriter.Visit(sourceTree.GetRoot());

if (newSource != sourceTree.GetRoot())

File.WriteAllText(sourceTree.FilePath, newSource.ToFullString());

Dentro de la instrucción foreach que ha creado, agregue el código siguiente para

realizar la transformación en cada árbol de origen. Este código escribe
condicionalmente el nuevo árbol transformado si se hicieron modificaciones. El sistema
de reescritura sólo debe modificar un árbol si encuentra una o más declaraciones de
variables locales que pudieron simplificarse mediante la inferencia de tipos:

C#

SyntaxNode newSource = rewriter.Visit(sourceTree.GetRoot());

if (newSource != sourceTree.GetRoot())

File.WriteAllText(sourceTree.FilePath, newSource.ToFullString());

Debería ver los subrayados ondulados bajo el código File.WriteAllText . Seleccione la

bombilla y agregue la instrucción using System.IO; necesaria.

Casi ha terminado. Queda un último paso: crear una prueba Compilation. Puesto que no
ha utilizado ninguna inferencia de tipos durante este tutorial rápido, habría sido un caso
de prueba perfecto. Desafortunadamente, la creación de una compilación desde un
archivo de proyecto de C# queda fuera del ámbito de este tutorial. Pero
afortunadamente, si ha seguido las instrucciones con cuidado, hay esperanza.
Reemplace el contenido del método CreateTestCompilation con el código siguiente.
Crea una compilación de prueba que casualmente coincide con el proyecto descrito en
este tutorial rápido:

C#

String programPath = @"..\..\..\Program.cs";

String programText = File.ReadAllText(programPath);

SyntaxTree programTree =

CSharpSyntaxTree.ParseText(programText)

.WithFilePath(programPath);

String rewriterPath = @"..\..\..\TypeInferenceRewriter.cs";

String rewriterText = File.ReadAllText(rewriterPath);

SyntaxTree rewriterTree =

CSharpSyntaxTree.ParseText(rewriterText)

.WithFilePath(rewriterPath);

SyntaxTree[] sourceTrees = { programTree, rewriterTree };

MetadataReference mscorlib =

MetadataReference.CreateFromFile(typeof(object).Assembly.Location);

MetadataReference codeAnalysis =

MetadataReference.CreateFromFile(typeof(SyntaxTree).Assembly.Location);

MetadataReference csharpCodeAnalysis =

MetadataReference.CreateFromFile(typeof(CSharpSyntaxTree).Assembly.Location)
;

MetadataReference[] references = { mscorlib, codeAnalysis,

csharpCodeAnalysis };

return CSharpCompilation.Create("TransformationCS",

sourceTrees,

references,

new CSharpCompilationOptions(OutputKind.ConsoleApplication));

Cruce los dedos y ejecute el proyecto. En Visual Studio, elija Depurar>Iniciar

depuración. Visual Studio le debería notificar que los archivos de su proyecto han
cambiado. Haga clic en "Sí a todo" para volver a cargar los archivos modificados.
Examínelos para observar su genialidad. Observe que el código se ve mucho más limpio
sin todos los especificadores de tipo explícitos y redundantes.

¡Enhorabuena! Ha usado las API de compilador para escribir su propia refactorización

que busca en todos los archivos de un proyecto C# ciertos patrones sintácticos, analiza
la semántica del código fuente que coincide con esos patrones y la transforma. ¡Ya es
oficialmente un autor de refactorización!
Tutorial: Crear el primer analizador y la
corrección de código
Artículo • 28/11/2022 • Tiempo de lectura: 26 minutos

El SDK de .NET Compiler Platform proporciona las herramientas que necesita para crear
diagnósticos personalizados (analizadores), correcciones de código, refactorización de
código y supresores de diagnóstico que tengan como destino código de C# o
Visual Basic. Un analizador contiene código que reconoce las infracciones de la regla. La
corrección del código contiene el código que corrige la infracción. Las reglas
implementadas pueden ser cualquier elemento de la estructura de código para codificar
el estilo de las convenciones de nomenclatura y mucho más. .NET Compiler Platform
proporciona el marco para ejecutar el análisis a medida que los desarrolladores escriben
código y todas las características de la interfaz de usuario de Visual Studio para corregir
código: mostrar líneas de subrayado en el editor, rellenar la lista de errores de Visual
Studio, crear las sugerencias con "bombillas" y mostrar la vista previa enriquecida de las
correcciones sugeridas.

En este tutorial, explorará la creación de un analizador y una corrección de código

complementaria con el uso de las API de Roslyn. Un analizador es una manera de
realizar análisis de código fuente y notificar un problema al usuario. Opcionalmente, se
puede asociar una corrección de código al analizador para representar una modificación
en el código fuente del usuario. Este tutorial crea un analizador que busca declaraciones
de variable local que podrían declararse mediante el modificador const , aunque no
están. La corrección de código complementaria modifica esas declaraciones para
agregar el modificador const .

Requisitos previos
Visual Studio 2019 , versión 16.8 o posterior

Debe instalar el SDK de .NET Compiler Platform a través del Instalador de Visual Studio:

Instrucciones de instalación: Instalador de

Visual Studio
Hay dos maneras distintas de buscar el SDK de .NET Compiler Platform en el Instalador
de Visual Studio:
Instalación con el Instalador de Visual Studio:
visualización de cargas de trabajo
El SDK de .NET Compiler Platform no se selecciona automáticamente como parte de la
carga de trabajo de desarrollo de extensiones de Visual Studio. Se debe seleccionar
como un componente opcional.

1. Ejecute el Instalador de Visual Studio.

2. Selección de Modificar
3. Active la carga de trabajo Desarrollo de extensiones de Visual Studio.
4. Abra el nodo Desarrollo de extensiones de Visual Studio en el árbol de resumen.
5. Active la casilla SDK de .NET Compiler Platform. La encontrará en última posición
bajo los componentes opcionales.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Abra el nodo Componentes individuales en el árbol de resumen.

2. Active la casilla Editor de DGML.

Instalación con el Instalador de Visual Studio: pestaña

Componentes individuales
1. Ejecute el Instalador de Visual Studio.
2. Selección de Modificar
3. Haga clic en la pestaña Componentes individuales.
4. Active la casilla SDK de .NET Compiler Platform. La encontrará en la parte superior
bajo la sección Compiladores, herramientas de compilación y tiempos de
ejecución.

Opcionalmente, también le interesará que el Editor de DGML muestre los gráficos en el

visualizador:

1. Active la casilla Editor de DGML. La encontrará en la sección Herramientas de

código.

Hay varios pasos para crear y validar su analizador:

1. Crear la solución.
2. Registrar el nombre del analizador y la descripción.
3. Notificar las recomendaciones y las advertencias del analizador.
4. Implementar la corrección de código para aceptar las recomendaciones.
5. Mejorar el análisis mediante las pruebas unitarias.
Creación de la solución
En Visual Studio, elija Archivo > Nuevo > Proyecto... para mostrar el cuadro de
diálogo Nuevo proyecto.
En Visual C# > Extensibilidad, elija Analizador con corrección de código (.NET
Standard).
Asigne al proyecto el nombre "MakeConst" y haga clic en Aceptar.

７ Nota

Puede obtener un error de compilación (MSB4062: No se pudo cargar la tarea

"CompareBuildTaskVersion"). Para corregirlo, actualice los paquetes NuGet de la
solución con el Administrador de paquetes NuGet o use Update-Package en la
ventana Consola del administrador de paquetes.

Exploración de la plantilla del analizador

La plantilla de analizador con corrección de código crea cinco proyectos:

MakeConst, que contiene el analizador.

MakeConst.CodeFixes, que contiene la corrección del código.
MakeConst.Package, que se usa a fin de generar el paquete NuGet para el
analizador y la corrección de código.
MakeConst.Test, que es un proyecto de prueba unitaria.
MakeConst.Vsix, que es el proyecto de inicio predeterminado que inicia una
segunda instancia de Visual Studio que ha cargado el nuevo analizador. Presione
F5 para iniciar el proyecto de VSIX.

７ Nota

Los analizadores deben tener como destino .NET Standard 2.0 porque se pueden

ejecutar en el entorno de .NET Core (compilaciones de línea de comandos) y el de
.NET Framework (Visual Studio).

 Sugerencia

Al ejecutar el analizador, inicie una segunda copia de Visual Studio. Esta segunda
copia usa un subárbol del registro diferente para almacenar la configuración. Le
permite diferenciar la configuración visual en las dos copias de Visual Studio. Puede
 elegir un tema diferente para la ejecución experimental de Visual Studio. Además,
no mueva la configuración o el inicio de sesión a la cuenta de Visual Studio con la
ejecución experimental de Visual Studio. Así se mantiene una configuración
diferente.

El subárbol incluye no solo el analizador en desarrollo, sino también los

analizadores anteriores abiertos. Para restablecer el subárbol Roslyn, debe
eliminarlo manualmente de %LocalAppData%\Microsoft\VisualStudio. El nombre de
carpeta del subárbol Roslyn terminará en Roslyn ; por ejemplo,
16.0_9ae182f9Roslyn . Tenga en cuenta que es posible que tenga que limpiar la
solución y volver a generarla después de eliminar el subárbol.

En la segunda instancia de Visual Studio que acaba de iniciar, cree un proyecto de

aplicación de consola de C# (servirá cualquier marco; los analizadores funcionan en el
nivel de origen). Mantenga el mouse sobre el token con un subrayado ondulado y
aparecerá el texto de advertencia proporcionado por un analizador.

La plantilla crea un analizador que notifica una advertencia en cada declaración de tipo,
donde el nombre de tipo contiene letras minúsculas, tal como se muestra en la
ilustración siguiente:

La plantilla también proporciona una corrección de código que cambia cualquier

nombre de tipo que contiene caracteres en minúsculas a mayúsculas. Puede hacer clic
en la bombilla mostrada con la advertencia para ver los cambios sugeridos. Al aceptar
los cambios sugeridos, se actualizan el nombre de tipo y todas las referencias a dicho
tipo en la solución. Ahora que ha visto el analizador inicial en acción, cierre la segunda
instancia de Visual Studio y vuelva a su proyecto de analizador.

No tiene que iniciar una segunda copia de Visual Studio, y cree código para probar
todos los cambios en el analizador. La plantilla también crea un proyecto de prueba
unitaria de forma automática. Este proyecto contiene dos pruebas. TestMethod1 muestra
el formato típico de una prueba que analiza el código sin que se desencadene un
diagnóstico. TestMethod2 muestra el formato de una prueba que desencadena un
diagnóstico y, a continuación, se aplica una corrección de código sugerida. Al crear el
analizador y la corrección de código, deberá escribir pruebas para diferentes estructuras
de código para verificar el trabajo. Las pruebas unitarias de los analizadores son mucho
más rápidas que las pruebas interactivas con Visual Studio.

 Sugerencia

Las pruebas unitarias del analizador son una herramienta magnífica si se sabe qué
construcciones de código deben y no deben desencadenar el analizador. Cargar el
analizador en otra copia de Visual Studio es una herramienta magnífica para
explorar y buscar construcciones en las que puede no haber pensado todavía.

En este tutorial, se escribe un analizador que notifica al usuario las declaraciones de

variables locales que se pueden convertir en constantes locales. Por ejemplo, considere
el siguiente código:

C#

int x = 0;

Console.WriteLine(x);

En el código anterior, a x se le asigna un valor constante y nunca se modifica. Se puede

declarar con el modificador const :

C#

const int x = 0;

Console.WriteLine(x);

El análisis para determinar si una variable se puede convertir en constante, que requiere
un análisis sintáctico, un análisis constante de la expresión del inicializador y un análisis
del flujo de datos para garantizar que no se escriba nunca en la variable. .NET Compiler
Platform proporciona las API que facilita la realización de este análisis.

Creación de registros del analizador

La plantilla crea la clase DiagnosticAnalyzer inicial en el archivo MakeConstAnalyzer.cs.
Este analizador inicial muestra dos propiedades importantes de cada analizador.
 Cada analizador de diagnóstico debe proporcionar un atributo
[DiagnosticAnalyzer] que describe el lenguaje en el que opera.
Cada analizador de diagnóstico debe derivar (directa o indirectamente) de la clase
DiagnosticAnalyzer.

La plantilla también muestra las características básicas que forman parte de cualquier
analizador:

1. Registre acciones. Las acciones representan los cambios de código que deben
desencadenar el analizador para examinar el código para las infracciones. Cuando
Visual Studio detecta las modificaciones del código que coinciden con una acción
registrada, llama al método registrado del analizador.
2. Cree diagnósticos. Cuando el analizador detecta una infracción, crea un objeto de
diagnóstico que Visual Studio usa para notificar la infracción al usuario.

Registre acciones en la invalidación del método

DiagnosticAnalyzer.Initialize(AnalysisContext). En este tutorial, repasará nodos de
sintaxis que buscan declaraciones locales y verá cuáles de ellos tienen valores
constantes. Si una declaración puede ser constante, el analizador creará y notificará un
diagnóstico.

El primer paso es actualizar las constantes de registro y el método Initialize , por lo

que estas constantes indican su analizador "Make Const". La mayoría de las constantes
de cadena se definen en el archivo de recursos de cadena. Debe seguir dicha práctica
para una localización más sencilla. Abra el archivo Resources.resx para el proyecto de
analizador MakeConst. Muestra el editor de recursos. Actualice los recursos de cadena
como sigue:

Cambie AnalyzerDescription a "Variables that are not modified should be made

constants.".
Cambie AnalyzerMessageFormat a "Variable '{0}' can be made constant".
Cambie AnalyzerTitle a "Variable can be made constant".

Cuando haya terminado, el editor de recursos debe aparecer tal y como se muestra en
la ilustración siguiente:

Los cambios restantes están en el archivo del analizador. Abra MakeConstAnalyzer.cs en

Visual Studio. Cambie la acción registrada de una que actúa en los símbolos a una que
actúa en la sintaxis. En el método MakeConstAnalyzerAnalyzer.Initialize , busque la
línea que registra la acción en los símbolos:

C#

context.RegisterSymbolAction(AnalyzeSymbol, SymbolKind.NamedType);

Reemplácela por la línea siguiente:

C#

context.RegisterSyntaxNodeAction(AnalyzeNode,
SyntaxKind.LocalDeclarationStatement);

Después de este cambio, puede eliminar el método AnalyzeSymbol . Este analizador

examina SyntaxKind.LocalDeclarationStatement, no las instrucciones
SymbolKind.NamedType. Tenga en cuenta que AnalyzeNode tiene un subrayado
ondulado rojo debajo. El código recién agregado hace referencia a un método
AnalyzeNode que no se ha declarado. Declare dicho método con el siguiente código:

C#

private void AnalyzeNode(SyntaxNodeAnalysisContext context)

Cambie Category a "Usage" en MakeConstAnalyzer.cs, como se muestra en el código

siguiente:

C#

private const string Category = "Usage";

Búsqueda de las declaraciones locales que

podrían ser constantes
Es el momento de escribir la primera versión del método AnalyzeNode . Debe buscar una
sola declaración local que podría ser const pero no lo es, al igual que el código
siguiente:

C#
 int x = 0;

Console.WriteLine(x);

El primer paso es encontrar las declaraciones locales. Agregue el código siguiente a

AnalyzeNode en MakeConstAnalyzer.cs:

C#

var localDeclaration = (LocalDeclarationStatementSyntax)context.Node;

Esta conversión siempre se realiza correctamente porque el analizador registró los

cambios de las declaraciones locales, y solo las declaraciones locales. Ningún otro tipo
de nodo desencadena una llamada al método AnalyzeNode . A continuación, compruebe
la declaración de cualquier modificador const . Si la encuentra, devuélvala de inmediato.
El código siguiente busca cualquier modificador const en la declaración local:

C#

// make sure the declaration isn't already const:

if (localDeclaration.Modifiers.Any(SyntaxKind.ConstKeyword))

return;

Por último, deberá comprobar que la variable podría ser const . Esto significa asegurarse
de que nunca se asigne después de inicializarse.

Realizará algún análisis semántico con SyntaxNodeAnalysisContext. Use el argumento

context para determinar si la declaración de variable local puede convertirse en const .
Una clase Microsoft.CodeAnalysis.SemanticModel representa toda la información
semántica en un solo archivo de origen. Puede obtener más información en el artículo
que trata los modelos semánticos. Deberá usar Microsoft.CodeAnalysis.SemanticModel
para realizar análisis de flujo de datos en la instrucción de declaración local. A
continuación, use los resultados de este análisis de flujo de datos para garantizar que la
variable local no se escriba con un valor nuevo en cualquier otro lugar. Llame al método
de extensión GetDeclaredSymbol para recuperar ILocalSymbol para la variable y
compruebe si no está incluido en la colección DataFlowAnalysis.WrittenOutside del
análisis de flujo de datos. Agregue el código siguiente al final del método AnalyzeNode :

C#

// Perform data flow analysis on the local declaration.

DataFlowAnalysis dataFlowAnalysis =
 context.SemanticModel.AnalyzeDataFlow(localDeclaration);

// Retrieve the local symbol for each variable in the local declaration

// and ensure that it is not written outside of the data flow analysis
region.

VariableDeclaratorSyntax variable =
localDeclaration.Declaration.Variables.Single();

ISymbol variableSymbol = context.SemanticModel.GetDeclaredSymbol(variable,

context.CancellationToken);

if (dataFlowAnalysis.WrittenOutside.Contains(variableSymbol))

return;

El código recién agregado garantiza que no se modifique la variable y que se pueda

convertir por tanto en const . Es el momento de generar el diagnóstico. Agregue el
código siguiente a la última línea en AnalyzeNode :

C#

context.ReportDiagnostic(Diagnostic.Create(Rule, context.Node.GetLocation(),
localDeclaration.Declaration.Variables.First().Identifier.ValueText));

Puede comprobar el progreso presionando F5 para ejecutar el analizador. Puede cargar

la aplicación de consola que creó anteriormente y después agregar el siguiente código
de prueba:

C#

int x = 0;

Console.WriteLine(x);

Debe aparecer la bombilla, y el analizador debe informar de un diagnóstico. Sin

embargo, en función de la versión de Visual Studio, aparecerá una de estas opciones:

La bombilla, que todavía usa la corrección de código generada en plantilla, indica

que se puede convertir en mayúsculas.
Un mensaje de banner en la parte superior del editor, que indica que
"MakeConstCodeFixProvider" ha encontrado un error y se ha deshabilitado. Esto se
debe a que el proveedor de corrección de código aún no se ha cambiado y todavía
espera encontrar los elementos TypeDeclarationSyntax en vez de los elementos
LocalDeclarationStatementSyntax .

En la sección siguiente se explica cómo escribir la corrección de código.

Escritura de la corrección de código
Un analizador puede proporcionar una o varias correcciones de código. Una corrección
de código define una edición que soluciona el problema notificado. Para el analizador
que ha creado, puede proporcionar una corrección de código que inserta la palabra
clave const:

diff

- int x = 0;

+ const int x = 0;

Console.WriteLine(x);

El usuario la elige en la interfaz de usuario de la bombilla del editor, y Visual Studio

cambia el código.

Abra el archivo CodeFixResources.resx y cambie CodeFixTitle a "Make constant".

Abra el archivo MakeConstCodeFixProvider.cs agregado por la plantilla. Esta corrección

de código ya está conectada con el identificador de diagnóstico generado por el
analizador de diagnóstico, pero aún no implementa la transformación de código
correcta.

Después, elimine el método MakeUppercaseAsync . Ya no se aplica.

Todos los proveedores de corrección de código se derivan de CodeFixProvider. Todas

invalidan CodeFixProvider.RegisterCodeFixesAsync(CodeFixContext) para notificar las
correcciones de código disponibles. En RegisterCodeFixesAsync , cambie el tipo de nodo
antecesor que está buscando por LocalDeclarationStatementSyntax para que coincida
con el diagnóstico:

C#

var declaration =
root.FindToken(diagnosticSpan.Start).Parent.AncestorsAndSelf().OfType<LocalD
eclarationStatementSyntax>().First();

A continuación, cambie la última línea para registrar una corrección de código. La

corrección creará un documento que resulta de agregar el modificador const a una
declaración existente:

C#

// Register a code action that will invoke the fix.

context.RegisterCodeFix(

 CodeAction.Create(

title: CodeFixResources.CodeFixTitle,

createChangedDocument: c => MakeConstAsync(context.Document,

declaration, c),

equivalenceKey: nameof(CodeFixResources.CodeFixTitle)),

diagnostic);

Observará un subrayado ondulado rojo en el código que acaba de agregar en el

símbolo MakeConstAsync . Agregue una declaración para MakeConstAsync como el código
siguiente:

C#

private static async Task<Document> MakeConstAsync(Document document,

LocalDeclarationStatementSyntax localDeclaration,

CancellationToken cancellationToken)

El nuevo método MakeConstAsync transformará la clase Document que representa el

archivo de origen del usuario en una nueva clase Document que ahora contiene una
declaración const .

Se crea un token de palabra clave const para insertarlo en la parte delantera de la

instrucción de declaración. Tenga cuidado de quitar primero cualquier curiosidad inicial
del primer token de la instrucción de declaración y adjúntela al token const . Agregue el
código siguiente al método MakeConstAsync :

C#

// Remove the leading trivia from the local declaration.

SyntaxToken firstToken = localDeclaration.GetFirstToken();

SyntaxTriviaList leadingTrivia = firstToken.LeadingTrivia;

LocalDeclarationStatementSyntax trimmedLocal =
localDeclaration.ReplaceToken(

firstToken, firstToken.WithLeadingTrivia(SyntaxTriviaList.Empty));

// Create a const token with the leading trivia.

SyntaxToken constToken = SyntaxFactory.Token(leadingTrivia,

SyntaxKind.ConstKeyword,
SyntaxFactory.TriviaList(SyntaxFactory.ElasticMarker));

A continuación, agregue el token const a la declaración con el siguiente código:

C#
 // Insert the const token into the modifiers list, creating a new modifiers
list.

SyntaxTokenList newModifiers = trimmedLocal.Modifiers.Insert(0, constToken);

// Produce the new local declaration.

LocalDeclarationStatementSyntax newLocal = trimmedLocal

.WithModifiers(newModifiers)

.WithDeclaration(localDeclaration.Declaration);

Después aplique formato a la nueva declaración para que coincida con las reglas de
formato de C#. Aplicar formato a los cambios para que coincidan con el código
existente mejora la experiencia. Agregue la instrucción siguiente inmediatamente
después del código existente:

C#

// Add an annotation to format the new local declaration.

LocalDeclarationStatementSyntax formattedLocal =
newLocal.WithAdditionalAnnotations(Formatter.Annotation);

Se requiere un nuevo espacio de nombres para este código. Agregue la siguiente

directiva using al principio del archivo:

C#

using Microsoft.CodeAnalysis.Formatting;

El último paso es realizar la edición. Hay tres pasos para este proceso:

1. Obtenga un identificador para el documento existente.

2. Cree un documento mediante el reemplazo de la declaración existente con la
nueva declaración.
3. Devuelva el nuevo documento.

Agregue el código siguiente al final del método MakeConstAsync :

C#

// Replace the old local declaration with the new local declaration.

SyntaxNode oldRoot = await

document.GetSyntaxRootAsync(cancellationToken).ConfigureAwait(false);

SyntaxNode newRoot = oldRoot.ReplaceNode(localDeclaration, formattedLocal);

// Return document with transformed tree.

return document.WithSyntaxRoot(newRoot);

La corrección de código está lista para probarla. Presione F5 para ejecutar el proyecto
del analizador en una segunda instancia de Visual Studio. En la segunda instancia de
Visual Studio, cree un proyecto de aplicación de consola de C# y agregue algunas
declaraciones de variable local inicializadas con valores de constante para el método
Main. Observará que se notifican como advertencias de la siguiente forma.

Ha progresado bastante. Hay subrayados ondulados debajo de las declaraciones que

pueden convertirse en const . Pero aún queda trabajo por hacer. Esto funciona bien si
agrega const a las declaraciones a partir de i , luego j y, por último, k . Sin embargo, si
agrega el modificador const en un orden diferente, a partir de k , el analizador crea
errores: k no puede declararse como const , a menos que i y j ya sean const . Tiene
que realizar más análisis para asegurarse de que controla la forma en que las variables
pueden declararse e inicializarse.

Compilación de pruebas unitarias

El analizador y la corrección de código funcionan en un caso sencillo de una única
declaración que puede convertirse en const. Hay varias instrucciones de declaración
posibles donde esta implementación comete errores. Abordará estos casos al trabajar
con la biblioteca de pruebas unitarias escrita por la plantilla. Es mucho más rápido que
abrir repetidamente una segunda copia de Visual Studio.

Abra el archivo MakeConstUnitTests.cs en el proyecto de prueba unitaria. La plantilla creó

dos pruebas que siguen los dos patrones comunes para una prueba unitaria de la
corrección de código y del analizador. TestMethod1 muestra el patrón para una prueba
que garantiza que el analizador no notifique un diagnóstico cuando no debe.
TestMethod2 muestra el patrón de notificación de un diagnóstico y de ejecución de la
corrección de código.

La plantilla usa los paquetes Microsoft.CodeAnalysis.Testing para las pruebas unitarias.

 Sugerencia

La biblioteca de pruebas admite una sintaxis de marcado especial, que incluye lo

siguiente:
 [|text|] : indica que se ha notificado un diagnóstico para text . De forma

predeterminada, este formulario solo se puede usar para probar analizadores

con exactamente una instancia de DiagnosticDescriptor proporcionada por
DiagnosticAnalyzer.SupportedDiagnostics .

{|ExpectedDiagnosticId:text|} : indica que se ha notificado un diagnóstico

para text con Id ExpectedDiagnosticId .

Reemplace las pruebas de plantilla de la clase MakeConstUnitTest por el método de

prueba siguiente:

C#

[TestMethod]

public async Task LocalIntCouldBeConstant_Diagnostic()

await VerifyCS.VerifyCodeFixAsync(@"

using System;

class Program

static void Main()

[|int i = 0;|]

Console.WriteLine(i);

", @"

using System;

class Program

static void Main()

const int i = 0;

Console.WriteLine(i);

");

Ejecute esta prueba para asegurarse de que se supera. En Visual Studio, abra el
Explorador de pruebas; para ello, seleccione Prueba>Windows>Explorador de
pruebas. Luego, seleccione Ejecutar todo.

Creación de pruebas para declaraciones válidas

Por norma general, los analizadores deben existir lo más rápido posible, pero haciendo
el mínimo trabajo. Visual Studio llama a los analizadores registrados a medida que el
usuario edita el código. La capacidad de respuesta es un requisito clave. Hay varios
casos de pruebas del código que no deben realizar un diagnóstico. El analizador ya
controla una de esas pruebas, el caso en que una variable se asigna después de
inicializarse. Agregue el siguiente método de prueba para representar ese caso:

C#

[TestMethod]

public async Task VariableIsAssigned_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

int i = 0;

Console.WriteLine(i++);

");

Esta prueba también pasa. Después, agregue métodos de prueba para las condiciones
que todavía no ha controlado:

Declaraciones que ya son const , porque ya son constantes:

C#

[TestMethod]

public async Task VariableIsAlreadyConst_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

const int i = 0;

Console.WriteLine(i);

");

 Declaraciones que no tienen inicializador, porque no hay ningún valor para usar:

C#

[TestMethod]

public async Task NoInitializer_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

int i;

i = 0;

Console.WriteLine(i);

");

Declaraciones donde el inicializador no es una constante, porque no pueden ser

constantes en tiempo de compilación:

C#

[TestMethod]

public async Task InitializerIsNotConstant_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

int i = DateTime.Now.DayOfYear;

Console.WriteLine(i);

");

Puede ser incluso más complicado, porque C# admite varias declaraciones como una
instrucción. Considere la siguiente constante de cadena de caso de prueba:

C#
 [TestMethod]

public async Task MultipleInitializers_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

int i = 0, j = DateTime.Now.DayOfYear;

Console.WriteLine(i);

Console.WriteLine(j);

");

La variable i puede convertirse en constante, pero la variable j no puede. Por tanto,

esta instrucción no puede convertirse en una declaración de constante.

Vuelva a ejecutar las pruebas y, después, observará que estos nuevos casos de prueba
generarán errores.

Actualización del analizador para ignorar

declaraciones correctas
Necesita algunas mejoras en el método AnalyzeNode del analizador para filtrar el código
que cumple estas condiciones. Son todas condiciones relacionadas, por lo que los
cambios similares corregirán todas estas condiciones. Realice los siguientes cambios en
AnalyzeNode :

El análisis semántico analizó una única declaración de variable. Este código

necesita estar en un bucle foreach que examina todas las variables declaradas en
la misma instrucción.
Cada variable declarada necesita tener un inicializador.
El inicializador de cada variable declarada debe ser una constante de tiempo de
compilación.

En el método AnalyzeNode , reemplace el análisis semántico original:

C#

// Perform data flow analysis on the local declaration.

DataFlowAnalysis dataFlowAnalysis =
 context.SemanticModel.AnalyzeDataFlow(localDeclaration);

// Retrieve the local symbol for each variable in the local declaration

// and ensure that it is not written outside of the data flow analysis
region.

VariableDeclaratorSyntax variable =
localDeclaration.Declaration.Variables.Single();

ISymbol variableSymbol = context.SemanticModel.GetDeclaredSymbol(variable,

context.CancellationToken);

if (dataFlowAnalysis.WrittenOutside.Contains(variableSymbol))

return;

por el siguiente fragmento de código:

C#

// Ensure that all variables in the local declaration have initializers that

// are assigned with constant values.

foreach (VariableDeclaratorSyntax variable in

localDeclaration.Declaration.Variables)

EqualsValueClauseSyntax initializer = variable.Initializer;

if (initializer == null)

return;

Optional<object> constantValue =
context.SemanticModel.GetConstantValue(initializer.Value,
context.CancellationToken);

if (!constantValue.HasValue)

return;

// Perform data flow analysis on the local declaration.

DataFlowAnalysis dataFlowAnalysis =
context.SemanticModel.AnalyzeDataFlow(localDeclaration);

foreach (VariableDeclaratorSyntax variable in

localDeclaration.Declaration.Variables)

// Retrieve the local symbol for each variable in the local declaration

// and ensure that it is not written outside of the data flow analysis
region.

ISymbol variableSymbol =
context.SemanticModel.GetDeclaredSymbol(variable,
context.CancellationToken);

if (dataFlowAnalysis.WrittenOutside.Contains(variableSymbol))

 return;

El primer bucle foreach examina cada declaración de variable con análisis sintácticos La
primera comprobación garantiza que la variable tiene un inicializador. La segunda
comprobación garantiza que el inicializador es una constante. El segundo bucle tiene el
análisis semántico original. Las comprobaciones semánticas se encuentran en un bucle
independiente porque afectan más al rendimiento. Vuelva a ejecutar las pruebas y
observará que todas pasan.

Adición de un retoque final

Casi ha terminado. Hay algunas condiciones más que el analizador tiene que cumplir.
Visual Studio llama a los analizadores mientras el usuario escribe el código. Suele darse
el caso de que se llama al analizador para código que no compila. El método
AnalyzeNode del analizador de diagnóstico no comprueba si el valor de constante se
puede convertir al tipo de variable. Por tanto, la implementación actual convertirá de
forma adecuada una declaración incorrecta, como int i = "abc" , en una constante
local. Agregue un método de prueba para este caso:

C#

[TestMethod]

public async Task DeclarationIsInvalid_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

int x = {|CS0029:""abc""|};

");

Además, los tipos de referencia no se controlan correctamente. El único valor de

constante permitido para un tipo de referencia es null , excepto en el caso de
System.String, que admite los literales de cadena. En otras palabras, const string s =
"abc" es legal, pero const object s = "abc" no lo es. Este fragmento de código
comprueba esa condición:
 C#

[TestMethod]

public async Task DeclarationIsNotString_NoDiagnostic()

await VerifyCS.VerifyAnalyzerAsync(@"

using System;

class Program

static void Main()

object s = ""abc"";

");

Para ser exhaustivo, debe agregar otra prueba para asegurarse de que puede crear una
declaración de constante para una cadena. El fragmento de código siguiente define el
código que genera el diagnóstico y el código después de haber aplicado la corrección:

C#

[TestMethod]

public async Task StringCouldBeConstant_Diagnostic()

await VerifyCS.VerifyCodeFixAsync(@"

using System;

class Program

static void Main()

[|string s = ""abc"";|]

", @"

using System;

class Program

static void Main()

const string s = ""abc"";

}

");

Por último, si una variable se declara con la palabra clave var , la corrección de código
hace una función incorrecta y genera una declaración const var , que el lenguaje C# no
admite. Para corregir este error, la corrección de código debe reemplazar la palabra
clave var por el nombre del tipo deducido:

C#

[TestMethod]

public async Task VarIntDeclarationCouldBeConstant_Diagnostic()

await VerifyCS.VerifyCodeFixAsync(@"

using System;

class Program

static void Main()

[|var item = 4;|]

", @"

using System;

class Program

static void Main()

const int item = 4;

");

[TestMethod]

public async Task VarStringDeclarationCouldBeConstant_Diagnostic()

await VerifyCS.VerifyCodeFixAsync(@"

using System;

class Program

static void Main()

[|var item = ""abc"";|]

", @"

using System;

class Program

static void Main()

 const string item = ""abc"";

");

Afortunadamente, todos los errores anteriores se pueden tratar con las mismas técnicas
que acaba de aprender.

Para corregir el primer error, abra primero MakeConstAnalyzer.cs y busque el bucle

foreach donde se comprueban todos los inicializadores de la declaración local para
asegurarse de que se les hayan asignado valores constantes. Inmediatamente antes del
primer bucle foreach, llame a context.SemanticModel.GetTypeInfo() para recuperar
información detallada sobre el tipo declarado de la declaración local:

C#

TypeSyntax variableTypeName = localDeclaration.Declaration.Type;

ITypeSymbol variableType =
context.SemanticModel.GetTypeInfo(variableTypeName,
context.CancellationToken).ConvertedType;

Después, dentro del bucle foreach , compruebe cada inicializador para asegurarse de
que se puede convertir al tipo de variable. Agregue la siguiente comprobación después
de asegurarse de que el inicializador es una constante:

C#

// Ensure that the initializer value can be converted to the type of the

// local declaration without a user-defined conversion.

Conversion conversion =
context.SemanticModel.ClassifyConversion(initializer.Value, variableType);

if (!conversion.Exists || conversion.IsUserDefined)

return;

El siguiente cambio se basa en el último. Antes de cerrar la llave del primer bucle
foreach, agregue el código siguiente para comprobar el tipo de declaración local
cuando la constante es una cadena o null.

C#

// Special cases:

// * If the constant value is a string, the type of the local declaration

// must be System.String.

// * If the constant value is null, the type of the local declaration must

 // be a reference type.

if (constantValue.Value is string)

if (variableType.SpecialType != SpecialType.System_String)

return;

else if (variableType.IsReferenceType && constantValue.Value != null)

return;

Debe escribir algo más de código en el proveedor de corrección de código para

reemplazar la palabra clave var por el nombre de tipo correcto. Vuelva a
MakeConstCodeFixProvider.cs. El código que se va a agregar realiza los pasos siguientes:

Compruebe si la declaración es una declaración var y, en su caso:

Cree un tipo para el tipo deducido.
Asegúrese de que la declaración de tipo no es un alias. Si es así, es válido declarar
const var .

Asegúrese de que var no es un nombre de tipo en este programa. (Si es así, const
var es válido).
Simplificación del nombre de tipo completo

Parece mucho código. Pero no lo es. Reemplace la línea que declara e inicializa newLocal
con el código siguiente. Va inmediatamente después de la inicialización de
newModifiers :

C#

// If the type of the declaration is 'var', create a new type name

// for the inferred type.

VariableDeclarationSyntax variableDeclaration =
localDeclaration.Declaration;

TypeSyntax variableTypeName = variableDeclaration.Type;

if (variableTypeName.IsVar)

SemanticModel semanticModel = await

document.GetSemanticModelAsync(cancellationToken).ConfigureAwait(false);

// Special case: Ensure that 'var' isn't actually an alias to another

type

// (e.g. using var = System.String).

IAliasSymbol aliasInfo = semanticModel.GetAliasInfo(variableTypeName,

cancellationToken);

if (aliasInfo == null)

// Retrieve the type inferred for var.

 ITypeSymbol type = semanticModel.GetTypeInfo(variableTypeName,

cancellationToken).ConvertedType;

// Special case: Ensure that 'var' isn't actually a type named

'var'.

if (type.Name != "var")

// Create a new TypeSyntax for the inferred type. Be careful

// to keep any leading and trailing trivia from the var keyword.

TypeSyntax typeName =
SyntaxFactory.ParseTypeName(type.ToDisplayString())

.WithLeadingTrivia(variableTypeName.GetLeadingTrivia())

.WithTrailingTrivia(variableTypeName.GetTrailingTrivia());

// Add an annotation to simplify the type name.

TypeSyntax simplifiedTypeName =
typeName.WithAdditionalAnnotations(Simplifier.Annotation);

// Replace the type in the variable declaration.

variableDeclaration =
variableDeclaration.WithType(simplifiedTypeName);

// Produce the new local declaration.

LocalDeclarationStatementSyntax newLocal =
trimmedLocal.WithModifiers(newModifiers)

.WithDeclaration(variableDeclaration);

Deberá agregar una directiva using para usar el tipo Simplifier:

C#

using Microsoft.CodeAnalysis.Simplification;

Ejecute las pruebas, y todas deberían pasar. Felicítese por ejecutar el analizador
terminado. Presione Ctrl + F5 para ejecutar el proyecto de analizador en una segunda
instancia de Visual Studio con la extensión de la versión preliminar de Roslyn cargada.

En la segunda instancia de Visual Studio, cree un proyecto de aplicación de

consola de C# y agregue int x = "abc"; al método Main. Gracias a la primera
corrección de errores, no se debe notificar ninguna advertencia para esta
declaración de variable local (aunque hay un error del compilador según lo
esperado).
A continuación, agregue object s = "abc"; al método Main. Debido a la segunda
corrección de errores, no se debe notificar ninguna advertencia.
Por último, agregue otra variable local que usa la palabra clave var . Observará que
se notifica una advertencia y que aparece una sugerencia debajo a la izquierda.
 Mueva el símbolo de intercalación del editor sobre el subrayado ondulado y
presione Ctrl + . . para mostrar la corrección de código sugerida. Al seleccionar la
corrección de código, tenga en cuenta que la palabra clave var ahora se trata
correctamente.

Por último, agregue el código siguiente:

C#

int i = 2;

int j = 32;

int k = i + j;

Después de estos cambios, obtendrá un subrayado ondulado rojo solo en las dos
primeras variables. Agregue const a i y j , y obtendrá una nueva advertencia sobre k
porque ahora puede ser const .

¡Enhorabuena! Ha creado su primera extensión de .NET Compiler Platform que realiza

un análisis de código sobre la marcha para detectar un problema y proporciona una
solución rápida para corregirlo. Durante el proceso, ha aprendido muchas de las API de
código que forman parte del SDK de .NET Compiler Platform (API de Roslyn). Puede
comprobar su trabajo con el ejemplo completo en nuestro repositorio de ejemplos de
GitHub.

Otros recursos
Introducción al análisis de sintaxis
Introducción al análisis semántico
Guía de programación de C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En esta sección se proporciona información detallada sobre las funcionalidades y

características claves del lenguaje C# a las que C# puede acceder a través de .NET.

En la mayor parte de esta sección se supone que ya sabe algo sobre C# y que conoce
los conceptos de programación generales. Si nunca ha programado ni ha trabajado con
C#, puede consultar los tutoriales de introducción a C# o el tutorial de .NET en
explorador , que no requieren ningún conocimiento previo de programación.

Para obtener información sobre determinadas palabras clave, operadores y directivas de

preprocesador, consulte Referencia de C#. Para obtener información sobre la
especificación del lenguaje C#, consulte Especificación del lenguaje C#.

Secciones de programa
Dentro de un programa de C#

Main() y argumentos de la línea de comandos

Secciones de lenguaje
InstruccionesOperadores y expresionesMiembros con cuerpo de
expresiónComparaciones de igualdad

Tipos

Programación orientada a objetos

Interfaces

Delegados

Matrices

Cadenas

Propiedades

Indizadores

Eventos
Genéricos

Iteradores

Expresiones de consulta LINQ

Espacios de nombres

Código no seguro y punteros

Comentarios de la documentación XML

Secciones de la plataforma
Dominios de aplicación

Ensamblados de .NET

Atributos

Colecciones

Excepciones y control de excepciones

Registro y sistema de archivos (Guía de programación de C#)

Interoperabilidad

Reflexión

Vea también
Referencia de C#
Conceptos de programación (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En esta sección se explican los conceptos de programación del lenguaje C#.

En esta sección
Title Descripción

Ensamblados Describe cómo crear y utilizar ensamblados.

de .NET

Programación Describe cómo escribir soluciones asincrónicas mediante las palabras clave
asincrónica con Async y Await en C#. Incluye un tutorial.
Async y Await
(C#)

Atributos (C#) Describe cómo proporcionar información adicional sobre elementos de

programación como tipos, campos, métodos y propiedades mediante el uso de
atributos.

Colecciones Describe algunos de los tipos de colecciones proporcionadas por .NET. Muestra
(C#) cómo usar colecciones sencillas y colecciones de pares clave-valor.

Covarianza y Describe cómo habilitar la conversión implícita de parámetros de tipo genérico

contravarianza en interfaces y delegados.
(C#)

Árboles de Explica cómo puede utilizar árboles de expresión para habilitar la modificación
expresión (C#) dinámica de código ejecutable.

Iteradores (C#) Describe los iteradores, que se usan para recorrer colecciones y devolver los
elementos uno a uno.

Language Se describen las eficaces funciones de consulta de la sintaxis del lenguaje C#,
Integrated así como el modelo para consultar bases de datos relacionales, documentos
Query (LINQ) XML, conjuntos de datos y colecciones en memoria.
(C#)

Reflexión (C#) Se explica cómo usar la reflexión para crear dinámicamente una instancia de un
tipo, enlazar el tipo a un objeto existente u obtener el tipo desde un objeto
existente e invocar sus métodos, o acceder a sus campos y propiedades.

Serialización Describe los conceptos clave de la serialización binaria, XML y SOAP.

(C#)
Secciones relacionadas
Sugerencias para mejorar el rendimiento

Se describen varias reglas básicas que pueden ayudarle a aumentar el rendimiento

de la aplicación.
Programación asincrónica
Artículo • 20/02/2023 • Tiempo de lectura: 11 minutos

Si tiene cualquier necesidad enlazada a E/S (por ejemplo, solicitar datos de una red,
acceder a una base de datos o leer y escribir un sistema de archivos), deberá usar la
programación asincrónica. También podría tener código enlazado a la CPU, como
realizar un cálculo costoso, que también es un buen escenario para escribir código
asincrónico.

C# tiene un modelo de programación asincrónico de nivel de lenguaje que permite

escribir fácilmente código asincrónico sin tener que hacer malabares con las
devoluciones de llamada o ajustarse a una biblioteca que admita la asincronía. Sigue lo
que se conoce como el modelo asincrónico basado en tareas (TAP).

Información general del modelo asincrónico

El núcleo de la programación asincrónica son los objetos Task y Task<T> , que modelan
las operaciones asincrónicas. Son compatibles con las palabras clave async y await . El
modelo es bastante sencillo en la mayoría de los casos:

Para el código enlazado a E/S, espera una operación que devuelva Task o Task<T>
dentro de un método async .
Para el código enlazado a la CPU, espera una operación que se inicia en un
subproceso en segundo plano con el método Task.Run.

La palabra clave await es donde ocurre la magia. Genera control para el autor de la
llamada del método que ha realizado await , y permite en última instancia una interfaz
de usuario con capacidad de respuesta o un servicio flexible. Aunque existen maneras
de abordar el código asincrónico diferentes de async y await , este artículo se centra en
las construcciones de nivel de lenguaje.

Ejemplo enlazado a E/S: descarga de datos de un servicio

web
Puede que necesite descargar algunos datos de un servicio web cuando se presione un
botón, pero no quiere bloquear el subproceso de interfaz de usuario. Esto se puede
lograr con la clase System.Net.Http.HttpClient:

C#
 private readonly HttpClient _httpClient = new HttpClient();

downloadButton.Clicked += async (o, e) =>

// This line will yield control to the UI as the request

// from the web service is happening.

//

// The UI thread is now free to perform other work.

var stringData = await _httpClient.GetStringAsync(URL);

DoSomethingWithData(stringData);

};

El código expresa la intención (descargar datos de forma asincrónica) sin verse

obstaculizado en la interacción con objetos Task .

Ejemplo enlazado a la CPU: realizar un cálculo para un

juego
Supongamos que está escribiendo un juego para móviles en el que se pueden infligir
daños a muchos enemigos en la pantalla pulsando un botón. Realizar el cálculo del
daño puede resultar costoso y hacerlo en el subproceso de interfaz de usuario haría que
pareciera que el juego se pone en pausa mientras se lleva a cabo el cálculo.

La mejor manera de abordar esta situación consiste en iniciar un subproceso en

segundo plano que realice la tarea mediante Task.Run y esperar su resultado mediante
await . Esto permite que la interfaz de usuario funcione de manera fluida mientras se

lleva a cabo la tarea.

C#

private DamageResult CalculateDamageDone()

// Code omitted:

//

// Does an expensive calculation and returns

// the result of that calculation.

calculateButton.Clicked += async (o, e) =>

// This line will yield control to the UI while CalculateDamageDone()

// performs its work. The UI thread is free to perform other work.

var damageResult = await Task.Run(() => CalculateDamageDone());

DisplayDamage(damageResult);

};

Este código expresa claramente la intención del evento de clic del botón, no requiere la
administración manual de un subproceso en segundo plano y lo hace en un modo sin
bloqueo.

Qué sucede en segundo plano

En lo que respecta a C#, el compilador transforma el código en una máquina de estados
que realiza el seguimiento de acciones como la retención de la ejecución cuando se
alcanza await y la reanudación de la ejecución cuando se ha finalizado un trabajo en
segundo plano.

Para los más interesados en la teoría, se trata de una implementación del modelo de
promesas de asincronía .

Piezas clave que debe comprender

El código asincrónico puede usarse para código tanto enlazado a E/S como
enlazado a la CPU, pero de forma distinta en cada escenario.
El código asincrónico usa Task<T> y Task , que son construcciones que se usan
para modelar el trabajo que se realiza en segundo plano.
La palabra clave async convierte un método en un método asincrónico, lo que
permite usar la palabra clave await en su cuerpo.
Cuando se aplica la palabra clave await , se suspende el método de llamada y se
cede el control al autor de la llamada hasta que se completa la tarea esperada.
await solo puede usarse dentro de un método asincrónico.

Reconocer el trabajo enlazado a la CPU y el

enlazado a E/S
En los dos primeros ejemplos de esta guía se ha explicado cómo podría usar async y
await para trabajos enlazados a E/S y a la CPU. Resulta fundamental que pueda
identificar si el trabajo que debe realizar está enlazado a E/S o a la CPU, ya que esto
puede afectar en gran medida al rendimiento del código y podría dar lugar al uso
inadecuado de ciertas construcciones.

A continuación, se indican dos preguntas que debe hacerse antes de escribir el código:

1. ¿Estará su código "esperando" algo, como datos de una base de datos?

Si la respuesta es "sí", su trabajo está enlazado a E/S.

 2. ¿Realizará el código un cálculo costoso?

Si la respuesta es "sí", su trabajo está enlazado a la CPU.

Si el trabajo que tiene está enlazado a E/S, use async y await sin Task.Run . No debe usar
la Biblioteca TPL.

Si el trabajo que tiene está enlazado a la CPU y le interesa la capacidad de respuesta,

use async y await , pero genere el trabajo en otro subproceso con Task.Run . Si el trabajo
es adecuado para la simultaneidad y el paralelismo, también debe plantearse el uso de
la biblioteca TPL.

Además, siempre debe medir la ejecución del código. Por ejemplo, puede verse en una
situación en la que el trabajo enlazado a la CPU no sea suficientemente costoso en
comparación con la sobrecarga de cambios de contexto cuando realice multithreading.
Cada opción tiene su compensación y debe elegir el equilibrio correcto para su
situación.

Más ejemplos
En los ejemplos siguientes se muestran distintas maneras en las que puede escribir
código asincrónico en C#. Abarcan algunos escenarios diferentes con los que puede
encontrarse.

Extracción de datos de una red

Este fragmento de código descarga el HTML desde la página principal en
https://dotnetfoundation.org y cuenta el número de veces que aparece la cadena
".NET" en el código HTML. Usa ASP.NET para definir un método de controlador Web API
que realiza esta tarea y devuelve el número.

７ Nota

Si tiene previsto realizar un análisis HTML en el código de producción, no use

expresiones regulares. Use una biblioteca de análisis en su lugar.

C#

private readonly HttpClient _httpClient = new HttpClient();

[HttpGet, Route("DotNetCount")]

public async Task<int> GetDotNetCount()

 // Suspends GetDotNetCount() to allow the caller (the web server)

// to accept another request, rather than blocking on this one.

var html = await

_httpClient.GetStringAsync("https://dotnetfoundation.org");

return Regex.Matches(html, @"\.NET").Count;

Este es el mismo escenario escrito para una aplicación Windows Universal, que realiza la
misma tarea cuando se presiona un botón:

C#

private readonly HttpClient _httpClient = new HttpClient();

private async void OnSeeTheDotNetsButtonClick(object sender, RoutedEventArgs

e)

// Capture the task handle here so we can await the background task
later.

var getDotNetFoundationHtmlTask =
_httpClient.GetStringAsync("https://dotnetfoundation.org");

// Any other work on the UI thread can be done here, such as enabling a
Progress Bar.

// This is important to do here, before the "await" call, so that the

user

// sees the progress bar before execution of this method is yielded.

NetworkProgressBar.IsEnabled = true;

NetworkProgressBar.Visibility = Visibility.Visible;

// The await operator suspends OnSeeTheDotNetsButtonClick(), returning

control to its caller.

// This is what allows the app to be responsive and not block the UI
thread.

var html = await getDotNetFoundationHtmlTask;

int count = Regex.Matches(html, @"\.NET").Count;

DotNetCountLabel.Text = $"Number of .NETs on dotnetfoundation.org:

{count}";

NetworkProgressBar.IsEnabled = false;

NetworkProgressBar.Visibility = Visibility.Collapsed;

Esperar a que se completen varias tareas

Es posible que se vea en una situación en la que necesite recuperar varios fragmentos
de datos al mismo tiempo. La API Task contiene dos métodos, Task.WhenAll y
Task.WhenAny, que permiten escribir código asincrónico que realiza una espera sin
bloqueo en varios trabajos en segundo plano.

En este ejemplo se muestra cómo podría captar datos User de un conjunto de

elementos userId .

C#

public async Task<User> GetUserAsync(int userId)

// Code omitted:

//

// Given a user Id {userId}, retrieves a User object corresponding

// to the entry in the database with {userId} as its Id.

public static async Task<IEnumerable<User>> GetUsersAsync(IEnumerable<int>

userIds)

var getUserTasks = new List<Task<User>>();

foreach (int userId in userIds)

getUserTasks.Add(GetUserAsync(userId));

return await Task.WhenAll(getUserTasks);

Aquí tiene otra manera de escribir lo mismo de una forma más sucinta, con LINQ:

C#

public async Task<User> GetUserAsync(int userId)

// Code omitted:

//

// Given a user Id {userId}, retrieves a User object corresponding

// to the entry in the database with {userId} as its Id.

public static async Task<User[]> GetUsersAsync(IEnumerable<int> userIds)

var getUserTasks = userIds.Select(id => GetUserAsync(id)).ToArray();

return await Task.WhenAll(getUserTasks);

Aunque es menos código, tenga cuidado al combinar LINQ con código asincrónico.
Dado que LINQ usa la ejecución diferida, las llamadas asincrónicas no se realizarán
inmediatamente, como lo hacen en un bucle foreach , a menos que fuerce la secuencia
generada a procesar una iteración con una llamada a .ToList() o .ToArray() . En el
ejemplo anterior se usa Enumerable.ToArray para realizar la consulta diligentemente y
almacenar los resultados en una matriz. Esto obliga al código id => GetUserAsync(id) a
ejecutar e iniciar la tarea.

Consejos e información importante

Con la programación asincrónica, hay algunos detalles que debe tener en cuenta para
evitar un comportamiento inesperado.

Los métodos async deben tener una palabra clave await en el cuerpo o nunca
proporcionarán resultados.

Es importante que tenga esto en cuenta. Si no se usa await en el cuerpo de un

método async , el compilador de C# genera una advertencia, pero el código se
compila y se ejecuta como si se tratara de un método normal. Esto sería muy
ineficaz, ya que la máquina de estados generada por el compilador de C# para el
método asincrónico no realiza nada.

Agregue "Async" como el sufijo de todos los métodos asincrónicos que escriba.

Se trata de la convención que se usa en .NET para distinguir más fácilmente los
métodos sincrónicos de los asincrónicos. No se aplican necesariamente ciertos
métodos a los que el código no llame explícitamente (como controladores de
eventos o métodos de controlador web). Puesto que el código no los llama
explícitamente, resulta importante explicitar sus nombres.

async void solo se debe usar para controladores de eventos.

async void es la única manera de permitir a los controladores de eventos

asincrónicos trabajar, ya que los eventos no tienen tipos de valor devuelto (por lo
tanto, no pueden hacer uso de Task y Task<T> ). Cualquier otro uso de async void
no sigue el modelo de TAP y puede resultar difícil de usar, como:
Las excepciones producidas en un método async void no se pueden detectar
fuera de ese método.
Los métodos async void resultan muy difíciles de probar.
Los métodos async void pueden provocar efectos secundarios negativos si el
autor de la llamada no espera que sean asincrónicos.

Tenga cuidado al usar lambdas asincrónicas en las expresiones de LINQ.

Las expresiones lambda de LINQ usan la ejecución aplazada, lo que implica que el
código podría acabar ejecutándose en un momento en que no se lo espere. La
introducción de las tareas de bloqueo puede dar lugar a un interbloqueo si no se
han escrito correctamente. Además, el anidamiento de código asincrónico de esta
manera también puede hacer que resulte más difícil razonar sobre la ejecución del
código. Async y LINQ son eficaces, pero deben usarse conjuntamente con el mayor
cuidado y claridad posible.

Escriba código que espere las tareas sin bloqueo.

Bloquear el subproceso actual como un medio para esperar que se complete Task
puede dar lugar a interbloqueos y subprocesos de contexto bloqueados, y puede
requerir un control de errores más complejo. En la tabla siguiente se ofrece
orientación sobre cómo abordar la espera de las tareas de una manera que no
produzca un bloqueo:

Use esto... En vez de esto... Cuando quiera hacer esto...

await Task.Wait o Recuperar el resultado de una tarea en

Task.Result segundo plano

await Task.WaitAny Esperar que finalice cualquier tarea

Task.WhenAny

await Task.WaitAll Esperar que finalicen todas las tareas

Task.WhenAll

await Thread.Sleep Esperar un período de tiempo

Task.Delay

Considere la posibilidad de usar ValueTask siempre que sea posible

La devolución de un objeto Task desde métodos asincrónicos puede presentar

cuellos de botella de rendimiento en determinadas rutas de acceso. Task es un
tipo de referencia, por lo que su uso implica la asignación de un objeto. En los
casos en los que un método declarado con el modificador async devuelva un
resultado en caché o se complete sincrónicamente, las asignaciones adicionales
pueden suponer un costo considerable de tiempo en secciones críticas para el
rendimiento del código. Esas asignaciones pueden resultar costosas si se producen
en bucles ajustados. Para obtener más información, consulte Tipos de valor
devueltos asincrónicos generalizados.

Considere la posibilidad de usar ConfigureAwait(false)

 Una pregunta habitual es "¿Cuándo debo usar el método
Task.ConfigureAwait(Boolean)?". El método permite a una instancia de Task
configurar su elemento awaiter. Este es un aspecto importante que debe tenerse
en cuenta, y su configuración incorrecta podría tener implicaciones de rendimiento
e incluso interbloqueos. Para obtener más información sobre ConfigureAwait ,
consulte las preguntas más frecuentes sobre ConfigureAwait .

Escriba código con menos estados.

No dependa del estado de los objetos globales o la ejecución de ciertos métodos.

En su lugar, dependa únicamente de los valores devueltos de los métodos. ¿Por
qué?
Le resultará más fácil razonar sobre el código.
Le resultará más fácil probar el código.
Resulta mucho más sencillo mezclar código asincrónico y sincrónico.
Normalmente se pueden evitar por completo las condiciones de carrera.
Depender de los valores devueltos facilita la coordinación de código
asincrónico.
(Extra) Funciona muy bien con la inserción de dependencias.

Un objetivo recomendado es lograr una transparencia referencial completa o casi

completa en el código. Esto se traducirá en un código base predecible, que se puede
probar y es fácil de mantener.

Otros recursos
Modelo de programación asincrónica de tareas (C#).
Asynchronous programming with async
and await
Artículo • 13/02/2023 • Tiempo de lectura: 16 minutos

The Task asynchronous programming model (TAP) provides an abstraction over

asynchronous code. You write code as a sequence of statements, just like always. You
can read that code as though each statement completes before the next begins. The
compiler performs many transformations because some of those statements may start
work and return a Task that represents the ongoing work.

That's the goal of this syntax: enable code that reads like a sequence of statements, but
executes in a much more complicated order based on external resource allocation and
when tasks are complete. It's analogous to how people give instructions for processes
that include asynchronous tasks. Throughout this article, you'll use an example of
instructions for making breakfast to see how the async and await keywords make it
easier to reason about code that includes a series of asynchronous instructions. You'd
write the instructions something like the following list to explain how to make a
breakfast:

1. Pour a cup of coffee.

2. Heat a pan, then fry two eggs.
3. Fry three slices of bacon.
4. Toast two pieces of bread.
5. Add butter and jam to the toast.
6. Pour a glass of orange juice.

If you have experience with cooking, you'd execute those instructions asynchronously.
You'd start warming the pan for eggs, then start the bacon. You'd put the bread in the
toaster, then start the eggs. At each step of the process, you'd start a task, then turn
your attention to tasks that are ready for your attention.

Cooking breakfast is a good example of asynchronous work that isn't parallel. One
person (or thread) can handle all these tasks. Continuing the breakfast analogy, one
person can make breakfast asynchronously by starting the next task before the first task
completes. The cooking progresses whether or not someone is watching it. As soon as
you start warming the pan for the eggs, you can begin frying the bacon. Once the bacon
starts, you can put the bread into the toaster.

For a parallel algorithm, you'd need multiple cooks (or threads). One would make the
eggs, one the bacon, and so on. Each one would be focused on just that one task. Each
cook (or thread) would be blocked synchronously waiting for the bacon to be ready to
flip, or the toast to pop.

Now, consider those same instructions written as C# statements:

C#

using System;

using System.Threading.Tasks;

namespace AsyncBreakfast

// These classes are intentionally empty for the purpose of this

example. They are simply marker classes for the purpose of demonstration,
contain no properties, and serve no other purpose.

internal class Bacon { }

internal class Coffee { }

internal class Egg { }

internal class Juice { }

internal class Toast { }

class Program

static void Main(string[] args)

Coffee cup = PourCoffee();

Console.WriteLine("coffee is ready");

Egg eggs = FryEggs(2);

Console.WriteLine("eggs are ready");

Bacon bacon = FryBacon(3);

Console.WriteLine("bacon is ready");

Toast toast = ToastBread(2);

ApplyButter(toast);

ApplyJam(toast);

Console.WriteLine("toast is ready");

Juice oj = PourOJ();

Console.WriteLine("oj is ready");

Console.WriteLine("Breakfast is ready!");

private static Juice PourOJ()

Console.WriteLine("Pouring orange juice");

return new Juice();

private static void ApplyJam(Toast toast) =>

Console.WriteLine("Putting jam on the toast");

 private static void ApplyButter(Toast toast) =>

Console.WriteLine("Putting butter on the toast");

private static Toast ToastBread(int slices)

for (int slice = 0; slice < slices; slice++)

Console.WriteLine("Putting a slice of bread in the

toaster");

Console.WriteLine("Start toasting...");

Task.Delay(3000).Wait();

Console.WriteLine("Remove toast from toaster");

return new Toast();

private static Bacon FryBacon(int slices)

Console.WriteLine($"putting {slices} slices of bacon in the

pan");

Console.WriteLine("cooking first side of bacon...");

Task.Delay(3000).Wait();

for (int slice = 0; slice < slices; slice++)

Console.WriteLine("flipping a slice of bacon");

Console.WriteLine("cooking the second side of bacon...");

Task.Delay(3000).Wait();

Console.WriteLine("Put bacon on plate");

return new Bacon();

private static Egg FryEggs(int howMany)

Console.WriteLine("Warming the egg pan...");

Task.Delay(3000).Wait();

Console.WriteLine($"cracking {howMany} eggs");

Console.WriteLine("cooking the eggs ...");

Task.Delay(3000).Wait();

Console.WriteLine("Put eggs on plate");

return new Egg();

private static Coffee PourCoffee()

Console.WriteLine("Pouring coffee");

return new Coffee();

The synchronously prepared breakfast took roughly 30 minutes because the total is the
sum of each task.

Computers don't interpret those instructions the same way people do. The computer
will block on each statement until the work is complete before moving on to the next
statement. That creates an unsatisfying breakfast. The later tasks wouldn't be started
until the earlier tasks had been completed. It would take much longer to create the
breakfast, and some items would have gotten cold before being served.

If you want the computer to execute the above instructions asynchronously, you must
write asynchronous code.

These concerns are important for the programs you write today. When you write client
programs, you want the UI to be responsive to user input. Your application shouldn't
make a phone appear frozen while it's downloading data from the web. When you write
server programs, you don't want threads blocked. Those threads could be serving other
requests. Using synchronous code when asynchronous alternatives exist hurts your
ability to scale out less expensively. You pay for those blocked threads.

Successful modern applications require asynchronous code. Without language support,

writing asynchronous code required callbacks, completion events, or other means that
obscured the original intent of the code. The advantage of the synchronous code is that
its step-by-step actions make it easy to scan and understand. Traditional asynchronous
models forced you to focus on the asynchronous nature of the code, not on the
fundamental actions of the code.

Don't block, await instead

The preceding code demonstrates a bad practice: constructing synchronous code to
perform asynchronous operations. As written, this code blocks the thread executing it
from doing any other work. It won't be interrupted while any of the tasks are in
progress. It would be as though you stared at the toaster after putting the bread in.
You'd ignore anyone talking to you until the toast popped.

Let's start by updating this code so that the thread doesn't block while tasks are
running. The await keyword provides a non-blocking way to start a task, then continue
execution when that task completes. A simple asynchronous version of the make a
breakfast code would look like the following snippet:

C#

static async Task Main(string[] args)

Coffee cup = PourCoffee();

Console.WriteLine("coffee is ready");

Egg eggs = await FryEggsAsync(2);

Console.WriteLine("eggs are ready");

Bacon bacon = await FryBaconAsync(3);

Console.WriteLine("bacon is ready");

Toast toast = await ToastBreadAsync(2);

ApplyButter(toast);

ApplyJam(toast);

Console.WriteLine("toast is ready");

Juice oj = PourOJ();

Console.WriteLine("oj is ready");

Console.WriteLine("Breakfast is ready!");

） Importante

The total elapsed time is roughly the same as the initial synchronous version. The
code has yet to take advantage of some of the key features of asynchronous
programming.
  Sugerencia

The method bodies of the FryEggsAsync , FryBaconAsync , and ToastBreadAsync have

all been updated to return Task<Egg> , Task<Bacon> , and Task<Toast> respectively.
The methods are renamed from their original version to include the "Async" suffix.
Their implementations are shown as part of the final version later in this article.

７ Nota

The Main method returns Task , despite not having a return expression—this is by
design. For more information, see Evaluation of a void-returning async function.

This code doesn't block while the eggs or the bacon are cooking. This code won't start
any other tasks though. You'd still put the toast in the toaster and stare at it until it pops.
But at least, you'd respond to anyone that wanted your attention. In a restaurant where
multiple orders are placed, the cook could start another breakfast while the first is
cooking.

Now, the thread working on the breakfast isn't blocked while awaiting any started task
that hasn't yet finished. For some applications, this change is all that's needed. A GUI
application still responds to the user with just this change. However, for this scenario,
you want more. You don't want each of the component tasks to be executed
sequentially. It's better to start each of the component tasks before awaiting the
previous task's completion.

Start tasks concurrently

In many scenarios, you want to start several independent tasks immediately. Then, as
each task finishes, you can continue other work that's ready. In the breakfast analogy,
that's how you get breakfast done more quickly. You also get everything done close to
the same time. You'll get a hot breakfast.

The System.Threading.Tasks.Task and related types are classes you can use to reason
about tasks that are in progress. That enables you to write code that more closely
resembles the way you'd create breakfast. You'd start cooking the eggs, bacon, and
toast at the same time. As each requires action, you'd turn your attention to that task,
take care of the next action, then wait for something else that requires your attention.

You start a task and hold on to the Task object that represents the work. You'll await
each task before working with its result.
Let's make these changes to the breakfast code. The first step is to store the tasks for
operations when they start, rather than awaiting them:

C#

Coffee cup = PourCoffee();

Console.WriteLine("Coffee is ready");

Task<Egg> eggsTask = FryEggsAsync(2);

Egg eggs = await eggsTask;

Console.WriteLine("Eggs are ready");

Task<Bacon> baconTask = FryBaconAsync(3);

Bacon bacon = await baconTask;

Console.WriteLine("Bacon is ready");

Task<Toast> toastTask = ToastBreadAsync(2);

Toast toast = await toastTask;

ApplyButter(toast);

ApplyJam(toast);

Console.WriteLine("Toast is ready");

Juice oj = PourOJ();

Console.WriteLine("Oj is ready");
Console.WriteLine("Breakfast is ready!");

The preceding code won't get your breakfast ready any faster. The tasks are all await ed
as soon as they are started. Next, you can move the await statements for the bacon and
eggs to the end of the method, before serving breakfast:

C#

Coffee cup = PourCoffee();

Console.WriteLine("Coffee is ready");

Task<Egg> eggsTask = FryEggsAsync(2);

Task<Bacon> baconTask = FryBaconAsync(3);

Task<Toast> toastTask = ToastBreadAsync(2);

Toast toast = await toastTask;

ApplyButter(toast);

ApplyJam(toast);

Console.WriteLine("Toast is ready");

Juice oj = PourOJ();

Console.WriteLine("Oj is ready");

Egg eggs = await eggsTask;

Console.WriteLine("Eggs are ready");

Bacon bacon = await baconTask;

Console.WriteLine("Bacon is ready");

 Console.WriteLine("Breakfast is ready!");

The asynchronously prepared breakfast took roughly 20 minutes, this time savings is
because some tasks ran concurrently.

The preceding code works better. You start all the asynchronous tasks at once. You await
each task only when you need the results. The preceding code may be similar to code in
a web application that makes requests to different microservices, then combines the
results into a single page. You'll make all the requests immediately, then await all those
tasks and compose the web page.

Composition with tasks

You have everything ready for breakfast at the same time except the toast. Making the
toast is the composition of an asynchronous operation (toasting the bread), and
synchronous operations (adding the butter and the jam). Updating this code illustrates
an important concept:

） Importante

The composition of an asynchronous operation followed by synchronous work is an

asynchronous operation. Stated another way, if any portion of an operation is
asynchronous, the entire operation is asynchronous.
The preceding code showed you that you can use Task or Task<TResult> objects to hold
running tasks. You await each task before using its result. The next step is to create
methods that represent the combination of other work. Before serving breakfast, you
want to await the task that represents toasting the bread before adding butter and jam.
You can represent that work with the following code:

C#

static async Task<Toast> MakeToastWithButterAndJamAsync(int number)

var toast = await ToastBreadAsync(number);

ApplyButter(toast);

ApplyJam(toast);

return toast;

The preceding method has the async modifier in its signature. That signals to the
compiler that this method contains an await statement; it contains asynchronous
operations. This method represents the task that toasts the bread, then adds butter and
jam. This method returns a Task<TResult> that represents the composition of those
three operations. The main block of code now becomes:

C#

static async Task Main(string[] args)

Coffee cup = PourCoffee();

Console.WriteLine("coffee is ready");

var eggsTask = FryEggsAsync(2);

var baconTask = FryBaconAsync(3);

var toastTask = MakeToastWithButterAndJamAsync(2);

var eggs = await eggsTask;

Console.WriteLine("eggs are ready");

var bacon = await baconTask;

Console.WriteLine("bacon is ready");

var toast = await toastTask;

Console.WriteLine("toast is ready");

Juice oj = PourOJ();

Console.WriteLine("oj is ready");

Console.WriteLine("Breakfast is ready!");

The previous change illustrated an important technique for working with asynchronous
code. You compose tasks by separating the operations into a new method that returns a
task. You can choose when to await that task. You can start other tasks concurrently.

Asynchronous exceptions
Up to this point, you've implicitly assumed that all these tasks complete successfully.
Asynchronous methods throw exceptions, just like their synchronous counterparts.
Asynchronous support for exceptions and error handling strives for the same goals as
asynchronous support in general: You should write code that reads like a series of
synchronous statements. Tasks throw exceptions when they can't complete successfully.
The client code can catch those exceptions when a started task is awaited . For example,
let's assume that the toaster catches fire while making the toast. You can simulate that
by modifying the ToastBreadAsync method to match the following code:

C#

private static async Task<Toast> ToastBreadAsync(int slices)

for (int slice = 0; slice < slices; slice++)

Console.WriteLine("Putting a slice of bread in the toaster");

Console.WriteLine("Start toasting...");

await Task.Delay(2000);

Console.WriteLine("Fire! Toast is ruined!");

throw new InvalidOperationException("The toaster is on fire");

await Task.Delay(1000);

Console.WriteLine("Remove toast from toaster");

return new Toast();

７ Nota

You'll get a warning when you compile the preceding code regarding unreachable
code. That's intentional, because once the toaster catches fire, operations won't
proceed normally.

Run the application after making these changes, and you'll output similar to the
following text:

Consola
 Pouring coffee

Coffee is ready

Warming the egg pan...

putting 3 slices of bacon in the pan

Cooking first side of bacon...

Putting a slice of bread in the toaster

Putting a slice of bread in the toaster

Start toasting...

Fire! Toast is ruined!

Flipping a slice of bacon

Flipping a slice of bacon

Flipping a slice of bacon

Cooking the second side of bacon...

Cracking 2 eggs

Cooking the eggs ...

Put bacon on plate

Put eggs on plate

Eggs are ready

Bacon is ready

Unhandled exception. System.InvalidOperationException: The toaster is on

fire

at AsyncBreakfast.Program.ToastBreadAsync(Int32 slices) in
Program.cs:line 65

at AsyncBreakfast.Program.MakeToastWithButterAndJamAsync(Int32 number) in
Program.cs:line 36

at AsyncBreakfast.Program.Main(String[] args) in Program.cs:line 24

at AsyncBreakfast.Program.<Main>(String[] args)

You'll notice quite a few tasks are completed between when the toaster catches fire and
the exception is observed. When a task that runs asynchronously throws an exception,
that Task is faulted. The Task object holds the exception thrown in the Task.Exception
property. Faulted tasks throw an exception when they're awaited.

There are two important mechanisms to understand: how an exception is stored in a

faulted task, and how an exception is unpackaged and rethrown when code awaits a
faulted task.

When code running asynchronously throws an exception, that exception is stored in the
Task . The Task.Exception property is a System.AggregateException because more than

one exception may be thrown during asynchronous work. Any exception thrown is
added to the AggregateException.InnerExceptions collection. If that Exception property
is null, a new AggregateException is created and the thrown exception is the first item in
the collection.

The most common scenario for a faulted task is that the Exception property contains
exactly one exception. When code awaits a faulted task, the first exception in the
AggregateException.InnerExceptions collection is rethrown. That's why the output from
this example shows an InvalidOperationException instead of an AggregateException .
Extracting the first inner exception makes working with asynchronous methods as
similar as possible to working with their synchronous counterparts. You can examine the
Exception property in your code when your scenario may generate multiple exceptions.

Before going on, comment out these two lines in your ToastBreadAsync method. You
don't want to start another fire:

C#

Console.WriteLine("Fire! Toast is ruined!");

throw new InvalidOperationException("The toaster is on fire");

Await tasks efficiently

The series of await statements at the end of the preceding code can be improved by
using methods of the Task class. One of those APIs is WhenAll, which returns a Task that
completes when all the tasks in its argument list have completed, as shown in the
following code:

C#

await Task.WhenAll(eggsTask, baconTask, toastTask);

Console.WriteLine("Eggs are ready");

Console.WriteLine("Bacon is ready");

Console.WriteLine("Toast is ready");

Console.WriteLine("Breakfast is ready!");

Another option is to use WhenAny, which returns a Task<Task> that completes when
any of its arguments complete. You can await the returned task, knowing that it has
already finished. The following code shows how you could use WhenAny to await the
first task to finish and then process its result. After processing the result from the
completed task, you remove that completed task from the list of tasks passed to
WhenAny .

C#

var breakfastTasks = new List<Task> { eggsTask, baconTask, toastTask };

while (breakfastTasks.Count > 0)

Task finishedTask = await Task.WhenAny(breakfastTasks);

if (finishedTask == eggsTask)

Console.WriteLine("Eggs are ready");

else if (finishedTask == baconTask)

Console.WriteLine("Bacon is ready");

else if (finishedTask == toastTask)

Console.WriteLine("Toast is ready");

await finishedTask;

breakfastTasks.Remove(finishedTask);

Near the end, you see the line await finishedTask; . The line await Task.WhenAny
doesn't await the finished task. It await s the Task returned by Task.WhenAny . The result
of Task.WhenAny is the task that has completed (or faulted). You should await that task
again, even though you know it's finished running. That's how you retrieve its result, or
ensure that the exception causing it to fault gets thrown.

After all those changes, the final version of the code looks like this:

C#

using System;

using System.Collections.Generic;
using System.Threading.Tasks;

namespace AsyncBreakfast

// These classes are intentionally empty for the purpose of this

example. They are simply marker classes for the purpose of demonstration,
contain no properties, and serve no other purpose.

internal class Bacon { }

internal class Coffee { }

internal class Egg { }

internal class Juice { }

internal class Toast { }

class Program

 static async Task Main(string[] args)

Coffee cup = PourCoffee();

Console.WriteLine("coffee is ready");

var eggsTask = FryEggsAsync(2);

var baconTask = FryBaconAsync(3);

var toastTask = MakeToastWithButterAndJamAsync(2);

var breakfastTasks = new List<Task> { eggsTask, baconTask,

toastTask };

while (breakfastTasks.Count > 0)

Task finishedTask = await Task.WhenAny(breakfastTasks);

if (finishedTask == eggsTask)

Console.WriteLine("eggs are ready");

else if (finishedTask == baconTask)

Console.WriteLine("bacon is ready");

else if (finishedTask == toastTask)

Console.WriteLine("toast is ready");

await finishedTask;

breakfastTasks.Remove(finishedTask);

Juice oj = PourOJ();

Console.WriteLine("oj is ready");

Console.WriteLine("Breakfast is ready!");
}

static async Task<Toast> MakeToastWithButterAndJamAsync(int number)

var toast = await ToastBreadAsync(number);

ApplyButter(toast);

ApplyJam(toast);

return toast;

private static Juice PourOJ()

Console.WriteLine("Pouring orange juice");

return new Juice();

private static void ApplyJam(Toast toast) =>

Console.WriteLine("Putting jam on the toast");

private static void ApplyButter(Toast toast) =>

Console.WriteLine("Putting butter on the toast");

 private static async Task<Toast> ToastBreadAsync(int slices)

for (int slice = 0; slice < slices; slice++)

Console.WriteLine("Putting a slice of bread in the

toaster");

Console.WriteLine("Start toasting...");

await Task.Delay(3000);

Console.WriteLine("Remove toast from toaster");

return new Toast();

private static async Task<Bacon> FryBaconAsync(int slices)

Console.WriteLine($"putting {slices} slices of bacon in the

pan");

Console.WriteLine("cooking first side of bacon...");

await Task.Delay(3000);

for (int slice = 0; slice < slices; slice++)

Console.WriteLine("flipping a slice of bacon");

Console.WriteLine("cooking the second side of bacon...");

await Task.Delay(3000);

Console.WriteLine("Put bacon on plate");

return new Bacon();

private static async Task<Egg> FryEggsAsync(int howMany)

Console.WriteLine("Warming the egg pan...");

await Task.Delay(3000);

Console.WriteLine($"cracking {howMany} eggs");

Console.WriteLine("cooking the eggs ...");

await Task.Delay(3000);

Console.WriteLine("Put eggs on plate");

return new Egg();

private static Coffee PourCoffee()

Console.WriteLine("Pouring coffee");

return new Coffee();

The final version of the asynchronously prepared breakfast took roughly 15 minutes
because some tasks ran concurrently, and the code monitored multiple tasks at once
and only took action when it was needed.

This final code is asynchronous. It more accurately reflects how a person would cook a
breakfast. Compare the preceding code with the first code sample in this article. The
core actions are still clear from reading the code. You can read this code the same way
you'd read those instructions for making a breakfast at the beginning of this article. The
language features for async and await provide the translation every person makes to
follow those written instructions: start tasks as you can and don't block waiting for tasks
to complete.

Next steps
Explore real world scenarios for asynchronous programs
Modelo de programación asincrónica de
tareas
Artículo • 20/02/2023 • Tiempo de lectura: 14 minutos

Puede evitar cuellos de botella de rendimiento y mejorar la capacidad de respuesta total

de la aplicación mediante la programación asincrónica. Sin embargo, las técnicas
tradicionales para escribir aplicaciones asincrónicas pueden resultar complicadas,
haciéndolas difícil de escribir, depurar y mantener.

C# admite el enfoque simplificado, la programación asincrónica, que aprovecha la

compatibilidad asincrónica en el entorno de ejecución de .NET. El compilador realiza el
trabajo difícil que el desarrollador suele realizar y la aplicación conserva una estructura
lógica similar al código sincrónico. Como resultado, se obtienen todas las ventajas de la
programación asincrónica con una parte del trabajo.

Este tema proporciona información general sobre cuándo y cómo utilizar la

programación asincrónica e incluye vínculos que admiten temas con detalles y ejemplos.

La asincronía mejora la capacidad de respuesta

La asincronía es esencial para actividades que pueden producir bloqueos, por ejemplo,
el acceso a Internet. Tener acceso a un recurso web a veces es lento o va retrasado. Si tal
actividad queda bloqueada en un proceso sincrónico, toda la aplicación deberá esperar.
En un proceso asincrónico, la aplicación puede continuar con otro trabajo que no
dependa del recurso web hasta que finaliza la tarea que puede producir bloqueos.

En la tabla siguiente se muestran las áreas típicas donde la programación asincrónica

mejora su capacidad de respuesta. Las API enumeradas desde .NET y Windows Runtime
contienen métodos que admiten la programación asincrónica.

Área de Tipos de .NET con métodos Tipos de Windows Runtime con métodos
aplicación asincrónicos asincrónicos

Acceso web HttpClient Windows.Web.Http.HttpClient

SyndicationClient

Trabajar con JsonSerializer

StorageFile
archivos StreamReader

StreamWriter

XmlReader

XmlWriter
 Área de Tipos de .NET con métodos Tipos de Windows Runtime con métodos
aplicación asincrónicos asincrónicos

Trabajar con MediaCapture

imágenes BitmapEncoder

BitmapDecoder

Programar WCF Operaciones sincrónicas y

asincrónicas

La asincronía es especialmente valiosa para aquellas aplicaciones que obtienen acceso al

subproceso de interfaz de usuario, ya que todas las actividades relacionadas con la
interfaz de usuario normalmente comparten un único subproceso. Si se bloquea un
proceso en una aplicación sincrónica, se bloquean todos. La aplicación deja de
responder y puede que se piense que se ha producido un error cuando en realidad la
aplicación está esperando.

Cuando se usan métodos asincrónicos, la aplicación continúa respondiendo a la interfaz

de usuario. Puede cambiar el tamaño o minimizar una ventana, por ejemplo, o puede
cerrar la aplicación si no desea esperar a que finalice.

El enfoque basado en asincrónico agrega el equivalente de una transmisión automática

a la lista de opciones entre las que puede elegir al diseñar operaciones asincrónicas. Es
decir, obtiene todas las ventajas de la programación asincrónica tradicional pero con
mucho menos trabajo de desarrollador.

Los métodos asincrónicos son fáciles de escribir

Las palabras clave async y await en C# son fundamentales en la programación
asincrónica. Con esas dos palabras clave, se pueden usar los recursos de .NET
Framework, .NET Core o Windows Runtime para crear un método asincrónico casi tan
fácilmente como se crea un método sincrónico. Los métodos asincrónicos que se
definen mediante la palabra clave async se denominan métodos asincrónicos.

En el ejemplo siguiente se muestra un método asincrónico. Prácticamente todos los

elementos del código deberían resultarle familiares.

Puede encontrar un ejemplo completo de Windows Presentation Foundation (WPF)

disponible para su descarga en el artículo Programación asincrónica con async y await
en C#.

C#
 public async Task<int> GetUrlContentLengthAsync()

var client = new HttpClient();

Task<string> getStringTask =

client.GetStringAsync("https://docs.microsoft.com/dotnet");

DoIndependentWork();

string contents = await getStringTask;

return contents.Length;

void DoIndependentWork()

Console.WriteLine("Working...");

Del ejemplo anterior puede obtener información sobre varios procedimientos.

Comience con la firma del método. Incluye el modificador async . El tipo de valor
devuelto es Task<int> (vea la sección "Tipos de valor devuelto" para obtener más
opciones). El nombre del método termina en Async . En el cuerpo del método,
GetStringAsync devuelve un elemento Task<string> . Esto significa que, cuando se

aplica await a la tarea, se obtiene un elemento string ( contents ). Antes de la espera

de la tarea, puede realizar otras acciones que no se basen en el elemento string de
GetStringAsync .

Preste mucha atención al operador await . Suspende a GetUrlContentLengthAsync :

GetUrlContentLengthAsync no puede continuar hasta que se complete

getStringTask .
Mientras tanto, el control vuelve al autor de la llamada de
GetUrlContentLengthAsync .
Aquí se reanuda el control cuando se completa getStringTask .
Después, el operador await recupera el resultado string de getStringTask .

La instrucción return especifica un resultado entero. Los métodos que están a la espera
de GetUrlContentLengthAsync recuperan el valor de longitud.

Si GetUrlContentLengthAsync no hay ningún trabajo que se pueda hacer entre llamar a

GetStringAsync y esperar a su finalización, se puede simplificar el código llamando y

esperando en la siguiente instrucción única.

C#
 string contents = await
client.GetStringAsync("https://learn.microsoft.com/dotnet");

Las siguientes características resumen lo que hace que el ejemplo anterior sea un
método asincrónico:

Method Signature incluye un modificador async .

El nombre de un método asincrónico, por convención, finaliza con un sufijo

“Async”.

El tipo de valor devuelto es uno de los tipos siguientes:

Task<TResult> si el método tiene una instrucción return en la que el operando
tiene el tipo TResult .
Task si el método no tiene ninguna instrucción return ni tiene una instrucción
return sin operando.
void si está escribiendo un controlador de eventos asincrónicos.
Cualquier otro tipo que tenga un método GetAwaiter .

Para obtener más información, consulte la sección Tipos de valor devuelto y

parámetros.

El método normalmente incluye al menos una expresión await , que marca un

punto en el que el método no puede continuar hasta que se completa la operación
asincrónica en espera. Mientras tanto, se suspende el método y el control vuelve al
llamador del método. La sección siguiente de este tema muestra lo que sucede en
el punto de suspensión.

En métodos asincrónicos, se utilizan las palabras clave y los tipos proporcionados para
indicar lo que se desea hacer y el compilador realiza el resto, incluido el seguimiento de
qué debe ocurrir cuando el control vuelve a un punto de espera en un método
suspendido. Algunos procesos de rutina, tales como bucles y control de excepciones,
pueden ser difíciles de controlar en código asincrónico tradicional. En un método
asincrónico, se pueden escribir estos elementos como se haría en una solución
sincrónica y se resuelve este problema.

Para obtener más información sobre la asincronía en versiones anteriores de .NET

Framework, vea TPL y la programación asincrónica tradicional de .NET Framework.

Lo que ocurre en un método asincrónico

Lo más importante de entender en la programación asincrónica es cómo el flujo de
control pasa de un método a otro. El diagrama siguiente lo guía en el proceso:

Los números del diagrama se corresponden con los pasos siguientes, que se inician
cuando un método de llamada llama al método asincrónico.

1. Un método de llamada llama al método asincrónico GetUrlContentLengthAsync y lo

espera.

2. GetUrlContentLengthAsync crea una instancia HttpClient y llama al método

asincrónico GetStringAsync para descargar el contenido de un sitio web como una
cadena.

3. Sucede algo en GetStringAsync que suspende el progreso. Quizás debe esperar a

un sitio web para realizar la descarga o alguna otra actividad de bloqueo. Para
evitar el bloqueo de recursos, GetStringAsync genera un control a su llamador,
GetUrlContentLengthAsync .

GetStringAsync devuelve un elemento Task<TResult>, donde TResult es una

cadena y GetUrlContentLengthAsync asigna la tarea a la variable getStringTask . La
tarea representa el proceso actual para la llamada a GetStringAsync , con el
compromiso de generar un valor de cadena real cuando se completa el trabajo.

4. Debido a que getStringTask no se ha esperado, GetUrlContentLengthAsync puede

continuar con otro trabajo que no dependa del resultado final de GetStringAsync .
 Ese trabajo se representa mediante una llamada al método sincrónico
DoIndependentWork .

5. DoIndependentWork es un método sincrónico que funciona y vuelve al llamador.

6. GetUrlContentLengthAsync se ha quedado sin el trabajo que se puede realizar sin

un resultado de getStringTask . Después, GetUrlContentLengthAsync desea calcular
y devolver la longitud de la cadena descargada, pero el método no puede calcular
ese valor hasta que el método tiene la cadena.

Por consiguiente, GetUrlContentLengthAsync utiliza un operador await para

suspender el progreso y producir el control al método que llamó
GetUrlContentLengthAsync . GetUrlContentLengthAsync devuelve Task<int> al

llamador. La tarea representa una sugerencia para generar un resultado entero que
es la longitud de la cadena descargada.

７ Nota

Si GetStringAsync (y, por tanto, getStringTask ) se completa antes de que

GetUrlContentLengthAsync lo espere, el control permanece en

GetUrlContentLengthAsync . El gasto de suspensión y de regresar a

GetUrlContentLengthAsync se desperdiciaría si el proceso asincrónico

getStringTask al que se llama ya se ha completado y

GetUrlContentLengthAsync no tiene que esperar el resultado final.

Dentro del método de llamada, el patrón de procesamiento continúa. El llamador

puede hacer otro trabajo que no depende del resultado de
GetUrlContentLengthAsync antes de esperar ese resultado, o es posible que el

llamador se espere inmediatamente. El método de llamada espera a

GetUrlContentLengthAsync , y GetUrlContentLengthAsync espera a GetStringAsync .

7. GetStringAsync completa y genera un resultado de la cadena. La llamada a

GetStringAsync no devuelve el resultado de la cadena de la manera que cabría
esperar. (Recuerde que el método ya devolvió una tarea en el paso 3). En su lugar,
el resultado de la cadena se almacena en la tarea que representa la finalización del
método, getStringTask . El operador await recupera el resultado de getStringTask .
La instrucción de asignación asigna el resultado recuperado a contents .

8. Cuando GetUrlContentLengthAsync tiene el resultado de la cadena, el método

puede calcular la longitud de la cadena. El trabajo de GetUrlContentLengthAsync
también se completa y el controlador de eventos que espera se puede reanudar.
 En el ejemplo completo del final de este tema, puede comprobar que el
controlador de eventos recupera e imprime el valor de resultado de longitud.
Si no
está familiarizado con la programación asincrónica, reserve un minuto para ver la
diferencia entre el comportamiento sincrónico y asincrónico. Un método
sincrónico devuelve cuando se completa su trabajo (paso 5), pero un método
asincrónico devuelve un valor de tarea cuando se suspende el trabajo (pasos 3 y 6).
Cuando el método asincrónico completa finalmente el trabajo, se marca la tarea
como completa y el resultado, si existe, se almacena en la tarea.

Métodos asincrónicos de API

Tal vez se pregunte dónde encontrar métodos como GetStringAsync que sean
compatibles con la programación asincrónica. .NET Framework 4.5 o versiones
posteriores y .NET Core contienen muchos miembros que trabajan con async y await .
Puede reconocerlos por el sufijo "Async" que se anexa al nombre del miembro y por su
tipo de valor devuelto Task o Task<TResult>. Por ejemplo, la clase System.IO.Stream
contiene métodos como CopyToAsync, ReadAsync y WriteAsync junto con los métodos
sincrónicos CopyTo, Read y Write.

Windows Runtime también contiene muchos métodos que puede utilizar con async y
await en Aplicaciones Windows. Para más información, consulte Subprocesamiento y

programación asincrónica para el desarrollo con UWP, y Programación asincrónica

(aplicaciones de la Tienda Windows) y Guía de inicio rápido: Llamadas a API asincrónicas
en C# o Visual Basic si usa versiones anteriores de Windows Runtime.

Subprocesos
La intención de los métodos Async es ser aplicaciones que no pueden producir
bloqueos. Una expresión await en un método asincrónico no bloquea el subproceso
actual mientras la tarea esperada se encuentra en ejecución. En vez de ello, la expresión
declara el resto del método como una continuación y devuelve el control al llamador del
método asincrónico.

Las palabras clave async y await no hacen que se creen subprocesos adicionales. Los
métodos Async no requieren multithreading, ya que un método asincrónico no se
ejecuta en su propio subproceso. El método se ejecuta en el contexto de sincronización
actual y ocupa tiempo en el subproceso únicamente cuando el método está activo.
Puede utilizar Task.Run para mover el trabajo enlazado a la CPU a un subproceso en
segundo plano, pero un subproceso en segundo plano no ayuda con un proceso que
solo está esperando a que los resultados estén disponibles.
El enfoque basado en asincrónico en la programación asincrónica es preferible a los
enfoques existentes en casi todos los casos. En concreto, este enfoque es mejor que la
clase BackgroundWorker para las operaciones enlazadas a E/S porque el código es más
sencillo y no se tiene que proteger contra las condiciones de carrera. Junto con el
método Task.Run, la programación asincrónica es mejor que BackgroundWorker para las
operaciones enlazadas a la CPU, ya que la programación asincrónica separa los detalles
de coordinación en la ejecución del código del trabajo que Task.Run transfiere al grupo
de subprocesos.

async y await
Si especifica que un método es un método asincrónico mediante el modificador async,
habilita las dos funciones siguientes.

El método asincrónico marcado puede utilizar await para designar puntos de

suspensión. El operador await indica al compilador que el método asincrónico no
puede continuar pasado ese punto hasta que se complete el proceso asincrónico
aguardado. Mientras tanto, el control devuelve al llamador del método
asincrónico.

La suspensión de un método asincrónico en una expresión await no constituye

una salida del método y los bloques finally no se ejecutan.

El método asincrónico marcado sí se puede esperar por los métodos que lo

llaman.

Un método asincrónico normalmente contiene una o más apariciones de un operador

await , pero la ausencia de expresiones await no causa errores de compilación. Si un

método asincrónico no usa un operador await para marcar el punto de suspensión, se

ejecuta como un método sincrónico, a pesar del modificador async . El compilador
detecta una advertencia para dichos métodos.

async y await son palabras clave contextuales. Para mayor información y ejemplos, vea
los siguientes temas:

async
await

Tipos de valor devuelto y parámetros

Un método asincrónico suele devolver Task o Task<TResult>. Dentro de un método
asincrónico, se aplica un operador await a una tarea que devuelve una llamada a otro
método asincrónico.

Puede especificar Task<TResult> como el tipo de valor devuelto si el método contiene

una instrucción return en la que se especifica un operando de tipo TResult .

Puede utilizar Task como tipo de valor devuelto si el método no tiene instrucción return
o tiene una instrucción return que no devuelve un operando.

También puede especificar cualquier otro tipo de valor devuelto, siempre que dicho tipo
incluya un método GetAwaiter . Un ejemplo de este tipo es ValueTask<TResult>. Está
disponible en el paquete NuGet System.Threading.Tasks.Extension .

En el ejemplo siguiente se muestra cómo declarar y llamar a un método que devuelve

Task<TResult> o Task:

C#

async Task<int> GetTaskOfTResultAsync()

int hours = 0;

await Task.Delay(0);

return hours;

Task<int> returnedTaskTResult = GetTaskOfTResultAsync();

int intResult = await returnedTaskTResult;

// Single line

// int intResult = await GetTaskOfTResultAsync();

async Task GetTaskAsync()

await Task.Delay(0);

// No return statement needed

}

Task returnedTask = GetTaskAsync();

await returnedTask;

// Single line

await GetTaskAsync();

Cada tarea devuelta representa el trabajo en curso. Una tarea encapsula la información
sobre el estado del proceso asincrónico y, finalmente, el resultado final del proceso o la
excepción que el proceso provoca si no tiene éxito.
Un método asincrónico también puede tener un tipo de valor devuelto void . Este tipo
de valor devuelto se utiliza principalmente para definir controladores de eventos, donde
se requiere un tipo de valor devuelto void . Los controladores de eventos asincrónicos
sirven a menudo como punto de partida para programas asincrónicos.

No se puede esperar a un método asincrónico que tenga un tipo de valor devuelto void
y el llamador de un método con tipo de valor devuelto void no puede capturar ninguna
excepción producida por este.

Un método asincrónico no puede declarar ningún parámetro in, ref o out, pero el
método puede llamar a los métodos que tienen estos parámetros. De forma similar, un
método asincrónico no puede devolver un valor por referencia, aunque puede llamar a
métodos con valores devueltos ref.

Para obtener más información y ejemplos, vea Tipos de valor devueltos asincrónicos
(C#). Para más información sobre cómo capturar excepciones en métodos asincrónicos,
vea try-catch.

Las API asincrónicas en la programación de Windows Runtime tienen uno de los

siguientes tipos de valor devuelto, que son similares a las tareas:

IAsyncOperation<TResult>, lo que equivale a Task<TResult>

IAsyncAction, lo que equivale a Task
IAsyncActionWithProgress<TProgress>
IAsyncOperationWithProgress<TResult,TProgress>

Convención de nomenclatura
Por convención, los nombres de los métodos que devuelven tipos que suelen admitir
"await" (por ejemplo, Task , Task<T> , ValueTask y ValueTask<T> ) deben terminar por
"Async". Los nombres de los métodos que inician operaciones asincrónicas, pero que no
devuelven un tipo que admite "await", no deben terminar en "Async", pero pueden
empezar por "Begin", "Start" o cualquier otro verbo para sugerir que este método no
devuelve ni genera el resultado de la operación.

Puede ignorar esta convención cuando un evento, clase base o contrato de interfaz
sugieren un nombre diferente. Por ejemplo, no se debería cambiar el nombre de los
controladores de eventos, tales como OnButtonClick .

Artículos relacionados (Visual Studio)

Título Descripción

Procedimiento para realizar varias Demuestra cómo comenzar varias tareas al mismo
solicitudes web en paralelo con async y tiempo.
await (C#)

Tipos de valor devueltos asincrónicos Muestra los tipos que los métodos asincrónicos
(C#) pueden devolver y explica cuándo es apropiado cada
uno de ellos.

Cancelación de tareas con un token de Muestra cómo agregar la siguiente funcionalidad a la

cancelación como mecanismo de solución asincrónica:

señalización.
- Cancelación de una lista de tareas (C#)

- Cancelación de tareas asincrónicas tras un período

de tiempo (C#)

- Iniciar varias tareas asincrónicas y procesarlas a

medida que se completan (C#)

Usar Async en acceso a archivos (C#) Enumera y demuestra los beneficios de usar async y
await para obtener acceso a archivos.

Modelo asincrónico basado en tareas Describe un modelo asincrónico, el patrón se basa en

(TAP) los tipos Task y Task<TResult>.

Vídeos de Async en Channel 9 Proporciona vínculos a una serie de vídeos sobre

programación asincrónica.

Vea también
Programación asincrónica con async y await
async
await
Tipos de valor devueltos asincrónicos
(C#)
Artículo • 14/02/2023 • Tiempo de lectura: 10 minutos

Los métodos asincrónicos pueden tener los siguientes tipos de valor devuelto:

Task, para un método asincrónico que realiza una operación pero no devuelve
ningún valor.
Task<TResult>, para un método asincrónico que devuelve un valor.
void , para un controlador de eventos.

Cualquier tipo que tenga un método GetAwaiter accesible. El objeto devuelto por
el método GetAwaiter debe implementar la interfaz
System.Runtime.CompilerServices.ICriticalNotifyCompletion.
IAsyncEnumerable<T>, para un método asincrónico que devuelve una secuencia
asincrónica.

Para obtener más información sobre los métodos asincrónicos, vea Programación
asincrónica con async y await (C#).

También existen varios tipos que son específicos de las cargas de trabajo de Windows:

DispatcherOperation: para las operaciones asincrónicas limitadas a Windows.

IAsyncAction, para las acciones asincrónicas en UWP que no devuelven un valor.
IAsyncActionWithProgress<TProgress>, para las acciones asincrónicas en UWP que
notifican el progreso, pero no devuelven un valor.
IAsyncOperation<TResult>: para las operaciones asincrónicas en UWP que
devuelven un valor.
IAsyncOperationWithProgress<TResult,TProgress>: para las operaciones
asincrónicas en UWP que informan del progreso y devuelven un valor.

Tipo de valor devuelto Task

Los métodos asincrónicos que no contienen una instrucción return o que contienen
una instrucción return que no devuelve un operando tienen normalmente un tipo de
valor devuelto de Task. Dichos métodos devuelven void si se ejecutan de manera
sincrónica. Si se usa un tipo de valor devuelto Task para un método asincrónico, un
método de llamada puede usar un operador await para suspender la finalización del
llamador hasta que finalice el método asincrónico llamado.
En el ejemplo siguiente, el método WaitAndApologizeAsync no contiene una instrucción
return , de manera que el método devuelve un objeto Task. La devolución de Task
permite que se espere a WaitAndApologizeAsync . El tipo Task no incluye una propiedad
Result porque no tiene ningún valor devuelto.

C#

public static async Task DisplayCurrentInfoAsync()

await WaitAndApologizeAsync();

Console.WriteLine($"Today is {DateTime.Now:D}");

Console.WriteLine($"The current time is {DateTime.Now.TimeOfDay:t}");

Console.WriteLine("The current temperature is 76 degrees.");

static async Task WaitAndApologizeAsync()

await Task.Delay(2000);

Console.WriteLine("Sorry for the delay...\n");

// Example output:

// Sorry for the delay...

//

// Today is Monday, August 17, 2020

// The current time is 12:59:24.2183304

// The current temperature is 76 degrees.

Se espera a WaitAndApologizeAsync mediante una instrucción await en lugar de una

expresión await, similar a la instrucción de llamada para un método sincrónico que
devuelve void. En este caso, la aplicación de un operador await no genera un valor.
Cuando el operando derecho de await es Task<TResult>, la expresión await genera un
resultado de T . Cuando el operando derecho de await es Task, await y su operando
son una instrucción.

Puede separar la llamada a WaitAndApologizeAsync desde la aplicación de un operador

await, como muestra el código siguiente. Pero recuerde que una Task no tiene una
propiedad Result y que no se genera ningún valor cuando se aplica un operador await
a una Task .

El código siguiente separa la llamada del método WaitAndApologizeAsync de la espera

de la tarea que el método devuelve.

C#
 Task waitAndApologizeTask = WaitAndApologizeAsync();

string output =

$"Today is {DateTime.Now:D}\n" +

$"The current time is {DateTime.Now.TimeOfDay:t}\n" +

"The current temperature is 76 degrees.\n";

await waitAndApologizeTask;

Console.WriteLine(output);

Tipo de valor devuelto Task<TResult>

El tipo de valor devuelto Task<TResult> se usa para un método asincrónico que
contiene una instrucción return en la que el operando es TResult .

En el ejemplo siguiente, el método GetLeisureHoursAsync contiene una instrucción

return que devuelve un entero. La declaración del método debe tener un tipo de valor

devuelto de Task<int> . El método asincrónico FromResult es un marcador de posición

para una operación que devuelve una propiedad DayOfWeek.

C#

public static async Task ShowTodaysInfoAsync()

string message =

$"Today is {DateTime.Today:D}\n" +

"Today's hours of leisure: " +

$"{await GetLeisureHoursAsync()}";

Console.WriteLine(message);

static async Task<int> GetLeisureHoursAsync()

DayOfWeek today = await Task.FromResult(DateTime.Now.DayOfWeek);

int leisureHours =

today is DayOfWeek.Saturday || today is DayOfWeek.Sunday

? 16 : 5;

return leisureHours;

// Example output:

// Today is Wednesday, May 24, 2017

// Today's hours of leisure: 5

Cuando se llama a GetLeisureHoursAsync desde una expresión await en el método
ShowTodaysInfo , esta recupera el valor entero (el valor de leisureHours ) que está
almacenado en la tarea que devuelve el método GetLeisureHours . Para más información
sobre las expresiones await, vea await.

Puede comprender mejor cómo await recupera el resultado de Task<T> si separa la

llamada a GetLeisureHoursAsync de la aplicación de await , como se muestra en el
código siguiente. Una llamada al método GetLeisureHoursAsync que no se espera
inmediatamente devuelve Task<int> , como se podría esperar de la declaración del
método. La tarea se asigna a la variable getLeisureHoursTask en el ejemplo. Dado que
getLeisureHoursTask es Task<TResult>, contiene una propiedad Result de tipo TResult .

En este caso, TResult representa un tipo entero. Cuando await se aplica a

getLeisureHoursTask , la expresión await se evalúa en el contenido de la propiedad
Result de getLeisureHoursTask . El valor se asigna a la variable ret .

） Importante

La propiedad Result es una propiedad de bloqueo. Si se intenta acceder a ella

antes de que termine su tarea, se bloquea el subproceso que está activo
actualmente hasta que finaliza la tarea y el valor está disponible. En la mayoría de
los casos, se debe tener acceso al valor usando await en lugar de tener acceso
directamente a la propiedad.

En el ejemplo anterior se ha recuperado el valor de la propiedad Result para

bloquear el subproceso principal de manera que el método Main pueda imprimir el
mensaje ( message ) en la consola antes de que finalice la aplicación.

C#

var getLeisureHoursTask = GetLeisureHoursAsync();

string message =

$"Today is {DateTime.Today:D}\n" +

"Today's hours of leisure: " +

$"{await getLeisureHoursTask}";

Console.WriteLine(message);

Tipo de valor devuelto Void

Usa el tipo de valor devuelto void en controladores de eventos asincrónicos, que
necesitan un tipo de valor devuelto void . Para métodos que no sean controladores de
eventos que no devuelven un valor, debe devolver Task en su lugar, porque no se espera
a un método asincrónico que devuelva void . Cualquiera que realice la llamada a este
método debe continuar hasta completarse sin esperar a que finalice el método
asincrónico que se haya llamado. El autor de la llamada debe ser independiente de los
valores o las excepciones que genere el método asincrónico.

El autor de la llamada de un método asincrónico que devuelva void no puede detectar

las excepciones que inicia el método. Es probable que estas excepciones no controladas
provoquen un error en la aplicación. Si un método que devuelve un valor Task o
Task<TResult> inicia una excepción, la excepción se almacena en la tarea devuelta. La
excepción se vuelve a iniciar cuando se espera a la tarea. Asegúrese de que cualquier
método asincrónico que puede iniciar una excepción tiene un tipo de valor devuelto de
Task o Task<TResult>, y que se esperan las llamadas al método.

Para obtener más información sobre cómo capturar excepciones en métodos

asincrónicos, vea la sección Excepciones en métodos asincrónicos del artículo try-catch.

En el ejemplo siguiente se muestra el comportamiento de un controlador de eventos

asincrónicos. En el código de ejemplo, un controlador de eventos asincrónicos debe
informar al subproceso principal de que ha terminado. Después, el subproceso principal
puede esperar a que un controlador de eventos asincrónicos finalice antes de salir del
programa.

C#

public class NaiveButton

public event EventHandler? Clicked;

public void Click()

Console.WriteLine("Somebody has clicked a button. Let's raise the

event...");

Clicked?.Invoke(this, EventArgs.Empty);

Console.WriteLine("All listeners are notified.");

public class AsyncVoidExample

static readonly TaskCompletionSource<bool> s_tcs = new

TaskCompletionSource<bool>();

public static async Task MultipleEventHandlersAsync()

 Task<bool> secondHandlerFinished = s_tcs.Task;

var button = new NaiveButton();

button.Clicked += OnButtonClicked1;

button.Clicked += OnButtonClicked2Async;

button.Clicked += OnButtonClicked3;

Console.WriteLine("Before button.Click() is called...");

button.Click();

Console.WriteLine("After button.Click() is called...");

await secondHandlerFinished;

private static void OnButtonClicked1(object? sender, EventArgs e)

Console.WriteLine(" Handler 1 is starting...");

Task.Delay(100).Wait();

Console.WriteLine(" Handler 1 is done.");

private static async void OnButtonClicked2Async(object? sender,

EventArgs e)

Console.WriteLine(" Handler 2 is starting...");

Task.Delay(100).Wait();

Console.WriteLine(" Handler 2 is about to go async...");

await Task.Delay(500);

Console.WriteLine(" Handler 2 is done.");

s_tcs.SetResult(true);

private static void OnButtonClicked3(object? sender, EventArgs e)

Console.WriteLine(" Handler 3 is starting...");

Task.Delay(100).Wait();

Console.WriteLine(" Handler 3 is done.");

// Example output:

//

// Before button.Click() is called...

// Somebody has clicked a button. Let's raise the event...

// Handler 1 is starting...

// Handler 1 is done.

// Handler 2 is starting...

// Handler 2 is about to go async...

// Handler 3 is starting...

// Handler 3 is done.

// All listeners are notified.

// After button.Click() is called...

// Handler 2 is done.

Tipos de valor devueltos asincrónicos

generalizados y ValueTask<TResult>
Un método asincrónico puede devolver cualquier tipo que tenga un método GetAwaiter
accesible que devuelva una instancia de un tipo awaiter. Además, el tipo devuelto por el
método GetAwaiter debe tener el atributo
System.Runtime.CompilerServices.AsyncMethodBuilderAttribute. Puede obtener más
información en el artículo sobre Atributos leídos por el compilador o la especificación
de características para Tarea como tipos de valor devuelto.

Esta característica es el complemento de las expresiones con await, que describe los
requisitos del operando de await . Los tipos de valor devueltos asincrónicos
generalizados permiten al compilador generar métodos async que devuelven tipos
diferentes. Los tipos de valor devueltos asincrónicos generalizados permitían mejoras de
rendimiento en las bibliotecas de .NET. Como Task y Task<TResult> son tipos de
referencia, la asignación de memoria en las rutas críticas para el rendimiento,
especialmente cuando las asignaciones se producen en ajustados bucles, puede afectar
negativamente al rendimiento. La compatibilidad para los tipos de valor devuelto
generalizados significa que puede devolver un tipo de valor ligero en lugar de un tipo
de referencia para evitar asignaciones de memoria adicionales.

.NET proporciona la estructura System.Threading.Tasks.ValueTask<TResult> como una

implementación ligera de un valor de devolución de tareas generalizado. Para usar el
tipo System.Threading.Tasks.ValueTask<TResult>, debe agregar el paquete NuGet de
System.Threading.Tasks.Extensions a su proyecto. En el ejemplo siguiente se usa la

estructura ValueTask<TResult> para recuperar el valor de dos tiradas de dado.

C#

class Program

static readonly Random s_rnd = new Random();

static async Task Main() =>

Console.WriteLine($"You rolled {await GetDiceRollAsync()}");

static async ValueTask<int> GetDiceRollAsync()

Console.WriteLine("Shaking dice...");

int roll1 = await RollAsync();

int roll2 = await RollAsync();

return roll1 + roll2;

 static async ValueTask<int> RollAsync()

await Task.Delay(500);

int diceRoll = s_rnd.Next(1, 7);

return diceRoll;

// Example output:

// Shaking dice...

// You rolled 8

La escritura de un tipo de valor devuelto asincrónico generalizado es un escenario

avanzado y está destinado para su uso en entornos especializados. En su lugar,
considere la posibilidad de usar los tipos Task , Task<T> y ValueTask<T> , que abarcan la
mayoría de los escenarios del código asincrónico.

En C# 10 y versiones posteriores, se puede aplicar el atributo AsyncMethodBuilder a un

método asincrónico (en lugar de la declaración de tipo de valor devuelto asincrónico)
para invalidar el generador de ese tipo. Normalmente, este atributo se aplica para usar
un generador diferente proporcionado en el entorno de ejecución de .NET.

Secuencias asincrónicas con

IAsyncEnumerable<T>
Un método asincrónico puede devolver una secuencia asincrónica, representada por
IAsyncEnumerable<T>. Una secuencia asincrónica proporciona una manera de
enumerar los elementos leídos de una secuencia cuando se generan elementos en
fragmentos con llamadas asincrónicas repetidas. En el ejemplo siguiente se muestra un
método asincrónico que genera una secuencia asincrónica:

C#

static async IAsyncEnumerable<string> ReadWordsFromStreamAsync()

string data =

@"This is a line of text.

Here is the second line of text.

And there is one more for good measure.

Wait, that was the penultimate line.";

using var readStream = new StringReader(data);

string? line = await readStream.ReadLineAsync();

while (line != null)

foreach (string word in line.Split(' ',

StringSplitOptions.RemoveEmptyEntries))

yield return word;

line = await readStream.ReadLineAsync();

En el ejemplo anterior, las líneas de una cadena se leen de forma asincrónica. Una vez
que se ha leído cada línea, el código enumera cada palabra de la cadena. Los autores de
la llamada enumerarían cada palabra mediante la instrucción await foreach . El método
espera cuando necesita leer de forma asincrónica la línea siguiente de la cadena de
origen.

Vea también
FromResult
Procesamiento de tareas asincrónicas a medida que se completan
Programación asincrónica con async y await (C#)
async
await
Cancelar una lista de tareas
Artículo • 20/02/2023 • Tiempo de lectura: 5 minutos

Puede cancelar una aplicación de consola asincrónica si no quiere esperar a que

termine. Mediante el ejemplo de este tema, puede agregar una cancelación a una
aplicación que descargue el contenido de una lista de sitios web. Puede cancelar
muchas tareas asociando la instancia de CancellationTokenSource a cada tarea. Si se
presiona la tecla Entrar , se cancelan todas las tareas que aún no se han completado.

Esta tutorial abarca lo siguiente:

＂ Creación de una aplicación de consola de .NET

＂ Escritura de una aplicación asincrónica que admite la cancelación
＂ Demostración de la señalización de una cancelación

Requisitos previos
Este tutorial requiere lo siguiente:

.NET 5 o un SDK posterior

Entorno de desarrollo integrado (IDE)
Se recomienda usar Visual Studio, Visual Studio Code o Visual Studio para
Mac .

Creación de una aplicación de ejemplo

Cree una nueva aplicación de consola de .NET Core. Puede crear una mediante el
comando dotnet new console o desde Visual Studio. Abra el archivo Program.cs en su
editor de código favorito.

Reemplazo de instrucciones using

Reemplace las instrucciones using existentes por estas declaraciones:

C#

using System;

using System.Collections.Generic;
using System.Diagnostics;

using System.Net.Http;

using System.Threading;

using System.Threading.Tasks;

Adición de campos
Dentro de la definición de la clase Program , agregue estos tres campos:

C#

static readonly CancellationTokenSource s_cts = new

CancellationTokenSource();

static readonly HttpClient s_client = new HttpClient

MaxResponseContentBufferSize = 1_000_000

};

static readonly IEnumerable<string> s_urlList = new string[]

"https://learn.microsoft.com",

"https://learn.microsoft.com/aspnet/core",

"https://learn.microsoft.com/azure",

"https://learn.microsoft.com/azure/devops",

"https://learn.microsoft.com/dotnet",

"https://learn.microsoft.com/dynamics365",

"https://learn.microsoft.com/education",

"https://learn.microsoft.com/enterprise-mobility-security",

"https://learn.microsoft.com/gaming",

"https://learn.microsoft.com/graph",

"https://learn.microsoft.com/microsoft-365",

"https://learn.microsoft.com/office",

"https://learn.microsoft.com/powershell",

"https://learn.microsoft.com/sql",

"https://learn.microsoft.com/surface",

"https://learn.microsoft.com/system-center",

"https://learn.microsoft.com/visualstudio",

"https://learn.microsoft.com/windows",

"https://learn.microsoft.com/xamarin"

};

CancellationTokenSource se usa para indicar una cancelación solicitada a un token de

cancelación (CancellationToken). HttpClient expone la capacidad de enviar solicitudes
HTTP y de recibir respuestas HTTP. s_urlList contiene todas las direcciones URL que
planea procesar la aplicación.

Actualización del punto de entrada de la

aplicación
El punto de entrada principal de la aplicación de consola es el método Main . Reemplace
el método existente por lo siguiente:

C#

static async Task Main()

Console.WriteLine("Application started.");

Console.WriteLine("Press the ENTER key to cancel...\n");

Task cancelTask = Task.Run(() =>

while (Console.ReadKey().Key != ConsoleKey.Enter)

Console.WriteLine("Press the ENTER key to cancel...");

}

Console.WriteLine("\nENTER key pressed: cancelling downloads.\n");

s_cts.Cancel();

});

Task finishedTask = await Task.WhenAny(new[] { cancelTask,

sumPageSizesTask });

if (finishedTask == cancelTask)

// wait for the cancellation to take place:

try

await sumPageSizesTask;

Console.WriteLine("Download task completed before cancel

request was processed.");

catch (TaskCanceledException)

Console.WriteLine("Download task has been cancelled.");

Console.WriteLine("Application ending.");

El método Main actualizado ahora se considera un método Async main, el cual permite
un punto de entrada asincrónico en el archivo ejecutable. Escribe algunos mensajes
informativos en la consola y, luego, declara una instancia de Task denominada
cancelTask , la cual leerá las pulsaciones de teclas de la consola. Si se presiona la tecla

Entrar , se realiza una llamada a CancellationTokenSource.Cancel(). Esto indicará la

cancelación. Después, se asigna la variable sumPageSizesTask desde el método
SumPageSizesAsync y ambas tareas se pasan a Task.WhenAny(Task[]), que continuará

cuando se complete cualquiera de las dos tareas.

El siguiente bloque de código garantiza que la aplicación no salga hasta que se haya
procesado la cancelación. Si la primera tarea que se va a completar es cancelTask , se
suspende sumPageSizeTask con await. Si se ha cancelado, cuando se esperaba que se
hubiera suspendido con await, produce una excepción
System.Threading.Tasks.TaskCanceledException. El bloque detecta esa excepción e
imprime un mensaje.

Creación de un método SumPageSizes

asincrónico
Agregue el método SumPageSizesAsync después del método Main :

C#

static async Task SumPageSizesAsync()

var stopwatch = Stopwatch.StartNew();

int total = 0;

foreach (string url in s_urlList)

int contentLength = await ProcessUrlAsync(url, s_client,

s_cts.Token);

total += contentLength;

stopwatch.Stop();

Console.WriteLine($"\nTotal bytes returned: {total:#,#}");

Console.WriteLine($"Elapsed time: {stopwatch.Elapsed}\n");

El método comienza creando una instancia e iniciando una clase Stopwatch. Luego,
recorre en bucle cada dirección URL en s_urlList y llama a ProcessUrlAsync . Con cada
iteración, se pasa el token s_cts.Token al método ProcessUrlAsync y el código devuelve
una clase Task<TResult>, donde TResult es un entero:

C#

int total = 0;

foreach (string url in s_urlList)

int contentLength = await ProcessUrlAsync(url, s_client, s_cts.Token);

total += contentLength;

Adición de un método de proceso

Agregue el siguiente método ProcessUrlAsync después del método SumPageSizesAsync :

C#

static async Task<int> ProcessUrlAsync(string url, HttpClient client,

CancellationToken token)

HttpResponseMessage response = await client.GetAsync(url, token);

byte[] content = await response.Content.ReadAsByteArrayAsync(token);

Console.WriteLine($"{url,-60} {content.Length,10:#,#}");

return content.Length;

Para cualquier dirección URL, el método usará la instancia de client proporcionada

para obtener la respuesta como byte[] . La instancia de CancellationToken se pasa a los
métodos HttpClient.GetAsync(String, CancellationToken) y
HttpContent.ReadAsByteArrayAsync(). El token ( token ) se usa para registrar la
cancelación solicitada. La longitud se devuelve después de que la dirección URL y la
longitud se escriban en la consola.

Ejemplo de resultado de la aplicación

Consola

Application started.

Press the ENTER key to cancel...

https://learn.microsoft.com 37,357

https://learn.microsoft.com/aspnet/core 85,589

https://learn.microsoft.com/azure 398,939

https://learn.microsoft.com/azure/devops 73,663

https://learn.microsoft.com/dotnet 67,452

https://learn.microsoft.com/dynamics365 48,582

https://learn.microsoft.com/education 22,924

ENTER key pressed: cancelling downloads.

Application ending.

Ejemplo completo
El código siguiente es el texto completo del archivo Program.cs para el ejemplo.
C#

using System.Diagnostics;

class Program

static readonly CancellationTokenSource s_cts = new

CancellationTokenSource();

static readonly HttpClient s_client = new HttpClient

MaxResponseContentBufferSize = 1_000_000

};

static readonly IEnumerable<string> s_urlList = new string[]

"https://docs.microsoft.com",

"https://docs.microsoft.com/aspnet/core",

"https://docs.microsoft.com/azure",

"https://docs.microsoft.com/azure/devops",

"https://docs.microsoft.com/dotnet",

"https://docs.microsoft.com/dynamics365",

"https://docs.microsoft.com/education",

"https://docs.microsoft.com/enterprise-mobility-security",

"https://docs.microsoft.com/gaming",

"https://docs.microsoft.com/graph",

"https://docs.microsoft.com/microsoft-365",

"https://docs.microsoft.com/office",

"https://docs.microsoft.com/powershell",

"https://docs.microsoft.com/sql",

"https://docs.microsoft.com/surface",

"https://docs.microsoft.com/system-center",

"https://docs.microsoft.com/visualstudio",

"https://docs.microsoft.com/windows",

"https://docs.microsoft.com/xamarin"

};

static async Task Main()

Console.WriteLine("Application started.");

Console.WriteLine("Press the ENTER key to cancel...\n");

Task cancelTask = Task.Run(() =>

while (Console.ReadKey().Key != ConsoleKey.Enter)

Console.WriteLine("Press the ENTER key to cancel...");

Console.WriteLine("\nENTER key pressed: cancelling

downloads.\n");

s_cts.Cancel();

});

 Task sumPageSizesTask = SumPageSizesAsync();

Task finishedTask = await Task.WhenAny(new[] { cancelTask,

sumPageSizesTask });

if (finishedTask == cancelTask)

// wait for the cancellation to take place:

try

await sumPageSizesTask;

Console.WriteLine("Download task completed before cancel

request was processed.");

catch (TaskCanceledException)

Console.WriteLine("Download task has been cancelled.");

Console.WriteLine("Application ending.");

static async Task SumPageSizesAsync()

var stopwatch = Stopwatch.StartNew();

int total = 0;

foreach (string url in s_urlList)

int contentLength = await ProcessUrlAsync(url, s_client,

s_cts.Token);

total += contentLength;

stopwatch.Stop();

Console.WriteLine($"\nTotal bytes returned: {total:#,#}");

Console.WriteLine($"Elapsed time: {stopwatch.Elapsed}\n");

static async Task<int> ProcessUrlAsync(string url, HttpClient client,

CancellationToken token)

HttpResponseMessage response = await client.GetAsync(url, token);

byte[] content = await response.Content.ReadAsByteArrayAsync(token);

Console.WriteLine($"{url,-60} {content.Length,10:#,#}");

return content.Length;

Vea también
 CancellationToken
CancellationTokenSource
Programación asincrónica con async y await (C#)

Pasos siguientes
Cancelar tareas asincrónicas tras un período de tiempo (C#)
Cancelación de tareas asincrónicas tras
un período de tiempo
Artículo • 20/02/2023 • Tiempo de lectura: 2 minutos

Puede cancelar una operación asincrónica después de un período de tiempo con el

método CancellationTokenSource.CancelAfter si no quiere esperar a que finalice la
operación. Este método programa la cancelación de las tareas asociadas que no se
completen en el período de tiempo designado por la expresión CancelAfter .

Este ejemplo se agrega al código que se desarrolla en el tutorial Cancelación de una

lista de tareas (C#) para descargar una lista de sitios web y mostrar la longitud del
contenido de cada uno de ellos.

Esta tutorial abarca lo siguiente:

＂ Actualización de una aplicación de consola .NET existente

＂ Programación de una cancelación

Requisitos previos
Este tutorial requiere lo siguiente:

Que haya creado una aplicación en el tutorial Cancelación de una lista de tareas
(C#)
.NET 5 o un SDK posterior
Entorno de desarrollo integrado (IDE)
Se recomienda usar Visual Studio, Visual Studio Code o Visual Studio para
Mac .

Actualización del punto de entrada de la

aplicación
Reemplace el método Main existente por lo siguiente:

C#

static async Task Main()

Console.WriteLine("Application started.");

try

s_cts.CancelAfter(3500);

await SumPageSizesAsync();

catch (OperationCanceledException)

Console.WriteLine("\nTasks cancelled: timed out.\n");

finally

s_cts.Dispose();

Console.WriteLine("Application ending.");

El método actualizado Main escribe algunos mensajes informativos en la consola. En la

instrucción try catch, una llamada a CancellationTokenSource.CancelAfter(Int32)
programa una cancelación. Esto indicará la cancelación pasado un período de tiempo.

Después, se espera al método SumPageSizesAsync . Si el procesamiento de todas las

direcciones URL se produce más rápido que la cancelación programada, la aplicación
finaliza. Pero si la cancelación programada se desencadena antes de que se procesen
todas las direcciones URL, se produce una excepción OperationCanceledException.

Ejemplo de resultado de la aplicación

Consola

Application started.

https://learn.microsoft.com 37,357

https://learn.microsoft.com/aspnet/core 85,589

https://learn.microsoft.com/azure 398,939

https://learn.microsoft.com/azure/devops 73,663

Tasks cancelled: timed out.

Application ending.

Ejemplo completo
El código siguiente es el texto completo del archivo Program.cs para el ejemplo.

C#
using System.Diagnostics;

class Program

static readonly CancellationTokenSource s_cts = new

CancellationTokenSource();

static readonly HttpClient s_client = new HttpClient

MaxResponseContentBufferSize = 1_000_000

};

static readonly IEnumerable<string> s_urlList = new string[]

"https://docs.microsoft.com",

"https://docs.microsoft.com/aspnet/core",

"https://docs.microsoft.com/azure",

"https://docs.microsoft.com/azure/devops",

"https://docs.microsoft.com/dotnet",

"https://docs.microsoft.com/dynamics365",

"https://docs.microsoft.com/education",

"https://docs.microsoft.com/enterprise-mobility-security",

"https://docs.microsoft.com/gaming",

"https://docs.microsoft.com/graph",

"https://docs.microsoft.com/microsoft-365",

"https://docs.microsoft.com/office",

"https://docs.microsoft.com/powershell",

"https://docs.microsoft.com/sql",

"https://docs.microsoft.com/surface",

"https://docs.microsoft.com/system-center",

"https://docs.microsoft.com/visualstudio",

"https://docs.microsoft.com/windows",

"https://docs.microsoft.com/xamarin"

};

static async Task Main()

Console.WriteLine("Application started.");

try

s_cts.CancelAfter(3500);

await SumPageSizesAsync();

catch (OperationCanceledException)

Console.WriteLine("\nTasks cancelled: timed out.\n");

finally

s_cts.Dispose();

 Console.WriteLine("Application ending.");

static async Task SumPageSizesAsync()

var stopwatch = Stopwatch.StartNew();

int total = 0;

foreach (string url in s_urlList)

int contentLength = await ProcessUrlAsync(url, s_client,

s_cts.Token);

total += contentLength;

stopwatch.Stop();

Console.WriteLine($"\nTotal bytes returned: {total:#,#}");

Console.WriteLine($"Elapsed time: {stopwatch.Elapsed}\n");

static async Task<int> ProcessUrlAsync(string url, HttpClient client,

CancellationToken token)

HttpResponseMessage response = await client.GetAsync(url, token);

byte[] content = await response.Content.ReadAsByteArrayAsync(token);

Console.WriteLine($"{url,-60} {content.Length,10:#,#}");

return content.Length;

Vea también
CancellationToken
CancellationTokenSource
Programación asincrónica con async y await (C#)
Cancelación de una lista de tareas (C#)
Iniciar varias tareas asincrónicas y
procesarlas a medida que se completan
(C#)
Artículo • 20/02/2023 • Tiempo de lectura: 9 minutos

Si usa Task.WhenAny, puede iniciar varias tareas a la vez y procesarlas una por una a
medida que se completen, en lugar de procesarlas en el orden en el que se han iniciado.

En el siguiente ejemplo se usa una consulta para crear una colección de tareas. Cada
tarea descarga el contenido de un sitio web especificado. En cada iteración de un bucle
while, una llamada awaited a WhenAny devuelve la tarea en la colección de tareas que
termine primero su descarga. Esa tarea se quita de la colección y se procesa. El bucle se
repite hasta que la colección no contiene más tareas.

Prerrequisitos
Puede seguir este tutorial mediante una de las opciones siguientes:

Visual Studio 2022 con la carga de trabajo de desarrollo de escritorio de .NET

instalada. El SDK de .NET se instala automáticamente al seleccionar esta carga de
trabajo.
SDK de .NET con un editor de código de su elección, como Visual Studio
Code .

Creación de una aplicación de ejemplo

Cree una nueva aplicación de consola de .NET Core. Puede crear una mediante el
comando dotnet new console o desde Visual Studio.

Abra el archivo Program.cs en el editor de código y reemplace el código existente por

este:

C#

using System.Diagnostics;

namespace ProcessTasksAsTheyFinish;

class Program

static void Main(string[] args)

Console.WriteLine("Hello World!");

Adición de campos
Dentro de la definición de la clase Program , agregue los dos campos siguientes:

C#

static readonly HttpClient s_client = new HttpClient

MaxResponseContentBufferSize = 1_000_000

};

static readonly IEnumerable<string> s_urlList = new string[]

"https://learn.microsoft.com",

"https://learn.microsoft.com/aspnet/core",

"https://learn.microsoft.com/azure",

"https://learn.microsoft.com/azure/devops",

"https://learn.microsoft.com/dotnet",

"https://learn.microsoft.com/dynamics365",

"https://learn.microsoft.com/education",

"https://learn.microsoft.com/enterprise-mobility-security",

"https://learn.microsoft.com/gaming",

"https://learn.microsoft.com/graph",

"https://learn.microsoft.com/microsoft-365",

"https://learn.microsoft.com/office",

"https://learn.microsoft.com/powershell",

"https://learn.microsoft.com/sql",

"https://learn.microsoft.com/surface",

"https://learn.microsoft.com/system-center",

"https://learn.microsoft.com/visualstudio",

"https://learn.microsoft.com/windows",

"https://learn.microsoft.com/xamarin"

};

HttpClient expone la capacidad de enviar solicitudes HTTP y de recibir respuestas

HTTP. s_urlList contiene todas las direcciones URL que planea procesar la aplicación.

Actualización del punto de entrada de la

aplicación
El punto de entrada principal de la aplicación de consola es el método Main . Reemplace
el método existente por lo siguiente:

C#

static Task Main() => SumPageSizesAsync();

El método Main actualizado ahora se considera un método Async main, el cual permite
un punto de entrada asincrónico en el archivo ejecutable. Se expresa como una llamada
a SumPageSizesAsync .

Creación de un método SumPageSizes

asincrónico
Agregue el método SumPageSizesAsync después del método Main :

C#

static async Task SumPageSizesAsync()

var stopwatch = Stopwatch.StartNew();

IEnumerable<Task<int>> downloadTasksQuery =

from url in s_urlList

select ProcessUrlAsync(url, s_client);

List<Task<int>> downloadTasks = downloadTasksQuery.ToList();

int total = 0;

while (downloadTasks.Any())

Task<int> finishedTask = await Task.WhenAny(downloadTasks);

downloadTasks.Remove(finishedTask);

total += await finishedTask;

stopwatch.Stop();

Console.WriteLine($"\nTotal bytes returned: {total:#,#}");

Console.WriteLine($"Elapsed time: {stopwatch.Elapsed}\n");

El bucle while quita una de las tareas de cada iteración. Una vez completadas todas las
tareas, el bucle finaliza. El método comienza creando una instancia e iniciando una clase
Stopwatch. Después, incluye una consulta que, cuando se ejecuta, crea una colección de
tareas. Cada llamada a ProcessUrlAsync en el siguiente código devuelve un objeto
Task<TResult>, donde TResult es un entero:

C#

IEnumerable<Task<int>> downloadTasksQuery =

from url in s_urlList

select ProcessUrlAsync(url, s_client);

Debido a la ejecución diferida con LINQ, se llama a Enumerable.ToList para iniciar cada
tarea.

C#

List<Task<int>> downloadTasks = downloadTasksQuery.ToList();

El bucle while realiza los pasos siguientes para cada tarea de la colección:

1. Espera una llamada a WhenAny para identificar la primera tarea de la colección que
ha finalizado su descarga.

C#

Task<int> finishedTask = await Task.WhenAny(downloadTasks);

2. Quita la tarea de la colección.

C#

downloadTasks.Remove(finishedTask);

3. Espera finishedTask , que se devuelve mediante una llamada a ProcessUrlAsync .

La variable finishedTask es un Task<TResult> donde TResult es un entero. La
tarea ya está completa, pero la espera para recuperar la longitud del sitio web
descargado, como se muestra en el ejemplo siguiente. Si se produce un error en la
tarea, await iniciará la primera excepción secundaria almacenada en
AggregateException , en lugar de leer la propiedad Task<TResult>.Result que
iniciaría la excepción AggregateException .

C#

total += await finishedTask;

Adición de un método de proceso

Agregue el siguiente método ProcessUrlAsync después del método SumPageSizesAsync :

C#

static async Task<int> ProcessUrlAsync(string url, HttpClient client)

byte[] content = await client.GetByteArrayAsync(url);

Console.WriteLine($"{url,-60} {content.Length,10:#,#}");

return content.Length;

Para cualquier dirección URL, el método usará la instancia de client proporcionada

para obtener la respuesta como byte[] . La longitud se devuelve después de que la
dirección URL y la longitud se escriban en la consola.

Ejecute el programa varias veces para comprobar que las longitudes que se han
descargado no aparecen siempre en el mismo orden.

Ｕ Precaución

Puede usar WhenAny en un bucle, como se describe en el ejemplo, para solucionar

problemas que implican un número reducido de tareas. Sin embargo, otros
enfoques son más eficaces si hay que procesar un gran número de tareas. Para más
información y ejemplos, vea Processing Tasks as they complete (Procesar tareas
a medida que se completan).

Ejemplo completo
El código siguiente es el texto completo del archivo Program.cs para el ejemplo.

C#

using System.Diagnostics;

HttpClient s_client = new()

MaxResponseContentBufferSize = 1_000_000

};

IEnumerable<string> s_urlList = new string[]

"https://docs.microsoft.com",

 "https://docs.microsoft.com/aspnet/core",

"https://docs.microsoft.com/azure",

"https://docs.microsoft.com/azure/devops",

"https://docs.microsoft.com/dotnet",

"https://docs.microsoft.com/dynamics365",

"https://docs.microsoft.com/education",

"https://docs.microsoft.com/enterprise-mobility-security",

"https://docs.microsoft.com/gaming",

"https://docs.microsoft.com/graph",

"https://docs.microsoft.com/microsoft-365",

"https://docs.microsoft.com/office",

"https://docs.microsoft.com/powershell",

"https://docs.microsoft.com/sql",

"https://docs.microsoft.com/surface",

"https://docs.microsoft.com/system-center",

"https://docs.microsoft.com/visualstudio",

"https://docs.microsoft.com/windows",

"https://docs.microsoft.com/xamarin"

};

await SumPageSizesAsync();

async Task SumPageSizesAsync()

var stopwatch = Stopwatch.StartNew();

IEnumerable<Task<int>> downloadTasksQuery =

from url in s_urlList

select ProcessUrlAsync(url, s_client);

List<Task<int>> downloadTasks = downloadTasksQuery.ToList();

int total = 0;

while (downloadTasks.Any())

Task<int> finishedTask = await Task.WhenAny(downloadTasks);

downloadTasks.Remove(finishedTask);

total += await finishedTask;

stopwatch.Stop();

Console.WriteLine($"\nTotal bytes returned: {total:#,#}");

Console.WriteLine($"Elapsed time: {stopwatch.Elapsed}\n");

static async Task<int> ProcessUrlAsync(string url, HttpClient client)

byte[] content = await client.GetByteArrayAsync(url);

Console.WriteLine($"{url,-60} {content.Length,10:#,#}");

return content.Length;

// Example output:

 // https://docs.microsoft.com 132,517

// https://docs.microsoft.com/powershell 57,375

// https://docs.microsoft.com/gaming 33,549

// https://docs.microsoft.com/aspnet/core 88,714

// https://docs.microsoft.com/surface 39,840

// https://docs.microsoft.com/enterprise-mobility-security 30,903

// https://docs.microsoft.com/microsoft-365 67,867

// https://docs.microsoft.com/windows 26,816

// https://docs.microsoft.com/xamarin 57,958

// https://docs.microsoft.com/dotnet 78,706

// https://docs.microsoft.com/graph 48,277

// https://docs.microsoft.com/dynamics365 49,042

// https://docs.microsoft.com/office 67,867

// https://docs.microsoft.com/system-center 42,887

// https://docs.microsoft.com/education 38,636

// https://docs.microsoft.com/azure 421,663

// https://docs.microsoft.com/visualstudio 30,925

// https://docs.microsoft.com/sql 54,608

// https://docs.microsoft.com/azure/devops 86,034

// Total bytes returned: 1,454,184

// Elapsed time: 00:00:01.1290403

Vea también
WhenAny
Programación asincrónica con async y await (C#)
Acceso asincrónico a archivos (C#)
Artículo • 13/02/2023 • Tiempo de lectura: 5 minutos

Puede usar la característica async para acceder a archivos. Con la característica async, se
puede llamar a métodos asincrónicos sin usar devoluciones de llamada ni dividir el
código en varios métodos o expresiones lambda. Para convertir código sincrónico en
asincrónico, basta con llamar a un método asincrónico y no a un método sincrónico y
agregar algunas palabras clave al código.

Podrían considerarse los siguientes motivos para agregar asincronía a las llamadas de
acceso a archivos:

＂ La asincronía hace que las aplicaciones de interfaz de usuario tengan mayor

capacidad de respuesta porque el subproceso de interfaz de usuario que inicia la
operación puede realizar otro trabajo. Si el subproceso de interfaz de usuario debe
ejecutar código que tarda mucho tiempo (por ejemplo, más de 50 milisegundos),
puede inmovilizar la interfaz de usuario hasta que la E/S se complete y el
subproceso de interfaz de usuario pueda volver a procesar la entrada de teclado y
de mouse y otros eventos.
＂ La asincronía mejora la escalabilidad de ASP.NET y otras aplicaciones basadas en
servidor reduciendo la necesidad de subproceso. Si la aplicación usa un subproceso
dedicado por respuesta y se procesa un millar de solicitudes simultáneamente, se
necesitan mil subprocesos. Las operaciones asincrónicas no suelen necesitar un
subproceso durante la espera. Usan el subproceso existente de finalización de E/S
brevemente al final.
＂ Puede que la latencia de una operación de acceso a archivos sea muy baja en las
condiciones actuales, pero puede aumentar mucho en el futuro. Por ejemplo, se
puede mover un archivo a un servidor que está a escala mundial.
＂ La sobrecarga resultante de usar la característica Async es pequeña.
＂ Las tareas asincrónicas se pueden ejecutar fácilmente en paralelo.

Uso de las clases adecuadas

Los ejemplos sencillos de este tema muestran cómo usar los métodos
File.WriteAllTextAsync y File.ReadAllTextAsync. Para tener control finito sobre las
operaciones de E/S de archivos, use la clase FileStream, que tiene una opción que hace
que la E/S asincrónica se produzca en el nivel del sistema operativo. Si usa esta opción,
puede evitar bloquear un subproceso del grupo de subprocesos en muchos casos. Para
habilitar esta opción, especifique el argumento useAsync=true o
options=FileOptions.Asynchronous en la llamada al constructor.
No puede usar esta opción con StreamReader y StreamWriter si los abre directamente al
especificar una ruta de acceso de archivo. En cambio, puede usar esta opción si les
proporciona un Stream que ha abierto la clase FileStream. Las llamadas asincrónicas son
más rápidas en aplicaciones de interfaz de usuario aunque un subproceso del grupo de
subprocesos se bloquee, porque el subproceso de interfaz de usuario no se bloquea
durante la espera.

Escritura de texto
En los siguientes ejemplos se escribe texto en un archivo. En cada instrucción await, el
método finaliza inmediatamente. Cuando se complete la E/S de archivo, el método se
reanuda en la instrucción que sigue a la instrucción await. El modificador async se
encuentra en la definición de métodos que usan la instrucción await.

Ejemplo sencillo
C#

public async Task SimpleWriteAsync()

string filePath = "simple.txt";

string text = $"Hello World";

await File.WriteAllTextAsync(filePath, text);

Ejemplo de control finito

C#

public async Task ProcessWriteAsync()

string filePath = "temp.txt";

string text = $"Hello World{Environment.NewLine}";

await WriteTextAsync(filePath, text);

async Task WriteTextAsync(string filePath, string text)

byte[] encodedText = Encoding.Unicode.GetBytes(text);

using var sourceStream =

new FileStream(

filePath,

 FileMode.Create, FileAccess.Write, FileShare.None,

bufferSize: 4096, useAsync: true);

await sourceStream.WriteAsync(encodedText, 0, encodedText.Length);

El ejemplo original incluye la instrucción await sourceStream.WriteAsync(encodedText,

0, encodedText.Length); , que es una contracción de las dos instrucciones siguientes:

C#

Task theTask = sourceStream.WriteAsync(encodedText, 0, encodedText.Length);

await theTask;

La primera instrucción devuelve una tarea e inicia el procesamiento de archivos. La

segunda instrucción con await finaliza el método inmediatamente y devuelve otra tarea.
Después, cuando se complete el procesamiento de archivos, la ejecución vuelve a la
instrucción que sigue a la instrucción await.

Lectura de texto
En los ejemplos siguientes se lee texto de un archivo.

Ejemplo sencillo
C#

public async Task SimpleReadAsync()

string filePath = "simple.txt";

string text = await File.ReadAllTextAsync(filePath);

Console.WriteLine(text);

Ejemplo de control finito

El texto se almacena en búfer y, en este caso, se coloca en un StringBuilder. A diferencia
del ejemplo anterior, la evaluación de la instrucción await genera un valor. El método
ReadAsync devuelve Task<Int32>, por lo que la evaluación de await genera un valor
Int32 numRead una vez completada la operación. Para obtener más información,

consulte Tipos de valor devueltos asincrónicos (C#).

 C#

public async Task ProcessReadAsync()

try

string filePath = "temp.txt";

if (File.Exists(filePath) != false)

string text = await ReadTextAsync(filePath);

Console.WriteLine(text);

else

Console.WriteLine($"file not found: {filePath}");

catch (Exception ex)

Console.WriteLine(ex.Message);

async Task<string> ReadTextAsync(string filePath)

using var sourceStream =

new FileStream(

filePath,

FileMode.Open, FileAccess.Read, FileShare.Read,

bufferSize: 4096, useAsync: true);

var sb = new StringBuilder();

byte[] buffer = new byte[0x1000];

int numRead;

while ((numRead = await sourceStream.ReadAsync(buffer, 0,

buffer.Length)) != 0)

string text = Encoding.Unicode.GetString(buffer, 0, numRead);

sb.Append(text);

return sb.ToString();

E/S asincrónica en paralelo

En los siguientes ejemplos se muestra el procesamiento paralelo escribiendo 10 archivos
de texto.
Ejemplo sencillo
C#

public async Task SimpleParallelWriteAsync()

string folder = Directory.CreateDirectory("tempfolder").Name;

IList<Task> writeTaskList = new List<Task>();

for (int index = 11; index <= 20; ++ index)

string fileName = $"file-{index:00}.txt";

string filePath = $"{folder}/{fileName}";

string text = $"In file {index}{Environment.NewLine}";

writeTaskList.Add(File.WriteAllTextAsync(filePath, text));

await Task.WhenAll(writeTaskList);

Ejemplo de control finito

Para cada archivo, el método WriteAsync devuelve una tarea que luego se agrega a una
lista de tareas. La instrucción await Task.WhenAll(tasks); finaliza el método y se
reanuda en el método cuando el procesamiento de archivos se completa para todas las
tareas.

Tras completar las tareas, el ejemplo cierra todas las instancias de FileStream de un
bloque finally . Si en lugar de ello, cada FileStream se ha creado en una instrucción
using , la FileStream se podría desechar antes de completarse la tarea.

Cualquier aumento del rendimiento se debe casi por completo al procesamiento en

paralelo y no al procesamiento asincrónico. Las ventajas de la asincronía radican en que
no inmoviliza varios subprocesos ni el subproceso de interfaz de usuario.

C#

public async Task ProcessMultipleWritesAsync()

IList<FileStream> sourceStreams = new List<FileStream>();

try

string folder = Directory.CreateDirectory("tempfolder").Name;

IList<Task> writeTaskList = new List<Task>();

for (int index = 1; index <= 10; ++ index)

string fileName = $"file-{index:00}.txt";

string filePath = $"{folder}/{fileName}";

string text = $"In file {index}{Environment.NewLine}";

byte[] encodedText = Encoding.Unicode.GetBytes(text);

var sourceStream =

new FileStream(

filePath,

FileMode.Create, FileAccess.Write, FileShare.None,

bufferSize: 4096, useAsync: true);

Task writeTask = sourceStream.WriteAsync(encodedText, 0,

encodedText.Length);

sourceStreams.Add(sourceStream);

writeTaskList.Add(writeTask);

await Task.WhenAll(writeTaskList);

finally

foreach (FileStream sourceStream in sourceStreams)

sourceStream.Close();
}

Al usar los métodos WriteAsync y ReadAsync, puede especificar un CancellationToken,

que puede usar para cancelar la operación en mitad de la secuencia. Para más
información, consulte Cancelación de subprocesos administrados.

Vea también
Programación asincrónica con async y await (C#)
Tipos de valor devueltos asincrónicos (C#)
Atributos (C#)
Artículo • 09/02/2023 • Tiempo de lectura: 5 minutos

Los atributos proporcionan un método eficaz para asociar metadatos, o información

declarativa, con código (ensamblados, tipos, métodos, propiedades, etc.). Después de
asociar un atributo con una entidad de programa, se puede consultar el atributo en
tiempo de ejecución mediante la utilización de una técnica denominada reflexión. Para
obtener más información, vea Reflexión (C#).

Los atributos tienen las propiedades siguientes:

Los atributos agregan metadatos al programa. Los metadatos son información

sobre los tipos definidos en un programa. Todos los ensamblados .NET contienen
un conjunto de metadatos específico que describe los tipos y miembros de tipo
definidos en el ensamblado. Puede agregar atributos personalizados para
especificar cualquier información adicional que sea necesaria. Para obtener más
información, vea Crear atributos personalizados (C#).
Puede aplicar uno o más atributos a todos los ensamblados, módulos o elementos
de programa más pequeños como clases y propiedades.
Los atributos pueden aceptar argumentos de la misma manera que los métodos y
las propiedades.
El programa puede examinar sus propios metadatos o los metadatos de otros
programas mediante la reflexión. Para obtener más información, consulte Acceder
a atributos mediante reflexión (C#).

Uso de atributos
Los atributos se pueden colocar en la mayoría de las declaraciones, aunque un
determinado atributo podría restringir los tipos de declaraciones en que es válido. En
C#, para especificar un atributo se coloca su nombre entre corchetes ([]) por encima de
la declaración de la entidad a la que se aplica.

En este ejemplo, el atributo SerializableAttribute se usa para aplicar una característica

específica a una clase:

C#

[Serializable]

public class SampleClass

// Objects of this type can be serialized.

Un método con el atributo DllImportAttribute se declara como en el siguiente ejemplo:

C#

[System.Runtime.InteropServices.DllImport("user32.dll")]
extern static void SampleMethod();

En una declaración se puede colocar más de un atributo, como se muestra en el

siguiente ejemplo:

C#

using System.Runtime.InteropServices;

C#

void MethodA([In][Out] ref double x) { }

void MethodB([Out][In] ref double x) { }

void MethodC([In, Out] ref double x) { }

Algunos atributos se pueden especificar más de una vez para una entidad determinada.
Un ejemplo de este tipo de atributos multiuso es ConditionalAttribute:

C#

[Conditional("DEBUG"), Conditional("TEST1")]

void TraceMethod()

// ...

７ Nota

Por convención, todos los nombres de atributos terminan con la palabra "Attribute"
para distinguirlos de otros elementos de las bibliotecas de .NET. Sin embargo, no
es necesario especificar el sufijo de atributo cuando utiliza atributos en el código.
Por ejemplo, [DllImport] es equivalente a [DllImportAttribute] , pero
DllImportAttribute es el nombre real del atributo en la biblioteca de clases .NET.

Parámetros de atributo
Muchos atributos tienen parámetros, que pueden ser posicionales, sin nombre o con
nombre. Los parámetros posicionales deben especificarse en un orden determinado y
no se pueden omitir. Los parámetros con nombre son opcionales y pueden especificarse
en cualquier orden. Los parámetros posicionales se especifican en primer lugar. Por
ejemplo, estos tres atributos son equivalentes:

C#

[DllImport("user32.dll")]

[DllImport("user32.dll", SetLastError=false, ExactSpelling=false)]

[DllImport("user32.dll", ExactSpelling=false, SetLastError=false)]

El primer parámetro, el nombre del archivo DLL, es posicional y siempre va primero; los
demás tienen un nombre. En este caso, ambos parámetros con nombre tienen el estado
false de forma predeterminada, por lo que se pueden omitir. Los parámetros
posicionales corresponden a los parámetros del constructor de atributos. Los
parámetros con nombre u opcionales corresponden a propiedades o campos del
atributo. Consulte la documentación del atributo individual para obtener información
sobre los valores de parámetro predeterminados.

Para obtener más información sobre los tipos de parámetro admitidos, vea la sección
Atributos de la Especificación del lenguaje C#

Destinos de atributo
El destino de un atributo es la entidad a la que se aplica dicho atributo. Por ejemplo,
puede aplicar un atributo a una clase, un método determinado o un ensamblado
completo. De forma predeterminada, el atributo se aplica al elemento que sigue. Pero
puede identificar explícitamente, por ejemplo, si se aplica un atributo a un método, a su
parámetro o a su valor devuelto.

Para identificar un destino de atributo de forma explícita, use la sintaxis siguiente:

C#

[target : attribute-list]

La lista de posibles valores target se muestra en la tabla siguiente.

Valor del Se aplica a

objetivo

assembly Ensamblado completo

 Valor del Se aplica a
objetivo

module Módulo de ensamblado actual

field Campo de una clase o un struct

event evento

method Método o descriptores de acceso de propiedad get y set

param Parámetros de método o parámetros de descriptor de acceso de propiedad set

property Propiedad.

return Valor devuelto de un método, indexador de propiedad o descriptor de acceso

de propiedad get

type Estructura, clase, interfaz, enumeración o delegado

Debe especificar el valor de destino field para aplicar un atributo al campo de respaldo
creado para una propiedad implementada automáticamente.

En el ejemplo siguiente se muestra cómo aplicar atributos a ensamblados y módulos.

Para obtener más información, vea Atributos comunes (C#).

C#

using System;

using System.Reflection;

[assembly: AssemblyTitleAttribute("Production assembly 4")]

[module: CLSCompliant(true)]

En el ejemplo siguiente, se muestra cómo aplicar atributos a métodos, parámetros de

método y valores devueltos por métodos en C#.

C#

// default: applies to method

[ValidatedContract]

int Method1() { return 0; }

// applies to method

[method: ValidatedContract]

int Method2() { return 0; }

// applies to parameter

int Method3([ValidatedContract] string contract) { return 0; }

// applies to return value

 [return: ValidatedContract]

int Method4() { return 0; }

７ Nota

Independientemente de los destinos en los que ValidatedContract se define para

que sea válido, debe especificarse el destino return , incluso si ValidatedContract
se ha definido para que se aplique solo a los valores devueltos. En otras palabras, el
compilador no usará información de AttributeUsage para resolver destinos de
atributo ambiguos. Para obtener más información, consulte AttributeUsage (C#).

Usos comunes de los atributos

La lista siguiente incluye algunos de los usos comunes de atributos en el código:

Marcar métodos con el atributo WebMethod en los servicios web para indicar que el
método debe ser invocable a través del protocolo SOAP. Para obtener más
información, vea WebMethodAttribute.
Describir cómo serializar parámetros de método al interoperar con código nativo.
Para obtener más información, vea MarshalAsAttribute.
Describir las propiedades COM para clases, métodos e interfaces.
Llamar al código no administrado mediante la clase DllImportAttribute.
Describir los ensamblados en cuanto a título, versión, descripción o marca.
Describir qué miembros de una clase serializar para la persistencia.
Describir cómo realizar asignaciones entre los miembros de clase y los nodos XML
para la serialización XML.
Describir los requisitos de seguridad para los métodos.
Especificar las características utilizadas para reforzar la seguridad.
Controlar optimizaciones mediante el compilador Just-In-Time (JIT) para que el
código siga siendo fácil de depurar.
Obtener información sobre el llamador de un método.

Secciones relacionadas
Para obtener más información, consulte:

Crear atributos personalizados (C#)

Acceder a atributos mediante reflexión (C#)
Procedimiento para: Crear una unión de C/C++ mediante atributos (C#)
Atributos comunes (C#)
 Información del llamador (C#)

Vea también
Guía de programación de C#
Reflexión (C#)
Atributos
Uso de atributos en C#
Crear atributos personalizados (C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

Para crear sus propios atributos personalizados, defina una clase de atributo derivada
directa o indirectamente de Attribute, que agiliza y facilita la identificación de las
definiciones de atributos en los metadatos. Imagínese que desea etiquetar tipos con el
nombre del programador que los escribió. Puede definir una clase de atributos Author
personalizada:

C#

[System.AttributeUsage(System.AttributeTargets.Class |

System.AttributeTargets.Struct)

public class AuthorAttribute : System.Attribute

private string name;

public double version;

public AuthorAttribute(string name)

this.name = name;

version = 1.0;

El nombre de la clase AuthorAttribute es el nombre del atributo, Author , al que se le

agrega el sufijo Attribute . Se deriva de System.Attribute , por lo que es una clase de
atributo personalizada. Los parámetros del constructor son los parámetros posicionales
del atributo personalizado. En este ejemplo, name es un parámetro posicional. Las
propiedades o los campos públicos de lectura y escritura son parámetros con nombre.
En este caso, version es el único parámetro con nombre. Observe el uso del atributo
AttributeUsage para hacer que el atributo Author sea válido solo en las declaraciones

de clase y de struct .

Puede usar este nuevo atributo de la siguiente manera:

C#

[Author("P. Ackerman", version = 1.1)]

class SampleClass

// P. Ackerman's code goes here...

AttributeUsage tiene un parámetro con nombre, AllowMultiple , con el que puede

hacer que un atributo personalizado sea multiuso o de un solo uso. En el ejemplo de

código siguiente se crea un atributo multiuso.

C#

[System.AttributeUsage(System.AttributeTargets.Class |

System.AttributeTargets.Struct,

AllowMultiple = true) // multiuse attribute

public class AuthorAttribute : System.Attribute

En el ejemplo de código siguiente se aplican varios atributos del mismo tipo a una clase.

C#

[Author("P. Ackerman", version = 1.1)]

[Author("R. Koch", version = 1.2)]

class SampleClass

// P. Ackerman's code goes here...

// R. Koch's code goes here...

Vea también
System.Reflection
Guía de programación de C#
Escribir atributos personalizados
Reflexión (C#)
Atributos (C#)
Acceder a atributos mediante reflexión (C#)
AttributeUsage (C#)
Acceder a atributos mediante reflexión
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El hecho de que pueda definir atributos personalizados y colocarlos en el código fuente

no serviría de mucho si no existiera ninguna forma de recuperar la información y actuar
en consecuencia. Mediante la reflexión, puede recuperar la información que se ha
definido con atributos personalizados. El método clave es GetCustomAttributes , que
devuelve una matriz de objetos que son los equivalentes en tiempo de ejecución de los
atributos de código fuente. Este método tiene varias versiones sobrecargadas. Para
obtener más información, vea Attribute.

Una especificación de atributo como:

C#

[Author("P. Ackerman", version = 1.1)]

class SampleClass

es conceptualmente equivalente a esta:

C#

Author anonymousAuthorObject = new Author("P. Ackerman");

anonymousAuthorObject.version = 1.1;

En cambio, el código no se ejecuta hasta que se consulta a SampleClass sobre los

atributos. Llamar a GetCustomAttributes en SampleClass hace que se cree e inicialice un
objeto Author como se ha mostrado anteriormente. Si la clase tiene otros atributos, se
crean otros objetos de atributo de forma similar. Luego, GetCustomAttributes devuelve
el objeto Author y cualquier otro objeto de atributo en una matriz. Después, puede
recorrer en iteración esta matriz, determinar qué atributos se han aplicado según el tipo
de cada elemento de la matriz y extraer información de los objetos de atributo.

Ejemplo
Este es un ejemplo completo. Se define un atributo personalizado, se aplica a varias
entidades y se recupera mediante reflexión.

C#
// Multiuse attribute.

[System.AttributeUsage(System.AttributeTargets.Class |

System.AttributeTargets.Struct,

AllowMultiple = true) // Multiuse attribute.

public class Author : System.Attribute

string name;

public double version;

public Author(string name)

this.name = name;

// Default value.

version = 1.0;

public string GetName()

return name;

// Class with the Author attribute.

[Author("P. Ackerman")]

public class FirstClass

// ...

// Class without the Author attribute.

public class SecondClass

// ...

// Class with multiple Author attributes.

[Author("P. Ackerman"), Author("R. Koch", version = 2.0)]

public class ThirdClass

// ...

class TestAuthorAttribute

static void Test()

PrintAuthorInfo(typeof(FirstClass));

PrintAuthorInfo(typeof(SecondClass));

PrintAuthorInfo(typeof(ThirdClass));

private static void PrintAuthorInfo(System.Type t)

System.Console.WriteLine("Author information for {0}", t);

// Using reflection.

System.Attribute[] attrs = System.Attribute.GetCustomAttributes(t);

// Reflection.

// Displaying output.

foreach (System.Attribute attr in attrs)

if (attr is Author)

Author a = (Author)attr;

System.Console.WriteLine(" {0}, version {1:f}",

a.GetName(), a.version);

/* Output:

Author information for FirstClass

P. Ackerman, version 1.00

Author information for SecondClass

Author information for ThirdClass

R. Koch, version 2.00

P. Ackerman, version 1.00

*/

Vea también
System.Reflection
Attribute
Guía de programación de C#
Recuperar información almacenada en atributos
Reflexión (C#)
Atributos (C#)
Crear atributos personalizados (C#)
Procedimiento para crear una unión de
C o C++ mediante atributos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Mediante el uso de atributos, puede personalizar la manera en que los structs se

disponen en la memoria. Por ejemplo, puede crear lo que se conoce como una unión en
C/ C++ mediante los atributos StructLayout(LayoutKind.Explicit) y FieldOffset .

Ejemplos
En este segmento de código, todos los campos de TestUnion empiezan en la misma
ubicación en la memoria.

C#

// Add a using directive for System.Runtime.InteropServices.

[System.Runtime.InteropServices.StructLayout(LayoutKind.Explicit)]
struct TestUnion

[System.Runtime.InteropServices.FieldOffset(0)]

public int i;

[System.Runtime.InteropServices.FieldOffset(0)]

public double d;

[System.Runtime.InteropServices.FieldOffset(0)]

public char c;

[System.Runtime.InteropServices.FieldOffset(0)]

public byte b;

A continuación se muestra otro ejemplo en el que los campos empiezan en ubicaciones

diferentes establecidas explícitamente.

C#

// Add a using directive for System.Runtime.InteropServices.

[System.Runtime.InteropServices.StructLayout(LayoutKind.Explicit)]
struct TestExplicit

[System.Runtime.InteropServices.FieldOffset(0)]

public long lg;

 [System.Runtime.InteropServices.FieldOffset(0)]

public int i1;

[System.Runtime.InteropServices.FieldOffset(0)]

public int i2;

[System.Runtime.InteropServices.FieldOffset(8)]

public double d;

[System.Runtime.InteropServices.FieldOffset(12)]

public char c;

[System.Runtime.InteropServices.FieldOffset(14)]

public byte b;

Los dos campos enteros, i1 e i2 , tiene las mismas ubicaciones en la memoria que lg .
Este tipo de control sobre el diseño del struct es útil cuando se usa la invocación de
plataforma.

Vea también
System.Reflection
Attribute
Guía de programación de C#
Atributos
Reflexión (C#)
Atributos (C#)
Crear atributos personalizados (C#)
Acceder a atributos mediante reflexión (C#)
Colecciones (C#)
Artículo • 10/02/2023 • Tiempo de lectura: 14 minutos

Para muchas aplicaciones, puede que desee crear y administrar grupos de objetos
relacionados. Existen dos formas de agrupar objetos: mediante la creación de matrices
de objetos y con la creación de colecciones de objetos.

Las matrices son muy útiles para crear y trabajar con un número fijo de objetos
fuertemente tipados. Para obtener información sobre las matrices, vea Matrices.

Las colecciones proporcionan una manera más flexible de trabajar con grupos de
objetos. A diferencia de las matrices, el grupo de objetos con el que trabaja puede
aumentar y reducirse de manera dinámica a medida que cambian las necesidades de la
aplicación. Para algunas colecciones, puede asignar una clave a cualquier objeto que
incluya en la colección para, de este modo, recuperar rápidamente el objeto con la
clave.

Una colección es una clase, por lo que debe declarar una instancia de la clase para
poder agregar elementos a dicha colección.

Si la colección contiene elementos de un solo tipo de datos, puede usar una de las
clases del espacio de nombres System.Collections.Generic. Una colección genérica
cumple la seguridad de tipos para que ningún otro tipo de datos se pueda agregar a
ella. Cuando recupera un elemento de una colección genérica, no tiene que determinar
su tipo de datos ni convertirlo.

７ Nota

Para los ejemplos de este tema, incluya las directivas using para los espacios de
nombres System.Collections.Generic y System.Linq .

En este tema

Uso de una colección Simple

Tipos de colecciones

Clases System.Collections.Generic

Clases System.Collections.Concurrent

Clases System.Collections
 Implementación de una colección de pares de clave/valor

Uso de LINQ para tener acceso a una colección

Ordenar una colección

Definición de una colección personalizada

Iteradores

Uso de una colección Simple

Los ejemplos de esta sección usan la clase genérica List<T>, que le permite trabajar con
una lista de objetos fuertemente tipados.

En el ejemplo siguiente se crea una lista de cadenas y luego se recorren en iteración

mediante una instrucción foreach.

C#

// Create a list of strings.

var salmons = new List<string>();

salmons.Add("chinook");

salmons.Add("coho");

salmons.Add("pink");

salmons.Add("sockeye");

// Iterate through the list.

foreach (var salmon in salmons)

Console.Write(salmon + " ");

// Output: chinook coho pink sockeye

Si el contenido de una colección se conoce de antemano, puede usar un inicializador de

colección para inicializar la colección. Para obtener más información, vea Inicializadores
de objeto y colección.

El ejemplo siguiente es el mismo que el ejemplo anterior, excepto que se usa un

inicializador de colección para agregar elementos a la colección.

C#

// Create a list of strings by using a

// collection initializer.

var salmons = new List<string> { "chinook", "coho", "pink", "sockeye" };

// Iterate through the list.

 foreach (var salmon in salmons)

Console.Write(salmon + " ");

// Output: chinook coho pink sockeye

Puede usar una instrucción for en lugar de una instrucción foreach para recorrer en
iteración una colección. Esto se consigue con el acceso a los elementos de la colección
mediante la posición de índice. El índice de los elementos comienza en 0 y termina en el
número de elementos menos 1.

El ejemplo siguiente recorre en iteración los elementos de una colección mediante for
en lugar de foreach .

C#

// Create a list of strings by using a

// collection initializer.

var salmons = new List<string> { "chinook", "coho", "pink", "sockeye" };

for (var index = 0; index < salmons.Count; index++)

Console.Write(salmons[index] + " ");

// Output: chinook coho pink sockeye

El ejemplo siguiente quita un elemento de la colección especificando el objeto que se

quitará.

C#

// Create a list of strings by using a

// collection initializer.

var salmons = new List<string> { "chinook", "coho", "pink", "sockeye" };

// Remove an element from the list by specifying

// the object.

salmons.Remove("coho");

// Iterate through the list.

foreach (var salmon in salmons)

Console.Write(salmon + " ");

// Output: chinook pink sockeye

El ejemplo siguiente quita elementos de una lista genérica. En lugar de una instrucción
foreach , se usa una instrucción for que procesa una iteración en orden descendente.
Esto es porque el método RemoveAt hace que los elementos después de un elemento
quitado tengan un valor de índice inferior.

C#

var numbers = new List<int> { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };

// Remove odd numbers.

for (var index = numbers.Count - 1; index >= 0; index--)

if (numbers[index] % 2 == 1)

// Remove the element by specifying

// the zero-based index in the list.

numbers.RemoveAt(index);

// Iterate through the list.

// A lambda expression is placed in the ForEach method

// of the List(T) object.

numbers.ForEach(

number => Console.Write(number + " "));

// Output: 0 2 4 6 8

Para el tipo de elementos de List<T>, también puede definir su propia clase. En el

ejemplo siguiente, la clase Galaxy que usa List<T> se define en el código.

C#

private static void IterateThroughList()

var theGalaxies = new List<Galaxy>

new Galaxy() { Name="Tadpole", MegaLightYears=400},

new Galaxy() { Name="Pinwheel", MegaLightYears=25},

new Galaxy() { Name="Milky Way", MegaLightYears=0},

new Galaxy() { Name="Andromeda", MegaLightYears=3}

};

foreach (Galaxy theGalaxy in theGalaxies)

Console.WriteLine(theGalaxy.Name + " " + theGalaxy.MegaLightYears);

// Output:

// Tadpole 400

// Pinwheel 25

// Milky Way 0

// Andromeda 3

 public class Galaxy

public string Name { get; set; }

public int MegaLightYears { get; set; }

Tipos de colecciones
.NET proporciona muchas colecciones comunes. Cada tipo de colección está diseñado
para un fin específico.

En esta sección se describen algunas de las clases de colecciones comunes:

Clases System.Collections.Generic

Clases System.Collections.Concurrent

Clases System.Collections

Clases System.Collections.Generic
Puede crear una colección genérica mediante una de las clases del espacio de nombres
System.Collections.Generic. Una colección genérica es útil cuando todos los elementos
de la colección tienen el mismo tipo. Una colección genérica exige el establecimiento de
fuertes tipos al permitir agregar solo los tipos de datos deseados.

En la tabla siguiente se enumeran algunas de las clases usadas con frecuencia del
espacio de nombres System.Collections.Generic:

Clase Descripción

Dictionary<TKey,TValue> Representa una colección de pares de clave y valor que se organizan

según la clave.

List<T> Representa una lista de objetos a los que puede tener acceso el
índice. Proporciona métodos para buscar, ordenar y modificar listas.

Queue<T> Representa una colección de objetos de primeras entradas, primeras

salidas (FIFO).

SortedList<TKey,TValue> Representa una colección de pares clave-valor que se ordenan por

claves según la implementación de IComparer<T> asociada.

Stack<T> Representa una colección de objetos de últimas entradas, primeras

salidas (LIFO).
Para obtener más información, vea Tipos de colección utilizados normalmente,
Seleccionar una clase de colección y System.Collections.Generic.

Clases System.Collections.Concurrent
En .NET Framework 4 y versiones posteriores, las colecciones del espacio de nombres
System.Collections.Concurrent proporcionan operaciones eficaces y seguras para
subprocesos con el fin de acceder a los elementos de la colección desde varios
subprocesos.

Las clases del espacio de nombres System.Collections.Concurrent deben usarse en lugar

de los tipos correspondientes de los espacios de nombres System.Collections.Generic y
System.Collections cada vez que varios subprocesos tengan acceso de manera
simultánea a la colección. Para obtener más información, vea Colecciones seguras para
subprocesos y System.Collections.Concurrent.

Algunas clases incluidas en el espacio de nombres System.Collections.Concurrent son

BlockingCollection<T>, ConcurrentDictionary<TKey,TValue>, ConcurrentQueue<T> y
ConcurrentStack<T>.

Clases System.Collections
Las clases del espacio de nombres System.Collections no almacenan los elementos
como objetos de tipo específico, sino como objetos del tipo Object .

Siempre que sea posible, debe usar las colecciones genéricas del espacio de nombres
System.Collections.Generic o del espacio de nombres System.Collections.Concurrent en
lugar de los tipos heredados del espacio de nombres System.Collections .

En la siguiente tabla se enumeran algunas de las clases usadas con frecuencia en el

espacio de nombres System.Collections :

Clase Descripción

ArrayList Representa una matriz cuyo tamaño aumenta dinámicamente cuando es necesario.

Hashtable Representa una colección de pares de clave y valor que se organizan por código hash
de la clave.

Queue Representa una colección de objetos de primeras entradas, primeras salidas (FIFO).

Stack Representa una colección de objetos de últimas entradas, primeras salidas (LIFO).
El espacio de nombres System.Collections.Specialized proporciona clases de colección
especializadas y fuertemente tipadas como, por ejemplo, colecciones de solo cadena y
diccionarios híbridos y de lista vinculada.

Implementación de una colección de pares de

clave/valor
La colección genérica Dictionary<TKey,TValue> le permite tener acceso a los elementos
de una colección con la clave de cada elemento. Cada adición al diccionario consta de
un valor y de su clave asociada. Recuperar un valor usando su clave es rápido porque la
clase Dictionary se implementa como una tabla hash.

En el ejemplo siguiente se crea una colección Dictionary y se recorre en iteración el

diccionario usando una instrucción foreach .

C#

private static void IterateThruDictionary()

Dictionary<string, Element> elements = BuildDictionary();

foreach (KeyValuePair<string, Element> kvp in elements)

Element theElement = kvp.Value;

Console.WriteLine("key: " + kvp.Key);

Console.WriteLine("values: " + theElement.Symbol + " " +

theElement.Name + " " + theElement.AtomicNumber);

private static Dictionary<string, Element> BuildDictionary()

var elements = new Dictionary<string, Element>();

AddToDictionary(elements, "K", "Potassium", 19);

AddToDictionary(elements, "Ca", "Calcium", 20);

AddToDictionary(elements, "Sc", "Scandium", 21);

AddToDictionary(elements, "Ti", "Titanium", 22);

return elements;

private static void AddToDictionary(Dictionary<string, Element> elements,

string symbol, string name, int atomicNumber)

Element theElement = new Element();

theElement.Symbol = symbol;

 theElement.Name = name;

theElement.AtomicNumber = atomicNumber;

elements.Add(key: theElement.Symbol, value: theElement);

public class Element

public string Symbol { get; set; }

public string Name { get; set; }

public int AtomicNumber { get; set; }

Para usar un inicializador de colección para compilar la colección Dictionary , puede

reemplazar los métodos BuildDictionary y AddToDictionary por el método siguiente.

C#

private static Dictionary<string, Element> BuildDictionary2()

return new Dictionary<string, Element>

{"K",

new Element() { Symbol="K", Name="Potassium", AtomicNumber=19}},

{"Ca",

new Element() { Symbol="Ca", Name="Calcium", AtomicNumber=20}},

{"Sc",

new Element() { Symbol="Sc", Name="Scandium", AtomicNumber=21}},

{"Ti",

new Element() { Symbol="Ti", Name="Titanium", AtomicNumber=22}}

};

En el ejemplo siguiente se usa el método ContainsKey y la propiedad Item[] de

Dictionary para encontrar rápidamente un elemento por clave. La propiedad Item le

permite tener acceso a un elemento de la colección elements usando elements[symbol]

en C#.

C#

private static void FindInDictionary(string symbol)

Dictionary<string, Element> elements = BuildDictionary();

if (elements.ContainsKey(symbol) == false)

Console.WriteLine(symbol + " not found");

else

 Element theElement = elements[symbol];

Console.WriteLine("found: " + theElement.Name);

En el ejemplo siguiente se usa en su lugar el método TryGetValue para encontrar

rápidamente un elemento por clave.

C#

private static void FindInDictionary2(string symbol)

Dictionary<string, Element> elements = BuildDictionary();

Element theElement = null;

if (elements.TryGetValue(symbol, out theElement) == false)

Console.WriteLine(symbol + " not found");

else

Console.WriteLine("found: " + theElement.Name);

Uso de LINQ para tener acceso a una colección

LINQ (Language-Integrated Query) puede usar para tener acceso a las colecciones. Las
consultas LINQ proporcionan capacidades de filtrado, ordenación y agrupación. Para
obtener más información, vea Introducción a LINQ en C#.

El ejemplo siguiente ejecuta una consulta LINQ en una List genérica. La consulta LINQ
devuelve otra colección que contiene los resultados.

C#

private static void ShowLINQ()

List<Element> elements = BuildList();

// LINQ Query.

var subset = from theElement in elements

where theElement.AtomicNumber < 22

orderby theElement.Name

select theElement;

foreach (Element theElement in subset)

Console.WriteLine(theElement.Name + " " + theElement.AtomicNumber);

// Output:

 // Calcium 20

// Potassium 19

// Scandium 21

private static List<Element> BuildList()

return new List<Element>

{ new Element() { Symbol="K", Name="Potassium", AtomicNumber=19}},

{ new Element() { Symbol="Ca", Name="Calcium", AtomicNumber=20}},

{ new Element() { Symbol="Sc", Name="Scandium", AtomicNumber=21}},

{ new Element() { Symbol="Ti", Name="Titanium", AtomicNumber=22}}

};

public class Element

public string Symbol { get; set; }

public string Name { get; set; }

public int AtomicNumber { get; set; }

Ordenar una colección

En el ejemplo siguiente se muestra un procedimiento para ordenar una colección. El
ejemplo ordena las instancias de la clase Car que se almacenan en un List<T>. La clase
Car implementa la interfaz IComparable<T>, que requiere implementar el método

CompareTo.

Cada llamada al método CompareTo realiza una comparación única que se usa para la
ordenación. El código escrito por el usuario en el método CompareTo devuelve un valor
para cada comparación del objeto actual con otro objeto. El valor devuelto es menor
que cero si el objeto actual es menor que el otro objeto, mayor que cero si el objeto
actual es mayor que el otro objeto y cero si son iguales. Esto permite definir en el
código los criterios de mayor que, menor que e igual.

En el método ListCars , la instrucción cars.Sort() ordena la lista. Esta llamada al

método Sort de List<T> hace que se llame automáticamente al método CompareTo para
los objetos Car de List .

C#

private static void ListCars()

var cars = new List<Car>

 { new Car() { Name = "car1", Color = "blue", Speed = 20}},

{ new Car() { Name = "car2", Color = "red", Speed = 50}},

{ new Car() { Name = "car3", Color = "green", Speed = 10}},

{ new Car() { Name = "car4", Color = "blue", Speed = 50}},

{ new Car() { Name = "car5", Color = "blue", Speed = 30}},

{ new Car() { Name = "car6", Color = "red", Speed = 60}},

{ new Car() { Name = "car7", Color = "green", Speed = 50}}

};

// Sort the cars by color alphabetically, and then by speed

// in descending order.

cars.Sort();

// View all of the cars.

foreach (Car thisCar in cars)

Console.Write(thisCar.Color.PadRight(5) + " ");

Console.Write(thisCar.Speed.ToString() + " ");

Console.Write(thisCar.Name);

Console.WriteLine();

// Output:

// blue 50 car4

// blue 30 car5

// blue 20 car1

// green 50 car7

// green 10 car3

// red 60 car6

// red 50 car2

public class Car : IComparable<Car>

public string Name { get; set; }

public int Speed { get; set; }

public string Color { get; set; }

public int CompareTo(Car other)

// A call to this method makes a single comparison that is

// used for sorting.

// Determine the relative order of the objects being compared.

// Sort by color alphabetically, and then by speed in

// descending order.

// Compare the colors.

int compare;

compare = String.Compare(this.Color, other.Color, true);

// If the colors are the same, compare the speeds.

if (compare == 0)

compare = this.Speed.CompareTo(other.Speed);

 // Use descending order for speed.

compare = -compare;

return compare;

Definición de una colección personalizada

Puede definir una colección implementando la interfaz IEnumerable<T> o IEnumerable.

Aunque puede definir una colección personalizada, es mejor usar las colecciones
incluidas en .NET. Estas colecciones se describen en la sección Tipos de colecciones de
este artículo.

En el siguiente ejemplo se define una clase de colección personalizada denominada

AllColors . Esta clase implementa la interfaz IEnumerable que requiere implementar el

método GetEnumerator.

El método GetEnumerator devuelve una instancia de la clase ColorEnumerator .

ColorEnumerator implementa la interfaz IEnumerator, que requiere que la propiedad

Current, el método MoveNext y el método Reset estén implementados.

C#

private static void ListColors()

var colors = new AllColors();

foreach (Color theColor in colors)

Console.Write(theColor.Name + " ");

Console.WriteLine();

// Output: red blue green

// Collection class.

public class AllColors : System.Collections.IEnumerable

Color[] _colors =

new Color() { Name = "red" },

new Color() { Name = "blue" },

new Color() { Name = "green" }

};

 public System.Collections.IEnumerator GetEnumerator()

return new ColorEnumerator(_colors);

// Instead of creating a custom enumerator, you could

// use the GetEnumerator of the array.

//return _colors.GetEnumerator();

// Custom enumerator.

private class ColorEnumerator : System.Collections.IEnumerator

private Color[] _colors;

private int _position = -1;

public ColorEnumerator(Color[] colors)

_colors = colors;

object System.Collections.IEnumerator.Current

get

return _colors[_position];

bool System.Collections.IEnumerator.MoveNext()

_position++;

return (_position < _colors.Length);

void System.Collections.IEnumerator.Reset()

_position = -1;

// Element class.

public class Color

public string Name { get; set; }

Iterators
Los iteradores se usan para efectuar una iteración personalizada en una colección. Un
iterador puede ser un método o un descriptor de acceso get . Un iterador usa una
instrucción yield return para devolver cada elemento de la colección a la vez.

Llame a un iterador mediante una instrucción foreach. Cada iteración del bucle foreach
llama al iterador. Cuando se alcanza una instrucción yield return en el iterador, se
devuelve una expresión y se conserva la ubicación actual en el código. La ejecución se
reinicia desde esa ubicación la próxima vez que se llama al iterador.

Para obtener más información, vea Iteradores (C#).

El siguiente ejemplo usa el método del iterador. El método del iterador tiene una
instrucción yield return que se encuentra dentro de un bucle for . En el método
ListEvenNumbers , cada iteración del cuerpo de la instrucción foreach crea una llamada
al método iterador, que continúa con la siguiente instrucción yield return .

C#

private static void ListEvenNumbers()

foreach (int number in EvenSequence(5, 18))

Console.Write(number.ToString() + " ");

Console.WriteLine();

// Output: 6 8 10 12 14 16 18
}

private static IEnumerable<int> EvenSequence(

int firstNumber, int lastNumber)

// Yield even numbers in the range.

for (var number = firstNumber; number <= lastNumber; number++)

if (number % 2 == 0)

yield return number;

Vea también
Inicializadores de objeto y colección
Conceptos de programación (C#)
Option Strict (instrucción)
LINQ to Objects (C#)
Parallel LINQ (PLINQ)
Colecciones y estructuras de datos
Seleccionar una clase de colección
Comparaciones y ordenaciones en colecciones
Cuándo utilizar colecciones genéricas
Instrucciones de iteración
Covarianza y contravarianza (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En C#, la covarianza y la contravarianza habilitan la conversión de referencias implícita

de tipos de matriz, tipos de delegado y argumentos de tipo genérico. La covarianza
conserva la compatibilidad de asignaciones y la contravarianza la invierte.

El siguiente código muestra la diferencia entre la compatibilidad de asignaciones, la

covarianza y la contravarianza.

C#

// Assignment compatibility.

string str = "test";

// An object of a more derived type is assigned to an object of a less

derived type.

object obj = str;

// Covariance.

IEnumerable<string> strings = new List<string>();

// An object that is instantiated with a more derived type argument

// is assigned to an object instantiated with a less derived type argument.

// Assignment compatibility is preserved.

IEnumerable<object> objects = strings;

// Contravariance.

// Assume that the following method is in the class:

static void SetObject(object o) { }

Action<object> actObject = SetObject;

// An object that is instantiated with a less derived type argument

// is assigned to an object instantiated with a more derived type argument.

// Assignment compatibility is reversed.

Action<string> actString = actObject;

La covarianza de matrices permite la conversión implícita de una matriz de un tipo más

derivado a una matriz de un tipo menos derivado. Pero esta operación no es segura, tal
como se muestra en el ejemplo de código siguiente.

C#

object[] array = new String[10];

// The following statement produces a run-time exception.

// array[0] = 10;

La compatibilidad de la covarianza y la contravarianza con grupos de métodos permite

hacer coincidir firmas de método con tipos de delegado. Esto le permite asignar a los
delegados no solo métodos con firmas coincidentes, sino métodos que devuelven tipos
más derivados (covarianza) o que aceptan parámetros con tipos menos derivados
(contravarianza) que el especificado por el tipo de delegado. Para obtener más
información, vea Varianza en delegados (C#) y Usar varianza en delegados (C#).

En el ejemplo de código siguiente, se muestra la compatibilidad de covarianza y

contravarianza con grupos de métodos.

C#

static object GetObject() { return null; }

static void SetObject(object obj) { }

static string GetString() { return ""; }

static void SetString(string str) { }

static void Test()

// Covariance. A delegate specifies a return type as object,

// but you can assign a method that returns a string.

Func<object> del = GetString;

// Contravariance. A delegate specifies a parameter type as string,

// but you can assign a method that takes an object.

Action<string> del2 = SetObject;

En .NET Framework 4 o versiones posteriores, C# admite la covarianza y contravarianza

en las interfaces genéricas y los delegados, y permite la conversión implícita de los
parámetros de tipo genérico. Para obtener más información, vea Varianza en interfaces
genéricas (C#) y Varianza en delegados (C#).

En el ejemplo de código siguiente, se muestra la conversión implícita de referencias para

interfaces genéricas.

C#

IEnumerable<String> strings = new List<String>();

IEnumerable<Object> objects = strings;

Un delegado o interfaz genéricos se denominan variante si sus parámetros genéricos se

declaran como covariantes o contravariantes. C# le permite crear sus propias interfaces
y delegados variantes. Para obtener más información, consulte Crear interfaces
genéricas variantes (C#) y Varianza en delegados (C#).
Temas relacionados
Title Descripción

Varianza en interfaces Describe la covarianza y contravarianza en las interfaces genéricas y

genéricas (C#) proporciona una lista de interfaces genéricas variantes en .NET.

Crear interfaces Se muestra cómo crear interfaces variantes personalizadas.

genéricas variantes (C#)

Usar la varianza en Se muestra cómo la compatibilidad de covarianza y contravarianza en

interfaces para las las interfaces IEnumerable<T> y IComparable<T> puede ayudarle a
colecciones genéricas volver a usar el código.
(C#)

Varianza en delegados Se describe la covarianza y contravarianza en delegados genéricos y

(C#) no genéricos y se proporciona una lista de delegados genéricos
variantes en .NET.

Usar varianza en Se muestra cómo usar la compatibilidad de covarianza y

delegados (C#) contravarianza en los delegados no genéricos para que coincidan las
firmas de método con los tipos de delegado.

Usar varianza para los Se muestra cómo la compatibilidad de covarianza y contravarianza en

delegados genéricos los delegados Func y Action puede ayudarle a volver a usar el
Func y Action (C#) código.
Varianza en interfaces genéricas (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En .NET Framework 4 se ha presentado la compatibilidad con la varianza para varias

interfaces genéricas existentes. La compatibilidad con la varianza permite la conversión
implícita de clases que implementan estas interfaces.

A partir de .NET Framework 4, las siguientes interfaces son variantes:

IEnumerable<T> (T es covariante)

IEnumerator<T> (T es covariante)

IQueryable<T> (T es covariante)

IGrouping<TKey,TElement> ( TKey y TElement son covariantes)

IComparer<T> (T es contravariante)

IEqualityComparer<T> (T es contravariante)

IComparable<T> (T es contravariante)

A partir de .NET Framework 4.5, las siguientes interfaces son variantes:

IReadOnlyList<T> (T es covariante)

IReadOnlyCollection<T> (T es covariante)

La covarianza permite que un método tenga un tipo de valor devuelto más derivado
que los que se definen en los parámetros de tipo genérico de la interfaz. Para ilustrar la
característica de la covarianza, considere estas interfaces genéricas: IEnumerable<Object>
y IEnumerable<String> . La interfaz IEnumerable<String> no hereda la interfaz
IEnumerable<Object> . En cambio, el tipo String hereda el tipo Object , y en algunos

casos puede que quiera asignar objetos de estas interfaces entre sí. Esto se muestra en
el ejemplo de código siguiente.

C#

IEnumerable<String> strings = new List<String>();

IEnumerable<Object> objects = strings;

En versiones anteriores de .NET Framework, este código provoca un error de

compilación en C# y, si Option Strict está activado, en Visual Basic. Pero ahora puede
usar strings en lugar de objects , como se muestra en el ejemplo anterior, porque la
interfaz IEnumerable<T> es covariante.

La contravarianza permite que un método tenga tipos de argumento menos derivados

que los que se especifican en el parámetro genérico de la interfaz. Para ilustrar la
contravarianza, se presupone que ha creado una clase BaseComparer para comparar
instancias de la clase BaseClass . La clase BaseComparer implementa la interfaz
IEqualityComparer<BaseClass> . Como la interfaz IEqualityComparer<T> ahora es
contravariante, puede usar BaseComparer para comparar instancias de clases que
heredan la clase BaseClass . Esto se muestra en el ejemplo de código siguiente.

C#

// Simple hierarchy of classes.

class BaseClass { }

class DerivedClass : BaseClass { }

// Comparer class.

class BaseComparer : IEqualityComparer<BaseClass>

public int GetHashCode(BaseClass baseInstance)

return baseInstance.GetHashCode();

public bool Equals(BaseClass x, BaseClass y)

return x == y;

class Program

static void Test()

IEqualityComparer<BaseClass> baseComparer = new BaseComparer();

// Implicit conversion of IEqualityComparer<BaseClass> to

// IEqualityComparer<DerivedClass>.

IEqualityComparer<DerivedClass> childComparer = baseComparer;

Para obtener más ejemplos, vea Usar la varianza en interfaces para las colecciones
genéricas (C#).

La varianza para interfaces genéricas solo es compatible con tipos de referencia. Los
tipos de valor no admiten la varianza. Por ejemplo, IEnumerable<int> no puede
convertirse implícitamente en IEnumerable<object> , porque los enteros se representan
mediante un tipo de valor.
 C#

IEnumerable<int> integers = new List<int>();

// The following statement generates a compiler error,

// because int is a value type.

// IEnumerable<Object> objects = integers;

También es importante recordar que las clases que implementan las interfaces variantes
siguen siendo invariables. Por ejemplo, aunque List<T> implementa la interfaz
covariante IEnumerable<T>, no puede convertir List<String> en List<Object>
implícitamente. Esto se muestra en el siguiente código de ejemplo.

C#

// The following line generates a compiler error

// because classes are invariant.

// List<Object> list = new List<String>();

// You can use the interface object instead.

IEnumerable<Object> listObjects = new List<String>();

Vea también
Usar la varianza en interfaces para las colecciones genéricas (C#)
Crear interfaces genéricas variantes (C#)
Interfaces genéricas
Varianza en delegados (C#)
Crear interfaces genéricas variantes (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Puede declarar parámetros de tipo genérico en las interfaces como covariantes o

contravariantes. La covarianza permite que los métodos de interfaz tengan tipos de
valor devuelto más derivados que los que se definen en los parámetros de tipo
genérico. La contravarianza permite que los métodos de interfaz tengan tipos de
argumento menos derivados que los que se especifican en los parámetros genéricos.
Las interfaces genéricas que tienen parámetros de tipo genérico covariantes o
contravariantes se llaman variantes.

７ Nota

En .NET Framework 4 se ha presentado la compatibilidad con la varianza para varias

interfaces genéricas existentes. Para ver la lista de interfaces variantes de .NET, vea
Varianza en interfaces genéricas (C#).

Declarar interfaces genéricas variantes

Puede declarar interfaces genéricas variantes mediante las palabras clave in y out para
los parámetros de tipo genérico.

） Importante

Los parámetros ref , in y out de C# no pueden ser variantes. Los tipos de valor
tampoco admiten la varianza.

Puede declarar un parámetro de tipo genérico covariante mediante la palabra clave out .
El tipo covariante debe cumplir las siguientes condiciones:

El tipo se usa únicamente como tipo de valor devuelto de los métodos de interfaz,
y no como tipo de los argumentos de método. Esto se muestra en el siguiente
ejemplo, en el que el tipo R se declara como covariante.

C#

interface ICovariant<out R>

R GetSomething();

// The following statement generates a compiler error.

 // void SetSomething(R sampleArg);

Hay una excepción para esta regla. Si tiene un delegado genérico contravariante
como parámetro de método, puede usar el tipo como parámetro de tipo genérico
para el delegado. Esto se muestra en el siguiente ejemplo con el tipo R . Para
obtener más información, vea Varianza en delegados (C#) y Usar la varianza para
los delegados genéricos Func y Action (C#).

C#

interface ICovariant<out R>

void DoSomething(Action<R> callback);

El tipo no se usa como restricción genérica para los métodos de interfaz. Esto se
muestra en el siguiente código.

C#

interface ICovariant<out R>

// The following statement generates a compiler error

// because you can use only contravariant or invariant types

// in generic constraints.

// void DoSomething<T>() where T : R;

Puede declarar un parámetro de tipo genérico contravariante mediante la palabra clave

in . El tipo contravariante solo se puede usar como tipo de los argumentos de método,
y no como tipo de valor devuelto de los métodos de interfaz. El tipo contravariante
también se puede usar para las restricciones genéricas. En el siguiente código se
muestra cómo declarar una interfaz contravariante y cómo usar una restricción genérica
para uno de sus métodos.

C#

interface IContravariant<in A>

void SetSomething(A sampleArg);

void DoSomething<T>() where T : A;

// The following statement generates a compiler error.

// A GetSomething();

También se puede admitir la covarianza y la contravarianza en la misma interfaz, pero

para distintos parámetros de tipo, como se muestra en el siguiente ejemplo de código.

C#

interface IVariant<out R, in A>

R GetSomething();

void SetSomething(A sampleArg);

R GetSetSomethings(A sampleArg);

Implementar interfaces genéricas variantes

Las interfaces genéricas variantes se implementan en las clases usando la misma sintaxis
que se usa para las interfaces invariables. En el siguiente ejemplo de código se muestra
cómo implementar una interfaz covariante en una clase genérica.

C#

interface ICovariant<out R>

R GetSomething();

class SampleImplementation<R> : ICovariant<R>

public R GetSomething()

// Some code.

return default(R);

Las clases que implementan interfaces variantes son invariables. Por ejemplo, considere
el fragmento de código siguiente:

C#

// The interface is covariant.

ICovariant<Button> ibutton = new SampleImplementation<Button>();

ICovariant<Object> iobj = ibutton;

// The class is invariant.

SampleImplementation<Button> button = new SampleImplementation<Button>();

// The following statement generates a compiler error

// because classes are invariant.

// SampleImplementation<Object> obj = button;

Extender interfaces genéricas variantes

Al extender una interfaz genérica variante, debe usar las palabras clave in y out para
especificar de forma explícita si la interfaz derivada admite la varianza. El compilador no
infiere la varianza de la interfaz que se va a extender. Por ejemplo, observe las siguientes
interfaces.

C#

interface ICovariant<out T> { }

interface IInvariant<T> : ICovariant<T> { }

interface IExtCovariant<out T> : ICovariant<T> { }

En la interfaz IInvariant<T> , el parámetro de tipo genérico T es invariable, mientras

que en IExtCovariant<out T> el parámetro de tipo es covariante, si bien ambas
interfaces extienden la misma interfaz. La misma regla se aplica a los parámetros de tipo
genérico contravariantes.

Puede crear una interfaz que extienda la interfaz donde el parámetro de tipo genérico T
es covariante y la interfaz donde es contravariante si, en la interfaz que va a extender, el
parámetro de tipo genérico T es invariable. Esto se muestra en el siguiente código de
ejemplo.

C#

interface ICovariant<out T> { }

interface IContravariant<in T> { }

interface IInvariant<T> : ICovariant<T>, IContravariant<T> { }

Pero si un parámetro de tipo genérico T se declara como covariante en una interfaz, no

puede declararlo como contravariante en la interfaz extensible (o viceversa). Esto se
muestra en el siguiente código de ejemplo.

C#

interface ICovariant<out T> { }

// The following statement generates a compiler error.

// interface ICoContraVariant<in T> : ICovariant<T> { }

Evitar la ambigüedad
Al implementar interfaces genéricas variantes, la varianza a veces puede implicar
ambigüedad. Debe evitarse esta ambigüedad.

Por ejemplo, si implementa explícitamente en una clase la misma interfaz genérica

variante con distintos parámetros de tipo genérico, puede crear ambigüedad. El
compilador no genera ningún error en este caso, pero no se especifica qué
implementación de interfaz se va a elegir en tiempo de ejecución. Esta ambigüedad
podría provocar errores sutiles en el código. Observe el siguiente ejemplo de código.

C#

// Simple class hierarchy.

class Animal { }

class Cat : Animal { }

class Dog : Animal { }

// This class introduces ambiguity

// because IEnumerable<out T> is covariant.

class Pets : IEnumerable<Cat>, IEnumerable<Dog>

IEnumerator<Cat> IEnumerable<Cat>.GetEnumerator()

Console.WriteLine("Cat");
// Some code.

return null;

IEnumerator IEnumerable.GetEnumerator()

// Some code.

return null;

IEnumerator<Dog> IEnumerable<Dog>.GetEnumerator()

Console.WriteLine("Dog");
// Some code.

return null;

class Program

public static void Test()

IEnumerable<Animal> pets = new Pets();

pets.GetEnumerator();

En este ejemplo no se especifica cómo elige el método pets.GetEnumerator entre Cat y

Dog . Esto podría producir problemas en el código.

Vea también
Varianza en interfaces genéricas (C#)
Usar varianza para los delegados genéricos Func y Action (C#)
Usar la varianza en interfaces para las
colecciones genéricas (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Una interfaz covariante permite que sus métodos devuelvan tipos más derivados que los
especificados en la interfaz. Una interfaz contravariante permite que sus métodos
acepten parámetros de tipos menos derivados que los especificados en la interfaz.

Varias interfaces existentes en .NET Framework 4 pasaron a ser covariantes y

contravariantes. Por ejemplo, IEnumerable<T> y IComparable<T>. Esto permite volver a
usar métodos que funcionan con colecciones genéricas de tipos base para colecciones
de tipos derivados.

Para ver una lista de interfaces variantes de .NET, vea Varianza en interfaces genéricas
(C#).

Convertir colecciones genéricas

En el ejemplo siguiente se muestran las ventajas de la compatibilidad con la covarianza
en la interfaz IEnumerable<T>. El método PrintFullName acepta una colección del tipo
IEnumerable<Person> como parámetro. Pero se puede volver a usar para una colección
del tipo IEnumerable<Employee> porque Employee hereda Person .

C#

// Simple hierarchy of classes.

public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

public class Employee : Person { }

class Program

// The method has a parameter of the IEnumerable<Person> type.

public static void PrintFullName(IEnumerable<Person> persons)

foreach (Person person in persons)

Console.WriteLine("Name: {0} {1}",

person.FirstName, person.LastName);

public static void Test()

IEnumerable<Employee> employees = new List<Employee>();

// You can pass IEnumerable<Employee>,

// although the method expects IEnumerable<Person>.

PrintFullName(employees);

Comparar colecciones genéricas

En el ejemplo siguiente se muestran las ventajas de la compatibilidad con la
contravarianza en la interfaz IEqualityComparer<T>. La clase PersonComparer
implementa la interfaz IEqualityComparer<Person> . Pero se puede volver a usar esta
clase para comparar una secuencia de objetos del tipo Employee porque Employee
hereda Person .

C#

// Simple hierarchy of classes.

public class Person

public string FirstName { get; set; }

public string LastName { get; set; }

public class Employee : Person { }

// The custom comparer for the Person type

// with standard implementations of Equals()

// and GetHashCode() methods.

class PersonComparer : IEqualityComparer<Person>

public bool Equals(Person x, Person y)

if (Object.ReferenceEquals(x, y)) return true;

if (Object.ReferenceEquals(x, null) ||

Object.ReferenceEquals(y, null))

return false;

return x.FirstName == y.FirstName && x.LastName == y.LastName;

public int GetHashCode(Person person)

if (Object.ReferenceEquals(person, null)) return 0;

int hashFirstName = person.FirstName == null

? 0 : person.FirstName.GetHashCode();

 int hashLastName = person.LastName.GetHashCode();

return hashFirstName ^ hashLastName;

class Program

public static void Test()

List<Employee> employees = new List<Employee> {

new Employee() {FirstName = "Michael", LastName =

"Alexander"},

new Employee() {FirstName = "Jeff", LastName = "Price"}

};

// You can pass PersonComparer,

// which implements IEqualityComparer<Person>,

// although the method expects IEqualityComparer<Employee>.

IEnumerable<Employee> noduplicates =

employees.Distinct<Employee>(new PersonComparer());

foreach (var employee in noduplicates)

Console.WriteLine(employee.FirstName + " " + employee.LastName);

Vea también
Varianza en interfaces genéricas (C#)
Varianza en delegados (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

En .NET Framework 3.5 se presentó por primera vez la compatibilidad con la varianza
para hacer coincidir firmas de método con tipos de delegados en todos los delegados
en C#. Esto significa que puede asignar a los delegados no solo métodos con firmas
coincidentes, sino métodos que devuelven tipos más derivados (covarianza) o que
aceptan parámetros con tipos menos derivados (contravarianza) que el especificado por
el tipo de delegado. Esto incluye delegados genéricos y no genéricos.

Por ejemplo, consideremos el siguiente código, que tiene dos clases y dos delegados:
genéricos y no genéricos.

C#

public class First { }

public class Second : First { }

public delegate First SampleDelegate(Second a);

public delegate R SampleGenericDelegate<A, R>(A a);

Al crear delegados de los tipos SampleDelegate o SampleGenericDelegate<A, R> , puede

asignar uno de los métodos siguientes a dichos delegados.

C#

// Matching signature.

public static First ASecondRFirst(Second second)

{ return new First(); }

// The return type is more derived.

public static Second ASecondRSecond(Second second)

{ return new Second(); }

// The argument type is less derived.

public static First AFirstRFirst(First first)

{ return new First(); }

// The return type is more derived

// and the argument type is less derived.

public static Second AFirstRSecond(First first)

{ return new Second(); }

En el ejemplo de código siguiente se ilustra la conversión implícita entre la firma del

método y el tipo de delegado.
 C#

// Assigning a method with a matching signature

// to a non-generic delegate. No conversion is necessary.

SampleDelegate dNonGeneric = ASecondRFirst;

// Assigning a method with a more derived return type

// and less derived argument type to a non-generic delegate.

// The implicit conversion is used.

SampleDelegate dNonGenericConversion = AFirstRSecond;

// Assigning a method with a matching signature to a generic delegate.

// No conversion is necessary.

SampleGenericDelegate<Second, First> dGeneric = ASecondRFirst;

// Assigning a method with a more derived return type

// and less derived argument type to a generic delegate.

// The implicit conversion is used.

SampleGenericDelegate<Second, First> dGenericConversion = AFirstRSecond;

Para obtener más ejemplos, vea Usar varianza en delegados (C#) y Usar la varianza para
los delegados genéricos Func y Action (C#).

Varianza en parámetros de tipo genérico

En .NET Framework 4 o posterior puede habilitar la conversión implícita entre los
delegados, de modo que los delegados genéricos con tipos diferentes especificados por
parámetros de tipo genérico se puedan asignar entre sí, en el caso de que los tipos se
hereden entre sí, como requiere la varianza.

Para habilitar la conversión implícita, debe declarar explícitamente parámetros genéricos

en un delegado como covariante o contravariante mediante la palabra clave in o out .

En el ejemplo de código siguiente se muestra cómo se crea un delegado que tiene un

parámetro de tipo genérico covariante.

C#

// Type T is declared covariant by using the out keyword.

public delegate T SampleGenericDelegate <out T>();

public static void Test()

SampleGenericDelegate <String> dString = () => " ";

// You can assign delegates to each other,

// because the type T is declared covariant.

SampleGenericDelegate <Object> dObject = dString;

Si usa solo la compatibilidad con la varianza para hacer coincidir firmas de método con
tipos de delegados y no usa las palabras clave in y out , es posible que en algunas
ocasiones pueda crear instancias de delegados con métodos o expresiones lambda
idénticos, pero no pueda asignar un delegado a otro.

En el ejemplo de código siguiente, SampleGenericDelegate<String> no se puede

convertir explícitamente a SampleGenericDelegate<Object> , aunque String hereda
Object . Para solucionar este problema, marque el parámetro genérico T con la palabra
clave out .

C#

public delegate T SampleGenericDelegate<T>();

public static void Test()

SampleGenericDelegate<String> dString = () => " ";

// You can assign the dObject delegate

// to the same lambda expression as dString delegate

// because of the variance support for

// matching method signatures with delegate types.

SampleGenericDelegate<Object> dObject = () => " ";

// The following statement generates a compiler error

// because the generic type T is not marked as covariant.

// SampleGenericDelegate <Object> dObject = dString;

Delegados genéricos con parámetros de tipo variante en

.NET
En .NET Framework 4 se presentó por primera vez la compatibilidad con la varianza para
los parámetros de tipo genérico en varios delegados genéricos existentes:

Action delega del espacio de nombres System, por ejemplo, Action<T> y

Action<T1,T2>

Func delega del espacio de nombres System, por ejemplo, Func<TResult> y

Func<T,TResult>

Delegado Predicate<T>.

Delegado Comparison<T>.
 Delegado Converter<TInput,TOutput>.

Para obtener más información y ejemplos, vea Using Variance for Func and Action
Generic Delegates (C#) (Usar varianza para delegados genéricos Func y Action (C#)).

Declarar parámetros de tipo variante en delegados

genéricos
Si un delegado genérico tiene parámetros de tipo genérico covariante o contravariante,
se puede hacer referencia a él como un delegado genérico variante.

Puede declarar un parámetro de tipo genérico covariante en un delegado genérico

mediante la palabra clave out . El tipo covariante puede usarse solo como un tipo de
valor devuelto de método, y no como un tipo de argumentos de método. En el
siguiente ejemplo de código se muestra cómo declarar un delegado genérico
covariante.

C#

public delegate R DCovariant<out R>();

Puede declarar un parámetro de tipo genérico contravariante en un delegado genérico

mediante la palabra clave in . El tipo contravariante puede usarse solo como un tipo de
argumentos de método, y no como un tipo de valor devuelto de método. En el
siguiente ejemplo de código se muestra cómo declarar un delegado genérico
contravariante.

C#

public delegate void DContravariant<in A>(A a);

） Importante

Los parámetros ref , in y out de C# no se pueden marcar como variantes.

También es posible admitir la varianza y la covarianza en el mismo delegado, pero para

parámetros de tipo diferentes. Esta implementación se muestra en el ejemplo siguiente.

C#

public delegate R DVariant<in A, out R>(A a);

Crear instancias de delegados genéricos variantes e

invocarlos
Puede crear instancias de delegados variantes e invocarlos del mismo modo que crea
instancias de delegados invariables y los invoca. En el ejemplo siguiente, se crea una
instancia del delegado mediante una expresión lambda.

C#

DVariant<String, String> dvariant = (String str) => str + " ";

dvariant("test");

Combinar delegados genéricos variantes

No combine delegados variantes. El método Combine no admite la conversión de
delegados variantes y espera que los delegados sean exactamente del mismo tipo. Esto
puede provocar una excepción en tiempo de ejecución cuando se combinan delegados
mediante el método Combine o mediante el operador + , como se muestra en el
ejemplo de código siguiente.

C#

Action<object> actObj = x => Console.WriteLine("object: {0}", x);

Action<string> actStr = x => Console.WriteLine("string: {0}", x);

// All of the following statements throw exceptions at run time.

// Action<string> actCombine = actStr + actObj;

// actStr += actObj;

// Delegate.Combine(actStr, actObj);

Varianza en parámetros de tipo genérico para

los tipos de referencia y valor
La varianza para parámetros de tipo genérico solo es compatible con tipos de
referencia. Por ejemplo, DVariant<int> no se puede convertir implícitamente en
DVariant<Object> o DVariant<long> , porque un entero es un tipo de valor.

En el ejemplo siguiente se muestra que la varianza en parámetros de tipo genérico no

se admite para tipos de valor.

C#
 // The type T is covariant.

public delegate T DVariant<out T>();

// The type T is invariant.

public delegate T DInvariant<T>();

public static void Test()

int i = 0;

DInvariant<int> dInt = () => i;

DVariant<int> dVariantInt = () => i;

// All of the following statements generate a compiler error

// because type variance in generic parameters is not supported

// for value types, even if generic type parameters are declared

variant.

// DInvariant<Object> dObject = dInt;

// DInvariant<long> dLong = dInt;

// DVariant<Object> dVariantObject = dVariantInt;

// DVariant<long> dVariantLong = dVariantInt;

Vea también
Genéricos
Usar varianza para los delegados genéricos Func y Action (C#)
Procedimiento para combinar delegados (delegados de multidifusión)
Usar varianza en delegados (C#)
Artículo • 09/02/2023 • Tiempo de lectura: 2 minutos

Al asignar un método a un delegado, la covarianza y la contravarianza proporcionan

flexibilidad para hacer coincidir un tipo de delegado con una firma de método. La
covarianza permite que un método tenga un tipo de valor devuelto más derivado que el
definido en el delegado. La contravarianza permite un método que tiene tipos de
parámetro menos derivados que los del tipo de delegado.

Ejemplo 1: Covarianza

Descripción
En este ejemplo se muestra cómo se pueden usar delegados con métodos que tienen
tipos de valor devuelto derivados del tipo de valor devuelto en la firma del delegado. El
tipo de datos devuelto por DogsHandler es de tipo Dogs , que se deriva del tipo Mammals
definido en el delegado.

Código
C#

class Mammals {}

class Dogs : Mammals {}

class Program

// Define the delegate.

public delegate Mammals HandlerMethod();

public static Mammals MammalsHandler()

return null;

public static Dogs DogsHandler()

return null;

static void Test()

HandlerMethod handlerMammals = MammalsHandler;

// Covariance enables this assignment.

 HandlerMethod handlerDogs = DogsHandler;

Ejemplo 2: Contravarianza

Descripción
En este ejemplo se muestra cómo se pueden usar delegados con métodos que tienen
parámetros que son tipos base del tipo de parámetro de la firma del delegado. Con la
contravarianza, puede usar un controlador de eventos en lugar de controladores
independientes. En el ejemplo siguiente se usan dos delegados:

Un delegado KeyEventHandler que define la firma del evento Button.KeyDown. Su

firma es:

C#

public delegate void KeyEventHandler(object sender, KeyEventArgs e)

Un delegado MouseEventHandler que define la firma del evento

Button.MouseClick. Su firma es:

C#

public delegate void MouseEventHandler(object sender, MouseEventArgs e)

En el ejemplo se define un controlador de eventos con un parámetro EventArgs, que se

usa para controlar los eventos Button.KeyDown y Button.MouseClick . Es posible hacer
esto porque EventArgs es un tipo base de KeyEventArgs y MouseEventArgs.

Código
C#

// Event handler that accepts a parameter of the EventArgs type.

private void MultiHandler(object sender, System.EventArgs e)

label1.Text = System.DateTime.Now.ToString();

public Form1()

 InitializeComponent();

// You can use a method that has an EventArgs parameter,

// although the event expects the KeyEventArgs parameter.

this.button1.KeyDown += this.MultiHandler;

// You can use the same method

// for an event that expects the MouseEventArgs parameter.

this.button1.MouseClick += this.MultiHandler;

Consulte también
Varianza en delegados (C#)
Usar varianza para los delegados genéricos Func y Action (C#)
Usar la varianza para los delegados
genéricos Func y Action (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En estos ejemplos se muestra cómo usar la covarianza y la contravarianza en los

delegados genéricos Func y Action para habilitar la reutilización de métodos y
proporcionar más flexibilidad en el código.

Para obtener más información sobre la covarianza y la contravarianza, vea Varianza en

delegados (C#)

Usar delegados con parámetros de tipo

covariante
En el ejemplo siguiente se muestran las ventajas de la compatibilidad con la covarianza
en los delegados Func genéricos. El método FindByTitle toma un parámetro del tipo
String y devuelve un objeto del tipo Employee . Pero este método se puede asignar al

delegado Func<String, Person> porque Employee hereda Person .

C#

// Simple hierarchy of classes.

public class Person { }

public class Employee : Person { }

class Program

static Employee FindByTitle(String title)

// This is a stub for a method that returns

// an employee that has the specified title.

return new Employee();

static void Test()

// Create an instance of the delegate without using variance.

Func<String, Employee> findEmployee = FindByTitle;

// The delegate expects a method to return Person,

// but you can assign it a method that returns Employee.

Func<String, Person> findPerson = FindByTitle;

// You can also assign a delegate

// that returns a more derived type

// to a delegate that returns a less derived type.

 findPerson = findEmployee;

Usar delegados con parámetros de tipo

contravariante
En el ejemplo siguiente se muestran las ventajas de la compatibilidad con la
contravarianza en los delegados Action genéricos. El método AddToContacts toma un
parámetro del tipo Person . Pero este método se puede asignar al delegado
Action<Employee> porque Employee hereda Person .

C#

public class Person { }

public class Employee : Person { }

class Program

static void AddToContacts(Person person)

{

// This method adds a Person object

// to a contact list.

static void Test()

// Create an instance of the delegate without using variance.

Action<Person> addPersonToContacts = AddToContacts;

// The Action delegate expects

// a method that has an Employee parameter,

// but you can assign it a method that has a Person parameter

// because Employee derives from Person.

Action<Employee> addEmployeeToContacts = AddToContacts;

// You can also assign a delegate

// that accepts a less derived parameter to a delegate

// that accepts a more derived parameter.

addEmployeeToContacts = addPersonToContacts;

Vea también
Covarianza y contravarianza (C#)
Genéricos
Expression Trees
Artículo • 09/03/2023 • Tiempo de lectura: 4 minutos

Expression trees represent code in a tree-like data structure, where each node is an
expression, for example, a method call or a binary operation such as x < y .

If you have used LINQ, you have experience with a rich library where the Func types are
part of the API set. (If you aren't familiar with LINQ, you probably want to read the LINQ
tutorial and the article about lambda expressions before this one.) Expression Trees
provide richer interaction with the arguments that are functions.

You write function arguments, typically using Lambda Expressions, when you create
LINQ queries. In a typical LINQ query, those function arguments are transformed into a
delegate the compiler creates.

You've likely already written code that uses Expression trees. Entity Framework's LINQ
APIs accept Expression trees as the arguments for the LINQ Query Expression Pattern.
That enables Entity Framework to translate the query you wrote in C# into SQL that
executes in the database engine. Another example is Moq , which is a popular
mocking framework for .NET.

When you want to have a richer interaction, you need to use Expression Trees. Expression
Trees represent code as a structure that you examine, modify, or execute. These tools
give you the power to manipulate code during run time. You write code that examines
running algorithms, or injects new capabilities. In more advanced scenarios, you modify
running algorithms and even translate C# expressions into another form for execution in
another environment.

You compile and run code represented by expression trees. Building and running
expression trees enables dynamic modification of executable code, the execution of
LINQ queries in various databases, and the creation of dynamic queries. For more
information about expression trees in LINQ, see How to use expression trees to build
dynamic queries.

Expression trees are also used in the dynamic language runtime (DLR) to provide
interoperability between dynamic languages and .NET and to enable compiler writers to
emit expression trees instead of Microsoft intermediate language (MSIL). For more
information about the DLR, see Dynamic Language Runtime Overview.

You can have the C# or Visual Basic compiler create an expression tree for you based on
an anonymous lambda expression, or you can create expression trees manually by using
the System.Linq.Expressions namespace.
When a lambda expression is assigned to a variable of type Expression<TDelegate>, the
compiler emits code to build an expression tree that represents the lambda expression.

The C# compiler generates expression trees only from expression lambdas (or single-
line lambdas). It can't parse statement lambdas (or multi-line lambdas). For more
information about lambda expressions in C#, see Lambda Expressions.

The following code examples demonstrate how to have the C# compiler create an
expression tree that represents the lambda expression num => num < 5 .

C#

Expression<Func<int, bool>> lambda = num => num < 5;

You create expression trees in your code. You build the tree by creating each node and
attaching the nodes into a tree structure. You learn how to create expressions in the
article on building expression trees.

Expression trees are immutable. If you want to modify an expression tree, you must
construct a new expression tree by copying the existing one and replacing nodes in it.
You use an expression tree visitor to traverse the existing expression tree. For more
information, see the article on translating expression trees.

Once you build an expression tree, you execute the code represented by the expression
tree.

Limitations
There are some newer C# language elements that don't translate well into expression
trees. Expression trees can't contain await expressions, or async lambda expressions.
Many of the features added in C# 6 and later don't appear exactly as written in
expression trees. Instead, newer features are exposed in expression trees in the
equivalent, earlier syntax, where possible. Other constructs aren't available. It means that
code that interprets expression trees works the same when new language features are
introduced. However, the expression trees Even with these limitations, expression trees
do enable you to create dynamic algorithms that rely on interpreting and modifying
code that is represented as a data structure. It enables rich libraries such as Entity
Framework to accomplish what they do.

Expression trees won't support new expression node types. It would be a breaking
change for all libraries interpreting expression trees to introduce new node types. The
following list includes most C# language elements that can't be used:
Conditional methods that have been removed
base access
Method group expressions, including address-of (&) a method group, and
anonymous method expressions
References to local functions
Statements, including assignment ( = ) and statement bodied expressions
Partial methods with only a defining declaration
Unsafe pointer operations
dynamic operations
Coalescing operators with null or default literal left side, null coalescing
assignment, and the null propagating operator (?.)
Multi-dimensional array initializers, indexed properties, and dictionary initializers
throw expressions
Accessing static virtual or abstract interface members
Lambda expressions that have attributes
Interpolated strings
UTF-8 string conversions or UTF-8 string literals
Method invocations using variable arguments, named arguments or optional
arguments
Expressions using System.Index or System.Range, index "from end" (^) operator or
range expressions (..)
async lambda expressions or await expressions, including await foreach and await
using
Tuple literals, tuple conversions, tuple == or !=, or with expressions
Discards (_), deconstructing assignment, pattern matching is operator or the
pattern matching switch expression
COM call with ref omitted on the arguments
ref, in or out parameters, ref return values, out arguments, or any values of ref
struct type
Ejecución de árboles de expresión
Artículo • 13/03/2023 • Tiempo de lectura: 7 minutos

Un árbol de expresión es una estructura de datos que representa un código. No es

código compilado y ejecutable. Si quiere ejecutar el código de .NET representado
mediante un árbol de expresión, debe convertirlo en instrucciones de lenguaje
intermedio ejecutables. La ejecución de un árbol de expresión puede devolver un valor
o simplemente realizar una acción, como llamar a un método.

Solo se pueden ejecutar los árboles de expresiones que representan expresiones

lambda. Los árboles de expresiones que representan expresiones lambda son de tipo
LambdaExpression o Expression<TDelegate>. Para ejecutar estos árboles de
expresiones, llame al método Compile para crear un delegado ejecutable y, después,
invoque el delegado.

７ Nota

Si el tipo del delegado es desconocido, es decir, la expresión lambda es de tipo

LambdaExpression y no Expression<TDelegate>, llame al método DynamicInvoke
en el delegado en lugar de invocarlo directamente.

Si un árbol de expresión no representa una expresión lambda, puede crear una nueva
expresión lambda que tenga el árbol de expresión original como su cuerpo llamando al
método Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>). Luego
puede ejecutar la expresión lambda tal y como se ha descrito anteriormente en esta
sección.

Expresiones lambda a funciones

Puede convertir cualquier objeto LambdaExpression o cualquier tipo derivado de
LambdaExpression en lenguaje intermedio ejecutable. Otros tipos de expresión no se
pueden convertir directamente a código. Esta restricción tiene poco efecto en la
práctica. Las expresiones lambda son los únicos tipos de expresiones que podría querer
ejecutar mediante la conversión a lenguaje intermedio (IL) ejecutable. (Piense en lo que
significaría ejecutar directamente un elemento
System.Linq.Expressions.ConstantExpression. ¿Significaría algo útil?) Cualquier árbol de
expresión que sea un elemento System.Linq.Expressions.LambdaExpression o un tipo
derivado de LambdaExpression se puede convertir en IL. El tipo de expresión
System.Linq.Expressions.Expression<TDelegate> es el único ejemplo concreto en las
bibliotecas de .NET Core. Se usa para representar una expresión que se asigna a
cualquier tipo de delegado. Dado que este tipo se asigna a un tipo de delegado, .NET
puede examinar la expresión y generar el lenguaje intermedio de un delegado
adecuado que coincida con la firma de la expresión lambda. El tipo de delegado se basa
en el tipo de expresión. Debe conocer el tipo de valor devuelto y la lista de argumentos
si quiere usar el objeto de delegado de una forma fuertemente tipada. El método
LambdaExpression.Compile() devuelve el tipo Delegate . Tiene que convertirlo al tipo de
delegado correcto para que las herramientas de tiempo de compilación comprueben la
lista de argumentos del tipo de valor devuelto.

En la mayoría de los casos, existe una asignación simple entre una expresión y su
delegado correspondiente. Por ejemplo, un árbol de expresión que se representa por
Expression<Func<int>> se convertiría a un delegado del tipo Func<int> . Para una
expresión lambda con cualquier tipo de valor devuelto y lista de argumentos, existe un
tipo de delegado que es el tipo de destino para el código ejecutable representado por
esa expresión lambda.

El tipo System.Linq.Expressions.LambdaExpression contiene los miembros

LambdaExpression.Compile y LambdaExpression.CompileToMethod que se usarían para
convertir un árbol de expresión en código ejecutable. El método Compile crea un
delegado. El método CompileToMethod actualiza un objeto
System.Reflection.Emit.MethodBuilder con el lenguaje intermedio que representa la
salida compilada del árbol de expresión.

） Importante

CompileToMethod solo está disponible en .NET Framework, no en .NET Core o .NET 5

y versiones posteriores.

Como opción, también puede proporcionar un

System.Runtime.CompilerServices.DebugInfoGenerator que recibe la información de
depuración de símbolos para el objeto de delegado generado. DebugInfoGenerator
proporciona información de depuración completa sobre el delegado generado.

Para convertir una expresión en un delegado se usaría el siguiente código:

C#

Expression<Func<int>> add = () => 1 + 2;

var func = add.Compile(); // Create Delegate

var answer = func(); // Invoke Delegate

Console.WriteLine(answer);

En el ejemplo de código siguiente se muestran los tipos concretos que se usan al

compilar y ejecutar un árbol de expresión.

C#

Expression<Func<int, bool>> expr = num => num < 5;

// Compiling the expression tree into a delegate.

Func<int, bool> result = expr.Compile();

// Invoking the delegate and writing the result to the console.

Console.WriteLine(result(4));

// Prints True.

// You can also use simplified syntax

// to compile and run an expression tree.

// The following line can replace two previous statements.

Console.WriteLine(expr.Compile()(4));

// Also prints True.

En el ejemplo de código siguiente se muestra cómo ejecutar un árbol de expresión que

representa la elevación de un número a una potencia mediante la creación de una
expresión lambda y su posterior ejecución. Se muestra el resultado, que representa el
número elevado a la potencia.

C#

// The expression tree to execute.

BinaryExpression be = Expression.Power(Expression.Constant(2d),
Expression.Constant(3d));

// Create a lambda expression.

Expression<Func<double>> le = Expression.Lambda<Func<double>>(be);

// Compile the lambda expression.

Func<double> compiledExpression = le.Compile();

// Execute the lambda expression.

double result = compiledExpression();

// Display the result.

Console.WriteLine(result);

// This code produces the following output:

// 8

Ejecución y duraciones
El código se ejecuta mediante la invocación del delegado que se crea al llamar a
LambdaExpression.Compile() . El código anterior, add.Compile() , devuelve un delegado.

Para invocar ese delegado, llame a func() , que ejecuta el código.

Ese delegado representa el código en el árbol de expresión. Se puede conservar el

identificador a ese delegado e invocarlo más adelante. No es necesario compilar el árbol
de expresión cada vez que se quiera ejecutar el código que representa. (Recuerde que
los árboles de expresión son inmutables y que compilar el mismo árbol de expresión
más adelante crea un delegado que ejecuta el mismo código).

Ｕ Precaución

No cree ningún mecanismo de almacenamiento en caché más sofisticado para

aumentar el rendimiento evitando llamadas innecesarias de compilación. La
comparación de dos árboles de expresión arbitrarios para determinar si
representan el mismo algoritmo es una operación que consume mucho tiempo de
ejecución. Probablemente el tiempo de proceso que se ahorra al evitar llamadas
adicionales a LambdaExpression.Compile() será consumido por el tiempo de
ejecución de código que determina si dos árboles de expresión diferentes
devuelven el mismo código ejecutable.

Advertencias
Compilar una expresión lambda en un delegado e invocar ese delegado es una de las
operaciones más simples que se pueden realizar con un árbol de expresión. Pero incluso
con esta sencilla operación, hay advertencias que debe conocer.

Las expresiones lambda crean clausuras sobre las variables locales a las que se hace
referencia en la expresión. Debe garantizar que las variables que formarían parte del
delegado se pueden usar en la ubicación desde la que se llama a Compile , y cuando se
ejecuta el delegado resultante. El compilador garantiza que las variables estén en el
ámbito. Pero si la expresión tiene acceso a una variable que implementa IDisposable , es
posible que el código deseche el objeto mientras se sigue manteniendo en el árbol de
expresión.

Por ejemplo, este código funciona bien porque int no implementa IDisposable :

C#
 private static Func<int, int> CreateBoundFunc()

var constant = 5; // constant is captured by the expression tree

Expression<Func<int, int>> expression = (b) => constant + b;

var rVal = expression.Compile();

return rVal;

El delegado capturó una referencia a la variable local constant . Esa variable es accesible
en cualquier momento posterior, cuando se ejecuta la función devuelta por
CreateBoundFunc .

Pero considere la siguiente clase (bastante artificiosa) que implementa

System.IDisposable:

C#

public class Resource : IDisposable

private bool isDisposed = false;

public int Argument

get

if (!isDisposed)

return 5;

else throw new ObjectDisposedException("Resource");

public void Dispose()

isDisposed = true;

Si se usa en una expresión como se muestra en el siguiente código, obtiene una

System.ObjectDisposedException al ejecutar el código al que hace referencia la
propiedad Resource.Argument :

C#

private static Func<int, int> CreateBoundResource()

using (var constant = new Resource()) // constant is captured by the

expression tree

Expression<Func<int, int>> expression = (b) => constant.Argument +

 b;

var rVal = expression.Compile();

return rVal;

El delegado devuelto por este método se clausuró sobre el objeto constant , que se
eliminó. (Se eliminó porque se declaró en una instrucción using ).

Ahora, al ejecutar el delegado devuelto desde este método, se produce una excepción
ObjectDisposedException en el punto de ejecución.

Parece extraño tener un error en tiempo de ejecución que representa una construcción
de tiempo de compilación, pero es el mundo al que entra cuando trabaja con árboles de
expresión.

Hay numerosas permutaciones de este problema, por lo que resulta difícil ofrecer
instrucciones generales para evitarlo. Tenga cuidado al obtener acceso a las variables
locales al definir expresiones y al obtener acceso al estado en el objeto actual
(representado por this ) al crear un árbol de expresión devuelto por una API pública.

El código de la expresión puede hacer referencia a métodos o propiedades de otros

ensamblados. Ese ensamblado debe ser accesible cuando se define la expresión, cuando
se compila y cuando se invoca el delegado resultante. En los casos en los que no esté
presente, se produce una excepción ReferencedAssemblyNotFoundException .

Resumen
Los árboles de expresión que representan expresiones lambda se pueden compilar para
crear un delegado que se puede ejecutar. Los árboles de expresión proporcionan un
mecanismo para ejecutar el código representado por un árbol de expresión.

El árbol de expresión representa el código que se ejecutaría para cualquier construcción

que se cree. Mientras que el entorno donde se compile y ejecute el código coincida con
el entorno donde se crea la expresión, todo funciona según lo esperado. Cuando eso no
sucede, los errores son predecibles y se detectan en las primeras pruebas de cualquier
código que use los árboles de expresión.
Traslado de árboles de expresión
Artículo • 13/03/2023 • Tiempo de lectura: 7 minutos

En este artículo, obtendrá información sobre cómo visitar cada nodo en un árbol de
expresión, mientras se crea una copia modificada de ese árbol de expresión. Trasladará
los árboles de expresión para comprender los algoritmos para poder trasladarlos a otro
entorno. Cambiará el algoritmo que se ha creado. Podría agregar el registro, interceptar
las llamadas de método y realizar un seguimiento de ellas, o con otros fines.

El código que se compila para trasladar un árbol de expresión es una extensión de lo

que ya se vio para visitar todos los nodos de un árbol. Al trasladar un árbol de
expresión, se visitan todos los nodos y mientras se visitan, se crea el árbol nuevo. El
nuevo árbol puede contener referencias a los nodos originales o a nodos nuevos que
haya colocado en el árbol.

Visitaremos un árbol de expresión y crearemos un árbol nuevo con varios nodos de

reemplazo. En este ejemplo, se van a sustituir todas las constantes con una constante
que es diez veces mayor. De lo contrario, dejará el árbol de expresión intacto. En lugar
de leer el valor de la constante y reemplazarlo con una constante nueva, hará este
cambio reemplazando el nodo constante con un nuevo nodo que realiza la
multiplicación.

Aquí, una vez que se encuentre un nodo constante, se crea un nuevo nodo de
multiplicación cuyos elementos secundarios son la constante original y la constante 10 :

C#

private static Expression ReplaceNodes(Expression original)

if (original.NodeType == ExpressionType.Constant)

return Expression.Multiply(original, Expression.Constant(10));

else if (original.NodeType == ExpressionType.Add)

var binaryExpression = (BinaryExpression)original;

return Expression.Add(

ReplaceNodes(binaryExpression.Left),

ReplaceNodes(binaryExpression.Right));

return original;

Cree un nuevo árbol reemplazando el nodo original por el sustituto. Puede comprobar
los cambios mediante la compilación y ejecución del árbol reemplazado.
 C#

var one = Expression.Constant(1, typeof(int));

var two = Expression.Constant(2, typeof(int));

var addition = Expression.Add(one, two);

var sum = ReplaceNodes(addition);

var executableFunc = Expression.Lambda(sum);

var func = (Func<int>)executableFunc.Compile();

var answer = func();

Console.WriteLine(answer);

La creación de un árbol nuevo es una combinación de visitar los nodos del árbol
existente y crear nodos nuevos e insertarlos en el árbol. En el ejemplo anterior se
muestra la importancia de la inmutabilidad de los árboles de expresión. Observe que el
nuevo árbol creado anteriormente contiene una mezcla de los nodos recién creados y
los nodos del árbol existente. Los nodos se pueden usar en ambos árboles porque los
nodos del árbol existente no se pueden modificar. La reutilización de nodos da lugar a
importantes eficiencias de memoria. Los mismos nodos se pueden usar en un árbol o en
varios árboles de expresión. Dado que los nodos no se pueden modificar, se puede
volver a usar el mismo nodo siempre que sea necesario.

Recorrer y ejecutar una adición

Vamos a comprobar el nuevo árbol mediante la creación de un segundo visitante que
recorre el árbol de nodos de adición y calcula el resultado. Haga algunas modificaciones
en el visitante visto hasta el momento. En esta nueva versión, el visitante devolverá la
suma parcial de la operación de adición hasta este punto. Para una expresión constante,
es simplemente el valor de la expresión constante. Para una expresión de adición, el
resultado es la suma de los operandos izquierdo y derecho, una vez que se recorren
esos árboles.

C#

var one = Expression.Constant(1, typeof(int));

var two = Expression.Constant(2, typeof(int));

var three = Expression.Constant(3, typeof(int));

var four = Expression.Constant(4, typeof(int));

var addition = Expression.Add(one, two);

var add2 = Expression.Add(three, four);

var sum = Expression.Add(addition, add2);

// Declare the delegate, so you can call it

// from itself recursively:

Func<Expression, int> aggregate = null!;

// Aggregate, return constants, or the sum of the left and right operand.

 // Major simplification: Assume every binary expression is an addition.

aggregate = (exp) =>

exp.NodeType == ExpressionType.Constant ?

(int)((ConstantExpression)exp).Value :

aggregate(((BinaryExpression)exp).Left) +
aggregate(((BinaryExpression)exp).Right);

var theSum = aggregate(sum);

Console.WriteLine(theSum);

Aquí hay gran cantidad de código, pero los conceptos son accesibles. Este código visita
los elementos secundarios en una primera búsqueda de profundidad. Cuando encuentra
un nodo constante, el visitante devuelve el valor de la constante. Tras la visita a los dos
elementos secundarios por parte del visitante, dichos elementos han obtenido la suma
calculada para ese subárbol. El nodo de adición ahora puede calcular la suma. Una vez
que se visiten todos los nodos en el árbol de expresión, se habrá calculado la suma. Se
puede hacer el seguimiento de la ejecución ejecutando el ejemplo en el depurador y
realizando el seguimiento de la ejecución.

Vamos a facilitar el seguimiento de cómo se analizan los nodos y cómo se calcula la

suma mediante el recorrido del árbol. Esta es una versión actualizada del método
agregado que incluye gran cantidad de información de seguimiento:

C#

private static int Aggregate(Expression exp)

if (exp.NodeType == ExpressionType.Constant)

var constantExp = (ConstantExpression)exp;

Console.Error.WriteLine($"Found Constant: {constantExp.Value}");

if (constantExp.Value is int value)

return value;

else

return 0;

else if (exp.NodeType == ExpressionType.Add)

var addExp = (BinaryExpression)exp;

Console.Error.WriteLine("Found Addition Expression");

Console.Error.WriteLine("Computing Left node");

var leftOperand = Aggregate(addExp.Left);

Console.Error.WriteLine($"Left is: {leftOperand}");

Console.Error.WriteLine("Computing Right node");

var rightOperand = Aggregate(addExp.Right);

Console.Error.WriteLine($"Right is: {rightOperand}");

 var sum = leftOperand + rightOperand;

Console.Error.WriteLine($"Computed sum: {sum}");

return sum;

else throw new NotSupportedException("Haven't written this yet");

Al ejecutarla en la expresión sum , produce el siguiente resultado:

Resultados

10

Found Addition Expression

Computing Left node

Found Addition Expression

Computing Left node

Found Constant: 1

Left is: 1

Computing Right node

Found Constant: 2

Right is: 2

Computed sum: 3

Left is: 3

Computing Right node

Found Addition Expression

Computing Left node

Found Constant: 3

Left is: 3

Computing Right node

Found Constant: 4

Right is: 4

Computed sum: 7

Right is: 7

Computed sum: 10

10

Realice el seguimiento del resultado y siga el código anterior. Debería poder averiguar
cómo el código visita cada nodo y calcula la suma mientras recorre el árbol y busca la
suma.

Ahora, veremos una ejecución diferente, con la expresión proporcionada por sum1 :

C#

Expression<Func<int>> sum1 = () => 1 + (2 + (3 + 4));

Este es el resultado de examinar esta expresión:

Resultados
 Found Addition Expression

Computing Left node

Found Constant: 1

Left is: 1

Computing Right node

Found Addition Expression

Computing Left node

Found Constant: 2

Left is: 2

Computing Right node

Found Addition Expression

Computing Left node

Found Constant: 3

Left is: 3

Computing Right node

Found Constant: 4

Right is: 4

Computed sum: 7

Right is: 7

Computed sum: 9

Right is: 9

Computed sum: 10

10

Aunque la respuesta final es la misma, el recorrido del árbol es diferente. Los nodos se
recorren en un orden diferente, porque el árbol se construyó con diferentes operaciones
que se producen en primer lugar.

Creación de una copia modificada

Cree un nuevo proyecto de aplicación de consola. Agregue una directiva using al
archivo para el espacio de nombres System.Linq.Expressions . Agregue la clase
AndAlsoModifier al proyecto.

C#

public class AndAlsoModifier : ExpressionVisitor

public Expression Modify(Expression expression)

return Visit(expression);

protected override Expression VisitBinary(BinaryExpression b)

if (b.NodeType == ExpressionType.AndAlso)

Expression left = this.Visit(b.Left);

Expression right = this.Visit(b.Right);

 // Make this binary expression an OrElse operation instead of an

AndAlso operation.

return Expression.MakeBinary(ExpressionType.OrElse, left, right,

b.IsLiftedToNull, b.Method);

return base.VisitBinary(b);

Esta clase hereda la clase ExpressionVisitor y está especializada en la modificación de

expresiones que representan operaciones AND condicionales. Cambia estas operaciones
de una expresión AND condicional a una expresión OR condicional. La clase invalida el
método VisitBinary del tipo base, porque las expresiones AND condicionales se
representan como expresiones binarias. En el método VisitBinary , si la expresión que
se pasa representa una operación AND condicional, el código construye una nueva
expresión que contiene el operador OR condicional en lugar del operador AND
condicional. Si la expresión que se pasa a VisitBinary no representa una operación AND
condicional, el método defiere a la implementación de la case base. Los métodos de
clase base construyen nodos que son como los árboles de expresiones que se pasan,
pero los subárboles de los nodos se reemplazan por los árboles de expresiones que
genera de forma recursiva el visitante.

Agregue una directiva using al archivo para el espacio de nombres

System.Linq.Expressions . Agregue código al método Main en el archivo Program.cs
para crear un árbol de expresión y pasarlo al método que lo modifica.

C#

Expression<Func<string, bool>> expr = name => name.Length > 10 &&

name.StartsWith("G");

Console.WriteLine(expr);

AndAlsoModifier treeModifier = new AndAlsoModifier();

Expression modifiedExpr = treeModifier.Modify((Expression)expr);

Console.WriteLine(modifiedExpr);

/* This code produces the following output:

name => ((name.Length > 10) && name.StartsWith("G"))

name => ((name.Length > 10) || name.StartsWith("G"))

*/

El código crea una expresión que contiene una operación AND condicional. Luego crea
una instancia de la clase AndAlsoModifier y pasa la expresión al método Modify de esta
clase. Se generan los árboles de expresiones tanto originales como modificados para
mostrar el cambio. Compile y ejecute la aplicación.

Más información
En este ejemplo se muestra un pequeño subconjunto del código que se compilaría para
recorrer e interpretar los algoritmos representados por un árbol de expresión. Para
información sobre la compilación de una biblioteca de propósito general que traduce
árboles de expresión a otro lenguaje, lea esta serie de Matt Warren. Describe en detalle
cómo traducir cualquier código que es posible encontrar en un árbol de expresión.

Ahora ha visto la verdadera eficacia de los árboles de expresión. Examine un conjunto

de código, realice los cambios que quiera en ese código y ejecute la versión modificada.
Como los árboles de expresión son inmutables, crea árboles nuevos mediante el uso de
los componentes de árboles existentes. La reutilización de los nodos minimiza la
cantidad de memoria necesaria para crear árboles de expresión modificados.
Sintaxis de DebugView
Artículo • 13/03/2023 • Tiempo de lectura: 2 minutos

La propiedad DebugView (disponible solo durante la depuración) proporciona una

representación de cadenas de árboles de expresión. La mayor parte de la sintaxis es
bastante sencilla de entender; los casos especiales se describen en las siguientes
secciones.

Cada ejemplo va seguido de un comentario del bloque, que contiene DebugView.

ParameterExpression
los nombres de variable ParameterExpression se muestran con un símbolo $ al
principio.

Si un parámetro no tiene un nombre, se le asigna un nombre generado

automáticamente, como $var1 o $var2 .

C#

ParameterExpression numParam = Expression.Parameter(typeof(int), "num");

/*

$num

*/

ParameterExpression numParam = Expression.Parameter(typeof(int));

/*

$var1

*/

ConstantExpression
Para los objetos ConstantExpression que representan valores enteros, cadenas y null ,
se muestra el valor de la constante.

Para los tipos numéricos que tienen sufijos estándar como literales de C#, el sufijo se
agrega al valor. En la tabla siguiente se muestran los sufijos asociados a varios tipos
numéricos.

Tipo Palabra clave Sufijo

System.UInt32 uint U
 Tipo Palabra clave Sufijo

System.Int64 long L

System.UInt64 ulong UL

System.Double double D

System.Single float F

System.Decimal decimal M

C#

int num = 10;

ConstantExpression expr = Expression.Constant(num);

/*

10

*/

double num = 10;

ConstantExpression expr = Expression.Constant(num);

/*

10D

*/

BlockExpression
Si el tipo de un objeto BlockExpression difiere del tipo de la última expresión del bloque,
el tipo se muestra entre corchetes angulares ( < y > ). De otro modo, el tipo del objeto
BlockExpression no se muestra.

C#

BlockExpression block = Expression.Block(Expression.Constant("test"));

/*

.Block() {

"test"

*/

BlockExpression block = Expression.Block(typeof(Object),

Expression.Constant("test"));

/*

.Block<System.Object>() {

"test"

*/

LambdaExpression
Los objetos LambdaExpression se muestran junto con sus tipos delegados.

Si una expresión lambda no tiene un nombre, se le asigna un nombre generado

automáticamente, como #Lambda1 o #Lambda2 .

C#

LambdaExpression lambda = Expression.Lambda<Func<int>>

(Expression.Constant(1));

/*

.Lambda #Lambda1<System.Func'1[System.Int32]>() {

*/

LambdaExpression lambda = Expression.Lambda<Func<int>>

(Expression.Constant(1), "SampleLambda", null);

/*

.Lambda #SampleLambda<System.Func'1[System.Int32]>() {

*/

LabelExpression
Si especifica un valor predeterminado para el objeto LabelExpression, este valor se
muestra antes del objeto LabelTarget.

El token .Label indica el inicio de la etiqueta. El token .LabelTarget indica el destino al

que se va a saltar.

Si una etiqueta no tiene un nombre, se le asigna un nombre generado

automáticamente, como #Label1 o #Label2 .

C#

LabelTarget target = Expression.Label(typeof(int), "SampleLabel");

BlockExpression block = Expression.Block(

Expression.Goto(target, Expression.Constant(0)),

Expression.Label(target, Expression.Constant(-1))

);

/*

.Block() {

.Goto SampleLabel { 0 };

.Label

-1

 .LabelTarget SampleLabel:
}

*/

LabelTarget target = Expression.Label();

BlockExpression block = Expression.Block(

Expression.Goto(target),

Expression.Label(target)

);

/*

.Block() {

.Goto #Label1 { };

.Label

.LabelTarget #Label1:

*/

Operadores activados
Los operadores activados se muestran con el símbolo # delante del operador. Por
ejemplo, el operador de adición activado se muestra como #+ .

C#

Expression expr = Expression.AddChecked( Expression.Constant(1),

Expression.Constant(2));

/*

1 #+ 2

*/

Expression expr = Expression.ConvertChecked( Expression.Constant(10.0),

typeof(int));

/*

#(System.Int32)10D

*/

Depuración de árboles de expresión en

Visual Studio
Artículo • 13/03/2023 • Tiempo de lectura: 2 minutos

Se puede analizar la estructura y el contenido de los árboles de expresión cuando se

depuran las aplicaciones. Para obtener una introducción rápida a la estructura del árbol
de expresión, puede usar la propiedad DebugView , que representa los árboles de
expresión con una sintaxis especial. DebugView solo está disponible en modo de
depuración.

Puesto que DebugView es una cadena, puede usar el visualizador de texto integrado para
verla en varias líneas si selecciona Visualizador de texto en el icono de lupa situado
junto a la etiqueta DebugView .

Como alternativa, puede instalar y usar un visualizador personalizado para árboles de

expresión, como:

Readable Expressions (licencia MIT , disponible en Visual Studio

Marketplace ), representa el árbol de expresión como código de C# con temas,
con varias opciones de representación:
 Expression Tree Visualizer (licencia MIT ), proporciona una vista de árbol del
árbol de expresión y sus nodos individuales:

Apertura de un visualizador para un árbol de

expresión
Seleccione el icono de lupa que aparece junto al árbol de expresión en Información
sobre datos, en una ventana Inspección o en las ventanas Automático o Variables
locales. Se muestra una lista de los visualizadores disponibles:
Seleccione el visualizador que desee usar.

Vea también
Depurar en Visual Studio
Create Custom Visualizers (Crear visualizadores personalizados)
Sintaxis DebugView
Consultas basadas en el estado del
entorno de ejecución (C#)
Artículo • 13/03/2023 • Tiempo de lectura: 9 minutos

７ Nota

Asegúrese de agregar using System.Linq.Expressions; y using static

System.Linq.Expressions.Expression; en la parte superior del archivo de .cs.

Tenga en cuenta el código que define IQueryable o IQueryable<T> con respecto a un

origen de datos:

C#

var companyNames = new[] {

"Consolidated Messenger", "Alpine Ski House", "Southridge Video",

"City Power & Light", "Coho Winery", "Wide World Importers",

"Graphic Design Institute", "Adventure Works", "Humongous Insurance",

"Woodgrove Bank", "Margie's Travel", "Northwind Traders",

"Blue Yonder Airlines", "Trey Research", "The Phone Company",

"Wingtip Toys", "Lucerne Publishing", "Fourth Coffee"

};

// We're using an in-memory array as the data source, but the IQueryable
could have come

// from anywhere -- an ORM backed by a database, a web request, or any other

LINQ provider.

IQueryable<string> companyNamesSource = companyNames.AsQueryable();

var fixedQry = companyNames.OrderBy(x => x);

Cada vez que ejecute este código, se ejecutará la misma consulta exacta. Esto no suele
ser muy útil, ya que es posible que quiera que el código ejecute otras consultas en
función de las condiciones en tiempo de ejecución. En este artículo se describe cómo
puede ejecutar otra consulta en función del estado del entorno de ejecución.

IQueryable o IQueryable<T> y árboles de

expresiones
Fundamentalmente, una interfaz IQueryable tiene dos componentes:

Expression, una representación, independiente del lenguaje y del origen de datos,

de los componentes de la consulta actual, en forma de árbol de expresión.
 Provider, una instancia de un proveedor LINQ, que sabe cómo materializar la
consulta actual en un valor o en un conjunto de valores.

En el contexto de las consultas dinámicas, el proveedor normalmente seguirá siendo el

mismo; el árbol de expresión de la consulta variará entre consultas.

Los árboles de expresión son inmutables; si quieres otro árbol de expresión (y, por
tanto, otra consulta), tendrás que convertir el existente en uno nuevo y, por tanto, en
una nueva instancia de IQueryable.

En las secciones siguientes se describen técnicas específicas para realizar consultas de

forma diferente en respuesta al estado del entorno de ejecución:

Uso del estado del entorno de ejecución desde el árbol de expresión

Llamada a métodos de LINQ adicionales
Variación del árbol de expresión que se pasa a los métodos de LINQ
Creación de un árbol de expresión Expression<TDelegate> con Factory Methods
en Expression
Adición de nodos de llamada de método al árbol de expresión de IQueryable
Construcción de cadenas y uso de la biblioteca dinámica de LINQ

Uso del estado del entorno de ejecución desde

el árbol de expresión
Siempre que el proveedor LINQ lo admita, la manera más sencilla de realizar consultas
dinámicas consiste en hacer referencia al estado del entorno de ejecución de forma
directa en la consulta mediante una variable cerrada, como length en el ejemplo de
código siguiente:

C#

var length = 1;

var qry = companyNamesSource

.Select(x => x.Substring(0, length))

.Distinct();

Console.WriteLine(string.Join(",", qry));

// prints: C, A, S, W, G, H, M, N, B, T, L, F

length = 2;

Console.WriteLine(string.Join(",", qry));

// prints: Co, Al, So, Ci, Wi, Gr, Ad, Hu, Wo, Ma, No, Bl, Tr, Th, Lu, Fo

El árbol de expresión interno (y, por tanto, la consulta) no se han modificado; la consulta
solo devuelve otros valores porque se ha cambiado el valor de length .

Llamada a métodos de LINQ adicionales

Por lo general, los métodos de LINQ integrados en Queryable realizan dos pasos:

Encapsulan el árbol de expresión actual en un elemento MethodCallExpression que

representa la llamada de método.
Vuelven a pasar el árbol de expresión encapsulado al proveedor, ya sea para
devolver un valor mediante el método IQueryProvider.Execute del proveedor, o
bien para devolver un objeto de consulta traducido mediante el método
IQueryProvider.CreateQuery.

Puede reemplazar la consulta original con el resultado de un método que devuelva

IQueryable<T> para obtener una nueva consulta. Puede hacerlo condicionalmente en
función del estado del entorno de ejecución, como en el ejemplo siguiente:

C#

// bool sortByLength = /* ... */;

var qry = companyNamesSource;

if (sortByLength)

qry = qry.OrderBy(x => x.Length);

Variación del árbol de expresión que se pasa a

los métodos de LINQ
Puede pasar otras expresiones a los métodos de LINQ, en función del estado del
entorno de ejecución:

C#

// string? startsWith = /* ... */;

// string? endsWith = /* ... */;

Expression<Func<string, bool>> expr = (startsWith, endsWith) switch

("" or null, "" or null) => x => true,

(_, "" or null) => x => x.StartsWith(startsWith),

("" or null, _) => x => x.EndsWith(endsWith),

 (_, _) => x => x.StartsWith(startsWith) || x.EndsWith(endsWith)

};

var qry = companyNamesSource.Where(expr);

También es posible que quiera crear las distintas subexpresiones mediante una
biblioteca de terceros, como PredicateBuilder de LinqKit :

C#

// This is functionally equivalent to the previous example.

// using LinqKit;

// string? startsWith = /* ... */;

// string? endsWith = /* ... */;

Expression<Func<string, bool>>? expr = PredicateBuilder.New<string>(false);

var original = expr;

if (!string.IsNullOrEmpty(startsWith))

expr = expr.Or(x => x.StartsWith(startsWith));

if (!string.IsNullOrEmpty(endsWith))

expr = expr.Or(x => x.EndsWith(endsWith));

if (expr == original)

expr = x => true;

var qry = companyNamesSource.Where(expr);

Creación de árboles de expresión y consultas

mediante métodos de generador
En todos los ejemplos vistos hasta ahora, se ha conocido el tipo de elemento en tiempo
de compilación ( string ) y por tanto el tipo de la consulta ( IQueryable<string> ). Es
posible que necesite agregar componentes a una consulta de cualquier tipo de
elemento o agregar componentes diferentes, en función del tipo de elemento. Puede
crear árboles de expresión desde cero, con los métodos de generador de
System.Linq.Expressions.Expression y, por tanto, adaptar la expresión en tiempo de
ejecución a un tipo de elemento específico.

Creación de una instancia de Expression<TDelegate>

Cuando se crea una expresión para pasarla a uno de los métodos LINQ, en realidad se
crea una instancia de Expression<TDelegate>, en la que TDelegate es un tipo de
delegado como Func<string, bool> , Action o un tipo de delegado personalizado.

Expression<TDelegate> hereda de LambdaExpression, que representa una expresión

lambda completa como la siguiente:

C#

Expression<Func<string, bool>> expr = x => x.StartsWith("a");

LambdaExpression tiene dos componentes:

Una lista de parámetros ( (string x) ) representada por la propiedad Parameters.

Un cuerpo ( x.StartsWith("a") ) representado por la propiedad Body.

Los pasos básicos para crear una instancia de Expression<TDelegate> son los
siguientes:

Defina objetos ParameterExpression para cada uno de los parámetros (si existen)
de la expresión lambda, mediante el método generador Parameter.

C#

ParameterExpression x = Expression.Parameter(typeof(string), "x");

Construya el cuerpo de LambdaExpression utilizando los valores

ParameterExpression definidos por el usuario y los métodos de generador en
Expression. Por ejemplo, una expresión que represente x.StartsWith("a") se
podría crear de la siguiente manera:

C#

Expression body = Call(

x,

typeof(string).GetMethod("StartsWith", new[] { typeof(string) })!,

Constant("a")

);

Ajuste los parámetros y el cuerpo en una instancia de Expression<TDelegate> con

tipo de tiempo de compilación, mediante la sobrecarga apropiada de Factory
Method Lambda:

C#
 Expression<Func<string, bool>> expr = Lambda<Func<string, bool>>(body,
x);

En las secciones siguientes se describe un escenario en el que es posible que quiera

crear una instancia de Expression<TDelegate> para pasarla a un método LINQ, y se
proporciona un ejemplo completo de cómo hacerlo mediante Factory Methods.

Escenario
Imagine que tiene varios tipos de entidad:

C#

record Person(string LastName, string FirstName, DateTime DateOfBirth);

record Car(string Model, int Year);

En cualquiera de estos tipos de entidad, quiere filtrar y devolver solo las entidades que
contengan un texto concreto dentro de uno de sus campos string . Para Person , le
interesa buscar las propiedades FirstName y LastName :

C#

string term = /* ... */;

var personsQry = new List<Person>()

.AsQueryable()

.Where(x => x.FirstName.Contains(term) || x.LastName.Contains(term));

Pero para Car , solo quiere buscar la propiedad Model :

C#

string term = /* ... */;

var carsQry = new List<Car>()

.AsQueryable()

.Where(x => x.Model.Contains(term));

Aunque podría escribir una función personalizada para IQueryable<Person> y otra para
IQueryable<Car> , la siguiente función agrega este filtrado a cualquier consulta existente,

con independencia del tipo de elemento específico.

Ejemplo
C#
// using static System.Linq.Expressions.Expression;

IQueryable<T> TextFilter<T>(IQueryable<T> source, string term)

if (string.IsNullOrEmpty(term)) { return source; }

// T is a compile-time placeholder for the element type of the query.

Type elementType = typeof(T);

// Get all the string properties on this specific type.

PropertyInfo[] stringProperties =

elementType.GetProperties()

.Where(x => x.PropertyType == typeof(string))

.ToArray();

if (!stringProperties.Any()) { return source; }

// Get the right overload of String.Contains

MethodInfo containsMethod = typeof(string).GetMethod("Contains", new[] {

typeof(string) })!;

// Create a parameter for the expression tree:

// the 'x' in 'x => x.PropertyName.Contains("term")'

// The type of this parameter is the query's element type

ParameterExpression prm = Parameter(elementType);

// Map each property to an expression tree node

IEnumerable<Expression> expressions = stringProperties

.Select(prp =>

// For each property, we have to construct an expression tree

node like x.PropertyName.Contains("term")

Call( // .Contains(...)

Property( // .PropertyName

prm, // x

prp

),

containsMethod,

Constant(term) // "term"

);

// Combine all the resultant expression nodes using ||

Expression body = expressions

.Aggregate(

(prev, current) => Or(prev, current)

);

// Wrap the expression body in a compile-time-typed lambda expression

Expression<Func<T, bool>> lambda = Lambda<Func<T, bool>>(body, prm);

// Because the lambda is compile-time-typed (albeit with a generic

parameter), we can use it with the Where method

return source.Where(lambda);

Como la función TextFilter toma y devuelve una instancia de IQueryable<T> (y no

solo IQueryable), puede agregar más elementos de consulta con tipo de tiempo de
compilación después del filtro del texto.

C#

var qry = TextFilter(

new List<Person>().AsQueryable(),

"abcd"

.Where(x => x.DateOfBirth < new DateTime(2001, 1, 1));

var qry1 = TextFilter(

new List<Car>().AsQueryable(),

"abcd"

.Where(x => x.Year == 2010);

Adición de nodos de llamada de método al

árbol de expresión de IQueryable
Si tiene IQueryable en lugar de IQueryable<T>, no puede llamar directamente a los
métodos LINQ genéricos. Una alternativa consiste en crear el árbol de expresión interno
como se ha indicado antes y usar la reflexión para invocar el método de LINQ adecuado
mientras se pasa el árbol de expresión.

También puede duplicar la función del método de LINQ y encapsular todo el árbol en un
elemento MethodCallExpression que represente una llamada al método de LINQ:

C#

IQueryable TextFilter_Untyped(IQueryable source, string term)

if (string.IsNullOrEmpty(term)) { return source; }

Type elementType = source.ElementType;

// The logic for building the ParameterExpression and the

LambdaExpression's body is the same as in the previous example,

// but has been refactored into the constructBody function.

(Expression? body, ParameterExpression? prm) =

constructBody(elementType, term);
if (body is null) {return source;}

Expression filteredTree = Call(

typeof(Queryable),

"Where",

new[] { elementType},

 source.Expression,

Lambda(body, prm!)

);

return source.Provider.CreateQuery(filteredTree);

En este caso no tiene un marcador de posición genérico T en tiempo de compilación,

por lo que usará la sobrecarga de Lambda, que no necesita información de tipos de
tiempo de compilación, y que genera un elemento LambdaExpression en vez de una
instancia de Expression<TDelegate>.

Biblioteca dinámica de LINQ

La creación de árboles de expresión mediante métodos de generador es relativamente
compleja; es más fácil crear cadenas. La biblioteca dinámica de LINQ expone un
conjunto de métodos de extensión en IQueryable correspondiente a los métodos
estándar de LINQ en Queryable y que aceptan cadenas en una sintaxis especial en
lugar de árboles de expresión. La biblioteca genera el árbol de expresión adecuado a
partir de la cadena y puede devolver la interfaz IQueryable traducida resultante.

El ejemplo anterior se podría volver a escribir de esta manera:

C#

// using System.Linq.Dynamic.Core

IQueryable TextFilter_Strings(IQueryable source, string term) {

if (string.IsNullOrEmpty(term)) { return source; }

var elementType = source.ElementType;

// Get all the string property names on this specific type.

var stringProperties =

elementType.GetProperties()

.Where(x => x.PropertyType == typeof(string))

.ToArray();

if (!stringProperties.Any()) { return source; }

// Build the string expression

string filterExpr = string.Join(

" || ",

stringProperties.Select(prp => $"{prp.Name}.Contains(@0)")

);

return source.Where(filterExpr, term);

Vea también
Árboles de expresión (C#)
Ejecución de árboles de expresión
Especificación de filtros con predicado de forma dinámica en tiempo de ejecución
Iteradores (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 8 minutos

Un iterador puede usarse para recorrer colecciones como listas y matrices.

Un método iterador o un descriptor de acceso get realiza una iteración personalizada

en una colección. Un iterador usa la instrucción yield return para devolver cada
elemento de uno en uno. Cuando se alcanza una instrucción yield return , se recuerda
la ubicación actual en el código. La ejecución se reinicia desde esa ubicación la próxima
vez que se llama a la función del iterador.

Para consumir un método iterador desde código de cliente, use una instrucción foreach
o una consulta de LINQ.

En el ejemplo siguiente, la primera iteración del bucle foreach hace que continúe la
ejecución del método de iterador SomeNumbers hasta que se alcance la primera
instrucción yield return . Esta iteración devuelve un valor de 3, y la ubicación actual del
método de iterador se conserva. En la siguiente iteración del bucle, la ejecución del
método iterador continúa desde donde se dejó, deteniéndose de nuevo al alcanzar una
instrucción yield return . Esta iteración devuelve un valor de 5, y la ubicación actual del
método de iterador se vuelve a conservar. El bucle se completa al alcanzar el final del
método iterador.

C#

static void Main()

foreach (int number in SomeNumbers())

Console.Write(number.ToString() + " ");

// Output: 3 5 8

Console.ReadKey();

public static System.Collections.IEnumerable SomeNumbers()

yield return 3;

yield return 5;

yield return 8;

El tipo de valor devuelto de un método de iterador o descriptor de acceso get puede

ser IEnumerable, IEnumerable<T>, IEnumerator o IEnumerator<T>.
Puede usar una instrucción yield break para finalizar la iteración.

７ Nota

En todos los ejemplos de este tema, excepto en el ejemplo de iterador simple,

incluya directivas using para los espacios de nombres System.Collections y
System.Collections.Generic .

Iterador simple
El ejemplo siguiente tiene una única instrucción yield return que está dentro de un
bucle for. En Main , cada iteración del cuerpo de la instrucción foreach crea una llamada
a la función de iterador, que continúa a la instrucción yield return siguiente.

C#

static void Main()

foreach (int number in EvenSequence(5, 18))

Console.Write(number.ToString() + " ");

// Output: 6 8 10 12 14 16 18
Console.ReadKey();

public static System.Collections.Generic.IEnumerable<int>

EvenSequence(int firstNumber, int lastNumber)

// Yield even numbers in the range.

for (int number = firstNumber; number <= lastNumber; number++)

if (number % 2 == 0)

yield return number;

Creación de una clase de colección

En el ejemplo siguiente, la clase DaysOfTheWeek implementa la interfaz IEnumerable, que
requiere un método GetEnumerator. El compilador llama implícitamente al método
GetEnumerator , que devuelve un IEnumerator.
El método GetEnumerator devuelve las cadenas de una en una mediante la instrucción
yield return .

C#

static void Main()

DaysOfTheWeek days = new DaysOfTheWeek();

foreach (string day in days)

Console.Write(day + " ");

// Output: Sun Mon Tue Wed Thu Fri Sat

Console.ReadKey();

public class DaysOfTheWeek : IEnumerable

private string[] days = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri",

"Sat" };

public IEnumerator GetEnumerator()

for (int index = 0; index < days.Length; index++)

// Yield each day of the week.

yield return days[index];

En el ejemplo siguiente se crea una clase Zoo que contiene una colección de animales.

La instrucción foreach que hace referencia a la instancia de clase ( theZoo ) llama

implícitamente al método GetEnumerator . Las instrucciones foreach que hacen
referencia a las propiedades Birds y Mammals usan el método iterador con el nombre
AnimalsForType .

C#

static void Main()

Zoo theZoo = new Zoo();

theZoo.AddMammal("Whale");

theZoo.AddMammal("Rhinoceros");

theZoo.AddBird("Penguin");

theZoo.AddBird("Warbler");

 foreach (string name in theZoo)

Console.Write(name + " ");

Console.WriteLine();

// Output: Whale Rhinoceros Penguin Warbler

foreach (string name in theZoo.Birds)

Console.Write(name + " ");

Console.WriteLine();

// Output: Penguin Warbler

foreach (string name in theZoo.Mammals)

Console.Write(name + " ");

Console.WriteLine();

// Output: Whale Rhinoceros

Console.ReadKey();

public class Zoo : IEnumerable

// Private members.

private List<Animal> animals = new List<Animal>();

// Public methods.

public void AddMammal(string name)

animals.Add(new Animal { Name = name, Type = Animal.TypeEnum.Mammal

});

public void AddBird(string name)

animals.Add(new Animal { Name = name, Type = Animal.TypeEnum.Bird

});

public IEnumerator GetEnumerator()

foreach (Animal theAnimal in animals)

yield return theAnimal.Name;

// Public members.

public IEnumerable Mammals

get { return AnimalsForType(Animal.TypeEnum.Mammal); }

 public IEnumerable Birds

get { return AnimalsForType(Animal.TypeEnum.Bird); }

// Private methods.

private IEnumerable AnimalsForType(Animal.TypeEnum type)

foreach (Animal theAnimal in animals)

if (theAnimal.Type == type)

yield return theAnimal.Name;

// Private class.

private class Animal

public enum TypeEnum { Bird, Mammal }

public string Name { get; set; }

public TypeEnum Type { get; set; }

Uso de iteradores con una lista genérica

En el ejemplo siguiente, la clase genérica Stack<T> implementa la interfaz genérica
IEnumerable<T>. El método Push asigna valores a una matriz de tipo T . El método
GetEnumerator devuelve los valores de la matriz con la instrucción yield return .

Además del método GetEnumerator genérico, el método GetEnumerator no genérico

también debe implementarse. Esto es porque IEnumerable<T> se hereda de
IEnumerable. La implementación no genérica aplaza la implementación genérica.

El ejemplo usa iteradores con nombre para admitir distintas formas de recorrer en
iteración la misma colección de datos. Estos iteradores con nombre son las propiedades
TopToBottom y BottomToTop , y el método TopN .

La propiedad BottomToTop usa un iterador en un descriptor de acceso get .

C#

static void Main()

 Stack<int> theStack = new Stack<int>();

// Add items to the stack.

for (int number = 0; number <= 9; number++)

theStack.Push(number);

// Retrieve items from the stack.

// foreach is allowed because theStack implements IEnumerable<int>.

foreach (int number in theStack)

Console.Write("{0} ", number);

Console.WriteLine();

// Output: 9 8 7 6 5 4 3 2 1 0

// foreach is allowed, because theStack.TopToBottom returns

IEnumerable(Of Integer).

foreach (int number in theStack.TopToBottom)

Console.Write("{0} ", number);

Console.WriteLine();

// Output: 9 8 7 6 5 4 3 2 1 0

foreach (int number in theStack.BottomToTop)

Console.Write("{0} ", number);

Console.WriteLine();

// Output: 0 1 2 3 4 5 6 7 8 9

foreach (int number in theStack.TopN(7))

Console.Write("{0} ", number);

Console.WriteLine();

// Output: 9 8 7 6 5 4 3

Console.ReadKey();

public class Stack<T> : IEnumerable<T>

private T[] values = new T[100];

private int top = 0;

public void Push(T t)

values[top] = t;

top++;

public T Pop()

 top--;

return values[top];

// This method implements the GetEnumerator method. It allows

// an instance of the class to be used in a foreach statement.

public IEnumerator<T> GetEnumerator()

for (int index = top - 1; index >= 0; index--)

yield return values[index];

IEnumerator IEnumerable.GetEnumerator()

return GetEnumerator();

public IEnumerable<T> TopToBottom

get { return this; }

public IEnumerable<T> BottomToTop

get

for (int index = 0; index <= top - 1; index++)

yield return values[index];

public IEnumerable<T> TopN(int itemsFromTop)

// Return less than itemsFromTop if necessary.

int startIndex = itemsFromTop >= top ? 0 : top - itemsFromTop;

for (int index = top - 1; index >= startIndex; index--)

yield return values[index];

Información sobre la sintaxis

Un iterador se puede producir como un método o como un descriptor de acceso get .
Un iterador no puede aparecer en un evento, un constructor de instancia, un constructor
estático o un finalizador estático.

Debe existir una conversión implícita desde el tipo de expresión en la instrucción yield
return al argumento de tipo para el valor IEnumerable<T> devuelto por el iterador.

En C#, un método iterador no puede tener ningún parámetro in , ref o out .

En C#, yield no es una palabra reservada y solo tiene un significado especial cuando se
usa antes de una palabra clave return o break .

Implementación técnica
Aunque un iterador se escribe como un método, el compilador lo traduce a una clase
anidada que es, en realidad, una máquina de estados. Esta clase realiza el seguimiento
de la posición del iterador mientras el bucle foreach continúe en el código de cliente.

Para ver lo que hace el compilador, puede usar la herramienta Ildasm.exe para ver el
código de lenguaje intermedio de Microsoft que se genera para un método de iterador.

Cuando crea un iterador para una clase o struct, no necesita implementar la interfaz
IEnumerator completa. Cuando el compilador detecta el iterador, genera
automáticamente los métodos Current , MoveNext y Dispose de la interfaz IEnumerator
o IEnumerator<T>.

En cada iteración sucesiva del bucle foreach (o la llamada directa a

IEnumerator.MoveNext ), el cuerpo de código del iterador siguiente se reanuda después

de la instrucción yield return anterior. Después continúa con la siguiente instrucción

yield return hasta que se alcanza el final del cuerpo del iterador, o hasta que se

encuentra una instrucción yield break .

Los iteradores no admiten el método IEnumerator.Reset. Para volver a recorrer en

iteración desde el principio, se debe obtener un nuevo iterador. Una llamada a Reset en
el iterador devuelto por un método de iterador inicia una excepción
NotSupportedException.

Para obtener más información, vea la Especificación del lenguaje C#.

Uso de iteradores
Los iteradores permiten mantener la simplicidad de un bucle foreach cuando se
necesita usar código complejo para rellenar una secuencia de lista. Esto puede ser útil si
quiere hacer lo siguiente:
 Modificar la secuencia de lista después de la primera iteración del bucle foreach .

Evitar que se cargue totalmente una lista grande antes de la primera iteración de
un bucle foreach . Un ejemplo es una búsqueda paginada para cargar un lote de
filas de tabla. Otro ejemplo es el método EnumerateFiles, que implementa
iteradores en .NET.

Encapsular la creación de la lista en el iterador. En el método iterador, puede crear

la lista y después devolver cada resultado en un bucle.

Vea también
System.Collections.Generic
IEnumerable<T>
foreach, in
Utilizar foreach con matrices
Genéricos
Language Integrated Query (LINQ) (C#)
Artículo • 10/02/2023 • Tiempo de lectura: 4 minutos

Language-Integrated Query (LINQ) es el nombre de un conjunto de tecnologías basadas

en la integración de capacidades de consulta directamente en el lenguaje C#.
Tradicionalmente, las consultas con datos se expresaban como cadenas simples sin
comprobación de tipos en tiempo de compilación ni compatibilidad con IntelliSense.
Además, tendrá que aprender un lenguaje de consulta diferente para cada tipo de
origen de datos: bases de datos SQL, documentos XML, varios servicios web y así
sucesivamente. Con LINQ, una consulta es una construcción de lenguaje de primera
clase, como clases, métodos y eventos. Escribe consultas en colecciones de objetos
fuertemente tipadas con palabras clave del lenguaje y operadores familiares. La familia
de tecnologías de LINQ proporciona una experiencia de consulta coherente para
objetos (LINQ to Objects), bases de datos relacionales (LINQ to SQL) y XML (LINQ to
XML).

Para un desarrollador que escribe consultas, la parte más visible de "lenguaje integrado"
de LINQ es la expresión de consulta. Las expresiones de consulta se escriben con una
sintaxis de consulta declarativa. Con la sintaxis de consulta, puede realizar operaciones
de filtrado, ordenación y agrupamiento en orígenes de datos con el mínimo código.
Utilice los mismos patrones de expresión de consulta básica para consultar y
transformar datos de bases de datos SQL, conjuntos de datos de ADO .NET, secuencias
y documentos XML y colecciones. NET.

Puede escribir consultas LINQ en C# para bases de datos de SQL Server, documentos
XML, conjuntos de datos ADO.NET y cualquier colección de objetos que admita
IEnumerable o la interfaz genérica IEnumerable<T>. La compatibilidad con LINQ
también se proporciona por terceros para muchos servicios web y otras
implementaciones de base de datos.

En el ejemplo siguiente se muestra la operación de consulta completa. La operación

completa incluye crear un origen de datos, definir la expresión de consulta y ejecutar la
consulta en una instrucción foreach .

C#

// Specify the data source.

int[] scores = { 97, 92, 81, 60 };

// Define the query expression.

IEnumerable<int> scoreQuery =

from score in scores

where score > 80

 select score;

// Execute the query.

foreach (int i in scoreQuery)

Console.Write(i + " ");

// Output: 97 92 81

En la siguiente ilustración de Visual Studio se muestra una consulta LINQ parcialmente

completa en una base de datos de SQL Server en C# y Visual Basic con la comprobación
de tipos completa y la compatibilidad con IntelliSense:

Información general sobre la expresión de

consulta
Las expresiones de consulta se pueden utilizar para consultar y transformar los
datos de cualquier origen de datos habilitado para LINQ. Por ejemplo, una sola
consulta puede recuperar datos de una base de datos SQL y generar una secuencia
XML como salida.
Las expresiones de consulta son fáciles de controlar porque usan muchas
construcciones familiares del lenguaje C#.
Todas las variables de una expresión de consulta están fuertemente tipadas,
aunque en muchos casos no es necesario proporcionar el tipo explícitamente
porque el compilador puede deducirlo. Para más información, vea Relaciones entre
tipos en operaciones de consulta LINQ.
 Una consulta no se ejecuta hasta que no se realiza la iteración a través de la
variable de consulta, por ejemplo, en una instrucción foreach . Para más
información, vea Introducción a las consultas LINQ.
En tiempo de compilación, las expresiones de consulta se convierten en llamadas
al método de operador de consulta estándar según las reglas establecidas en la
especificación de C#. Cualquier consulta que se puede expresar con sintaxis de
consulta también se puede expresar mediante sintaxis de método. Sin embargo, en
la mayoría de los casos, la sintaxis de consulta es más legible y concisa. Para más
información, vea Especificación del lenguaje C# e Información general sobre
operadores de consulta estándar.
Como regla al escribir consultas LINQ, se recomienda utilizar la sintaxis de consulta
siempre que sea posible y la sintaxis de método cuando sea necesario. No hay
diferencias semánticas ni de rendimiento entre estas dos formas diversas. Las
expresiones de consulta suelen ser más legibles que las expresiones equivalentes
escritas con la sintaxis de método.
Algunas operaciones de consulta, como Count o Max, no tienen ninguna cláusula
de expresión de consulta equivalente, de modo que deben expresarse como una
llamada de método. La sintaxis de método se puede combinar con la sintaxis de
consulta de varias maneras. Para más información, vea Sintaxis de consultas y
sintaxis de métodos en LINQ.
Las expresiones de consulta pueden compilarse en árboles de expresión o en
delegados, en función del tipo al que se aplica la consulta. Las consultas
IEnumerable<T> se compilan en delegados. Las consultas IQueryable y
IQueryable<T> se compilan en árboles de expresión. Para más información, vea
Árboles de expresión.

Pasos siguientes
Para obtener más información sobre LINQ, empiece a familiarizarse con algunos
conceptos básicos en Conceptos básicos de las expresiones de consultas y, después, lea
la documentación de la tecnología de LINQ en la que esté interesado:

Documentos XML: LINQ to XML

ADO.NET Entity Framework: LINQ to Entities
Colecciones .NET, archivos y cadenas, entre otros: LINQ to Objects

Para comprender mejor los aspectos generales de LINQ, vea LINQ in C# (LINQ en C#).

Para empezar a trabajar con LINQ en C#, vea el tutorial Trabajar con LINQ.
Introducción a las consultas LINQ (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Una consulta es una expresión que recupera datos de un origen de datos. Las consultas
se suelen expresar en un lenguaje de consultas especializado. Con el tiempo se han
desarrollado diferentes lenguajes para los distintos tipos de orígenes de datos, como
SQL para las bases de datos relacionales y XQuery para XML. Por lo tanto, los
programadores han tenido que aprender un lenguaje de consultas nuevo para cada tipo
de origen de datos o formato de datos que deben admitir. LINQ simplifica esta situación
al ofrecer un modelo coherente para trabajar con los datos de varios formatos y
orígenes. En una consulta LINQ siempre se trabaja con objetos. Se usan los mismos
patrones de codificación básicos para consultar y transformar datos de documentos
XML, bases de datos SQL, conjuntos de datos de ADO.NET, colecciones de .NET y
cualquier otro formato para el que haya disponible un proveedor de LINQ.

Las tres partes de una operación de consulta

Todas las operaciones de consulta LINQ constan de tres acciones distintas:

1. Obtener el origen de datos.

2. Crear la consulta.

3. Ejecutar la consulta.

En el siguiente ejemplo se muestra cómo se expresan las tres partes de una operación
de consulta en código fuente. En el ejemplo se usa una matriz de enteros como origen
de datos para su comodidad, aunque se aplican los mismos conceptos a otros orígenes
de datos. En el resto de este tema se hará referencia a este ejemplo.

C#

class IntroToLINQ

static void Main()

// The Three Parts of a LINQ Query:

// 1. Data source.

int[] numbers = new int[7] { 0, 1, 2, 3, 4, 5, 6 };

// 2. Query creation.

// numQuery is an IEnumerable<int>

var numQuery =

from num in numbers

 where (num % 2) == 0

select num;

// 3. Query execution.

foreach (int num in numQuery)

Console.Write("{0,1} ", num);

En la siguiente ilustración se muestra toda la operación de consulta. En LINQ, la

ejecución de la consulta es distinta de la propia consulta. En otras palabras, no ha
recuperado ningún dato simplemente creando una variable de consulta.

El origen de datos
En el ejemplo anterior, como el origen de datos es una matriz, admite implícitamente la
interfaz genérica IEnumerable<T>. Este hecho implica que se puede consultar con LINQ.
Se ejecuta una consulta en una instrucción foreach , y foreach requiere IEnumerable o
bien IEnumerable<T>. Los tipos compatibles con IEnumerable<T> o una interfaz
derivada, como la interfaz genérica IQueryable<T>, se denominan tipos consultables.

Un tipo consultable no requiere ninguna modificación ni ningún tratamiento especial

para actuar como origen de datos de LINQ. Si el origen de datos no está en la memoria
como tipo consultable, el proveedor de LINQ debe representarlo como tal. Por ejemplo,
LINQ to XML carga un documento XML en un tipo consultable XElement:
 C#

// Create a data source from an XML document.

// using System.Xml.Linq;

XElement contacts = XElement.Load(@"c:\myContactList.xml");

Con LINQ to SQL, primero se crea una asignación relacional de objetos en tiempo de
diseño, ya sea manualmente o mediante las herramientas de LINQ to SQL en
Visual Studio. Se escriben las consultas en los objetos y, en tiempo de ejecución, LINQ to
SQL controla la comunicación con la base de datos. En el ejemplo siguiente, Customers
representa una tabla específica en una base de datos, y el tipo del resultado de la
consulta, IQueryable<T>, se deriva de IEnumerable<T>.

C#

Northwnd db = new Northwnd(@"c:\northwnd.mdf");

// Query for customers in London.

IQueryable<Customer> custQuery =

from cust in db.Customers

where cust.City == "London"

select cust;

Para obtener más información sobre cómo crear tipos específicos de orígenes de datos,
consulte la documentación de los distintos proveedores de LINQ. Aun así, la regla básica
es muy sencilla: un origen de datos de LINQ es cualquier objeto que admita la interfaz
genérica IEnumerable<T> o una interfaz que la haya heredado.

７ Nota

Los tipos como ArrayList, que admiten la interfaz no genérica IEnumerable,

también se pueden usar como origen de datos de LINQ. Para más información,
consulte el procedimiento para consultar un objeto ArrayList con LINQ (C#).

Consulta
La consulta especifica la información que se debe recuperar de los orígenes de datos.
Opcionalmente, una consulta también especifica cómo se debe ordenar, agrupar y
conformar esa información antes de que se devuelva. Las consultas se almacenan en
una variable de consulta y se inicializan con una expresión de consulta. Para facilitar la
escritura de consultas, C# ha incorporado una nueva sintaxis de consulta.
La consulta del ejemplo anterior devuelve todos los números pares de la matriz de
enteros. La expresión de consulta contiene tres cláusulas: from , where y select (si está
familiarizado con SQL, habrá observado que el orden de las cláusulas se invierte
respecto al orden de SQL). La cláusula from especifica el origen de datos, la cláusula
where aplica el filtro y la cláusula select especifica el tipo de los elementos devueltos.

Estas y otras cláusulas de consulta se tratan con detalle en la sección Language

Integrated Query (LINQ). Por ahora, lo importante es que en LINQ la variable de
consulta no efectúa ninguna acción y no devuelve ningún dato. Lo único que hace es
almacenar la información necesaria para generar los resultados cuando se ejecuta la
consulta en algún momento posterior. Para obtener más información sobre cómo se
construyen las consultas en segundo plano, vea Información general sobre operadores
de consulta estándar (C#).

７ Nota

Las consultas también se pueden expresar empleando una sintaxis de método. Para
obtener más información, vea Query Syntax and Method Syntax in LINQ (Sintaxis
de consulta y sintaxis de método en LINQ).

Ejecución de la consulta

Ejecución aplazada
Como se ha indicado anteriormente, la variable de consulta solo almacena los
comandos de consulta. La ejecución real de la consulta se aplaza hasta que se procese
una iteración en la variable de consulta en una instrucción foreach . Este concepto se
conoce como ejecución aplazada y se muestra en el ejemplo siguiente:

C#

// Query execution.

foreach (int num in numQuery)

Console.Write("{0,1} ", num);

}

La instrucción foreach es también donde se recuperan los resultados de la consulta. Por

ejemplo, en la consulta anterior, la variable de iteración num contiene cada valor (de uno
en uno) en la secuencia devuelta.
Dado que la propia variable de consulta nunca contiene los resultados de la consulta,
puede ejecutarla tantas veces como desee. Por ejemplo, se puede tener una base de
datos que esté siendo actualizada de forma continua por otra aplicación. En su
aplicación, se puede crear una consulta que recupere los datos más recientes y se puede
ejecutar repetidamente de acuerdo con un intervalo para recuperar resultados
diferentes cada vez.

Forzar la ejecución inmediata

Las consultas que llevan a cabo funciones de agregación en un intervalo de elementos
de origen primero deben recorrer en iteración dichos elementos. Ejemplos de estas
consultas son Count , Max , Average y First . Se ejecutan sin una instrucción foreach
explícita, ya que la propia consulta debe usar foreach para poder devolver un resultado.
Tenga en cuenta también que estos tipos de consultas devuelven un único valor, y no
una colección IEnumerable . La consulta siguiente devuelve un recuento de los números
pares de la matriz de origen:

C#

var evenNumQuery =

from num in numbers

where (num % 2) == 0

select num;

int evenNumCount = evenNumQuery.Count();

Para forzar la ejecución inmediata de cualquier consulta y almacenar en caché los

resultados correspondientes, puede llamar a los métodos ToList o ToArray.

C#

List<int> numQuery2 =

(from num in numbers

where (num % 2) == 0

select num).ToList();

// or like this:

// numQuery3 is still an int[]

var numQuery3 =

(from num in numbers

where (num % 2) == 0

select num).ToArray();

También puede forzar la ejecución colocando el bucle foreach justo después de la

expresión de consulta, aunque, si se llama a ToList o a ToArray , también se almacenan
en caché todos los datos de un objeto de colección.

Vea también
Introducción a LINQ en C#
Tutorial: Escribir consultas en C#
Language-Integrated Query (LINQ)
foreach, in
Palabras clave para consultas (LINQ)
LINQ y tipos genéricos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las consultas LINQ se basan en tipos genéricos incorporados en la versión 2.0 de .NET

Framework. No es necesario tener conocimientos avanzados de genéricos para poder
empezar a escribir consultas, aunque debería entender dos conceptos básicos:

1. Al crear una instancia de una clase de colección genérica como List<T>, reemplace
la "T" por el tipo de objetos que contendrá la lista. Por ejemplo, una lista de
cadenas se expresa como List<string> y una lista de objetos Customer se expresa
como List<Customer> . Las listas genéricas están fuertemente tipadas y ofrecen
muchas ventajas respecto a las colecciones que almacenan sus elementos como
Object. Si intenta agregar un Customer a una List<string> , se producirá un error
en tiempo de compilación. Usar colecciones genéricas es fácil porque no es
necesario efectuar ninguna conversión de tipos en tiempo de ejecución.

2. IEnumerable<T> es la interfaz que permite enumerar las clases de colección

genéricas mediante la instrucción foreach . Las clases de colección genéricas
admiten IEnumerable<T> simplemente como clases de colección no genéricas
como ArrayList admite IEnumerable.

Para obtener más información sobre los genéricos, vea Genéricos.

Variables IEnumerableT<> en consultas LINQ

Las variables de consulta LINQ tienen el tipo IEnumerable<T> o un tipo derivado como
IQueryable<T>. Cuando vea una variable de consulta que tiene el tipo
IEnumerable<Customer> , significa que, al ejecutarse, la consulta generará una secuencia
de cero o más objetos Customer .

C#

IEnumerable<Customer> customerQuery =

from cust in customers

where cust.City == "London"

select cust;

foreach (Customer customer in customerQuery)

Console.WriteLine(customer.LastName + ", " + customer.FirstName);

Para obtener más información, vea Relaciones entre tipos en operaciones de consulta
LINQ.

Permitir que el compilador controle las

declaraciones de tipo genérico
Si lo prefiere, puede evitar la sintaxis genérica mediante la palabra clave var. La palabra
clave var indica al compilador que infiera el tipo de una variable de consulta
examinando el origen de datos especificado en la cláusula from . En el ejemplo siguiente
se genera el mismo código compilado que en el ejemplo anterior:

C#

var customerQuery2 =

from cust in customers

where cust.City == "London"

select cust;

foreach(var customer in customerQuery2)

Console.WriteLine(customer.LastName + ", " + customer.FirstName);

La palabra clave var es útil cuando el tipo de la variable es obvio o cuando no es tan
importante especificar explícitamente los tipos genéricos anidados, como los que
generan las consultas de grupo. Le recordamos que, si usa var , debe tener presente
que puede dificultar la lectura del código a otros usuarios. Para más información, vea
Variables locales con asignación implícita de tipos.

Vea también
Genéricos
Operaciones básicas de consulta LINQ
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

En este tema se ofrece una breve introducción a las expresiones de consulta LINQ y
algunas de las clases de operaciones típicas que se realizan en una consulta. En los
temas siguientes se ofrece información más detallada:

Expresiones de consulta LINQ

Información general sobre operadores de consulta estándar (C#)

Tutorial: Creación de consultas en C#

７ Nota

Si ya está familiarizado con un lenguaje de consultas como SQL o XQuery, puede

omitir la mayoría de este tema. Lea la parte dedicada a la "cláusula from " en la
sección siguiente para obtener información sobre el orden de las cláusulas en las
expresiones de consulta LINQ.

Obtener un origen de datos

En una consulta LINQ, el primer paso es especificar el origen de datos. En C#, como en
la mayoría de los lenguajes de programación, se debe declarar una variable antes de
poder usarla. En una consulta LINQ, la cláusula from aparece en primer lugar para
introducir el origen de datos ( customers ) y la variable de rango ( cust ).

C#

//queryAllCustomers is an IEnumerable<Customer>

var queryAllCustomers = from cust in customers

select cust;

La variable de rango es como la variable de iteración en un bucle foreach , con la

diferencia de que en una expresión de consulta realmente no se produce ninguna
iteración. Cuando se ejecuta la consulta, la variable de rango actúa como referencia para
cada elemento sucesivo de customers . Dado que el compilador puede deducir el tipo de
cust , no tiene que especificarlo explícitamente. Una cláusula let puede introducir

variables de rango adicionales. Para obtener más información, vea let (Cláusula).

７ Nota

Para los orígenes de datos no genéricos, como ArrayList, el tipo de la variable de

rango debe establecerse explícitamente. Para más información, consulte el
procedimiento para consultar un objeto ArrayList con LINQ (C#) y Cláusula from.

Filtrado
Probablemente la operación de consulta más común es aplicar un filtro en forma de
expresión booleana. El filtro hace que la consulta devuelva solo los elementos para los
que la expresión es verdadera. El resultado se genera mediante la cláusula where . El
filtro aplicado especifica qué elementos se deben excluir de la secuencia de origen. En el
ejemplo siguiente, solo se devuelven los customers cuya dirección se encuentra en
Londres.

C#

var queryLondonCustomers = from cust in customers

where cust.City == "London"

select cust;

Puede usar los operadores lógicos AND y OR de C#, con los que ya estará familiarizado,
para aplicar las expresiones de filtro que sean necesarias en la cláusula where . Por
ejemplo, para devolver solo los clientes con dirección en "London" AND cuyo nombre
sea "Devon", escribiría el código siguiente:

C#

where cust.City == "London" && cust.Name == "Devon"

Para devolver los clientes con dirección en Londres o París, escribiría el código siguiente:

C#

where cust.City == "London" || cust.City == "Paris"

Para obtener más información, vea where (Cláusula).

Ordenación
A menudo es necesario ordenar los datos devueltos. La cláusula orderby hará que los
elementos de la secuencia devuelta se ordenen según el comparador predeterminado
del tipo que se va a ordenar. Por ejemplo, la consulta siguiente se puede extender para
ordenar los resultados según la propiedad Name . Dado que Name es una cadena, el
comparador predeterminado realiza una ordenación alfabética de la A a la Z.

C#

var queryLondonCustomers3 =

from cust in customers

where cust.City == "London"

orderby cust.Name ascending

select cust;

Para ordenar los resultados en orden inverso, de la Z a la A, use la cláusula orderby…

descending .

Para obtener más información, vea orderby (Cláusula).

Agrupar
La cláusula group permite agrupar los resultados según la clave que se especifique. Por
ejemplo, podría especificar que los resultados se agrupen por City para que todos los
clientes de London o París estén en grupos individuales. En este caso, la clave es
cust.City .

C#

// queryCustomersByCity is an IEnumerable<IGrouping<string, Customer>>

var queryCustomersByCity =

from cust in customers

group cust by cust.City;

// customerGroup is an IGrouping<string, Customer>

foreach (var customerGroup in queryCustomersByCity)

Console.WriteLine(customerGroup.Key);

foreach (Customer customer in customerGroup)

Console.WriteLine(" {0}", customer.Name);

Al finalizar una consulta con una cláusula group , los resultados adoptan la forma de una
lista de listas. Cada elemento de la lista es un objeto que tiene un miembro Key y una
lista de elementos agrupados bajo esa clave. Al procesar una iteración en una consulta
que genera una secuencia de grupos, debe usar un bucle foreach anidado. El bucle
exterior recorre en iteración cada grupo y el bucle interior recorre en iteración los
miembros de cada grupo.

Si debe hacer referencia a los resultados de una operación de grupo, puede usar la
palabra clave into para crear un identificador con el que se puedan realizar más
consultas. La consulta siguiente devuelve solo los grupos que contienen más de dos
clientes:

C#

// custQuery is an IEnumerable<IGrouping<string, Customer>>

var custQuery =

from cust in customers

group cust by cust.City into custGroup

where custGroup.Count() > 2

orderby custGroup.Key

select custGroup;

Para obtener más información, vea group (Cláusula).

Combinación
Las operaciones de combinación crean asociaciones entre las secuencias que no se
modelan explícitamente en los orígenes de datos. Por ejemplo, puede realizar una
combinación para buscar todos los clientes y distribuidores que tengan la misma
ubicación. En LINQ, la cláusula join funciona siempre con colecciones de objetos, en
lugar de con tablas de base de datos directamente.

C#

var innerJoinQuery =

from cust in customers

join dist in distributors on cust.City equals dist.City

select new { CustomerName = cust.Name, DistributorName = dist.Name };

En LINQ no es necesario usar join tan a menudo como en SQL, porque las claves
externas en LINQ se representan en el modelo de objetos como propiedades que
contienen una colección de elementos. Por ejemplo, un objeto Customer contiene una
colección de objetos Order . En lugar de realizar una combinación, tiene acceso a los
pedidos usando la notación de punto:

C#

from order in Customer.Orders...

Para obtener más información, vea join (Cláusula, Referencia de C#).

Selección (proyecciones)
La cláusula select genera resultados de consulta y especifica la "forma" o el tipo de
cada elemento devuelto. Por ejemplo, puede especificar si sus resultados estarán
compuestos de objetos Customer completos, un solo miembro, un subconjunto de
miembros o algún tipo de resultado completamente diferente basado en un cálculo o
en un objeto nuevo. Cuando la cláusula select genera algo distinto de una copia del
elemento de origen, la operación se denomina proyección. El uso de proyecciones para
transformar los datos es una función eficaz de las expresiones de consulta LINQ. Para
obtener más información, vea Transformaciones de datos con LINQ (C#) y select
(cláusula).

Consulte también
Expresiones de consulta LINQ
Tutorial: Creación de consultas en C#
Palabras clave para consultas (LINQ)
Tipos anónimos
Transformaciones de datos con LINQ
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Language-Integrated Query (LINQ) no solo es para recuperar datos. También es una

herramienta eficaz para transformarlos. Mediante el uso de un consulta LINQ, se puede
usar una secuencia de origen como entrada y modificarla de muchas maneras para crear
una nueva secuencia de salida. Por medio de ordenaciones y agrupaciones se puede
modificar la propia secuencia sin modificar los elementos. Pero quizás la característica
más eficaz de las consultas LINQ es la capacidad para crear nuevos tipos. Esto se realiza
en la cláusula select. Por ejemplo, puede realizar las tareas siguientes:

Combinar varias secuencias de entrada en una sola secuencia de salida que tiene
un tipo nuevo.

Crear secuencias de salida cuyos elementos estén formados por una o varias
propiedades de cada elemento de la secuencia de origen.

Crear secuencias de salida cuyos elementos estén formados por los resultados de
las operaciones realizadas en el origen de datos.

Crear secuencias de salida en un formato diferente. Por ejemplo, se pueden

transformar datos de filas de SQL o archivos de texto en XML.

Estos son solo algunos ejemplos. Por supuesto, estas transformaciones pueden
combinarse de diversas formas en la misma consulta. Además, se puede usar la
secuencia de salida de una consulta como la secuencia de entrada para una nueva
consulta.

Combinar varias entradas en una secuencia de

salida
Se puede usar una consulta LINQ para crear una secuencia de salida que contiene los
elementos de más de una secuencia de entrada. En el ejemplo siguiente se muestra
cómo combinar dos estructuras de datos en memoria, pero se pueden aplicar los
mismos principios para combinar datos de XML o de orígenes SQL o DataSet.
Supongamos los dos tipos de clase siguientes:

C#
 class Student

public string First { get; set; }

public string Last {get; set;}

public int ID { get; set; }

public string Street { get; set; }

public string City { get; set; }

public List<int> Scores;

class Teacher

public string First { get; set; }

public string Last { get; set; }

public int ID { get; set; }

public string City { get; set; }

En el ejemplo siguiente se muestra la consulta:

C#

class DataTransformations

static void Main()

// Create the first data source.

List<Student> students = new List<Student>()

new Student { First="Svetlana",

Last="Omelchenko",

ID=111,
Street="123 Main Street",

City="Seattle",

Scores= new List<int> { 97, 92, 81, 60 } },

new Student { First="Claire",

Last="O’Donnell",

ID=112,
Street="124 Main Street",

City="Redmond",

Scores= new List<int> { 75, 84, 91, 39 } },

new Student { First="Sven",

Last="Mortensen",

ID=113,
Street="125 Main Street",

City="Lake City",

Scores= new List<int> { 88, 94, 65, 91 } },

};

// Create the second data source.

List<Teacher> teachers = new List<Teacher>()

 new Teacher { First="Ann", Last="Beebe", ID=945, City="Seattle"

},

new Teacher { First="Alex", Last="Robinson", ID=956,

City="Redmond" },

new Teacher { First="Michiyo", Last="Sato", ID=972,

City="Tacoma" }

};

// Create the query.

var peopleInSeattle = (from student in students

where student.City == "Seattle"

select student.Last)

.Concat(from teacher in teachers

where teacher.City == "Seattle"

select teacher.Last);

Console.WriteLine("The following students and teachers live in

Seattle:");

// Execute the query.

foreach (var person in peopleInSeattle)

Console.WriteLine(person);

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

The following students and teachers live in Seattle:

Omelchenko

Beebe

*/

Para obtener más información, vea join (Cláusula) y select (Cláusula).

Seleccionar un subconjunto de cada elemento

de origen
Hay dos maneras principales de seleccionar un subconjunto de cada elemento de la
secuencia de origen:

1. Para seleccionar a un solo miembro del elemento de origen, use la operación de

punto. En el ejemplo siguiente, suponga que un objeto Customer contiene varias
propiedades públicas, incluida una cadena denominada City . Cuando se ejecuta,
esta consulta genera una secuencia de salida de cadenas.

C#
 var query = from cust in Customers

select cust.City;

2. Para crear elementos que contengan más de una propiedad del elemento de
origen, se puede usar un inicializador de objeto con un objeto con nombre o un
tipo anónimo. En el ejemplo siguiente se muestra el uso de un tipo anónimo para
encapsular dos propiedades de cada elemento Customer :

C#

var query = from cust in Customer

select new {Name = cust.Name, City = cust.City};

Para obtener más información, vea Inicializadores de objeto y de colección y Tipos

anónimos.

Transformar objetos en memoria en XML

Las consultas LINQ facilitan la transformación de datos entre estructuras de datos en
memoria, bases de datos SQL, conjuntos de datos de ADO.NET y documentos o
secuencias de XML. En el siguiente ejemplo se transforman objetos de una estructura de
datos en memoria en elementos XML.

C#

class XMLTransform

static void Main()

// Create the data source by using a collection initializer.

// The Student class was defined previously in this topic.

List<Student> students = new List<Student>()

new Student {First="Svetlana", Last="Omelchenko", ID=111, Scores

= new List<int>{97, 92, 81, 60}},

new Student {First="Claire", Last="O’Donnell", ID=112, Scores =

new List<int>{75, 84, 91, 39}},

new Student {First="Sven", Last="Mortensen", ID=113, Scores =

new List<int>{88, 94, 65, 91}},

};

// Create the query.

var studentsToXML = new XElement("Root",

from student in students

let scores = string.Join(",", student.Scores)

select new XElement("student",

 new XElement("First", student.First),

new XElement("Last", student.Last),

new XElement("Scores", scores)

) // end "student"

); // end "Root"

// Execute the query.

Console.WriteLine(studentsToXML);

// Keep the console open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

El código produce el siguiente resultado de XML:

XML

<Root>

<student>

<First>Svetlana</First>

<Last>Omelchenko</Last>

<Scores>97,92,81,60</Scores>

</student>

<student>

<First>Claire</First>

<Last>O'Donnell</Last>

<Scores>75,84,91,39</Scores>

</student>

<student>

<First>Sven</First>

<Last>Mortensen</Last>

<Scores>88,94,65,91</Scores>

</student>

</Root>

Para obtener más información, vea Creating XML Trees (C#) (Creación de árboles XML
[C#]).

Realizar operaciones en los elementos de

origen
Es posible que una secuencia de salida no contenga ningún elemento o propiedades de
elemento de la secuencia de origen. En su lugar, es posible que la salida sea una
secuencia de valores que se calcula usando los elementos de origen como argumentos
de entrada.
La consulta siguiente tomará una secuencia de números que representan radios de
círculos, calculará el área de cada radio y devolverá una secuencia de salida que
contenga cadenas con el formato del área calculada.

Se dará formato a cada cadena de la secuencia de salida mediante la interpolación de

cadenas. Una cadena interpolada presentará un elemento $ delante de las comillas de
apertura de la cadena, y las operaciones se pueden realizar entre llaves colocadas
dentro de la cadena interpolada. Tras realizar las operaciones, se concatenarán los
resultados.

７ Nota

No se admite llamar a métodos en expresiones de consulta si la consulta se va a

convertir a otro dominio. Por ejemplo, no se puede llamar a un método de C#
normal en LINQ to SQL porque SQL Server no tiene contexto para él. En cambio, se
pueden asignar procedimientos almacenados a los métodos y llamar a los
primeros. Para obtener más información, vea Procedimientos almacenados.

C#

class FormatQuery

static void Main()

// Data source.

double[] radii = { 1, 2, 3 };

// LINQ query using method syntax.

IEnumerable<string> output =

radii.Select(r => $"Area for a circle with a radius of '{r}' =

{r * r * Math.PI:F2}");

/*

// LINQ query using query syntax.

IEnumerable<string> output =

from rad in radii

select $"Area for a circle with a radius of '{rad}' = {rad * rad

* Math.PI:F2}";

*/

foreach (string s in output)

Console.WriteLine(s);
}

// Keep the console open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Area for a circle with a radius of '1' = 3.14

Area for a circle with a radius of '2' = 12.57

Area for a circle with a radius of '3' = 28.27

*/

Vea también
Language Integrated Query (LINQ) (C#)
LINQ to SQL
LINQ to DataSet
LINQ to XML (C#)
Expresiones de consulta LINQ
select (cláusula)
Relaciones entre tipos en operaciones
de consulta LINQ (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Para escribir las consultas eficazmente, es necesario comprender cómo los tipos de las
variables en una operación de consulta completa se relacionan entre sí. Si entiende
estas relaciones comprenderá más fácilmente los ejemplos de LINQ y los ejemplos de
código de la documentación. Además, entenderá lo que sucede en segundo plano
cuando los tipos de las variables se declaran implícitamente mediante var .

las operaciones de consulta LINQ tienen un establecimiento fuertemente tipado en el

origen de datos, en la propia consulta y en la ejecución de la consulta. El tipo de las
variables de la consulta debe ser compatible con el tipo de los elementos del origen de
datos y con el tipo de la variable de iteración de la instrucción foreach . Este
establecimiento inflexible de tipos garantiza que los errores de tipos se detectan en
tiempo de compilación, cuando aún se pueden corregir antes de que los usuarios los
detecten.

Para mostrar estas relaciones de tipos, en la mayoría de los ejemplos siguientes se usan
tipos explícitos para todas las variables. En el último ejemplo se muestra cómo se
aplican los mismos principios incluso al usar tipos implícitos mediante var.

Consultas que no transforman los datos de

origen
La ilustración siguiente muestra una operación de consulta de LINQ to Objects que no
realiza ninguna transformación de los datos. El origen contiene una secuencia de
cadenas y el resultado de la consulta también es una secuencia de cadenas.
 1. El argumento de tipo del origen de datos determina el tipo de la variable de rango.

2. El tipo del objeto que está seleccionado determina el tipo de la variable de

consulta. Aquí, name es una cadena. Por tanto, la variable de consulta es
IEnumerable<string> .

3. La variable de consulta se procesa en iteración en la instrucción foreach . Dado que

la variable de consulta es una secuencia de cadenas, la variable de iteración
también es una cadena.

Consultas que transforman los datos de origen

En la ilustración siguiente se muestra una operación de consulta de LINQ to SQL que
realiza una transformación simple de los datos. La consulta usa una secuencia de
objetos Customer como entrada y selecciona solo la propiedad Name en el resultado.
Dado que Name es una cadena, la consulta genera una secuencia de cadenas como
resultado.

1. El argumento de tipo del origen de datos determina el tipo de la variable de rango.

2. La instrucción select devuelve la propiedad Name en lugar del objeto Customer

completo. Dado que Name es una cadena, el argumento de tipo de custNameQuery
es string , no Customer .

3. Dado que custNameQuery es una secuencia de cadenas, la variable de iteración del

bucle foreach también debe ser string .

En la ilustración siguiente se muestra una transformación un poco más compleja. La

instrucción select devuelve un tipo anónimo que captura solo dos miembros del
objeto Customer original.
 1. El argumento de tipo del origen de datos siempre es el tipo de la variable de
rango de la consulta.

2. Dado que la instrucción select genera un tipo anónimo, la variable de consulta

debe declararse implícitamente mediante var .

3. Dado que el tipo de la variable de consulta es implícito, la variable de iteración del

bucle foreach también debe ser implícita.

Permitir que el compilador deduzca la

información de tipo
Aunque debería comprender las relaciones de los tipos en una operación de consulta,
tiene la opción de que el compilador le haga todo el trabajo. La palabra clave var se
puede usar para cualquier variable local en una operación de consulta. La ilustración
siguiente es similar al ejemplo número 2 que se ha analizado anteriormente. En cambio,
el compilador proporciona el tipo seguro de cada variable en la operación de consulta.

Para obtener más información sobre var , vea Variables locales con asignación implícita
de tipos.
Sintaxis de consultas y sintaxis de
métodos en LINQ (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

La mayoría de las consultas de la documentación introductoria de Language Integrated

Query (LINK) se escribe con la sintaxis de consulta declarativa de LINQ. Pero la sintaxis
de consulta debe traducirse en llamadas de método para .NET Common Language
Runtime (CLR) al compilar el código. Estas llamadas de método invocan los operadores
de consulta estándar, que tienen nombres tales como Where , Select , GroupBy , Join ,
Max y Average . Puede llamarlas directamente con la sintaxis de método en lugar de la
sintaxis de consulta.

La sintaxis de consulta y la sintaxis de método son idénticas desde el punto de vista

semántico, pero muchos usuarios creen que la sintaxis de consulta es mucho más
sencilla y fácil de leer. Algunos métodos deben expresarse como llamadas de método.
Por ejemplo, debe usar una llamada de método para expresar una consulta que
recupera el número de elementos que cumplen una condición especificada. También
debe usar una llamada de método para una consulta que recupera el elemento que
tiene el valor máximo de una secuencia de origen. La documentación de referencia de
los operadores de consulta estándar del espacio de nombres System.Linq generalmente
usa la sintaxis de método. Por consiguiente, incluso cuando empiece a escribir consultas
de LINK, resulta útil estar familiarizado con el uso de la sintaxis de método en las
consultas y en las propias expresiones de consulta.

Métodos de extensión de operador de consulta

estándar
En el ejemplo siguiente se muestra una expresión de consulta sencilla y la consulta
equivalente desde el punto de vista semántico que se escribe como consulta basada en
métodos.

C#

class QueryVMethodSyntax

static void Main()

int[] numbers = { 5, 10, 8, 3, 6, 12};

//Query syntax:

IEnumerable<int> numQuery1 =

 from num in numbers

where num % 2 == 0

orderby num

select num;

//Method syntax:

IEnumerable<int> numQuery2 = numbers.Where(num => num % 2 ==

0).OrderBy(n => n);

foreach (int i in numQuery1)

Console.Write(i + " ");

Console.WriteLine(System.Environment.NewLine);

foreach (int i in numQuery2)

Console.Write(i + " ");

// Keep the console open in debug mode.

Console.WriteLine(System.Environment.NewLine);

Console.WriteLine("Press any key to exit");

Console.ReadKey();

/*

Output:

6 8 10 12

6 8 10 12

*/

El resultado de los dos ejemplos es idéntico. Como puede ver, el tipo de variable de
consulta es el mismo en ambos formularios: IEnumerable<T>.

Para entender la consulta basada en métodos, vamos a examinarla más detenidamente.

En el lado derecho de la expresión, observe que la cláusula where ahora se expresa
como un método de instancia en el objeto numbers , que, como recordará, tiene un tipo
de IEnumerable<int> . Si está familiarizado con la interfaz genérica IEnumerable<T>,
sabe que no tiene un método Where . Pero si se invoca la lista de finalización de
IntelliSense en el IDE de Visual Studio, verá no solo un método Where , sino muchos
otros métodos tales como Select , SelectMany , Join y Orderby . Estos son todos los
operadores de consulta estándar.
Aunque parece que IEnumerable<T> se haya redefinido para incluir estos métodos
adicionales, en realidad no es el caso. Los operadores de consulta estándar se
implementan como un nuevo tipo de método denominado método de extensión. Los
métodos de extensión "extienden" un tipo existente; se pueden llamar como si fueran
métodos de instancia en el tipo. Los operadores de consulta estándar extienden
IEnumerable<T> y esta es la razón por la que la puede escribir numbers.Where(...) .

Para empezar a usar LINK, lo único que realmente debe saber sobre los métodos de
extensión es cómo incluirlos en el ámbito de la aplicación mediante el uso correcto de
directivas using . Desde el punto de vista de la aplicación, un método de extensión y un
método de instancia normal son iguales.

Para obtener más información sobre los métodos de extensión, vea Métodos de
extensión. Para obtener más información sobre los operadores de consulta estándar, vea
Información general sobre operadores de consulta estándar (C#). Algunos proveedores
LINQ, como LINQ to SQL y LINQ to XML, implementan sus propios operadores de
consulta estándar y otros métodos de extensión adicionales para otros tipos además de
IEnumerable<T>.

Expresiones lambda
En el ejemplo anterior, observe que la expresión condicional ( num % 2 == 0 ) se pasa
como argumento insertado al método Where : Where(num => num % 2 == 0). Esta
expresión insertada se denomina expresión lambda. Se trata de una forma cómoda de
escribir código que, de lo contrario, tendría que escribirse de forma más compleja como
un método anónimo, un delegado genérico o un árbol de expresión. En C#, => es el
operador lambda, que se lee como "va a". La num situada a la izquierda del operador es
la variable de entrada que corresponde a num en la expresión de consulta. El compilador
puede deducir el tipo de num porque sabe que numbers es un tipo IEnumerable<T>
genérico. El cuerpo de la expresión lambda es exactamente igual que la expresión de la
sintaxis de consulta o de cualquier otra expresión o instrucción de C#; puede incluir
llamadas de método y otra lógica compleja. El "valor devuelto" es simplemente el
resultado de la expresión.

Para empezar a usar LINK, no es necesario emplear muchas expresiones lambda. Pero
determinadas consultas solo se pueden expresar en sintaxis de método y algunas
requieren expresiones lambda. Cuando esté más familiarizado con las expresiones
lambda, verá que se trata de una herramienta eficaz y flexible del cuadro de
herramientas de LINK. Para obtener más información, vea Expresiones lambda.

Capacidad de composición de consultas

En el ejemplo de código anterior, tenga en cuenta que el método OrderBy se invoca
mediante el operador de punto en la llamada a Where . Where crea una secuencia filtrada
y, luego, Orderby actúa en dicha secuencia ordenándola. Dado que las consultas
devuelven un IEnumerable , redáctelas con la sintaxis de método encadenando las
llamadas de método. Es lo que el compilador hace en segundo plano cuando se
escriben consultas con la sintaxis de consulta. Y dado que una variable de consulta no
almacena los resultados de la consulta, puede modificarla o usarla como base para una
nueva consulta en cualquier momento, incluso después de que se haya ejecutado.
Características de C# compatibles con
LINQ
Artículo • 09/03/2023 • Tiempo de lectura: 3 minutos

Aunque estas nuevas características se usan hasta cierto punto con consultas LINQ, no
se limitan a LINQ y se pueden usar en cualquier contexto en las que se consideren de
utilidad.

Expresiones de consulta
Las expresiones de consulta usan una sintaxis declarativa similar a SQL o XQuery para
consultar colecciones de IEnumerable. En tiempo de compilación, la sintaxis de consulta
se convierte en llamadas de método a la implementación de un proveedor de LINQ de
los métodos de extensión de operador de consulta estándar. Las aplicaciones controlan
los operadores de consulta estándar que están en el ámbito al especificar el espacio de
nombres adecuado con una directiva using . La siguiente expresión de consulta toma
una matriz de cadenas, las agrupa por el primer carácter de la cadena y ordena los
grupos.

C#

var query = from str in stringArray

group str by str[0] into stringGroup

orderby stringGroup.Key

select stringGroup;

Para obtener más información, vea Expresiones de consulta LINQ.

Variables con asignación implícita de tipos (var)

En lugar de especificar explícitamente un tipo al declarar e inicializar una variable, se
puede usar el modificador var para indicar al compilador que deduzca y asigne el tipo,
como se muestra aquí:

C#

var number = 5;

var name = "Virginia";

var query = from str in stringArray

where str[0] == 'm'

select str;

Las variables declaradas como var son tan fuertemente tipadas como las variables cuyo
tipo se especifica explícitamente. El uso de var hace posible crear tipos anónimos, pero
solo se puede usar para variables locales. También se pueden declarar matrices con
asignación implícita de tipos.

Para más información, vea Variables locales con asignación implícita de tipos.

Inicializadores de objeto y colección

Los inicializadores de objeto y colección permiten inicializar objetos sin llamar
explícitamente a un constructor para el objeto. Los inicializadores normalmente se usan
en expresiones de consulta cuando proyectan los datos de origen en un nuevo tipo de
datos. Suponiendo que hay una clase denominada Customer con las propiedades
públicas Name y Phone , el inicializador de objeto se puede usar como en el código
siguiente:

C#

var cust = new Customer { Name = "Mike", Phone = "555-1212" };

Continuando con nuestra clase Customer , suponga que hay un origen de datos
denominado IncomingOrders y que para cada pedido con un OrderSize grande, nos
gustaría crear un nuevo Customer basado en ese orden. Se pueden ejecutar una
consulta LINQ en este origen de datos y usar la inicialización de objetos para rellenar
una colección:

C#

var newLargeOrderCustomers = from o in IncomingOrders

where o.OrderSize > 5

select new Customer { Name = o.Name, Phone =

o.Phone };

El origen de datos puede tener más propiedades ocultas en el montón que la clase
Customer , como OrderSize , pero con la inicialización de objetos, los datos devueltos por

la consulta se moldean en el tipo de datos deseado; elegimos los datos que son
relevantes para nuestra clase. Como resultado, ahora tenemos un IEnumerable relleno
con el nuevo Customer que queríamos. Lo anterior también se puede escribir en la
sintaxis de método de LINQ:

C#
 var newLargeOrderCustomers = IncomingOrders.Where(x => x.OrderSize >
5).Select(y => new Customer { Name = y.Name, Phone = y.Phone });

Para obtener más información, consulte:

Inicializadores de objeto y colección

Sintaxis de las expresiones de consulta para operadores de consulta estándar

Tipos anónimos
Un tipo anónimo se construye por el compilador y el nombre del tipo solo está
disponible para el compilador. Los tipos anónimos son una manera cómoda de agrupar
un conjunto de propiedades temporalmente en un resultado de consulta sin tener que
definir un tipo con nombre independiente. Los tipos anónimos se inicializan con una
nueva expresión y un inicializador de objeto, como se muestra aquí:

C#

select new {name = cust.Name, phone = cust.Phone};

Para obtener más información, vea Tipos anónimos.

Métodos de extensión.
Un método de extensión es un método estático que se puede asociar con un tipo, por
lo que puede llamarse como si fuera un método de instancia en el tipo. Esta
característica permite, en efecto, "agregar" nuevos métodos a los tipos existentes sin
tener que modificarlos realmente. Los operadores de consulta estándar son un conjunto
de métodos de extensión que proporcionan funciones de consultas LINQ para cualquier
tipo que implemente IEnumerable<T>.

Para obtener más información, vea Métodos de extensión.

Expresiones lambda
Una expresión lambda es una función insertada que usa el operador => para separar los
parámetros de entrada del cuerpo de la función y que se puede convertir en tiempo de
compilación en un delegado o un árbol de expresión. En la programación de LINQ, se
encuentran expresiones lambda al realizar llamadas de método directas a los
operadores de consulta estándar.

Para más información, consulte:

Expresiones lambda

Árboles de expresión (C#)

Vea también
Language Integrated Query (LINQ) (C#)
Tutorial: Escribir consultas en C# (LINQ)
Artículo • 10/02/2023 • Tiempo de lectura: 10 minutos

Este tutorial muestra las características del lenguaje C# que se usan para escribir
expresiones de consulta de LINQ.

Crear un proyecto de C#

７ Nota

Las siguientes instrucciones se aplican a Visual Studio. Si usa otro entorno de

desarrollo, cree un proyecto de consola con una referencia a System.Core.dll y una
directiva using para el espacio de nombres System.Linq.

Para crear un proyecto en Visual Studio

1. Inicie Visual Studio.

2. En la barra de menús, elija Archivo, Nuevo, Proyecto.

Aparece el cuadro de diálogo Nuevo proyecto .

3. Expanda Instalado, Plantillas, Visual C# y luego elija Aplicación de consola.

4. En el cuadro de texto Nombre, escriba otro nombre o acepte el predeterminado y

luego elija el botón Aceptar.

El proyecto nuevo aparece en el Explorador de soluciones.

5. Observe que el proyecto tiene una referencia a System.Core.dll y una directiva

using para el espacio de nombres System.Linq.

Crear un origen de datos en memoria

El origen de datos de las consultas es una simple lista de objetos Student . Cada registro
Student tiene un nombre, un apellido y una matriz de enteros que representa sus
puntuaciones de las pruebas en la clase. Copie este código en el proyecto. Observe las
siguientes características:

La clase Student consta de propiedades implementadas automáticamente.

 Cada alumno de la lista se inicializa con un inicializador de objeto.

La propia lista se inicializa con un inicializador de colección.

Toda la estructura de datos se inicializará y creará una instancia sin llamadas explícitas a
ningún constructor ni acceso a miembro explícito. Para obtener más información sobre
estas nuevas características, vea Propiedades autoimplementadas (Propiedades
implementadas automáticamente) y Inicializadores de objeto y de colección.

Para agregar el origen de datos

Agregue la clase Student y la lista inicializada de alumnos a la clase Program del
proyecto.

C#

public class Student

public string First { get; set; }

public string Last { get; set; }

public int ID { get; set; }

public List<int> Scores;

// Create a data source by using a collection initializer.

static List<Student> students = new List<Student>

new Student {First="Svetlana", Last="Omelchenko", ID=111, Scores=

new List<int> {97, 92, 81, 60}},

new Student {First="Claire", Last="O'Donnell", ID=112, Scores= new

List<int> {75, 84, 91, 39}},

new Student {First="Sven", Last="Mortensen", ID=113, Scores= new

List<int> {88, 94, 65, 91}},

new Student {First="Cesar", Last="Garcia", ID=114, Scores= new

List<int> {97, 89, 85, 82}},

new Student {First="Debra", Last="Garcia", ID=115, Scores= new

List<int> {35, 72, 91, 70}},

new Student {First="Fadi", Last="Fakhouri", ID=116, Scores= new

List<int> {99, 86, 90, 94}},

new Student {First="Hanying", Last="Feng", ID=117, Scores= new

List<int> {93, 92, 80, 87}},

new Student {First="Hugo", Last="Garcia", ID=118, Scores= new

List<int> {92, 90, 83, 78}},

new Student {First="Lance", Last="Tucker", ID=119, Scores= new

List<int> {68, 79, 88, 92}},

new Student {First="Terry", Last="Adams", ID=120, Scores= new

List<int> {99, 82, 81, 79}},

new Student {First="Eugene", Last="Zabokritski", ID=121, Scores=

new List<int> {96, 85, 91, 60}},

new Student {First="Michael", Last="Tucker", ID=122, Scores= new

 List<int> {94, 92, 91, 91}}

};

Para agregar un nuevo alumno a la lista de alumnos

1. Agregue un nuevo Student a la lista Students y use el nombre y las puntuaciones
de las pruebas que prefiera. Pruebe a escribir toda la nueva información de alumno
para conocer mejor la sintaxis del inicializador de objeto.

Crear la consulta

Para crear una consulta simple

En el método Main de la aplicación, cree una consulta simple que, cuando se
ejecute, genere una lista de todos los alumnos cuya puntuación en la primera
prueba haya sido superior a 90. Tenga en cuenta que, dado que se ha seleccionado
todo el objeto Student , el tipo de la consulta es IEnumerable<Student> . Aunque el
código podría usar tipos implícitos con la palabra clave var, se usan tipos explícitos
para mostrar claramente los resultados. (Para obtener más información sobre var ,
vea Implicitly Typed Local Variables [Variables locales con tipo implícito]).

Tenga también en cuenta que la variable de rango de la consulta, student , actúa

como referencia a cada Student del origen, lo que proporciona acceso a miembro
para cada objeto.

C#

// Create the query.

// The first line could also be written as "var studentQuery ="

IEnumerable<Student> studentQuery =

from student in students

where student.Scores[0] > 90

select student;

Ejecutar la consulta

Para ejecutar la consulta

1. Escriba ahora el bucle foreach que hará que la consulta se ejecute. Tenga en
cuenta los siguiente sobre el código:
 A cada elemento de la secuencia devuelta se accede mediante la variable de
iteración del bucle foreach .

El tipo de esta variables es Student y el tipo de la variable de consulta es

compatible, IEnumerable<Student> .

2. Tras agregar este código, compile y ejecute la aplicación para ver los resultados en
la ventana Consola.

C#

// Execute the query.

// var could be used here also.

foreach (Student student in studentQuery)

Console.WriteLine("{0}, {1}", student.Last, student.First);

// Output:

// Omelchenko, Svetlana

// Garcia, Cesar

// Fakhouri, Fadi

// Feng, Hanying

// Garcia, Hugo

// Adams, Terry

// Zabokritski, Eugene

// Tucker, Michael

Para agregar otra condición de filtro

1. Puede combinar varias condiciones booleanas en la cláusula where para delimitar

aún más una consulta. El código siguiente agrega una condición para que la
consulta devuelva los alumnos cuya primera puntuación haya sido superior a 90 y
cuya última puntuación haya sido inferior a 80. La cláusula where debería ser
similar al código siguiente.

C#

where student.Scores[0] > 90 && student.Scores[3] < 80

Para obtener más información, vea where (Cláusula).

Modificar la consulta
Para ordenar los resultados
1. Le resultará más fácil examinar los resultados si se muestran con algún tipo de
orden. Puede ordenar la secuencia devuelta por cualquier campo accesible de los
elementos de origen. Por ejemplo, la cláusula orderby siguiente ordena los
resultados alfabéticamente de la A a la Z por el apellido de cada alumno. Agregue
la cláusula orderby siguiente a la consulta, inmediatamente después de la
instrucción where y antes de la instrucción select :

C#

orderby student.Last ascending

2. Cambie ahora la cláusula orderby para que ordene los resultados en orden inverso
según la puntuación en la primera prueba, de la puntuación más alta a la más baja.

C#

orderby student.Scores[0] descending

3. Cambie la cadena de formato WriteLine para poder ver las puntuaciones:

C#

Console.WriteLine("{0}, {1} {2}", student.Last, student.First,

student.Scores[0]);

Para obtener más información, vea orderby (Cláusula).

Para agrupar los resultados

1. La agrupación es una funcionalidad de gran eficacia en expresiones de consulta.

Una consulta con una cláusula group genera una secuencia de grupos y cada
grupo propiamente dicho contiene un Key y una secuencia que consta de todos
los miembros del grupo. La siguiente nueva consulta agrupa los alumnos usando
la primera letra del apellido como clave.

C#

// studentQuery2 is an IEnumerable<IGrouping<char, Student>>

var studentQuery2 =

from student in students

group student by student.Last[0];

 2. Tenga en cuenta que el tipo de la consulta ha cambiado. Ahora genera una

secuencia de grupos que tienen un tipo char como clave y una secuencia de
objetos Student . Dado que el tipo de la consulta ha cambiado, el siguiente código
cambia también el bucle de ejecución foreach :

C#

// studentGroup is a IGrouping<char, Student>

foreach (var studentGroup in studentQuery2)

Console.WriteLine(studentGroup.Key);

foreach (Student student in studentGroup)

Console.WriteLine(" {0}, {1}",

student.Last, student.First);

// Output:

// O

// Omelchenko, Svetlana

// O'Donnell, Claire

// M

// Mortensen, Sven

// G

// Garcia, Cesar

// Garcia, Debra

// Garcia, Hugo

// F

// Fakhouri, Fadi

// Feng, Hanying

// T

// Tucker, Lance

// Tucker, Michael

// A

// Adams, Terry

// Z

// Zabokritski, Eugene

3. Ejecute la aplicación y vea los resultados en la ventana Consola.

Para obtener más información, vea group (Cláusula).

Para que las variables tengan tipo implícito

1. La codificación explícita con IEnumerables de IGroupings puede resultar tediosa.

Puede escribir la misma consulta y el bucle foreach mucho más cómodamente
con var . La palabra clave var no cambia los tipos de los objetos; solo indica al
 compilador que deduzca los tipos. Cambie el tipo de studentQuery y la variable de
iteración group a var y vuelva a ejecutar la consulta. Tenga en cuenta que en el
bucle foreach interior, la variable de iteración sigue teniendo como tipo Student y
la consulta funciona igual que antes. Cambie la variable de iteración student a var
y vuelva a ejecutar la consulta. Como puede ver, obtiene exactamente los mismos
resultados.

C#

var studentQuery3 =

from student in students

group student by student.Last[0];

foreach (var groupOfStudents in studentQuery3)

Console.WriteLine(groupOfStudents.Key);

foreach (var student in groupOfStudents)

Console.WriteLine(" {0}, {1}",

student.Last, student.First);

// Output:

// O

// Omelchenko, Svetlana

// O'Donnell, Claire

// M

// Mortensen, Sven

// G

// Garcia, Cesar

// Garcia, Debra

// Garcia, Hugo

// F

// Fakhouri, Fadi

// Feng, Hanying

// T

// Tucker, Lance

// Tucker, Michael

// A

// Adams, Terry

// Z

// Zabokritski, Eugene

Para obtener más información sobre var, vea Variables locales con asignación
implícita de tipos.

Para ordenar los grupos por su valor clave

1. Al ejecutar la consulta anterior, observará que los grupos no están en orden
alfabético. Para cambiar esto, debe especificar una cláusula orderby después de la
cláusula group . Pero para usar una cláusula orderby , necesita primero un
identificador que actúe como referencia a los grupos creados por la cláusula
group . El identificador se especifica con la palabra clave into , de la manera

siguiente:

C#

var studentQuery4 =

from student in students

group student by student.Last[0] into studentGroup

orderby studentGroup.Key

select studentGroup;

foreach (var groupOfStudents in studentQuery4)

Console.WriteLine(groupOfStudents.Key);

foreach (var student in groupOfStudents)

Console.WriteLine(" {0}, {1}",

student.Last, student.First);

// Output:

//A

// Adams, Terry

//F

// Fakhouri, Fadi

// Feng, Hanying

//G

// Garcia, Cesar

// Garcia, Debra

// Garcia, Hugo

//M

// Mortensen, Sven

//O

// Omelchenko, Svetlana

// O'Donnell, Claire

//T

// Tucker, Lance

// Tucker, Michael

//Z

// Zabokritski, Eugene

Cuando ejecute esta consulta, verá que los grupos aparecen ahora ordenados
alfabéticamente.
Para incluir un identificador mediante let
1. Puede usar la palabra clave let para incluir un identificador con cualquier
resultado de la expresión en la expresión de consulta. Este identificador puede
resultar cómodo, como en el ejemplo siguiente, o mejorar el rendimiento
almacenando los resultados de una expresión para que no tenga que calcularse
varias veces.

C#

// studentQuery5 is an IEnumerable<string>

// This query returns those students whose

// first test score was higher than their

// average score.

var studentQuery5 =

from student in students

let totalScore = student.Scores[0] + student.Scores[1] +

student.Scores[2] + student.Scores[3]

where totalScore / 4 < student.Scores[0]

select student.Last + " " + student.First;

foreach (string s in studentQuery5)

Console.WriteLine(s);

// Output:

// Omelchenko Svetlana

// O'Donnell Claire

// Mortensen Sven

// Garcia Cesar

// Fakhouri Fadi

// Feng Hanying

// Garcia Hugo

// Adams Terry

// Zabokritski Eugene

// Tucker Michael

Para obtener más información, vea let (Cláusula).

Para usar la sintaxis de método en una expresión de consulta

1. Tal y como se describe en Sintaxis de consulta y sintaxis de método en LINQ,
algunas operaciones de consulta solo pueden expresarse con una sintaxis de
método. El código siguiente calcula la puntuación total de cada Student de la
secuencia de origen y luego llama al método Average() en los resultados de esa
consulta para calcular la puntuación media de la clase.
 C#

var studentQuery6 =

from student in students

let totalScore = student.Scores[0] + student.Scores[1] +

student.Scores[2] + student.Scores[3]

select totalScore;

double averageScore = studentQuery6.Average();

Console.WriteLine("Class average score = {0}", averageScore);

// Output:

// Class average score = 334.166666666667

Para transformar o proyectar en la cláusula select

1. Es muy frecuente que una consulta genere una secuencia cuyos elementos difieren
de los elementos de las secuencias de origen. Elimine la consulta y el bucle de
ejecución anteriores o conviértalos en comentario, y reemplácelos por el código
siguiente. Tenga en cuenta que la consulta devuelve una secuencia de cadenas (no
Students ) y este hecho se refleja en el bucle foreach .

C#

IEnumerable<string> studentQuery7 =

from student in students

where student.Last == "Garcia"

select student.First;

Console.WriteLine("The Garcias in the class are:");

foreach (string s in studentQuery7)

Console.WriteLine(s);

// Output:

// The Garcias in the class are:

// Cesar

// Debra

// Hugo

2. El código anterior en este tutorial indicaba que la puntuación media de la clase es

aproximadamente 334. Para generar una secuencia de Students cuya puntuación
total sea superior al promedio de la clase, junto con su Student ID , puede usar un
tipo anónimo en la instrucción select :

C#
 var studentQuery8 =

from student in students

let x = student.Scores[0] + student.Scores[1] +

student.Scores[2] + student.Scores[3]

where x > averageScore

select new { id = student.ID, score = x };

foreach (var item in studentQuery8)

Console.WriteLine("Student ID: {0}, Score: {1}", item.id,

item.score);

// Output:

// Student ID: 113, Score: 338

// Student ID: 114, Score: 353

// Student ID: 116, Score: 369

// Student ID: 117, Score: 352

// Student ID: 118, Score: 343

// Student ID: 120, Score: 341

// Student ID: 122, Score: 368

Pasos siguientes
Cuando se haya familiarizado con los aspectos básicos del uso de consultas en C#,
estará preparado para leer la documentación y ejemplos del tipo específico de
proveedor LINQ que le interese:

LINQ to SQL

LINQ to DataSet

LINQ to XML (C#)

LINQ to Objects (C#)

Vea también
Language Integrated Query (LINQ) (C#)
Expresiones de consulta LINQ
Información general sobre operadores
de consulta estándar (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Los operadores de consulta estándar son los métodos que constituyen el modelo LINQ.
La mayoría de estos métodos funciona en secuencias; donde una secuencia es un objeto
cuyo tipo implementa la interfaz IEnumerable<T> o la interfaz IQueryable<T>. Los
operadores de consulta estándar ofrecen funcionalidades de consulta, como las
funciones de filtrado, proyección, agregación y ordenación, entre otras.

Hay dos conjuntos de operadores de consulta estándar de LINQ: uno que actúa sobre
objetos de tipo IEnumerable<T> y otro sobre objetos de tipo IQueryable<T>. Los
métodos que forman cada conjunto son miembros estáticos de las clases Enumerable y
Queryable, respectivamente. Se definen como métodos de extensión del tipo en el que
actúan. Se puede llamar a los métodos de extensión mediante sintaxis de método
estático o sintaxis de método de instancia.

Además, varios métodos de operador de consulta estándar funcionan en tipos distintos

de los que se basan en IEnumerable<T> o IQueryable<T>. El tipo Enumerable define
dos métodos que funcionan en objetos de tipo IEnumerable. Estos métodos,
Cast<TResult>(IEnumerable) y OfType<TResult>(IEnumerable), le permiten habilitar una
colección no genérica o no parametrizada para consultarse en el patrón LINQ. Para ello,
se crea una colección de objetos fuertemente tipados. La clase Queryable define dos
métodos similares, Cast<TResult>(IQueryable) y OfType<TResult>(IQueryable), que
funcionan en objetos de tipo IQueryable.

Los operadores de consulta estándar difieren en sus intervalos de ejecución,

dependiendo de que devuelvan un valor singleton o una secuencia de valores. Esos
métodos que devuelven un valor singleton (por ejemplo, Average y Sum) se ejecutan
inmediatamente. Los métodos que devuelven una secuencia aplazan la ejecución de la
consulta y devuelven un objeto enumerable.

En el caso de los métodos que actúan en colecciones en memoria, es decir, los métodos
que extienden IEnumerable<T>, el objeto enumerable devuelto captura los argumentos
que se han pasado al método. Cuando se enumera ese objeto, se emplea la lógica del
operador de consulta y se devuelven los resultados de la consulta.

En cambio, los métodos que extienden IQueryable<T> no implementan ningún

comportamiento de realización de consultas. Compilan un árbol de expresión que
representa la consulta que se va a realizar. El procesamiento de consultas se controla
mediante el objeto IQueryable<T> de origen.
Las llamadas a métodos de consulta se pueden encadenar juntas en una consulta, lo
que permite que las consultas se conviertan en complejas de forma arbitraria.

En el ejemplo de código siguiente se muestra el uso de los operadores de consulta

estándar para obtener información sobre una secuencia.

C#

string sentence = "the quick brown fox jumps over the lazy dog";

// Split the string into individual words to create a collection.

string[] words = sentence.Split(' ');

// Using query expression syntax.

var query = from word in words

group word.ToUpper() by word.Length into gr

orderby gr.Key

select new { Length = gr.Key, Words = gr };

// Using method-based query syntax.

var query2 = words.

GroupBy(w => w.Length, w => w.ToUpper()).

Select(g => new { Length = g.Key, Words = g }).

OrderBy(o => o.Length);

foreach (var obj in query)

Console.WriteLine("Words of length {0}:", obj.Length);

foreach (string word in obj.Words)

Console.WriteLine(word);

// This code example produces the following output:

//

// Words of length 3:

// THE

// FOX

// THE

// DOG

// Words of length 4:

// OVER

// LAZY

// Words of length 5:

// QUICK

// BROWN

// JUMPS

Sintaxis de expresiones de consulta

Algunos de los operadores de consulta estándar que se usan con más frecuencia tienen
una sintaxis especial de palabras clave dedicadas de lenguaje C# y Visual Basic para que
se puedan invocar como parte de una expresiónde consulta. Para obtener más
información sobre los operadores de consulta estándar que incluyen palabras clave
dedicadas y sus sintaxis correspondientes, vea Sintaxis de las expresiones de consulta
para operadores de consulta estándar (C#).

Extender los operadores de consulta estándar

Puede aumentar el conjunto de operadores de consulta estándar creando métodos
específicos de dominio que sean adecuados para su tecnología o dominio de destino.
También puede reemplazar los operadores de consulta estándar con sus propias
implementaciones que proporcionen otros servicios tales como evaluación remota,
traducción de consultas y optimización. Vea AsEnumerable para obtener un ejemplo.

Secciones relacionadas
Los vínculos siguientes llevan a artículos que ofrecen información adicional sobre los
distintos operadores de consulta estándar según la funcionalidad.

Ordenación de datos [C#]

Operaciones set [C#]

Filtrado de datos [C#]

Operaciones cuantificadoras [C#]

Operaciones de proyección [C#]

Realizar particiones de datos [C#]

Operaciones de combinación [C#]

Agrupar datos [C#]

Operaciones de generación [C#]

Operaciones de igualdad [C#]

Operaciones de elementos [C#]

Convertir tipos de datos [C#]

Operaciones de concatenación [C#]

Operaciones de agregación [C#]

Vea también
Enumerable
Queryable
Introducción a las consultas LINQ (C#)
Sintaxis de las expresiones de consulta para operadores de consulta estándar (C#)
Clasificación de operadores de consulta estándar por modo de ejecución (C#)
Métodos de extensión
Sintaxis de las expresiones de consulta
para operadores de consulta estándar
(C#)
Artículo • 22/09/2022 • Tiempo de lectura: 2 minutos

Algunos de los operadores de consulta estándar que se usan con más frecuencia tienen
una sintaxis especial de palabras clave de lenguaje C# para que se puedan invocar como
parte de una expresión de consulta. Una expresión de consulta constituye una forma
diferente de expresar una consulta, más legible que su equivalente basado en métodos.
Las cláusulas de las expresiones de consulta se convierten en llamadas a los métodos de
consulta en tiempo de compilación.

Tabla de sintaxis de expresiones de consulta

En la tabla siguiente se muestran los operadores de consulta estándar que poseen
cláusulas de expresiones de consulta equivalentes.

Método Sintaxis de la expresión

de consulta de C#

Cast Use una variable de rango

con tipo explícito, por
ejemplo:

from int i in numbers

(Para obtener más

información, vea Cláusula
from).

GroupBy group … by

o bien

group … by … into …

(Para obtener más

información, vea Cláusula
group).
Método Sintaxis de la expresión
de consulta de C#

GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, join … in … on … equals

IEnumerable<TInner>,
Func<TOuter,TKey>, Func<TInner,TKey>, … into …

Func<TOuter,IEnumerable<TInner>,
TResult>)
(Para obtener más
información, vea join
(Cláusula, Referencia de
C#)).

Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, join … in … on … equals

IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, …

Func<TOuter,TInner,TResult>)
(Para obtener más
información, vea join
(Cláusula, Referencia de
C#)).

OrderBy<TSource,TKey>(IEnumerable<TSource>, orderby

Func<TSource,TKey>)
(Para obtener más
información, vea orderby
(Cláusula)).

OrderByDescending<TSource,TKey>(IEnumerable<TSource>, orderby … descending

Func<TSource,TKey>)
(Para obtener más
información, vea orderby
(Cláusula)).

Select select

(Para obtener más

información, vea Cláusula
select).

SelectMany Varias cláusulas from .

(Para obtener más

información, vea Cláusula
from).

ThenBy<TSource,TKey>(IOrderedEnumerable<TSource>, orderby …, …

Func<TSource,TKey>)
(Para obtener más
información, vea orderby
(Cláusula)).
Método Sintaxis de la expresión
de consulta de C#

ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, orderby …, … descending

Func<TSource,TKey>)
(Para obtener más
información, vea orderby
(Cláusula)).

Where where

(Para obtener más

información, vea where
(Cláusula)).

Consulte también
Enumerable
Queryable
Información general sobre operadores de consulta estándar (C#)
Clasificación de operadores de consulta estándar por modo de ejecución (C#)
Clasificación de operadores de consulta
estándar por modo de ejecución (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las implementaciones de LINQ to Objects de los métodos de operador de consulta

estándar se ejecutan de una de dos formas principales: inmediata o aplazada. Los
operadores de consulta que usan la ejecución aplazada pueden dividirse además en dos
categorías: de streaming y de no streaming. Si sabe cómo se ejecutan los diferentes
operadores de consulta, puede servirle para entender los resultados que se obtienen de
una consulta determinada. Esto es especialmente cierto si se está cambiando el origen
de datos o si se está creando una consulta sobre otra. En este tema se clasifican los
operadores de consulta estándar según su modo de ejecución.

Modos de ejecución

Inmediato
La ejecución inmediata significa que se lee el origen de datos y que la operación se
realiza una vez. Todos los operadores de consulta estándar que devuelven un resultado
escalar se ejecutan de manera inmediata. Puede forzar que una consulta se ejecute
inmediatamente mediante los métodos Enumerable.ToList y Enumerable.ToArray. La
ejecución inmediata permite reutilizar los resultados de la consulta, no su declaración.
Los resultados se recuperan una vez y, después, se almacenan para usarlos en el futuro.

Aplazada
La ejecución aplazada significa que la operación no se realiza en el punto en el código
donde se declara la consulta. La operación se realiza solo cuando se enumera la variable
de consulta, por ejemplo, mediante una instrucción foreach . Esto significa que los
resultados de ejecutar la consulta dependen del contenido del origen de datos cuando
se ejecuta la consulta en lugar de cuando se define la consulta. Si la variable de consulta
se enumera varias veces, es posible que los resultados difieran cada vez. Casi todos los
operadores de consulta estándar cuyo tipo de valor devuelto es IEnumerable<T> o
IOrderedEnumerable<TElement> se ejecutan de una manera diferida. La ejecución
diferida aporta la facilidad de reutilizar las consultas, ya que la consulta captura los
datos actualizados del origen de datos cada vez que se iteran los resultados de la
consulta.
Los operadores de consulta que usan la ejecución aplazada pueden clasificarse además
como de streaming o de no streaming.

Streaming

Los operadores de streaming no deben leer todos los datos de origen antes de que
produzcan elementos. En el momento de la ejecución, un operador de streaming realiza
su operación en cada elemento de origen mientras se lee y proporciona el elemento si
es necesario. Un operador de streaming continúa leyendo los elementos de origen hasta
que se puede generar un elemento de resultado. Esto significa que es posible leer más
de un elemento de origen para generar un elemento de resultado.

No streaming

Los operadores de no streaming deben leer todos los datos de origen antes de poder
proporcionar un elemento de resultado. Las operaciones como la ordenación o la
agrupación pertenecen a esta categoría. En tiempo de ejecución, los operadores de
consulta de no streaming leen todos los datos de origen, los colocan en una estructura
de datos, realizan la operación y proporcionan los elementos resultantes.

Tabla de clasificación
En la tabla siguiente se clasifica cada método de operador de consulta estándar según
su método de ejecución.

７ Nota

Si un operador se marca en dos columnas, dos secuencias de entrada intervienen

en la operación, y cada secuencia se evalúa de manera diferente. En estos casos,
siempre es la primera secuencia de la lista de parámetros la que se evalúa en un
modo de transmisión diferido.

Operador de Tipo devuelto Ejecución Ejecución Ejecución

consulta estándar inmediata aplazada aplazada
de de no
streaming streaming

Aggregate TSource X

All Boolean X
Operador de Tipo devuelto Ejecución Ejecución Ejecución
consulta estándar inmediata aplazada aplazada
de de no
streaming streaming

Any Boolean X

AsEnumerable IEnumerable<T> X

Average Valor numérico único x

Cast IEnumerable<T> X

Concat IEnumerable<T> X

Contains Boolean X

Count Int32 X

DefaultIfEmpty IEnumerable<T> X

Distinct IEnumerable<T> X

ElementAt TSource X

ElementAtOrDefault TSource X

Empty IEnumerable<T> X

Except IEnumerable<T> X X

First TSource X

FirstOrDefault TSource X

GroupBy IEnumerable<T> X

GroupJoin IEnumerable<T> X X

Intersect IEnumerable<T> X X

Join IEnumerable<T> X X

Last TSource X

LastOrDefault TSource X

LongCount Int64 X

Max Valor numérico único, TSource o X

TResult
Operador de Tipo devuelto Ejecución Ejecución Ejecución
consulta estándar inmediata aplazada aplazada
de de no
streaming streaming

Min Valor numérico único, TSource o X

TResult

OfType IEnumerable<T> X

OrderBy IOrderedEnumerable<TElement> X

OrderByDescending IOrderedEnumerable<TElement> X

Range IEnumerable<T> X

Repeat IEnumerable<T> X

Reverse IEnumerable<T> X

Select IEnumerable<T> X

SelectMany IEnumerable<T> X

SequenceEqual Boolean X

Single TSource X

SingleOrDefault TSource X

Skip IEnumerable<T> X

SkipWhile IEnumerable<T> X

Sum Valor numérico único x

Take IEnumerable<T> X

TakeWhile IEnumerable<T> X

ThenBy IOrderedEnumerable<TElement> X

ThenByDescending IOrderedEnumerable<TElement> X

ToArray Matriz de TSource x

ToDictionary Dictionary<TKey,TValue> X

ToList IList<T> X

ToLookup ILookup<TKey,TElement> X

Union IEnumerable<T> X
Operador de Tipo devuelto Ejecución Ejecución Ejecución
consulta estándar inmediata aplazada aplazada
de de no
streaming streaming

Where IEnumerable<T> X

Consulte también
Enumerable
Información general sobre operadores de consulta estándar (C#)
Sintaxis de las expresiones de consulta para operadores de consulta estándar (C#)
LINQ to Objects (C#)
Ordenación de datos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Una operación de ordenación ordena los elementos de una secuencia según uno o
varios atributos. El primer criterio de ordenación realiza una ordenación primaria de los
elementos. Al especificar un segundo criterio de ordenación, se pueden ordenar los
elementos dentro de cada grupo de ordenación primaria.

En la ilustración siguiente se muestran los resultados de una operación de ordenación

alfabética en una secuencia de caracteres:

Los métodos de operador de consulta estándar que ordenan datos de datos se

enumeran en la sección siguiente.

Métodos
Nombre del Descripción Sintaxis de la Más información
método expresión de
consulta de C#

OrderBy Ordena valores en orderby Enumerable.OrderBy

orden ascendente.
Queryable.OrderBy

OrderByDescending Ordena valores en orderby … Enumerable.OrderByDescending

orden descendente. descending

Queryable.OrderByDescending

ThenBy Realiza una orderby …, … Enumerable.ThenBy

ordenación
secundaria en orden Queryable.ThenBy
ascendente.

ThenByDescending Realiza una orderby …, … Enumerable.ThenByDescending

ordenación descending
secundaria en orden Queryable.ThenByDescending
descendente.
 Nombre del Descripción Sintaxis de la Más información
método expresión de
consulta de C#

Reverse Invierte el orden de No es aplicable. Enumerable.Reverse

los elementos de
una colección. Queryable.Reverse

Ejemplos de sintaxis de expresiones de

consulta

Ejemplos de ordenación principal

Orden ascendente principal

En el siguiente ejemplo se muestra cómo usar la cláusula orderby en una consulta LINQ
para ordenar las cadenas de una matriz por la longitud de la cadena, en orden
ascendente.

C#

string[] words = { "the", "quick", "brown", "fox", "jumps" };

IEnumerable<string> query = from word in words

orderby word.Length

select word;

foreach (string str in query)

Console.WriteLine(str);

/* This code produces the following output:

the

fox

quick

brown

jumps

*/

Orden descendente principal

En el siguiente ejemplo se muestra cómo usar la cláusula orderby descending en una

consulta LINQ para ordenar las cadenas por su letra inicial, en orden descendente.
 C#

string[] words = { "the", "quick", "brown", "fox", "jumps" };

IEnumerable<string> query = from word in words

orderby word.Substring(0, 1) descending

select word;

foreach (string str in query)

Console.WriteLine(str);

/* This code produces the following output:

the

quick

jumps

fox

brown

*/

Ejemplos de ordenación secundaria

Orden ascendente secundario

En el siguiente ejemplo se muestra cómo usar la cláusula orderby en una consulta LINQ
para realizar una ordenación principal y secundaria de las cadenas de una matriz. Las
cadenas se ordenan primero por su longitud y, después, por la letra inicial de la cadena,
en orden ascendente.

C#

string[] words = { "the", "quick", "brown", "fox", "jumps" };

IEnumerable<string> query = from word in words

orderby word.Length, word.Substring(0, 1)

select word;

foreach (string str in query)

Console.WriteLine(str);

/* This code produces the following output:

fox

the

brown

jumps

quick

*/

Orden descendente secundario

En el siguiente ejemplo se muestra cómo usar la cláusula orderby descending en una
consulta LINQ para realizar una ordenación principal en orden ascendente y una
ordenación secundaria en orden descendente. Las cadenas se ordenan primero por su
longitud y, después, por la letra inicial de la cadena.

C#

string[] words = { "the", "quick", "brown", "fox", "jumps" };

IEnumerable<string> query = from word in words

orderby word.Length, word.Substring(0, 1)

descending

select word;

foreach (string str in query)

Console.WriteLine(str);

/* This code produces the following output:

the

fox

quick

jumps

brown

*/

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
orderby (cláusula)
Ordenar los resultados de una cláusula join
Procedimiento para ordenar o filtrar datos de texto por palabra o campo (LINQ)
(C#)
Operaciones set [C#]
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

Las operaciones set de LINQ se refieren a operaciones de consulta que generan un

conjunto de resultados en función de la presencia o ausencia de elementos equivalentes
dentro de la misma colección o en distintas colecciones (o conjuntos).

Los métodos del operador de consulta estándar que realizan operaciones set se indican
en la sección siguiente.

Métodos
Nombres Descripción Sintaxis de la Información adicional
de expresión de
método consulta de C#

Distinct o Quita valores duplicados de una No es aplicable. Enumerable.Distinct

DistinctBy colección. Enumerable.DistinctBy

Queryable.Distinct

Queryable.DistinctBy

Except o Devuelve la diferencia de conjuntos, es No es aplicable. Enumerable.Except

ExceptBy decir, los elementos de una colección Enumerable.ExceptBy

que no aparecen en una segunda Queryable.Except

colección. Queryable.ExceptBy

Intersect o Devuelve la intersección de conjuntos, No es aplicable. Enumerable.Intersect

IntersectBy es decir, los elementos que aparecen Enumerable.IntersectBy

en las dos colecciones. Queryable.Intersect

Queryable.IntersectBy

Union o Devuelve la unión de conjuntos, es No es aplicable. Enumerable.Union

UnionBy decir, los elementos únicos que Enumerable.UnionBy

aparecen en una de las dos Queryable.Union

colecciones. Queryable.UnionBy

Ejemplos
Algunos de los ejemplos siguientes se basan en un tipo record que representa los
planetas de nuestro sistema solar.

C#
 namespace SolarSystem;

record Planet(

string Name,

PlanetType Type,

int OrderFromSun)

public static readonly Planet Mercury =

new(nameof(Mercury), PlanetType.Rock, 1);

public static readonly Planet Venus =

new(nameof(Venus), PlanetType.Rock, 2);

public static readonly Planet Earth =

new(nameof(Earth), PlanetType.Rock, 3);

public static readonly Planet Mars =

new(nameof(Mars), PlanetType.Rock, 4);

public static readonly Planet Jupiter =

new(nameof(Jupiter), PlanetType.Gas, 5);

public static readonly Planet Saturn =

new(nameof(Saturn), PlanetType.Gas, 6);

public static readonly Planet Uranus =

new(nameof(Uranus), PlanetType.Liquid, 7);

public static readonly Planet Neptune =

new(nameof(Neptune), PlanetType.Liquid, 8);

// Yes, I know... not technically a planet anymore

public static readonly Planet Pluto =

new(nameof(Pluto), PlanetType.Ice, 9);

record Planet es un registro posicional, que requiere Name , Type y argumentos

OrderFromSun para crear una instancia de él. Hay varias instancias de planeta static

readonly en el tipo Planet . Se trata de definiciones de conveniencia para planetas

conocidos. El miembro Type identifica el tipo de planeta.

C#

namespace SolarSystem;

enum PlanetType

Rock,

Ice,

Gas,

 Liquid

};

Distinct y DistinctBy
En la siguiente ilustración se muestra el comportamiento del método
Enumerable.Distinct en una secuencia de cadenas. La secuencia devuelta contiene los
elementos únicos de la secuencia de entrada.

C#

string[] planets = { "Mercury", "Venus", "Venus", "Earth", "Mars", "Earth"

};

IEnumerable<string> query = from planet in planets.Distinct()

select planet;

foreach (var str in query)

Console.WriteLine(str);

/* This code produces the following output:

* Mercury

* Venus

* Earth

* Mars

*/

DistinctBy es un enfoque alternativo a Distinct , que adopta keySelector . keySelector

se usa como discriminador comparativo del tipo de origen. Considere la siguiente matriz
de planetas:

C#

Planet[] planets =

Planet.Mercury,

Planet.Venus,

Planet.Earth,

Planet.Mars,

Planet.Jupiter,

Planet.Saturn,

Planet.Uranus,

 Planet.Neptune,

Planet.Pluto

};

En el código siguiente, los planetas se discriminan en función de su PlanetType , y se

muestra el primer planeta de cada tipo:

C#

foreach (Planet planet in planets.DistinctBy(p => p.Type))

Console.WriteLine(planet);

// This code produces the following output:

// Planet { Name = Mercury, Type = Rock, OrderFromSun = 1 }

// Planet { Name = Jupiter, Type = Gas, OrderFromSun = 5 }

// Planet { Name = Uranus, Type = Liquid, OrderFromSun = 7 }

// Planet { Name = Pluto, Type = Ice, OrderFromSun = 9 }

En el código de C# anterior:

La matriz Planet se filtra de forma distinta a la primera aparición de cada tipo de

planeta único.
Las instancias planet resultantes se escriben en la consola.

Except y ExceptBy
En el ejemplo siguiente se muestra el comportamiento de Enumerable.Except. La
secuencia devuelta solo contiene los elementos de la primera secuencia de entrada que
no están en la segunda secuencia de entrada.

C#

string[] planets1 = { "Mercury", "Venus", "Earth", "Jupiter" };

string[] planets2 = { "Mercury", "Earth", "Mars", "Jupiter" };

IEnumerable<string> query = from planet in planets1.Except(planets2)

select planet;

foreach (var str in query)

 Console.WriteLine(str);

/* This code produces the following output:

* Venus

*/

El método ExceptBy es un enfoque alternativo a Except que adopta dos secuencias de

tipos posiblemente heterogéneos y keySelector . keySelector es el mismo tipo que el
segundo tipo de colecciones y se usa como discriminador comparativo del tipo de
origen. Considere las siguientes matrices de planetas:

C#

Planet[] planets =

Planet.Mercury,

Planet.Venus,

Planet.Earth,

Planet.Jupiter

};

Planet[] morePlanets =

Planet.Mercury,

Planet.Earth,

Planet.Mars,

Planet.Jupiter

};

Para buscar planetas en la primera colección que no están en la segunda colección

puede proyectar los nombres de planeta como la colección second y proporcionar el
mismo keySelector :

C#

// A shared "keySelector"

static string PlanetNameSelector(Planet planet) => planet.Name;

foreach (Planet planet in

planets.ExceptBy(

morePlanets.Select(PlanetNameSelector), PlanetNameSelector))

Console.WriteLine(planet);

// This code produces the following output:

// Planet { Name = Venus, Type = Rock, OrderFromSun = 2 }

En el código de C# anterior:

keySelector se define como una función static local, que discrimina por nombre
de planeta.
La primera matriz de planetas se filtra por planetas que no se encuentran en la
segunda matriz del planeta, en función de su nombre.
La instancia planet resultante se escribe en la consola.

Intersect y IntersectBy
En el ejemplo siguiente se muestra el comportamiento de Enumerable.Intersect. La
secuencia devuelta contiene los elementos que son comunes a las dos secuencias de
entrada.

C#

string[] planets1 = { "Mercury", "Venus", "Earth", "Jupiter" };

string[] planets2 = { "Mercury", "Earth", "Mars", "Jupiter" };

IEnumerable<string> query = from planet in planets1.Intersect(planets2)

select planet;

foreach (var str in query)

Console.WriteLine(str);

/* This code produces the following output:

* Mercury

* Earth

* Jupiter

*/

El método IntersectBy es un enfoque alternativo a Intersect que adopta dos secuencias

de tipos posiblemente heterogéneos y keySelector . keySelector se usa como
discriminador comparativo del tipo de la segunda colección. Considere las siguientes
matrices de planetas:

C#
 Planet[] firstFivePlanetsFromTheSun =

Planet.Mercury,

Planet.Venus,

Planet.Earth,

Planet.Mars,

Planet.Jupiter

};

Planet[] lastFivePlanetsFromTheSun =

Planet.Mars,

Planet.Jupiter,

Planet.Saturn,

Planet.Uranus,

Planet.Neptune

};

Hay dos matrices de planetas, una representa los cinco primeros planetas desde el sol y
la segunda representa los últimos cinco planetas desde sol. Dado que el tipo Planet es
un tipo posicional record , se puede utilizar su semántica de comparación de valores en
la forma del keySelector :

C#

foreach (Planet planet in

firstFivePlanetsFromTheSun.IntersectBy(

lastFivePlanetsFromTheSun, planet => planet))

Console.WriteLine(planet);

// This code produces the following output:

// Planet { Name = Mars, Type = Rock, OrderFromSun = 4 }

// Planet { Name = Jupiter, Type = Gas, OrderFromSun = 5 }

En el código de C# anterior:

Las dos matrices Planet se cruzan por su semántica de comparación de valores.

Solo los planetas que se encuentran en ambas matrices están presentes en la
secuencia resultante.
Las instancias planet resultantes se escriben en la consola.

Union y UnionBy
En el siguiente ejemplo se muestra una operación de unión en dos secuencias de
cadenas. La secuencia devuelta contiene los elementos únicos de las dos secuencias de
entrada.

C#

string[] planets1 = { "Mercury", "Venus", "Earth", "Jupiter" };

string[] planets2 = { "Mercury", "Earth", "Mars", "Jupiter" };

IEnumerable<string> query = from planet in planets1.Union(planets2)

select planet;

foreach (var str in query)

Console.WriteLine(str);

/* This code produces the following output:

* Mercury

* Venus

* Earth

* Jupiter

* Mars

*/

UnionBy es un enfoque alternativo a Union que adopta dos secuencias del mismo tipo y
keySelector . keySelector se usa como discriminador comparativo del tipo de origen.
Considere las siguientes matrices de planetas:

C#

Planet[] firstFivePlanetsFromTheSun =

Planet.Mercury,

Planet.Venus,

Planet.Earth,

Planet.Mars,

Planet.Jupiter

};

Planet[] lastFivePlanetsFromTheSun =

Planet.Mars,

Planet.Jupiter,

 Planet.Saturn,

Planet.Uranus,

Planet.Neptune

};

Para la unión de estas dos colecciones en una sola secuencia, proporcione keySelector :

C#

foreach (Planet planet in

firstFivePlanetsFromTheSun.UnionBy(

lastFivePlanetsFromTheSun, planet => planet))

Console.WriteLine(planet);

// This code produces the following output:

// Planet { Name = Mercury, Type = Rock, OrderFromSun = 1 }

// Planet { Name = Venus, Type = Rock, OrderFromSun = 2 }

// Planet { Name = Earth, Type = Rock, OrderFromSun = 3 }

// Planet { Name = Mars, Type = Rock, OrderFromSun = 4 }

// Planet { Name = Jupiter, Type = Gas, OrderFromSun = 5 }

// Planet { Name = Saturn, Type = Gas, OrderFromSun = 6 }

// Planet { Name = Uranus, Type = Liquid, OrderFromSun = 7 }

// Planet { Name = Neptune, Type = Liquid, OrderFromSun = 8 }

En el código de C# anterior:

Las dos matrices Planet se entrelazan mediante su semántica de comparación de

valores record .
Las instancias planet resultantes se escriben en la consola.

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Procedimiento para combinar y comparar colecciones de cadenas (LINQ) (C#)
Procedimiento para buscar la diferencia de conjuntos entre dos listas (LINQ) (C#)
Filtrado de datos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El filtrado hace referencia a la operación de restringir el conjunto de resultados, de

manera que solo contenga los elementos que cumplen una condición especificada.
También se conoce como selección.

En la ilustración siguiente se muestran los resultados de filtrar una secuencia de

caracteres. El predicado de la operación de filtrado especifica que el carácter debe ser
"A".

Los métodos del operador de consulta estándar que realizan selecciones se indican en la
sección siguiente.

Métodos
Nombre Descripción Sintaxis de la Más información
del expresión de
método consulta de C#

OfType Selecciona valores en función de su No es aplicable. Enumerable.OfType

capacidad para convertirse en un tipo

especificado. Queryable.OfType

Where Selecciona valores basados en una where Enumerable.Where

función de predicado.
Queryable.Where

Ejemplo de sintaxis de expresiones de consulta

En el siguiente ejemplo se usa la cláusula where para filtrar de una matriz aquellas
cadenas que tienen una longitud específica.

C#
 string[] words = { "the", "quick", "brown", "fox", "jumps" };

IEnumerable<string> query = from word in words

where word.Length == 3

select word;

foreach (string str in query)

Console.WriteLine(str);

/* This code produces the following output:

the

fox

*/

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
where (cláusula)
Especificación de filtros con predicado de forma dinámica en tiempo de ejecución
Procedimiento para consultar los metadatos de un ensamblado con reflexión
(LINQ) (C#)
Procedimiento para buscar archivos con un nombre o atributo especificados (C#)
Procedimiento para ordenar o filtrar datos de texto por palabra o campo (LINQ)
(C#)
Operaciones cuantificadoras en LINQ
(C#)
Artículo • 10/02/2023 • Tiempo de lectura: 3 minutos

Las operaciones cuantificadoras devuelven un valor Boolean que indica si algunos o

todos los elementos de una secuencia cumplen una condición.

En la siguiente ilustración se muestran dos operaciones cuantificadoras diferentes en

dos secuencias de origen distintas. La primera operación pregunta si alguno de los
elementos es el carácter "A". La segunda operación pregunta si todos los elementos son
el carácter "A". Ambos métodos devuelven true en este ejemplo.

Los métodos del operador de consulta estándar que realizan operaciones

cuantificadoras se indican en la sección siguiente.

Métodos
Nombre Descripción Sintaxis de la Más información
del expresión de
método consulta de C#

Todas Determina si todos los elementos de No es aplicable. Enumerable.All

una secuencia cumplen una Queryable.All

condición.

Cualquiera Determina si algunos de los No es aplicable. Enumerable.Any

elementos de una secuencia Queryable.Any
cumplen una condición.

Contiene Determina si una secuencia contiene No es aplicable. Enumerable.Contains

un elemento especificado. Queryable.Contains

Ejemplos de sintaxis de expresiones de
consulta

Todas
En el ejemplo siguiente se usa All para comprobar que todas las cadenas tienen una
longitud específica.

C#

class Market

public string Name { get; set; }

public string[] Items { get; set; }

public static void Example()

List<Market> markets = new List<Market>

new Market { Name = "Emily's", Items = new string[] { "kiwi",

"cheery", "banana" } },

new Market { Name = "Kim's", Items = new string[] { "melon",

"mango", "olive" } },

new Market { Name = "Adam's", Items = new string[] { "kiwi",

"apple", "orange" } },

};

// Determine which market have all fruit names length equal to 5

IEnumerable<string> names = from market in markets

where market.Items.All(item => item.Length

== 5)

select market.Name;

foreach (string name in names)

Console.WriteLine($"{name} market");

// This code produces the following output:

//

// Kim's market

Cualquiera
En el ejemplo siguiente se usa Any para comprobar que las cadenas se inician con "o".
 C#

class Market

public string Name { get; set; }

public string[] Items { get; set; }

public static void Example()

List<Market> markets = new List<Market>

new Market { Name = "Emily's", Items = new string[] { "kiwi",

"cheery", "banana" } },

new Market { Name = "Kim's", Items = new string[] { "melon",

"mango", "olive" } },

new Market { Name = "Adam's", Items = new string[] { "kiwi",

"apple", "orange" } },

};

// Determine which market have any fruit names start with 'o'

IEnumerable<string> names = from market in markets

where market.Items.Any(item =>

item.StartsWith("o"))

select market.Name;

foreach (string name in names)

Console.WriteLine($"{name} market");

// This code produces the following output:

//

// Kim's market

// Adam's market

Contiene
En el ejemplo siguiente se usa Contains para comprobar que una matriz tenga un
elemento específico.

C#

class Market

public string Name { get; set; }

public string[] Items { get; set; }

public static void Example()

List<Market> markets = new List<Market>

new Market { Name = "Emily's", Items = new string[] { "kiwi",

"cheery", "banana" } },

new Market { Name = "Kim's", Items = new string[] { "melon",

"mango", "olive" } },

new Market { Name = "Adam's", Items = new string[] { "kiwi",

"apple", "orange" } },

};

// Determine which market contains fruit names equal 'kiwi'

IEnumerable<string> names = from market in markets

where market.Items.Contains("kiwi")

select market.Name;

foreach (string name in names)

Console.WriteLine($"{name} market");

// This code produces the following output:

//

// Emily's market

// Adam's market

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Especificación de filtros con predicado de forma dinámica en tiempo de ejecución
Procedimiento para buscar frases que contengan un conjunto especificado de
palabras (LINQ) (C#)
Operaciones de proyección (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

El término "proyección" hace referencia a la operación de transformar un objeto en una

nueva forma que, a menudo, consta solo de aquellas propiedades que se usarán
posteriormente. Utilizando la proyección, puede construir un tipo nuevo creado a partir
de cada objeto. Se puede proyectar una propiedad y realizar una función matemática en
ella. También puede proyectar el objeto original sin cambiarlo.

Los métodos del operador de consulta estándar que realizan proyecciones se indican en
la sección siguiente.

Métodos
Nombres Descripción Sintaxis de la Información adicional
de método expresión de
consulta de
C#

Seleccionar Proyecta valores basados en una select Enumerable.Select

función de transformación. Queryable.Select

SelectMany Proyecta secuencias de valores que se Use varias Enumerable.SelectMany

basan en una función de cláusulas from Queryable.SelectMany

transformación y después los convierte
en una secuencia.

Zip Genera una secuencia de tuplas con No aplicable. Enumerable.Zip

elementos a partir de dos o tres Queryable.Zip

secuencias especificadas.

Select
En el ejemplo siguiente se usa la cláusula select para proyectar la primera letra de cada
cadena de una lista de cadenas.

C#

List<string> words = new() { "an", "apple", "a", "day" };

var query = from word in words

select word.Substring(0, 1);

foreach (string s in query)

 Console.WriteLine(s);

/* This code produces the following output:

*/

SelectMany
En el ejemplo siguiente se usan varias cláusulas from para proyectar cada palabra de
todas las cadenas de una lista de cadenas.

C#

List<string> phrases = new() { "an apple a day", "the quick brown fox" };

var query = from phrase in phrases

from word in phrase.Split(' ')

select word;

foreach (string s in query)

Console.WriteLine(s);

/* This code produces the following output:

an

apple

day

the

quick

brown

fox

*/

Zip
Hay varias sobrecargas para el operador Zip de proyección. Todos los métodos Zip
funcionan en secuencias de dos o más tipos posiblemente heterogéneos. Las dos
primeras sobrecargas devuelven tuplas, con el tipo posicional correspondiente de las
secuencias dadas.

Observe las siguientes colecciones:

 C#

// An int array with 7 elements.

IEnumerable<int> numbers = new[]

1, 2, 3, 4, 5, 6, 7

};

// A char array with 6 elements.

IEnumerable<char> letters = new[]

'A', 'B', 'C', 'D', 'E', 'F'

};

Para proyectar estas secuencias juntas, use el operador Enumerable.Zip<TFirst,TSecond>

(IEnumerable<TFirst>, IEnumerable<TSecond>):

C#

foreach ((int number, char letter) in numbers.Zip(letters))

Console.WriteLine($"Number: {number} zipped with letter: '{letter}'");

// This code produces the following output:

// Number: 1 zipped with letter: 'A'

// Number: 2 zipped with letter: 'B'

// Number: 3 zipped with letter: 'C'

// Number: 4 zipped with letter: 'D'

// Number: 5 zipped with letter: 'E'

// Number: 6 zipped with letter: 'F'

） Importante

La secuencia resultante de una operación zip nunca tiene más longitud que la
secuencia más corta. Las colecciones numbers y letters difieren en longitud, y la
secuencia resultante omite el último elemento de la colección numbers , ya que no
tiene nada con que comprimir.

La segunda sobrecarga acepta una secuencia third . Vamos a crear otra colección,
concretamente emoji :

C#

// A string array with 8 elements.

IEnumerable<string> emoji = new[]

"🤓", "🔥", "🎉", "👀", "⭐", "💜", "✔", "💯"

};

Para proyectar estas secuencias juntas, use el operador

Enumerable.Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>,
IEnumerable<TThird>):

C#

foreach ((int number, char letter, string em) in numbers.Zip(letters,

emoji))

Console.WriteLine(

$"Number: {number} is zipped with letter: '{letter}' and emoji:

{em}");

// This code produces the following output:

// Number: 1 is zipped with letter: 'A' and emoji: 🤓

// Number: 2 is zipped with letter: 'B' and emoji: 🔥

// Number: 3 is zipped with letter: 'C' and emoji: 🎉

// Number: 4 is zipped with letter: 'D' and emoji: 👀

// Number: 5 is zipped with letter: 'E' and emoji: ⭐

// Number: 6 is zipped with letter: 'F' and emoji: 💜

Al igual que la sobrecarga anterior, el método Zip proyecta una tupla, pero esta vez con
tres elementos.

La tercera sobrecarga acepta un argumento Func<TFirst, TSecond, TResult> que actúa

como selector de resultados. Dados los dos tipos de las secuencias que se comprimen,
puede proyectar una nueva secuencia resultante.

C#

foreach (string result in

numbers.Zip(letters, (number, letter) => $"{number} = {letter}

({(int)letter})"))

Console.WriteLine(result);

// This code produces the following output:

// 1 = A (65)

// 2 = B (66)

// 3 = C (67)

// 4 = D (68)

// 5 = E (69)

// 6 = F (70)

Con la sobrecarga Zip anterior, la función especificada se aplica a los elementos

correspondientes numbers y letter , lo que genera una secuencia de los resultados
string .
Diferencias entre Select y SelectMany
La función tanto de Select como de SelectMany consiste en generar un valor (o valores)
de resultado a partir de valores de origen. Select genera un valor de resultado para
cada valor de origen. El resultado global, por tanto, es una colección que tiene el mismo
número de elementos que la colección de origen. En cambio, SelectMany genera un
resultado global único que contiene subcolecciones concatenadas procedentes de cada
valor de origen. La función de transformación que se pasa como argumento a
SelectMany debe devolver una secuencia enumerable de valores para cada valor de

origen. Luego, SelectMany concatena estas secuencias enumerables para crear una
secuencia de gran tamaño.

Las dos ilustraciones siguientes muestran la diferencia conceptual entre las acciones de
estos dos métodos. En cada caso, se supone que la función de selector (transformación)
selecciona la matriz de flores de cada valor de origen.

En esta ilustración se muestra cómo Select devuelve una colección que tiene el mismo
número de elementos que la colección de origen.

En esta ilustración se muestra cómo SelectMany concatena la secuencia intermedia de

matrices en un valor de resultado final que contiene cada uno de los valores de todas
las matrices intermedias.
Ejemplo de código
En el ejemplo siguiente se compara el comportamiento de Select y SelectMany . El
código crea un "ramo" de flores tomando los elementos de cada lista de nombres de
flores de la colección de origen. En este ejemplo, el "valor único" que la función de
transformación Select<TSource,TResult>(IEnumerable<TSource>,
Func<TSource,TResult>) usa es una colección de valores. Para ello, se requiere el bucle
adicional foreach a fin de enumerar cada una de las cadenas de cada subsecuencia.

C#

class Bouquet

public List<string> Flowers { get; set; }

static void SelectVsSelectMany()

List<Bouquet> bouquets = new()

new Bouquet { Flowers = new List<string> { "sunflower", "daisy",

"daffodil", "larkspur" }},

new Bouquet { Flowers = new List<string> { "tulip", "rose", "orchid"

}},

new Bouquet { Flowers = new List<string> { "gladiolis", "lily",

"snapdragon", "aster", "protea" }},

new Bouquet { Flowers = new List<string> { "larkspur", "lilac",

"iris", "dahlia" }}

};

IEnumerable<List<string>> query1 = bouquets.Select(bq => bq.Flowers);

IEnumerable<string> query2 = bouquets.SelectMany(bq => bq.Flowers);

 Console.WriteLine("Results by using Select():");

// Note the extra foreach loop here.

foreach (IEnumerable<String> collection in query1)

foreach (string item in collection)

Console.WriteLine(item);

Console.WriteLine("\nResults by using SelectMany():");

foreach (string item in query2)

Console.WriteLine(item);

/* This code produces the following output:

Results by using Select():

sunflower

daisy

daffodil

larkspur

tulip

rose

orchid

gladiolis

lily

snapdragon

aster

protea

larkspur

lilac

iris

dahlia

Results by using SelectMany():

sunflower

daisy

daffodil

larkspur

tulip

rose

orchid

gladiolis

lily

snapdragon

aster

protea

larkspur

lilac

iris

dahlia

*/

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
select (cláusula)
Procedimiento para rellenar colecciones de objetos de varios orígenes (LINQ) (C#)
Procedimiento para dividir un archivo en varios mediante el uso de grupos (LINQ)
(C#)
Realizar particiones de datos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Partición en LINQ es la operación de dividir una secuencia de entrada en dos secciones,

sin reorganizar los elementos, y devolver después una de las secciones.

En la siguiente ilustración se muestran los resultados de tres operaciones de partición

diferentes en una secuencia de caracteres. La primera operación devuelve los tres
primeros elementos de la secuencia. La segunda operación omite los tres primeros
elementos y devuelve los restantes. La tercera operación omite los dos primeros
elementos de la secuencia y devuelve los tres siguientes.

Los métodos de operador de consulta estándar que realizan particiones de las

secuencias se enumeran en la sección siguiente.

Operadores
Nombres Descripción Sintaxis de la Información
de expresión de adicional
método consulta de C#

Skip Omite los elementos hasta una No es aplicable. Enumerable.Skip

determinada posición de una Queryable.Skip

secuencia.

SkipWhile Omite los elementos según una No es aplicable. Enumerable.SkipWhile

función de predicado hasta que un Queryable.SkipWhile

elemento no satisface la condición.

Take Admite los elementos hasta una No es aplicable. Enumerable.Take

determinada posición de una Queryable.Take

secuencia.
 Nombres Descripción Sintaxis de la Información
de expresión de adicional
método consulta de C#

TakeWhile Admite los elementos según una No es aplicable. Enumerable.TakeWhile

función de predicado hasta que un Queryable.TakeWhile

elemento no satisface la condición.

Fragmento Divide los elementos de una secuencia No aplicable. Enumerable.Chunk

en fragmentos de un tamaño máximo Queryable.Chunk

especificado.

Ejemplo
El operador Chunk se usa para dividir los elementos de una secuencia en función de un
valor size determinado.

C#

int chunkNumber = 1;

foreach (int[] chunk in Enumerable.Range(0, 8).Chunk(3))

Console.WriteLine($"Chunk {chunkNumber++}:");

foreach (int item in chunk)

Console.WriteLine($" {item}");

Console.WriteLine();

// This code produces the following output:

// Chunk 1:

// 0

// 1

// 2

//

//Chunk 2:

// 3

// 4

// 5

//

//Chunk 3:

// 6

// 7

El código de C# anterior:

Se basa en Enumerable.Range(Int32, Int32) para generar una secuencia de

números.
 Aplica el operador Chunk y divide la secuencia en fragmentos con un tamaño
máximo de tres.

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Operaciones Join (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Una combinación de dos orígenes de datos es la asociación de objetos de un origen de

datos con los objetos que comparten un atributo común en otro origen de datos.

La combinación Join es una operación importante en las consultas destinadas a orígenes

de datos cuyas relaciones entre sí no se pueden seguir directamente. En la
programación orientada a objetos, esto podría significar una correlación entre objetos
que no está modelada, como el sentido contrario de una relación unidireccional. Un
ejemplo de una relación unidireccional es una clase Cliente que tiene una propiedad de
tipo Ciudad, pero la clase Ciudad no tiene una propiedad que sea una colección de
objetos Cliente. Si tiene una lista de objetos Ciudad y quiere encontrar todos los clientes
en cada ciudad, podría usar una operación de combinación para encontrarlos.

Los métodos de combinación que se han proporcionado en el marco de LINQ son Join y
GroupJoin. Estos métodos efectúan combinaciones de igualdad, o combinaciones que
hacen corresponder dos orígenes de datos en función de la igualdad de sus claves. (Para
comparar, Transact-SQL admite otros operadores de combinación aparte de 'igual', por
ejemplo, 'menor que'). En términos de base de datos relacional, Join implementa una
combinación interna, un tipo de combinación en la que solo se devuelven los objetos
que tienen una correspondencia en el otro conjunto de datos. El método GroupJoin no
tiene equivalente directo en términos de bases de datos relacionales; pero implementa
un superconjunto de combinaciones internas y combinaciones externas izquierdas. Una
combinación externa izquierda es una combinación que devuelve cada elemento del
primer origen de datos (izquierda), aunque no tenga elementos correlacionados en el
otro origen de datos.

En la ilustración siguiente se muestra una vista conceptual de dos conjuntos y los

elementos de esos conjuntos que se incluyen en una combinación interna o en una
combinación externa izquierda.
Métodos
Nombre Descripción Sintaxis de la Más información
del expresión de
método consulta de
C#

Join Combina mediante Join dos secuencias join … in … Enumerable.Join

según las funciones de selector de claves on … equals …

y extrae pares de valores. Queryable.Join

GroupJoin Combina mediante Join dos secuencias join … in … Enumerable.GroupJoin

según las funciones de selector de claves on … equals …

y agrupa los resultados coincidentes para into … Queryable.GroupJoin
cada elemento.

Ejemplos de sintaxis de expresiones de

consulta

Join
En el ejemplo siguiente se usa la cláusula join … in … on … equals … para combinar dos
secuencias en función de un valor específico:

C#

class Product

public string Name { get; set; }

public int CategoryId { get; set; }

class Category

public int Id { get; set; }

public string CategoryName { get; set; }

public static void Example()

List<Product> products = new List<Product>

new Product { Name = "Cola", CategoryId = 0 },

new Product { Name = "Tea", CategoryId = 0 },

new Product { Name = "Apple", CategoryId = 1 },

new Product { Name = "Kiwi", CategoryId = 1 },

new Product { Name = "Carrot", CategoryId = 2 },

 };

List<Category> categories = new List<Category>

new Category { Id = 0, CategoryName = "Beverage" },

new Category { Id = 1, CategoryName = "Fruit" },

new Category { Id = 2, CategoryName = "Vegetable" }

};

// Join products and categories based on CategoryId

var query = from product in products

join category in categories on product.CategoryId equals

category.Id

select new { product.Name, category.CategoryName };

foreach (var item in query)

Console.WriteLine($"{item.Name} - {item.CategoryName}");

// This code produces the following output:

//

// Cola - Beverage

// Tea - Beverage

// Apple - Fruit

// Kiwi - Fruit

// Carrot - Vegetable

GroupJoin
En el ejemplo siguiente se usa la cláusula join … in … on … equals … into … para
combinar dos secuencias en función de un valor específico y se agrupan las
coincidencias resultantes de cada elemento:

C#

class Product

public string Name { get; set; }

public int CategoryId { get; set; }

class Category

public int Id { get; set; }

public string CategoryName { get; set; }

public static void Example()

 List<Product> products = new List<Product>

new Product { Name = "Cola", CategoryId = 0 },

new Product { Name = "Tea", CategoryId = 0 },

new Product { Name = "Apple", CategoryId = 1 },

new Product { Name = "Kiwi", CategoryId = 1 },

new Product { Name = "Carrot", CategoryId = 2 },

};

List<Category> categories = new List<Category>

new Category { Id = 0, CategoryName = "Beverage" },

new Category { Id = 1, CategoryName = "Fruit" },

new Category { Id = 2, CategoryName = "Vegetable" }

};

// Join categories and product based on CategoryId and grouping result

var productGroups = from category in categories

join product in products on category.Id equals

product.CategoryId into productGroup

select productGroup;

foreach (IEnumerable<Product> productGroup in productGroups)

Console.WriteLine("Group");

foreach (Product product in productGroup)

Console.WriteLine($"{product.Name,8}");

// This code produces the following output:

//

// Group

// Cola

// Tea

// Group

// Apple

// Kiwi

// Group

// Carrot

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Tipos anónimos
Formular combinaciones Join y consultas entre productos
join (cláusula)
Join usando claves compuestas
Procedimiento para combinar contenido de archivos no similares (LINQ) (C#)
Ordenar los resultados de una cláusula join
Realizar operaciones de combinación personalizadas
Realizar combinaciones agrupadas
Realizar combinaciones internas
Realizar operaciones de combinación externa izquierda
Procedimiento para rellenar colecciones de objetos de varios orígenes (LINQ) (C#)
Agrupar datos (C#)
Artículo • 29/11/2022 • Tiempo de lectura: 2 minutos

El agrupamiento hace referencia a la operación de colocar los datos en grupos de

manera que los elementos de cada grupo compartan un atributo común.

La ilustración siguiente muestra los resultados de agrupar una secuencia de caracteres.

La clave de cada grupo es el carácter.

Los métodos de operador de consulta estándar que agrupan elementos de datos se

enumeran en la sección siguiente.

Métodos
Nombre Descripción Sintaxis de la Más información
del expresión de
método consulta de
C#

GroupBy Agrupa los elementos que comparten un group … by

Enumerable.GroupBy

atributo común. Cada grupo se representa

mediante un objeto o bien
Queryable.GroupBy
IGrouping<TKey,TElement>.
group … by …
into …

ToLookup Inserta elementos a una No es Enumerable.ToLookup

Lookup<TKey,TElement> (un diccionario aplicable.
uno a varios) basándose en una función de
selector de claves.

Ejemplo de sintaxis de expresiones de consulta

El ejemplo de código siguiente usa la cláusula group by para agrupar los enteros de una
lista según sean pares o impares.

C#

List<int> numbers = new List<int>() { 35, 44, 200, 84, 3987, 4, 199, 329,
446, 208 };

IEnumerable<IGrouping<int, int>> query = from number in numbers

group number by number % 2;

foreach (var group in query)

Console.WriteLine(group.Key == 0 ? "\nEven numbers:" : "\nOdd

numbers:");

foreach (int i in group)

Console.WriteLine(i);

/* This code produces the following output:

Odd numbers:

35

3987

199

329

Even numbers:

44

200

84

446

208

*/

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
group (cláusula)
Crear grupos anidados
Procedimiento para agrupar archivos por extensión (LINQ) (C#)
Agrupar los resultados de consultas
Realizar una subconsulta en una operación de agrupación
Procedimiento para dividir un archivo en varios mediante el uso de grupos (LINQ)
(C#)
Operaciones de generación (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La generación hace referencia a la creación de una nueva secuencia de valores.

Los métodos del operador de consulta estándar que realizan generaciones se indican en
la sección siguiente.

Métodos
Nombre del Descripción Sintaxis de la Más información
método expresión de
consulta de C#

DefaultIfEmpty Reemplaza una colección vacía No es aplicable. Enumerable.DefaultIfEmpty

con una colección de singleton

con valores predeterminados. Queryable.DefaultIfEmpty

Empty Devuelve una colección vacía. No es aplicable. Enumerable.Empty

Intervalo Genera una colección que No es aplicable. Enumerable.Range

contiene una secuencia de
números.

Repeat Genera una colección que No es aplicable. Enumerable.Repeat

contiene un valor repetido.

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Operaciones de igualdad (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Dos secuencias cuyos respectivos elementos sean iguales y que tengan el mismo
número de elementos se consideran iguales.

Métodos
Nombre del Descripción Sintaxis de la Más información
método expresión de
consulta de C#

SequenceEqual Determina si dos secuencias No es aplicable. Enumerable.SequenceEqual

son iguales al comparar

elementos par a par. Queryable.SequenceEqual

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Procedimiento para comparar el contenido de dos carpetas (LINQ) (C#)
Operaciones de elementos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las operaciones de elementos devuelven un único elemento específico de una

secuencia.

Los métodos del operador de consulta estándar que realizan operaciones de elementos
se indican en la sección siguiente.

Métodos
Nombre del Descripción Sintaxis Información adicional
método de la
expresión
de
consulta
de C#

ElementAt Devuelve el elemento No es Enumerable.ElementAt

situado en un índice aplicable. Queryable.ElementAt

especificado de la
colección.

ElementAtOrDefault Devuelve el elemento No es Enumerable.ElementAtOrDefault

situado en un índice aplicable. Queryable.ElementAtOrDefault
especificado de una
colección o un valor
predeterminado si el
índice está fuera del
intervalo.

First Devuelve el primer No es Enumerable.First

elemento de una aplicable. Queryable.First

colección, o el primer
elemento que cumple una
condición.

FirstOrDefault Devuelve el primer No es Enumerable.FirstOrDefault

elemento de una aplicable. Queryable.FirstOrDefault

colección, o el primer Queryable.FirstOrDefault<TSource>

elemento que cumple una (IQueryable<TSource>)
condición. Devuelve un
valor predeterminado si
dicho elemento no existe.
Nombre del Descripción Sintaxis Información adicional
método de la
expresión
de
consulta
de C#

Último Devuelve el último No es Enumerable.Last

elemento de una aplicable. Queryable.Last

colección, o el último
elemento que cumple una
condición.

LastOrDefault Devuelve el último No es Enumerable.LastOrDefault

elemento de una aplicable. Queryable.LastOrDefault

colección, o el último
elemento que cumple una
condición. Devuelve un
valor predeterminado si
dicho elemento no existe.

Single Devuelve el único No es Enumerable.Single

elemento de una aplicable. Queryable.Single

colección, o el único
elemento que cumple una
condición. Se produce un
InvalidOperationException
si no hay ningún
elemento o hay más de
un elemento para
devolver.

SingleOrDefault Devuelve el único No es Enumerable.SingleOrDefault

elemento de una aplicable. Queryable.SingleOrDefault

colección, o el único
elemento que cumple una
condición. Devuelve un
valor predeterminado si
no hay ningún elemento
para devolver. Se produce
un
InvalidOperationException
si hay más de un
elemento para devolver.

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Procedimiento para buscar el archivo o archivos de mayor tamaño en un árbol de
directorios (LINQ) (C#)
Convertir tipos de datos (C#)
Artículo • 22/09/2022 • Tiempo de lectura: 2 minutos

Los métodos de conversión cambian el tipo de los objetos de entrada.

Las operaciones de conversión en las consultas LINQ son útiles en una serie de
aplicaciones. A continuación se muestran algunos ejemplos:

El método Enumerable.AsEnumerable puede usarse para ocultar una

implementación personalizada de tipo de un operador de consulta estándar.

El método Enumerable.OfType puede usarse para permitir colecciones no

parametrizadas para las consultas LINQ.

Los métodos Enumerable.ToArray, Enumerable.ToDictionary, Enumerable.ToList y

Enumerable.ToLookup pueden usarse para aplicar la ejecución de consultas
inmediata en lugar de aplazarla hasta que se enumere la consulta.

Métodos
En la siguiente tabla se muestran los métodos de operadores de consulta estándar que
efectúan conversiones de tipo de datos.

Los métodos de conversión de esta tabla cuyos nombres comienzan por "As" cambian el
tipo estático de la colección de origen, pero no lo enumeran. Los métodos cuyos
nombres empiezan por "To" enumeran la colección de origen y colocan los elementos
en el tipo de colección correspondiente.

Nombre del Descripción Sintaxis de Más información

método la expresión
de consulta
de C#

AsEnumerable Devuelve la entrada con tipo como No es Enumerable.AsEnumerable

IEnumerable<T>. aplicable.

AsQueryable Convierte un IEnumerable No es Queryable.AsQueryable

(genérico) en un IQueryable aplicable.
(genérico).
 Nombre del Descripción Sintaxis de Más información
método la expresión
de consulta
de C#

Conversión de Convierte los elementos de una Use una Enumerable.Cast

tipos explícita colección en un tipo especificado. variable de

rango con Queryable.Cast
tipo
explícito. Por
ejemplo:

from string
str in
words

OfType Filtra valores en función de su No es Enumerable.OfType

capacidad para convertirse en un aplicable.

tipo especificado. Queryable.OfType

ToArray Convierte una colección en una No es Enumerable.ToArray

matriz. Este método fuerza la aplicable.
ejecución de la consulta.

ToDictionary Coloca elementos en No es Enumerable.ToDictionary

Dictionary<TKey,TValue> aplicable.
basándose en una función de
selector de claves. Este método
fuerza la ejecución de la consulta.

ToList Convierte una colección en List<T>. No es Enumerable.ToList

Este método fuerza la ejecución de aplicable.
la consulta.

ToLookup Coloca elementos en una No es Enumerable.ToLookup

Lookup<TKey,TElement> (un aplicable.
diccionario uno a varios) basándose
en una función de selector de
claves. Este método fuerza la
ejecución de la consulta.

Ejemplo de sintaxis de expresiones de consulta

En el ejemplo de código siguiente se usa una variable de rango con tipo explícito para
convertir un tipo en un subtipo antes de obtener acceso a un miembro que solo está
disponible en el subtipo.

C#
 class Plant

public string Name { get; set; }

class CarnivorousPlant : Plant

public string TrapType { get; set; }

static void Cast()

Plant[] plants = new Plant[] {

new CarnivorousPlant { Name = "Venus Fly Trap", TrapType = "Snap

Trap" },

new CarnivorousPlant { Name = "Pitcher Plant", TrapType = "Pitfall

Trap" },

new CarnivorousPlant { Name = "Sundew", TrapType = "Flypaper Trap"

},

new CarnivorousPlant { Name = "Waterwheel Plant", TrapType = "Snap

Trap" }

};

var query = from CarnivorousPlant cPlant in plants

where cPlant.TrapType == "Snap Trap"

select cPlant;

foreach (Plant plant in query)

Console.WriteLine(plant.Name);

/* This code produces the following output:

Venus Fly Trap

Waterwheel Plant

*/

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
from (cláusula)
Expresiones de consulta LINQ
Procedimiento para consultar un objeto ArrayList con LINQ (C#)
Operaciones de concatenación (C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

La concatenación hace referencia a la operación de anexar una secuencia a otra.

En la siguiente ilustración se muestra una operación de concatenación en dos

secuencias de caracteres.

Los métodos del operador de consulta estándar que efectúan una concatenación se
indican en la siguiente sección.

Métodos
Nombre del Descripción Sintaxis de la expresión Más información
método de consulta de C#

Concat Concatena dos secuencias para No es aplicable. Enumerable.Concat

formar una secuencia.

Queryable.Concat

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Procedimiento para combinar y comparar colecciones de cadenas (LINQ) (C#)
Operaciones de agregación (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Una operación de agregación calcula un valor único a partir de una colección de valores.
Un ejemplo de operación de agregación es calcular el promedio de temperatura diaria a
partir de los valores de temperatura diaria durante un mes.

En la siguiente ilustración se muestran los resultados de dos operaciones de agregación

diferentes en una secuencia de números. La primera operación suma los números. La
segunda operación devuelve el valor máximo de la secuencia.

Los métodos del operador de consulta estándar que realizan operaciones de agregación
se indican en la sección siguiente.

Métodos
Nombre description Sintaxis de la Información adicional
del expresión de
método consulta de C#

Agregar Realiza una operación de agregación No es aplicable. Enumerable.Aggregate

personalizada en los valores de una Queryable.Aggregate

colección.

Average Calcula el valor medio de una colección No es aplicable. Enumerable.Average

de valores. Queryable.Average

Recuento Cuenta los elementos de una No es aplicable. Enumerable.Count

colección; opcionalmente, solo Queryable.Count

aquellos que satisfacen una función de
predicado.

LongCount Cuenta los elementos de una gran No es aplicable. Enumerable.LongCount

colección; opcionalmente, solo Queryable.LongCount

aquellos que satisfacen una función de
predicado.
Nombre description Sintaxis de la Información adicional
del expresión de
método consulta de C#

Max o Determina el valor máximo de una No es aplicable. Enumerable.Max

MaxBy colección. Enumerable.MaxBy

Queryable.Max

Queryable.MaxBy

Min o Determina el valor mínimo de una No es aplicable. Enumerable.Min

MinBy colección. Enumerable.MinBy

Queryable.Min

Queryable.MinBy

Sum Calcula la suma de los valores de una No es aplicable. Enumerable.Sum

colección. Queryable.Sum

Consulte también
System.Linq
Información general sobre operadores de consulta estándar (C#)
Procedimiento para calcular valores de columna en un archivo de texto CSV (LINQ)
(C#)
Procedimiento para buscar el archivo o archivos de mayor tamaño en un árbol de
directorios (LINQ) (C#)
Procedimiento para buscar el número total de bytes de un conjunto de carpetas
(LINQ) (C#)
LINQ to Objects (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El término "LINQ to Objects" se refiere al uso de consultas LINQ con cualquier colección
IEnumerable o IEnumerable<T> directamente, sin usar un proveedor o una API de LINQ
intermedios como LINQ to SQL o LINQ to XML. Puede usar LINQ para consultar
cualquier colección enumerable, como List<T>, Array o Dictionary<TKey,TValue>. La
colección puede haberla definido el usuario, o bien puede que la haya devuelto una API
de .NET.

Básicamente, LINQ to Objects representa un nuevo enfoque para las colecciones. En el

sistema antiguo, tenía que escribir complejos bucles foreach que especificaban cómo
recuperar los datos de una colección. En el enfoque de LINQ, se escribe código
declarativo que describe qué se quiere recuperar.

Además, las consultas LINQ ofrecen tres ventajas principales respecto a los bucles
foreach tradicionales:

Son más concisas y legibles, especialmente cuando se filtran varias condiciones.

Proporcionan funcionalidades eficaces para filtrar, ordenar y agrupar con un

código de aplicación mínimo.

Se pueden migrar a otros orígenes de datos con muy poca o ninguna

modificación.

Por lo general, cuanto más compleja es la operación que se quiere realizar en los datos,
más ventajas se obtienen al usar LINQ en lugar de las técnicas de iteración tradicionales.

El propósito de esta sección es mostrar el enfoque de LINQ con algunos ejemplos

seleccionados. No pretende ser exhaustiva.

En esta sección
LINQ y cadenas (C#)

Explica cómo se puede usar LINQ para consultar y transformar cadenas y colecciones de
cadenas. También incluye vínculos a artículos que muestran estos principios.

LINQ y reflexión (C#)

Vincula a un ejemplo que muestra cómo usa LINQ la reflexión.

LINQ y directorios de archivos (C#)

Explica cómo se puede usar LINQ para interactuar con sistemas de archivos. También
incluye vínculos a artículos que muestran estos conceptos.

Procedimiento para consultar un objeto ArrayList con LINQ (C#)

Muestra cómo consultar un objeto ArrayList en C#.

Procedimiento para agregar métodos personalizados para las consultas LINQ (C#)

Explica cómo extender el conjunto de métodos que puede usar para consultas LINQ
agregando métodos de extensión a la interfaz IEnumerable<T>.

Language Integrated Query (LINQ) (C#)

Proporciona vínculos a artículos que explican LINQ e incluye ejemplos de código que
realizan consultas.
LINQ y cadenas (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Se puede usar LINQ para consultar y transformar cadenas y colecciones de cadenas.

Puede resultar especialmente útil con datos semiestructurados de archivos de texto. Las
consultas LINQ se pueden combinar con funciones de cadena tradicionales y
expresiones regulares. Por ejemplo, puede usar el método String.Split o Regex.Split para
crear una matriz de cadenas que después puede consultar o modificar mediante LINQ.
Puede usar el método Regex.IsMatch en la cláusula where de una consulta LINQ. Y
puede usar LINQ para consultar o modificar los resultados MatchCollection que se han
devuelto mediante una expresión regular.

También puede usar las técnicas descritas en esta sección para transformar datos de
texto semiestructurados en XML. Para más información, consulte Procedimiento para
generar XML a partir de archivos CSV (C#).

Los ejemplos de esta sección se dividen en dos categorías:

Consulta de un bloque de texto

Puede consultar, analizar y modificar bloques de texto dividiéndolos en una matriz
consultable de cadenas más pequeñas mediante el método String.Split o el método
Regex.Split. Puede dividir el texto de origen en palabras, frases, párrafos, páginas o
cualquier otro criterio y luego realizar divisiones adicionales si son necesarias en la
consulta.

Procedimiento para realizar un recuento de las repeticiones de una palabra en una

cadena (LINQ) (C#)

Muestra cómo usar LINQ para consultas simples en texto.

Procedimiento para buscar frases que contengan un conjunto especificado de

palabras (LINQ) (C#)

Muestra cómo dividir archivos de texto en límites arbitrarios y cómo realizar

consultas en cada parte.

Procedimiento para buscar caracteres en una cadena (LINQ) (C#)

Muestra que una cadena es un tipo que se puede consultar.

Procedimiento para combinar consultas LINQ con expresiones regulares (C#)

 Muestra cómo usar expresiones regulares en consultas LINQ para la coincidencia
de patrones compleja en resultados de consulta filtrados.

Consulta de datos semiestructurados en

formato de texto
Muchos tipos diferentes de archivos de texto se componen de una serie de líneas, a
menudo con un formato similar, como archivos delimitados por comas o líneas de
longitud fija. Después de leer uno de estos archivos de texto en la memoria, puede usar
LINQ para consultar o modificar las líneas. Las consultas LINQ también simplifican la
tarea de combinar datos de varios orígenes.

Procedimiento para buscar la diferencia de conjuntos entre dos listas (LINQ) (C#)

Muestra cómo encontrar todas las cadenas que se encuentran en una lista pero no
en la otra.

Procedimiento para ordenar o filtrar datos de texto por palabra o campo (LINQ)
(C#)

Muestra cómo ordenar líneas de texto según cualquier palabra o campo.

Procedimiento para reordenar los campos de un archivo delimitado (LINQ) (C#)

Muestra cómo cambiar el orden de los campos en una línea en un archivo .csv.

Procedimiento para combinar y comparar colecciones de cadenas (LINQ) (C#)

Muestra cómo combinar listas de cadenas de varias maneras.

Procedimiento para rellenar colecciones de objetos de varios orígenes (LINQ) (C#)

Muestra cómo crear colecciones de objetos mediante varios archivos de texto

como orígenes de datos.

Procedimiento para combinar contenido de archivos no similares (LINQ) (C#)

Muestra cómo combinar cadenas de dos listas en una sola mediante una clave
coincidente.

Procedimiento para dividir un archivo en muchos mediante grupos (LINQ) (C#)

Muestra cómo crear nuevos archivos mediante un solo archivo como origen de
datos.
 Procedimiento para calcular valores de columna en un archivo de texto CSV (LINQ)
(C#)

Muestra cómo realizar cálculos matemáticos en datos de texto en archivos .csv.

Vea también
Language Integrated Query (LINQ) (C#)
Procedimiento para generar XML a partir de archivos CSV
Procedimiento para realizar un recuento
de las repeticiones de una palabra en
una cadena (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo usar una consulta LINQ para contar las apariciones de
una palabra determinada en una cadena. Observe que para realizar el recuento, primero
se llama al método Split para crear una matriz de palabras. Existe un costo de
rendimiento en el método Split. Si la única operación de la cadena es para contar las
palabras, debe considerar la posibilidad de usar en su lugar los métodos Matches o
IndexOf. Pero si el rendimiento no es un problema crítico, o si ya ha dividido la frase
para realizar otros tipos de consultas, tiene sentido usar LINQ para además contar las
palabras o frases.

Ejemplo
C#

class CountWords

static void Main()

string text = @"Historically, the world of data and the world of

objects" +

@" have not been well integrated. Programmers work in C# or Visual

Basic" +

@" and also in SQL or XQuery. On the one side are concepts such as
classes," +

@" objects, fields, inheritance, and .NET APIs. On the other side"
+

@" are tables, columns, rows, nodes, and separate languages for
dealing with" +

@" them. Data types often require translation between the two
worlds; there are" +

@" different standard functions. Because the object world has no

notion of query, a" +

@" query can only be represented as a string without compile-time

type checking or" +

@" IntelliSense support in the IDE. Transferring data from SQL

tables or XML trees to" +

@" objects in memory is often tedious and error-prone.";

string searchTerm = "data";

//Convert the string into an array of words

 string[] source = text.Split(new char[] { '.', '?', '!', ' ', ';',
':', ',' }, StringSplitOptions.RemoveEmptyEntries);

// Create the query. Use the InvariantCultureIgnoreCase comparision

to match "data" and "Data"

var matchQuery = from word in source

where word.Equals(searchTerm,
StringComparison.InvariantCultureIgnoreCase)

select word;

// Count the matches, which executes the query.

int wordCount = matchQuery.Count();

Console.WriteLine("{0} occurrences(s) of the search term \"{1}\"

were found.", wordCount, searchTerm);

// Keep console window open in debug mode

Console.WriteLine("Press any key to exit");

Console.ReadKey();

/* Output:

3 occurrences(s) of the search term "data" were found.

*/

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
Procedimiento para buscar frases que
contengan un conjunto especificado de
palabras (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo buscar frases en un archivo de texto que contengan
coincidencias con cada uno de los conjuntos de palabras especificados. Aunque la
matriz de términos de búsqueda está codificada de forma rígida en este ejemplo,
también se podría rellenar dinámicamente en tiempo de ejecución. En este ejemplo, la
consulta devuelve las frases que contienen las palabras "Historically", "data" e
"integrated".

Ejemplo
C#

class FindSentences

static void Main()

string text = @"Historically, the world of data and the world of

objects " +

@"have not been well integrated. Programmers work in C# or Visual

Basic " +

@"and also in SQL or XQuery. On the one side are concepts such as
classes, " +

@"objects, fields, inheritance, and .NET APIs. On the other side " +

@"are tables, columns, rows, nodes, and separate languages for

dealing with " +

@"them. Data types often require translation between the two worlds;
there are " +

@"different standard functions. Because the object world has no

notion of query, a " +

@"query can only be represented as a string without compile-time

type checking or " +

@"IntelliSense support in the IDE. Transferring data from SQL tables

or XML trees to " +

@"objects in memory is often tedious and error-prone.";

// Split the text block into an array of sentences.

string[] sentences = text.Split(new char[] { '.', '?', '!' });

// Define the search terms. This list could also be dynamically

populated at run time.

string[] wordsToMatch = { "Historically", "data", "integrated" };

 // Find sentences that contain all the terms in the wordsToMatch

array.

// Note that the number of terms to match is not specified at

compile time.

var sentenceQuery = from sentence in sentences

let w = sentence.Split(new char[] { '.', '?',
'!', ' ', ';', ':', ',' },

StringSplitOptions.RemoveEmptyEntries)

where
w.Distinct().Intersect(wordsToMatch).Count() == wordsToMatch.Count()

select sentence;

// Execute the query. Note that you can explicitly type

// the iteration variable here even though sentenceQuery

// was implicitly typed.

foreach (string str in sentenceQuery)

Console.WriteLine(str);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

/* Output:

Historically, the world of data and the world of objects have not been well
integrated

*/

La consulta primero divide el texto en frases y, luego, divide las frases en una matriz de
cadenas que contienen cada palabra. Para cada una de estas matrices, el método
Distinct quita todas las palabras duplicadas y, después, la consulta realiza una operación
Intersect en la matriz de palabras y en la matriz wordsToMatch . Si el recuento de la
intersección es igual que el recuento de la matriz wordsToMatch , se han encontrado
todas las palabras y se devuelve la frase original.

En la llamada a Split, los signos de puntuación se usan como separadores para quitar las
frases de la cadena. Si no lo hiciera podría tener, por ejemplo, una cadena "Historically",
lo que no coincidiría con el "Historically" de la matriz wordsToMatch . Podría tener que
usar separadores adicionales, en función de los tipos de puntuación del texto de origen.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.
Consulte también
LINQ y cadenas (C#)
Procedimiento para buscar caracteres en
una cadena (LINQ) (C#)
Artículo • 11/02/2023 • Tiempo de lectura: 2 minutos

Como la clase String implementa la interfaz IEnumerable<T> genérica, cualquier cadena

puede consultarse como una secuencia de caracteres. Pero esto no es un uso habitual
de LINQ. Para operaciones de coincidencia de patrones complejas, use la clase Regex.

Ejemplo
En el ejemplo siguiente se consulta una cadena para determinar el número de dígitos
numéricos que contiene. Tenga en cuenta que la consulta se "reutiliza" después de que
se ejecute la primera vez. Esto es posible porque la propia consulta no almacena ningún
resultado real.

C#

class QueryAString

static void Main()

string aString = "ABCDE99F-J74-12-89A";

// Select only those characters that are numbers

IEnumerable<char> stringQuery =

from ch in aString

where Char.IsDigit(ch)

select ch;

// Execute the query

foreach (char c in stringQuery)

Console.Write(c + " ");

// Call the Count method on the existing query.

int count = stringQuery.Count();

Console.WriteLine("Count = {0}", count);

// Select all characters before the first '-'

IEnumerable<char> stringQuery2 = aString.TakeWhile(c => c != '-');

// Execute the second query

foreach (char c in stringQuery2)

Console.Write(c);

Console.WriteLine(System.Environment.NewLine + "Press any key to

exit");

Console.ReadKey();

/* Output:

Output: 9 9 7 4 1 2 8 9

Count = 8

ABCDE99F

*/

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Vea también
LINQ y cadenas (C#)
Procedimiento para combinar consultas LINQ con expresiones regulares (C#)
Procedimiento para combinar consultas
LINQ con expresiones regulares (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo usar la clase Regex para crear una expresión regular
para coincidencias más complejas en cadenas de texto. Con la consulta LINQ, resulta
fácil filtrar por los archivos exactos que se quieren buscar con la expresión regular y dar
forma a los resultados.

Ejemplo
C#

class QueryWithRegEx

public static void Main()

// Modify this path as necessary so that it accesses your version of

Visual Studio.

string startFolder = @"C:\Program Files (x86)\Microsoft Visual

Studio 14.0\";

// One of the following paths may be more appropriate on your

computer.

//string startFolder = @"C:\Program Files (x86)\Microsoft Visual

Studio\2017\";

// Take a snapshot of the file system.

IEnumerable<System.IO.FileInfo> fileList = GetFiles(startFolder);

// Create the regular expression to find all things "Visual".

System.Text.RegularExpressions.Regex searchTerm =

new System.Text.RegularExpressions.Regex(@"Visual
(Basic|C#|C\+\+|Studio)");

// Search the contents of each .htm file.

// Remove the where clause to find even more matchedValues!

// This query produces a list of files where a match

// was found, and a list of the matchedValues in that file.

// Note: Explicit typing of "Match" in select clause.

// This is required because MatchCollection is not a

// generic IEnumerable collection.

var queryMatchingFiles =

from file in fileList

where file.Extension == ".htm"

let fileText = System.IO.File.ReadAllText(file.FullName)

let matches = searchTerm.Matches(fileText)

where matches.Count > 0

select new

name = file.FullName,

matchedValues = from System.Text.RegularExpressions.Match

match in matches

select match.Value

};

// Execute the query.

Console.WriteLine("The term \"{0}\" was found in:",

searchTerm.ToString());

foreach (var v in queryMatchingFiles)

// Trim the path a bit, then write

// the file name in which a match was found.

string s = v.name.Substring(startFolder.Length - 1);

Console.WriteLine(s);

// For this file, write out all the matching strings

foreach (var v2 in v.matchedValues)

Console.WriteLine(" " + v2);

// Keep the console window open in debug mode

Console.WriteLine("Press any key to exit");

Console.ReadKey();

// This method assumes that the application has discovery

// permissions for all folders under the specified path.

static IEnumerable<System.IO.FileInfo> GetFiles(string path)

if (!System.IO.Directory.Exists(path))

throw new System.IO.DirectoryNotFoundException();

string[] fileNames = null;

List<System.IO.FileInfo> files = new List<System.IO.FileInfo>();

fileNames = System.IO.Directory.GetFiles(path, "*.*",

System.IO.SearchOption.AllDirectories);

foreach (string name in fileNames)

files.Add(new System.IO.FileInfo(name));

return files;

Tenga en cuenta que también puede consultar el objeto MatchCollection devuelto por
una búsqueda RegEx . En este ejemplo se genera solo el valor de cada coincidencia en
los resultados. Pero también es posible usar LINQ para realizar todo tipo de filtrado,
ordenación y agrupación en esa colección. Dado que MatchCollection no es una
colección genérica IEnumerable, tendrá que indicar explícitamente el tipo de la variable
de rango en la consulta.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
LINQ y directorios de archivos (C#)
Procedimiento para buscar la diferencia
de conjuntos entre dos listas (LINQ) (C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo usar LINQ para comparar dos listas de cadenas y
generar estas líneas, que están en names1.txt pero no en names2.txt.

Para crear los archivos de datos

1. Copie names1.txt y names2.txt en la carpeta de la solución, como se muestra en
Procedimiento para combinar y comparar colecciones de cadenas (LINQ) (C#).

Ejemplo
C#

class CompareLists

static void Main()

// Create the IEnumerable data sources.

string[] names1 =
System.IO.File.ReadAllLines(@"../../../names1.txt");

string[] names2 =
System.IO.File.ReadAllLines(@"../../../names2.txt");

// Create the query. Note that method syntax must be used here.

IEnumerable<string> differenceQuery =

names1.Except(names2);

// Execute the query.

Console.WriteLine("The following lines are in names1.txt but not

names2.txt");

foreach (string s in differenceQuery)

Console.WriteLine(s);

// Keep the console window open until the user presses a key.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

/* Output:

The following lines are in names1.txt but not names2.txt

Potra, Cristina

Noriega, Fabricio

Aw, Kam Foo

 Toyoshima, Tim

Guy, Wey Yuan

Garcia, Debra

*/

Algunos tipos de operaciones de consulta en C#, como Except, Distinct, Union y Concat,
solo pueden expresarse en una sintaxis basada en método.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
Procedimiento para ordenar o filtrar
datos de texto por palabra o campo
(LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En el ejemplo siguiente se muestra cómo ordenar líneas de texto estructurado, como

valores separados por comas, por cualquier campo de la línea. El campo se puede
especificar dinámicamente en tiempo de ejecución. Supongamos que los campos de
scores.csv representan el número de identificación de un alumno, seguido de una serie
de cuatro calificaciones.

Para crear un archivo que contenga datos

1. Copie los datos de scores.csv del tema Procedimiento para combinar contenido de
archivos no similares (LINQ) (C#).

Ejemplo
C#

public class SortLines

static void Main()

// Create an IEnumerable data source

string[] scores =
System.IO.File.ReadAllLines(@"../../../scores.csv");

// Change this to any value from 0 to 4.

int sortField = 1;

Console.WriteLine("Sorted highest to lowest by field [{0}]:",

sortField);

// Demonstrates how to return query from a method.

// The query is executed here.

foreach (string str in RunQuery(scores, sortField))

Console.WriteLine(str);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

// Returns the query variable, not query results!

static IEnumerable<string> RunQuery(IEnumerable<string> source, int num)

// Split the string and sort on field[num]

var scoreQuery = from line in source

let fields = line.Split(',')

orderby fields[num] descending

select line;

return scoreQuery;

/* Output (if sortField == 1):

Sorted highest to lowest by field [1]:

116, 99, 86, 90, 94

120, 99, 82, 81, 79

111, 97, 92, 81, 60

114, 97, 89, 85, 82

121, 96, 85, 91, 60

122, 94, 92, 91, 91

117, 93, 92, 80, 87

118, 92, 90, 83, 78

113, 88, 94, 65, 91

112, 75, 84, 91, 39

119, 68, 79, 88, 92

115, 35, 72, 91, 70

*/

En este ejemplo también se muestra cómo devolver una variable de consulta desde un
método.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
Procedimiento para reordenar los
campos de un archivo delimitado (LINQ)
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Un archivo de valores separados por comas (CSV) es un archivo de texto que se usa a
menudo para almacenar datos de hoja de cálculo u otros datos tabulares que se
representan mediante filas y columnas. Mediante el uso del método Split para separar
los campos, es muy fácil consultar y manipular los archivos CSV con LINQ. De hecho, la
misma técnica puede usarse para reordenar los elementos de cualquier línea
estructurada de texto, no se limita a un archivo CSV.

En el ejemplo siguiente, supongamos que las tres columnas representan el "apellido", el

"nombre" y el "ID" de los alumnos. Los campos están en orden alfabético en función de
los apellidos de los alumnos. La consulta genera una nueva secuencia en la que la
columna de identificador aparece en primer lugar, seguida por una segunda columna
que combina el nombre y el apellido del alumno. Las líneas se reordenan según el
campo ID. Los resultados se guardan en un archivo nuevo y no se modifican los datos
originales.

Para crear el archivo de datos

1. Copie las líneas siguientes en un archivo de texto sin formato que se denomine
spreadsheet1.csv. Guarde el archivo en la carpeta del proyecto.

csv

Adams,Terry,120

Fakhouri,Fadi,116

Feng,Hanying,117

Garcia,Cesar,114

Garcia,Debra,115

Garcia,Hugo,118

Mortensen,Sven,113

O'Donnell,Claire,112

Omelchenko,Svetlana,111

Tucker,Lance,119

Tucker,Michael,122

Zabokritski,Eugene,121

Ejemplo
 C#

class CSVFiles

static void Main(string[] args)

// Create the IEnumerable data source

string[] lines =
System.IO.File.ReadAllLines(@"../../../spreadsheet1.csv");

// Create the query. Put field 2 first, then

// reverse and combine fields 0 and 1 from the old field

IEnumerable<string> query =

from line in lines

let x = line.Split(',')

orderby x[2]

select x[2] + ", " + (x[1] + " " + x[0]);

// Execute the query and write out the new file. Note that
WriteAllLines

// takes a string[], so ToArray is called on the query.

System.IO.File.WriteAllLines(@"../../../spreadsheet2.csv",
query.ToArray());

Console.WriteLine("Spreadsheet2.csv written to disk. Press any key

to exit");

Console.ReadKey();

/* Output to spreadsheet2.csv:

111, Svetlana Omelchenko

112, Claire O'Donnell

113, Sven Mortensen

114, Cesar Garcia

115, Debra Garcia

116, Fadi Fakhouri

117, Hanying Feng

118, Hugo Garcia

119, Lance Tucker

120, Terry Adams

121, Eugene Zabokritski

122, Michael Tucker

*/

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.
Consulte también
LINQ y cadenas (C#)
LINQ y directorios de archivos (C#)
Procedimiento para generar XML a partir de archivos CSV (C#)
Procedimiento para combinar y
comparar colecciones de cadenas
(LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo combinar archivos que contienen líneas de texto y
después ordenar los resultados. En concreto, se muestra cómo realizar una
concatenación simple, una unión y una intersección en los dos conjuntos de líneas de
texto.

Para configurar el proyecto y los archivos de texto

1. Copie estos nombres en un archivo de texto denominado names1.txt y guárdelo
en la carpeta del proyecto:

text

Bankov, Peter

Holm, Michael

Garcia, Hugo

Potra, Cristina

Noriega, Fabricio

Aw, Kam Foo

Beebe, Ann

Toyoshima, Tim

Guy, Wey Yuan

Garcia, Debra

2. Copie estos nombres en un archivo de texto denominado names2.txt y guárdelo

en la carpeta del proyecto. Tenga en cuenta que los dos archivos tienen algunos
nombres en común.

text

Liu, Jinghao

Bankov, Peter

Holm, Michael

Garcia, Hugo

Beebe, Ann

Gilchrist, Beth

Myrcha, Jacek

Giakoumakis, Leo

McLin, Nkenge

El Yassir, Mehdi

Ejemplo
C#

class MergeStrings

static void Main(string[] args)

//Put text files in your solution folder

string[] fileA =
System.IO.File.ReadAllLines(@"../../../names1.txt");

string[] fileB =
System.IO.File.ReadAllLines(@"../../../names2.txt");

//Simple concatenation and sort. Duplicates are preserved.

IEnumerable<string> concatQuery =

fileA.Concat(fileB).OrderBy(s => s);

// Pass the query variable to another function for execution.

OutputQueryResults(concatQuery, "Simple concatenate and sort.

Duplicates are preserved:");

// Concatenate and remove duplicate names based on

// default string comparer.

IEnumerable<string> uniqueNamesQuery =

fileA.Union(fileB).OrderBy(s => s);

OutputQueryResults(uniqueNamesQuery, "Union removes duplicate

names:");

// Find the names that occur in both files (based on

// default string comparer).

IEnumerable<string> commonNamesQuery =

fileA.Intersect(fileB);

OutputQueryResults(commonNamesQuery, "Merge based on

intersect:");

// Find the matching fields in each list. Merge the two

// results by using Concat, and then

// sort using the default string comparer.

string nameMatch = "Garcia";

IEnumerable<String> tempQuery1 =

from name in fileA

let n = name.Split(',')

where n[0] == nameMatch

select name;

IEnumerable<string> tempQuery2 =

from name2 in fileB

let n2 = name2.Split(',')

where n2[0] == nameMatch

 select name2;

IEnumerable<string> nameMatchQuery =

tempQuery1.Concat(tempQuery2).OrderBy(s => s);

OutputQueryResults(nameMatchQuery, $"Concat based on partial

name match \"{nameMatch}\":");

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

static void OutputQueryResults(IEnumerable<string> query, string

message)

Console.WriteLine(System.Environment.NewLine + message);

foreach (string item in query)

Console.WriteLine(item);

Console.WriteLine("{0} total names in list", query.Count());

/* Output:

Simple concatenate and sort. Duplicates are preserved:

Aw, Kam Foo

Bankov, Peter

Bankov, Peter

Beebe, Ann

Beebe, Ann

El Yassir, Mehdi

Garcia, Debra

Garcia, Hugo

Garcia, Hugo

Giakoumakis, Leo

Gilchrist, Beth

Guy, Wey Yuan

Holm, Michael

Holm, Michael

Liu, Jinghao

McLin, Nkenge

Myrcha, Jacek

Noriega, Fabricio

Potra, Cristina

Toyoshima, Tim

20 total names in list

Union removes duplicate names:

Aw, Kam Foo

Bankov, Peter

Beebe, Ann

El Yassir, Mehdi

Garcia, Debra

Garcia, Hugo

Giakoumakis, Leo

 Gilchrist, Beth

Guy, Wey Yuan

Holm, Michael

Liu, Jinghao

McLin, Nkenge

Myrcha, Jacek

Noriega, Fabricio

Potra, Cristina

Toyoshima, Tim

16 total names in list

Merge based on intersect:

Bankov, Peter

Holm, Michael

Garcia, Hugo

Beebe, Ann

4 total names in list

Concat based on partial name match "Garcia":

Garcia, Debra

Garcia, Hugo

Garcia, Hugo

3 total names in list

*/

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
LINQ y directorios de archivos (C#)
Procedimiento para rellenar colecciones
de objetos de varios orígenes (LINQ)
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

En este ejemplo se muestra cómo combinar datos de orígenes diferentes en una

secuencia de tipos nuevos.

７ Nota

No intente unir datos en memoria o datos del sistema de archivos con datos que
todavía están en una base de datos. Dichas combinaciones entre dominios pueden
producir resultados indefinidos porque hay diferentes maneras de definir las
operaciones de combinación para las consultas de base de datos y otros tipos de
orígenes. Además, existe el riesgo de que esta operación produzca una excepción
de memoria insuficiente si la cantidad de datos existente en la base de datos es
considerable. Para combinar datos de una base de datos con datos en memoria,
primero debe llamar a ToList o a ToArray en la base de datos de consulta y, luego,
debe efectuar la combinación en la colección devuelta.

Para crear el archivo de datos

Copie los archivos names.csv y scores.csv en la carpeta del proyecto, como se describe
en Procedimiento para combinar contenido de archivos no similares (LINQ) (C#).

Ejemplo
En el ejemplo siguiente se muestra cómo usar un tipo Student con nombre para
almacenar los datos combinados de dos colecciones de cadenas en memoria que
simulan datos de hoja de cálculo en formato .csv. La primera colección de cadenas
representa los nombres y los identificadores de los estudiantes, mientras que la segunda
colección representa el identificador de los estudiantes (en la primera columna) y cuatro
notas de exámenes. El identificador se usa como clave externa.

C#

using System;

using System.Collections.Generic;
using System.Linq;

class Student

public string FirstName { get; set; }

public string LastName { get; set; }

public int ID { get; set; }

public List<int> ExamScores { get; set; }

class PopulateCollection

static void Main()

// These data files are defined in How to join content from

// dissimilar files (LINQ).

// Each line of names.csv consists of a last name, a first name, and

an

// ID number, separated by commas. For example,

Omelchenko,Svetlana,111

string[] names = System.IO.File.ReadAllLines(@"../../../names.csv");

// Each line of scores.csv consists of an ID number and four test

// scores, separated by commas. For example, 111, 97, 92, 81, 60

string[] scores =
System.IO.File.ReadAllLines(@"../../../scores.csv");

// Merge the data sources using a named type.

// var could be used instead of an explicit type. Note the dynamic

// creation of a list of ints for the ExamScores member. The first

item

// is skipped in the split string because it is the student ID,

// not an exam score.

IEnumerable<Student> queryNamesScores =

from nameLine in names

let splitName = nameLine.Split(',')

from scoreLine in scores

let splitScoreLine = scoreLine.Split(',')

where Convert.ToInt32(splitName[2]) ==
Convert.ToInt32(splitScoreLine[0])

select new Student()

FirstName = splitName[0],

LastName = splitName[1],

ID = Convert.ToInt32(splitName[2]),

ExamScores = (from scoreAsText in splitScoreLine.Skip(1)

select Convert.ToInt32(scoreAsText)).

ToList()

};

// Optional. Store the newly created student objects in memory

// for faster access in future queries. This could be useful with

// very large data files.

List<Student> students = queryNamesScores.ToList();

 // Display each student's name and exam score average.

foreach (var student in students)

Console.WriteLine("The average score of {0} {1} is {2}.",

student.FirstName, student.LastName,

student.ExamScores.Average());

//Keep console window open in debug mode

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

The average score of Omelchenko Svetlana is 82.5.

The average score of O'Donnell Claire is 72.25.

The average score of Mortensen Sven is 84.5.

The average score of Garcia Cesar is 88.25.

The average score of Garcia Debra is 67.

The average score of Fakhouri Fadi is 92.25.

The average score of Feng Hanying is 88.

The average score of Garcia Hugo is 85.75.

The average score of Tucker Lance is 81.75.

The average score of Adams Terry is 85.25.

The average score of Zabokritski Eugene is 83.

The average score of Tucker Michael is 92.

*/

En la cláusula select se usa un inicializador de objeto para crear una instancia de cada
objeto Student nuevo usando los datos de los dos orígenes.

Si no tiene que almacenar los resultados de una consulta, los tipos anónimos pueden
ser más convenientes que los tipos con nombre. Los tipos con nombre son necesarios si
pasa los resultados de la consulta fuera del método en el que se ejecuta la consulta. En
el ejemplo siguiente se ejecuta la misma tarea que en el ejemplo anterior, con la
diferencia de que se usan tipos anónimos en lugar de tipos con nombre:

C#

// Merge the data sources by using an anonymous type.

// Note the dynamic creation of a list of ints for the

// ExamScores member. We skip 1 because the first string

// in the array is the student ID, not an exam score.

var queryNamesScores2 =

from nameLine in names

let splitName = nameLine.Split(',')

from scoreLine in scores

let splitScoreLine = scoreLine.Split(',')

where Convert.ToInt32(splitName[2]) ==
Convert.ToInt32(splitScoreLine[0])

 select new

First = splitName[0],

Last = splitName[1],

ExamScores = (from scoreAsText in splitScoreLine.Skip(1)

select Convert.ToInt32(scoreAsText))

.ToList()

};

// Display each student's name and exam score average.

foreach (var student in queryNamesScores2)

Console.WriteLine("The average score of {0} {1} is {2}.",

student.First, student.Last, student.ExamScores.Average());

Consulte también
LINQ y cadenas (C#)
Inicializadores de objeto y colección
Tipos anónimos
Procedimiento para dividir un archivo
en muchos mediante grupos (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra una manera de combinar el contenido de dos archivos y

luego crear un conjunto de archivos nuevos que organicen los datos de una forma
nueva.

Para crear los archivos de datos

1. Copie estos nombres en un archivo de texto denominado names1.txt y guárdelo
en la carpeta del proyecto:

text

Bankov, Peter

Holm, Michael

Garcia, Hugo

Potra, Cristina

Noriega, Fabricio

Aw, Kam Foo

Beebe, Ann

Toyoshima, Tim

Guy, Wey Yuan

Garcia, Debra

2. Copie estos nombres en un archivo de texto denominado names2.txt y guárdelo

en la carpeta del proyecto: tenga en cuenta que los dos archivos tienen algunos
nombres en común.

text

Liu, Jinghao

Bankov, Peter

Holm, Michael

Garcia, Hugo

Beebe, Ann

Gilchrist, Beth

Myrcha, Jacek

Giakoumakis, Leo

McLin, Nkenge

El Yassir, Mehdi

Ejemplo
C#

class SplitWithGroups

static void Main()

string[] fileA =
System.IO.File.ReadAllLines(@"../../../names1.txt");

string[] fileB =
System.IO.File.ReadAllLines(@"../../../names2.txt");

// Concatenate and remove duplicate names based on

// default string comparer

var mergeQuery = fileA.Union(fileB);

// Group the names by the first letter in the last name.

var groupQuery = from name in mergeQuery

let n = name.Split(',')

group name by n[0][0] into g

orderby g.Key

select g;

// Create a new file for each group that was created

// Note that nested foreach loops are required to access

// individual items with each group.

foreach (var g in groupQuery)

// Create the new file name.

string fileName = @"../../../testFile_" + g.Key + ".txt";

// Output to display.

Console.WriteLine(g.Key);

// Write file.

using (System.IO.StreamWriter sw = new

System.IO.StreamWriter(fileName))

foreach (var item in g)

sw.WriteLine(item);

// Output to console for example purposes.

Console.WriteLine(" {0}", item);

// Keep console window open in debug mode.

Console.WriteLine("Files have been written. Press any key to exit");

Console.ReadKey();

/* Output:

Aw, Kam Foo

Bankov, Peter

Beebe, Ann

El Yassir, Mehdi

Garcia, Hugo

Guy, Wey Yuan

Garcia, Debra

Gilchrist, Beth

Giakoumakis, Leo

Holm, Michael

Liu, Jinghao

Myrcha, Jacek

McLin, Nkenge

Noriega, Fabricio

Potra, Cristina

Toyoshima, Tim

*/

El programa escribe un archivo independiente para cada grupo en la misma carpeta que
los archivos de datos.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
LINQ y directorios de archivos (C#)
Procedimiento para combinar contenido
de archivos no similares (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo combinar datos de dos archivos delimitados por
comas que comparten un valor común que se usa como clave coincidente. Esta técnica
puede ser útil si tiene que combinar datos de dos hojas de cálculo o si tiene que
combinar en un archivo nuevo datos procedentes de una hoja de cálculo y de un
archivo que tiene otro formato. Puede modificar el ejemplo para adaptarlo a cualquier
tipo de texto estructurado.

Para crear los archivos de datos

1. Copie las líneas siguientes en un archivo llamado scores.csv y guárdelo en la
carpeta del proyecto. El archivo representa datos de una hoja de cálculo. La
columna 1 es el identificador del estudiante y las columnas comprendidas entre la
2 y la 5 son las notas de las pruebas.

csv

111, 97, 92, 81, 60

112, 75, 84, 91, 39

113, 88, 94, 65, 91

114, 97, 89, 85, 82

115, 35, 72, 91, 70

116, 99, 86, 90, 94

117, 93, 92, 80, 87

118, 92, 90, 83, 78

119, 68, 79, 88, 92

120, 99, 82, 81, 79

121, 96, 85, 91, 60

122, 94, 92, 91, 91

2. Copie las líneas siguientes en un archivo llamado names.csv y guárdelo en la

carpeta del proyecto. El archivo representa una hoja de cálculo que contiene el
nombre, los apellidos y el identificador de los estudiantes.

csv

Omelchenko,Svetlana,111

O'Donnell,Claire,112

Mortensen,Sven,113

Garcia,Cesar,114

 Garcia,Debra,115

Fakhouri,Fadi,116

Feng,Hanying,117

Garcia,Hugo,118

Tucker,Lance,119

Adams,Terry,120

Zabokritski,Eugene,121

Tucker,Michael,122

Ejemplo
C#

using System;

using System.Collections.Generic;
using System.Linq;

class JoinStrings

static void Main()

// Join content from dissimilar files that contain

// related information. File names.csv contains the student

// name plus an ID number. File scores.csv contains the ID

// and a set of four test scores. The following query joins

// the scores to the student names by using ID as a

// matching key.

string[] names = System.IO.File.ReadAllLines(@"../../../names.csv");

string[] scores =
System.IO.File.ReadAllLines(@"../../../scores.csv");

// Name: Last[0], First[1], ID[2]

// Omelchenko, Svetlana, 11

// Score: StudentID[0], Exam1[1] Exam2[2], Exam3[3], Exam4[4]

// 111, 97, 92, 81, 60

// This query joins two dissimilar spreadsheets based on common ID

value.

// Multiple from clauses are used instead of a join clause

// in order to store results of id.Split.

IEnumerable<string> scoreQuery1 =

from name in names

let nameFields = name.Split(',')

from id in scores

let scoreFields = id.Split(',')

where Convert.ToInt32(nameFields[2]) ==
Convert.ToInt32(scoreFields[0])

select nameFields[0] + "," + scoreFields[1] + "," +

scoreFields[2]

+ "," + scoreFields[3] + "," + scoreFields[4];

 // Pass a query variable to a method and execute it

// in the method. The query itself is unchanged.

OutputQueryResults(scoreQuery1, "Merge two spreadsheets:");

// Keep console window open in debug mode.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

static void OutputQueryResults(IEnumerable<string> query, string

message)

Console.WriteLine(System.Environment.NewLine + message);

foreach (string item in query)

Console.WriteLine(item);

Console.WriteLine("{0} total names in list", query.Count());

/* Output:

Merge two spreadsheets:

Omelchenko, 97, 92, 81, 60

O'Donnell, 75, 84, 91, 39

Mortensen, 88, 94, 65, 91

Garcia, 97, 89, 85, 82

Garcia, 35, 72, 91, 70

Fakhouri, 99, 86, 90, 94

Feng, 93, 92, 80, 87

Garcia, 92, 90, 83, 78

Tucker, 68, 79, 88, 92

Adams, 99, 82, 81, 79

Zabokritski, 96, 85, 91, 60

Tucker, 94, 92, 91, 91

12 total names in list

*/

Consulte también
LINQ y cadenas (C#)
LINQ y directorios de archivos (C#)
Procedimiento para calcular valores de
columna en un archivo de texto CSV
(LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En este ejemplo se muestra cómo efectuar cálculos agregados (como sumas, promedios,
mínimos y máximos) en las columnas de un archivo .csv. Los principios de ejemplo que
se muestran aquí se pueden aplicar a otros tipos de textos estructurados.

Para crear el archivo de origen

1. Copie las líneas siguientes en un archivo llamado scores.csv y guárdelo en la
carpeta del proyecto. Imagínese que la primera columna representa un
identificador de estudiante y que las columnas siguientes representan las notas de
cuatro exámenes.

csv

111, 97, 92, 81, 60

112, 75, 84, 91, 39

113, 88, 94, 65, 91

114, 97, 89, 85, 82

115, 35, 72, 91, 70

116, 99, 86, 90, 94

117, 93, 92, 80, 87

118, 92, 90, 83, 78

119, 68, 79, 88, 92

120, 99, 82, 81, 79

121, 96, 85, 91, 60

122, 94, 92, 91, 91

Ejemplo
C#

class SumColumns

static void Main(string[] args)

string[] lines =
System.IO.File.ReadAllLines(@"../../../scores.csv");

 // Specifies the column to compute.

int exam = 3;

// Spreadsheet format:

// Student ID Exam#1 Exam#2 Exam#3 Exam#4

// 111, 97, 92, 81, 60

// Add one to exam to skip over the first column,

// which holds the student ID.

SingleColumn(lines, exam + 1);

Console.WriteLine();

MultiColumns(lines);

Console.WriteLine("Press any key to exit");

Console.ReadKey();

static void SingleColumn(IEnumerable<string> strs, int examNum)

{

Console.WriteLine("Single Column Query:");

// Parameter examNum specifies the column to

// run the calculations on. This value could be

// passed in dynamically at run time.

// Variable columnQuery is an IEnumerable<int>.

// The following query performs two steps:

// 1) use Split to break each row (a string) into an array

// of strings,

// 2) convert the element at position examNum to an int

// and select it.

var columnQuery =

from line in strs

let elements = line.Split(',')

select Convert.ToInt32(elements[examNum]);

// Execute the query and cache the results to improve

// performance. This is helpful only with very large files.

var results = columnQuery.ToList();

// Perform aggregate calculations Average, Max, and

// Min on the column specified by examNum.

double average = results.Average();

int max = results.Max();

int min = results.Min();

Console.WriteLine("Exam #{0}: Average:{1:##.##} High Score:{2} Low

Score:{3}",

examNum, average, max, min);

static void MultiColumns(IEnumerable<string> strs)

Console.WriteLine("Multi Column Query:");

 // Create a query, multiColQuery. Explicit typing is used

// to make clear that, when executed, multiColQuery produces

// nested sequences. However, you get the same results by

// using 'var'.

// The multiColQuery query performs the following steps:

// 1) use Split to break each row (a string) into an array

// of strings,

// 2) use Skip to skip the "Student ID" column, and store the

// rest of the row in scores.

// 3) convert each score in the current row from a string to

// an int, and select that entire sequence as one row

// in the results.

IEnumerable<IEnumerable<int>> multiColQuery =

from line in strs

let elements = line.Split(',')

let scores = elements.Skip(1)

select (from str in scores

select Convert.ToInt32(str));

// Execute the query and cache the results to improve

// performance.

// ToArray could be used instead of ToList.

var results = multiColQuery.ToList();

// Find out how many columns you have in results.

int columnCount = results[0].Count();

// Perform aggregate calculations Average, Max, and

// Min on each column.

// Perform one iteration of the loop for each column

// of scores.

// You can use a for loop instead of a foreach loop

// because you already executed the multiColQuery

// query by calling ToList.

for (int column = 0; column < columnCount; column++)

var results2 = from row in results

select row.ElementAt(column);

double average = results2.Average();

int max = results2.Max();

int min = results2.Min();

// Add one to column because the first exam is Exam #1,

// not Exam #0.

Console.WriteLine("Exam #{0} Average: {1:##.##} High Score: {2}

Low Score: {3}",

column + 1, average, max, min);

/* Output:

Single Column Query:

Exam #4: Average:76.92 High Score:94 Low Score:39

 Multi Column Query:

Exam #1 Average: 86.08 High Score: 99 Low Score: 35

Exam #2 Average: 86.42 High Score: 94 Low Score: 72

Exam #3 Average: 84.75 High Score: 91 Low Score: 65

Exam #4 Average: 76.92 High Score: 94 Low Score: 39

*/

La consulta funciona usando el método Split para convertir cada línea de texto en una
matriz. Cada elemento de matriz representa una columna. Por último, el texto de cada
columna se convierte en su representación numérica. Si el archivo es un archivo
separado por tabulaciones, actualice el argumento del método Split a \t .

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y cadenas (C#)
LINQ y directorios de archivos (C#)
Procedimiento para consultar los
metadatos de un ensamblado con
reflexión (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las API de reflexión de .NET Framework se pueden usar para examinar los metadatos de
un ensamblado .NET y para crear colecciones de tipos, escribir miembros, parámetros y
otros elementos que se encuentren en ese ensamblado. Dado que estas colecciones
admiten la interfaz genérica IEnumerable<T>, se pueden consultar mediante LINQ.

En el ejemplo siguiente se muestra cómo se puede usar LINQ con reflexión para
recuperar metadatos concretos sobre métodos que coinciden con un criterio de
búsqueda especificado. En este caso, la consulta encontrará los nombres de todos los
métodos del ensamblado que devuelven tipos enumerables, como matrices.

Ejemplo
C#

using System;

using System.Linq;

using System.Reflection;

class ReflectionHowTO

static void Main()

Assembly assembly = Assembly.Load("System.Core, Version=3.5.0.0,

Culture=neutral, PublicKeyToken= b77a5c561934e089");

var pubTypesQuery = from type in assembly.GetTypes()

where type.IsPublic

from method in type.GetMethods()

where method.ReturnType.IsArray == true

|| ( method.ReturnType.GetInterface(

typeof(System.Collections.Generic.IEnumerable<>).FullName ) != null

&& method.ReturnType.FullName != "System.String"

)

group method.ToString() by type.ToString();

foreach (var groupOfMethods in pubTypesQuery)

Console.WriteLine("Type: {0}", groupOfMethods.Key);

foreach (var method in groupOfMethods)

 Console.WriteLine(" {0}", method);

Console.WriteLine("Press any key to exit... ");

Console.ReadKey();

El ejemplo usa el método Assembly.GetTypes para devolver una matriz de tipos en el

ensamblado especificado. Se aplica el filtro where para que solo se devuelvan tipos
públicos. Para cada tipo público, se genera una consulta anidada con la matriz
MethodInfo que se devuelve desde la llamada Type.GetMethods. Estos resultados se
filtran para que solo devuelvan los métodos cuyo tipo de valor devuelto sea una matriz,
o un tipo que implemente IEnumerable<T>. Por último, estos resultados se agrupan
usando el nombre de tipo como una clave.

Vea también
LINQ to Objects (C#)
Procedimiento para consultar los
metadatos de un ensamblado con
reflexión (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las API de reflexión de .NET Framework se pueden usar para examinar los metadatos de
un ensamblado .NET y para crear colecciones de tipos, escribir miembros, parámetros y
otros elementos que se encuentren en ese ensamblado. Dado que estas colecciones
admiten la interfaz genérica IEnumerable<T>, se pueden consultar mediante LINQ.

En el ejemplo siguiente se muestra cómo se puede usar LINQ con reflexión para
recuperar metadatos concretos sobre métodos que coinciden con un criterio de
búsqueda especificado. En este caso, la consulta encontrará los nombres de todos los
métodos del ensamblado que devuelven tipos enumerables, como matrices.

Ejemplo
C#

using System;

using System.Linq;

using System.Reflection;

class ReflectionHowTO

static void Main()

Assembly assembly = Assembly.Load("System.Core, Version=3.5.0.0,

Culture=neutral, PublicKeyToken= b77a5c561934e089");

var pubTypesQuery = from type in assembly.GetTypes()

where type.IsPublic

from method in type.GetMethods()

where method.ReturnType.IsArray == true

|| ( method.ReturnType.GetInterface(

typeof(System.Collections.Generic.IEnumerable<>).FullName ) != null

&& method.ReturnType.FullName != "System.String"

)

group method.ToString() by type.ToString();

foreach (var groupOfMethods in pubTypesQuery)

Console.WriteLine("Type: {0}", groupOfMethods.Key);

foreach (var method in groupOfMethods)

 Console.WriteLine(" {0}", method);

Console.WriteLine("Press any key to exit... ");

Console.ReadKey();

El ejemplo usa el método Assembly.GetTypes para devolver una matriz de tipos en el

ensamblado especificado. Se aplica el filtro where para que solo se devuelvan tipos
públicos. Para cada tipo público, se genera una consulta anidada con la matriz
MethodInfo que se devuelve desde la llamada Type.GetMethods. Estos resultados se
filtran para que solo devuelvan los métodos cuyo tipo de valor devuelto sea una matriz,
o un tipo que implemente IEnumerable<T>. Por último, estos resultados se agrupan
usando el nombre de tipo como una clave.

Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Muchas operaciones de sistema de archivos son esencialmente consultas y, por tanto,

son adecuadas para el enfoque LINQ.

Las consultas en esta sección no son destructivas. No se usan para cambiar el contenido
de las carpetas o los archivos originales. Esto sigue la regla de que las consultas no
deben causar efectos secundarios. En general, cualquier código (incluidas las consultas
que ejecutan operadores de creación actualización y eliminación) que modifica los datos
de origen se debe separar del código que solo consulta los datos.

Esta sección contiene los siguientes temas:

Procedimiento para buscar archivos con un nombre o atributo especificados (C#)

Muestra cómo buscar archivos examinando una o más propiedades de su objeto

FileInfo.

Procedimiento para agrupar archivos por extensión (LINQ) (C#)

Muestra cómo devolver grupos del objeto FileInfo basándose en su extensión de

nombre de archivo.

Procedimiento para buscar el número total de bytes de un conjunto de carpetas (LINQ)

(C#)

Muestra cómo devolver el número total de bytes en todos los archivos en un árbol de
directorio especificado.

Procedimiento para comparar el contenido de dos carpetas (LINQ) (C#)

Muestra cómo devolver todos los archivos que se encuentran en dos carpetas
especificadas y también todos los archivos que se encuentran en una carpeta pero no
en la otra.

Procedimiento para buscar el archivo o archivos de mayor tamaño en un árbol de

directorios (LINQ) (C#)

Muestra cómo devolver el archivo mayor o menor, o un número especificado de

archivos, en un árbol de directorios.

Búsqueda de archivos duplicados en un árbol de directorios (LINQ) (C#)

Muestra cómo agrupar todos los nombres de archivo que aparecen en más de una
ubicación en un árbol de directorio especificado. También muestra cómo realizar
comparaciones más complejas basadas en un comparador personalizado.
Consulta del contenido de los archivos de una carpeta (LINQ) (C#)

Muestra cómo recorrer en iteración las carpetas de un árbol, abrir cada archivo y
consultar el contenido del archivo.

Comentarios
Hay cierta complejidad en la creación de un origen de datos que representa de forma
precisa el contenido del sistema de archivos y controla las excepciones correctamente.
En los ejemplos de esta sección se crea una colección de instantáneas de objetos
FileInfo que representa todos los archivos en una carpeta raíz especificada y todas sus
subcarpetas. El estado real de cada FileInfo puede cambiar en el periodo comprendido
entre el comienzo y el fin de la ejecución de una consulta. Por ejemplo, se puede crear
una lista de objetos FileInfo para usarla como origen de datos. Si se intenta tener acceso
a la propiedad Length en una consulta, el objeto FileInfo intentará tener acceso al
sistema de archivos para actualizar el valor de Length . Si el archivo ya no existe, se
obtendrá una excepción FileNotFoundException en la consulta, aunque no se esté
consultando el sistema de archivos directamente. Algunas consultas de esta sección
usan un método independiente que consume estas excepciones concretas en casos
determinados. Otra opción consiste en mantener actualizado el origen de datos de
manera dinámica mediante FileSystemWatcher.

Vea también
LINQ to Objects (C#)
Procedimiento para buscar archivos con
un nombre o atributo especificados (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo encontrar todos los archivos con una determinada
extensión de nombre de archivo (por ejemplo, ".txt") en un árbol de directorios
especificado. También se muestra cómo devolver el archivo más reciente o más antiguo
del árbol por fecha de creación.

Ejemplo
C#

class FindFileByExtension

// This query will produce the full path for all .txt files

// under the specified folder including subfolders.

// It orders the list according to the file name.

static void Main()

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\";

// Take a snapshot of the file system.

System.IO.DirectoryInfo dir = new

System.IO.DirectoryInfo(startFolder);

// This method assumes that the application has discovery

permissions

// for all folders under the specified path.

IEnumerable<System.IO.FileInfo> fileList = dir.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

//Create the query

IEnumerable<System.IO.FileInfo> fileQuery =

from file in fileList

where file.Extension == ".txt"

orderby file.Name

select file;

//Execute the query. This might write out a lot of files!

foreach (System.IO.FileInfo fi in fileQuery)

Console.WriteLine(fi.FullName);

// Create and execute a new query by using the previous

// query as a starting point. fileQuery is not

 // executed again until the call to Last()

var newestFile =

(from file in fileQuery

orderby file.CreationTime

select new { file.FullName, file.CreationTime })

.Last();

Console.WriteLine("\r\nThe newest .txt file is {0}. Creation time:

{1}",

newestFile.FullName, newestFile.CreationTime);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Procedimiento para agrupar archivos
por extensión (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En este ejemplo se muestra cómo se puede usar LINQ para efectuar operaciones
avanzadas de agrupación y ordenación en listas de archivos o de carpetas. También
muestra cómo paginar la salida en la ventana de consola mediante los métodos Skip y
Take.

Ejemplo
En la siguiente consulta se muestra cómo agrupar el contenido de un árbol de directorio
especificado por la extensión de nombre de archivo.

C#

class GroupByExtension

// This query will sort all the files under the specified folder

// and subfolder into groups keyed by the file extension.

private static void Main()

// Take a snapshot of the file system.

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\Common7";

// Used in WriteLine to trim output lines.

int trimLength = startFolder.Length;

// Take a snapshot of the file system.

System.IO.DirectoryInfo dir = new

System.IO.DirectoryInfo(startFolder);

// This method assumes that the application has discovery

permissions

// for all folders under the specified path.

IEnumerable<System.IO.FileInfo> fileList = dir.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

// Create the query.

var queryGroupByExt =

from file in fileList

group file by file.Extension.ToLower() into fileGroup

orderby fileGroup.Key

select fileGroup;

// Display one group at a time. If the number of

 // entries is greater than the number of lines

// in the console window, then page the output.

PageOutput(trimLength, queryGroupByExt);

// This method specifically handles group queries of FileInfo objects

with string keys.

// It can be modified to work for any long listings of data. Note that
explicit typing

// must be used in method signatures. The groupbyExtList parameter is a

query that produces

// groups of FileInfo objects with string keys.

private static void PageOutput(int rootLength,

IEnumerable<System.Linq.IGrouping<string, System.IO.FileInfo>>
groupByExtList)

// Flag to break out of paging loop.

bool goAgain = true;

// "3" = 1 line for extension + 1 for "Press any key" + 1 for input
cursor.

int numLines = Console.WindowHeight - 3;

// Iterate through the outer collection of groups.

foreach (var filegroup in groupByExtList)

// Start a new extension at the top of a page.

int currentLine = 0;

// Output only as many lines of the current group as will fit in

the window.

do

Console.Clear();

Console.WriteLine(filegroup.Key == String.Empty ? "[none]" :

filegroup.Key);

// Get 'numLines' number of items starting at number

'currentLine'.

var resultPage = filegroup.Skip(currentLine).Take(numLines);

//Execute the resultPage query

foreach (var f in resultPage)

Console.WriteLine("\t{0}",
f.FullName.Substring(rootLength));

// Increment the line counter.

currentLine += numLines;

// Give the user a chance to escape.

Console.WriteLine("Press any key to continue or the 'End'

key to break...");

 ConsoleKey key = Console.ReadKey().Key;

if (key == ConsoleKey.End)

goAgain = false;

break;

} while (currentLine < filegroup.Count());

if (goAgain == false)

break;

La salida de este programa puede ser larga, dependiendo de los detalles del sistema de
archivos local y de la configuración de startFolder . Para habilitar la visualización de
todos los resultados, en este ejemplo se muestra cómo paginar los resultados. Se
pueden aplicar las mismas técnicas a las aplicaciones web y Windows. Observe que,
como el código pagina los elementos en un grupo, se necesita un bucle foreach
anidado. También hay alguna lógica adicional para calcular la posición actual en la lista y
para permitir que el usuario detenga la paginación y salga del programa. En este caso
en concreto, la consulta de paginación se ejecuta en los resultados almacenados en
caché de la consulta original. En otros contextos, como en LINQ to SQL, este
almacenamiento en caché no es necesario.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Procedimiento para buscar el número
total de bytes de un conjunto de
carpetas (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo recuperar el número total de bytes usados por todos
los archivos en una carpeta especificada y en todas sus subcarpetas.

Ejemplo
El método Sum agrega los valores de todos los elementos seleccionados en la cláusula
select . Puede modificar fácilmente esta consulta para recuperar el archivo más grande

y más pequeño en el árbol de directorio especificado llamando al método Min o Max en

lugar de Sum.

C#

class QuerySize

public static void Main()

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\VC#";

// Take a snapshot of the file system.

// This method assumes that the application has discovery

permissions

// for all folders under the specified path.

IEnumerable<string> fileList =
System.IO.Directory.GetFiles(startFolder, "*.*",
System.IO.SearchOption.AllDirectories);

var fileQuery = from file in fileList

select GetFileLength(file);

// Cache the results to avoid multiple trips to the file system.

long[] fileLengths = fileQuery.ToArray();

// Return the size of the largest file

long largestFile = fileLengths.Max();

// Return the total number of bytes in all the files under the
specified folder.

long totalBytes = fileLengths.Sum();

Console.WriteLine("There are {0} bytes in {1} files under {2}",

 totalBytes, fileList.Count(), startFolder);

Console.WriteLine("The largest files is {0} bytes.", largestFile);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

// This method is used to swallow the possible exception

// that can be raised when accessing the System.IO.FileInfo.Length

property.

static long GetFileLength(string filename)

long retval;

try

System.IO.FileInfo fi = new System.IO.FileInfo(filename);

retval = fi.Length;
}

catch (System.IO.FileNotFoundException)

// If a file is no longer present,

// just add zero bytes to the total.

retval = 0;

return retval;

Si solo tiene que contar el número de bytes en un árbol de directorio especificado,

puede hacerlo de forma más eficaz sin crear una consulta LINQ, ya que conlleva la
sobrecarga de crear la colección de listas como un origen de datos. La utilidad del
enfoque de LINQ aumenta a medida que la consulta se vuelve más compleja, o cuando
se tienen que ejecutar varias consultas en el mismo origen de datos.

La consulta llama a un método independiente para obtener la longitud del archivo. Lo

hace para consumir la excepción que probablemente se producirá si el archivo se ha
eliminado en otro subproceso después de que se creara el objeto FileInfo en la llamada
a GetFiles . Aunque ya se haya creado el objeto FileInfo, puede producirse una
excepción porque un objeto FileInfo intentará actualizar su propiedad Length con la
longitud más actual la primera vez que se tenga acceso a la propiedad. Al incluir esta
operación en un bloque try-catch fuera de la consulta, el código sigue la regla de evitar
las operaciones en las consultas que pueden producir efectos secundarios. En general,
debe tener mucho cuidado al consumir excepciones para asegurarse de que no deja una
aplicación en un estado desconocido.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Procedimiento para comparar el
contenido de dos carpetas (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestran tres maneras de comparar dos listados de archivos:

Mediante la consulta de un valor booleano que especifica si las dos listas de

archivos son idénticas.

Mediante la consulta de la intersección para recuperar los archivos que están en

ambas carpetas.

Mediante la consulta de la diferencia de conjuntos para recuperar los archivos que

se encuentran en una carpeta, pero no en la otra.

７ Nota

Las técnicas que se mencionan aquí pueden adaptarse para comparar

secuencias de objetos de cualquier tipo.

La clase FileComparer que aparece a continuación muestra cómo usar una clase de
comparador personalizada junto con los operadores de consulta estándar. La clase no
está diseñada para su uso en escenarios reales. Simplemente usa el nombre y la
longitud en bytes de cada archivo para determinar si el contenido de cada una de las
carpetas es idéntico o no. En un escenario real, debería modificar este comparador para
realizar una comprobación de igualdad más rigurosa.

Ejemplo
C#

namespace QueryCompareTwoDirs

class CompareDirs
{

static void Main(string[] args)

// Create two identical or different temporary folders

// on a local drive and change these file paths.

string pathA = @"C:\TestDir";

 string pathB = @"C:\TestDir2";

System.IO.DirectoryInfo dir1 = new

System.IO.DirectoryInfo(pathA);
System.IO.DirectoryInfo dir2 = new
System.IO.DirectoryInfo(pathB);

// Take a snapshot of the file system.

IEnumerable<System.IO.FileInfo> list1 = dir1.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

IEnumerable<System.IO.FileInfo> list2 = dir2.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

//A custom file comparer defined below

FileCompare myFileCompare = new FileCompare();

// This query determines whether the two folders contain

// identical file lists, based on the custom file comparer

// that is defined in the FileCompare class.

// The query executes immediately because it returns a bool.

bool areIdentical = list1.SequenceEqual(list2, myFileCompare);

if (areIdentical == true)

Console.WriteLine("the two folders are the same");

else

Console.WriteLine("The two folders are not the same");

// Find the common files. It produces a sequence and doesn't

// execute until the foreach statement.

var queryCommonFiles = list1.Intersect(list2, myFileCompare);

if (queryCommonFiles.Any())

Console.WriteLine("The following files are in both

folders:");

foreach (var v in queryCommonFiles)

Console.WriteLine(v.FullName); //shows which items end

up in result list

else

Console.WriteLine("There are no common files in the two

folders.");

// Find the set difference between the two folders.

// For this example we only check one way.

var queryList1Only = (from file in list1

select file).Except(list2, myFileCompare);

Console.WriteLine("The following files are in list1 but not

list2:");

foreach (var v in queryList1Only)

Console.WriteLine(v.FullName);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

// This implementation defines a very simple comparison

// between two FileInfo objects. It only compares the name

// of the files being compared and their length in bytes.

class FileCompare :
System.Collections.Generic.IEqualityComparer<System.IO.FileInfo>

public FileCompare() { }

public bool Equals(System.IO.FileInfo f1, System.IO.FileInfo f2)

return (f1.Name == f2.Name &&

f1.Length == f2.Length);

// Return a hash that reflects the comparison criteria. According to

the

// rules for IEqualityComparer<T>, if Equals is true, then the hash

codes must

// also be equal. Because equality as defined here is a simple value

equality, not

// reference identity, it is possible that two or more objects will

produce the same

// hash code.

public int GetHashCode(System.IO.FileInfo fi)

string s = $"{fi.Name}{fi.Length}";

return s.GetHashCode();

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.
Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Procedimiento para buscar el archivo o
archivos de mayor tamaño en un árbol
de directorios (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En este ejemplo se muestran cinco consultas relacionadas con el tamaño de archivo en

bytes:

Cómo recuperar el tamaño en bytes del archivo más grande.

Cómo recuperar el tamaño en bytes del archivo más pequeño.

Cómo recuperar el archivo de mayor o menor tamaño del objeto FileInfo de una o
más carpetas en una carpeta raíz especificada.

Cómo recuperar una secuencia, como los 10 archivos de mayor tamaño.

Cómo ordenar los archivos en grupos según su tamaño en bytes, sin incluir los
archivos inferiores a un tamaño especificado.

Ejemplo
El ejemplo siguiente contiene cinco consultas independientes que muestran cómo
consultar y agrupar archivos, en función de su tamaño en bytes. Puede modificar
fácilmente estos ejemplos para basar la consulta en otra propiedad del objeto FileInfo.

C#

class QueryBySize

static void Main(string[] args)

QueryFilesBySize();

Console.WriteLine("Press any key to exit");

Console.ReadKey();

private static void QueryFilesBySize()

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\";

// Take a snapshot of the file system.

System.IO.DirectoryInfo dir = new

System.IO.DirectoryInfo(startFolder);

// This method assumes that the application has discovery

permissions

// for all folders under the specified path.

IEnumerable<System.IO.FileInfo> fileList = dir.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

//Return the size of the largest file

long maxSize =

(from file in fileList

let len = GetFileLength(file)

select len)

.Max();

Console.WriteLine("The length of the largest file under {0} is {1}",

startFolder, maxSize);

// Return the FileInfo object for the largest file

// by sorting and selecting from beginning of list

System.IO.FileInfo longestFile =

(from file in fileList

let len = GetFileLength(file)

where len > 0

orderby len descending

select file)

.First();

Console.WriteLine("The largest file under {0} is {1} with a length

of {2} bytes",

startFolder, longestFile.FullName,
longestFile.Length);

//Return the FileInfo of the smallest file

System.IO.FileInfo smallestFile =

(from file in fileList

let len = GetFileLength(file)

where len > 0

orderby len ascending

select file).First();

Console.WriteLine("The smallest file under {0} is {1} with a length

of {2} bytes",

startFolder, smallestFile.FullName,
smallestFile.Length);

//Return the FileInfos for the 10 largest files

// queryTenLargest is an IEnumerable<System.IO.FileInfo>

var queryTenLargest =

(from file in fileList

let len = GetFileLength(file)

orderby len descending

select file).Take(10);

Console.WriteLine("The 10 largest files under {0} are:",

 startFolder);

foreach (var v in queryTenLargest)

Console.WriteLine("{0}: {1} bytes", v.FullName, v.Length);

// Group the files according to their size, leaving out

// files that are less than 200000 bytes.

var querySizeGroups =

from file in fileList

let len = GetFileLength(file)

where len > 0

group file by (len / 100000) into fileGroup

where fileGroup.Key >= 2

orderby fileGroup.Key descending

select fileGroup;

foreach (var filegroup in querySizeGroups)

Console.WriteLine(filegroup.Key.ToString() + "00000");

foreach (var item in filegroup)

Console.WriteLine("\t{0}: {1}", item.Name, item.Length);

// This method is used to swallow the possible exception

// that can be raised when accessing the FileInfo.Length property.

// In this particular case, it is safe to swallow the exception.

static long GetFileLength(System.IO.FileInfo fi)

long retval;

try

retval = fi.Length;
}

catch (System.IO.FileNotFoundException)

// If a file is no longer present,

// just add zero bytes to the total.

retval = 0;

return retval;

Para devolver uno o más objetos FileInfo completos, la consulta debe examinar cada
uno de ellos en los datos de origen y, después, ordenarlos por el valor de su propiedad
Length. Después, puede devolver el objeto único o la secuencia con la mayor longitud.
Use First para devolver el primer elemento de una lista. Use Take para devolver el primer
número n de elementos. Especifique un criterio de ordenación descendente para
colocar los elementos más pequeños al principio de la lista.

La consulta llama a un método independiente para obtener el tamaño del archivo en

bytes para consumir la posible excepción que se generará en el caso de que se haya
eliminado un archivo en otro subproceso en el período de tiempo desde que se ha
creado el objeto FileInfo en la llamada a GetFiles . Aunque ya se haya creado el objeto
FileInfo, puede producirse una excepción porque un objeto FileInfo intentará actualizar
su propiedad Length con el tamaño más actual la primera vez que se tenga acceso a la
propiedad. Al incluir esta operación en un bloque try-catch fuera de la consulta,
seguimos la regla de evitar las operaciones en las consultas que pueden producir
efectos secundarios. En general, debe tener mucho cuidado al consumir excepciones
para asegurarse de que no deja una aplicación en un estado desconocido.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Procedimiento para buscar archivos
duplicados en un árbol de directorios
(LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

A veces, los archivos que tienen el mismo nombre pueden estar en más de una carpeta.
Por ejemplo, en la carpeta de instalación de Visual Studio, hay varias carpetas que tienen
un archivo readme.htm. En este ejemplo se muestra cómo buscar estos nombres de
archivos duplicados en una carpeta raíz especificada. En el segundo ejemplo se muestra
cómo buscar archivos cuyo tamaño y fecha de LastWrite también coinciden.

Ejemplo
C#

class QueryDuplicateFileNames

static void Main(string[] args)

// Uncomment QueryDuplicates2 to run that query.

QueryDuplicates();

// QueryDuplicates2();

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

static void QueryDuplicates()

// Change the root drive or folder if necessary

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\";

// Take a snapshot of the file system.

System.IO.DirectoryInfo dir = new

System.IO.DirectoryInfo(startFolder);

// This method assumes that the application has discovery

permissions

// for all folders under the specified path.

IEnumerable<System.IO.FileInfo> fileList = dir.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

// used in WriteLine to keep the lines shorter

int charsToSkip = startFolder.Length;

// var can be used for convenience with groups.

var queryDupNames =

from file in fileList

group file.FullName.Substring(charsToSkip) by file.Name into

fileGroup

where fileGroup.Count() > 1

select fileGroup;

// Pass the query to a method that will

// output one page at a time.

PageOutput<string, string>(queryDupNames);

// A Group key that can be passed to a separate method.

// Override Equals and GetHashCode to define equality for the key.

// Override ToString to provide a friendly name for Key.ToString()

class PortableKey
{

public string Name { get; set; }

public DateTime LastWriteTime { get; set; }

public long Length { get; set; }

public override bool Equals(object obj)

PortableKey other = (PortableKey)obj;

return other.LastWriteTime == this.LastWriteTime &&

other.Length == this.Length &&

other.Name == this.Name;

public override int GetHashCode()

string str = $"{this.LastWriteTime}{this.Length}{this.Name}";

return str.GetHashCode();

public override string ToString()

return $"{this.Name} {this.Length} {this.LastWriteTime}";

static void QueryDuplicates2()

// Change the root drive or folder if necessary.

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\Common7";

// Make the lines shorter for the console display

int charsToSkip = startFolder.Length;

// Take a snapshot of the file system.

System.IO.DirectoryInfo dir = new

System.IO.DirectoryInfo(startFolder);

IEnumerable<System.IO.FileInfo> fileList = dir.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

// Note the use of a compound key. Files that match

// all three properties belong to the same group.

// A named type is used to enable the query to be

// passed to another method. Anonymous types can also be used

// for composite keys but cannot be passed across method boundaries

//

var queryDupFiles =

from file in fileList

group file.FullName.Substring(charsToSkip) by

new PortableKey { Name = file.Name, LastWriteTime =

file.LastWriteTime, Length = file.Length } into fileGroup

where fileGroup.Count() > 1

select fileGroup;

var list = queryDupFiles.ToList();

int i = queryDupFiles.Count();

PageOutput<PortableKey, string>(queryDupFiles);

// A generic method to page the output of the QueryDuplications methods

// Here the type of the group must be specified explicitly. "var" cannot

// be used in method signatures. This method does not display more than
one

// group per page.

private static void PageOutput<K, V>

(IEnumerable<System.Linq.IGrouping<K, V>> groupByExtList)

// Flag to break out of paging loop.

bool goAgain = true;

// "3" = 1 line for extension + 1 for "Press any key" + 1 for input
cursor.

int numLines = Console.WindowHeight - 3;

// Iterate through the outer collection of groups.

foreach (var filegroup in groupByExtList)

// Start a new extension at the top of a page.

int currentLine = 0;

// Output only as many lines of the current group as will fit in

the window.

do

Console.Clear();

Console.WriteLine("Filename = {0}", filegroup.Key.ToString()

== String.Empty ? "[none]" : filegroup.Key.ToString());

// Get 'numLines' number of items starting at number

'currentLine'.

var resultPage = filegroup.Skip(currentLine).Take(numLines);

 //Execute the resultPage query

foreach (var fileName in resultPage)

Console.WriteLine("\t{0}", fileName);

// Increment the line counter.

currentLine += numLines;

// Give the user a chance to escape.

Console.WriteLine("Press any key to continue or the 'End'

key to break...");

ConsoleKey key = Console.ReadKey().Key;

if (key == ConsoleKey.End)

goAgain = false;

break;

} while (currentLine < filegroup.Count());

if (goAgain == false)

break;

En la primera consulta se usa una clave simple para determinar una coincidencia; se
buscan archivos que tengan el mismo nombre, pero cuyo contenido podría ser
diferente. En la segunda consulta se usa una clave compuesta para coincidir con tres
propiedades del objeto FileInfo. En esta consulta es mucho más probable que se
encuentren archivos que tienen el mismo nombre y un contenido similar o idéntico.

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Vea también
LINQ to Objects (C#)
LINQ y directorios de archivos (C#)
Procedimiento para consultar el
contenido de los archivos de texto de
una carpeta (LINQ) (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo consultar todos los archivos en un árbol de

directorios especificado, abrir cada archivo e inspeccionar su contenido. Este tipo de
técnica puede usarse para crear índices o índices inversos del contenido de un árbol de
directorios. En este ejemplo, se realiza una búsqueda de cadena simple. Pero los tipos
más complejos de coincidencia de patrones se pueden realizar con una expresión
regular. Para obtener más información, vea Procedimiento para combinar consultas
LINQ con expresiones regulares (C#).

Ejemplo
C#

class QueryContents

public static void Main()

// Modify this path as necessary.

string startFolder = @"c:\program files\Microsoft Visual Studio

9.0\";

// Take a snapshot of the file system.

System.IO.DirectoryInfo dir = new

System.IO.DirectoryInfo(startFolder);

// This method assumes that the application has discovery

permissions

// for all folders under the specified path.

IEnumerable<System.IO.FileInfo> fileList = dir.GetFiles("*.*",

System.IO.SearchOption.AllDirectories);

string searchTerm = @"Visual Studio";

// Search the contents of each file.

// A regular expression created with the RegEx class

// could be used instead of the Contains method.

// queryMatchingFiles is an IEnumerable<string>.

var queryMatchingFiles =

from file in fileList

where file.Extension == ".htm"

let fileText = GetFileText(file.FullName)

 where fileText.Contains(searchTerm)

select file.FullName;

// Execute the query.

Console.WriteLine("The term \"{0}\" was found in:", searchTerm);

foreach (string filename in queryMatchingFiles)

Console.WriteLine(filename);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit");

Console.ReadKey();

// Read the contents of the file.

static string GetFileText(string name)

string fileContents = String.Empty;

// If the file has been deleted since we took

// the snapshot, ignore it and return the empty string.

if (System.IO.File.Exists(name))

fileContents = System.IO.File.ReadAllText(name);

return fileContents;

Compilar el código
Cree un proyecto de aplicación de consola de C# con directivas using para los espacios
de nombres System.Linq y System.IO.

Consulte también
LINQ y directorios de archivos (C#)
LINQ to Objects (C#)
Procedimiento para consultar un objeto
ArrayList con LINQ (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Cuando use LINQ para consultar colecciones no genéricas IEnumerable como ArrayList,
debe declarar explícitamente el tipo de variable de rango para reflejar el tipo específico
de los objetos de la colección. Por ejemplo, si tiene una ArrayList de objetos Student , la
cláusula from debe tener un aspecto similar a este:

C#

var query = from Student s in arrList

//...

Al especificar el tipo de la variable de rango, se convierte cada elemento de la ArrayList

en un Student .

El uso de una variable de rango con tipo explícito en una expresión de consulta es
equivalente a llamar al método Cast. Cast genera una excepción si la conversión
especificada no puede realizarse. Cast y OfType son los dos métodos de operador de
consulta estándar que funcionan en tipos IEnumerable no genéricos. Para obtener más
información, vea Relaciones entre tipos en operaciones de consulta LINQ.

Ejemplo
En el siguiente ejemplo se muestra una consulta simple sobre un ArrayList. Tenga en
cuenta que en este ejemplo se usan inicializadores de objeto cuando el código llama al
método Add, pero esto no es un requisito.

C#

using System;

using System.Collections;

using System.Linq;

namespace NonGenericLINQ

public class Student

public string FirstName { get; set; }

public string LastName { get; set; }

public int[] Scores { get; set; }

class Program

static void Main(string[] args)

ArrayList arrList = new ArrayList();

arrList.Add(

new Student

FirstName = "Svetlana", LastName = "Omelchenko",

Scores = new int[] { 98, 92, 81, 60 }

});

arrList.Add(

new Student

FirstName = "Claire", LastName = "O’Donnell", Scores

= new int[] { 75, 84, 91, 39 }

});

arrList.Add(

new Student

FirstName = "Sven", LastName = "Mortensen", Scores =

new int[] { 88, 94, 65, 91 }

});

arrList.Add(

new Student

FirstName = "Cesar", LastName = "Garcia", Scores =

new int[] { 97, 89, 85, 82 }

});

var query = from Student student in arrList

where student.Scores[0] > 95

select student;

foreach (Student s in query)

Console.WriteLine(s.LastName + ": " + s.Scores[0]);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Omelchenko: 98

Garcia: 97

*/

Vea también
LINQ to Objects (C#)
Procedimiento para agregar métodos
personalizados para las consultas LINQ
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Para extender el conjunto de métodos que usa para consultas LINQ, agregue métodos
de extensión a la interfaz IEnumerable<T>. Por ejemplo, además de las operaciones
habituales de promedio o de máximo, puede crear un método de agregación
personalizado para calcular un solo valor a partir de una secuencia de valores. También
puede crear un método que funcione como un filtro personalizado o como una
transformación de datos específica para una secuencia de valores y que devuelva una
nueva secuencia. Ejemplos de dichos métodos son Distinct, Skip y Reverse.

Si extiende la interfaz IEnumerable<T>, puede aplicar los métodos personalizados a

cualquier colección enumerable. Para obtener más información, vea Métodos de
extensión.

Adición de un método de agregación

Un método de agregación calcula un valor único a partir de un conjunto de valores.
LINQ proporciona varios métodos de agregación, incluidos Average, Min y Max. Si
quiere crear su propio método de agregación, agregue un método de extensión a la
interfaz IEnumerable<T>.

En el ejemplo de código siguiente se muestra cómo crear un método de extensión

denominado Median para calcular la mediana de una secuencia de números de tipo
double .

C#

public static class EnumerableExtension

public static double Median(this IEnumerable<double>? source)

if (source is null || !source.Any())

throw new InvalidOperationException("Cannot compute median for a

null or empty set.");

var sortedList =

source.OrderBy(number => number).ToList();

 int itemIndex = sortedList.Count / 2;

if (sortedList.Count % 2 == 0)

// Even number of items.

return (sortedList[itemIndex] + sortedList[itemIndex - 1]) / 2;

else

// Odd number of items.

return sortedList[itemIndex];

Puede llamar a este método de extensión para cualquier colección enumerable de la

misma manera en la que llamaría a otros métodos de agregación desde la interfaz
IEnumerable<T>.

En el ejemplo de código siguiente se muestra cómo usar el método Median para una
matriz de tipo double .

C#

double[] numbers = { 1.9, 2, 8, 4, 5.7, 6, 7.2, 0 };

var query = numbers.Median();

Console.WriteLine($"double: Median = {query}");

// This code produces the following output:

// double: Median = 4.85

Sobrecarga de un método de agregado para aceptar

varios tipos
Puede sobrecargar el método de agregación para que acepte secuencias de varios tipos.
El enfoque estándar consiste en crear una sobrecarga para cada tipo. Otro enfoque
consiste en crear una sobrecarga que tome un tipo genérico y lo convierta a un tipo
específico mediante un delegado. También puede combinar ambos enfoques.

Creación de una sobrecarga para cada tipo

Puede crear una sobrecarga específica para cada tipo que desee admitir. En el siguiente
ejemplo de código se muestra una sobrecarga del método Median para el tipo int .
 C#

// int overload

public static double Median(this IEnumerable<int> source) =>

(from number in source select (double)number).Median();

Ahora puede llamar a las sobrecargas Median para los tipos integer y double , como se
muestra en el código siguiente:

C#

double[] numbers1 = { 1.9, 2, 8, 4, 5.7, 6, 7.2, 0 };

var query1 = numbers1.Median();

Console.WriteLine($"double: Median = {query1}");

int[] numbers2 = { 1, 2, 3, 4, 5 };

var query2 = numbers2.Median();

Console.WriteLine($"int: Median = {query2}");

// This code produces the following output:

// double: Median = 4.85

// int: Median = 3

Creación de una sobrecarga genérica

También puede crear una sobrecarga que acepte una secuencia de objetos genéricos.
Esta sobrecarga toma un delegado como parámetro y lo usa para convertir una
secuencia de objetos de un tipo genérico a un tipo específico.

En el código siguiente se muestra una sobrecarga del método Median que toma el
delegado Func<T,TResult> como parámetro. Este delegado toma un objeto del tipo
genérico T y devuelve un objeto de tipo double .

C#

// generic overload

public static double Median<T>(

this IEnumerable<T> numbers, Func<T, double> selector) =>

(from num in numbers select selector(num)).Median();

Ahora puede llamar al método Median para una secuencia de objetos de cualquier tipo.
Si el tipo no tiene su propia sobrecarga de métodos, deberá pasar un parámetro de
delegado. En C# puede usar una expresión lambda para este propósito. Además, solo
en Visual Basic, si usa la cláusula Aggregate o Group By en lugar de la llamada al
método, puede pasar cualquier valor o expresión que esté en el ámbito de esta cláusula.

En el ejemplo de código siguiente se muestra cómo llamar al método Median para una
matriz de enteros y una matriz de cadenas. Para las cadenas, se calcula la mediana de las
longitudes de las cadenas de la matriz. En el ejemplo se muestra cómo pasar el
parámetro del delegado Func<T,TResult> al método Median para cada caso.

C#

int[] numbers3 = { 1, 2, 3, 4, 5 };

/*

You can use the num => num lambda expression as a parameter for the
Median method

so that the compiler will implicitly convert its value to double.

If there is no implicit conversion, the compiler will display an error

message.

*/

var query3 = numbers3.Median(num => num);

Console.WriteLine($"int: Median = {query3}");

string[] numbers4 = { "one", "two", "three", "four", "five" };

// With the generic overload, you can also use numeric properties of
objects.

var query4 = numbers4.Median(str => str.Length);

Console.WriteLine($"string: Median = {query4}");

// This code produces the following output:

// int: Median = 3

// string: Median = 4

Adición de un método que devuelva una

secuencia
Puede extender la interfaz IEnumerable<T> con un método de consulta personalizado
que devuelve una secuencia de valores. En este caso, el método debe devolver una
colección de tipo IEnumerable<T>. Estos métodos se pueden usar para aplicar filtros o
transformaciones de datos a una secuencia de valores.

En el ejemplo siguiente se muestra cómo crear un método de extensión denominado

AlternateElements que devuelve los demás elementos de una colección, empezando

por el primer elemento.

 C#

// Extension method for the IEnumerable<T> interface.

// The method returns every other element of a sequence.

public static IEnumerable<T> AlternateElements<T>(this IEnumerable<T>

source)

int index = 0;

foreach (T element in source)

if (index % 2 == 0)

yield return element;

index++;

Puede llamar a este método de extensión para cualquier colección enumerable de la

misma manera en la que llamaría a otros métodos desde la interfaz IEnumerable<T>,
como se muestra en el siguiente código:

C#

string[] strings = { "a", "b", "c", "d", "e" };

var query5 = strings.AlternateElements();

foreach (var element in query5)

Console.WriteLine(element);

// This code produces the following output:

// a

// c

// e

Consulte también
IEnumerable<T>
Métodos de extensión
LINQ to ADO.NET (Página de portal)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

LINQ to ADO.NET permite consultar sobre cualquier objeto enumerable de ADO.NET

mediante el modelo de programación de Language Integrated Query (LINQ).

７ Nota

La documentación de LINQ to ADO.NET se encuentra en la sección ADO.NET del

SDK de .NET Framework: LINQ y ADO.NET.

Hay tres tecnologías independientes de Language Integrated Query (LINQ) para

ADO.NET: LINQ to DataSet, LINQ to SQL y LINQ to Entities. LINQ to DataSet proporciona
consultas más ricas y optimizadas en DataSet, LINQ to SQL permite consultar
directamente los esquemas de bases de datos de SQL Server y LINQ to Entities permite
consultar un Entity Data Model.

LINQ to DataSet
DataSet es uno de los componentes más usados de ADO.NET, además de un elemento
clave del modelo de programación desconectado en el que se basa ADO.NET. En
cambio, a pesar de su importancia, DataSet tiene funciones de consulta limitadas.

LINQ to DataSet permite compilar capacidades de consulta más complejas en DataSet

mediante la misma funcionalidad de consulta disponible para muchos otros orígenes de
datos.

Para más información, vea LINQ to DataSet.

LINQ to SQL
LINQ to SQL proporciona una infraestructura en tiempo de ejecución para administrar
los datos relacionales como objetos. En LINQ to SQL, el modelo de datos de una base
de datos relacional se asigna a un modelo de objetos expresado en el lenguaje de
programación del programador. Cuando se ejecuta la aplicación, LINQ to SQL convierte
a SQL las consultas integradas en el lenguaje, en el modelo de objetos, y las envía a la
base de datos para su ejecución. Cuando la base de datos devuelve los resultados, LINQ
to SQL los vuelve a convertir en objetos que se pueden manipular.
LINQ to SQL incluye compatibilidad con los procedimientos almacenados y las
funciones definidas por el usuario que están en la base de datos, además de con la
herencia en el modelo de objetos.

Para más información, vea LINQ to SQL.

LINQ to Entities
A través del modelo Entity Data Model, los datos relacionales se exponen como objetos
en el entorno .NET. Esto hace de la capa de objetos un objetivo idóneo para la
compatibilidad con LINQ, ya que permite a los programadores formular consultas en la
base de datos con el lenguaje usado para compilar la lógica empresarial. Esta
funcionalidad se conoce como LINQ to Entities. Para más información, vea LINQ to
Entities.

Consulte también
LINQ y ADO.NET
Language Integrated Query (LINQ) (C#)
Habilitar un origen de datos para
realizar consultas LINQ
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Hay varias maneras de extender LINQ para permitir consultar cualquier origen de datos
en el modelo LINQ El origen de datos podría ser una estructura de datos, un servicio
Web, un sistema de archivos o una base de datos, por nombrar algunos. El modelo LINQ
facilita a los clientes las consultas a un origen de datos para el que las consultas LINQ
están habilitadas, ya que la sintaxis y el modelo de consulta no cambian. Las maneras en
las que LINQ se puede extender a estos orígenes de datos son las siguientes:

Implementar la interfaz IEnumerable<T> en un tipo para habilitar las consultas de

LINQ to Objects para ese tipo.

Crear métodos de operador de consulta estándar como Where y Select que

extienden un tipo para habilitar las consultas personalizadas LINQ para ese tipo.

Crear un proveedor para el origen de datos que implementa la interfaz

IQueryable<T>. Un proveedor que implementa esta interfaz recibe consultas LINQ
en forma de árboles de expresión, que puede ejecutar de una manera
personalizada, por ejemplo, remotamente.

Crear un proveedor para el origen de datos que aproveche una tecnología de

LINQ existente. Este tipo de proveedor permitiría no sólo las consultas, sino
también las operaciones de inserción, actualización y eliminación, así como la
asignación para tipos definidos por el usuario.

En este tema se analizan estas opciones.

Cómo habilitar las consultas LINQ de un origen

de datos

Datos en memoria
Hay dos maneras de habilitar las consultas LINQ para datos en memoria. Si los datos
son de un tipo que implementa IEnumerable<T>, puede consultar los datos utilizando
LINQ to Objects. Si no tiene sentido habilitar la enumeración de su tipo implementando
la interfaz IEnumerable<T>, puede definir métodos de operador de consulta estándar
de LINQ en ese tipo o crear métodos de operador de consulta estándar de LINQ que
extiendan el tipo. Las implementaciones personalizadas de los operadores de consulta
estándar deberían utilizar ejecución diferida para devolver los resultados.

Datos remotos
La mejor opción para permitir las consultas LINQ para un origen de datos remoto
consiste en implementar la interfaz IQueryable<T>. Sin embargo, esto difiere de
extender un proveedor como LINQ to SQL para un origen de datos.

Proveedores LINQ de IQueryable

Los proveedores de LINQ que implementan IQueryable<T> pueden variar ampliamente
en su complejidad. En esta sección se analizan los diferentes niveles de complejidad.

Un proveedor de IQueryable menos complejo podría interactuar con un solo método

de un servicio Web. Este tipo de proveedor es muy específico, ya que espera
información específica en las consultas que administra. Posee un sistema de tipos
cerrado, y expone quizá un único tipo de resultado. La mayor parte de la ejecución de la
consulta ocurre localmente, por ejemplo, utilizando las implementaciones Enumerable
de los operadores de consulta estándar. Un proveedor menos complejo podría examinar
sólo una expresión de llamada a método en el árbol de expresión que representa la
consulta, y dejaría que la lógica restante de la consulta se procesara en otra parte.

Un proveedor IQueryable de complejidad media podría destinarse a un origen de datos

que tuviera un lenguaje de consulta parcialmente expresivo. Si se destina a un servicio
Web, podría comunicarse con más de un método del servicio Web y seleccionar el
método que va a llamar en función de la pregunta que plantea la consulta. Un
proveedor de complejidad media tendría un sistema de tipos más amplio que un
proveedor simple, pero todavía sería un sistema de tipos fijo. Por ejemplo, el proveedor
podría exponer tipos que tienen relaciones uno a varios y que se pueden recorrer, pero
no proporcionaría tecnología de asignación para tipos definidos por el usuario.

Un proveedor IQueryable complejo, como el proveedor LINQ to SQL, podría convertir

consultas LINQ completas a un lenguaje de consulta expresivo, como SQL. Un
proveedor complejo es más general que un proveedor menos complejo, porque puede
controlar una gran variedad de preguntas en la consulta. También posee un sistema de
tipos abierto y, por tanto, debe contener una amplia infraestructura para utilizar tipos
definidos por el usuario. El desarrollo de un proveedor complejo requiere un esfuerzo
significativo.
Consulte también
IQueryable<T>
IEnumerable<T>
Enumerable
Información general sobre operadores de consulta estándar (C#)
LINQ to Objects (C#)
Compatibilidad del IDE y las
herramientas de Visual Studio con LINQ
(C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El entorno de desarrollo integrado (IDE) de Visual Studio proporciona las siguientes

características que admiten el desarrollo de aplicaciones de LINQ:

Object Relational Designer

Object Relational Designer es una herramienta de diseño visual que puede usar en
aplicaciones de LINQ to SQL para generar clases en C# que representan los datos
relacionales en una base de datos subyacente. Para obtener más información, vea LINQ
to SQL Tools en Visual Studio.

Herramienta de línea de comandos SQLMetal

SQLMetal es una herramienta de línea de comandos que puede usarse en procesos de
compilación para generar clases de bases de datos existentes para su uso en
aplicaciones de LINQ to SQL. Para obtener más información, vea SqlMetal.exe
(Herramienta de generación de código).

Editor de código compatible con LINQ

El editor de código de C# admite LINQ de manera extensiva con IntelliSense y las
funciones de formato.

Compatibilidad con el depurador de Visual

Studio
El depurador de Visual Studio admite la depuración de expresiones de consulta. Para
obtener más información, vea Depurar LINQ.

Vea también
Language Integrated Query (LINQ) (C#)
Reflexión (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La reflexión proporciona objetos (de tipo Type) que describen los ensamblados,
módulos y tipos. Puede usar la reflexión para crear dinámicamente una instancia de un
tipo, enlazar el tipo a un objeto existente u obtener el tipo desde un objeto existente e
invocar sus métodos, o acceder a sus campos y propiedades. Si usa atributos en el
código, la reflexión le permite acceder a ellos. Para obtener más información, consulte
Attributes (Atributos).

Este es un ejemplo simple de reflexión que usa el método GetType(), heredado por
todos los tipos de la clase base Object , para obtener el tipo de una variable:

７ Nota

Asegúrese de agregar using System; y using System.Reflection; en la parte

superior del archivo de .cs.

C#

// Using GetType to obtain type information:

int i = 42;

Type type = i.GetType();

Console.WriteLine(type);

El resultado es System.Int32 .

En el ejemplo siguiente se usa la reflexión para obtener el nombre completo del

ensamblado cargado.

C#

// Using Reflection to get information of an Assembly:

Assembly info = typeof(int).Assembly;

Console.WriteLine(info);

El resultado es System.Private.CoreLib, Version=4.0.0.0, Culture=neutral,

PublicKeyToken=7cec85d7bea7798e .

７ Nota
 Las palabras clave de C# protected y internal no tienen ningún significado en
lenguaje intermedio (IL) y no se usan en las API de reflexión. Los términos
correspondientes en IL son Family y Assembly. Para identificar un método internal
con la reflexión, use la propiedad IsAssembly. Para identificar un método protected
internal , use IsFamilyOrAssembly.

Información general de la reflexión

La reflexión resulta útil en las siguientes situaciones:

Cuando tenga que acceder a atributos en los metadatos del programa. Para
obtener más información, consulte Recuperar información almacenada en
atributos.
Para examinar y crear instancias de tipos en un ensamblado.
Para generar nuevos tipos en tiempo de ejecución. Usar clases en
System.Reflection.Emit.
Para llevar a cabo métodos de acceso de enlace en tiempo de ejecución en tipos
creados en tiempo de ejecución. Consulte el tema Cargar y utilizar tipos
dinámicamente.

Secciones relacionadas
Para obtener más información:

Reflexión
Ver información tipos
Reflexión y tipos genéricos
System.Reflection.Emit
Recuperar la información almacenada en atributos

Consulte también
Guía de programación de C#
Ensamblados de .NET
Serialización (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

La serialización es el proceso de convertir un objeto en una secuencia de bytes para

almacenarlo o transmitirlo a la memoria, a una base de datos o a un archivo. Su
propósito principal es guardar el estado de un objeto para poder volver a crearlo
cuando sea necesario. El proceso inverso se denomina deserialización.

Funcionamiento de la serialización
En esta ilustración se muestra el proceso general de la serialización:

El objeto se serializa en una secuencia que incluye los datos. La secuencia también
puede tener información sobre el tipo del objeto, como la versión, la referencia cultural
y el nombre del ensamblado. A partir de esa secuencia, el objeto se puede almacenar en
una base de datos, en un archivo o en memoria.

Usos de la serialización
La serialización permite al desarrollador guardar el estado de un objeto y volver a
crearlo según sea necesario, ya que proporciona almacenamiento de los objetos e
intercambio de datos. A través de la serialización, un desarrollador puede realizar
acciones como las siguientes:

Enviar el objeto a una aplicación remota mediante un servicio web

Pasar un objeto de un dominio a otro
Pasar un objeto a través de un firewall como una cadena JSON o XML
Mantener la seguridad o información específica del usuario entre aplicaciones

Serialización de JSON
El espacio de nombres System.Text.Json contiene clases para la serialización y
deserialización de notación de objetos JavaScript (JSON). JSON es un estándar abierto
que se usa normalmente para compartir datos en la web.

La serialización de JSON serializa las propiedades públicas de un objeto en una cadena,

una matriz de bytes o una secuencia que se ajusta a la especificación de JSON
RFC 8259 . Para controlar la forma en que JsonSerializer serializa o deserializa una
instancia de la clase:

Use un objeto JsonSerializerOptions.

Aplique atributos del espacio de nombres System.Text.Json.Serialization a clases o
propiedades.
Implemente convertidores personalizados.

Serialización XML y binaria

El espacio de nombres System.Runtime.Serialization contiene clases para la serialización
y deserialización binaria y XML.

La serialización binaria utiliza la codificación binaria para generar una serialización

compacta para usos como almacenamiento o secuencias de red basadas en socket. En la
serialización binaria se serializan todos los miembros, incluso aquellos que son de solo
lectura, y mejora el rendimiento.

２ Advertencia

La serialización binaria puede ser peligrosa. Para más información, consulte Guía de
seguridad de BinaryFormatter.

La serialización XML serializa las propiedades y los campos públicos de un objeto o los
parámetros y valores devueltos de los métodos en una secuencia XML que se ajusta a
un documento específico del lenguaje de definición de esquema XML (XSD). La
serialización XML produce clases fuertemente tipadas cuyas propiedades y campos
públicos se convierten a XML. System.Xml.Serialization contiene clases para serializar y
deserializar XML. Se aplican atributos a clases y a miembros de clase para controlar la
forma en que XmlSerializer serializa o deserializa una instancia de la clase.

Conversión de un objeto en serializable

Para la serialización binaria o XML, necesita lo siguiente:
 Objeto que se va a serializar
Secuencia para incluir el objeto serializado
Instancia de System.Runtime.Serialization.Formatter

Aplique el atributo SerializableAttribute a un tipo para indicar que se pueden serializar

instancias de este tipo. Si se intenta serializar, pero el tipo no tiene el atributo
SerializableAttribute, se produce una excepción.

Para evitar que un campo se serialice, aplique el atributo NonSerializedAttribute. Si un

campo de un tipo serializable contiene un puntero, un controlador o alguna otra
estructura de datos específica para un entorno concreto y el campo no se puede
reconstituir correctamente en un entorno diferente, puede convertirlo en no serializable.

Si una clase serializada contiene referencias a objetos de otras clases marcadas como
SerializableAttribute, esos objetos también se serializarán.

Serialización básica y personalizada

La serialización binaria y XML se puede realizar de dos formas: de manera básica y
personalizada.

La serialización básica utiliza .NET para serializar automáticamente el objeto. El único

requisito es que la clase tenga el atributo SerializableAttribute aplicado.
NonSerializedAttribute puede usarse para impedir la serialización de campos
específicos.

Cuando se usa la serialización básica, el control de versiones de objetos puede causar

problemas. Use la serialización personalizada si los problemas de control de versiones
son importantes. La serialización básica es la manera más fácil de realizar la serialización,
pero no proporciona mucho control sobre el proceso.

En la serialización personalizada, puede especificar exactamente qué objetos se

serializarán y cómo se llevará a cabo la serialización. La clase debe marcarse como
SerializableAttribute e implementar la interfaz ISerializable. Si quiere que el objeto
también se deserialice de forma personalizada, use un constructor personalizado.

Serialización de diseñador
La serialización de diseñador es una forma especial de serialización que conlleva el tipo
de persistencia de objeto asociado a las herramientas de desarrollo. La serialización de
diseñador es un proceso que consiste en convertir un gráfico de objetos en un archivo
de código fuente que puede utilizarse posteriormente para recuperar el gráfico de
objetos. Un archivo de código fuente puede contener código, marcado o incluso
información de la tabla SQL.

Temas relacionados y ejemplos

En Información general de System.Text.Json se muestra cómo obtener la biblioteca
System.Text.Json .

En Procedimiento para serializar y deserializar JSON en .NET

se muestra cómo leer y
escribir datos de objetos a y desde JSON mediante la clase JsonSerializer.

Tutorial: Conservar un objeto en Visual Studio (C#)

Se explica cómo se puede usar la serialización para conservar los datos de un objeto
entre instancias, lo que le permite almacenar valores y recuperarlos la próxima vez que
se cree una instancia del objeto.

Procedimiento para leer datos de objeto de un archivo XML (C#)

Se muestra cómo leer los datos de objetos que se han escrito anteriormente en un
archivo XML con la clase XmlSerializer.

Procedimiento para escribir datos de objeto en un archivo XML (C#)

Se muestra cómo escribir el objeto de una clase en un archivo XML con la clase
XmlSerializer.
Procedimiento para escribir datos de
objeto en un archivo XML (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se escribe el objeto de una clase en un archivo XML con la clase
XmlSerializer.

Ejemplo
C#

public class XMLWrite

{

static void Main(string[] args)

{

WriteXML();

public class Book

public String title;

public static void WriteXML()

Book overview = new Book();

overview.title = "Serialization Overview";

System.Xml.Serialization.XmlSerializer writer =

new System.Xml.Serialization.XmlSerializer(typeof(Book));

var path =
Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) +
"//SerializationOverview.xml";

System.IO.FileStream file = System.IO.File.Create(path);

writer.Serialize(file, overview);

file.Close();

Compilar el código
La clase que se serializa debe tener un constructor público sin parámetros.
Programación sólida
Las condiciones siguientes pueden provocar una excepción:

La clase que se está serializando no tiene un constructor público sin parámetros.

El archivo ya existe y es de solo lectura (IOException).

La ruta de acceso del archivo es demasiado larga (PathTooLongException).

El disco está lleno (IOException).

Seguridad de .NET
En este ejemplo se crea un nuevo archivo, si este no existe aún. Si una aplicación
necesita crear un archivo, precisará acceso Create para la carpeta. Si el archivo ya existe,
la aplicación necesitará solo acceso Write , un privilegio menor. Siempre que sea
posible, resulta más seguro crear el archivo durante la implementación y conceder solo
acceso Read a un único archivo, en lugar de acceso Create para una carpeta.

Vea también
StreamWriter
Procedimiento para leer datos de objeto de un archivo XML (C#)
Serialización (C#)
Procedimiento para leer datos de objeto
de un archivo XML (C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se leen los datos de objetos que se han escrito anteriormente en un
archivo XML con la clase XmlSerializer.

Ejemplo
C#

public class Book

public String title;

public void ReadXML()

// First write something so that there is something to read ...

var b = new Book { title = "Serialization Overview" };

var writer = new System.Xml.Serialization.XmlSerializer(typeof(Book));

var wfile = new

System.IO.StreamWriter(@"c:\temp\SerializationOverview.xml");

writer.Serialize(wfile, b);
wfile.Close();

// Now we can read the serialized book ...

System.Xml.Serialization.XmlSerializer reader =

new System.Xml.Serialization.XmlSerializer(typeof(Book));

System.IO.StreamReader file = new System.IO.StreamReader(

@"c:\temp\SerializationOverview.xml");

Book overview = (Book)reader.Deserialize(file);

file.Close();

Console.WriteLine(overview.title);

Compilar el código
Reemplace el nombre de archivo "c:\temp\SerializationOverview.xml" por el nombre del
archivo que contiene los datos serializados. Para más información sobre la serialización
de datos, consulte Procedimiento para escribir datos de objeto en un archivo XML (C#).

La clase debe tener un constructor público sin parámetros.

Solo se deserializan las propiedades y los campos públicos.

Programación sólida
Las condiciones siguientes pueden provocar una excepción:

La clase que se está serializando no tiene un constructor público sin parámetros.

Los datos del archivo no representan los datos de la clase que se va a deserializar.

El archivo no existe (IOException).

Seguridad de .NET
Compruebe siempre las entradas y nunca deserialice datos de un origen que no sea de
confianza. El objeto que se ha vuelto a crear se ejecuta en un equipo local con los
permisos del código que lo ha deserializado. Compruebe todas las entradas antes de
utilizar los datos en la aplicación.

Vea también
StreamWriter
Procedimiento para escribir datos de objeto en un archivo XML (C#)
Serialización (C#)
Guía de programación de C#
Tutorial: Conservar un objeto con C#
Artículo • 17/02/2023 • Tiempo de lectura: 4 minutos

Puede usar la serialización de JSON para conservar los datos de un objeto entre
instancias, lo que le permite almacenar valores y recuperarlos la próxima vez que se cree
una instancia del objeto.

En este tutorial, creará un objeto Loan básico y conservará sus datos en un archivo
JSON. Después, recuperará los datos del archivo cuando vuelva a crear el objeto.

） Importante

En este ejemplo se crea un nuevo archivo, si este no existe aún. Si una aplicación
debe crear un archivo, es necesario que tenga el permiso Create en la carpeta. Los
permisos se establecen mediante el uso de las listas de control de acceso. Si el
archivo ya existe, la aplicación necesitará solo un permiso Write , un permiso
menor. Siempre que sea posible, resulta más seguro crear el archivo durante la
implementación y conceder solo permisos Read a un único archivo (en lugar de
Create permisos para una carpeta). También es más seguro escribir datos en
carpetas de usuario en lugar de hacerlo en la carpeta raíz o en la carpeta Archivos
de programa.

） Importante

En este ejemplo se almacenan datos en un archivo JSON. No debe almacenar datos

confidenciales, como contraseñas o información de tarjeta de crédito, en un archivo
JSON.

Requisitos previos
Para compilar y ejecutar, instale el SDK de .NET .

Instale el editor de código que prefiera si aún no lo ha hecho.

 Sugerencia

¿Es necesario instalar un editor de código? Pruebe Visual Studio .

En el repositorio de GitHub de ejemplos de .NET puede examinar el código de
ejemplo en línea.

Definición del tipo de préstamo

El primer paso consiste en crear una clase Loan y una aplicación de consola que use la
clase:

1. Cree una aplicación. Escriba dotnet new console -o serialization para crear una
aplicación de consola en un subdirectorio llamado serialization .

2. Abra la aplicación en el editor y agregue una nueva clase denominada Loan.cs .

3. Agregue el siguiente código a la clase Loan :

C#

public class Loan : INotifyPropertyChanged

public double LoanAmount { get; set; }

public double InterestRate { get; set; }

[JsonIgnore]

public DateTime TimeLastLoaded { get; set; }

public int Term { get; set; }

private string _customer;

public string Customer

get { return _customer; }

set

_customer = value;

PropertyChanged?.Invoke(this,

new PropertyChangedEventArgs(nameof(Customer)));

public event PropertyChangedEventHandler? PropertyChanged;

public Loan(double loanAmount,

double interestRate,

int term,

string customer)

LoanAmount = loanAmount;

InterestRate = interestRate;

Term = term;

_customer = customer;

Creación de una instancia de un objeto de

préstamo
1. Abra el archivo Program.cs y agregue el código siguiente:

C#

Loan testLoan = new(10_000.0, 7.5, 36, "Neil Black");

2. Agregue un controlador de eventos del evento PropertyChanged y unas cuantas

líneas para modificar el objeto Loan y ver los cambios. En el siguiente código
puede ver las adiciones realizadas:

C#

testLoan.PropertyChanged += (_, __) => Console.WriteLine($"New customer

value: {testLoan.Customer}");

testLoan.Customer = "Henry Clay";

Console.WriteLine(testLoan.InterestRate);

testLoan.InterestRate = 7.1;

Console.WriteLine(testLoan.InterestRate);

Llegado este punto, puede ejecutar el código y ver el resultado actual:

Consola

New customer value: Henry Clay

7.5

7.1

Si ejecuta esta aplicación repetidamente, verá que siempre escribe los mismos valores.
Se creará un objeto Loan cada vez que ejecute el programa. En el mundo real, las tasas
de interés cambian periódicamente, pero no necesariamente cada vez que se ejecuta la
aplicación. El código de serialización conlleva que se va a conservar la tasa de interés
más reciente entre las instancias de la aplicación. En el paso siguiente, hará esto
agregando la serialización a la clase Loan .

Usar la serialización para conservar el objeto

Para serializar un objeto mediante System.Text.Json la serialización, no es necesario
agregar ningún atributo especial al tipo. De forma predeterminada, se serializan todas
las propiedades públicas y se omiten todos los campos. Sin embargo, puede anotar las
propiedades para omitir o especificar que se deben incluir los campos.

El código siguiente agrega una TimeLastLoaded propiedad y la marca con el

JsonIgnoreAttribute atributo para excluirla de la serialización:

C#

[JsonIgnore]

public DateTime TimeLastLoaded { get; set; }

1. Para serializar la clase y escribirla en un archivo, usaremos los espacios de nombres

System.IO y System.Text.Json. Para evitar escribir los nombres completos, puede
agregar referencias a los espacios de nombres necesarios, tal y como se muestra
en el siguiente código:

C#

using System.IO;

using System.Text.Json;

2. El siguiente paso es agregar código para deserializar el objeto del archivo cuando
el objeto se crea. Agregue una constante a la clase para el nombre de archivo de
los datos serializados, tal y como se muestra en el siguiente código:

C#

const string fileName = @"../../../SavedLoan.json";

Luego, agregue el siguiente código después de la línea que crea el objeto

TestLoan . Este código comprueba primero que el archivo existe. Si existe, lee el

texto del archivo y, a continuación, deserialícelo mediante el método

JsonSerializer.Deserialize<TValue>(String, JsonSerializerOptions).

C#

if (File.Exists(fileName))

Console.WriteLine("Reading saved file");

string jsonFromFile = File.ReadAllText(fileName);

testLoan = JsonSerializer.Deserialize<Loan>(jsonFromFile);

testLoan.TimeLastLoaded = DateTime.Now;

 3. A continuación, agregue código para serializar la clase en un archivo mediante el

método JsonSerializer.Serialize<TValue>(TValue, JsonSerializerOptions). Agregue el
siguiente código al final del archivo:

C#

// Serialize it.

string json = JsonSerializer.Serialize(testLoan);

File.WriteAllText(fileName, json);

En este punto, podrá compilar y ejecutar la aplicación de nuevo. La primera vez que se
ejecuta, observe que el tipo de interés comienza en 7.5 y, después, pasa a 7.1. Cierre la
aplicación y, después, ejecútela de nuevo. Ahora, la aplicación muestra un mensaje que
indica que se ha leído el archivo guardado y la tasa de interés es 7.1 incluso antes del
código que la cambia.

Vea también
Serialización (C#)
Guía de programación de C#
Procedimiento para serializar y deserializar JSON en .NET
Instrucciones (Guía de programación de
C#)
Artículo • 14/02/2023 • Tiempo de lectura: 6 minutos

Las acciones que realiza un programa se expresan en instrucciones. Entre las acciones
comunes se incluyen declarar variables, asignar valores, llamar a métodos, recorrer
colecciones en bucle y crear una bifurcación a uno u otro bloque de código, en función
de una condición determinada. El orden en el que se ejecutan las instrucciones en un
programa se denomina flujo de control o flujo de ejecución. El flujo de control puede
variar cada vez que se ejecuta un programa, en función de cómo reacciona el programa
a la entrada que recibe en tiempo de ejecución.

Una instrucción puede constar de una sola línea de código que finaliza en un punto y
coma o de una serie de instrucciones de una sola línea en un bloque. Un bloque de
instrucciones se incluye entre llaves {} y puede contener bloques anidados. En el código
siguiente se muestran dos ejemplos de instrucciones de una sola línea y un bloque de
instrucciones de varias líneas:

C#

static void Main()

// Declaration statement.
int counter;

// Assignment statement.

counter = 1;

// Error! This is an expression, not an expression statement.

// counter + 1;

// Declaration statements with initializers are functionally

// equivalent to declaration statement followed by assignment

statement:

int[] radii = { 15, 32, 108, 74, 9 }; // Declare and initialize an

array.

const double pi = 3.14159; // Declare and initialize constant.

// foreach statement block that contains multiple statements.

foreach (int radius in radii)

// Declaration statement with initializer.

double circumference = pi * (2 * radius);

// Expression statement (method invocation). A single-line

// statement can span multiple text lines because line breaks

// are treated as white space, which is ignored by the compiler.

 System.Console.WriteLine("Radius of circle #{0} is {1}.

Circumference = {2:N2}",

counter, radius, circumference);

// Expression statement (postfix increment).

counter++;

} // End of foreach statement block

} // End of Main method body.

} // End of SimpleStatements class.

/*

Output:

Radius of circle #1 = 15. Circumference = 94.25

Radius of circle #2 = 32. Circumference = 201.06

Radius of circle #3 = 108. Circumference = 678.58

Radius of circle #4 = 74. Circumference = 464.96

Radius of circle #5 = 9. Circumference = 56.55

*/

Tipos de instrucciones
En la tabla siguiente se muestran los distintos tipos de instrucciones de C# y sus
palabras clave asociadas, con vínculos a temas que incluyen más información:

Categoría Palabras clave de C# / notas

Instrucciones Una instrucción de declaración introduce una variable o constante nueva. Una
de declaración de variable puede asignar opcionalmente un valor a la variable. En
declaración una declaración de constante, se requiere la asignación.

Instrucciones Las instrucciones de expresión que calculan un valor deben almacenar el valor en
de expresión una variable.

Instrucciones Las instrucciones de selección permiten crear bifurcaciones a diferentes secciones

de selección de código, en función de una o varias condiciones especificadas. Para obtener más
información, vea los temas siguientes:
if
switch

Instrucciones Las instrucciones de iteración permiten recorrer en bucle colecciones, como

de iteración matrices, o realizar el mismo conjunto de instrucciones repetidas veces hasta que
se cumpla una condición especificada. Para obtener más información, vea los
temas siguientes:
do
for
foreach
while
Categoría Palabras clave de C# / notas

Instrucciones Las instrucciones de salto transfieren el control a otra sección de código. Para
de salto obtener más información, vea los temas siguientes:
break
continue
goto
return
yield

Instrucciones Las instrucciones para el control de excepciones permiten recuperarse

para el correctamente de condiciones excepcionales producidas en tiempo de ejecución.
control de Para obtener más información, vea los temas siguientes:
excepciones throw
try-catch
try-finally
try-catch-finally

checked y Las instrucciones checked y unchecked permiten especificar si las operaciones

unchecked numéricas de tipo entero pueden producir un desbordamiento cuando el
resultado se almacena en una variable que es demasiado pequeña para contener
el valor resultante.

Instrucción Si marca un método con el modificador async , puede usar el operador await en el
await método. Cuando el control alcanza una expresión await en el método
asincrónico, el control se devuelve al autor de llamada y el progreso del método
se suspende hasta que se completa la tarea esperada. Cuando se completa la
tarea, la ejecución puede reanudarse en el método.

Para obtener un ejemplo sencillo, vea la sección "Métodos asincrónicos" de

Métodos. Para obtener más información, vea Programación asincrónica con Async
y Await.

Instrucción Un iterador realiza una iteración personalizada en una colección, como una lista o
yield matriz. Un iterador utiliza la instrucción yield return para devolver cada elemento
return de uno en uno. Cuando se alcanza una instrucción yield return , se recuerda la
ubicación actual en el código. La ejecución se reinicia desde esa ubicación la
próxima vez que se llama el iterador.

Para obtener más información, consulta Iteradores.

Instrucción La instrucción fixed impide que el recolector de elementos no utilizados cambie la

fixed ubicación de una variable móvil. Para obtener más información, vea fixed.

Instrucción La instrucción lock permite limitar el acceso a bloques de código a un solo

lock subproceso de cada vez. Para obtener más información, vea lock.
 Categoría Palabras clave de C# / notas

Instrucciones Puede asignar una etiqueta a una instrucción y, después, usar la palabra clave
con etiqueta goto para saltar a la instrucción con etiqueta. (Vea el ejemplo de la línea
siguiente).

Instrucción La instrucción vacía consta únicamente de un punto y coma. No hace nada y se

vacía puede usar en lugares en los que se requiere una instrucción, pero no es
necesario realizar ninguna acción.

Instrucciones de declaración
En el código siguiente se muestran ejemplos de declaraciones de variables con y sin una
asignación inicial, y una declaración constante con la inicialización necesaria.

C#

// Variable declaration statements.

double area;

double radius = 2;

// Constant declaration statement.

const double pi = 3.14159;

Instrucciones de expresión
En el código siguiente se muestran ejemplos de instrucciones de expresión, que
incluyen la asignación, la creación de objetos con asignación y la invocación de método.

C#

// Expression statement (assignment).

area = 3.14 * (radius * radius);

// Error. Not statement because no assignment:

//circ * 2;

// Expression statement (method invocation).

System.Console.WriteLine();

// Expression statement (new object creation).

System.Collections.Generic.List<string> strings =

new System.Collections.Generic.List<string>();

Instrucción vacía
En los ejemplos siguientes se muestran dos usos de una instrucción vacía:

C#

void ProcessMessages()

while (ProcessMessage())

; // Statement needed here.

void F()

//...

if (done) goto exit;

//...

exit:

; // Statement needed here.

Instrucciones insertadas
Algunas instrucciones, por ejemplo, las instrucciones de iteración, siempre van seguidas
de una instrucción insertada. Esta instrucción insertada puede ser una sola instrucción o
varias instrucciones incluidas entre llaves {} en un bloque de instrucciones. Las
instrucciones insertadas de una sola línea también pueden ir entre llaves {}, como se
muestra en el siguiente ejemplo:

C#

// Recommended style. Embedded statement in block.

foreach (string s in System.IO.Directory.GetDirectories(

System.Environment.CurrentDirectory))

System.Console.WriteLine(s);

// Not recommended.

foreach (string s in System.IO.Directory.GetDirectories(

System.Environment.CurrentDirectory))

System.Console.WriteLine(s);

Una instrucción insertada que no está incluida entre llaves {} no puede ser una
instrucción de declaración o una instrucción con etiqueta. Esto se muestra en el ejemplo
siguiente:
 C#

if(pointB == true)

//Error CS1023:

int radius = 5;

Coloque la instrucción insertada en un bloque para solucionar el error:

C#

if (b == true)

// OK:

System.DateTime d = System.DateTime.Now;

System.Console.WriteLine(d.ToLongDateString());

Bloques de instrucciones anidadas

Los bloques de instrucciones pueden anidarse, como se muestra en el código siguiente:

C#

foreach (string s in System.IO.Directory.GetDirectories(

System.Environment.CurrentDirectory))

if (s.StartsWith("CSharp"))

if (s.EndsWith("TempFolder"))

return s;

return "Not found.";

Instrucciones inaccesibles
Si el compilador determina que el flujo de control no puede alcanzar nunca una
instrucción determinada bajo ninguna circunstancia, producirá una advertencia CS0162,
como se muestra en el ejemplo siguiente:

C#

// An over-simplified example of unreachable code.

const int val = 5;

 if (val < 4)

System.Console.WriteLine("I'll never write anything."); //CS0162

Especificación del lenguaje C#

Para más información, vea la sección Instrucciones de la especificación del lenguaje C#.

Consulte también
Guía de programación de C#
Palabras clave de instrucciones
Operadores y expresiones de C#
Miembros con cuerpo de expresión
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las definiciones de cuerpos de expresión permiten proporcionar la implementación de

un miembro de una forma muy concisa y legible. Se puede usar una definición de
cuerpo de expresión siempre que la lógica de cualquier miembro compatible, como un
método o propiedad, se componga de una expresión única. Una definición de cuerpo
de expresión tiene la siguiente sintaxis general:

C#

member => expression;

donde expresión es una expresión válida.

Las definiciones del cuerpo de expresiones se pueden usar con los miembros de tipo
siguientes:

Método
Propiedad de solo lectura
Propiedad
Constructor
Finalizador
Indizador

Métodos
Un método con cuerpo de expresión consta de una sola expresión que devuelve un
valor cuyo tipo coincide con el tipo de valor devuelto del método, o bien, para los
métodos que devuelven void , que realiza alguna operación. Por ejemplo, los tipos que
reemplazan el método ToString normalmente incluyen una sola expresión que devuelve
la representación de cadena del objeto actual.

En el ejemplo siguiente se define una clase Person que reemplaza el método ToString
con una definición de cuerpo de expresión. También define un método DisplayName que
muestra un nombre en la consola. Tenga en cuenta que la palabra clave return no se
usa en la definición de cuerpo de expresión de ToString .

C#
 using System;

public class Person

public Person(string firstName, string lastName)

fname = firstName;

lname = lastName;

private string fname;

private string lname;

public override string ToString() => $"{fname} {lname}".Trim();

public void DisplayName() => Console.WriteLine(ToString());

class Example

static void Main()

Person p = new Person("Mandy", "Dejesus");

Console.WriteLine(p);

p.DisplayName();

Para más información, vea Métodos (Guía de programación de C#).

Propiedades de solo lectura

Puede usar la definición del cuerpo de expresiones para implementar una propiedad de
solo lectura. Para ello, use la sintaxis siguiente:

C#

PropertyType PropertyName => expression;

En el ejemplo siguiente se define una clase Location cuya propiedad Name de solo
lectura se implementa como una definición de cuerpo de expresión que devuelve el
valor del campo privado locationName :

C#

public class Location

private string locationName;

 public Location(string name)

locationName = name;

public string Name => locationName;

Para más información sobre las propiedades, vea Propiedades (Guía de programación
de C#).

Propiedades
Puede usar las definiciones del cuerpo de expresiones para implementar los
descriptores de acceso get y set de propiedades. En el ejemplo siguiente se muestra
cómo hacerlo:

C#

public class Location

private string locationName;

public Location(string name) => Name = name;

public string Name

get => locationName;

set => locationName = value;

Para más información sobre las propiedades, vea Propiedades (Guía de programación
de C#).

Constructores
Una definición de cuerpo de expresión para un constructor normalmente consta de una
expresión de asignación única o una llamada de método que controla los argumentos
del constructor o inicializa el estado de la instancia.

En el ejemplo siguiente se define una clase Location cuyo constructor tiene un único
parámetro de cadena denominado name. La definición del cuerpo de expresión asigna
el argumento a la propiedad Name .
 C#

public class Location

private string locationName;

public Location(string name) => Name = name;

public string Name

get => locationName;

set => locationName = value;

Para más información, vea Constructores (Guía de programación de C#).

Finalizadores
Una definición de cuerpo de expresión para un finalizador normalmente contiene
instrucciones de limpieza, como las instrucciones que liberan recursos no administrados.

En el ejemplo siguiente se define un finalizador que usa una definición de cuerpo de

expresión para indicar que el finalizador se ha llamado.

C#

public class Destroyer

public override string ToString() => GetType().Name;

~Destroyer() => Console.WriteLine($"The {ToString()} finalizer is

executing.");

Para más información, vea Finalizadores (Guía de programación de C#).

Indizadores
Como las propiedades, los descriptores de acceso get y set del indizador constan de
las definiciones de cuerpos de expresión si el descriptor de acceso get está formado
por una sola expresión que devuelve un valor o el descriptor de acceso set realiza una
asignación simple.
En el ejemplo siguiente se define una clase denominada Sports que incluye una matriz
String interna que contiene los nombres de varios deportes. Los descriptores de acceso
get y set del indizador se implementan como definiciones de cuerpos de expresión.

C#

using System;

using System.Collections.Generic;

public class Sports

private string[] types = { "Baseball", "Basketball", "Football",

"Hockey", "Soccer", "Tennis",

"Volleyball" };

public string this[int i]

get => types[i];

set => types[i] = value;

Para más información, vea Indizadores (Guía de programación de C#).

Consulte también
Reglas de estilo de código de .NET para miembros con forma de expresión
Comparaciones de igualdad (guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

A veces es necesario comparar si dos valores son iguales. En algunos casos, se prueba la
igualdad de valores, también denominada equivalencia, lo que significa que los valores
contenidos en las dos variables son iguales. En otros casos, hay que determinar si dos
variables hacen referencia al mismo objeto subyacente de la memoria. Este tipo de
igualdad se denomina igualdad de referencia o identidad. En este tema se describen
estos dos tipos de igualdad y se proporcionan vínculos a otros temas para obtener más
información.

Igualdad de referencia
La igualdad de referencia significa que dos referencias de objeto hacen referencia al
mismo objeto subyacente. Esto puede suceder mediante una asignación simple, como
se muestra en el ejemplo siguiente.

C#

using System;

class Test

public int Num { get; set; }

public string Str { get; set; }

static void Main()

Test a = new Test() { Num = 1, Str = "Hi" };

Test b = new Test() { Num = 1, Str = "Hi" };

bool areEqual = System.Object.ReferenceEquals(a, b);

// False:

System.Console.WriteLine("ReferenceEquals(a, b) = {0}", areEqual);

// Assign b to a.

b = a;

// Repeat calls with different results.

areEqual = System.Object.ReferenceEquals(a, b);

// True:

System.Console.WriteLine("ReferenceEquals(a, b) = {0}", areEqual);

// Keep the console open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

En este código, se crean dos objetos, pero después de la instrucción de asignación,

ambas referencias hacen referencia al mismo objeto. Por consiguiente, presentan
igualdad de referencia. Use el método ReferenceEquals para determinar si dos
referencias hacen referencia al mismo objeto.

El concepto de igualdad de la referencia solo se aplica a los tipos de referencia. Los

objetos de tipo de valor no pueden presentar igualdad de referencia porque al asignar
una instancia de un tipo de valor a una variable, se realiza una copia del valor. Por
consiguiente, nunca puede haber dos structs con conversión unboxing que hagan
referencia a la misma ubicación de la memoria. Además, si se usa ReferenceEquals para
comparar dos tipos de valor, el resultado siempre será false , aunque todos los valores
que contengan los objetos sean idénticos. Esto se debe a que a cada variable se aplica la
conversión boxing en una instancia de objeto independiente. Para más información,
consulte Procedimiento Probar la igualdad de referencia (Identidad).

Igualdad de valores
La igualdad de valores significa que dos objetos contienen el mismo valor o valores.
Para los tipos de valor primitivos, como int o bool, las pruebas de igualdad de valores
son sencillas. Puede usar el operador ==, como se muestra en el ejemplo siguiente.

C#

int a = GetOriginalValue();

int b = GetCurrentValue();

// Test for value equality.

if (b == a)

// The two integers are equal.

Para la mayoría de los otros tipos, las pruebas de igualdad de valores son más
complejas, porque es preciso entender cómo la define el tipo. Para las clases y los
structs que tienen varios campos o propiedades, la igualdad de valores suele definirse
de modo que significa que todos los campos o propiedades tienen el mismo valor. Por
ejemplo, podrían definirse dos objetos Point que fueran equivalentes si pointA.X es
igual a pointB.X y pointA.Y es igual a pointB.Y. En el caso de los registros, la igualdad de
valores significa que dos variables de un tipo de registro son iguales si los tipos
coinciden y todos los valores de propiedad y campo coinciden.
En cambio, no hay ningún requisito que exija que la equivalencia se base en todos los
campos de un tipo. Se puede basar en un subconjunto. Al comparar tipos que no sean
de su propiedad, es importante asegurarse concretamente de cómo se define la
equivalencia para ese tipo. Para más información sobre cómo definir la igualdad de
valores en sus propias clases y structs, consulte Procedimiento Definir la igualdad de
valores para un tipo.

Igualdad de valores en valores de número de punto

flotante
Las comparaciones de igualdad de valores de punto flotante (double y float) son
problemáticas debido a la imprecisión de la aritmética de número de punto flotante en
los equipos binarios. Para obtener más información, vea los comentarios en el tema
System.Double.

Temas relacionados
Title Descripción

Procedimiento Probar la Describe cómo determinar si dos variables presentan igualdad de

igualdad de referencia referencia.
(Identidad)

Procedimiento Definir la Describe cómo proporcionar una definición personalizada de igualdad

igualdad de valores para de valores para un tipo.
un tipo

Guía de programación Proporciona vínculos a información detallada sobre importantes

de C# características del lenguaje C# y características que están disponibles
para C# a través de .NET.

Tipos Proporciona información sobre el sistema de tipos de C# y vínculos a

información adicional.

Registros Proporciona información sobre los tipos de registro, que comprueban

la igualdad de valores de forma predeterminada.

Vea también
Guía de programación de C#
Definición de la igualdad de valores
para una clase o una estructura (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

Los registros implementan automáticamente la igualdad de valores. Considere la

posibilidad de definir record en lugar de class cuando el tipo modela los datos y debe
implementar la igualdad de valores.

Cuando defina una clase o un struct, debe decidir si tiene sentido crear una definición
personalizada de igualdad (o equivalencia) de valores para el tipo. Normalmente, la
igualdad de valores se implementa cuando se espera agregar objetos del tipo a una
colección, o cuando su objetivo principal es almacenar un conjunto de campos o
propiedades. Puede basar la definición de la igualdad de valores en una comparación de
todos los campos y propiedades del tipo, o bien puede basarla en un subconjunto.

En cualquier caso, tanto en las clases como en las estructuras, la implementación debe
cumplir las cinco garantías de equivalencia (en las siguientes reglas, se da por hecho
que x , y y z no son NULL):

1. La propiedad reflexiva x.Equals(x) devuelve true .

2. La propiedad simétrica x.Equals(y) devuelve el mismo valor que y.Equals(x) .

3. La propiedad transitiva: si (x.Equals(y) && y.Equals(z)) devuelve true ,

x.Equals(z) devuelve true .

4. Las invocaciones sucesivas de x.Equals(y) devuelven el mismo valor siempre y

cuando los objetos a los que x e y hacen referencia no se modifiquen.

5. Cualquier valor distinto de NULL no es igual a NULL. Sin embargo, x.Equals(y)

produce una excepción cuando x es NULL. Esto rompe las reglas 1 o 2, en función
del argumento de Equals .

Cualquier struct que defina ya tiene una implementación predeterminada de igualdad

de valor que hereda de la invalidación System.ValueType del método
Object.Equals(Object). Esta implementación usa la reflexión para examinar todos los
campos y propiedades del tipo. Aunque esta implementación genera resultados
correctos, es relativamente lenta en comparación con una implementación
personalizada escrita específicamente para el tipo.
Los detalles de implementación para la igualdad de valores son diferentes para las
clases y los structs. A pesar de ello, tanto las clases como los structs requieren los
mismos pasos básicos para implementar la igualdad:

1. Invalide el método Object.Equals(Object)virtual. En la mayoría de los casos, la

implementación de bool Equals( object obj ) debería llamar solamente al
método Equals específico del tipo que es la implementación de la interfaz
System.IEquatable<T>. (Vea el paso 2).

2. Implemente la interfaz System.IEquatable<T> proporcionando un método Equals

específico del tipo. Aquí es donde se realiza la comparación de equivalencias
propiamente dicha. Por ejemplo, podría decidir que, para definir la igualdad, solo
se comparen uno o dos campos del tipo. No genere excepciones desde Equals .
Para las clases que están relacionadas por herencia:

este método debe examinar únicamente los campos que se declaran en la

clase. Debe llamar a base.Equals para examinar los campos que están en la
clase base. (No llame a base.Equals si el tipo hereda directamente de Object,
porque la implementación Object de Object.Equals(Object) realiza una
comprobación de igualdad de referencia).

Dos variables deben considerarse iguales solo si los tipos en tiempo de

ejecución de las variables que se van a comparar son los mismos. Además,
asegúrese de que se utiliza la implementación IEquatable del método
Equals para el tipo en tiempo de ejecución si los tipos en tiempo de
ejecución y en tiempo de compilación de una variable son diferentes. Una
estrategia para asegurarse de que los tipos en tiempo de ejecución siempre
se comparan correctamente es implementar IEquatable solo en clases
sealed . Para obtener más información, vea el ejemplo de clases más adelante

en este artículo.

3. Opcional, pero recomendado: Sobrecargue los operadores == y !=.

4. Invalide Object.GetHashCode de manera que dos objetos que tengan igualdad de

valor produzcan el mismo código hash.

5. Opcional: Para admitir definiciones para "mayor que" o "menor que", implemente
la interfaz IComparable<T> para el tipo y sobrecargue los operadores <= y >=.

７ Nota
 A partir de C# 9.0, puede usar registros para obtener la semántica de igualdad de
valores sin código reutilizable innecesario.

Ejemplo de clase
En el ejemplo siguiente se muestra cómo implementar la igualdad de valores en una
clase (tipo de referencia).

C#

namespace ValueEqualityClass;

class TwoDPoint : IEquatable<TwoDPoint>

public int X { get; private set; }

public int Y { get; private set; }

public TwoDPoint(int x, int y)

if (x is (< 1 or > 2000) || y is (< 1 or > 2000))

throw new ArgumentException("Point must be in range 1 - 2000");

this.X = x;

this.Y = y;

public override bool Equals(object obj) => this.Equals(obj as

TwoDPoint);

public bool Equals(TwoDPoint p)

if (p is null)

return false;

// Optimization for a common success case.

if (Object.ReferenceEquals(this, p))

return true;

// If run-time types are not exactly the same, return false.

if (this.GetType() != p.GetType())

return false;

// Return true if the fields match.

// Note that the base class is not invoked because it is

 // System.Object, which defines Equals as reference equality.

return (X == p.X) && (Y == p.Y);

public override int GetHashCode() => (X, Y).GetHashCode();

public static bool operator ==(TwoDPoint lhs, TwoDPoint rhs)

if (lhs is null)

if (rhs is null)

return true;

// Only the left side is null.

return false;

// Equals handles case of null on right side.

return lhs.Equals(rhs);

public static bool operator !=(TwoDPoint lhs, TwoDPoint rhs) => !(lhs ==
rhs);

// For the sake of simplicity, assume a ThreeDPoint IS a TwoDPoint.

class ThreeDPoint : TwoDPoint, IEquatable<ThreeDPoint>

public int Z { get; private set; }

public ThreeDPoint(int x, int y, int z)

: base(x, y)

if ((z < 1) || (z > 2000))

throw new ArgumentException("Point must be in range 1 - 2000");

this.Z = z;

public override bool Equals(object obj) => this.Equals(obj as

ThreeDPoint);

public bool Equals(ThreeDPoint p)

if (p is null)

return false;

// Optimization for a common success case.

if (Object.ReferenceEquals(this, p))

return true;

// Check properties that this class declares.

if (Z == p.Z)

// Let base class check its own fields

// and do the run-time type comparison.

return base.Equals((TwoDPoint)p);

else

return false;

public override int GetHashCode() => (X, Y, Z).GetHashCode();

public static bool operator ==(ThreeDPoint lhs, ThreeDPoint rhs)

if (lhs is null)

if (rhs is null)

// null == null = true.

return true;

// Only the left side is null.

return false;

// Equals handles the case of null on right side.

return lhs.Equals(rhs);

public static bool operator !=(ThreeDPoint lhs, ThreeDPoint rhs) => !

(lhs == rhs);

class Program

static void Main(string[] args)

ThreeDPoint pointA = new ThreeDPoint(3, 4, 5);

ThreeDPoint pointB = new ThreeDPoint(3, 4, 5);

ThreeDPoint pointC = null;

int i = 5;

Console.WriteLine("pointA.Equals(pointB) = {0}",
pointA.Equals(pointB));

Console.WriteLine("pointA == pointB = {0}", pointA == pointB);

Console.WriteLine("null comparison = {0}", pointA.Equals(pointC));

Console.WriteLine("Compare to some other type = {0}",

pointA.Equals(i));

TwoDPoint pointD = null;

 TwoDPoint pointE = null;

Console.WriteLine("Two null TwoDPoints are equal: {0}", pointD ==

pointE);

pointE = new TwoDPoint(3, 4);

Console.WriteLine("(pointE == pointA) = {0}", pointE == pointA);

Console.WriteLine("(pointA == pointE) = {0}", pointA == pointE);

Console.WriteLine("(pointA != pointE) = {0}", pointA != pointE);

System.Collections.ArrayList list = new

System.Collections.ArrayList();

list.Add(new ThreeDPoint(3, 4, 5));

Console.WriteLine("pointE.Equals(list[0]): {0}",
pointE.Equals(list[0]));

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

pointA.Equals(pointB) = True

pointA == pointB = True

null comparison = False

Compare to some other type = False

Two null TwoDPoints are equal: True

(pointE == pointA) = False

(pointA == pointE) = False

(pointA != pointE) = True

pointE.Equals(list[0]): False
*/

En las clases (tipos de referencia), la implementación predeterminada de ambos

métodos Object.Equals(Object) realiza una comparación de igualdad de referencia, no
una comprobación de igualdad de valores. Cuando un implementador invalida el
método virtual, lo hace para asignarle semántica de igualdad de valores.

Los operadores == y != pueden usarse con clases, incluso si la clase no los sobrecarga,
pero el comportamiento predeterminado consiste en realizar una comprobación de
igualdad de referencia. En una clase, si sobrecarga el método Equals , debería
sobrecargar los operadores == y != , pero no es obligatorio.

） Importante

Es posible que el código de ejemplo anterior no controle cada escenario de

herencia de la manera esperada. Observe el código siguiente:
 C#

TwoDPoint p1 = new ThreeDPoint(1, 2, 3);

TwoDPoint p2 = new ThreeDPoint(1, 2, 4);

Console.WriteLine(p1.Equals(p2)); // output: True

Este código notifica que p1 es igual a p2 pesar de la diferencia en los valores z . La

diferencia se omite porque el compilador elige la implementación TwoDPoint de
IEquatable basándose en el tipo en tiempo de compilación.

La igualdad de valores integrada de los tipos record controla escenarios como

este. Si TwoDPoint y ThreeDPoint fueran de tipo record , el resultado de
p1.Equals(p2) sería False . Para obtener más información, vea Igualdad en las

jerarquías de herencia de tipo record.

Ejemplo de estructura
En el ejemplo siguiente se muestra cómo implementar la igualdad de valores en un
struct (tipo de valor):

C#

namespace ValueEqualityStruct

struct TwoDPoint : IEquatable<TwoDPoint>

public int X { get; private set; }

public int Y { get; private set; }

public TwoDPoint(int x, int y)

: this()

if (x is (< 1 or > 2000) || y is (< 1 or > 2000))

throw new ArgumentException("Point must be in range 1 -

2000");

X = x;

Y = y;

public override bool Equals(object? obj) => obj is TwoDPoint other

&& this.Equals(other);

public bool Equals(TwoDPoint p) => X == p.X && Y == p.Y;

public override int GetHashCode() => (X, Y).GetHashCode();

 public static bool operator ==(TwoDPoint lhs, TwoDPoint rhs) =>

lhs.Equals(rhs);

public static bool operator !=(TwoDPoint lhs, TwoDPoint rhs) => !

(lhs == rhs);

class Program

static void Main(string[] args)

TwoDPoint pointA = new TwoDPoint(3, 4);

TwoDPoint pointB = new TwoDPoint(3, 4);

int i = 5;

// True:

Console.WriteLine("pointA.Equals(pointB) = {0}",
pointA.Equals(pointB));

// True:

Console.WriteLine("pointA == pointB = {0}", pointA == pointB);

// True:

Console.WriteLine("object.Equals(pointA, pointB) = {0}",

object.Equals(pointA, pointB));

// False:

Console.WriteLine("pointA.Equals(null) = {0}",
pointA.Equals(null));

// False:

Console.WriteLine("(pointA == null) = {0}", pointA == null);

// True:

Console.WriteLine("(pointA != null) = {0}", pointA != null);

// False:

Console.WriteLine("pointA.Equals(i) = {0}", pointA.Equals(i));

// CS0019:

// Console.WriteLine("pointA == i = {0}", pointA == i);

// Compare unboxed to boxed.

System.Collections.ArrayList list = new

System.Collections.ArrayList();

list.Add(new TwoDPoint(3, 4));

// True:

Console.WriteLine("pointA.Equals(list[0]): {0}",
pointA.Equals(list[0]));

// Compare nullable to nullable and to non-nullable.

TwoDPoint? pointC = null;

TwoDPoint? pointD = null;

// False:

Console.WriteLine("pointA == (pointC = null) = {0}", pointA ==

pointC);

// True:

Console.WriteLine("pointC == pointD = {0}", pointC == pointD);

TwoDPoint temp = new TwoDPoint(3, 4);

pointC = temp;

 // True:

Console.WriteLine("pointA == (pointC = 3,4) = {0}", pointA ==

pointC);

pointD = temp;

// True:

Console.WriteLine("pointD == (pointC = 3,4) = {0}", pointD ==

pointC);

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

pointA.Equals(pointB) = True

pointA == pointB = True

Object.Equals(pointA, pointB) = True

pointA.Equals(null) = False

(pointA == null) = False

(pointA != null) = True

pointA.Equals(i) = False

pointE.Equals(list[0]): True

pointA == (pointC = null) = False

pointC == pointD = True

pointA == (pointC = 3,4) = True

pointD == (pointC = 3,4) = True

*/

Para los structs, la implementación predeterminada de Object.Equals(Object) (que es la

versión invalidada de System.ValueType) realiza una comprobación de igualdad de valor
con la reflexión para comparar valores de cada campo en el tipo. Cuando un
implementador reemplaza el método Equals virtual en una estructura, lo hace para
proporcionar un medio más eficaz de llevar a cabo la comprobación de igualdad de
valores y, opcionalmente, para basar la comparación en un subconjunto de propiedades
o campos de la estructura.

Los operadores == y != no pueden funcionar en un struct a menos que el struct los

sobrecargue explícitamente.

Consulte también
Comparaciones de igualdad
Guía de programación de C#
Procedimiento Probar la igualdad de
referencias (identidad) (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

No tiene que implementar ninguna lógica personalizada para admitir las comparaciones
de igualdad de referencias en los tipos. Esta funcionalidad se proporciona para todos los
tipos mediante el método Object.ReferenceEquals estático.

En el ejemplo siguiente, se muestra cómo determinar si dos variables tienen igualdad de

referencia, lo que significa que hacen referencia al mismo objeto en la memoria.

En el ejemplo también se muestra por qué Object.ReferenceEquals siempre devuelve

false para los tipos de valor y por qué no se debe usar ReferenceEquals para

determinar la igualdad entre cadenas.

Ejemplo
C#

using System.Text;

namespace TestReferenceEquality

struct TestStruct

public int Num { get; private set; }

public string Name { get; private set; }

public TestStruct(int i, string s) : this()

Num = i;

Name = s;

class TestClass

public int Num { get; set; }

public string? Name { get; set; }

class Program

static void Main()

// Demonstrate reference equality with reference types.

#region ReferenceTypes

// Create two reference type instances that have identical

values.

TestClass tcA = new TestClass() { Num = 1, Name = "New

TestClass" };

TestClass tcB = new TestClass() { Num = 1, Name = "New

TestClass" };

Console.WriteLine("ReferenceEquals(tcA, tcB) = {0}",

Object.ReferenceEquals(tcA, tcB)); // false

// After assignment, tcB and tcA refer to the same object.

// They now have reference equality.

tcB = tcA;

Console.WriteLine("After assignment: ReferenceEquals(tcA, tcB) =

{0}",

Object.ReferenceEquals(tcA, tcB)); // true

// Changes made to tcA are reflected in tcB. Therefore, objects

// that have reference equality also have value equality.

tcA.Num = 42;

tcA.Name = "TestClass 42";

Console.WriteLine("tcB.Name = {0} tcB.Num: {1}", tcB.Name,

tcB.Num);

#endregion

// Demonstrate that two value type instances never have

reference equality.

#region ValueTypes

TestStruct tsC = new TestStruct( 1, "TestStruct 1");

// Value types are copied on assignment. tsD and tsC have

// the same values but are not the same object.

TestStruct tsD = tsC;

Console.WriteLine("After assignment: ReferenceEquals(tsC, tsD) =
{0}",

Object.ReferenceEquals(tsC, tsD)); // false

#endregion

#region stringRefEquality

// Constant strings within the same assembly are always interned

by the runtime.

// This means they are stored in the same location in memory.

Therefore,

// the two strings have reference equality although no

assignment takes place.

string strA = "Hello world!";

string strB = "Hello world!";

Console.WriteLine("ReferenceEquals(strA, strB) = {0}",

Object.ReferenceEquals(strA, strB)); // true

 // After a new string is assigned to strA, strA and strB

// are no longer interned and no longer have reference equality.

strA = "Goodbye world!";

Console.WriteLine("strA = \"{0}\" strB = \"{1}\"", strA, strB);

Console.WriteLine("After strA changes, ReferenceEquals(strA,

strB) = {0}",

Object.ReferenceEquals(strA, strB)); // false

// A string that is created at runtime cannot be interned.

StringBuilder sb = new StringBuilder("Hello world!");

string stringC = sb.ToString();

// False:

Console.WriteLine("ReferenceEquals(stringC, strB) = {0}",

Object.ReferenceEquals(stringC, strB));

// The string class overloads the == operator to perform an

equality comparison.

Console.WriteLine("stringC == strB = {0}", stringC == strB); //

true

#endregion

// Keep the console open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

ReferenceEquals(tcA, tcB) = False

After assignment: ReferenceEquals(tcA, tcB) = True

tcB.Name = TestClass 42 tcB.Num: 42

After assignment: ReferenceEquals(tsC, tsD) = False

ReferenceEquals(strA, strB) = True

strA = "Goodbye world!" strB = "Hello world!"

After strA changes, ReferenceEquals(strA, strB) = False

ReferenceEquals(stringC, strB) = False

stringC == strB = True

*/

La implementación de Equals en la clase base universal System.Object también realiza

una comprobación de la igualdad de referencias; sin embargo, es mejor no seguir este
procedimiento porque, en el caso de que una clase invalide el método, los resultados
podrían no ser los esperados. Lo mismo se cumple para los operadores == y != .
Cuando se usan en tipos de referencia, el comportamiento predeterminado de == y !=
consiste en realizar una comprobación de la igualdad de referencias. Sin embargo, las
clases derivadas pueden sobrecargar el operador para realizar una comprobación de la
igualdad de valores. Para minimizar las posibilidades de error, lo mejor es usar siempre
ReferenceEquals cuando deba determinarse si dos objetos tienen igualdad de
referencia.

El runtime siempre aplica el método Intern a las cadenas constantes dentro del mismo
ensamblado. Es decir, solo se conserva una instancia de cada cadena literal única. Pero
el runtime no garantiza que se vaya a aplicar el método Intern a las cadenas creadas en
tiempo de ejecución, ni tampoco que dicho método se aplique a dos cadenas
constantes iguales en distintos ensamblados.

Consulte también
Comparaciones de igualdad
Conversiones de tipos (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Dado que C# tiene tipos estáticos en tiempo de compilación, después de declarar una
variable, no se puede volver a declarar ni se le puede asignar un valor de otro tipo a
menos que ese tipo sea convertible de forma implícita al tipo de la variable. Por
ejemplo, string no se puede convertir de forma implícita a int . Por tanto, después de
declarar i como un valor int , no se le puede asignar la cadena "Hello", como se
muestra en el código siguiente:

C#

int i;

// error CS0029: Cannot implicitly convert type 'string' to 'int'

i = "Hello";

Pero es posible que en ocasiones sea necesario copiar un valor en una variable o
parámetro de método de otro tipo. Por ejemplo, es posible que tenga una variable de
entero que se necesita pasar a un método cuyo parámetro es de tipo double . O es
posible que tenga que asignar una variable de clase a una variable de tipo de interfaz.
Estos tipos de operaciones se denominan conversiones de tipos. En C#, se pueden
realizar las siguientes conversiones de tipos:

Conversiones implícitas: no se requiere ninguna sintaxis especial porque la

conversión siempre es correcta y no se perderá ningún dato. Los ejemplos incluyen
conversiones de tipos enteros más pequeños a más grandes, y conversiones de
clases derivadas a clases base.

Conversiones explícitas: las conversiones explícitas requieren una expresión Cast.

La conversión es necesaria si es posible que se pierda información en la
conversión, o cuando es posible que la conversión no sea correcta por otros
motivos. Entre los ejemplos típicos están la conversión numérica a un tipo que
tiene menos precisión o un intervalo más pequeño, y la conversión de una
instancia de clase base a una clase derivada.

Conversiones definidas por el usuario: las conversiones definidas por el usuario se

realizan por medio de métodos especiales que se pueden definir para habilitar las
conversiones explícitas e implícitas entre tipos personalizados que no tienen una
 relación de clase base-clase derivada. Para obtener más información, vea
Operadores de conversión definidos por el usuario.

Conversiones con clases del asistente: para realizar conversiones entre tipos no
compatibles, como enteros y objetos System.DateTime, o cadenas hexadecimales y
matrices de bytes puede usar la clase System.BitConverter, la clase System.Convert
y los métodos Parse de los tipos numéricos integrados, como Int32.Parse. Para
obtener más información, consulte Procedimiento Convertir una matriz de bytes
en un valor int, Procedimiento Convertir una cadena en un número y
Procedimiento Convertir cadenas hexadecimales en tipos numéricos.

Conversiones implícitas
Para los tipos numéricos integrados, se puede realizar una conversión implícita cuando
el valor que se va a almacenar se puede encajar en la variable sin truncarse ni
redondearse. Para los tipos enteros, esto significa que el intervalo del tipo de origen es
un subconjunto apropiado del intervalo para el tipo de destino. Por ejemplo, una
variable de tipo long (entero de 64 bits) puede almacenar cualquier valor que un tipo int
(entero de 32 bits) pueda almacenar. En el ejemplo siguiente, el compilador convierte de
forma implícita el valor de num en la parte derecha a un tipo long antes de asignarlo a
bigNum .

C#

// Implicit conversion. A long can

// hold any value an int can hold, and more!

int num = 2147483647;

long bigNum = num;

Para obtener una lista completa de las conversiones numéricas implícitas, consulte la
sección Conversiones numéricas implícitas del artículo Conversiones numéricas
integradas.

Para los tipos de referencia, siempre existe una conversión implícita desde una clase a
cualquiera de sus interfaces o clases base directas o indirectas. No se necesita ninguna
sintaxis especial porque una clase derivada siempre contiene a todos los miembros de
una clase base.

C#

Derived d = new Derived();

 // Always OK.

Base b = d;

Conversiones explícitas
Pero si no se puede realizar una conversión sin riesgo de perder información, el
compilador requiere que se realice una conversión explícita, que se denomina
conversión. Una conversión de tipos es una manera de informar explícitamente al
compilador de que se pretende realizar la conversión y se es consciente de que se
puede producir pérdida de datos o la conversión de tipos puede fallar en tiempo de
ejecución. Para realizar una conversión, especifique el tipo al que se va a convertir entre
paréntesis delante del valor o la variable que se va a convertir. El siguiente programa
convierte un tipo double en un tipo int. El programa no se compilará sin la conversión.

C#

class Test

static void Main()

double x = 1234.7;

int a;

// Cast double to int.

a = (int)x;

System.Console.WriteLine(a);

// Output: 1234

Para obtener una lista completa de las conversiones numéricas explícitas admitidas,
consulte la sección Conversiones numéricas explícitas del artículo Conversiones
numéricas integradas.

Para los tipos de referencia, se requiere una conversión explícita si es necesario convertir
de un tipo base a un tipo derivado:

C#

// Create a new derived type.

Giraffe g = new Giraffe();

// Implicit conversion to base type is safe.

Animal a = g;

// Explicit conversion is required to cast back

// to derived type. Note: This will compile but will

 // throw an exception at run time if the right-side

// object is not in fact a Giraffe.

Giraffe g2 = (Giraffe)a;

Una operación de conversión entre tipos de referencia no cambia el tipo en tiempo de

ejecución del objeto subyacente. Solo cambia el tipo del valor que se usa como
referencia a ese objeto. Para obtener más información, vea Polimorfismo .

Excepciones de conversión de tipos en tiempo

de ejecución
En algunas conversiones de tipos de referencia, el compilador no puede determinar si
una conversión será válida. Es posible que una operación de conversión que se compile
correctamente produzca un error en tiempo de ejecución. Como se muestra en el
ejemplo siguiente, una conversión de tipo que produce un error en tiempo de ejecución
produce una excepción InvalidCastException.

C#

class Animal

public void Eat() => System.Console.WriteLine("Eating.");

public override string ToString() => "I am an animal.";

class Reptile : Animal { }

class Mammal : Animal { }

class UnSafeCast

static void Main()

Test(new Mammal());

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
}

static void Test(Animal a)

// System.InvalidCastException at run time

// Unable to cast object of type 'Mammal' to type 'Reptile'

Reptile r = (Reptile)a;

El método Test tiene un parámetro Animal , por lo que la conversión explícita del
argumento a en un Reptile supone una suposición peligrosa. Es más seguro no hacer
suposiciones, sino comprobar el tipo. C# proporciona el operador is para permitir
probar la compatibilidad antes de realizar una conversión. Para obtener más
información, consulte Procedimiento para convertir de forma segura mediante la
coincidencia de patrones y los operadores is y as.

Especificación del lenguaje C#

Para obtener más información, vea la sección sobre conversiones de la Especificación
del lenguaje C#.

Vea también
Guía de programación de C#
Tipos
Expresión Cast
Operadores de conversión definidos por el usuario
Conversión de tipos generalizada
Procedimiento Convertir una cadena en un número
Conversión boxing y unboxing (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

La conversión boxing es el proceso de convertir un tipo de valor en el tipo object o en

cualquier tipo de interfaz implementado por este tipo de valor. Cuando Common
Language Runtime (CLR) aplica la conversión boxing a un tipo de valor, ajusta el valor
dentro de una instancia System.Object y lo almacena en el montón administrado. La
conversión unboxing extrae el tipo de valor del objeto. La conversión boxing es implícita
y la conversión unboxing es explícita. El concepto de conversión boxing y unboxing es la
base de la vista unificada del sistema de tipos de C#, en el que un valor de cualquier
tipo se puede tratar como objeto.

En el ejemplo siguiente, se aplica conversión boxing a la variable de entero i y esta se

asigna al objeto o .

C#

int i = 123;

// The following line boxes i.

object o = i;

Luego se puede aplicar conversión unboxing al objeto o y asignarlo a la variable de

entero i :

C#

o = 123;

i = (int)o; // unboxing

En los ejemplos siguientes se muestra cómo usar la conversión boxing en C#.

C#

// String.Concat example.

// String.Concat has many versions. Rest the mouse pointer on

// Concat in the following statement to verify that the version

// that is used here takes three object arguments. Both 42 and

// true must be boxed.

Console.WriteLine(String.Concat("Answer", 42, true));

// List example.

// Create a list of objects to hold a heterogeneous collection

// of elements.

List<object> mixedList = new List<object>();

// Add a string element to the list.

mixedList.Add("First Group:");

// Add some integers to the list.

for (int j = 1; j < 5; j++)

// Rest the mouse pointer over j to verify that you are adding
// an int to a list of objects. Each element j is boxed when

// you add j to mixedList.

mixedList.Add(j);

// Add another string and more integers.

mixedList.Add("Second Group:");

for (int j = 5; j < 10; j++)

mixedList.Add(j);

// Display the elements in the list. Declare the loop variable by

// using var, so that the compiler assigns its type.

foreach (var item in mixedList)

// Rest the mouse pointer over item to verify that the elements

// of mixedList are objects.

Console.WriteLine(item);

// The following loop sums the squares of the first group of boxed

// integers in mixedList. The list elements are objects, and cannot

// be multiplied or added to the sum until they are unboxed. The

// unboxing must be done explicitly.

var sum = 0;

for (var j = 1; j < 5; j++)

// The following statement causes a compiler error: Operator

// '*' cannot be applied to operands of type 'object' and

// 'object'.

//sum += mixedList[j] * mixedList[j]);

// After the list elements are unboxed, the computation does

// not cause a compiler error.

sum += (int)mixedList[j] * (int)mixedList[j];

// The sum displayed is 30, the sum of 1 + 4 + 9 + 16.

Console.WriteLine("Sum: " + sum);

// Output:

// Answer42True

// First Group:

// 1

 // 2

// 3

// 4

// Second Group:

// 5

// 6

// 7

// 8

// 9

// Sum: 30

Rendimiento
Con relación a las asignaciones simples, las conversiones boxing y unboxing son
procesos que consumen muchos recursos. Cuando se aplica la conversión boxing a un
tipo de valor, se debe asignar y construir un objeto completamente nuevo. En menor
grado, la conversión de tipos requerida para aplicar la conversión unboxing también es
costosa. Para más información, vea Rendimiento.

Boxing
La conversión boxing se utiliza para almacenar tipos de valor en el montón de
recolección de elementos no utilizados. La conversión boxing es una conversión
implícita de un tipo de valor en el tipo object o en cualquier tipo de interfaz
implementado por este tipo de valor. Al aplicar la conversión boxing a un tipo de valor
se asigna una instancia de objeto en el montón y se copia el valor en el nuevo objeto.

Considere la siguiente declaración de una variable de tipo de valor:

C#

int i = 123;

La siguiente instrucción aplica implícitamente la operación de conversión boxing en la

variable i :

C#

// Boxing copies the value of i into object o.

object o = i;

El resultado de esta instrucción es crear una referencia de objeto o en la pila que hace
referencia a un valor del tipo int en el montón. Este valor es una copia del tipo de valor
asignado a la variable i . La diferencia entre las dos variables, i y o , se muestra en la
imagen siguiente de la conversión boxing:

También es posible realizar la conversión boxing de manera explícita, tal como se

muestra en el ejemplo siguiente, pero esta nunca es necesaria:

C#

int i = 123;

object o = (object)i; // explicit boxing

Ejemplo
Este ejemplo convierte una variable de entero i en un objeto o mediante la conversión
boxing. A continuación, el valor almacenado en la variable i se cambia de 123 a 456 . El
ejemplo muestra que el tipo de valor original y el objeto al que se ha aplicado la
conversión boxing usan ubicaciones de memoria independientes y, por consiguiente,
pueden almacenar valores diferentes.

C#

class TestBoxing

static void Main()

int i = 123;

// Boxing copies the value of i into object o.

object o = i;

// Change the value of i.

i = 456;

// The change in i doesn't affect the value stored in o.

System.Console.WriteLine("The value-type value = {0}", i);

System.Console.WriteLine("The object-type value = {0}", o);

/* Output:

The value-type value = 456

 The object-type value = 123

*/

Unboxing
La conversión unboxing es una conversión explícita del tipo object en un tipo de valor
o de un tipo de interfaz en un tipo de valor que implementa la interfaz. Una operación
de conversión unboxing consiste en lo siguiente:

Comprobar la instancia de objeto para asegurarse de que se trata de un valor de

conversión boxing del tipo de valor dado.

Copiar el valor de la instancia en la variable de tipo de valor.

Las siguientes instrucciones muestran las operaciones de conversión boxing y unboxing:

C#

int i = 123; // a value type

object o = i; // boxing

int j = (int)o; // unboxing

En la figura siguiente se muestra el resultado de las instrucciones anteriores:

Para que la conversión unboxing de tipos de valor sea correcta en tiempo de ejecución,
el elemento al que se aplica debe ser una referencia a un objeto creado previamente
mediante la conversión boxing de una instancia de ese tipo de valor. Si se intenta aplicar
la conversión unboxing a null , se producirá una excepción NullReferenceException. Si
se intenta aplicar la conversión unboxing a una referencia de un tipo de valor
incompatible, se producirá una excepción InvalidCastException.

Ejemplo
El ejemplo siguiente muestra un caso de conversión unboxing no válida y la excepción
InvalidCastException resultante. Si se utiliza try y catch , se muestra un mensaje de
error cuando se produce el error.

C#

class TestUnboxing

static void Main()

int i = 123;

object o = i; // implicit boxing

try

int j = (short)o; // attempt to unbox

System.Console.WriteLine("Unboxing OK.");

catch (System.InvalidCastException e)

System.Console.WriteLine("{0} Error: Incorrect unboxing.",

e.Message);

Este programa produce el resultado siguiente:

Specified cast is not valid. Error: Incorrect unboxing.

Si cambia la instrucción:

C#

int j = (short)o;

a:

C#

int j = (int)o;

la conversión se realizará y se obtendrá el resultado:

Unboxing OK.
Especificación del lenguaje C#
Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Guía de programación de C#
Tipos de referencia
Tipos de valor
Procedimiento Convertir una matriz de
bytes en un valor int (Guía de
programación de C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo usar la clase BitConverter para convertir una matriz de
bytes en un valor int y de nuevo en una matriz de bytes. Por ejemplo, es posible que
tenga que realizar una conversión de bytes a un tipo de datos integrado después de
leer los bytes fuera de la red. Además del método ToInt32(Byte[], Int32) del ejemplo, en
la tabla siguiente se muestran los métodos de la clase BitConverter que sirven para
convertir bytes (de una matriz de bytes) en otros tipos integrados.

Tipo devuelto Método

bool ToBoolean(Byte[], Int32)

char ToChar(Byte[], Int32)

double ToDouble(Byte[], Int32)

short ToInt16(Byte[], Int32)

int ToInt32(Byte[], Int32)

long ToInt64(Byte[], Int32)

float ToSingle(Byte[], Int32)

ushort ToUInt16(Byte[], Int32)

uint ToUInt32(Byte[], Int32)

ulong ToUInt64(Byte[], Int32)

Ejemplos
En este ejemplo se inicializa una matriz de bytes, se invierte la matriz si la arquitectura
de equipo es little-endian (es decir, en primer lugar se almacena el byte menos
significativo) y, después, se llama al método ToInt32(Byte[], Int32) para convertir cuatro
bytes de la matriz en int . El segundo argumento de ToInt32(Byte[], Int32)especifica el
índice de inicio de la matriz de bytes.
 ７ Nota

El resultado puede cambiar en función de los modos endian de la arquitectura del

equipo.

C#

byte[] bytes = { 0, 0, 0, 25 };

// If the system architecture is little-endian (that is, little end first),

// reverse the byte array.

if (BitConverter.IsLittleEndian)

Array.Reverse(bytes);

int i = BitConverter.ToInt32(bytes, 0);

Console.WriteLine("int: {0}", i);

// Output: int: 25

En este ejemplo, el método GetBytes(Int32) de la clase BitConverter se llama para

convertir int en una matriz de bytes.

７ Nota

El resultado puede cambiar en función de los modos endian de la arquitectura del

equipo.

C#

byte[] bytes = BitConverter.GetBytes(201805978);

Console.WriteLine("byte array: " + BitConverter.ToString(bytes));

// Output: byte array: 9A-50-07-0C

Consulte también
BitConverter
IsLittleEndian
Tipos
Procedimiento Convertir una cadena en
un número (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Puede convertir string en un número si llama al método Parse o TryParse que se

encuentra en tipos numéricos ( int , long , double , etc.), o bien mediante los métodos de
la clase System.Convert.

Resulta algo más eficaz y sencillo llamar a un método TryParse (por ejemplo,
int.TryParse("11", out number)) o un método Parse (por ejemplo, var number =
int.Parse("11")). El uso de un método Convert resulta más práctico para objetos
generales que implementan IConvertible.

Puede usar los métodos Parse o TryParse sobre el tipo numérico que espera que
contenga la cadena, como el tipo System.Int32. El método Convert.ToInt32 utiliza Parse
internamente. El método Parse devuelve el número convertido; el método TryParse
devuelve un valor booleano que indica si la conversión se realizó correctamente, y
devuelve el número convertido en un parámetro out . Si el formato de la cadena no es
válido, Parse inicia una excepción, pero TryParse devuelve false . Cuando se llama a un
método Parse , siempre debe usar control de excepciones para detectar un
FormatException cuando se produzca un error en la operación de análisis.

Llamada a métodos Parse o TryParse

Los métodos Parse y TryParse no tienen en cuenta los espacios en blanco al principio
ni al final de la cadena, pero todos los demás caracteres deben ser caracteres que
formen el tipo numérico adecuado ( int , long , ulong , float , decimal , etc.). Si hay un
espacio en blanco dentro de la cadena que forma el número, se producirá un error. Por
ejemplo, puede usar el método decimal.TryParse para analizar "10", "10,3" o " 10 ",
pero no para analizar 10 en "10X", "1 0" (fíjese en el espacio insertado), "10 ,3" (fíjese en
el espacio insertado) o "10e1" (ahí funciona float.TryParse ), y así sucesivamente. Una
cadena cuyo valor es null o String.Empty no se puede analizar correctamente. Puede
buscar una cadena nula o vacía antes de intentar analizarla mediante una llamada al
método String.IsNullOrEmpty.

En el siguiente ejemplo se muestran llamadas correctas e incorrectas a Parse y

TryParse .
C#

using System;

public static class StringConversion

public static void Main()

string input = String.Empty;

try

int result = Int32.Parse(input);

Console.WriteLine(result);

catch (FormatException)

Console.WriteLine($"Unable to parse '{input}'");

// Output: Unable to parse ''

try

int numVal = Int32.Parse("-105");

Console.WriteLine(numVal);

catch (FormatException e)
{

Console.WriteLine(e.Message);

// Output: -105

if (Int32.TryParse("-105", out int j))

{

Console.WriteLine(j);
}

else

Console.WriteLine("String could not be parsed.");

// Output: -105

try

int m = Int32.Parse("abc");

catch (FormatException e)
{

Console.WriteLine(e.Message);

// Output: Input string was not in a correct format.

const string inputString = "abc";

if (Int32.TryParse(inputString, out int numValue))

 Console.WriteLine(numValue);

else

Console.WriteLine($"Int32.TryParse could not parse

'{inputString}' to an int.");

// Output: Int32.TryParse could not parse 'abc' to an int.

En el ejemplo siguiente se muestra un enfoque para analizar una cadena que se espera
que incluya caracteres numéricos iniciales (incluidos caracteres hexadecimales) y
caracteres no numéricos finales. Asigna caracteres válidos desde el principio de una
cadena a una nueva cadena antes de llamar al método TryParse. Dado que las cadenas
que va a analizar contiene pocos caracteres, el ejemplo llama al método String.Concat
para asignar caracteres válidos a una nueva cadena. Para una cadena más larga, se
puede usar la clase StringBuilder en su lugar.

C#

using System;

public static class StringConversion

public static void Main()

var str = " 10FFxxx";

string numericString = string.Empty;

foreach (var c in str)

// Check for numeric characters (hex in this case) or leading or

trailing spaces.

if ((c >= '0' && c <= '9') || (char.ToUpperInvariant(c) >= 'A'

&& char.ToUpperInvariant(c) <= 'F') || c == ' ')

numericString = string.Concat(numericString, c.ToString());

else

break;

if (int.TryParse(numericString,
System.Globalization.NumberStyles.HexNumber, null, out int i))

Console.WriteLine($"'{str}' --> '{numericString}' --> {i}");

// Output: ' 10FFxxx' --> ' 10FF' --> 4351

 str = " -10FFXXX";

numericString = "";

foreach (char c in str)

// Check for numeric characters (0-9), a negative sign, or

leading or trailing spaces.

if ((c >= '0' && c <= '9') || c == ' ' || c == '-')

numericString = string.Concat(numericString, c);

else

break;

if (int.TryParse(numericString, out int j))

Console.WriteLine($"'{str}' --> '{numericString}' --> {j}");

// Output: ' -10FFXXX' --> ' -10' --> -10

Llamada a métodos Convert

En la siguiente tabla se muestran algunos de los métodos de la clase Convert que se
pueden usar para convertir una cadena en un número.

Tipo numérico Método

decimal ToDecimal(String)

float ToSingle(String)

double ToDouble(String)

short ToInt16(String)

int ToInt32(String)

long ToInt64(String)

ushort ToUInt16(String)

uint ToUInt32(String)

ulong ToUInt64(String)
En este ejemplo, se llama al método Convert.ToInt32(String) para convertir una cadena
de entrada en un valor int. El ejemplo detecta las dos excepciones más comunes que
este método puede generar, FormatException y OverflowException. Si se puede
incrementar el número resultante sin exceder Int32.MaxValue, el ejemplo suma 1 al
resultado y muestra la salida.

C#

using System;

public class ConvertStringExample1

static void Main(string[] args)

int numVal = -1;

bool repeat = true;

while (repeat)

Console.Write("Enter a number between −2,147,483,648 and

+2,147,483,647 (inclusive): ");

string input = Console.ReadLine();

// ToInt32 can throw FormatException or OverflowException.

try

numVal = Convert.ToInt32(input);

if (numVal < Int32.MaxValue)

Console.WriteLine("The new value is {0}", ++numVal);

else

Console.WriteLine("numVal cannot be incremented beyond

its current value");

catch (FormatException)

Console.WriteLine("Input string is not a sequence of

digits.");

catch (OverflowException)

Console.WriteLine("The number cannot fit in an Int32.");

Console.Write("Go again? Y/N: ");

string go = Console.ReadLine();

if (go.ToUpper() != "Y")

repeat = false;

// Sample Output:

// Enter a number between -2,147,483,648 and +2,147,483,647 (inclusive):

473

// The new value is 474

// Go again? Y/N: y

// Enter a number between -2,147,483,648 and +2,147,483,647 (inclusive):

2147483647

// numVal cannot be incremented beyond its current value

// Go again? Y/N: y

// Enter a number between -2,147,483,648 and +2,147,483,647 (inclusive):

-1000

// The new value is -999

// Go again? Y/N: n

Procedimiento Convertir cadenas

hexadecimales en tipos numéricos (Guía
de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En estos ejemplos se muestra cómo realizar las tareas siguientes:

Obtener el valor hexadecimal de cada uno de los caracteres de un elemento string.

Obtener el elemento char que corresponde a cada valor de una cadena

hexadecimal.

Convertir un elemento string hexadecimal en un elemento int.

Convertir un elemento string hexadecimal en un elemento float.

Convertir una matriz de bytes en un elemento string hexadecimal.

Ejemplos
En este ejemplo se genera el valor hexadecimal de cada uno de los caracteres de
string . Primero, analiza string como una matriz de caracteres. Después, llama a

ToInt32(Char) en cada carácter para obtener su valor numérico. Finalmente, aplica

formato al número como su representación hexadecimal en un elemento string .

C#

string input = "Hello World!";

char[] values = input.ToCharArray();

foreach (char letter in values)

// Get the integral value of the character.

int value = Convert.ToInt32(letter);

// Convert the integer value to a hexadecimal value in string form.

Console.WriteLine($"Hexadecimal value of {letter} is {value:X}");

/* Output:

Hexadecimal value of H is 48

Hexadecimal value of e is 65

Hexadecimal value of l is 6C

Hexadecimal value of l is 6C

Hexadecimal value of o is 6F

Hexadecimal value of is 20

Hexadecimal value of W is 57

 Hexadecimal value of o is 6F

Hexadecimal value of r is 72

Hexadecimal value of l is 6C

Hexadecimal value of d is 64

Hexadecimal value of ! is 21

*/

En este ejemplo se analiza un elemento string de valores hexadecimales y genera el

carácter correspondiente a cada valor hexadecimal. Primero, llama al método
Split(Char[]) para obtener cada valor hexadecimal como un elemento string individual
en una matriz. Después, llama a ToInt32(String, Int32) para convertir el valor hexadecimal
a un valor decimal representado como int. Muestra dos maneras distintas de obtener el
carácter correspondiente a ese código de carácter. En la primera técnica se usa
ConvertFromUtf32(Int32), que devuelve el carácter correspondiente al argumento de
tipo entero como string . En la segunda técnica, int se convierte de manera explícita
en un elemento char.

C#

string hexValues = "48 65 6C 6C 6F 20 57 6F 72 6C 64 21";

string[] hexValuesSplit = hexValues.Split(' ');

foreach (string hex in hexValuesSplit)

// Convert the number expressed in base-16 to an integer.

int value = Convert.ToInt32(hex, 16);

// Get the character corresponding to the integral value.

string stringValue = Char.ConvertFromUtf32(value);

char charValue = (char)value;

Console.WriteLine("hexadecimal value = {0}, int value = {1}, char value

= {2} or {3}",

hex, value, stringValue, charValue);

/* Output:

hexadecimal value = 48, int value = 72, char value = H or H

hexadecimal value = 65, int value = 101, char value = e or e

hexadecimal value = 6C, int value = 108, char value = l or l

hexadecimal value = 6C, int value = 108, char value = l or l

hexadecimal value = 6F, int value = 111, char value = o or o

hexadecimal value = 20, int value = 32, char value = or

hexadecimal value = 57, int value = 87, char value = W or W

hexadecimal value = 6F, int value = 111, char value = o or o

hexadecimal value = 72, int value = 114, char value = r or r

hexadecimal value = 6C, int value = 108, char value = l or l

hexadecimal value = 64, int value = 100, char value = d or d

hexadecimal value = 21, int value = 33, char value = ! or !

*/

En este ejemplo se muestra otra manera de convertir un string hexadecimal en un

entero mediante la llamada al método Parse(String, NumberStyles).

C#

string hexString = "8E2";

int num = Int32.Parse(hexString,

System.Globalization.NumberStyles.HexNumber);

Console.WriteLine(num);

//Output: 2274

En el siguiente ejemplo se muestra cómo convertir un string hexadecimal en un

elemento float con la clase System.BitConverter y el método UInt32.Parse.

C#

string hexString = "43480170";

uint num = uint.Parse(hexString,

System.Globalization.NumberStyles.AllowHexSpecifier);

byte[] floatVals = BitConverter.GetBytes(num);

float f = BitConverter.ToSingle(floatVals, 0);

Console.WriteLine("float convert = {0}", f);

// Output: 200.0056

En el ejemplo siguiente se muestra cómo convertir una matriz byte en una cadena
hexadecimal mediante la clase System.BitConverter.

C#

byte[] vals = { 0x01, 0xAA, 0xB1, 0xDC, 0x10, 0xDD };

string str = BitConverter.ToString(vals);

Console.WriteLine(str);

str = BitConverter.ToString(vals).Replace("-", "");

Console.WriteLine(str);

/*Output:

01-AA-B1-DC-10-DD

01AAB1DC10DD

*/

En el ejemplo siguiente se muestra cómo convertir una matriz byte en una cadena
hexadecimal mediante una llamada al método Convert.ToHexString introducido en
.NET 5.0.
 C#

byte[] array = { 0x64, 0x6f, 0x74, 0x63, 0x65, 0x74 };

string hexValue = Convert.ToHexString(array);

Console.WriteLine(hexValue);

/*Output:

646F74636574

*/

Vea también
Cadenas con formato numérico estándar
Tipos
Determinación de si una cadena representa un valor numérico
Using type dynamic
Artículo • 25/02/2023 • Tiempo de lectura: 4 minutos

The dynamic type is a static type, but an object of type dynamic bypasses static type
checking. In most cases, it functions like it has type object . The compiler assumes a
dynamic element supports any operation. Therefore, you don't have to determine
whether the object gets its value from a COM API, from a dynamic language such as
IronPython, from the HTML Document Object Model (DOM), from reflection, or from
somewhere else in the program. However, if the code isn't valid, errors surface at run
time.

For example, if instance method exampleMethod1 in the following code has only one
parameter, the compiler recognizes that the first call to the method,
ec.exampleMethod1(10, 4) , isn't valid because it contains two arguments. The call causes

a compiler error. The compiler doesn't check the second call to the method,
dynamic_ec.exampleMethod1(10, 4) , because the type of dynamic_ec is dynamic .

Therefore, no compiler error is reported. However, the error doesn't escape notice
indefinitely. It appears at run time and causes a run-time exception.

C#

static void Main(string[] args)

ExampleClass ec = new ExampleClass();

// The following call to exampleMethod1 causes a compiler error

// if exampleMethod1 has only one parameter. Uncomment the line

// to see the error.

//ec.exampleMethod1(10, 4);

dynamic dynamic_ec = new ExampleClass();

// The following line is not identified as an error by the

// compiler, but it causes a run-time exception.

dynamic_ec.exampleMethod1(10, 4);

// The following calls also do not cause compiler errors, whether

// appropriate methods exist or not.

dynamic_ec.someMethod("some argument", 7, null);

dynamic_ec.nonexistentMethod();

C#

class ExampleClass

public ExampleClass() { }

 public ExampleClass(int v) { }

public void exampleMethod1(int i) { }

public void exampleMethod2(string str) { }

The role of the compiler in these examples is to package together information about
what each statement is proposing to do to the dynamic object or expression. The
runtime examines the stored information and any statement that isn't valid causes a
run-time exception.

The result of most dynamic operations is itself dynamic . For example, if you rest the
mouse pointer over the use of testSum in the following example, IntelliSense displays
the type (local variable) dynamic testSum.

C#

dynamic d = 1;

var testSum = d + 3;

// Rest the mouse pointer over testSum in the following statement.

System.Console.WriteLine(testSum);

Operations in which the result isn't dynamic include:

Conversions from dynamic to another type.

Constructor calls that include arguments of type dynamic .

For example, the type of testInstance in the following declaration is ExampleClass , not
dynamic :

C#

var testInstance = new ExampleClass(d);

Conversions
Conversions between dynamic objects and other types are easy. Conversions enable the
developer to switch between dynamic and non-dynamic behavior.

You can convert any to dynamic implicitly, as shown in the following examples.

C#
 dynamic d1 = 7;

dynamic d2 = "a string";

dynamic d3 = System.DateTime.Today;

dynamic d4 = System.Diagnostics.Process.GetProcesses();

Conversely, you can dynamically apply any implicit conversion to any expression of type
dynamic .

C#

int i = d1;

string str = d2;

DateTime dt = d3;

System.Diagnostics.Process[] procs = d4;

Overload resolution with arguments of type

dynamic
Overload resolution occurs at run time instead of at compile time if one or more of the
arguments in a method call have the type dynamic , or if the receiver of the method call
is of type dynamic . In the following example, if the only accessible exampleMethod2
method takes a string argument, sending d1 as the argument doesn't cause a compiler
error, but it does cause a run-time exception. Overload resolution fails at run time
because the run-time type of d1 is int , and exampleMethod2 requires a string.

C#

// Valid.

ec.exampleMethod2("a string");

// The following statement does not cause a compiler error, even though ec
is not

// dynamic. A run-time exception is raised because the run-time type of d1

is int.

ec.exampleMethod2(d1);

// The following statement does cause a compiler error.

//ec.exampleMethod2(7);

Dynamic language runtime

The dynamic language runtime (DLR) provides the infrastructure that supports the
dynamic type in C#, and also the implementation of dynamic programming languages
such as IronPython and IronRuby. For more information about the DLR, see Dynamic
Language Runtime Overview.

COM interop
Many COM methods allow for variation in argument types and return type by
designating the types as object . COM interop necessitates explicit casting of the values
to coordinate with strongly typed variables in C#. If you compile by using the
EmbedInteropTypes (C# Compiler Options) option, the introduction of the dynamic type
enables you to treat the occurrences of object in COM signatures as if they were of
type dynamic , and thereby to avoid much of the casting. For more information on using
the dynamic type with COM objects, see the article on How to access Office interop
objects by using C# features.

Related articles
Title Description

dynamic Describes the usage of the dynamic keyword.

Dynamic Language Provides an overview of the DLR, which is a runtime environment that
Runtime Overview adds a set of services for dynamic languages to the common language
runtime (CLR).

Walkthrough: Creating Provides step-by-step instructions for creating a custom dynamic object
and Using Dynamic and for creating a project that accesses an IronPython library.
Objects
Tutorial: Crear y usar objetos dinámicos
en C#
Artículo • 03/03/2023 • Tiempo de lectura: 9 minutos

Los objetos dinámicos exponen miembros como propiedades y métodos en tiempo de

ejecución, en lugar de en tiempo de compilación. Los objetos dinámicos le permiten
crear objetos para trabajar con estructuras que no coinciden con un formato o tipo
estático. Por ejemplo, puede usar un objeto dinámico para hacer referencia a Document
Object Model (DOM) HTML, que puede contener cualquier combinación de atributos y
elementos de marcado HTML válidos. Dado que cada documento HTML es único, los
miembros de un documento HTML específico se determinan en tiempo de ejecución.
Un método común para hacer referencia a un atributo de un elemento HTML consiste
en pasar el nombre del atributo al método GetProperty del elemento. Para hacer
referencia al atributo id del elemento HTML <div id="Div1"> , primero debe obtener
una referencia al elemento <div> y, después, usar divElement.GetProperty("id") . Si usa
un objeto dinámico, puede hacer referencia al atributo id como divElement.id .

Los objetos dinámicos también proporcionan un acceso cómodo a lenguajes dinámicos

como IronPython e IronRuby. Puede usar un objeto dinámico para hacer referencia a un
script dinámico interpretado en tiempo de ejecución.

Para hacer referencia a un objeto dinámico, use un enlace en tiempo de ejecución.

Especifique el tipo de un objeto enlazado en tiempo de ejecución como dynamic . Para
obtener más información, consulte dynamic.

Puede crear objetos dinámicos personalizados con las clases del espacio de nombres
System.Dynamic. Por ejemplo, puede crear un objeto ExpandoObject y especificar los
miembros de ese objeto en tiempo de ejecución. También puede crear su propio tipo
que hereda la clase DynamicObject. Después, puede invalidar los miembros de la clase
DynamicObject para proporcionar funciones dinámicas en tiempo de ejecución.

Este artículo contiene dos tutoriales independientes:

Crear un objeto personalizado que expone dinámicamente el contenido de un

archivo de texto como propiedades de un objeto.
Crear un proyecto que usa una biblioteca IronPython .

Requisitos previos
 Visual Studio 2022, versión 17.3 o posterior con la carga de trabajo Desarrollo de
escritorio de .NET instalada. El SDK de .NET 7 se incluye al seleccionar esta carga
de trabajo.

７ Nota

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos

de los elementos de la interfaz de usuario de Visual Studio en las siguientes
instrucciones. La edición de Visual Studio que se tenga y la configuración que se
utilice determinan estos elementos. Para obtener más información, vea
Personalizar el IDE.

En el segundo tutorial, instale IronPython para .NET. Vaya a su página de

descarga para obtener la versión más reciente.

Creación de un objeto dinámico personalizado

En el primer tutorial se define un objeto dinámico personalizado que busca en el
contenido de un archivo de texto. Una propiedad dinámica especifica el texto que se va
a buscar. Por ejemplo, si el código de llamada especifica dynamicFile.Sample , la clase
dinámica devuelve una lista genérica de cadenas que contiene todas las líneas del
archivo que comienzan con "Sample". La búsqueda no distingue entre mayúsculas y
minúsculas. La clase dinámica también admite dos argumentos opcionales. El primer
argumento es un valor de enumeración de opción de búsqueda que especifica que la
clase dinámica debe buscar coincidencias al principio de la línea, al final de la línea o en
cualquier parte de la línea. El segundo argumento especifica que la clase dinámica debe
recortar los espacios iniciales y finales de cada línea antes de buscar. Por ejemplo, si el
código de llamada especifica dynamicFile.Sample(StringSearchOption.Contains) , la clase
dinámica busca "Sample" en cualquier parte de una línea. Si el código de llamada
especifica dynamicFile.Sample(StringSearchOption.StartsWith, false) , la clase
dinámica busca "Sample" al principio de cada línea y no quita los espacios iniciales y
finales. El comportamiento predeterminado de la clase dinámica es buscar una
coincidencia al principio de cada línea y quitar los espacios iniciales y finales.

Crear una clase dinámica personalizada

Inicie Visual Studio. Seleccione Crear un proyecto. En el cuadro de diálogo Crear un
proyecto, seleccione C#, después Aplicación de consola y luego Siguiente. En el cuadro
de diálogo Configurar el nuevo proyecto, escriba DynamicSample como Nombre del
proyecto y, después, seleccione Siguiente. En el cuadro de diálogo Información
adicional, seleccione .NET 7.0 (actual) para Plataforma de destino y después Crear. En
el Explorador de soluciones, haga clic con el botón derecho en el proyecto
DynamicSample y seleccione Agregar>Clase. En el cuadro Nombre, escriba
ReadOnlyFile y, después, seleccione Agregar. En la parte superior del archivo
ReadOnlyFile.cs o ReadOnlyFile.vb, agregue el código siguiente para importar los
espacios de nombres System.IO y System.Dynamic.

C#

using System.IO;

using System.Dynamic;

El objeto dinámico personalizado usa una enumeración para determinar los criterios de
búsqueda. Antes de la instrucción de clase, agregue la siguiente definición de
enumeración.

C#

public enum StringSearchOption

StartsWith,

Contains,

EndsWith

Actualice la instrucción de clase para heredar la clase DynamicObject , como se muestra

en el ejemplo de código siguiente.

C#

class ReadOnlyFile : DynamicObject

Agregue el código siguiente a la clase ReadOnlyFile para definir un campo privado para
la ruta de acceso y un constructor para la clase ReadOnlyFile .

C#

// Store the path to the file and the initial line count value.

private string p_filePath;

// Public constructor. Verify that file exists and store the path in

// the private variable.

public ReadOnlyFile(string filePath)

if (!File.Exists(filePath))

 throw new Exception("File path does not exist.");

p_filePath = filePath;

1. Agregue el método GetPropertyValue siguiente a la clase ReadOnlyFile . El método

GetPropertyValue toma como entrada criterios de búsqueda y devuelve las líneas
de un archivo de texto que coinciden con los criterios de búsqueda. Los métodos
dinámicos proporcionados por la clase ReadOnlyFile llaman al método
GetPropertyValue para recuperar los resultados correspondientes.

C#

public List<string> GetPropertyValue(string propertyName,

StringSearchOption StringSearchOption =
StringSearchOption.StartsWith,

bool trimSpaces = true)

StreamReader sr = null;

List<string> results = new List<string>();

string line = "";

string testLine = "";

try

sr = new StreamReader(p_filePath);

while (!sr.EndOfStream)

line = sr.ReadLine();

// Perform a case-insensitive search by using the specified

search options.

testLine = line.ToUpper();

if (trimSpaces) { testLine = testLine.Trim(); }

switch (StringSearchOption)

case StringSearchOption.StartsWith:

if (testLine.StartsWith(propertyName.ToUpper())) {
results.Add(line); }

break;

case StringSearchOption.Contains:

if (testLine.Contains(propertyName.ToUpper())) {
results.Add(line); }

break;

case StringSearchOption.EndsWith:

if (testLine.EndsWith(propertyName.ToUpper())) {
results.Add(line); }

break;

catch

// Trap any exception that occurs in reading the file and return
null.

results = null;

finally

if (sr != null) {sr.Close();}

return results;

Después del método GetPropertyValue , agregue el código siguiente para invalidar el

método TryGetMember de la clase DynamicObject. Se llama al método TryGetMember
cuando se solicita un miembro de una clase dinámica y no se especifican argumentos. El
argumento binder contiene información sobre el miembro al que se hace referencia y el
argumento result hace referencia al resultado devuelto para el miembro especificado.
El método TryGetMember devuelve un valor booleano que devuelve true si el miembro
solicitado existe. En caso contrario, devuelve false .

C#

// Implement the TryGetMember method of the DynamicObject class for dynamic

member calls.

public override bool TryGetMember(GetMemberBinder binder,

out object result)

result = GetPropertyValue(binder.Name);

return result == null ? false : true;

Después del método TryGetMember , agregue el código siguiente para invalidar el

método TryInvokeMember de la clase DynamicObject. Se llama al método
TryInvokeMember cuando se solicita un miembro de una clase dinámica con
argumentos. El argumento binder contiene información sobre el miembro al que se
hace referencia y el argumento result hace referencia al resultado devuelto para el
miembro especificado. El argumento args contiene una matriz de los argumentos que
se pasan al miembro. El método TryInvokeMember devuelve un valor booleano que
devuelve true si el miembro solicitado existe. En caso contrario, devuelve false .
La versión personalizada del método TryInvokeMember espera que el primer argumento
sea un valor del enumerador StringSearchOption que se ha definido en un paso
anterior. El método TryInvokeMember espera que el segundo argumento sea un valor
booleano. Si uno o ambos argumentos son valores válidos, se pasan al método
GetPropertyValue para recuperar los resultados.

C#

// Implement the TryInvokeMember method of the DynamicObject class for

// dynamic member calls that have arguments.

public override bool TryInvokeMember(InvokeMemberBinder binder,

object[] args,

out object result)

StringSearchOption StringSearchOption = StringSearchOption.StartsWith;

bool trimSpaces = true;

try

if (args.Length > 0) { StringSearchOption =

(StringSearchOption)args[0]; }

catch

throw new ArgumentException("StringSearchOption argument must be a

StringSearchOption enum value.");
}

try

if (args.Length > 1) { trimSpaces = (bool)args[1]; }

catch

throw new ArgumentException("trimSpaces argument must be a Boolean

value.");

result = GetPropertyValue(binder.Name, StringSearchOption, trimSpaces);

return result == null ? false : true;

Guarde y cierre el archivo.

Creación de un archivo de texto de ejemplo

En el Explorador de soluciones, haga clic con el botón derecho en el proyecto
DynamicSample y seleccione Agregar>Nuevo elemento. En el panel Plantillas
instaladas seleccione General y, luego, la plantilla Archivo de texto. Deje el nombre
predeterminado TextFile1.txt en el cuadro Nombre y después seleccione Agregar. Copie
el texto siguiente en el archivo TextFile1.txt.

text

List of customers and suppliers

Supplier: Lucerne Publishing (https://www.lucernepublishing.com/)

Customer: Preston, Chris

Customer: Hines, Patrick

Customer: Cameron, Maria

Supplier: Graphic Design Institute (https://www.graphicdesigninstitute.com/)

Supplier: Fabrikam, Inc. (https://www.fabrikam.com/)

Customer: Seubert, Roxanne

Supplier: Proseware, Inc. (http://www.proseware.com/)

Customer: Adolphi, Stephan

Customer: Koch, Paul

Guarde y cierre el archivo.

Creación de una aplicación de ejemplo que usa el objeto

dinámico personalizado
En el Explorador de soluciones, haga doble clic en el archivo Program.cs. Agregue el
código siguiente al procedimiento Main para crear una instancia de la clase
ReadOnlyFile para el archivo TextFile1.txt. El código usa el enlace en tiempo de

ejecución para llamar a miembros dinámicos y recuperar líneas de texto que contienen
la cadena "Customer".

C#

dynamic rFile = new ReadOnlyFile(@"..\..\..\TextFile1.txt");

foreach (string line in rFile.Customer)

Console.WriteLine(line);

Console.WriteLine("----------------------------");

foreach (string line in rFile.Customer(StringSearchOption.Contains, true))

Console.WriteLine(line);

Guarde el archivo y presione Ctrl+ F5 para compilar y ejecutar la aplicación.

Llamada a una biblioteca de lenguaje dinámico
En el tutorial siguiente se crea un proyecto que accede a una biblioteca escrita en el
lenguaje dinámico IronPython.

Para crear una clase dinámica personalizada

Abra Visual Studio, seleccione Archivo>Nuevo>Proyecto. En el cuadro de diálogo Crear
un proyecto, seleccione C#, después Aplicación de consola y luego Siguiente. En el
cuadro de diálogo Configurar el nuevo proyecto, escriba DynamicIronPythonSample
como Nombre del proyecto y, después, seleccione Siguiente. En el cuadro de diálogo
Información adicional, seleccione .NET 7.0 (actual) para Plataforma de destino y
después Crear. Instale el paquete NuGet IronPython . Edite el archivo Program.cs. En la
parte superior del archivo, agregue el código siguiente para importar los espacios de
nombres Microsoft.Scripting.Hosting y IronPython.Hosting de las bibliotecas de
IronPython, y el espacio de nombres System.Linq .

C#

using System.Linq;

using Microsoft.Scripting.Hosting;

using IronPython.Hosting;

En el método Main, agregue el código siguiente para crear un objeto

Microsoft.Scripting.Hosting.ScriptRuntime que hospede las bibliotecas de IronPython.

El objeto ScriptRuntime carga el módulo de biblioteca de IronPython random.py.

C#

// Set the current directory to the IronPython libraries.

System.IO.Directory.SetCurrentDirectory(

Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles) +

@"\IronPython 2.7\Lib");

// Create an instance of the random.py IronPython library.

Console.WriteLine("Loading random.py");

ScriptRuntime py = Python.CreateRuntime();

dynamic random = py.UseFile("random.py");

Console.WriteLine("random.py loaded.");

Una vez que el código haya cargado el módulo random.py, agregue el código siguiente
para crear una matriz de enteros. La matriz se pasa al método shuffle del módulo
random.py, que ordena aleatoriamente los valores de la matriz.
 C#

// Initialize an enumerable set of integers.

int[] items = Enumerable.Range(1, 7).ToArray();

// Randomly shuffle the array of integers by using IronPython.

for (int i = 0; i < 5; i++)

random.shuffle(items);

foreach (int item in items)

Console.WriteLine(item);

Console.WriteLine("-------------------");

Guarde el archivo y presione Ctrl+ F5 para compilar y ejecutar la aplicación.

Consulte también
System.Dynamic
System.Dynamic.DynamicObject
Uso de tipo dinámico
dynamic
Implementar interfaces dinámicas (PDF descargable de Microsoft TechNet)
Control de versiones con las palabras
clave Override y New (Guía de
programación de C#)
Artículo • 02/03/2023 • Tiempo de lectura: 5 minutos

El lenguaje C# está diseñado para que las versiones entre clases base y derivadas de
diferentes bibliotecas puedan evolucionar y mantener la compatibilidad con versiones
anteriores. Esto significa, por ejemplo, que la introducción de un nuevo miembro en una
clase base con el mismo nombre que un miembro de una clase derivada es totalmente
compatible con C# y no lleva a un comportamiento inesperado. Además, implica que
una clase debe declarar explícitamente si un método está pensado para reemplazar un
método heredado o si se trata de un nuevo método que oculta un método heredado de
nombre similar.

En C#, las clases derivadas pueden contener métodos con el mismo nombre que los
métodos de clase base.

Si el método de la clase derivada no va precedido por las palabras clave new u

override, el compilador emite una advertencia y el método se comporta como si la
palabra clave new estuviese presente.

Si el método de la clase derivada va precedido de la palabra clave new , el método

se define como independiente del método de la clase base.

Si el método de la clase derivada va precedido de la palabra clave override , los

objetos de la clase derivada llamarán a ese método y no al método de la clase
base.

Para aplicar la palabra clave override al método de la clase derivada, se debe

definir el método de clase base como virtual.

El método de clase base puede llamarse desde dentro de la clase derivada

mediante la palabra clave base .

Las palabras clave override , virtual y new también pueden aplicarse a

propiedades, indexadores y eventos.

De forma predeterminada, los métodos de C# no son virtuales. Si se declara un método

como virtual, toda clase que hereda el método puede implementar su propia versión
Para que un método sea virtual, se usa el modificador virtual en la declaración del
método de la clase base. La clase derivada puede luego reemplazar el método base
virtual mediante la palabra clave override u ocultar el método virtual en la clase base
mediante la palabra clave new . Si no se especifican las palabras clave override o new , el
compilador emite una advertencia y el método de la clase derivada oculta el método de
la clase base.

Para demostrar esto en la práctica, supongamos por un momento que la compañía A ha

creado una clase denominada GraphicsClass , que su programa usa. La siguiente es
GraphicsClass :

C#

class GraphicsClass

public virtual void DrawLine() { }

public virtual void DrawPoint() { }

Su compañía usa esta clase y usted la usa para derivar su propia clase, agregando un
nuevo método:

C#

class YourDerivedGraphicsClass : GraphicsClass

public void DrawRectangle() { }

La aplicación se usa sin problemas, hasta que la compañía A lanza una nueva versión de
GraphicsClass , que es similar al código siguiente:

C#

class GraphicsClass

public virtual void DrawLine() { }

public virtual void DrawPoint() { }

public virtual void DrawRectangle() { }

La nueva versión de GraphicsClass contiene ahora un método denominado

DrawRectangle . Inicialmente, no sucede nada. La nueva versión sigue siendo compatible
a nivel binario con la versión anterior. Cualquier software que haya implementado
seguirá funcionando, aunque la nueva clase se instale en esos sistemas informáticos.
Cualquier llamada existente al método DrawRectangle seguirá haciendo referencia a su
versión en la clase derivada.
Pero en cuanto vuelva a compilar la aplicación con la nueva versión de GraphicsClass ,
recibirá una advertencia del compilador, CS0108. Esta advertencia le informa de que
debe plantearse cómo quiere que el método DrawRectangle se comporte en la
aplicación.

Si quiere que su método reemplace al nuevo método de clase base, use la palabra clave
override :

C#

class YourDerivedGraphicsClass : GraphicsClass

public override void DrawRectangle() { }

La palabra clave override se asegura de que los objetos derivados de

YourDerivedGraphicsClass usen la versión de la clase derivada de DrawRectangle . Los

objetos derivados de YourDerivedGraphicsClass todavía pueden acceder a la versión de

clase base DrawRectangle mediante la palabra clave base:

C#

base.DrawRectangle();

Si no quiere que el método reemplace al nuevo método de clase base, se aplican las
consideraciones siguientes. Para evitar la confusión entre los dos métodos, puede
cambiarle el nombre a su método. Esto puede ser un proceso lento y propenso a errores
y no resultar práctico en algunos casos. Pero si el proyecto es relativamente pequeño,
puede usar opciones de refactorización de Visual Studio para cambiar el nombre del
método. Para obtener más información, vea Refactoring Classes and Types (Class
Designer) (Refactorización de clases y tipos [Diseñador de clases]).

También puede evitar la advertencia mediante la palabra clave new en la definición de

clase derivada:

C#

class YourDerivedGraphicsClass : GraphicsClass

public new void DrawRectangle() { }

Con la palabra clave new se indica al compilador que su definición oculta la definición
contenida en la clase base. Éste es el comportamiento predeterminado.

Selección de método y reemplazo

Cuando se llama a un método en una clase, el compilador de C# selecciona el mejor
método para llamar si hay más de uno compatible con la llamada, como cuando hay
dos métodos con el mismo nombre y parámetros que son compatibles con el
parámetro pasado. Los métodos siguientes serían compatibles:

C#

public class Derived : Base

public override void DoWork(int param) { }

public void DoWork(double param) { }

Cuando se llama a DoWork en una instancia de Derived , el compilador de C# intentará

en primer lugar que la llamada sea compatible con las versiones de DoWork declaradas
originalmente en Derived . Los métodos de reemplazo no se consideran como
declarados en una clase, son nuevas implementaciones de un método que se declara en
una clase base. Solo si el compilador de C# no puede hacer coincidir la llamada de
método con un método original en Derived , intentará hacer coincidir la llamada con un
método reemplazado con el mismo nombre y parámetros compatibles. Por ejemplo:

C#

int val = 5;

Derived d = new Derived();

d.DoWork(val); // Calls DoWork(double).

Dado que la variable val se puede convertir implícitamente en un valor doble, el

compilador de C# llama a DoWork(double) en lugar de a DoWork(int) . Hay dos maneras
de evitarlo. En primer lugar, evite declarar nuevos métodos con el mismo nombre que
los métodos virtuales. En segundo lugar, puede indicar al compilador de C# que llame al
método virtual haciendo que busque la lista de métodos de clase base mediante la
conversión de la instancia de Derived a Base . Como el método es virtual, se llamará a la
implementación de DoWork(int) en Derived . Por ejemplo:

C#
 ((Base)d).DoWork(val); // Calls DoWork(int) on Derived.

Para obtener otros ejemplos de new y override , vea Saber cuándo utilizar las palabras
clave Override y New (Guía de programación de C#).

Vea también
Guía de programación de C#
El sistema de tipos de C#
Métodos
Herencia
Saber cuándo utilizar las palabras clave
Override y New (Guía de programación
de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 11 minutos

En C#, un método de una clase derivada puede tener el mismo nombre que un método
de la clase base. Se puede especificar cómo interactúan los métodos mediante las
palabras clave new y override. El modificador override extiende el método de clase base
virtual y el modificador new oculta un método de clase base accesible. En los ejemplos
de este tema se ilustra la diferencia.

En una aplicación de consola, declare las dos clases siguientes, BaseClass y

DerivedClass . DerivedClass hereda de BaseClass .

C#

class BaseClass

public void Method1()

Console.WriteLine("Base - Method1");

class DerivedClass : BaseClass

public void Method2()

Console.WriteLine("Derived - Method2");

En el método Main , declare las variables bc , dc y bcdc .

bc es de tipo BaseClass , y su valor es de tipo BaseClass .

dc es de tipo DerivedClass , y su valor es de tipo DerivedClass .

bcdc es de tipo BaseClass , y su valor es de tipo DerivedClass . Esta es la variable a

la que hay que prestar atención.

Dado que bc y bcdc tienen el tipo BaseClass , solo pueden tener acceso directo a
Method1 , a menos que se use la conversión. La variable dc puede tener acceso a
Method1 y Method2 . Estas relaciones se muestran en el código siguiente.

C#

class Program

static void Main(string[] args)

BaseClass bc = new BaseClass();

DerivedClass dc = new DerivedClass();

BaseClass bcdc = new DerivedClass();

bc.Method1();

dc.Method1();

dc.Method2();

bcdc.Method1();

// Output:

// Base - Method1

// Base - Method1

// Derived - Method2

// Base - Method1

Después, agregue el método Method2 siguiente a BaseClass . La firma de este método

coincide con la firma del método Method2 de DerivedClass .

C#

public void Method2()

Console.WriteLine("Base - Method2");

Dado que BaseClass ahora tiene un método Method2 , se puede agregar una segunda
instrucción de llamada para las variables de BaseClass bc y bcdc , como se muestra en el
código siguiente.

C#

bc.Method1();

bc.Method2();

dc.Method1();

dc.Method2();

bcdc.Method1();

bcdc.Method2();

Al compilar el proyecto, verá que la adición del método Method2 de BaseClass genera
una advertencia. La advertencia indica que el método Method2 de DerivedClass oculta el
método Method2 de BaseClass . Se recomienda usar la palabra clave new en la definición
de Method2 si se pretende provocar ese resultado. Como alternativa, se puede cambiar
el nombre de uno de los métodos Method2 para resolver la advertencia, pero eso no
siempre resulta práctico.

Antes de agregar new , ejecute el programa para ver el resultado producido por las
instrucciones adicionales que realizan la llamada. Se muestran los resultados siguientes.

C#

// Output:

// Base - Method1

// Base - Method2

// Base - Method1

// Derived - Method2

// Base - Method1

// Base - Method2

La palabra clave new conserva las relaciones que generan ese resultado, pero se suprime
la advertencia. Las variables de tipo BaseClass siguen teniendo acceso a los miembros
de BaseClass y la variable de tipo DerivedClass sigue teniendo acceso a los miembros
de DerivedClass en primer lugar y, después, tiene en cuenta los miembros heredados
de BaseClass .

Para suprimir la advertencia, agregue el modificador new a la definición de Method2 en

DerivedClass , como se muestra en el código siguiente. Se puede agregar el modificador

antes o después de public .

C#

public new void Method2()

Console.WriteLine("Derived - Method2");

Vuelva a ejecutar el programa para comprobar que el resultado no ha cambiado.

Compruebe también que ya no aparece la advertencia. Mediante el uso de new , afirma
que es consciente de que el miembro que modifica oculta un miembro heredado de la
clase base. Para más información sobre la ocultación de nombres a través de la herencia,
vea new (Modificador, Referencia de C#).
Para contrastar este comportamiento con los efectos de usar override , agregue el
método siguiente a DerivedClass . Se puede agregar el modificador override antes o
después de public .

C#

public override void Method1()

Console.WriteLine("Derived - Method1");

Agregue el modificador virtual a la definición de Method1 en BaseClass . Se puede

agregar el modificador virtual antes o después de public .

C#

public virtual void Method1()

Console.WriteLine("Base - Method1");

Vuelva a ejecutar el proyecto. Observe especialmente las dos últimas líneas del
resultado siguiente.

C#

// Output:

// Base - Method1

// Base - Method2

// Derived - Method1

// Derived - Method2

// Derived - Method1

// Base - Method2

El uso del modificador override permite que bcdc tenga acceso al método Method1 que
se define en DerivedClass . Normalmente, es el comportamiento deseado en jerarquías
de herencia. La intención es que los objetos que tienen valores que se crean a partir de
la clase derivada usen los métodos que se definen en la clase derivada. Ese
comportamiento se consigue mediante el uso de override para extender el método de
clase base.

El código siguiente contiene el ejemplo completo.

C#
using System;

using System.Text;

namespace OverrideAndNew

class Program

static void Main(string[] args)

BaseClass bc = new BaseClass();

DerivedClass dc = new DerivedClass();

BaseClass bcdc = new DerivedClass();

// The following two calls do what you would expect. They call

// the methods that are defined in BaseClass.

bc.Method1();

bc.Method2();

// Output:

// Base - Method1

// Base - Method2

// The following two calls do what you would expect. They call

// the methods that are defined in DerivedClass.

dc.Method1();

dc.Method2();

// Output:

// Derived - Method1

// Derived - Method2

// The following two calls produce different results, depending

// on whether override (Method1) or new (Method2) is used.

bcdc.Method1();

bcdc.Method2();

// Output:

// Derived - Method1

// Base - Method2

class BaseClass

public virtual void Method1()

Console.WriteLine("Base - Method1");

public virtual void Method2()

Console.WriteLine("Base - Method2");

class DerivedClass : BaseClass

 public override void Method1()

Console.WriteLine("Derived - Method1");

public new void Method2()

Console.WriteLine("Derived - Method2");

En el ejemplo siguiente se muestra un comportamiento similar en un contexto diferente.

El ejemplo define tres clases: una clase base denominada Car y dos clases que se
derivan de ella, ConvertibleCar y Minivan . La clase base contiene un método
DescribeCar . El método muestra una descripción básica de un automóvil y, después,
llama a ShowDetails para proporcionar información adicional. Cada una de las tres
clases define un método ShowDetails . El modificador new se usa para definir
ShowDetails en la clase ConvertibleCar . El modificador override se usa para definir

ShowDetails en la clase Minivan .

C#

// Define the base class, Car. The class defines two methods,

// DescribeCar and ShowDetails. DescribeCar calls ShowDetails, and each

derived

// class also defines a ShowDetails method. The example tests which version
of

// ShowDetails is selected, the base class method or the derived class

method.

class Car

public void DescribeCar()

System.Console.WriteLine("Four wheels and an engine.");

ShowDetails();

public virtual void ShowDetails()

System.Console.WriteLine("Standard transportation.");

// Define the derived classes.

// Class ConvertibleCar uses the new modifier to acknowledge that

ShowDetails

// hides the base class method.

class ConvertibleCar : Car

public new void ShowDetails()

System.Console.WriteLine("A roof that opens up.");

// Class Minivan uses the override modifier to specify that ShowDetails

// extends the base class method.

class Minivan : Car

public override void ShowDetails()

System.Console.WriteLine("Carries seven people.");

El ejemplo comprueba la versión de ShowDetails que se llama. El siguiente método,

TestCars1 , declara una instancia de cada clase y, después, llama a DescribeCar en cada

instancia.

C#

public static void TestCars1()

System.Console.WriteLine("\nTestCars1");

System.Console.WriteLine("----------");

Car car1 = new Car();

car1.DescribeCar();

System.Console.WriteLine("----------");

// Notice the output from this test case. The new modifier is

// used in the definition of ShowDetails in the ConvertibleCar

// class.

ConvertibleCar car2 = new ConvertibleCar();

car2.DescribeCar();

System.Console.WriteLine("----------");

Minivan car3 = new Minivan();

car3.DescribeCar();

System.Console.WriteLine("----------");

TestCars1 genera el siguiente resultado. Observe especialmente los resultados de car2 ,

que probablemente no son los que se esperaban. El tipo de objeto es ConvertibleCar ,

pero DescribeCar no tiene acceso a la versión de ShowDetails que se define en la clase
ConvertibleCar porque ese método se declara con el modificador new , no con el
modificador override . Como resultado, un objeto ConvertibleCar muestra la misma
descripción que un objeto Car . Compare los resultados de car3 , que es un objeto
Minivan . En este caso, el método ShowDetails que se declara en la clase Minivan

invalida el método ShowDetails que se declara en la clase Car , y en la descripción que

se muestra se describe una furgoneta.

C#

// TestCars1

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Carries seven people.

// ----------

TestCars2 crea una lista de objetos que tienen el tipo Car . Se crean instancias de los
valores de los objetos desde las clases Car , ConvertibleCar y Minivan . DescribeCar se
llama en cada elemento de la lista. En el código siguiente se muestra la definición de
TestCars2 .

C#

public static void TestCars2()

System.Console.WriteLine("\nTestCars2");

System.Console.WriteLine("----------");

var cars = new List<Car> { new Car(), new ConvertibleCar(),

new Minivan() };

foreach (var car in cars)

car.DescribeCar();

System.Console.WriteLine("----------");

Se muestra el siguiente resultado. Observe que es el mismo resultado mostrado por

TestCars1 . El método ShowDetails de la clase ConvertibleCar no se llama,
independientemente de si el tipo de objeto es ConvertibleCar , como en TestCars1 , o
Car como en TestCars2 . Por el contrario, car3 llama al método ShowDetails desde la
clase Minivan en ambos casos, independientemente de que tenga el tipo Minivan o
Car .

C#

// TestCars2

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Carries seven people.

// ----------

Los métodos TestCars3 y TestCars4 completan el ejemplo. Estos métodos llaman

directamente a ShowDetails , primero desde los objetos declarados con el tipo
ConvertibleCar y Minivan ( TestCars3 ), y después desde los objetos declarados con el

tipo Car ( TestCars4 ). En el código siguiente se definen estos dos métodos.

C#

public static void TestCars3()

System.Console.WriteLine("\nTestCars3");

System.Console.WriteLine("----------");

ConvertibleCar car2 = new ConvertibleCar();

Minivan car3 = new Minivan();

car2.ShowDetails();

car3.ShowDetails();

public static void TestCars4()

System.Console.WriteLine("\nTestCars4");

System.Console.WriteLine("----------");

Car car2 = new ConvertibleCar();

Car car3 = new Minivan();

car2.ShowDetails();

car3.ShowDetails();

Los métodos generan el siguiente resultado, que se corresponde a los resultados del
primer ejemplo de este tema.

C#
 // TestCars3

// ----------

// A roof that opens up.

// Carries seven people.

// TestCars4

// ----------

// Standard transportation.

// Carries seven people.

En el código siguiente se muestra el proyecto completo y sus resultados.

C#

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

namespace OverrideAndNew2

class Program

static void Main(string[] args)

// Declare objects of the derived classes and test which version

// of ShowDetails is run, base or derived.

TestCars1();

// Declare objects of the base class, instantiated with the

// derived classes, and repeat the tests.

TestCars2();

// Declare objects of the derived classes and call ShowDetails

// directly.

TestCars3();

// Declare objects of the base class, instantiated with the

// derived classes, and repeat the tests.

TestCars4();

public static void TestCars1()

System.Console.WriteLine("\nTestCars1");

System.Console.WriteLine("----------");

Car car1 = new Car();

car1.DescribeCar();
System.Console.WriteLine("----------");

// Notice the output from this test case. The new modifier is

 // used in the definition of ShowDetails in the ConvertibleCar

// class.

ConvertibleCar car2 = new ConvertibleCar();

car2.DescribeCar();
System.Console.WriteLine("----------");

Minivan car3 = new Minivan();

car3.DescribeCar();
System.Console.WriteLine("----------");

// Output:

// TestCars1

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Carries seven people.

// ----------

public static void TestCars2()

System.Console.WriteLine("\nTestCars2");

System.Console.WriteLine("----------");

var cars = new List<Car> { new Car(), new ConvertibleCar(),

new Minivan() };

foreach (var car in cars)

car.DescribeCar();

System.Console.WriteLine("----------");

// Output:

// TestCars2

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Standard transportation.

// ----------

// Four wheels and an engine.

// Carries seven people.

// ----------

public static void TestCars3()

System.Console.WriteLine("\nTestCars3");

System.Console.WriteLine("----------");

ConvertibleCar car2 = new ConvertibleCar();

 Minivan car3 = new Minivan();

car2.ShowDetails();
car3.ShowDetails();
}

// Output:

// TestCars3

// ----------

// A roof that opens up.

// Carries seven people.

public static void TestCars4()

System.Console.WriteLine("\nTestCars4");

System.Console.WriteLine("----------");

Car car2 = new ConvertibleCar();

Car car3 = new Minivan();

car2.ShowDetails();
car3.ShowDetails();
}

// Output:

// TestCars4

// ----------

// Standard transportation.

// Carries seven people.

// Define the base class, Car. The class defines two virtual methods,

// DescribeCar and ShowDetails. DescribeCar calls ShowDetails, and each

derived

// class also defines a ShowDetails method. The example tests which

version of

// ShowDetails is used, the base class method or the derived class

method.

class Car

public virtual void DescribeCar()

System.Console.WriteLine("Four wheels and an engine.");

ShowDetails();

public virtual void ShowDetails()

System.Console.WriteLine("Standard transportation.");

// Define the derived classes.

// Class ConvertibleCar uses the new modifier to acknowledge that

ShowDetails

// hides the base class method.

class ConvertibleCar : Car

public new void ShowDetails()

System.Console.WriteLine("A roof that opens up.");

// Class Minivan uses the override modifier to specify that ShowDetails

// extends the base class method.

class Minivan : Car

public override void ShowDetails()

System.Console.WriteLine("Carries seven people.");

Vea también
Guía de programación de C#
El sistema de tipos de C#
Control de versiones con las palabras clave Override y New
base
abstract
Procedimiento para invalidar el método
ToString (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Cada clase o struct de C# hereda implícitamente la clase Object. Por consiguiente, cada
objeto de C# obtiene el método ToString, que devuelve una representación de cadena
de ese objeto. Por ejemplo, todas las variables de tipo int tienen un método ToString ,
que las habilita para devolver su contenido como cadena:

C#

int x = 42;

string strx = x.ToString();

Console.WriteLine(strx);

// Output:

// 42

Cuando cree una clase o struct personalizados, debe reemplazar el método ToString
para proporcionar información sobre el tipo al código de cliente.

Para obtener información sobre cómo usar cadenas de formato y otros tipos de formato
personalizado con el método ToString , vea Aplicar formato a tipos.

） Importante

Cuando decida qué información va a proporcionar a través de este método,

considere si la clase o struct se va a usar alguna vez en código que no sea de
confianza. Asegúrese de que no proporciona información que pueda ser
aprovechada por código malintencionado.

Para reemplazar el método ToString en una clase o struct:

1. Declare un método ToString con los modificadores y el tipo de valor devuelto

siguientes:

C#

public override string ToString(){}

2. Implemente el método para que devuelva una cadena.

 En el ejemplo siguiente, se devuelve el nombre de la clase, además de los datos
específicos de una instancia concreta de la clase.

C#

class Person

public string Name { get; set; }

public int Age { get; set; }

public override string ToString()

return "Person: " + Name + " " + Age;

Se puede probar el método ToString tal y como se muestra en el siguiente

ejemplo de código:

C#

Person person = new Person { Name = "John", Age = 12 };

Console.WriteLine(person);

// Output:

// Person: John 12

Vea también
IFormattable
Guía de programación de C#
El sistema de tipos de C#
Cadenas
string
override
virtual
Aplicación de formato a tipos
Miembros (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las clases y structs tienen miembros que representan sus datos y comportamiento. Los
miembros de una clase incluyen todos los miembros declarados en la clase, junto con
todos los miembros (excepto constructores y finalizadores) declarados en todas las
clases de su jerarquía de herencia. Los miembros privados de clases base se heredan en
las clases derivadas, pero estas no pueden tener acceso a ellos.

En la tabla siguiente se enumeran los tipos de miembros que puede contener una clase
o struct:

Miembro Descripción

Campos Los campos son variables declaradas en el ámbito de clase. Un campo puede ser
un tipo numérico integrado o una instancia de otra clase. Por ejemplo, una clase
de calendario puede tener un campo con la fecha actual.

Constantes Las constantes son campos cuyo valor se establece en tiempo de compilación y
no se puede cambiar.

Propiedades Las propiedades son métodos de una clase a los que se obtiene acceso como si
fueran campos de esa clase. Una propiedad puede proporcionar protección a un
campo de clase con el fin de evitar que se cambie sin el conocimiento del objeto.

Métodos Los métodos definen las acciones que una clase puede realizar. Los métodos
pueden aceptar parámetros que proporcionan datos de entrada y devolver datos
de salida a través de parámetros. Los métodos también pueden devolver un valor
directamente, sin usar ningún parámetro.

Eventos Los eventos proporcionan a otros objetos notificaciones sobre lo que ocurre,
como clics en botones o la realización correcta de un método. Los eventos se
definen y desencadenan mediante delegados.

Operadores Los operadores sobrecargados se consideran miembros de tipo. Si se sobrecarga

un operador, se define como método estático público en un tipo. Para obtener
más información, vea Sobrecarga de operadores.

Indizadores Los indizadores permiten indizar un objeto de manera similar a como se hace con
las matrices.

Constructores Los constructores son métodos a los que se llama cuando el objeto se crea por
primera vez. Se usan a menudo para inicializar los datos de un objeto.
Miembro Descripción

Finalizadores En C#, los finalizadores se usan en raras ocasiones. Son métodos a los que llama
el motor de ejecución del runtime cuando el objeto está a punto de quitarse de
la memoria. Generalmente se utilizan para asegurarse de que los recursos que se
deben liberar se controlan apropiadamente.

Tipos Los tipos anidados son tipos declarados dentro de otro tipo. Los tipos anidados
anidados se usan a menudo para describir objetos utilizados únicamente por los tipos que
los contienen.

Vea también
Guía de programación de C#
Clases
Clases y miembros de clase abstractos y
sellados (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave abstract permite crear clases y miembros class que están incompletos y
se deben implementar en una clase derivada.

La palabra clave sealed permite impedir la herencia de una clase o de ciertos miembros
de clase marcados previamente como virtual.

Clases y miembros de clase abstractos

Las clases se pueden declarar como abstractas si se incluye la palabra clave abstract
antes de la definición de clase. Por ejemplo:

C#

public abstract class A

// Class members here.

No se pueden crear instancias de una clase abstracta. El propósito de una clase

abstracta es proporcionar una definición común de una clase base que múltiples clases
derivadas pueden compartir. Por ejemplo, una biblioteca de clases puede definir una
clase abstracta que se utiliza como parámetro para muchas de sus funciones y solicitar a
los programadores que utilizan esa biblioteca que proporcionen su propia
implementación de la clase mediante la creación de una clase derivada.

Las clases abstractas también pueden definir métodos abstractos. Esto se consigue
agregando la palabra clave abstract antes del tipo de valor que devuelve el método.
Por ejemplo:

C#

public abstract class A

public abstract void DoWork(int i);

Los métodos abstractos no tienen ninguna implementación, de modo que la definición

de método va seguida por un punto y coma en lugar de un bloque de método normal.
Las clases derivadas de la clase abstracta deben implementar todos los métodos
abstractos. Cuando una clase abstracta hereda un método virtual de una clase base, la
clase abstracta puede reemplazar el método virtual con un método abstracto. Por
ejemplo:

C#

// compile with: -target:library

public class D

public virtual void DoWork(int i)

// Original implementation.

public abstract class E : D

public abstract override void DoWork(int i);

public class F : E

public override void DoWork(int i)

// New implementation.

Si un método virtual se declara como abstract , sigue siendo virtual para cualquier
clase que herede de la clase abstracta. Una clase que hereda un método abstracto no
puede tener acceso a la implementación original del método: en el ejemplo anterior,
DoWork en la clase F no puede llamar a DoWork en la clase D. De esta manera, una clase

abstracta puede exigir a las clases derivadas que proporcionen nuevas

implementaciones de método para los métodos virtuales.

Clases y miembros de clase sellados

Las clases se pueden declarar como selladas si se incluye la palabra clave sealed antes
de la definición de clase. Por ejemplo:

C#
 public sealed class D

// Class members here.

Una clase sellada no se puede utilizar como clase base. Por esta razón, tampoco puede
ser una clase abstracta. Las clases selladas evitan la derivación. Puesto que nunca se
pueden utilizar como clase base, algunas optimizaciones en tiempo de ejecución
pueden hacer que sea un poco más rápido llamar a miembros de clase sellada.

Un método, indizador, propiedad o evento de una clase derivada que reemplaza a un

miembro virtual de la clase base puede declarar ese miembro como sellado. Esto niega
el aspecto virtual del miembro para cualquier clase derivada adicional. Esto se logra
colocando la palabra clave sealed antes de la palabra clave override en la declaración
del miembro de clase. Por ejemplo:

C#

public class D : C

public sealed override void DoWork() { }

Consulte también
Guía de programación de C#
El sistema de tipos de C#
Herencia
Métodos
Campos
Procedimiento para definir propiedades abstractas
Clases estáticas y sus miembros (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Una clase estática es básicamente lo mismo que una clase no estática, con la diferencia
de que no se pueden crear instancias de una clase estática. En otras palabras, no puede
usar el operador new para crear una variable del tipo de clase. Dado que no hay
ninguna variable de instancia, para tener acceso a los miembros de una clase estática,
debe usar el nombre de la clase. Por ejemplo, si tiene una clase estática denominada
UtilityClass que tiene un método estático público denominado MethodA , llame al
método tal como se muestra en el ejemplo siguiente:

C#

UtilityClass.MethodA();

Es posible usar una clase estática como un contenedor adecuado para conjuntos de
métodos que solo funcionan en parámetros de entrada y que no tienen que obtener ni
establecer campos de instancias internas. Por ejemplo, en la biblioteca de clases .NET, la
clase estática System.Math contiene métodos que realizan operaciones matemáticas, sin
ningún requisito para almacenar o recuperar datos que sean únicos de una instancia
concreta de la clase Math. Es decir, para aplicar los miembros de la clase, debe
especificar el nombre de clase y el nombre de método, como se muestra en el ejemplo
siguiente.

C#

double dub = -3.14;

Console.WriteLine(Math.Abs(dub));

Console.WriteLine(Math.Floor(dub));

Console.WriteLine(Math.Round(Math.Abs(dub)));

// Output:

// 3.14

// -4

// 3

Como sucede con todos los tipos de clase, el entorno de ejecución de .NET carga la
información de tipo para una clase estática cuando se carga el programa que hace
referencia a la clase. El programa no puede especificar exactamente cuándo se carga la
clase, pero existe la garantía de que se cargará, de que sus campos se inicializarán y de
que se llamará a su constructor estático antes de que se haga referencia a la clase por
primera vez en el programa. Solo se llama una vez a un constructor estático, y una clase
estática permanece en memoria durante la vigencia del dominio de aplicación en el que
reside el programa.

７ Nota

Para crear una clase no estática que solo permita la creación de una instancia de sí
misma, vea Implementing Singleton in C# (Implementar un singleton en C#).

La siguiente lista contiene las características principales de una clase estática:

Solo contiene miembros estáticos.

No se pueden crear instancias de ella.

Está sellada.

No puede contener constructores de instancias.

Por lo tanto, crear una clase estática es básicamente lo mismo que crear una clase que
contiene solo miembros estáticos y un constructor privado. Un constructor privado
impide que se creen instancias de la clase. La ventaja de usar una clase estática es que el
compilador puede comprobar que no se agregue accidentalmente ningún miembro de
instancia. El compilador garantizará que no se creen instancias de esta clase.

Las clases estáticas están selladas y, por lo tanto, no pueden heredarse. No pueden
heredar de ninguna clase excepto Object. Las clases estáticas no pueden contener un
constructor de instancia, aunque sí un constructor estático. Las clases no estáticas
también deben definir un constructor estático si la clase contiene miembros estáticos
que requieren inicialización no trivial. Para obtener más información, vea Constructores
estáticos.

Ejemplo
A continuación se muestra un ejemplo de una clase estática que contiene dos métodos
que convierten la temperatura de grados Celsius a grados Fahrenheit y viceversa:

C#

public static class TemperatureConverter

public static double CelsiusToFahrenheit(string temperatureCelsius)

// Convert argument to double for calculations.

 double celsius = Double.Parse(temperatureCelsius);

// Convert Celsius to Fahrenheit.

double fahrenheit = (celsius * 9 / 5) + 32;

return fahrenheit;

public static double FahrenheitToCelsius(string temperatureFahrenheit)

// Convert argument to double for calculations.

double fahrenheit = Double.Parse(temperatureFahrenheit);

// Convert Fahrenheit to Celsius.

double celsius = (fahrenheit - 32) * 5 / 9;

return celsius;

class TestTemperatureConverter

static void Main()

Console.WriteLine("Please select the convertor direction");

Console.WriteLine("1. From Celsius to Fahrenheit.");

Console.WriteLine("2. From Fahrenheit to Celsius.");

Console.Write(":");

string? selection = Console.ReadLine();

double F, C = 0;

switch (selection)

case "1":

Console.Write("Please enter the Celsius temperature: ");

F =
TemperatureConverter.CelsiusToFahrenheit(Console.ReadLine() ?? "0");

Console.WriteLine("Temperature in Fahrenheit: {0:F2}", F);

break;

case "2":

Console.Write("Please enter the Fahrenheit temperature: ");

C =
TemperatureConverter.FahrenheitToCelsius(Console.ReadLine() ?? "0");

Console.WriteLine("Temperature in Celsius: {0:F2}", C);

break;

default:

Console.WriteLine("Please select a convertor.");

break;

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

 Console.ReadKey();

/* Example Output:

Please select the convertor direction

1. From Celsius to Fahrenheit.

2. From Fahrenheit to Celsius.

:2

Please enter the Fahrenheit temperature: 20

Temperature in Celsius: -6.67

Press any key to exit.

*/

Miembros estáticos
Una clase no estática puede contener métodos, campos, propiedades o eventos
estáticos. El miembro estático es invocable en una clase, incluso si no se ha creado
ninguna instancia de la clase. Siempre se tiene acceso al miembro estático con el
nombre de clase, no con el nombre de instancia. Solo existe una copia de un miembro
estático, independientemente del número de instancias de la clase que se creen. Los
métodos y las propiedades estáticos no pueden acceder a campos y eventos no
estáticos en su tipo contenedor, ni tampoco a una variable de instancia de un objeto a
menos que se pase explícitamente en un parámetro de método.

Es más habitual declarar una clase no estática con algunos miembros estáticos que
declarar toda una clase como estática. Dos usos habituales de los campos estáticos son
llevar la cuenta del número de objetos de los que se han creado instancias y almacenar
un valor que se debe compartir entre todas las instancias.

Los métodos estáticos se pueden sobrecargar pero no invalidar, ya que pertenecen a la

clase y no a una instancia de la clase.

Aunque un campo no se puede declarar como static const , el campo const es

básicamente estático en su comportamiento. Pertenece al tipo, no a las instancias del
tipo. Por lo tanto, se puede acceder a campos const mediante la misma notación
ClassName.MemberName que se usa para los campos estáticos. No se requiere ninguna

instancia de objeto.

C# no admite variables locales estáticas (es decir, variables que se declaran en el ámbito
del método).

Para declarar miembros de clases estáticas, use la palabra clave static antes del tipo de
valor devuelto del miembro, como se muestra en el ejemplo siguiente:
 C#

public class Automobile

{

public static int NumberOfWheels = 4;

public static int SizeOfGasTank

get

return 15;

public static void Drive() { }

public static event EventType? RunOutOfGas;

// Other non-static fields and properties...

Los miembros estáticos se inicializan antes de que se obtenga acceso por primera vez al
miembro estático y antes de que se llame al constructor estático, en caso de haberlo.
Para tener acceso a un miembro de clase estática, use el nombre de la clase en lugar de
un nombre de variable para especificar la ubicación del miembro, como se muestra en el
ejemplo siguiente:

C#

Automobile.Drive();

int i = Automobile.NumberOfWheels;

Si la clase contiene campos estáticos, proporcione un constructor estático que los

inicialice al cargar la clase.

Una llamada a un método estático genera una instrucción de llamada en Lenguaje

Intermedio de Microsoft (MSIL), mientras que una llamada a un método de instancia
genera una instrucción callvirt , que además busca referencias a un objeto NULL, pero
la mayoría de las veces la diferencia de rendimiento entre las dos no es significativo.

Especificación del lenguaje C#

Para más información, consulte Clases estáticas, Miembros estáticos y de instancia y
Constructores estáticos en la especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Consulte también
Guía de programación de C#
static
Clases
class
Constructores estáticos
Constructores de instancias
Modificadores de acceso (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Todos los tipos y miembros de tipo tienen un nivel de accesibilidad. El nivel de

accesibilidad controla si se pueden usar desde otro código del ensamblado u otros
ensamblados. Un ensamblado es un archivo .dll o .exe creado mediante la compilación
de uno o varios archivos .cs en una sola compilación. Use los modificadores de acceso
siguientes para especificar la accesibilidad de un tipo o miembro cuando lo declare:

public: Puede obtener acceso al tipo o miembro cualquier otro código del mismo
ensamblado o de otro ensamblado que haga referencia a éste. El nivel de
accesibilidad de los miembros públicos de un tipo se controla mediante el nivel de
accesibilidad del propio tipo.
private: solamente el código de la misma class o struct puede acceder al tipo o
miembro.
protected: solamente el código de la misma class , o bien de una class derivada
de esa class , puede acceder al tipo o miembro.
internal: Puede obtener acceso al tipo o miembro cualquier código del mismo
ensamblado, pero no de un ensamblado distinto. En otras palabras, se puede
acceder a tipos o miembros internal desde el código que forma parte de la
misma compilación.
protected internal: cualquier código del ensamblado en el que se ha declarado, o
desde una class derivada de otro ensamblado, puede acceder al tipo o miembro.
private protected: se puede tener acceso al tipo o miembro mediante tipos
derivados del objeto class que se declaran dentro de su ensamblado contenedor.

Tabla de resumen
Ubicación del autor de public protected protected internal private private
la llamada internal protected

Dentro de la clase ✔️️ ✔️ ✔️ ✔️ ✔️ ✔️

Clase derivada (mismo ✔️ ✔️ ✔️ ✔️ ✔️ ❌

ensamblado)

Clase no derivada ✔️ ✔️ ❌ ✔️ ❌ ❌
(mismo ensamblado)
 Ubicación del autor de public protected protected internal private private
la llamada internal protected

Clase derivada (otro ✔️ ✔️ ✔️ ❌ ❌ ❌

ensamblado)

Clase no derivada (otro ✔️ ❌ ❌ ❌ ❌ ❌

ensamblado)

En los ejemplos siguientes se muestra cómo especificar modificadores de acceso en un

tipo y miembro:

C#

public class Bicycle

public void Pedal() { }

No todos los modificadores de acceso son válidos para todos los tipos o miembros de
todos los contextos. En algunos casos, la accesibilidad de un miembro de tipo está
restringida por la accesibilidad de su tipo contenedor.

Accesibilidad de clases, registros y estructuras

Las clases, los registros y las estructuras que se declaran directamente en un espacio de
nombres (es decir, que no están anidadas en otras clases o estructuras) pueden ser
public o internal . Si no se especifica ningún modificador de acceso, el valor

predeterminado es internal .

Los miembros de estructura, incluidas las clases y las estructuras anidadas, se pueden
declarar como public , internal o private . Los miembros de clase, incluidas las clases y
las estructuras anidadas, pueden ser public , protected internal , protected , internal ,
private protected o private . Los miembros de clase y estructura, incluidas las clases y

las estructuras anidadas, tienen acceso private de forma predeterminada. Los tipos
anidados privados no son accesibles desde fuera del tipo contenedor.

Las clases derivadas y los registros derivados no pueden tener mayor accesibilidad que
sus tipos base. No se puede declarar una clase pública B que derive de una clase
interna A . Si se permitiera, convertiría A en público, porque todos los miembros
protected o internal de A son accesibles desde la clase derivada.
Puede habilitar otros ensamblados concretos para acceder a los tipos internos mediante
InternalsVisibleToAttribute . Para más información, vea Ensamblados de confianza.

Accesibilidad de miembros de clases, registros

y estructuras
Los miembros de clases y registros (incluidas las clases, los registros y las estructuras
anidados) se pueden declarar con cualquiera de los seis tipos de acceso. Los miembros
de estructura no se pueden declarar como protected , protected internal o private
protected porque las estructuras no admiten la herencia.

Normalmente, la accesibilidad de un miembro no es mayor que la del tipo que lo

contiene. Pero un miembro public de una clase interna podría ser accesible desde fuera
del ensamblado si el miembro implementa los métodos de interfaz o invalida los
métodos virtuales definidos en una clase base pública.

El tipo de cualquier miembro que sea un campo, propiedad o evento debe ser al menos
tan accesible como el propio miembro. Del mismo modo, el tipo devuelto y los tipos de
parámetro de cualquier método, indizador o delegado deben ser al menos tan
accesibles como el propio miembro. Por ejemplo, no puede tener un método public M
que devuelva una clase C a menos que C también sea public . Del mismo modo, no
puede tener una propiedad protected de tipo A si A se declara como private .

Los operadores definidos por el usuario siempre se deben declarar como public y
static . Para obtener más información, vea Sobrecarga de operadores.

Los finalizadores no pueden tener modificadores de accesibilidad.

Para establecer el nivel de acceso de un miembro de class , record o struct , agregue

la palabra clave adecuada a la declaración de miembro, como se muestra en el ejemplo
siguiente.

C#

// public class:

public class Tricycle

// protected method:

protected void Pedal() { }

// private field:

private int _wheels = 3;

// protected internal property:

 protected internal int Wheels

get { return _wheels; }

Otros tipos
Las interfaces declaradas directamente en un espacio de nombres pueden ser public o
internal y, al igual que las clases y las estructuras, su valor predeterminado es el acceso

internal . Los miembros de interfaz son public de manera predeterminada porque el

propósito de una interfaz es permitir que otros tipos accedan a una clase o estructura.
Las declaraciones de miembros de interfaz pueden incluir cualquier modificador de
acceso. Esto es muy útil para que los métodos estáticos proporcionen implementaciones
comunes necesarias para todos los implementadores de una clase.

Los miembros de enumeración siempre son public y no se les puede aplicar ningún
modificador de acceso.

Los delegados se comportan como las clases y las estructuras. De forma

predeterminada, tienen acceso internal cuando se declaran directamente en un
espacio de nombres y acceso private cuando están anidados.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Especificación del orden del modificador (regla de estilo IDE0036)
Guía de programación de C#
El sistema de tipos de C#
Interfaces
private
public
internal
protected
protected internal
private protected
class
struct
interface
Campos (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Un campo es una variable de cualquier tipo que se declara directamente en una clase o
struct. Los campos son miembros de su tipo contenedor.

Una clase o struct puede tener campos de instancia, campos estáticos o ambos. Los
campos de instancia son específicos de una instancia de un tipo. Si tiene una clase T ,
con un campo de instancia F , puede crear dos objetos de tipo T y modificar el valor de
F en cada objeto sin afectar el valor del otro objeto. Por el contrario, un campo estático
pertenece al propio tipo y se comparte entre todas las instancias de ese tipo. Solo
puede acceder al campo estático mediante el nombre del tipo. Si obtiene acceso al
campo estático mediante un nombre de instancia, obtendrá el error en tiempo de
compilación CS0176.

Por lo general, solo se deben usar campos para las variables que tienen accesibilidad
privada o protegida. Los datos que el tipo expone al código de cliente se deben
proporcionar mediante métodos, propiedades e indizadores. Mediante estas
construcciones para el acceso indirecto a los campos internos, se puede proteger de los
valores de entrada no válidos. Un campo privado que almacena los datos expuestos por
una propiedad pública se denomina memoria auxiliar o campo de respaldo.

Los campos almacenan habitualmente los datos que deben ser accesibles para más de
un método de tipo y que deben almacenarse durante más tiempo de lo que dura un
único método. Por ejemplo, es posible que un tipo que representa una fecha de
calendario tenga tres campos enteros: uno para el mes, otro para el día y otro para el
año. Las variables que no se usan fuera del ámbito de un único método se deben
declarar como variables locales dentro del campo del método.

Los campos se declaran en el bloque de clase o estructura mediante la especificación

del nivel de acceso del campo, seguido por el tipo del campo, seguido por el nombre
del campo. Por ejemplo:

C#

public class CalendarEntry

// private field (Located near wrapping "Date" property).

private DateTime _date;

// Public property exposes _date field safely.

public DateTime Date

 get

return _date;

set

// Set some reasonable boundaries for likely birth dates.

if (value.Year > 1900 && value.Year <= DateTime.Today.Year)

_date = value;

else

throw new ArgumentOutOfRangeException("Date");

// public field (Generally not recommended).

public string? Day;

// Public method also exposes _date field safely.

// Example call: birthday.SetDate("1975, 6, 30");

public void SetDate(string dateString)

DateTime dt = Convert.ToDateTime(dateString);

// Set some reasonable boundaries for likely birth dates.

if (dt.Year > 1900 && dt.Year <= DateTime.Today.Year)

_date = dt;

else

throw new ArgumentOutOfRangeException("dateString");

public TimeSpan GetTimeSpan(string dateString)

DateTime dt = Convert.ToDateTime(dateString);

if (dt.Ticks < _date.Ticks)

return _date - dt;

else

throw new ArgumentOutOfRangeException("dateString");

Para acceder a un campo en una instancia, agregue un punto después del nombre de
instancia, seguido del nombre del campo, como en instancename._fieldName . Por
ejemplo:

C#

CalendarEntry birthday = new CalendarEntry();

birthday.Day = "Saturday";

Se puede proporcionar un valor inicial a un campo mediante el operador de asignación

cuando se declara el campo. Para asignar automáticamente el campo Day a "Monday" ,
por ejemplo, se declararía Day como en el ejemplo siguiente:

C#

public class CalendarDateWithInitialization

public string Day = "Monday";

//...

Los campos se inicializan inmediatamente antes de que se llame al constructor para la

instancia del objeto. Si el constructor asigna el valor de un campo, sobrescribirá
cualquier valor dado durante la declaración del campo. Para obtener más información,
vea Utilizar constructores.

７ Nota

Un inicializador de campo no puede hacer referencia a otros campos de instancia.

Se pueden marcar campos como público, privado, protegido, interno, protegido interno
o privado protegido. Estos modificadores de acceso definen cómo los usuarios del tipo
pueden acceder a los campos. Para obtener más información, consulte Modificadores de
acceso.

Opcionalmente, un campo se puede declarar como static. El campo estático está

disponible para los autores de la llamada en cualquier momento, aunque no exista
ninguna instancia del tipo. Para más información, vea Clases estáticas y sus miembros.

Se puede declarar un campo como readonly. Solamente se puede asignar un valor a un

campo de solo lectura durante la inicialización o en un constructor. Un campo static
readonly es similar a una constante, salvo que el compilador de C# no tiene acceso al
valor de un campo estático de solo lectura en tiempo de compilación, solo en tiempo de
ejecución. Para obtener más información, vea Constants (Constantes).

Se puede declarar un campo como obligatorio. Un campo obligatorio lo debe inicializar

el constructor o un inicializador de objetos cuando se crea un objeto. Agregue el
atributo System.Diagnostics.CodeAnalysis.SetsRequiredMembersAttribute a cualquier
declaración de constructor que inicialice todos los miembros necesarios.

El modificador required no se puede combinar con el modificador readonly en el

mismo campo.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Guía de programación de C#
El sistema de tipos de C#
Utilizar constructores
Herencia
Modificadores de acceso
Clases y miembros de clase abstractos y sellados
Constantes (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las constantes son valores inmutables que se conocen en tiempo de compilación y que
no cambian durante la vida del programa. Las constantes se declaran con el modificador
const. Solo los tipos integrados de C# (excluido System.Object) pueden declararse como
const . Los tipos definidos por el usuario, incluidas las clases, las estructuras y las
matrices, no pueden ser const . Use el modificador readonly para crear una clase, una
estructura o una matriz que se inicialice una vez en tiempo de ejecución (por ejemplo,
en un constructor) y que posteriormente no se pueda cambiar.

C# no admite métodos, propiedades ni eventos const .

El tipo enum permite definir constantes con nombre para los tipos integrados enteros
(por ejemplo, int , uint , long , etc.). Para más información, vea enum.

Las constantes se deben inicializar al declararse. Por ejemplo:

C#

class Calendar1

public const int Months = 12;

En este ejemplo la constante Months siempre es 12 y ni siquiera la propia clase la puede

cambiar. De hecho, cuando el compilador detecta un identificador de constante en el
código fuente de C# (por ejemplo, Months ), sustituye directamente el valor literal en el
código de lenguaje intermedio (IL) que genera. Dado que no hay ninguna dirección de
variable asociada a una constante en tiempo de ejecución, no se pueden pasar los
campos const por referencia ni pueden aparecer como un valor L en una expresión.

７ Nota

Tenga cuidado al hacer referencia a valores de constante definidos en otro código

como archivos DLL. Si una nueva versión del archivo DLL define un nuevo valor
para la constante, el programa conservará el valor literal anterior hasta que se
vuelva a compilar con la versión nueva.
Se pueden declarar varias constantes del mismo tipo a la vez, por ejemplo:

C#

class Calendar2

public const int Months = 12, Weeks = 52, Days = 365;

La expresión que se usa para inicializar una constante puede hacer referencia a otra
constante si no crea una referencia circular. Por ejemplo:

C#

class Calendar3

public const int Months = 12;

public const int Weeks = 52;

public const int Days = 365;

public const double DaysPerWeek = (double) Days / (double) Weeks;

public const double DaysPerMonth = (double) Days / (double) Months;

Las constantes pueden marcarse como públicas, privadas, protegidas, internas,

protegidas internaso privadas protegidas. Estos modificadores de acceso definen cómo
los usuarios de la clase pueden acceder a la constante. Para más información, vea
Modificadores de acceso.

A las constantes se accede como si fueran campos estáticos porque el valor de la

constante es el mismo para todas las instancias del tipo. No use la palabra clave static
para declararlas. Las expresiones que no están en la clase que define la constante deben
usar el nombre de la clase, un punto y el nombre de la constante para acceder a ella. Por
ejemplo:

C#

int birthstones = Calendar.Months;

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Consulte también
Guía de programación de C#
Propiedades
Tipos
readonly
Inmutabilidad en la primera parte de C#: tipos de inmutabilidad
Procedimiento para definir propiedades
abstractas (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En el ejemplo siguiente se muestra cómo definir las propiedades abstract. Una

declaración de propiedad abstracta no proporciona una implementación de los
descriptores de acceso de propiedad, declara que la clase admite propiedades, pero
deja la implementación del descriptor de acceso a las clases derivadas. En el ejemplo
siguiente se muestra cómo implementar las propiedades abstractas heredadas de una
clase base.

Este ejemplo consta de tres archivos, cada uno de los cuales se compila individualmente
y se hace referencia a su ensamblado resultante mediante la siguiente compilación:

abstractshape.cs: la clase Shape que contiene una propiedad Area abstracta.

shapes.cs: las subclases de la clase Shape .

shapetest.cs: un programa de prueba para mostrar las áreas de algunos objetos

derivados de Shape .

Para compilar el ejemplo, use el siguiente comando:

csc abstractshape.cs shapes.cs shapetest.cs

Esto creará el archivo ejecutable shapetest.exe.

Ejemplos
Este archivo declara la clase Shape que contiene la propiedad Area del tipo double .

C#

// compile with: csc -target:library abstractshape.cs

public abstract class Shape

private string name;

public Shape(string s)

// calling the set accessor of the Id property.

Id = s;

public string Id

get

return name;

set

name = value;

// Area is a read-only property - only a get accessor is needed:

public abstract double Area

get;

public override string ToString()

return $"{Id} Area = {Area:F2}";

Los modificadores de la propiedad se colocan en la propia declaración de

propiedad. Por ejemplo:

C#

public abstract double Area

Al declarar una propiedad abstracta (como Area en este ejemplo), simplemente

indica qué descriptores de acceso de propiedad están disponibles, pero no los
implementa. En este ejemplo, solo está disponible un descriptor de acceso get, por
lo que la propiedad es de solo lectura.

En el siguiente código se muestran tres subclases de Shape y cómo invalidan la

propiedad Area para proporcionar su propia implementación.

C#

// compile with: csc -target:library -reference:abstractshape.dll shapes.cs

public class Square : Shape

private int side;

 public Square(int side, string id)

: base(id)

this.side = side;

public override double Area

get

// Given the side, return the area of a square:

return side * side;

public class Circle : Shape

private int radius;

public Circle(int radius, string id)

: base(id)

this.radius = radius;

public override double Area

get

// Given the radius, return the area of a circle:

return radius * radius * System.Math.PI;

public class Rectangle : Shape

private int width;

private int height;

public Rectangle(int width, int height, string id)

: base(id)

this.width = width;

this.height = height;

public override double Area

get

// Given the width and height, return the area of a rectangle:

return width * height;

En el siguiente código se muestra un programa de prueba que crea un número de

objetos derivados de Shape e imprime sus áreas.

C#

// compile with: csc -reference:abstractshape.dll;shapes.dll shapetest.cs

class TestClass

static void Main()

Shape[] shapes =

new Square(5, "Square #1"),

new Circle(3, "Circle #1"),

new Rectangle( 4, 5, "Rectangle #1")

};

System.Console.WriteLine("Shapes Collection");

foreach (Shape s in shapes)

System.Console.WriteLine(s);

/* Output:

Shapes Collection

Square #1 Area = 25.00

Circle #1 Area = 28.27

Rectangle #1 Area = 20.00

*/

Vea también
Guía de programación de C#
El sistema de tipos de C#
Clases y miembros de clase abstractos y sellados
Propiedades
Definición de constantes en C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las constantes son campos cuyos valores se establecen en tiempo de compilación y

nunca se pueden cambiar. Use constantes para proporcionar nombres descriptivos en
lugar de literales numéricos ("números mágicos") para valores especiales.

７ Nota

En C#, la directiva del preprocesador #define no puede usarse para definir

constantes en la manera que se usa normalmente en C y C++.

Para definir valores constantes de tipos enteros ( int , byte y así sucesivamente) use un
tipo enumerado. Para más información, vea enum.

Para definir constantes no enteras, un enfoque es agruparlas en una única clase estática
denominada Constants . Esto necesitará que todas las referencias a las constantes vayan
precedidas por el nombre de clase, como se muestra en el ejemplo siguiente.

Ejemplo
C#

static class Constants

public const double Pi = 3.14159;

public const int SpeedOfLight = 300000; // km per sec.

class Program

static void Main()

double radius = 5.3;

double area = Constants.Pi * (radius * radius);

int secsFromSun = 149476000 / Constants.SpeedOfLight; // in km

Console.WriteLine(secsFromSun);

El uso del calificador de nombre de clase ayuda a garantizar que usted y otros usuarios
que usan la constante comprenden que es una constante y que no puede modificarse.
Consulte también
El sistema de tipos de C#
Propiedades (Guía de programación de
C#)
Artículo • 11/02/2023 • Tiempo de lectura: 5 minutos

Una propiedad es un miembro que proporciona un mecanismo flexible para leer,

escribir o calcular el valor de un campo privado. Las propiedades se pueden usar como
si fueran miembros de datos públicos, pero son métodos especiales denominados
descriptores de acceso. Esta característica permite acceder fácilmente a los datos a la vez
que proporciona la seguridad y la flexibilidad de los métodos.

Información general sobre propiedades

Las propiedades permiten que una clase exponga una manera pública de obtener
y establecer valores, a la vez que se oculta el código de implementación o
verificación.
Para devolver el valor de la propiedad se usa un descriptor de acceso de propiedad
get, mientras que para asignar un nuevo valor se emplea un descriptor de acceso
de propiedad set. En C# 9 y versiones posteriores, se usa un descriptor de acceso
de propiedad init para asignar un nuevo valor solo durante la construcción del
objeto. Estos descriptores de acceso pueden tener diferentes niveles de acceso.
Para más información, vea Restringir la accesibilidad del descriptor de acceso.
La palabra clave value se usa para definir el valor que va a asignar el descriptor de
acceso set o init .
Las propiedades pueden ser de lectura y escritura (en ambos casos tienen un
descriptor de acceso get y set ), de solo lectura (tienen un descriptor de acceso
get , pero no set ) o de solo escritura (tienen un descriptor de acceso set , pero no

get ). Las propiedades de solo escritura son poco frecuentes y se suelen usar para
restringir el acceso a datos confidenciales.
Las propiedades simples que no necesitan ningún código de descriptor de acceso
personalizado se pueden implementar como definiciones de cuerpos de expresión
o como propiedades implementadas automáticamente.

Propiedades con campos de respaldo

Un patrón básico para implementar una propiedad conlleva el uso de un campo de
respaldo privado para establecer y recuperar el valor de la propiedad. El descriptor de
acceso get devuelve el valor del campo privado y el descriptor de acceso set puede
realizar alguna validación de datos antes de asignar un valor al campo privado. Ambos
descriptores de acceso además pueden realizar algún cálculo o conversión en los datos
antes de que se almacenen o se devuelvan.

En el ejemplo siguiente se muestra este patrón. En este ejemplo, la clase TimePeriod

representa un intervalo de tiempo. Internamente, la clase almacena el intervalo de
tiempo en segundos en un campo privado denominado _seconds . Una propiedad de
lectura y escritura denominada Hours permite al cliente especificar el intervalo de
tiempo en horas. Los descriptores de acceso get y set realizan la conversión necesaria
entre horas y segundos. Además, el descriptor de acceso set valida los datos e inicia
una excepción ArgumentOutOfRangeException si el número de horas no es válido.

C#

public class TimePeriod

{

private double _seconds;

public double Hours

get { return _seconds / 3600; }

set

if (value < 0 || value > 24)

throw new ArgumentOutOfRangeException(nameof(value),

"The valid range is between 0 and 24.");

_seconds = value * 3600;

Puede acceder a las propiedades para obtener y establecer el valor como se muestra en
el ejemplo siguiente:

C#

TimePeriod t = new TimePeriod();

// The property assignment causes the 'set' accessor to be called.

t.Hours = 24;

// Retrieving the property causes the 'get' accessor to be called.

Console.WriteLine($"Time in hours: {t.Hours}");

// The example displays the following output:

// Time in hours: 24

Definiciones de cuerpos de expresión

Los descriptores de acceso de propiedad suelen constar de instrucciones de una sola
línea que simplemente asignan o devuelven el resultado de una expresión. Puede
implementar estas propiedades como miembros con forma de expresión. Las
definiciones de cuerpos de expresión constan del símbolo => seguido de la expresión
que se va a asignar a la propiedad o a recuperar de ella.

Las propiedades de solo lectura pueden implementar el descriptor de acceso get como
miembro con forma de expresión. En este caso, no se usan ni la palabra clave del
descriptor de acceso get ni la palabra clave return . En el ejemplo siguiente se
implementa la propiedad de solo lectura Name como miembro con forma de expresión.

C#

public class Person

private string _firstName;

private string _lastName;

public Person(string first, string last)

_firstName = first;

_lastName = last;

public string Name => $"{_firstName} {_lastName}";

Tanto el descriptor de acceso get como set se pueden implementar como miembros
con forma de expresión. En este caso, las palabras clave get y set deben estar
presentes. En el ejemplo siguiente se muestra el uso de definiciones de cuerpos de
expresión para ambos descriptores de acceso. La palabra clave return no se usa con el
descriptor de acceso get .

C#

public class SaleItem

string _name;

decimal _cost;

public SaleItem(string name, decimal cost)

{

_name = name;

_cost = cost;

public string Name

 get => _name;

set => _name = value;

public decimal Price

get => _cost;

set => _cost = value;

Propiedades implementadas automáticamente

En algunos casos, los descriptores de acceso de propiedad get y set simplemente
asignan un valor a un campo de respaldo o recuperan un valor de él sin incluir ninguna
lógica adicional. Mediante las propiedades implementadas automáticamente, puede
simplificar el código y conseguir que el compilador de C# le proporcione el campo de
respaldo de forma transparente.

Si una propiedad tiene los descriptores de acceso get y set (o get y init ), ambos se
deben implementar de forma automática. Una propiedad implementada
automáticamente se define mediante las palabras clave get y set sin proporcionar
ninguna implementación. El ejemplo siguiente repite el anterior, salvo que Name y Price
son propiedades implementadas automáticamente. En el ejemplo también se quita el
constructor parametrizado, por lo que los objetos SaleItem ahora se inicializan con una
llamada al constructor sin parámetros y un inicializador de objeto.

C#

public class SaleItem

public string Name

{ get; set; }

public decimal Price

{ get; set; }

Las propiedades implementadas automáticamente pueden declarar diferentes

accesibilidades para los descriptores de acceso get y set . Normalmente, declara un
descriptor de acceso público get y un descriptor de acceso privado set . Puede obtener
más información en el artículo sobre Restringir la accesibilidad del descriptor de acceso.
Propiedades obligatorias
A partir de C# 11, puede agregar el miembro required para forzar que el código de
cliente inicialice cualquier propiedad o campo:

C#

public class SaleItem

public required string Name

{ get; set; }

public required decimal Price

{ get; set; }

Para crear SaleItem , debe establecer las propiedades Name y Price mediante
inicializadores de objeto, como se muestra en el código siguiente:

C#

var item = new SaleItem { Name = "Shoes", Price = 19.95m };

Console.WriteLine($"{item.Name}: sells for {item.Price:C2}");

Secciones relacionadas
Utilizar propiedades
Propiedades de interfaz
Comparación entre propiedades e indizadores
Restringir la accesibilidad del descriptor de acceso
Propiedades autoimplementadas

Especificación del lenguaje C#

Para obtener más información, vea la sección Propiedades de la Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.

Consulte también
Indizadores
get (Palabra clave)
set (palabra clave)
Utilizar propiedades (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

Las propiedades combinan aspectos de los campos y los métodos. Para el usuario de un
objeto, una propiedad que parece un campo, el acceso a la propiedad necesita la misma
sintaxis. Para el implementador de una clase, una propiedad es uno o dos bloques de
código que representa un descriptor de acceso get o un descriptor de acceso set. El
bloque de código del descriptor de acceso get se ejecuta cuando se lee la propiedad; el
bloque de código del descriptor de acceso set se ejecuta cuando se asigna un nuevo
valor a la propiedad. Una propiedad sin un descriptor de acceso set se considera de
solo lectura. Una propiedad sin un descriptor de acceso get se considera de solo
escritura. Una propiedad que tiene ambos descriptores de acceso es de lectura y
escritura. En C# 9 y versiones posteriores, puede usar un descriptor de acceso init en
lugar de set para que la propiedad sea de solo lectura.

A diferencia de los campos, las propiedades no se clasifican como variables. Por lo tanto,
no puede pasar una propiedad como un parámetro ref u out.

Las propiedades tienen muchos usos: pueden validar datos antes de permitir un cambio;
pueden exponer claramente datos en una clase donde esos datos se recuperan de otros
orígenes, como una base de datos; pueden realizar una acción cuando los datos se
cambian, como generar un evento, o cambiar el valor de otros campos.

Las propiedades se declaran en el bloque de clase especificando el nivel de acceso del

campo, seguido del tipo de la propiedad, seguido del nombre de la propiedad y
seguido de un bloque de código que declara un descriptor de acceso get o un
descriptor de acceso set . Por ejemplo:

C#

public class Date

private int _month = 7; // Backing store

public int Month

get => _month;

set

if ((value > 0) && (value < 13))

_month = value;

En este ejemplo, Month se declara como una propiedad, de manera que el descriptor de
acceso set pueda estar seguro de que el valor Month se establece entre 1 y 12. La
propiedad Month usa un campo privado para realizar un seguimiento del valor actual. La
ubicación real de los datos de una propiedad se conoce a menudo como la "memoria
auxiliar" de la propiedad. Es habitual que las propiedades usen campos privados como
memoria auxiliar. El campo se marca como privado para asegurarse de que solo puede
cambiarse llamando a la propiedad. Para obtener más información sobre las
restricciones de acceso público y privado, vea Modificadores de acceso.

Las propiedades implementadas automáticamente proporcionan una sintaxis

simplificada para las declaraciones de propiedad simples. Para obtener más información,
vea Propiedades implementadas automáticamente.

El descriptor de acceso get

El cuerpo del descriptor de acceso get se parece al de un método. Debe devolver un
valor del tipo de propiedad. La ejecución del descriptor de acceso get es equivalente a
la lectura del valor del campo. Por ejemplo, cuando se devuelve la variable privada del
descriptor de acceso get y se habilitan las optimizaciones, la llamada al método de
descriptor de acceso get se inserta mediante el compilador, de manera que no existe
ninguna sobrecarga de llamada al método. En cambio, un método de descriptor de
acceso get virtual no puede insertarse porque el compilador no conoce en tiempo de
compilación a qué método puede llamarse realmente en tiempo de ejecución. A
continuación se muestra un ejemplo de un descriptor de acceso get que devuelve el
valor de un campo privado _name :

C#

class Employee

private string _name; // the name field

public string Name => _name; // the Name property

Cuando hace referencia a la propiedad, excepto como el destino de una asignación, el

descriptor de acceso get se invoca para leer el valor de la propiedad. Por ejemplo:
 C#

var employee= new Employee();

//...

System.Console.Write(employee.Name); // the get accessor is invoked here

El descriptor de acceso get debe finalizar en una instrucción return o throw, y el control
no puede salir del cuerpo del descriptor de acceso.

２ Advertencia

Cambiar el estado del objeto mediante el descriptor de acceso get es un estilo de

programación incorrecto.

El descriptor de acceso get puede usarse para devolver el valor de campo o para
calcularlo y devolverlo. Por ejemplo:

C#

class Manager

private string _name;

public string Name => _name != null ? _name : "NA";

En el segmento de código anterior, si no asigna un valor a la propiedad Name , devolverá

el valor NA .

El descriptor de acceso set

El descriptor de acceso set es similar a un método cuyo tipo de valor devuelto es void.
Usa un parámetro implícito denominado value , cuyo tipo es el tipo de la propiedad. En
el siguiente ejemplo, se agrega un descriptor de acceso set a la propiedad Name :

C#

class Student

private string _name; // the name field

public string Name // the Name property

get => _name;

set => _name = value;

Cuando asigna un valor a la propiedad, el descriptor de acceso set se invoca mediante

un argumento que proporciona el valor nuevo. Por ejemplo:

C#

var student = new Student();

student.Name = "Joe"; // the set accessor is invoked here

System.Console.Write(student.Name); // the get accessor is invoked here

Es un error usar el nombre de parámetro implícito, value , para una declaración de

variable local en el descriptor de acceso set .

El descriptor de acceso init

El código para crear un descriptor de acceso init es el mismo que para crear uno de
tipo set , salvo que se usa la palabra clave init en lugar de set . La diferencia es que el
descriptor de acceso init solo se puede usar en el constructor o mediante un
inicializador de objeto.

Observaciones
Las propiedades se pueden marcar como public , private , protected , internal ,
protected internal o private protected . Estos modificadores de acceso definen cómo

los usuarios de la clase pueden obtener acceso a la propiedad. Los descriptores de

acceso get y set para la misma propiedad pueden tener diferentes modificadores de
acceso. Por ejemplo, get puede ser public para permitir el acceso de solo lectura desde
el exterior del tipo, y set puede ser private o protected . Para obtener más
información, consulte Modificadores de acceso.

Una propiedad puede declararse como una propiedad estática mediante la palabra
clave static . Las propiedad estáticas están disponibles para los autores de la llamada
en cualquier momento, aunque no exista ninguna instancia de la clase. Para más
información, vea Clases estáticas y sus miembros.

Una propiedad puede marcarse como una propiedad virtual mediante la palabra clave
virtual. Las propiedades virtuales permiten que las clases derivadas invaliden el
comportamiento de la propiedad mediante la palabra clave override. Para obtener más
información sobre estas opciones, vea Herencia.

Una propiedad que invalida una propiedad virtual también puede sellarse, lo que
especifica que para las clases derivadas ya no es virtual. Por último, una propiedad
puede declararse abstracta. Las propiedades abstractas no definen ninguna
implementación en la clase, y las clases derivadas deben escribir su propia
implementación. Para obtener más información sobre estas opciones, vea Clases y
miembros de clase abstractos y sellados (Guía de programación de C#).

７ Nota

Es un error usar un modificador virtual, abstract u override en un descriptor de

acceso de una propiedad static.

Ejemplos
En este ejemplo se muestran las propiedades de solo lectura, estáticas y de instancia.
Acepta el nombre del empleado desde el teclado, incrementa NumberOfEmployees en 1 y
muestra el nombre del empleado y el número.

C#

public class Employee

public static int NumberOfEmployees;

private static int _counter;

private string _name;

// A read-write instance property:

public string Name

get => _name;

set => _name = value;

// A read-only static property:

public static int Counter => _counter;

// A Constructor:

public Employee() => _counter = ++NumberOfEmployees; // Calculate the

employee's number:

Ejemplo de propiedad oculta

En este ejemplo se muestra cómo tener acceso a una propiedad en una clase base que
está oculta mediante otra propiedad que tiene el mismo nombre en una clase derivada:

C#

public class Employee

private string _name;

public string Name

get => _name;

set => _name = value;

public class Manager : Employee

private string _name;

// Notice the use of the new modifier:

public new string Name

get => _name;

set => _name = value + ", Manager";

class TestHiding

public static void Test()

Manager m1 = new Manager();

// Derived class property.

m1.Name = "John";

// Base class property.

((Employee)m1).Name = "Mary";

System.Console.WriteLine("Name in the derived class is: {0}",

m1.Name);

System.Console.WriteLine("Name in the base class is: {0}",

((Employee)m1).Name);

/* Output:

Name in the derived class is: John, Manager

Name in the base class is: Mary

*/

A continuación se muestran puntos importantes del ejemplo anterior:

La propiedad Name de la clase derivada oculta la propiedad Name de la clase base.

En dicho caso, el modificador new se usa en la declaración de la propiedad en la
clase derivada:

C#

public new string Name

La conversión (Employee) se usa para tener acceso a la propiedad oculta de la

clase base:

C#

((Employee)m1).Name = "Mary";

Para obtener más información sobre cómo ocultar miembros, vea el Modificador new.

Ejemplo de invalidación de propiedades

En este ejemplo, dos clases, Cube y Square , implementan una clase abstracta, Shape , e
invalidan su propiedad Area abstracta. Tenga en cuenta el uso del modificador override
en las propiedades. El programa acepta el lado como una entrada y calcula las áreas del
cuadrado y el cubo. También acepta el área como una entrada y calcula el lado
correspondiente para el cuadrado y el cubo.

C#

abstract class Shape

public abstract double Area

get;

set;

class Square : Shape

public double side;

//constructor

public Square(double s) => side = s;

public override double Area

 get => side * side;

set => side = System.Math.Sqrt(value);

class Cube : Shape

public double side;

//constructor

public Cube(double s) => side = s;

public override double Area

get => 6 * side * side;

set => side = System.Math.Sqrt(value / 6);

class TestShapes

static void Main()

// Input the side:

System.Console.Write("Enter the side: ");

double side = double.Parse(System.Console.ReadLine());

// Compute the areas:

Square s = new Square(side);

Cube c = new Cube(side);

// Display the results:

System.Console.WriteLine("Area of the square = {0:F2}", s.Area);

System.Console.WriteLine("Area of the cube = {0:F2}", c.Area);

System.Console.WriteLine();

// Input the area:

System.Console.Write("Enter the area: ");

double area = double.Parse(System.Console.ReadLine());

// Compute the sides:

s.Area = area;

c.Area = area;

// Display the results:

System.Console.WriteLine("Side of the square = {0:F2}", s.side);

System.Console.WriteLine("Side of the cube = {0:F2}", c.side);

/* Example Output:

Enter the side: 4

Area of the square = 16.00

Area of the cube = 96.00

Enter the area: 24

 Side of the square = 4.90

Side of the cube = 2.00

*/

Vea también
Propiedades
Propiedades de interfaz
Propiedades autoimplementadas
Propiedades de interfaces (Guía de
programación de C#)
Artículo • 09/02/2023 • Tiempo de lectura: 2 minutos

Las propiedades se pueden declarar en una interfaz. En el ejemplo siguiente se declara

un descriptor de acceso de propiedad de interfaz:

C#

public interface ISampleInterface

// Property declaration:

string Name

get;

set;

Normalmente, las propiedades de interfaz no tienen un cuerpo. Los descriptores de

acceso indican si la propiedad es de lectura y escritura, de solo lectura o de solo
escritura. A diferencia de las clases y las estructuras, la declaración de los descriptores
de acceso sin cuerpo no declara una propiedad implementada automáticamente. Una
interfaz puede definir una implementación predeterminada para los miembros, incluidas
las propiedades. La definición de una implementación predeterminada para una
propiedad en una interfaz es poco frecuente, ya que las interfaces no pueden definir
campos de datos de instancia.

Ejemplo
En este ejemplo, la interfaz IEmployee tiene una propiedad de lectura y escritura, Name , y
una propiedad de solo lectura, Counter . La clase Employee implementa la interfaz
IEmployee y usa estas dos propiedades. El programa lee el nombre de un nuevo

empleado y el número actual de empleados y muestra el nombre del empleado y el

número de empleados calculado.

Puede usar el nombre completo de la propiedad, que hace referencia a la interfaz en la

que se declara el miembro. Por ejemplo:

C#
 string IEmployee.Name

get { return "Employee Name"; }

set { }

En el ejemplo anterior se muestra la implementación de interfaz explícita. Por ejemplo, si

la clase Employee implementa dos interfaces ICitizen y IEmployee , y ambas interfaces
tienen la propiedad Name , la implementación del miembro de interfaz explícita será
necesaria. Es decir, la siguiente declaración de propiedad:

C#

string IEmployee.Name

get { return "Employee Name"; }

set { }

implementa la propiedad Name en la interfaz IEmployee , mientras que la siguiente

declaración:

C#

string ICitizen.Name

get { return "Citizen Name"; }

set { }

implementa la propiedad Name en la interfaz ICitizen .

C#

interface IEmployee

string Name

get;

set;

int Counter

get;

 public class Employee : IEmployee

public static int numberOfEmployees;

private string _name;

public string Name // read-write instance property

get => _name;

set => _name = value;

private int _counter;

public int Counter // read-only instance property

get => _counter;

// constructor

public Employee() => _counter = ++numberOfEmployees;

C#

System.Console.Write("Enter number of employees: ");

Employee.numberOfEmployees = int.Parse(System.Console.ReadLine());

Employee e1 = new Employee();

System.Console.Write("Enter the name of the new employee: ");

e1.Name = System.Console.ReadLine();

System.Console.WriteLine("The employee information:");

System.Console.WriteLine("Employee number: {0}", e1.Counter);

System.Console.WriteLine("Employee name: {0}", e1.Name);

Salida de ejemplo
Consola

Enter number of employees: 210

Enter the name of the new employee: Hazem Abolrous

The employee information:

Employee number: 211

Employee name: Hazem Abolrous

Consulte también
Guía de programación de C#
Propiedades
Utilizar propiedades
Comparación entre propiedades e indizadores
Indizadores
Interfaces
Restringir la accesibilidad del descriptor
de acceso (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Las partes get y set de una propiedad o un indexador se denominan descriptores de

acceso. De forma predeterminada, estos descriptores de acceso tienen la misma
visibilidad o nivel de acceso de la propiedad o el indexador al que pertenecen. Para
obtener más información, vea Niveles de accesibilidad. En cambio, a veces resulta útil
restringir el acceso a uno de estos descriptores de acceso. Normalmente, restringe la
accesibilidad del descriptor de acceso set , mientras que se mantiene el descriptor de
acceso get accesible públicamente. Por ejemplo:

C#

private string _name = "Hello";

public string Name

get

return _name;

protected set

_name = value;

En este ejemplo, una propiedad denominada Name define un descriptor de acceso get y
set . El descriptor de acceso get recibe el nivel de accesibilidad de la propiedad, public

en este caso, mientras que el descriptor de acceso set se restringe explícitamente al

aplicar el modificador de acceso protected al propio descriptor de acceso.

７ Nota

Los ejemplos de este artículo no usan propiedades implementadas

automáticamente. Las propiedades implementadas automáticamente proporcionan
una sintaxis concisa para declarar propiedades cuando no se requiere un campo de
respaldo personalizado.
Restricciones en los modificadores de acceso
en descriptores de acceso
Usar los modificadores de descriptor de acceso en propiedades o indexadores está
sujeto a estas condiciones:

No puede usar los modificadores de descriptor de acceso en una interfaz o en una

implementación explícita del miembro interface.
Puede usar modificadores de descriptor de acceso solo si la propiedad o el
indexador tienen los descriptores de acceso set y get . En este caso, se permite el
modificador solo en uno de los dos descriptores de acceso.
Si la propiedad o el indexador tienen un modificador override, el modificador de
descriptor de acceso debe coincidir con el descriptor de acceso del descriptor de
acceso invalidado, si lo hay.
El nivel de accesibilidad del descriptor de acceso debe ser más restrictivo que el
nivel de accesibilidad de la propiedad o el indexador.

Modificadores de acceso en descriptores de

acceso de invalidación
Al invalidar una propiedad o un indexador, los descriptores de acceso invalidados deben
ser accesibles para el código de invalidación. Además, la accesibilidad de la propiedad y
el indexador y sus descriptores de acceso debe coincidir con la propiedad y el indexador
invalidados correspondientes y sus descriptores de acceso. Por ejemplo:

C#

public class Parent

public virtual int TestProperty

// Notice the accessor accessibility level.

protected set { }

// No access modifier is used here.

get { return 0; }

public class Kid : Parent

public override int TestProperty

// Use the same accessibility level as in the overridden accessor.

protected set { }

 // Cannot use access modifier here.

get { return 0; }

Implementar interfaces
Al usar un descriptor de acceso para implementar una interfaz, este no puede tener un
modificador de acceso. En cambio, si implementa la interfaz con un descriptor de
acceso, como get , el otro descriptor de acceso puede tener un modificador de acceso,
como en el ejemplo siguiente:

C#

public interface ISomeInterface

int TestProperty

// No access modifier allowed here

// because this is an interface.

get;

public class TestClass : ISomeInterface

public int TestProperty

// Cannot use access modifier here because

// this is an interface implementation.

get { return 10; }

// Interface property does not have set accessor,

// so access modifier is allowed.

protected set { }

Dominio de accesibilidad de descriptor de

acceso
Si usa un modificador de acceso en el descriptor de acceso, el dominio de accesibilidad
del descriptor de acceso viene determinado por este modificador.

Si no ha usado un modificador de acceso en el descriptor de acceso, el dominio de

accesibilidad del descriptor de acceso viene determinado por el nivel de accesibilidad de
la propiedad o el indexador.

Ejemplo
En el ejemplo siguiente, se incluyen tres clases: BaseClass , DerivedClass y MainClass .
Hay dos propiedades en BaseClass , Name y Id en ambas clases. En el ejemplo, se
muestra cómo la propiedad Id en DerivedClass se puede ocultar con la propiedad Id
en BaseClass al usar un modificador de acceso restrictivo como protected o private. Por
tanto, cuando asigna valores a esta propiedad, se llama en su lugar a la propiedad en la
clase BaseClass . Si se reemplaza el modificador de acceso por public, la propiedad será
accesible.

En el ejemplo, también se muestra que un modificador de acceso restrictivo, como

private o protected , en el descriptor de acceso set de la propiedad Name en
DerivedClass impide el acceso al descriptor de acceso en la clase derivada. Genera un

error al asignarlo o accede a la propiedad de clase base del mismo nombre, si es

accesible.

C#

public class BaseClass

private string _name = "Name-BaseClass";

private string _id = "ID-BaseClass";

public string Name

get { return _name; }

set { }

public string Id

get { return _id; }

set { }

public class DerivedClass : BaseClass

private string _name = "Name-DerivedClass";

private string _id = "ID-DerivedClass";

new public string Name

get

return _name;

// Using "protected" would make the set accessor not accessible.

set

_name = value;

// Using private on the following property hides it in the Main Class.

// Any assignment to the property will use Id in BaseClass.

new private string Id

get

return _id;

set

_id = value;

class MainClass

static void Main()

BaseClass b1 = new BaseClass();

DerivedClass d1 = new DerivedClass();

b1.Name = "Mary";

d1.Name = "John";

b1.Id = "Mary123";

d1.Id = "John123"; // The BaseClass.Id property is called.

System.Console.WriteLine("Base: {0}, {1}", b1.Name, b1.Id);

System.Console.WriteLine("Derived: {0}, {1}", d1.Name, d1.Id);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
}

/* Output:

Base: Name-BaseClass, ID-BaseClass

Derived: John, ID-BaseClass

*/

Comentarios
Tenga en cuenta que, si reemplaza la declaración new private string Id por new public
string Id , obtendrá el resultado:

Name and ID in the base class: Name-BaseClass, ID-BaseClass

Name and ID in the

derived class: John, John123

Vea también
Propiedades
Indizadores
Modificadores de acceso
Propiedades de solo inicialización
Propiedades necesarias
Procedimiento para declarar y usar
propiedades de lectura y escritura (Guía
de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las propiedades proporcionan la comodidad de los miembros de datos públicos sin los
riesgos que provienen del acceso sin comprobar, sin controlar y sin proteger a los datos
de un objeto. Las propiedades declaran los descriptores de acceso: métodos especiales
que asignan y recuperan valores del miembro de datos subyacente. El descriptor de
acceso set permite que los miembros de datos se asignen, y el descriptor de acceso get
recupera los valores de los miembros de datos.

En este ejemplo se muestra una clase Person que tiene dos propiedades: Name (string) y
Age (int). Ambas propiedades proporcionan descriptores de acceso get y set , de

manera que se consideran propiedades de lectura y escritura.

Ejemplo
C#

class Person

private string _name = "N/A";

private int _age = 0;

// Declare a Name property of type string:

public string Name

get

return _name;

set

_name = value;

// Declare an Age property of type int:

public int Age

get

return _age;

set

_age = value;

public override string ToString()

return "Name = " + Name + ", Age = " + Age;

public class Wrapper

private string _name = "N/A";

public string Name

get

return _name;

private set

_name = value;

class TestPerson

static void Main()

// Create a new Person object:

Person person = new Person();

// Print out the name and the age associated with the person:

Console.WriteLine("Person details - {0}", person);

// Set some values on the person object:

person.Name = "Joe";

person.Age = 99;

Console.WriteLine("Person details - {0}", person);

// Increment the Age property:

person.Age += 1;

Console.WriteLine("Person details - {0}", person);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

 /* Output:

Person details - Name = N/A, Age = 0

Person details - Name = Joe, Age = 99

Person details - Name = Joe, Age = 100

*/

Programación sólida
En el ejemplo anterior, las propiedades Name y Age son públicas e incluyen un descriptor
de acceso get y set . Los descriptores de acceso públicos permiten que cualquier
objeto lea y escriba estas propiedades. En cambio, a veces esto es conveniente para
excluir uno de los descriptores de acceso. Puede omitir el descriptor de acceso set para
que la propiedad sea de solo lectura:

C#

public string Name

get

return _name;

private set

_name = value;

De manera alternativa, puede exponer un descriptor de acceso públicamente pero hacer

que el otro sea privado o esté protegido. Para obtener más información, vea
Accesibilidad del descriptor de acceso asimétrico.

Una vez que se declaren las propiedades, pueden usarse como campos de la clase. Las
propiedades permiten una sintaxis natural cuando ambos obtienen y establecen el valor
de una propiedad, como se muestra en las instrucciones siguientes:

C#

person.Name = "Joe";

person.Age = 99;

En un método set de la propiedad está disponible una variable value especial. Esta
variable contiene el valor que el usuario ha especificado, por ejemplo:

C#
 _name = value;

Tenga en cuenta la sintaxis pura para incrementar la propiedad Age en un objeto

Person :

C#

person.Age += 1;

Si los métodos set y get independientes se han usado para modelar las propiedades,
el código equivalente puede tener este aspecto:

C#

person.SetAge(person.GetAge() + 1);

El método ToString se invalida en este ejemplo:

C#

public override string ToString()

return "Name = " + Name + ", Age = " + Age;

Tenga en cuenta que ToString no se usa explícitamente en el programa. Se invoca de

manera predeterminada mediante las llamadas a WriteLine .

Consulte también
Propiedades
El sistema de tipos de C#
Propiedades autoimplementadas (Guía
de programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

Las propiedades implementadas automáticamente hacen que la declaración de

propiedades sea más concisa cuando no se requiere ninguna lógica adicional en los
descriptores de acceso de propiedad. También permite que el código de cliente cree
objetos. Cuando se declara una propiedad tal como se muestra en el ejemplo siguiente,
el compilador crea un campo de respaldo privado y anónimo al que solo se puede
acceder con los descriptores de acceso de propiedad get y set . En C# 9 y versiones
posteriores, los descriptores de acceso init también se pueden declarar como
propiedades implementadas automáticamente.

Ejemplo
En el ejemplo siguiente se muestra una clase simple que tiene algunas propiedades
implementadas automáticamente:

C#

// This class is mutable. Its data can be modified from

// outside the class.

public class Customer

// Auto-implemented properties for trivial get and set

public double TotalPurchases { get; set; }

public string Name { get; set; }

public int CustomerId { get; set; }

// Constructor

public Customer(double purchases, string name, int id)

TotalPurchases = purchases;

Name = name;

CustomerId = id;

// Methods

public string GetContactInfo() { return "ContactInfo"; }

public string GetTransactionHistory() { return "History"; }

// .. Additional methods, events, etc.

class Program

 static void Main()

// Initialize a new object.

Customer cust1 = new Customer(4987.63, "Northwind", 90108);

// Modify a property.

cust1.TotalPurchases += 499.99;

No se pueden declarar propiedades implementadas automáticamente en interfaces. Las

propiedades implementadas automáticamente declaran un campo de respaldo de
instancia privada y las interfaces no pueden declarar campos de instancia. Al declarar
una propiedad en una interfaz sin definir un cuerpo, se declara una propiedad con
descriptores de acceso que debe ser implementada por cada tipo que implemente esa
interfaz.

Puede inicializar las propiedades implementadas automáticamente de forma similar a

los campos:

C#

public string FirstName { get; set; } = "Jane";

La clase que se muestra en el ejemplo anterior es mutable. El código de cliente puede

cambiar los valores de los objetos una vez creados. En clases complejas que contienen
el comportamiento importante (métodos) y los datos, suele ser necesario tener
propiedades públicas. Pero para las clases pequeñas o estructuras que solo encapsulan
un conjunto de valores (datos) y tienen poco o ningún comportamiento, debe usar una
de las opciones siguientes para hacer que los objetos sean inmutables:

Declare solo un descriptor de acceso get (inmutable en cualquier lugar excepto el

constructor).
Declare un descriptor de acceso get y un descriptor de acceso init (inmutable en
cualquier lugar excepto durante la construcción del objeto).
Declare el descriptor de acceso set como private (inmutable para los
consumidores).

Para obtener más información, vea Procedimiento para implementar una clase ligera
con propiedades autoimplementadas.

Consulte también
Uso de propiedades implementadas automáticamente (regla de estilo IDE0032)
Propiedades
Modificadores
Procedimiento para implementar una
clase ligera con propiedades
autoimplementadas (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En este ejemplo se muestra cómo crear una clase ligera inmutable que solo sirve para
encapsular un conjunto de propiedades autoimplementadas. Use este tipo de
construcción en lugar de un struct cuando deba utilizar una semántica de tipo de
referencia.

Puede hacer que una propiedad sea inmutable de estas maneras:

Declare solo el descriptor de acceso get, que hace que la propiedad sea inmutable
en cualquier lugar excepto en el constructor del tipo.
Declare un descriptor de acceso init en lugar de set , que hace que la propiedad se
pueda establecer solo en el constructor o mediante un inicializador de objeto.
Declare el descriptor de acceso set como private. La propiedad solo se puede
establecer dentro del tipo, pero es inmutable para los consumidores.

Puede agregar el modificador required a la declaración de propiedad para forzar a los

llamadores a establecer la propiedad como parte de la inicialización de un nuevo objeto.

En el ejemplo siguiente se muestra cómo una propiedad con solo el descriptor de

acceso get es distinta de una con get y un conjunto privado.

C#

class Contact

public string Name { get; }

public string Address { get; private set; }

public Contact(string contactName, string contactAddress)

// Both properties are accessible in the constructor.

Name = contactName;

Address = contactAddress;
}

// Name isn't assignable here. This will generate a compile error.

//public void ChangeName(string newName) => Name = newName;

 // Address is assignable here.

public void ChangeAddress(string newAddress) => Address = newAddress;

Ejemplo
En el siguiente ejemplo se muestran dos maneras de implementar una clase inmutable
que tenga propiedades autoimplementadas. Cada forma declara una de las propiedades
con un set privado y una de las propiedades solamente con un get . La primera clase
usa un constructor solo para inicializar las propiedades y la segunda clase utiliza un
método factory estático que llama a un constructor.

C#

// This class is immutable. After an object is created,

// it cannot be modified from outside the class. It uses a

// constructor to initialize its properties.

class Contact

// Read-only property.

public string Name { get; }

// Read-write property with a private set accessor.

public string Address { get; private set; }

// Public constructor.

public Contact(string contactName, string contactAddress)

Name = contactName;

Address = contactAddress;
}

// This class is immutable. After an object is created,

// it cannot be modified from outside the class. It uses a

// static method and private constructor to initialize its properties.

public class Contact2

// Read-write property with a private set accessor.

public string Name { get; private set; }

// Read-only property.

public string Address { get; }

// Private constructor.

private Contact2(string contactName, string contactAddress)

Name = contactName;

Address = contactAddress;
}

 // Public factory method.

public static Contact2 CreateContact(string name, string address)

return new Contact2(name, address);

public class Program

static void Main()

// Some simple data sources.

string[] names = {"Terry Adams","Fadi Fakhouri", "Hanying Feng",

"Cesar Garcia", "Debra Garcia"};

string[] addresses = {"123 Main St.", "345 Cypress Ave.", "678 1st
Ave",

"12 108th St.", "89 E. 42nd St."};

// Simple query to demonstrate object creation in select clause.

// Create Contact objects by using a constructor.

var query1 = from i in Enumerable.Range(0, 5)

select new Contact(names[i], addresses[i]);

// List elements cannot be modified by client code.

var list = query1.ToList();

foreach (var contact in list)

Console.WriteLine("{0}, {1}", contact.Name, contact.Address);

// Create Contact2 objects by using a static factory method.

var query2 = from i in Enumerable.Range(0, 5)

select Contact2.CreateContact(names[i],
addresses[i]);

// Console output is identical to query1.

var list2 = query2.ToList();

// List elements cannot be modified by client code.

// CS0272:

// list2[0].Name = "Eugene Zabokritski";

// Keep the console open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Terry Adams, 123 Main St.

Fadi Fakhouri, 345 Cypress Ave.

Hanying Feng, 678 1st Ave

Cesar Garcia, 12 108th St.

 Debra Garcia, 89 E. 42nd St.

*/

El compilador crea campos de respaldo para cada propiedad autoimplementada. No se

puede acceder a los campos directamente desde el código fuente.

Consulte también
Propiedades
struct
Inicializadores de objeto y colección
Métodos (Guía de programación de C#)
Artículo • 14/02/2023 • Tiempo de lectura: 11 minutos

Un método es un bloque de código que contiene una serie de instrucciones. Un

programa hace que se ejecuten las instrucciones al llamar al método y especificando los
argumentos de método necesarios. En C#, todas las instrucciones ejecutadas se realizan
en el contexto de un método.

El método Main es el punto de entrada para cada aplicación de C# y se llama mediante

Common Language Runtime (CLR) cuando se inicia el programa. En una aplicación que
usa instrucciones de nivel superior, el compilador genera el método Main y contiene
todas las instrucciones de nivel superior.

７ Nota

En este artículo se analizan los métodos denominados. Para obtener información

sobre las funciones anónimas, consulte Expresiones lambda.

Firmas de método
Los métodos se declaran en una clase, struct o interfaz especificando el nivel de acceso,
como public o private , modificadores opcionales como abstract o sealed , el valor
devuelto, el nombre del método y cualquier parámetro de método. Todas estas partes
forman la firma del método.

） Importante

Un tipo de valor devuelto de un método no forma parte de la firma del método

con el objetivo de sobrecargar el método. Sin embargo, forma parte de la firma del
método al determinar la compatibilidad entre un delegado y el método que señala.

Los parámetros de método se encierran entre paréntesis y se separan por comas. Los
paréntesis vacíos indican que el método no requiere parámetros. Esta clase contiene
cuatro métodos:

C#

abstract class Motorcycle

// Anyone can call this.

 public void StartEngine() {/* Method statements here */ }

// Only derived classes can call this.

protected void AddGas(int gallons) { /* Method statements here */ }

// Derived classes can override the base class implementation.

public virtual int Drive(int miles, int speed) { /* Method statements
here */ return 1; }

// Derived classes must implement this.

public abstract double GetTopSpeed();

Acceso a métodos
Llamar a un método en un objeto es como acceder a un campo. Después del nombre
del objeto, agregue un punto, el nombre del método y paréntesis. Los argumentos se
enumeran entre paréntesis y están separados por comas. Los métodos de la clase
Motorcycle se pueden llamar como en el ejemplo siguiente:

C#

class TestMotorcycle : Motorcycle

public override double GetTopSpeed()

return 108.4;

static void Main()

TestMotorcycle moto = new TestMotorcycle();

moto.StartEngine();

moto.AddGas(15);

moto.Drive(5, 20);

double speed = moto.GetTopSpeed();

Console.WriteLine("My top speed is {0}", speed);

Parámetros de métodos frente a argumentos

La definición del método especifica los nombres y tipos de todos los parámetros
necesarios. Si el código de llamada llama al métodos, proporciona valores concretos
denominados argumentos para cada parámetro. Los argumentos deben ser compatibles
con el tipo de parámetro, pero el nombre del argumento (si existe) utilizado en el
código de llamada no tiene que ser el mismo que el parámetro con nombre definido en
el método. Por ejemplo:

C#

public void Caller()

int numA = 4;

// Call with an int variable.

int productA = Square(numA);

int numB = 32;

// Call with another int variable.

int productB = Square(numB);

// Call with an integer literal.

int productC = Square(12);

// Call with an expression that evaluates to int.

productC = Square(productA * 3);

int Square(int i)

// Store input argument in a local variable.

int input = i;

return input * input;

Pasar por referencia frente a pasar por valor

De forma predeterminada, cuando se pasa una instancia de un tipo de valor a un
método, se pasa su copia en lugar de la propia instancia. Por lo tanto, los cambios
realizados en el argumento no tienen ningún efecto en la instancia original del método
de llamada. Para pasar una instancia de tipo de valor por referencia, use la palabra clave
ref . Para obtener más información, vea Pasar parámetros de tipo de valor (Guía de
programación de C#).

Cuando se pasa un objeto de un tipo de referencia a un método, se pasa una referencia

al objeto. Es decir, el método no recibe el objeto concreto, recibe un argumento que
indica la ubicación del objeto. Si cambia un miembro del objeto mediante esta
referencia, el cambio se refleja en el argumento del método de llamada, incluso si pasa
el objeto por valor.
Crea un tipo de referencia mediante la palabra clave class , como se muestra en el
siguiente ejemplo:

C#

public class SampleRefType

public int value;

Ahora, si se pasa un objeto basado en este tipo a un método, también se pasa una
referencia al objeto. En el ejemplo siguiente se pasa un objeto de tipo SampleRefType al
método ModifyObject :

C#

public static void TestRefType()

SampleRefType rt = new SampleRefType();

rt.value = 44;

ModifyObject(rt);

Console.WriteLine(rt.value);

static void ModifyObject(SampleRefType obj)

obj.value = 33;

Fundamentalmente, el ejemplo hace lo mismo que el ejemplo anterior en el que se pasa

un argumento por valor a un método. Pero, debido a que se utiliza un tipo de
referencia, el resultado es diferente. La modificación que se lleva a cabo en
ModifyObject al campo value del parámetro, obj , también cambia el campo value del
argumento, rt , en el método TestRefType . El método TestRefType muestra 33 como
salida.

Para obtener más información sobre cómo pasar tipos de referencia por valor y por
referencia, vea Pasar parámetros Reference-Type (Guía de programación de C#) y Tipos
de referencia (Referencia de C#).

Valores devueltos
Los métodos pueden devolver un valor al autor de llamada. Si el tipo de valor devuelto
(el tipo que aparece antes del nombre de método) no es void , el método puede
devolver el valor mediante la instrucción return. Una instrucción con la palabra clave
return seguida de un valor que coincide con el tipo de valor devuelto devolverá este
valor al autor de llamada del método.

El valor se puede devolver al autor de la llamada por valor o por referencia. Los valores
se devuelven al autor de la llamada mediante referencia si la palabra clave ref se usa en
la firma del método y sigue cada palabra clave return . Por ejemplo, la siguiente firma
del método y la instrucción return indican que el método devuelve una variable
denominada estDistance mediante referencia al autor de la llamada.

C#

public ref double GetEstimatedDistance()

return ref estDistance;

La palabra clave return también detiene la ejecución del método. Si el tipo de valor
devuelto es void , una instrucción return sin un valor también es útil para detener la
ejecución del método. Sin la palabra clave return , el método dejará de ejecutarse
cuando alcance el final del bloque de código. Los métodos con un tipo de valor
devuelto no nulo son necesarios para usar la palabra clave return para devolver un
valor. Por ejemplo, estos dos métodos utilizan la palabra clave return para devolver
enteros:

C#

class SimpleMath

public int AddTwoNumbers(int number1, int number2)

return number1 + number2;

public int SquareANumber(int number)

return number * number;

Para utilizar un valor devuelto de un método, el método de llamada puede usar la

llamada de método en cualquier lugar; un valor del mismo tipo sería suficiente. También
puede asignar el valor devuelto a una variable. Por ejemplo, los dos siguientes ejemplos
de código logran el mismo objetivo:
 C#

int result = obj.AddTwoNumbers(1, 2);

result = obj.SquareANumber(result);

// The result is 9.

Console.WriteLine(result);

C#

result = obj.SquareANumber(obj.AddTwoNumbers(1, 2));

// The result is 9.

Console.WriteLine(result);

Usar una variable local, en este caso, result , para almacenar un valor es opcional. La
legibilidad del código puede ser útil, o puede ser necesaria si debe almacenar el valor
original del argumento para todo el ámbito del método.

Para usar un valor devuelto mediante referencia de un método, debe declarar una
variable local de tipo ref si pretende modificar su valor. Por ejemplo, si el método
Planet.GetEstimatedDistance devuelve un valor Double mediante referencia, puede

definirlo como una variable local de tipo ref con código como el siguiente:

C#

ref double distance = ref Planet.GetEstimatedDistance();

Devolver una matriz multidimensional de un método, M , que modifica el contenido de la

matriz no es necesario si la función de llamada ha pasado la matriz a M . Puede devolver
la matriz resultante de M para obtener un estilo correcto o un flujo funcional de valores,
pero no es necesario porque C# pasa todos los tipos de referencia mediante valor, y el
valor de una referencia de matriz es el puntero de la matriz. En el método M , los
cambios en el contenido de la matriz los puede observar cualquier código que tenga
una referencia a la matriz, como se muestra en el ejemplo siguiente:

C#

static void Main(string[] args)

int[,] matrix = new int[2, 2];

FillMatrix(matrix);

// matrix is now full of -1

public static void FillMatrix(int[,] matrix)

 for (int i = 0; i < matrix.GetLength(0); i++)

for (int j = 0; j < matrix.GetLength(1); j++)

matrix[i, j] = -1;

Métodos asincrónicos
Mediante la característica asincrónica, puede invocar métodos asincrónicos sin usar
definiciones de llamada explícitas ni dividir manualmente el código en varios métodos o
expresiones lambda.

Si marca un método con el modificador async, puede usar el operador await en el

método. Cuando el control alcanza una expresión await en el método asincrónico, el
control se devuelve al autor de llamada y se progreso del método se suspende hasta
que se completa la tarea esperada. Cuando se completa la tarea, la ejecución puede
reanudarse en el método.

７ Nota

Un método asincrónico vuelve al autor de la llamada cuando encuentra el primer

objeto esperado que aún no se ha completado o cuando llega al final del método
asincrónico, lo que ocurra primero.

Un método asincrónico normalmente tiene un tipo de valor devuelto de Task<TResult>,

Task, IAsyncEnumerable<T> o void . El tipo de valor devuelto void se usa
principalmente para definir controladores de eventos, donde se requiere un tipo de
valor devuelto void . No se puede esperar un método asincrónico que devuelve void y
el autor de llamada a un método que no devuelve ningún valor no puede capturar
ninguna excepción producida por este. Un método asincrónico puede tener cualquier
tipo de valor devuelto similar a una tarea.

En el ejemplo siguiente, DelayAsync es un método asincrónico con un tipo de valor

devuelto de Task<TResult>. DelayAsync tiene una instrucción return que devuelve un
entero. Por lo tanto, la declaración del método de DelayAsync debe tener un tipo de
valor devuelto de Task<int> . Dado que el tipo de valor devuelto es Task<int> , la
evaluación de la expresión await en DoSomethingAsync genera un entero, como se
demuestra en la siguiente instrucción: int result = await delayTask .
El método Main es un ejemplo de método asincrónico con un tipo de valor devuelto
Task. Va al método DoSomethingAsync , y como se expresa con una sola línea, puede
omitir las palabras clave async y await . Dado que DoSomethingAsync es un método
asincrónico, la tarea de la llamada a DoSomethingAsync debe esperar, como se muestra
en la siguiente instrucción: await DoSomethingAsync(); .

C#

class Program

static Task Main() => DoSomethingAsync();

static async Task DoSomethingAsync()

Task<int> delayTask = DelayAsync();

int result = await delayTask;

// The previous two statements may be combined into

// the following statement.

//int result = await DelayAsync();

Console.WriteLine($"Result: {result}");

static async Task<int> DelayAsync()

await Task.Delay(100);

return 5;

// Example output:

// Result: 5

Un método aisncrónico no puede declarar ningún parámetro ref u out , pero puede
llamar a los métodos que tienen estos parámetros.

Para obtener más información sobre los métodos asincrónicos, consulte los artículos
Programación asincrónica con async y await y Tipos de valor devueltos asincrónicos.

Definiciones de cuerpos de expresión

Es habitual tener definiciones de método que simplemente hacen las devoluciones de
forma inmediata con el resultado de una expresión, o que tienen una sola instrucción
como cuerpo del método. Hay un acceso directo de sintaxis para definir este método
mediante => :

C#
 public Point Move(int dx, int dy) => new Point(x + dx, y + dy);

public void Print() => Console.WriteLine(First + " " + Last);

// Works with operators, properties, and indexers too.

public static Complex operator +(Complex a, Complex b) => a.Add(b);

public string Name => First + " " + Last;

public Customer this[long id] => store.LookupCustomer(id);

Si el método devuelve void o si es un método asincrónico, el cuerpo del método debe

ser una expresión de instrucción (igual que con las expresiones lambda). Para las
propiedades y los indexadores, solo deben leerse, y no usa la palabra clave de
descriptor de acceso get .

Iterators
Un iterador realiza una iteración personalizada en una colección, como una lista o
matriz. Un iterador utiliza la instrucción yield return para devolver cada elemento de uno
en uno. Cuando se alcanza una instrucción yield return , se recuerda la ubicación actual
en el código. La ejecución se reinicia desde esa ubicación la próxima vez que se llama el
iterador.

Llame a un iterador a partir del código de cliente mediante una instrucción foreach .

El tipo de valor devuelto de un enumerador puede ser IEnumerable, IEnumerable<T>,

IAsyncEnumerable<T>, IEnumerator o IEnumerator<T>.

Para obtener más información, consulta Iteradores.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Guía de programación de C#
El sistema de tipos de C#
Modificadores de acceso
Clases estáticas y sus miembros
Herencia
Clases y miembros de clase abstractos y sellados
params
out
ref
Parámetros de métodos
Funciones locales (Guía de
programación de C#)
Artículo • 11/02/2023 • Tiempo de lectura: 10 minutos

Las funciones locales son métodos de un tipo que están anidados en otro miembro. Solo
se pueden llamar desde su miembro contenedor. Las funciones locales se pueden
declarar en y llamar desde:

Métodos, especialmente los métodos de iterador y asincrónicos

Constructores
Descriptores de acceso de propiedad
Descriptores de acceso de un evento
Métodos anónimos
Expresiones lambda
Finalizadores
Otras funciones locales

En cambio, las funciones locales no se pueden declarar dentro de un miembro con

forma de expresión.

７ Nota

En algunos casos, puede usar una expresión lambda para implementar

funcionalidad compatible también con una función local. Para ver una
comparación, consulte Funciones locales frente a expresiones lambda.

Las funciones locales aclaran la intención del código. Cualquiera que lea el código
puede ver que solo el método que lo contiene puede llamar al método. Para los
proyectos de equipo, también hacen que sea imposible que otro desarrollador llame
erróneamente al método de forma directa desde cualquier otro punto de la clase o
estructura.

Sintaxis de función local

Una función local se define como un método anidado dentro de un miembro
contenedor. Su definición tiene la siguiente sintaxis:

C#

<modifiers> <return-type> <method-name> <parameter-list>

Puede usar los siguientes modificadores con una función local:

async
unsafe
static Una función local estática no puede capturar variables locales o el estado de
la instancia.
extern Una función local externa debe ser static .

Todas las variables locales que se definen en el miembro contenedor, incluidos sus
parámetros de método, son accesibles en la función local no estática.

A diferencia de una definición de método, una definición de función local no puede

incluir el modificador de acceso de los miembros. Dado que todas las funciones locales
son privadas, incluido un modificador de acceso, como la palabra clave private , se
genera el error del compilador CS0106, "El modificador 'private' no es válido para este
elemento".

En el ejemplo siguiente, se define una función local denominada AppendPathSeparator

que es privada a un método denominado GetText :

C#

private static string GetText(string path, string filename)

var reader = File.OpenText($"{AppendPathSeparator(path)}{filename}");

var text = reader.ReadToEnd();

return text;

string AppendPathSeparator(string filepath)

return filepath.EndsWith(@"\") ? filepath : filepath + @"\";

A partir de C# 9.0, puede aplicar atributos a una función local, sus parámetros y
parámetros de tipo, como se muestra en el ejemplo siguiente:

C#

#nullable enable

private static void Process(string?[] lines, string mark)

foreach (var line in lines)

if (IsValid(line))

 // Processing logic...

bool IsValid([NotNullWhen(true)] string? line)

return !string.IsNullOrEmpty(line) && line.Length >= mark.Length;

En el ejemplo anterior se usa un atributo especial para ayudar al compilador en el

análisis estático en un contexto que acepta valores NULL.

Excepciones y funciones locales

Una de las características útiles de las funciones locales es que pueden permitir que las
excepciones aparezcan inmediatamente. Para los iteradores de método, las excepciones
aparecen solo cuando la secuencia devuelta se enumera y no cuando se recupera el
iterador. Para los métodos asincrónicos, las excepciones producidas en un método
asincrónico se observan cuando se espera la tarea devuelta.

En el ejemplo siguiente se define un método OddSequence que enumera los números

impares de un intervalo especificado. Dado que pasa un número mayor de 100 al
método de enumerador OddSequence , el método produce una excepción
ArgumentOutOfRangeException. Como se muestra en el resultado del ejemplo, la
excepción aparece solo cuando itera los números, y no al recuperar el enumerador.

C#

public class IteratorWithoutLocalExample

public static void Main()

IEnumerable<int> xs = OddSequence(50, 110);

Console.WriteLine("Retrieved enumerator...");

foreach (var x in xs) // line 11

Console.Write($"{x} ");

public static IEnumerable<int> OddSequence(int start, int end)

if (start < 0 || start > 99)

throw new ArgumentOutOfRangeException(nameof(start), "start must be

between 0 and 99.");

if (end > 100)

 throw new ArgumentOutOfRangeException(nameof(end), "end must be

less than or equal to 100.");

if (start >= end)

throw new ArgumentException("start must be less than end.");

for (int i = start; i <= end; i++)

if (i % 2 == 1)

yield return i;

// The example displays the output like this:

//

// Retrieved enumerator...

// Unhandled exception. System.ArgumentOutOfRangeException: end must be

less than or equal to 100. (Parameter 'end')

// at IteratorWithoutLocalExample.OddSequence(Int32 start, Int32

end)+MoveNext() in IteratorWithoutLocal.cs:line 22

// at IteratorWithoutLocalExample.Main() in IteratorWithoutLocal.cs:line
11

Si coloca la lógica de iterador en una función local, se iniciarán excepciones de

validación de argumentos al recuperar el enumerador, como se muestra en el ejemplo
siguiente:

C#

public class IteratorWithLocalExample

public static void Main()

IEnumerable<int> xs = OddSequence(50, 110); // line 8

Console.WriteLine("Retrieved enumerator...");

foreach (var x in xs)

Console.Write($"{x} ");

public static IEnumerable<int> OddSequence(int start, int end)

if (start < 0 || start > 99)

throw new ArgumentOutOfRangeException(nameof(start), "start must be

between 0 and 99.");

if (end > 100)

throw new ArgumentOutOfRangeException(nameof(end), "end must be

less than or equal to 100.");

if (start >= end)

throw new ArgumentException("start must be less than end.");

return GetOddSequenceEnumerator();

 IEnumerable<int> GetOddSequenceEnumerator()

for (int i = start; i <= end; i++)

if (i % 2 == 1)

yield return i;

// The example displays the output like this:

//

// Unhandled exception. System.ArgumentOutOfRangeException: end must be

less than or equal to 100. (Parameter 'end')

// at IteratorWithLocalExample.OddSequence(Int32 start, Int32 end) in

IteratorWithLocal.cs:line 22

// at IteratorWithLocalExample.Main() in IteratorWithLocal.cs:line 8

Funciones locales frente a expresiones lambda

A primera vista, las funciones locales y las expresiones lambda son muy similares. En
muchos casos, la elección entre usar expresiones lambda y funciones locales es una
cuestión de estilo y de preferencia personal. aunque hay diferencias que debe tener en
cuenta acerca de dónde puede usar una u otra.

Vamos a examinar las diferencias entre las implementaciones de la función local y la

expresión lambda del algoritmo factorial. Esta es la versión que usa una función local:

C#

public static int LocalFunctionFactorial(int n)

return nthFactorial(n);

int nthFactorial(int number) => number < 2

? 1

: number * nthFactorial(number - 1);

Esta versión usa expresiones lambda:

C#

public static int LambdaFactorial(int n)

Func<int, int> nthFactorial = default(Func<int, int>);

nthFactorial = number => number < 2

 ? 1

: number * nthFactorial(number - 1);

return nthFactorial(n);

Nomenclatura
Las funciones locales se nombran explícitamente como métodos. Las expresiones
lambda son métodos anónimos y deben asignarse a variables de un tipo delegate ,
normalmente los tipos Action o Func . Cuando se declara una función local, el proceso
es como escribir un método normal: se declaran un tipo de valor devuelto y una
signatura de función.

Signaturas de función y tipos de expresiones lambda

Las expresiones lambda se basan en el tipo de la variable Action / Func al que están
asignadas para determinar los tipos de argumento y de valor devuelto. En las funciones
locales, dado que la sintaxis se parece mucho a escribir un método normal, los tipos de
argumento y el tipo de valor devuelto ya forman parte de la declaración de función.

A partir de C# 10, algunas expresiones lambda tienen un tipo natural, que permite al
compilador deducir el tipo de valor devuelto y los tipos de parámetro de la expresión
lambda.

Asignación definitiva
Las expresiones lambda son objetos que se declaran y se asignan en tiempo de
ejecución. Para poder usar una expresión lambda, debe asignarse definitivamente: se
debe declarar la variable Action / Func a la que se va a asignar y luego asignar a esta la
expresión lambda. Observe que LambdaFactorial debe declarar e inicializar la expresión
lambda nthFactorial antes de definirla. De no hacerlo, se produce un error en tiempo
de compilación por hacer referencia a nthFactorial antes de asignarlo.

Las funciones locales se definen en tiempo de compilación. Dado que no están

asignadas a variables, se puede hacer referencia a ellas desde cualquier ubicación del
código que esté en ámbito; en el primer ejemplo LocalFunctionFactorial , se podría
declarar la función local por encima o por debajo de la instrucción return y no
desencadenar ningún error del compilador.
Estas diferencias implican que los algoritmos recursivos son más fáciles de crear usando
funciones locales. Puede declarar y definir una función local que se llama a sí misma. Las
expresiones lambda se deben declarar y se les debe asignar un valor predeterminado
para que se les pueda volver a asignar un cuerpo que haga referencia a la misma
expresión lambda.

Implementación como delegado

Las expresiones lambda se convierten en delegados en el momento en que se declaran.
Las funciones locales son más flexibles, ya que se pueden escribir como un método
tradicional o como un delegado. Las funciones locales solo se convierten en delegados
cuando se usan como delegados.

Si se declara una función local y solo se hace referencia a ella llamándola como un
método, no se convertirá en un delegado.

Captura de variables
Las reglas de asignación definitiva también afectan a las variables capturadas por la
función local o la expresión lambda. El compilador puede efectuar un análisis estático
que permite a las funciones locales asignar definitivamente variables capturadas en el
ámbito de inclusión. Considere este ejemplo:

C#

int M()

int y;

LocalFunction();

return y;

void LocalFunction() => y = 0;

El compilador puede determinar que LocalFunction asigna y definitivamente cuando se

le llama. Como se llama a LocalFunction antes de la instrucción return , y se asigna
definitivamente en la instrucción return .

Observe que cuando una función local captura variables en el ámbito de inclusión, la
función local se implementa como un tipo delegado.

Asignaciones de montón
Dependiendo de su uso, las funciones locales pueden evitar las asignaciones de montón
que siempre son necesarias para las expresiones lambda. Si una función local no se
convierte nunca en un delegado y ninguna de las variables capturadas por la función
local se captura con otras expresiones lambda o funciones locales que se han convertido
en delegados, el compilador puede evitar las asignaciones de montón.

Considere este ejemplo asincrónico:

C#

public async Task<string> PerformLongRunningWorkLambda(string address, int

index, string name)

if (string.IsNullOrWhiteSpace(address))

throw new ArgumentException(message: "An address is required",

paramName: nameof(address));

if (index < 0)

throw new ArgumentOutOfRangeException(paramName: nameof(index),

message: "The index must be non-negative");

if (string.IsNullOrWhiteSpace(name))

throw new ArgumentException(message: "You must supply a name",

paramName: nameof(name));

Func<Task<string>> longRunningWorkImplementation = async () =>

var interimResult = await FirstWork(address);

var secondResult = await SecondStep(index, name);

return $"The results are {interimResult} and {secondResult}.

Enjoy.";

};

return await longRunningWorkImplementation();

La clausura de esta expresión lambda contiene las variables address , index y name . En
el caso de las funciones locales, el objeto que implementa el cierre puede ser un tipo
struct . Luego, ese tipo de estructura se pasaría por referencia a la función local. Esta

diferencia de implementación supondría un ahorro en una asignación.

La creación de instancias necesaria para las expresiones lambda significa asignaciones

de memoria adicionales, lo que puede ser un factor de rendimiento en rutas de acceso
de código crítico en el tiempo. Las funciones locales no suponen esta sobrecarga. En el
ejemplo anterior, la versión de las funciones locales tiene dos asignaciones menos que
la versión de la expresión lambda.

Si sabe que la función local no se va a convertir en delegado y ninguna de las variables

capturadas por ella han sido capturadas por otras expresiones lambda o funciones
locales que se han convertido en delegados, puede garantizar la no asignación de la
función local al montón al declararla como función local static .

 Sugerencia

Habilite la regla de estilo de código de .NET IDE0062 para asegurarse de que las
funciones locales siempre estén marcadas como static .

７ Nota

La función local equivalente de este método también usa una clase para el cierre. Si
el cierre de una función local se implementa como class o struct es un detalle de
implementación. Una función local puede usar struct mientras una expresión
lambda siempre usará class .

C#

public async Task<string> PerformLongRunningWork(string address, int index,

string name)

if (string.IsNullOrWhiteSpace(address))

throw new ArgumentException(message: "An address is required",

paramName: nameof(address));

if (index < 0)

throw new ArgumentOutOfRangeException(paramName: nameof(index),

message: "The index must be non-negative");

if (string.IsNullOrWhiteSpace(name))

throw new ArgumentException(message: "You must supply a name",

paramName: nameof(name));

return await longRunningWorkImplementation();

async Task<string> longRunningWorkImplementation()

var interimResult = await FirstWork(address);

var secondResult = await SecondStep(index, name);

return $"The results are {interimResult} and {secondResult}.

Enjoy.";

Uso de la palabra clave yield

Una ventaja final que no se muestra en este ejemplo es que las funciones locales
pueden implementarse como iteradores, con la sintaxis yield return para producir una
secuencia de valores.

C#

public IEnumerable<string> SequenceToLowercase(IEnumerable<string> input)

if (!input.Any())

throw new ArgumentException("There are no items to convert to

lowercase.");

return LowercaseIterator();

IEnumerable<string> LowercaseIterator()

foreach (var output in input.Select(item => item.ToLower()))

yield return output;

La instrucción yield return no se permite en las expresiones lambda; vea el Error del
compilador CS1621.

Aunque las funciones locales pueden parecer redundantes con respecto a las
expresiones lambda, en realidad tienen finalidades y usos diferentes. Las funciones
locales son más eficaces si se quiere escribir una función a la que solo se llame desde el
contexto de otro método.

Vea también
Uso de la función local en lugar de lambda (regla de estilo IDE0039)
Métodos
Instrucciones de declaración
Artículo • 18/02/2023 • Tiempo de lectura: 8 minutos

Una instrucción de declaración declara una nueva variable y, opcionalmente, la inicializa.

Todas las variables tienen un tipo declarado. Puede obtener más información sobre los
tipos en el artículo sobre el sistema de tipos de .NET. Normalmente, una declaración
incluye un tipo y un nombre de variable. También puede incluir una inicialización: el
operador = seguido de una expresión. El tipo se puede reemplazar por var . La
declaración o la expresión pueden incluir el modificador ref para declarar que la nueva
variable hace referencia a una ubicación de almacenamiento existente.

Variables locales con tipo implícito

Las variables que se declaran en el ámbito de método pueden tener un "tipo" var
implícito. Una variable local con un tipo implícito está fuertemente tipada, igual que si
usted hubiera declarado el tipo, pero es el compilador el que lo determina. Las dos
declaraciones siguientes de a y b tienen una funcionalidad equivalente:

C#

var a = 10; // Implicitly typed.

int b = 10; // Explicitly typed.

） Importante

Cuando var se usa con tipos de referencia que aceptan valores NULL, siempre
implica un tipo de referencia que acepta valores NULL, aunque el tipo de expresión
no los acepte. El análisis de null-state del compilador protege frente a la
desreferenciación de un posible valor null . Si la variable nunca se asigna a una
expresión que pueda ser NULL, el compilador no emitirá ninguna advertencia. Si
asigna la variable a una expresión que podría ser NULL, debe probar que no sea
NULL antes de desreferenciarla para evitar advertencias.

Un uso común de la palabra clave var es con las expresiones de invocación del
constructor. El uso de var permite no repetir un nombre de tipo en una declaración de
variable y una creación de instancias de objeto, como se muestra en el ejemplo
siguiente:

C#
 var xs = new List<int>();

A partir de C# 9.0, se puede usar una expresión new de con tipo de destino como
alternativa:

C#

List<int> xs = new();

List<int>? ys = new();

En la coincidencia de patrones, la palabra clave var se usa en un patrón var.

En el siguiente ejemplo se muestran dos expresiones de consulta. En la primera

expresión, se permite el uso de var pero no es necesario, ya que el tipo del resultado
de la consulta se puede indicar explícitamente como IEnumerable<string> . En cambio,
en la segunda expresión, var permite que el resultado sea una colección de tipos
anónimos y solo el compilador puede tener acceso al nombre de ese tipo. El uso de var
elimina la necesidad de crear una nueva clase para el resultado. En el segundo ejemplo,
la variable item de la iteración foreach también debe tener un tipo implícito.

C#

// Example #1: var is optional when

// the select clause specifies a string

string[] words = { "apple", "strawberry", "grape", "peach", "banana" };

var wordQuery = from word in words

where word[0] == 'g'

select word;

// Because each element in the sequence is a string,

// not an anonymous type, var is optional here also.

foreach (string s in wordQuery)

Console.WriteLine(s);

// Example #2: var is required because

// the select clause specifies an anonymous type

var custQuery = from cust in customers

where cust.City == "Phoenix"

select new { cust.Name, cust.Phone };

// var must be used because each item

// in the sequence is an anonymous type

foreach (var item in custQuery)

Console.WriteLine("Name={0}, Phone={1}", item.Name, item.Phone);

Variables locales de tipo ref

Agregue la palabra clave ref antes del tipo de una variable para declarar una variable
local ref . Una variable local ref es una variable que hace referencia a otro
almacenamiento. Suponga que el método GetContactInformation se declara como un
valor devuelto por referencia:

C#

public ref Person GetContactInformation(string fname, string lname)

Vamos a contrastar estas dos asignaciones:

C#

Person p = contacts.GetContactInformation("Brandie", "Best");

ref Person p2 = ref contacts.GetContactInformation("Brandie", "Best");

La variable p contiene una copia del valor devuelto de GetContactInformation . Es una

ubicación de almacenamiento independiente de la variante ref devuelta desde
GetContactInformation . Si cambia cualquier propiedad de p , cambiará una copia de
Person .

La variable p2 hace referencia a la ubicación de almacenamiento para la variable ref

devuelta desde GetContactInformation . Es el mismo almacenamiento que la variante
ref devuelta desde GetContactInformation . Si cambia cualquier propiedad de p2 ,

cambiará esa instancia única de Person .

Puede acceder a un valor por referencia de la misma manera. En algunos casos, acceder
a un valor por referencia aumenta el rendimiento, ya que evita una operación de copia
potencialmente cara. Por ejemplo, en la instrucción siguiente se muestra cómo es
posible definir un valor local de referencia que se usa para hacer referencia a un valor.

C#

ref VeryLargeStruct reflocal = ref veryLargeStruct;

La palabra clave ref se usa antes de la declaración de variable local y antes del valor en
el segundo ejemplo. Si no se incluyen ambas palabras clave ref en la asignación y
declaración de la variable en ambos ejemplos, se produce el error del
compilador CS8172, "No se puede inicializar una variable por referencia con un valor".

C#

ref VeryLargeStruct reflocal = ref veryLargeStruct; // initialization

refLocal = ref anotherVeryLargeStruct; // reassigned, refLocal refers to

different storage.

Las variables locales ref todavía deben inicializarse cuando se declaran.

En el ejemplo siguiente, se define una clase NumberStore que almacena una matriz de
valores enteros. El método FindNumber devuelve por referencia el primer número que es
mayor o igual que el número que se pasa como argumento. Si ningún número es mayor
o igual que el argumento, el método devuelve el número en el índice 0.

C#

using System;

class NumberStore

int[] numbers = { 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023 };

public ref int FindNumber(int target)

for (int ctr = 0; ctr < numbers.Length; ctr++)

if (numbers[ctr] >= target)

return ref numbers[ctr];

return ref numbers[0];

public override string ToString() => string.Join(" ", numbers);

En el ejemplo siguiente, se llama al método NumberStore.FindNumber para recuperar el

primer valor que es mayor o igual que 16. Después, el autor de la llamada duplica el
valor devuelto por el método. En el resultado del ejemplo se muestra el cambio
reflejado en el valor de los elementos de matriz de la instancia NumberStore .

C#

var store = new NumberStore();

Console.WriteLine($"Original sequence: {store.ToString()}");

int number = 16;

ref var value = ref store.FindNumber(number);

 value *= 2;

Console.WriteLine($"New sequence: {store.ToString()}");

// The example displays the following output:

// Original sequence: 1 3 7 15 31 63 127 255 511 1023

// New sequence: 1 3 7 15 62 63 127 255 511 1023

Sin que se admitan los valores devueltos de referencia, este tipo de operación se realiza
al devolver el índice del elemento de matriz junto con su valor. Después, el autor de la
llamada puede usar este índice para modificar el valor en una llamada al método
independiente. En cambio, el autor de la llamada también puede modificar el índice
para tener acceso a otros valores de matriz y, posiblemente, modificarlos.

El siguiente ejemplo muestra cómo se podría reescribir el método FindNumber para usar
la reasignación de variable local ref:

C#

using System;

class NumberStore

int[] numbers = { 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023 };

public ref int FindNumber(int target)

ref int returnVal = ref numbers[0];

var ctr = numbers.Length - 1;

while ((ctr >= 0) && (numbers[ctr] >= target))

returnVal = ref numbers[ctr];

ctr--;

return ref returnVal;

public override string ToString() => string.Join(" ", numbers);

Esta segunda versión es más eficaz con secuencias más largas en escenarios donde el
número buscado está más cerca del final de la matriz, ya que en la matriz se itera desde
el final hacia el principio, lo que hace que se examinen menos elementos.

El compilador aplica reglas de ámbito en variables ref : variables locales ref ,

parámetros ref y campos ref en tipos ref struct . Las reglas garantizan que una
referencia no sobreviva al objeto al que hace referencia. Consulte la sección sobre las
reglas de ámbito del artículo sobre los parámetros de método.
ref y readonly
El modificador readonly se puede aplicar a variables locales ref y campos ref . El
modificador readonly afecta a la expresión de la derecha. Vea las siguientes
declaraciones de ejemplo:

C#

ref readonly int aConstant; // aConstant can't be value-reassigned.

readonly ref int Storage; // Storage can't be ref-reassigned.

readonly ref readonly int CantChange; // CantChange can't be value-

reassigned or ref-reassigned.

Reasignación de valor significa que se reasigna el valor de la variable.

Asignación de referencia significa que la variable ahora hace referencia a un objeto
diferente.

Las declaraciones readonly ref y readonly ref readonly solo son válidas en campos
ref de ref struct .

Referencia con ámbito

La palabra clave contextual scoped restringe la duración de un valor. El modificador
scoped restringe la duración ref-safe-to-escape o safe-to-escape, respectivamente, al
método actual. De hecho, al agregar el modificador scoped se afirma que el código no
extenderá la duración de la variable.

Puede aplicar scoped a un parámetro o variable local. El modificador scoped se puede

aplicar a parámetros y variables locales cuando el tipo es ref struct. De lo contrario, el
modificador scoped solo se puede aplicar a las variables locales que son de tipos ref.
Esto incluye las variables locales declaradas con el modificador ref y los parámetros
declarados con los modificadores in , ref o out .

El modificador scoped se agrega implícitamente a this en los métodos declarados en

struct y en parámetros out y ref cuando el tipo es ref struct .

Vea también
ref (palabra clave)
Cómo evitar asignaciones
Preferencias "var" (reglas de estilo IDE0007 e IDE0008)
Referencia de C#
Relaciones entre tipos en las operaciones de consulta LINQ
C# 11: modificador con ámbito
Parámetros de métodos (Referencia de
C#)
Artículo • 18/02/2023 • Tiempo de lectura: 10 minutos

En C#, los argumentos se pueden pasar a parámetros por valor o por referencia.
Recuerde que los tipos de C# pueden ser tipos de referencia ( class ) o tipos de valor
( struct ):

Pasar por valor significa pasar una copia de la variable al método.

Pasar por referencia significa pasar el acceso a la variable al método.
Una variable de un tipo de referencia contiene una referencia a sus datos.
Una variable de un tipo de valor contiene sus datos directamente.

Como un struct es un tipo de valor, cuando pasa un struct mediante valor a un método,
el método recibe y funciona en una copia del argumento struct. El método no tiene
acceso al struct original en el método de llamada y, por lo tanto, no puede cambiarlo de
ninguna manera. El método solo puede cambiar la copia.

Una instancia de clase es un tipo de referencia, no un tipo de valor. Cuando un tipo de

referencia se pasa mediante valor a un método, el método recibe una copia de la
referencia a la instancia de clase. Es decir, el método al que se llama recibe una copia de
la dirección de la instancia y el método de llamada conserva la dirección original de la
instancia. La instancia de clase en el método de llamada tiene una dirección, el
parámetro en el método que se ha llamado tiene una copia de la dirección, y ambas
direcciones hacen referencia al mismo objeto. Como el parámetro solo contiene una
copia de la dirección, el método al que se ha llamado no puede cambiar la dirección de
la instancia de clase en el método de llamada. En cambio, el método al que se ha
llamado puede usar la copia de la dirección para acceder a los miembros de clase a los
que hacen referencia la dirección original y la copia de la dirección. Si el método al que
se ha llamado cambia un miembro de clase, la instancia de clase original en el método
de llamada también cambia.

En el resultado del ejemplo siguiente se ilustra la diferencia. El valor del campo

willIChange de la instancia de clase se cambia mediante la llamada al método
ClassTaker porque el método usa la dirección en el parámetro para buscar el campo

especificado de la instancia de clase. El campo willIChange del struct en el método de

llamada no se cambia mediante la llamada al método StructTaker porque el valor del
argumento es una copia del propio struct, no una copia de su dirección. StructTaker
cambia la copia, y la copia se pierde cuando se completa la llamada a StructTaker .
 C#

class TheClass

public string? willIChange;

struct TheStruct

public string willIChange;

class TestClassAndStruct

static void ClassTaker(TheClass c)

c.willIChange = "Changed";

static void StructTaker(TheStruct s)

s.willIChange = "Changed";

public static void Main()

TheClass testClass = new TheClass();

TheStruct testStruct = new TheStruct();

testClass.willIChange = "Not Changed";

testStruct.willIChange = "Not Changed";

ClassTaker(testClass);

StructTaker(testStruct);

Console.WriteLine("Class field = {0}", testClass.willIChange);

Console.WriteLine("Struct field = {0}", testStruct.willIChange);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Class field = Changed

Struct field = Not Changed

*/

Cómo se pasa un argumento y si es un tipo de referencia o un tipo de valor controla

qué modificaciones realizadas en el argumento son visibles desde el autor de la llamada.
Pasar un tipo de valor por valor
Cuando se pasa un tipo de valorpor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios no son visibles desde el autor de la llamada.

En el ejemplo siguiente se muestra cómo pasar los parámetros de tipo de valor en

función del valor. La variable n se pasa en función del valor al método SquareIt . Los
cambios que tienen lugar dentro del método no tienen ningún efecto en el valor
original de la variable.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(n); // Passing the variable by value.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(int x)

// The parameter x is passed by value.

// Changes to x will not affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 5

*/

La variable n es un tipo de valor. Contiene sus datos, el valor 5 . Cuando se invoca

SquareIt , el contenido de n se copia en el parámetro x , que se multiplica dentro del

método. En Main , sin embargo, el valor de n es el mismo después de llamar al

método SquareIt que el que era antes. El cambio que tiene lugar dentro del método
solo afecta a la variable local x .

Pasar un tipo de valor por referencia

Cuando se pasa un tipo de valorpor referencia:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que el argumento se pasa como
un parámetro ref . El valor del argumento subyacente, n , se cambia cuando se modifica
x en el método.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(ref n); // Passing the variable by reference.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(ref int x)

// The parameter x is passed by reference.

// Changes to x will affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 25

*/

En este ejemplo, no es el valor de n el que se pasa, sino una referencia a n . El

parámetro x no es un entero; se trata de una referencia a int , en este caso, una
referencia a n . Por tanto, cuando x se multiplica dentro del método, lo que realmente
se multiplica es a lo que x hace referencia, n .

Pasar un tipo de referencia por valor

Cuando se pasa un tipo de referenciapor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
 Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

En el ejemplo siguiente, se muestra cómo pasar un parámetro de tipo de referencia,

arr , en función del valor a un método, Change . Dado que el parámetro es una
referencia a arr , es posible cambiar los valores de los elementos de matriz. En cambio,
el intento de volver a asignar el parámetro a otra ubicación de memoria solo funciona
dentro del método y no afecta a la variable original, arr .

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(int[] pArray)

pArray[0] = 888; // This change affects the original element.

pArray = new int[5] { -3, -1, -2, -3, -4 }; // This change is local.

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: 888

*/

En el ejemplo anterior, la matriz, arr , que es un tipo de referencia, se pasa al método

sin el parámetro ref . En tal caso, se pasa al método una copia de la referencia, que
apunta a arr . El resultado muestra que es posible que el método cambie el contenido
de un elemento de matriz, en este caso de 1 a 888 . En cambio, si se asigna una nueva
porción de memoria al usar el operador new dentro del método Change , la variable
pArray hace referencia a una nueva matriz. Por tanto, cualquier cambio que hubiese
después no afectará a la matriz original, arr , que se ha creado dentro de Main . De
hecho, se crean dos matrices en este ejemplo, una dentro de Main y otra dentro del
método Change .

Pasar un tipo de referencia por referencia

Cuando se pasa un tipo de referenciapor referencia:
 Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que la palabra clave ref se
agrega a la llamada y al encabezado de método. Los cambios que tengan lugar en el
método afectan a la variable original en el programa que realiza la llamada.

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(ref arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(ref int[] pArray)

// Both of the following changes will affect the original variables:

pArray[0] = 888;

pArray = new int[5] { -3, -1, -2, -3, -4 };

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: -3

*/

Todos los cambios que tienen lugar dentro del método afectan a la matriz original en
Main . De hecho, la matriz original se reasigna mediante el operador new . Por tanto,

después de llamar al método Change , cualquier referencia a arr apunta a la matriz de

cinco elementos, que se crea en el método Change .

Ámbito de las referencias y los valores

Los métodos pueden almacenar los valores de los parámetros en campos. Cuando los
parámetros se pasan por valor, siempre es seguro. Los valores se copian y se puede
acceder a los tipos de referencia cuando se almacenan en un campo. Pasar parámetros
por referencia de forma segura requiere que el compilador defina cuándo es seguro
asignar una referencia a una nueva variable. Para cada expresión, el compilador define
un ámbito que enlaza el acceso a una expresión o una variable. El compilador usa dos
ámbitos: safe_to_escape y ref_safe_to_escape.

El ámbito safe_to_escape define el ámbito en el que se puede acceder de forma

segura a cualquier expresión.
El ámbito ref_safe_to_escape define el ámbito en el que se puede acceder o
modificar de forma segura una referencia a cualquier expresión.

Informalmente, puede considerar estos ámbitos como un mecanismo para asegurarse

de que el código nunca accede o modifica una referencia que ya no es válida. Una
referencia es válida siempre que haga referencia a un objeto o estructura válidos. El
ámbito safe_to_escape define cuándo se puede asignar o reasignar una variable. El
ámbito ref_safe_to_escape define cuándo una variable se puede asignar ref o reasignar
ref. La asignación asigna una variable a un nuevo valor; la asignación por referencia
asigna la variable para hacer referencia a otra ubicación de almacenamiento.

Modificadores
Los parámetros declarados para un método sin in, ref o out se pasan al método llamado
por valor. Los modificadores ref , in y out difieren en las reglas de asignación:

El argumento de un parámetro ref se debe asignar definitivamente. El método

llamado puede reasignar ese parámetro.
El argumento de un parámetro in se debe asignar definitivamente. El método
llamado no puede reasignar ese parámetro.
No es necesario asignar definitivamente el argumento de un parámetro out . El
método llamado debe asignar el parámetro.

Esta sección describe las palabras clave que puede usar para declarar parámetros de
métodos:

params especifica que este parámetro puede tomar un número variable de

argumentos.
in especifica que este parámetro se pasa por referencia, pero solo se lee mediante
el método llamado.
ref especifica que este parámetro se pasa por referencia y puede ser leído o escrito
por el método llamado.
out especifica que este parámetro se pasa por referencia y se escribe mediante el
método llamado.

Vea también
Referencia de C#
Palabras clave de C#
Listas de argumentos en la especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Parámetros de métodos (Referencia de
C#)
Artículo • 18/02/2023 • Tiempo de lectura: 10 minutos

En C#, los argumentos se pueden pasar a parámetros por valor o por referencia.
Recuerde que los tipos de C# pueden ser tipos de referencia ( class ) o tipos de valor
( struct ):

Pasar por valor significa pasar una copia de la variable al método.

Pasar por referencia significa pasar el acceso a la variable al método.
Una variable de un tipo de referencia contiene una referencia a sus datos.
Una variable de un tipo de valor contiene sus datos directamente.

Como un struct es un tipo de valor, cuando pasa un struct mediante valor a un método,
el método recibe y funciona en una copia del argumento struct. El método no tiene
acceso al struct original en el método de llamada y, por lo tanto, no puede cambiarlo de
ninguna manera. El método solo puede cambiar la copia.

Una instancia de clase es un tipo de referencia, no un tipo de valor. Cuando un tipo de

referencia se pasa mediante valor a un método, el método recibe una copia de la
referencia a la instancia de clase. Es decir, el método al que se llama recibe una copia de
la dirección de la instancia y el método de llamada conserva la dirección original de la
instancia. La instancia de clase en el método de llamada tiene una dirección, el
parámetro en el método que se ha llamado tiene una copia de la dirección, y ambas
direcciones hacen referencia al mismo objeto. Como el parámetro solo contiene una
copia de la dirección, el método al que se ha llamado no puede cambiar la dirección de
la instancia de clase en el método de llamada. En cambio, el método al que se ha
llamado puede usar la copia de la dirección para acceder a los miembros de clase a los
que hacen referencia la dirección original y la copia de la dirección. Si el método al que
se ha llamado cambia un miembro de clase, la instancia de clase original en el método
de llamada también cambia.

En el resultado del ejemplo siguiente se ilustra la diferencia. El valor del campo

willIChange de la instancia de clase se cambia mediante la llamada al método
ClassTaker porque el método usa la dirección en el parámetro para buscar el campo

especificado de la instancia de clase. El campo willIChange del struct en el método de

llamada no se cambia mediante la llamada al método StructTaker porque el valor del
argumento es una copia del propio struct, no una copia de su dirección. StructTaker
cambia la copia, y la copia se pierde cuando se completa la llamada a StructTaker .
 C#

class TheClass

public string? willIChange;

struct TheStruct

public string willIChange;

class TestClassAndStruct

static void ClassTaker(TheClass c)

c.willIChange = "Changed";

static void StructTaker(TheStruct s)

s.willIChange = "Changed";

public static void Main()

TheClass testClass = new TheClass();

TheStruct testStruct = new TheStruct();

testClass.willIChange = "Not Changed";

testStruct.willIChange = "Not Changed";

ClassTaker(testClass);

StructTaker(testStruct);

Console.WriteLine("Class field = {0}", testClass.willIChange);

Console.WriteLine("Struct field = {0}", testStruct.willIChange);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Class field = Changed

Struct field = Not Changed

*/

Cómo se pasa un argumento y si es un tipo de referencia o un tipo de valor controla

qué modificaciones realizadas en el argumento son visibles desde el autor de la llamada.
Pasar un tipo de valor por valor
Cuando se pasa un tipo de valorpor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios no son visibles desde el autor de la llamada.

En el ejemplo siguiente se muestra cómo pasar los parámetros de tipo de valor en

función del valor. La variable n se pasa en función del valor al método SquareIt . Los
cambios que tienen lugar dentro del método no tienen ningún efecto en el valor
original de la variable.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(n); // Passing the variable by value.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(int x)

// The parameter x is passed by value.

// Changes to x will not affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 5

*/

La variable n es un tipo de valor. Contiene sus datos, el valor 5 . Cuando se invoca

SquareIt , el contenido de n se copia en el parámetro x , que se multiplica dentro del

método. En Main , sin embargo, el valor de n es el mismo después de llamar al

método SquareIt que el que era antes. El cambio que tiene lugar dentro del método
solo afecta a la variable local x .

Pasar un tipo de valor por referencia

Cuando se pasa un tipo de valorpor referencia:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que el argumento se pasa como
un parámetro ref . El valor del argumento subyacente, n , se cambia cuando se modifica
x en el método.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(ref n); // Passing the variable by reference.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(ref int x)

// The parameter x is passed by reference.

// Changes to x will affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 25

*/

En este ejemplo, no es el valor de n el que se pasa, sino una referencia a n . El

parámetro x no es un entero; se trata de una referencia a int , en este caso, una
referencia a n . Por tanto, cuando x se multiplica dentro del método, lo que realmente
se multiplica es a lo que x hace referencia, n .

Pasar un tipo de referencia por valor

Cuando se pasa un tipo de referenciapor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
 Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

En el ejemplo siguiente, se muestra cómo pasar un parámetro de tipo de referencia,

arr , en función del valor a un método, Change . Dado que el parámetro es una
referencia a arr , es posible cambiar los valores de los elementos de matriz. En cambio,
el intento de volver a asignar el parámetro a otra ubicación de memoria solo funciona
dentro del método y no afecta a la variable original, arr .

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(int[] pArray)

pArray[0] = 888; // This change affects the original element.

pArray = new int[5] { -3, -1, -2, -3, -4 }; // This change is local.

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: 888

*/

En el ejemplo anterior, la matriz, arr , que es un tipo de referencia, se pasa al método

sin el parámetro ref . En tal caso, se pasa al método una copia de la referencia, que
apunta a arr . El resultado muestra que es posible que el método cambie el contenido
de un elemento de matriz, en este caso de 1 a 888 . En cambio, si se asigna una nueva
porción de memoria al usar el operador new dentro del método Change , la variable
pArray hace referencia a una nueva matriz. Por tanto, cualquier cambio que hubiese
después no afectará a la matriz original, arr , que se ha creado dentro de Main . De
hecho, se crean dos matrices en este ejemplo, una dentro de Main y otra dentro del
método Change .

Pasar un tipo de referencia por referencia

Cuando se pasa un tipo de referenciapor referencia:
 Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que la palabra clave ref se
agrega a la llamada y al encabezado de método. Los cambios que tengan lugar en el
método afectan a la variable original en el programa que realiza la llamada.

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(ref arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(ref int[] pArray)

// Both of the following changes will affect the original variables:

pArray[0] = 888;

pArray = new int[5] { -3, -1, -2, -3, -4 };

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: -3

*/

Todos los cambios que tienen lugar dentro del método afectan a la matriz original en
Main . De hecho, la matriz original se reasigna mediante el operador new . Por tanto,

después de llamar al método Change , cualquier referencia a arr apunta a la matriz de

cinco elementos, que se crea en el método Change .

Ámbito de las referencias y los valores

Los métodos pueden almacenar los valores de los parámetros en campos. Cuando los
parámetros se pasan por valor, siempre es seguro. Los valores se copian y se puede
acceder a los tipos de referencia cuando se almacenan en un campo. Pasar parámetros
por referencia de forma segura requiere que el compilador defina cuándo es seguro
asignar una referencia a una nueva variable. Para cada expresión, el compilador define
un ámbito que enlaza el acceso a una expresión o una variable. El compilador usa dos
ámbitos: safe_to_escape y ref_safe_to_escape.

El ámbito safe_to_escape define el ámbito en el que se puede acceder de forma

segura a cualquier expresión.
El ámbito ref_safe_to_escape define el ámbito en el que se puede acceder o
modificar de forma segura una referencia a cualquier expresión.

Informalmente, puede considerar estos ámbitos como un mecanismo para asegurarse

de que el código nunca accede o modifica una referencia que ya no es válida. Una
referencia es válida siempre que haga referencia a un objeto o estructura válidos. El
ámbito safe_to_escape define cuándo se puede asignar o reasignar una variable. El
ámbito ref_safe_to_escape define cuándo una variable se puede asignar ref o reasignar
ref. La asignación asigna una variable a un nuevo valor; la asignación por referencia
asigna la variable para hacer referencia a otra ubicación de almacenamiento.

Modificadores
Los parámetros declarados para un método sin in, ref o out se pasan al método llamado
por valor. Los modificadores ref , in y out difieren en las reglas de asignación:

El argumento de un parámetro ref se debe asignar definitivamente. El método

llamado puede reasignar ese parámetro.
El argumento de un parámetro in se debe asignar definitivamente. El método
llamado no puede reasignar ese parámetro.
No es necesario asignar definitivamente el argumento de un parámetro out . El
método llamado debe asignar el parámetro.

Esta sección describe las palabras clave que puede usar para declarar parámetros de
métodos:

params especifica que este parámetro puede tomar un número variable de

argumentos.
in especifica que este parámetro se pasa por referencia, pero solo se lee mediante
el método llamado.
ref especifica que este parámetro se pasa por referencia y puede ser leído o escrito
por el método llamado.
out especifica que este parámetro se pasa por referencia y se escribe mediante el
método llamado.

Vea también
Referencia de C#
Palabras clave de C#
Listas de argumentos en la especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Parámetros de métodos (Referencia de
C#)
Artículo • 18/02/2023 • Tiempo de lectura: 10 minutos

En C#, los argumentos se pueden pasar a parámetros por valor o por referencia.
Recuerde que los tipos de C# pueden ser tipos de referencia ( class ) o tipos de valor
( struct ):

Pasar por valor significa pasar una copia de la variable al método.

Pasar por referencia significa pasar el acceso a la variable al método.
Una variable de un tipo de referencia contiene una referencia a sus datos.
Una variable de un tipo de valor contiene sus datos directamente.

Como un struct es un tipo de valor, cuando pasa un struct mediante valor a un método,
el método recibe y funciona en una copia del argumento struct. El método no tiene
acceso al struct original en el método de llamada y, por lo tanto, no puede cambiarlo de
ninguna manera. El método solo puede cambiar la copia.

Una instancia de clase es un tipo de referencia, no un tipo de valor. Cuando un tipo de

referencia se pasa mediante valor a un método, el método recibe una copia de la
referencia a la instancia de clase. Es decir, el método al que se llama recibe una copia de
la dirección de la instancia y el método de llamada conserva la dirección original de la
instancia. La instancia de clase en el método de llamada tiene una dirección, el
parámetro en el método que se ha llamado tiene una copia de la dirección, y ambas
direcciones hacen referencia al mismo objeto. Como el parámetro solo contiene una
copia de la dirección, el método al que se ha llamado no puede cambiar la dirección de
la instancia de clase en el método de llamada. En cambio, el método al que se ha
llamado puede usar la copia de la dirección para acceder a los miembros de clase a los
que hacen referencia la dirección original y la copia de la dirección. Si el método al que
se ha llamado cambia un miembro de clase, la instancia de clase original en el método
de llamada también cambia.

En el resultado del ejemplo siguiente se ilustra la diferencia. El valor del campo

willIChange de la instancia de clase se cambia mediante la llamada al método
ClassTaker porque el método usa la dirección en el parámetro para buscar el campo

especificado de la instancia de clase. El campo willIChange del struct en el método de

llamada no se cambia mediante la llamada al método StructTaker porque el valor del
argumento es una copia del propio struct, no una copia de su dirección. StructTaker
cambia la copia, y la copia se pierde cuando se completa la llamada a StructTaker .
 C#

class TheClass

public string? willIChange;

struct TheStruct

public string willIChange;

class TestClassAndStruct

static void ClassTaker(TheClass c)

c.willIChange = "Changed";

static void StructTaker(TheStruct s)

s.willIChange = "Changed";

public static void Main()

TheClass testClass = new TheClass();

TheStruct testStruct = new TheStruct();

testClass.willIChange = "Not Changed";

testStruct.willIChange = "Not Changed";

ClassTaker(testClass);

StructTaker(testStruct);

Console.WriteLine("Class field = {0}", testClass.willIChange);

Console.WriteLine("Struct field = {0}", testStruct.willIChange);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Class field = Changed

Struct field = Not Changed

*/

Cómo se pasa un argumento y si es un tipo de referencia o un tipo de valor controla

qué modificaciones realizadas en el argumento son visibles desde el autor de la llamada.
Pasar un tipo de valor por valor
Cuando se pasa un tipo de valorpor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios no son visibles desde el autor de la llamada.

En el ejemplo siguiente se muestra cómo pasar los parámetros de tipo de valor en

función del valor. La variable n se pasa en función del valor al método SquareIt . Los
cambios que tienen lugar dentro del método no tienen ningún efecto en el valor
original de la variable.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(n); // Passing the variable by value.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(int x)

// The parameter x is passed by value.

// Changes to x will not affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 5

*/

La variable n es un tipo de valor. Contiene sus datos, el valor 5 . Cuando se invoca

SquareIt , el contenido de n se copia en el parámetro x , que se multiplica dentro del

método. En Main , sin embargo, el valor de n es el mismo después de llamar al

método SquareIt que el que era antes. El cambio que tiene lugar dentro del método
solo afecta a la variable local x .

Pasar un tipo de valor por referencia

Cuando se pasa un tipo de valorpor referencia:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que el argumento se pasa como
un parámetro ref . El valor del argumento subyacente, n , se cambia cuando se modifica
x en el método.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(ref n); // Passing the variable by reference.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(ref int x)

// The parameter x is passed by reference.

// Changes to x will affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 25

*/

En este ejemplo, no es el valor de n el que se pasa, sino una referencia a n . El

parámetro x no es un entero; se trata de una referencia a int , en este caso, una
referencia a n . Por tanto, cuando x se multiplica dentro del método, lo que realmente
se multiplica es a lo que x hace referencia, n .

Pasar un tipo de referencia por valor

Cuando se pasa un tipo de referenciapor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
 Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

En el ejemplo siguiente, se muestra cómo pasar un parámetro de tipo de referencia,

arr , en función del valor a un método, Change . Dado que el parámetro es una
referencia a arr , es posible cambiar los valores de los elementos de matriz. En cambio,
el intento de volver a asignar el parámetro a otra ubicación de memoria solo funciona
dentro del método y no afecta a la variable original, arr .

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(int[] pArray)

pArray[0] = 888; // This change affects the original element.

pArray = new int[5] { -3, -1, -2, -3, -4 }; // This change is local.

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: 888

*/

En el ejemplo anterior, la matriz, arr , que es un tipo de referencia, se pasa al método

sin el parámetro ref . En tal caso, se pasa al método una copia de la referencia, que
apunta a arr . El resultado muestra que es posible que el método cambie el contenido
de un elemento de matriz, en este caso de 1 a 888 . En cambio, si se asigna una nueva
porción de memoria al usar el operador new dentro del método Change , la variable
pArray hace referencia a una nueva matriz. Por tanto, cualquier cambio que hubiese
después no afectará a la matriz original, arr , que se ha creado dentro de Main . De
hecho, se crean dos matrices en este ejemplo, una dentro de Main y otra dentro del
método Change .

Pasar un tipo de referencia por referencia

Cuando se pasa un tipo de referenciapor referencia:
 Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que la palabra clave ref se
agrega a la llamada y al encabezado de método. Los cambios que tengan lugar en el
método afectan a la variable original en el programa que realiza la llamada.

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(ref arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(ref int[] pArray)

// Both of the following changes will affect the original variables:

pArray[0] = 888;

pArray = new int[5] { -3, -1, -2, -3, -4 };

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: -3

*/

Todos los cambios que tienen lugar dentro del método afectan a la matriz original en
Main . De hecho, la matriz original se reasigna mediante el operador new . Por tanto,

después de llamar al método Change , cualquier referencia a arr apunta a la matriz de

cinco elementos, que se crea en el método Change .

Ámbito de las referencias y los valores

Los métodos pueden almacenar los valores de los parámetros en campos. Cuando los
parámetros se pasan por valor, siempre es seguro. Los valores se copian y se puede
acceder a los tipos de referencia cuando se almacenan en un campo. Pasar parámetros
por referencia de forma segura requiere que el compilador defina cuándo es seguro
asignar una referencia a una nueva variable. Para cada expresión, el compilador define
un ámbito que enlaza el acceso a una expresión o una variable. El compilador usa dos
ámbitos: safe_to_escape y ref_safe_to_escape.

El ámbito safe_to_escape define el ámbito en el que se puede acceder de forma

segura a cualquier expresión.
El ámbito ref_safe_to_escape define el ámbito en el que se puede acceder o
modificar de forma segura una referencia a cualquier expresión.

Informalmente, puede considerar estos ámbitos como un mecanismo para asegurarse

de que el código nunca accede o modifica una referencia que ya no es válida. Una
referencia es válida siempre que haga referencia a un objeto o estructura válidos. El
ámbito safe_to_escape define cuándo se puede asignar o reasignar una variable. El
ámbito ref_safe_to_escape define cuándo una variable se puede asignar ref o reasignar
ref. La asignación asigna una variable a un nuevo valor; la asignación por referencia
asigna la variable para hacer referencia a otra ubicación de almacenamiento.

Modificadores
Los parámetros declarados para un método sin in, ref o out se pasan al método llamado
por valor. Los modificadores ref , in y out difieren en las reglas de asignación:

El argumento de un parámetro ref se debe asignar definitivamente. El método

llamado puede reasignar ese parámetro.
El argumento de un parámetro in se debe asignar definitivamente. El método
llamado no puede reasignar ese parámetro.
No es necesario asignar definitivamente el argumento de un parámetro out . El
método llamado debe asignar el parámetro.

Esta sección describe las palabras clave que puede usar para declarar parámetros de
métodos:

params especifica que este parámetro puede tomar un número variable de

argumentos.
in especifica que este parámetro se pasa por referencia, pero solo se lee mediante
el método llamado.
ref especifica que este parámetro se pasa por referencia y puede ser leído o escrito
por el método llamado.
out especifica que este parámetro se pasa por referencia y se escribe mediante el
método llamado.

Vea también
Referencia de C#
Palabras clave de C#
Listas de argumentos en la especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Parámetros de métodos (Referencia de
C#)
Artículo • 18/02/2023 • Tiempo de lectura: 10 minutos

En C#, los argumentos se pueden pasar a parámetros por valor o por referencia.
Recuerde que los tipos de C# pueden ser tipos de referencia ( class ) o tipos de valor
( struct ):

Pasar por valor significa pasar una copia de la variable al método.

Pasar por referencia significa pasar el acceso a la variable al método.
Una variable de un tipo de referencia contiene una referencia a sus datos.
Una variable de un tipo de valor contiene sus datos directamente.

Como un struct es un tipo de valor, cuando pasa un struct mediante valor a un método,
el método recibe y funciona en una copia del argumento struct. El método no tiene
acceso al struct original en el método de llamada y, por lo tanto, no puede cambiarlo de
ninguna manera. El método solo puede cambiar la copia.

Una instancia de clase es un tipo de referencia, no un tipo de valor. Cuando un tipo de

referencia se pasa mediante valor a un método, el método recibe una copia de la
referencia a la instancia de clase. Es decir, el método al que se llama recibe una copia de
la dirección de la instancia y el método de llamada conserva la dirección original de la
instancia. La instancia de clase en el método de llamada tiene una dirección, el
parámetro en el método que se ha llamado tiene una copia de la dirección, y ambas
direcciones hacen referencia al mismo objeto. Como el parámetro solo contiene una
copia de la dirección, el método al que se ha llamado no puede cambiar la dirección de
la instancia de clase en el método de llamada. En cambio, el método al que se ha
llamado puede usar la copia de la dirección para acceder a los miembros de clase a los
que hacen referencia la dirección original y la copia de la dirección. Si el método al que
se ha llamado cambia un miembro de clase, la instancia de clase original en el método
de llamada también cambia.

En el resultado del ejemplo siguiente se ilustra la diferencia. El valor del campo

willIChange de la instancia de clase se cambia mediante la llamada al método
ClassTaker porque el método usa la dirección en el parámetro para buscar el campo

especificado de la instancia de clase. El campo willIChange del struct en el método de

llamada no se cambia mediante la llamada al método StructTaker porque el valor del
argumento es una copia del propio struct, no una copia de su dirección. StructTaker
cambia la copia, y la copia se pierde cuando se completa la llamada a StructTaker .
 C#

class TheClass

public string? willIChange;

struct TheStruct

public string willIChange;

class TestClassAndStruct

static void ClassTaker(TheClass c)

c.willIChange = "Changed";

static void StructTaker(TheStruct s)

s.willIChange = "Changed";

public static void Main()

TheClass testClass = new TheClass();

TheStruct testStruct = new TheStruct();

testClass.willIChange = "Not Changed";

testStruct.willIChange = "Not Changed";

ClassTaker(testClass);

StructTaker(testStruct);

Console.WriteLine("Class field = {0}", testClass.willIChange);

Console.WriteLine("Struct field = {0}", testStruct.willIChange);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Class field = Changed

Struct field = Not Changed

*/

Cómo se pasa un argumento y si es un tipo de referencia o un tipo de valor controla

qué modificaciones realizadas en el argumento son visibles desde el autor de la llamada.
Pasar un tipo de valor por valor
Cuando se pasa un tipo de valorpor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios no son visibles desde el autor de la llamada.

En el ejemplo siguiente se muestra cómo pasar los parámetros de tipo de valor en

función del valor. La variable n se pasa en función del valor al método SquareIt . Los
cambios que tienen lugar dentro del método no tienen ningún efecto en el valor
original de la variable.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(n); // Passing the variable by value.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(int x)

// The parameter x is passed by value.

// Changes to x will not affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 5

*/

La variable n es un tipo de valor. Contiene sus datos, el valor 5 . Cuando se invoca

SquareIt , el contenido de n se copia en el parámetro x , que se multiplica dentro del

método. En Main , sin embargo, el valor de n es el mismo después de llamar al

método SquareIt que el que era antes. El cambio que tiene lugar dentro del método
solo afecta a la variable local x .

Pasar un tipo de valor por referencia

Cuando se pasa un tipo de valorpor referencia:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que el argumento se pasa como
un parámetro ref . El valor del argumento subyacente, n , se cambia cuando se modifica
x en el método.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(ref n); // Passing the variable by reference.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(ref int x)

// The parameter x is passed by reference.

// Changes to x will affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 25

*/

En este ejemplo, no es el valor de n el que se pasa, sino una referencia a n . El

parámetro x no es un entero; se trata de una referencia a int , en este caso, una
referencia a n . Por tanto, cuando x se multiplica dentro del método, lo que realmente
se multiplica es a lo que x hace referencia, n .

Pasar un tipo de referencia por valor

Cuando se pasa un tipo de referenciapor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
 Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

En el ejemplo siguiente, se muestra cómo pasar un parámetro de tipo de referencia,

arr , en función del valor a un método, Change . Dado que el parámetro es una
referencia a arr , es posible cambiar los valores de los elementos de matriz. En cambio,
el intento de volver a asignar el parámetro a otra ubicación de memoria solo funciona
dentro del método y no afecta a la variable original, arr .

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(int[] pArray)

pArray[0] = 888; // This change affects the original element.

pArray = new int[5] { -3, -1, -2, -3, -4 }; // This change is local.

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: 888

*/

En el ejemplo anterior, la matriz, arr , que es un tipo de referencia, se pasa al método

sin el parámetro ref . En tal caso, se pasa al método una copia de la referencia, que
apunta a arr . El resultado muestra que es posible que el método cambie el contenido
de un elemento de matriz, en este caso de 1 a 888 . En cambio, si se asigna una nueva
porción de memoria al usar el operador new dentro del método Change , la variable
pArray hace referencia a una nueva matriz. Por tanto, cualquier cambio que hubiese
después no afectará a la matriz original, arr , que se ha creado dentro de Main . De
hecho, se crean dos matrices en este ejemplo, una dentro de Main y otra dentro del
método Change .

Pasar un tipo de referencia por referencia

Cuando se pasa un tipo de referenciapor referencia:
 Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que la palabra clave ref se
agrega a la llamada y al encabezado de método. Los cambios que tengan lugar en el
método afectan a la variable original en el programa que realiza la llamada.

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(ref arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(ref int[] pArray)

// Both of the following changes will affect the original variables:

pArray[0] = 888;

pArray = new int[5] { -3, -1, -2, -3, -4 };

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: -3

*/

Todos los cambios que tienen lugar dentro del método afectan a la matriz original en
Main . De hecho, la matriz original se reasigna mediante el operador new . Por tanto,

después de llamar al método Change , cualquier referencia a arr apunta a la matriz de

cinco elementos, que se crea en el método Change .

Ámbito de las referencias y los valores

Los métodos pueden almacenar los valores de los parámetros en campos. Cuando los
parámetros se pasan por valor, siempre es seguro. Los valores se copian y se puede
acceder a los tipos de referencia cuando se almacenan en un campo. Pasar parámetros
por referencia de forma segura requiere que el compilador defina cuándo es seguro
asignar una referencia a una nueva variable. Para cada expresión, el compilador define
un ámbito que enlaza el acceso a una expresión o una variable. El compilador usa dos
ámbitos: safe_to_escape y ref_safe_to_escape.

El ámbito safe_to_escape define el ámbito en el que se puede acceder de forma

segura a cualquier expresión.
El ámbito ref_safe_to_escape define el ámbito en el que se puede acceder o
modificar de forma segura una referencia a cualquier expresión.

Informalmente, puede considerar estos ámbitos como un mecanismo para asegurarse

de que el código nunca accede o modifica una referencia que ya no es válida. Una
referencia es válida siempre que haga referencia a un objeto o estructura válidos. El
ámbito safe_to_escape define cuándo se puede asignar o reasignar una variable. El
ámbito ref_safe_to_escape define cuándo una variable se puede asignar ref o reasignar
ref. La asignación asigna una variable a un nuevo valor; la asignación por referencia
asigna la variable para hacer referencia a otra ubicación de almacenamiento.

Modificadores
Los parámetros declarados para un método sin in, ref o out se pasan al método llamado
por valor. Los modificadores ref , in y out difieren en las reglas de asignación:

El argumento de un parámetro ref se debe asignar definitivamente. El método

llamado puede reasignar ese parámetro.
El argumento de un parámetro in se debe asignar definitivamente. El método
llamado no puede reasignar ese parámetro.
No es necesario asignar definitivamente el argumento de un parámetro out . El
método llamado debe asignar el parámetro.

Esta sección describe las palabras clave que puede usar para declarar parámetros de
métodos:

params especifica que este parámetro puede tomar un número variable de

argumentos.
in especifica que este parámetro se pasa por referencia, pero solo se lee mediante
el método llamado.
ref especifica que este parámetro se pasa por referencia y puede ser leído o escrito
por el método llamado.
out especifica que este parámetro se pasa por referencia y se escribe mediante el
método llamado.

Vea también
Referencia de C#
Palabras clave de C#
Listas de argumentos en la especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Variables locales con asignación
implícita de tipos (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Las variables locales pueden declararse sin proporcionar un tipo explícito. La palabra
clave var indica al compilador que infiera el tipo de la variable a partir de la expresión
de la derecha de la instrucción de inicialización. El tipo inferido puede ser un tipo
integrado, un tipo anónimo, un tipo definido por el usuario o un tipo definido en la
biblioteca de clases .NET. Para obtener más información sobre cómo inicializar las
matrices con var , vea Matrices con tipo implícito.

Los ejemplos siguientes muestran distintas formas en que se pueden declarar variables
locales con var :

C#

// i is compiled as an int

var i = 5;

// s is compiled as a string

var s = "Hello";

// a is compiled as int[]

var a = new[] { 0, 1, 2 };

// expr is compiled as IEnumerable<Customer>

// or perhaps IQueryable<Customer>

var expr =

from c in customers
where c.City == "London"

select c;

// anon is compiled as an anonymous type

var anon = new { Name = "Terry", Age = 34 };

// list is compiled as List<int>

var list = new List<int>();

Es importante comprender que la palabra clave var no significa "variant" ni indica que
la variable esté débilmente tipada o esté enlazada en tiempo de ejecución. Solo significa
que el compilador determina y asigna el tipo más adecuado.

La palabra clave var se puede usar en los contextos siguientes:

 En variables locales (variables declaradas en el ámbito del método), tal y como se
muestra en el ejemplo anterior.

En una instrucción de inicialización for.

C#

for (var x = 1; x < 10; x++)

En una instrucción de inicialización foreach.

C#

foreach (var item in list) {...}

En una instrucción using.

C#

using (var file = new StreamReader("C:\\myfile.txt")) {...}

Para obtener más información, vea Procedimiento para usar matrices y variables locales
con tipo implícito en expresiones de consulta.

var y tipos anónimos

En muchos casos, el uso de var es opcional y es simplemente una comodidad
sintáctica. Pero cuando una variable se inicializa con un tipo anónimo, la variable se
debe declarar como var si necesita acceder más adelante a las propiedades del objeto.
Se trata de un escenario común en expresiones de consulta LINQ. Para obtener más
información, consulte Tipos anónimos (Guía de programación de C#).

Desde el punto de vista del código fuente, un tipo anónimo no tiene nombre. Por lo
tanto, si una variable de consulta se ha inicializado con var , la única manera de tener
acceso a las propiedades de la secuencia de objetos devuelta consiste en usar var
como el tipo de la variable de iteración en la instrucción foreach .

C#

class ImplicitlyTypedLocals2

static void Main()

 string[] words = { "aPPLE", "BlUeBeRrY", "cHeRry" };

// If a query produces a sequence of anonymous types,

// then use var in the foreach statement to access the properties.

var upperLowerWords =

from w in words

select new { Upper = w.ToUpper(), Lower = w.ToLower() };

// Execute the query

foreach (var ul in upperLowerWords)

Console.WriteLine("Uppercase: {0}, Lowercase: {1}", ul.Upper,

ul.Lower);

/* Outputs:

Uppercase: APPLE, Lowercase: apple

Uppercase: BLUEBERRY, Lowercase: blueberry

Uppercase: CHERRY, Lowercase: cherry

*/

Comentarios
Las siguientes restricciones se aplican a las declaraciones de variable con tipo implícito:

var solo se puede usar cuando una variable local se declara e inicializa en la
misma instrucción; la variable no se puede inicializar en null ni en un grupo de
métodos o una función anónima.

var no se puede usar en campos en el ámbito de clase.

Las variables declaradas con var no se pueden usar en la expresión de

inicialización. En otras palabras, esta expresión es válida: int i = (i = 20); , pero
esta expresión genera un error en tiempo de compilación: var i = (i = 20);

No se pueden inicializar varias variables con tipo implícito en la misma instrucción.

Si en el ámbito se encuentra un tipo con nombre var , la palabra clave var se

resolverá en ese nombre de tipo y no se tratará como parte de una declaración de
variable local con tipo implícito.

El establecimiento de tipos implícitos con la palabra clave var solo puede aplicarse a
variables en el ámbito del método local. El establecimiento de tipos implícitos no está
disponible para los campos de clase ya que el compilador C# encontraría una paradoja
lógica al procesar el código: el compilador necesita conocer el tipo de campo, pero no
puede determinar el tipo hasta que se analiza la expresión de asignación, y no se puede
evaluar la expresión sin conocer el tipo. Observe el código siguiente:

C#

private var bookTitles;

bookTitles es un campo de clase dado el tipo var . Como el campo no tiene ninguna

expresión que evaluar, es imposible que el compilador pueda inferir el tipo bookTitles
que se supone que es. Además, agregar una expresión al campo (como se haría con una
variable local) también es suficiente:

C#

private var bookTitles = new List<string>();

Cuando el compilador encuentra campos durante la compilación de código, registra el

tipo de cada campo antes de procesar las expresiones asociadas a él. El compilador
encuentra la misma paradoja intentando analizar bookTitles : necesita saber el tipo de
campo, pero el compilador normalmente determinaría el tipo de var analizando la
expresión, lo que no es posible sin conocer de antemano el tipo.

Es posible que var también pueda resultar útil con expresiones de consulta en las que
es difícil determinar el tipo construido exacto de la variable de consulta. Esto puede
ocurrir con las operaciones de agrupamiento y ordenación.

La palabra clave var también puede ser útil cuando resulte tedioso escribir el tipo
específico de la variable en el teclado, o sea obvio o no aumente la legibilidad del
código. Un ejemplo en el que var resulta útil de esta manera es cuando se usa con
tipos genéricos anidados, como los que se emplean con las operaciones de grupo. En la
siguiente consulta, el tipo de la variable de consulta es IEnumerable<IGrouping<string,
Student>> . Siempre que usted y otras personas que deban mantener el código

comprendan esto, no hay ningún problema con el uso de tipos implícitos por
comodidad y brevedad.

C#

// Same as previous example except we use the entire last name as a key.

// Query variable is an IEnumerable<IGrouping<string, Student>>

var studentQuery3 =

from student in students

group student by student.Last;

El uso de var ayuda a simplificar el código, pero debe quedar restringido a los casos en
los que sea necesario, o cuando haga que el código sea más fácil de leer. Para obtener
más información sobre cuándo usar var correctamente, vea la sección Variables locales
con asignación implícita de tipos en el artículo sobre directrices de codificación de C#.

Vea también
Referencia de C#
Matrices con tipo implícito
Procedimiento para usar matrices y variables locales con tipo implícito en
expresiones de consulta
Tipos anónimos
Inicializadores de objeto y colección
var
LINQ en C#
LINQ (Language Integrated Query)
Instrucciones de iteración
using (instrucción)
Procedimiento para usar matrices y
variables locales con tipo implícito en
expresiones de consulta (Guía de
programación de C#)
Artículo • 11/02/2023 • Tiempo de lectura: 2 minutos

Puede usar variables locales con tipo implícito siempre que quiera que el compilador
determine el tipo de una variable local. Debe usar variables locales con tipo implícito
para almacenar tipos anónimos, que a menudo se usan en las expresiones de consulta.
En los ejemplos siguientes, se muestran los usos obligatorios y opcionales de las
variables locales con tipo implícito en las consultas.

Las variables locales con tipo implícito se declaran mediante la palabra clave contextual
var. Para obtener más información, vea Variables locales con asignación implícita de
tipos y Matrices con asignación implícita de tipos.

Ejemplos
En el ejemplo siguiente, se muestra un escenario común en el que la palabra clave var
es necesaria: una expresión de consulta que genera una secuencia de tipos anónimos.
En este escenario, la variable de consulta y la variable de iteración en la instrucción
foreach deben escribirse de forma implícita mediante el uso de var porque no se tiene

acceso a un nombre de tipo para el tipo anónimo. Para obtener más información sobre
los tipos anónimos, vea Tipos anónimos.

C#

private static void QueryNames(char firstLetter)

// Create the query. Use of var is required because

// the query produces a sequence of anonymous types:

// System.Collections.Generic.IEnumerable<????>.

var studentQuery =

from student in students

where student.FirstName[0] == firstLetter

select new { student.FirstName, student.LastName };

// Execute the query and display the results.

foreach (var anonType in studentQuery)

Console.WriteLine("First = {0}, Last = {1}", anonType.FirstName,

anonType.LastName);

En el ejemplo siguiente, se usa la palabra clave var en una situación similar, pero en la
que el uso de var es opcional. Dado que student.LastName es una cadena, la ejecución
de la consulta devuelve una secuencia de cadenas. Por tanto, el tipo de queryId podría
declararse como System.Collections.Generic.IEnumerable<string> en lugar de var . La
palabra clave var se usa por comodidad. En el ejemplo, la variable de iteración en la
instrucción foreach se escribe de forma explícita como una cadena, pero se podría
declarar mediante var . Dado que el tipo de la variable de iteración no es un tipo
anónimo, el uso de var es opcional, no es obligatorio. Recuerde que var no es un tipo,
sino una instrucción para que el compilador deduzca y asigne el tipo.

C#

// Variable queryId could be declared by using

// System.Collections.Generic.IEnumerable<string>

// instead of var.

var queryId =

from student in students

where student.Id > 111

select student.LastName;

// Variable str could be declared by using var instead of string.

foreach (string str in queryId)

Console.WriteLine("Last name: {0}", str);

Vea también
Guía de programación de C#
Métodos de extensión
LINQ (Language Integrated Query)
LINQ en C#
Métodos de extensión (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 11 minutos

Los métodos de extensión permiten "agregar" métodos a los tipos existentes sin crear
un nuevo tipo derivado, recompilar o modificar de otra manera el tipo original. Los
métodos de extensión son métodos estáticos, pero se les llama como si fueran métodos
de instancia en el tipo extendido. En el caso del código de cliente escrito en C#, F# y
Visual Basic, no existe ninguna diferencia aparente entre llamar a un método de
extensión y llamar a los métodos definidos en un tipo.

Los métodos de extensión más comunes son los operadores de consulta LINQ estándar,
que agregan funciones de consulta a los tipos System.Collections.IEnumerable y
System.Collections.Generic.IEnumerable<T> existentes. Para usar los operadores de
consulta estándar, inclúyalos primero en el ámbito con una directiva using System.Linq .
A partir de ese momento, cualquier tipo que implemente IEnumerable<T> parecerá
tener métodos de instancia como GroupBy, OrderBy, Average, etc. Puede ver estos
métodos adicionales en la finalización de instrucciones de IntelliSense al escribir "punto"
después de una instancia de un tipo IEnumerable<T>, como List<T> o Array.

Ejemplo de OrderBy
En el ejemplo siguiente se muestra cómo llamar al método OrderBy de operador de
consulta estándar en una matriz de enteros. La expresión entre paréntesis es una
expresión lambda. Muchos operadores de consulta estándar toman expresiones lambda
como parámetros, pero no es un requisito para los métodos de extensión. Para obtener
más información, vea Expresiones lambda.

C#

class ExtensionMethods2

static void Main()

int[] ints = { 10, 45, 15, 39, 21, 26 };

var result = ints.OrderBy(g => g);

foreach (var i in result)

System.Console.Write(i + " ");

//Output: 10 15 21 26 39 45

Los métodos de extensión se definen como métodos estáticos, pero se les llama usando
la sintaxis de método de instancia. Su primer parámetro especifica en qué tipo funciona
el método. El parámetro va precedido del modificador this. Los métodos de extensión
únicamente se encuentran dentro del ámbito cuando el espacio de nombres se importa
explícitamente en el código fuente con una directiva using .

En el ejemplo siguiente se muestra un método de extensión definido para la clase

System.String. Se define dentro de una clase estática no anidada y no genérica:

C#

namespace ExtensionMethods

public static class MyExtensions

public static int WordCount(this string str)

return str.Split(new char[] { ' ', '.', '?' },

StringSplitOptions.RemoveEmptyEntries).Length;

El método de extensión WordCount se puede incluir en el ámbito con esta directiva

using :

C#

using ExtensionMethods;

También se le puede llamar desde una aplicación con esta sintaxis:

C#

string s = "Hello Extension Methods";

int i = s.WordCount();

El método de extensión se invoca en el código con la sintaxis de método de instancia. El

lenguaje intermedio (IL) generado por el compilador convierte el código en una llamada
en el método estático. El principio de encapsulación no se infringe realmente. Los
métodos de extensión no pueden tener acceso a las variables privadas en el tipo que
extienden.
Tanto la clase MyExtensions como el método WordCount son static , y se puede acceder
a ellos como a todos los demás miembros static . El método WordCount se puede
invocar como otros métodos static , como se muestra a continuación:

C#

string s = "Hello Extension Methods";

int i = MyExtensions.WordCount(s);

El código de C# anterior:

Declara y asigna un nuevo objeto string denominado s con un valor de "Hello

Extension Methods" .

Llama a MyExtensions.WordCount dado el argumento s .

Para más información, consulte Implementación e invocación de un método de

extensión personalizado.

En general, probablemente se llamará a métodos de extensión con mucha más

frecuencia de la que se implementarán métodos propios. Dado que los métodos de
extensión se llaman con la sintaxis de método de instancia, no se requieren
conocimientos especiales para usarlos desde el código de cliente. Para habilitar los
métodos de extensión para un tipo determinado, basta con agregar una directiva using
para el espacio de nombres en el que se definen los métodos. Por ejemplo, para usar los
operadores de consulta estándar, agregue esta directiva using al código:

C#

using System.Linq;

(Puede que haya que agregar también una referencia a System.Core.dll). Observará que
los operadores de consulta estándar aparecen ahora en IntelliSense como métodos
adicionales disponibles para la mayoría de los tipos IEnumerable<T>.

Enlazar métodos de extensión en tiempo de

compilación
Se pueden usar métodos de extensión para ampliar una clase o interfaz, pero no para
invalidarlas. Nunca se llamará a un método de extensión con el mismo nombre y
signatura que un método de interfaz o clase. En tiempo de compilación, los métodos de
extensión siempre tienen menos prioridad que los métodos de instancia definidos en el
propio tipo. En otras palabras, si un tipo tiene un método denominado Process(int i)
y hay un método de extensión con la misma signatura, el compilador siempre se
enlazará al método de instancia. Cuando el compilador encuentra una invocación de
método, primero busca una coincidencia en los métodos de instancia del tipo. Si no la
hay, buscará cualquier método de extensión definido para el tipo y se enlazará al primer
método de extensión que encuentre. En el ejemplo siguiente se muestra cómo
determina el compilador a qué método de extensión o de instancia enlazarse.

Ejemplo
En el ejemplo siguiente se muestran las reglas que el compilador de C# sigue para
determinar si se va a enlazar una llamada a método a un método de instancia del tipo o
a un método de extensión. La clase estática Extensions contiene métodos de extensión
definidos para cualquier tipo que implemente IMyInterface . Las clases A , B y C
implementan la interfaz.

Nunca se llama al método de extensión MethodB , porque su nombre y signatura

coinciden exactamente con los métodos ya implementados por las clases.

Si el compilador no encuentra un método de instancia con una signatura coincidente, se

enlazará a un método de extensión coincidente, si existe.

C#

// Define an interface named IMyInterface.

namespace DefineIMyInterface

using System;

public interface IMyInterface

// Any class that implements IMyInterface must define a method

// that matches the following signature.

void MethodB();

// Define extension methods for IMyInterface.

namespace Extensions

using System;

using DefineIMyInterface;

// The following extension methods can be accessed by instances of any

// class that implements IMyInterface.

public static class Extension

 public static void MethodA(this IMyInterface myInterface, int i)

Console.WriteLine

("Extension.MethodA(this IMyInterface myInterface, int i)");

public static void MethodA(this IMyInterface myInterface, string s)

Console.WriteLine

("Extension.MethodA(this IMyInterface myInterface, string

s)");

// This method is never called in ExtensionMethodsDemo1, because

each

// of the three classes A, B, and C implements a method named

MethodB

// that has a matching signature.

public static void MethodB(this IMyInterface myInterface)

Console.WriteLine

("Extension.MethodB(this IMyInterface myInterface)");

// Define three classes that implement IMyInterface, and then use them to
test

// the extension methods.

namespace ExtensionMethodsDemo1

using System;

using Extensions;

using DefineIMyInterface;

class A : IMyInterface

public void MethodB() { Console.WriteLine("A.MethodB()"); }

class B : IMyInterface

public void MethodB() { Console.WriteLine("B.MethodB()"); }

public void MethodA(int i) { Console.WriteLine("B.MethodA(int i)");

}

class C : IMyInterface

public void MethodB() { Console.WriteLine("C.MethodB()"); }

public void MethodA(object obj)

Console.WriteLine("C.MethodA(object obj)");

 class ExtMethodDemo

static void Main(string[] args)

// Declare an instance of class A, class B, and class C.

A a = new A();

B b = new B();

C c = new C();

// For a, b, and c, call the following methods:

// -- MethodA with an int argument

// -- MethodA with a string argument

// -- MethodB with no argument.

// A contains no MethodA, so each call to MethodA resolves to

// the extension method that has a matching signature.

a.MethodA(1); // Extension.MethodA(IMyInterface, int)

a.MethodA("hello"); // Extension.MethodA(IMyInterface,
string)

// A has a method that matches the signature of the following

call

// to MethodB.

a.MethodB(); // A.MethodB()

// B has methods that match the signatures of the following

// method calls.

b.MethodA(1); // B.MethodA(int)

b.MethodB(); // B.MethodB()

// B has no matching method for the following call, but

// class Extension does.

b.MethodA("hello"); // Extension.MethodA(IMyInterface,
string)

// C contains an instance method that matches each of the

following

// method calls.

c.MethodA(1); // C.MethodA(object)

c.MethodA("hello"); // C.MethodA(object)

c.MethodB(); // C.MethodB()

/* Output:

Extension.MethodA(this IMyInterface myInterface, int i)

Extension.MethodA(this IMyInterface myInterface, string s)

A.MethodB()

B.MethodA(int i)

B.MethodB()

Extension.MethodA(this IMyInterface myInterface, string s)

C.MethodA(object obj)

C.MethodA(object obj)

 C.MethodB()

*/

Patrones de uso común

Funcionalidad de colección
En el pasado, era habitual crear "Clases de colección" que implementaban la interfaz
System.Collections.Generic.IEnumerable<T> para un tipo especificado e incluían una
funcionalidad que actuaba en colecciones de ese tipo. Aunque no hay ningún problema
con la creación de este tipo de objeto de colección, se puede lograr la misma
funcionalidad mediante una extensión en System.Collections.Generic.IEnumerable<T>.
Las extensiones tienen la ventaja de permitir que se llame a la funcionalidad desde
cualquier colección como System.Array o System.Collections.Generic.List<T> que
implementa System.Collections.Generic.IEnumerable<T> en ese tipo. Encontrará un
ejemplo de esto mediante una matriz de Int32 anteriormente en este artículo.

Funcionalidad específica de la capa

Al usar Onion Architecture (Arquitectura cebolla) u otro diseño de la aplicación por
niveles, es habitual tener un conjunto de entidades de dominio u objetos de
transferencia de datos que se pueden usar para la comunicación entre los límites de la
aplicación. Por regla general, estos objetos no contienen ninguna funcionalidad o
contienen únicamente una funcionalidad mínima que se aplica a todas las capas de la
aplicación. Los métodos de extensión se pueden usar para agregar una funcionalidad
específica de cada capa de la aplicación sin cargar el objeto con métodos no necesarios
o deseados en otras capas.

C#

public class DomainEntity

public int Id { get; set; }

public string FirstName { get; set; }

public string LastName { get; set; }

static class DomainEntityExtensions

static string FullName(this DomainEntity value)

=> $"{value.FirstName} {value.LastName}";

Ampliación de tipos predefinidos

En lugar de crear objetos cuando es necesario crear una funcionalidad reutilizable, a
menudo podemos ampliar un tipo existente como un tipo CLR o de .NET. Como
ejemplo, si no usamos métodos de extensión, podemos crear una clase Engine o Query
para ejecutar una consulta en un servidor SQL Server al que se puede llamar desde
varias ubicaciones en nuestro código. Sin embargo, en su lugar, podemos ampliar la
clase System.Data.SqlClient.SqlConnection mediante métodos de extensión para realizar
esa consulta desde cualquier lugar en el que tengamos una conexión a un servidor SQL
Server. Otros ejemplos podrían ser la adición de una funcionalidad común a la clase
System.String, la ampliación de las funcionalidades de procesamiento de datos de los
objetos System.IO.File y System.IO.Stream, y los objetos System.Exception para una
funcionalidad de control de errores específica. Solo su imaginación y sentido común
limitan estos tipos de casos de uso.

La ampliación de tipos predefinidos puede ser difícil con los tipos struct , ya que se
pasan en función del valor a los métodos. Eso significa que los cambios en la estructura
se realizan en una copia de la misma. Esos cambios dejarán de verse una vez que se
salga del método de extensión. Puede agregar el modificador ref al primer argumento
de un método de extensión. La adición del modificador ref significa que el primer
argumento se pasa por referencia. Esto le permite escribir métodos de extensión que
cambian el estado de la estructura que se amplía.

Instrucciones generales
Aunque sigue considerándose preferible agregar la funcionalidad modificando un
código del objeto o derivando un nuevo tipo siempre que sea razonable y posible
hacerlo, los métodos de extensión se han convertido en una opción fundamental para
crear una funcionalidad reutilizable en todo el ecosistema .NET. Para esas ocasiones en
las que no cuente con el control del origen original, si un objeto derivado es inadecuado
o imposible, o la funcionalidad no se debe exponer más allá de su ámbito aplicable, los
métodos de extensión son una opción excelente.

Para obtener más información sobre los tipos derivados, consulte Herencia.

Al usar un método de extensión para ampliar un tipo cuyo código fuente no está bajo
su control, se corre el riesgo de que un cambio en la implementación del tipo
interrumpa el método de extensión.

Si se implementan métodos de extensión para un tipo determinado, recuerde los

puntos siguientes:
 Nunca se llamará a un método de extensión si tiene la misma signatura que un
método definido en el tipo.
Los métodos de extensión se incluyen en el ámbito en el nivel de espacio de
nombres. Por ejemplo, si se tienen varias clases estáticas que contienen métodos
de extensión en un único espacio de nombres denominado Extensions , la
directiva using Extensions; los incluirá a todos en el ámbito.

Para una biblioteca de clases ya implementada, no deben usarse métodos de extensión

para evitar incrementar el número de versión de un ensamblado. Si quiere agregar una
funcionalidad significativa a una biblioteca de cuyo código fuente es propietario, siga las
instrucciones de .NET estándar para el control de versiones de ensamblado. Para
obtener más información, vea Versiones de los ensamblados.

Vea también
Guía de programación de C#
Ejemplos de programación en paralelo (incluyen numerosos métodos de extensión
de ejemplo)
Expresiones lambda
Información general sobre operadores de consulta estándar
Conversion rules for Instance parameters and their impact (Reglas de conversión
para los parámetros de instancia y su impacto)
Extension methods Interoperability between languages (Interoperabilidad de los
métodos de extensión entre lenguajes)
Extension methods and Curried Delegates (Métodos de extensión y delegados
currificados)
Extension method Binding and Error reporting (Enlazar métodos de extensión y
notificación de errores)
Procedimiento para implementar e
invocar un método de extensión
personalizado (Guía de programación
de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este tema se muestra cómo implementar sus propios métodos de extensión para
cualquier tipo de .NET. El código de cliente puede usar los métodos de extensión
agregando una referencia a la DLL que los contiene y agregando una directiva using
que especifique el espacio de nombres en el que se definen los métodos de extensión.

Para definir y llamar al método de extensión

1. Defina una class estática que contenga el método de extensión.

La clase debe estar visible para el código de cliente. Para obtener más información
sobre las reglas de accesibilidad, vea Modificadores de acceso.

2. Implemente el método de extensión como un método estático con al menos la

misma visibilidad que la clase contenedora.

3. El primer parámetro del método especifica el tipo en el que opera el método; debe
ir precedido del modificador this.

4. En el código de llamada, agregue una directiva using para especificar el espacio

de nombres que contiene la clase del método de extensión.

5. Llame a los métodos como si fueran métodos de instancia del tipo.

Tenga en cuenta que el primer parámetro no se especifica mediante el código de

llamada, ya que representa el tipo al que se aplica el operador y el compilador ya
conoce el tipo del objeto. Solo tiene que proporcionar argumentos para los
parámetros comprendidos entre el 2 y n .

Ejemplo
En el ejemplo siguiente se implementa un método de extensión denominado WordCount
en la clase CustomExtensions.StringExtension . El método opera en la clase String, que
se especifica como el primer parámetro de método. El espacio de nombres
CustomExtensions se importa en el espacio de nombres de la aplicación y se llama al

método dentro del método Main .

C#

using System.Linq;

using System.Text;

using System;

namespace CustomExtensions

// Extension methods must be defined in a static class.

public static class StringExtension

// This is the extension method.

// The first parameter takes the "this" modifier

// and specifies the type for which the method is defined.

public static int WordCount(this string str)

return str.Split(new char[] {' ', '.','?'},

StringSplitOptions.RemoveEmptyEntries).Length;

namespace Extension_Methods_Simple

// Import the extension method namespace.

using CustomExtensions;

class Program

static void Main(string[] args)

string s = "The quick brown fox jumped over the lazy dog.";

// Call the method as if it were an

// instance method on the type. Note that the first

// parameter is not specified by the calling code.

int i = s.WordCount();

System.Console.WriteLine("Word count of s is {0}", i);

Seguridad de .NET
Los métodos de extensión no presentan ninguna vulnerabilidad de seguridad específica.
No se pueden usar nunca para suplantar los métodos existentes en un tipo, porque
todos los conflictos de nombres se resuelven a favor de la instancia o del método
estático definido por el tipo en cuestión. Los métodos de extensión no pueden tener
acceso a los datos privados de la clase extendida.
Vea también
Guía de programación de C#
Métodos de extensión
LINQ (Language Integrated Query)
Clases estáticas y sus miembros
protected
internal
public
this
namespace
Procedimiento para crear un método
nuevo para una enumeración (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Puede usar métodos de extensión para agregar funcionalidad a un tipo de enumeración

concreto.

Ejemplo
En el ejemplo siguiente, la enumeración Grades representa las posibles calificaciones
con letras que un alumno puede recibir en una clase. Un método de extensión
denominado Passing se agrega al tipo Grades para que cada instancia de ese tipo
"sepa" ahora si representa una calificación de aprobado o no.

C#

using System;

using System.Collections.Generic;
using System.Text;

using System.Linq;

namespace EnumExtension

// Define an extension method in a non-nested static class.

public static class Extensions

public static Grades minPassing = Grades.D;

public static bool Passing(this Grades grade)

return grade >= minPassing;

public enum Grades { F = 0, D=1, C=2, B=3, A=4 };

class Program

static void Main(string[] args)

Grades g1 = Grades.D;
Grades g2 = Grades.F;
Console.WriteLine("First {0} a passing grade.", g1.Passing() ?
"is" : "is not");

Console.WriteLine("Second {0} a passing grade.", g2.Passing() ?

"is" : "is not");

 Extensions.minPassing = Grades.C;

Console.WriteLine("\r\nRaising the bar!\r\n");

Console.WriteLine("First {0} a passing grade.", g1.Passing() ?

"is" : "is not");

Console.WriteLine("Second {0} a passing grade.", g2.Passing() ?

"is" : "is not");

/* Output:

First is a passing grade.

Second is not a passing grade.

Raising the bar!

First is not a passing grade.

Second is not a passing grade.

*/

Tenga en cuenta que la clase Extensions también contiene una variable estática que se
actualiza dinámicamente y que el valor devuelto del método de extensión refleja el valor
actual de esa variable. Esto demuestra que, en segundo plano, los métodos de extensión
se invocan directamente en la clase estática en donde se definen.

Vea también
Guía de programación de C#
Métodos de extensión
Argumentos opcionales y con nombre
(Guía de programación de C#)
Artículo • 25/02/2023 • Tiempo de lectura: 7 minutos

Los argumentos con nombre permiten especificar un argumento para un parámetro

asociando el argumento a su nombre y no a su posición en la lista de parámetros. Los
argumentos opcionales permiten omitir argumentos para algunos parámetros. Ambas
técnicas se pueden usar con métodos, indexadores, constructores y delegados.

Cuando se usan argumentos opcionales y con nombre, los argumentos se evalúan por
el orden en que aparecen en la lista de argumentos, no en la lista de parámetros.

Los parámetros opcionales y con nombre permiten proporcionar argumentos para los
parámetros seleccionados. Esta funcionalidad facilita enormemente las llamadas a
interfaces COM, como las API de automatización de Microsoft Office.

Argumentos con nombre

Los argumentos con nombre le liberan de hacer coincidir el orden de los argumentos
con el de los parámetros en las listas de parámetros de los métodos llamados. El
argumento de cada parámetro se puede especificar por el nombre del parámetro. Por
ejemplo, se puede llamar a una función que imprime los detalles de un pedido (como
por ejemplo, el nombre de vendedor, el nombre de producto y el número del pedido)
mediante el envío de argumentos por posición, en el orden definido por la función.

C#

PrintOrderDetails("Gift Shop", 31, "Red Mug");

Si no recuerda el orden de los parámetros pero conoce sus nombres, puede enviar los
argumentos en cualquier orden.

C#

PrintOrderDetails(orderNum: 31, productName: "Red Mug", sellerName: "Gift

Shop");

PrintOrderDetails(productName: "Red Mug", sellerName: "Gift Shop", orderNum:

31);

Los argumentos con nombre también mejoran la legibilidad del código al identificar lo
que cada argumento representa. En el método de ejemplo siguiente, sellerName no
puede ser nulo ni un espacio en blanco. Como sellerName y productName son tipos de
cadena, en lugar de enviar argumentos por posición, tiene sentido usar argumentos con
nombre para eliminar la ambigüedad entre ambos y evitar confusiones para aquellos
que lean el código.

Los argumentos con nombre, cuando se usan con argumentos posicionales, son válidos
siempre que

no vayan seguidos de ningún argumento posicional o,

C#

PrintOrderDetails("Gift Shop", 31, productName: "Red Mug");

se usen en la posición correcta. En este ejemplo, el parámetro orderNum está en la

posición correcta pero no se le asigna un nombre de manera explícita.

C#

PrintOrderDetails(sellerName: "Gift Shop", 31, productName: "Red Mug");

Los argumentos posicionales que siguen a los argumentos con nombre desordenados
no son válidos.

C#

// This generates CS1738: Named argument specifications must appear after

all fixed arguments have been specified.

PrintOrderDetails(productName: "Red Mug", 31, "Gift Shop");

Ejemplo
Con este código se implementan los ejemplos de esta sección junto con otros
adicionales.

C#

class NamedExample

static void Main(string[] args)

// The method can be called in the normal way, by using positional

arguments.

PrintOrderDetails("Gift Shop", 31, "Red Mug");

 // Named arguments can be supplied for the parameters in any order.

PrintOrderDetails(orderNum: 31, productName: "Red Mug", sellerName:

"Gift Shop");

PrintOrderDetails(productName: "Red Mug", sellerName: "Gift Shop",

orderNum: 31);

// Named arguments mixed with positional arguments are valid

// as long as they are used in their correct position.

PrintOrderDetails("Gift Shop", 31, productName: "Red Mug");

PrintOrderDetails(sellerName: "Gift Shop", 31, productName: "Red

Mug");

PrintOrderDetails("Gift Shop", orderNum: 31, "Red Mug");

// However, mixed arguments are invalid if used out-of-order.

// The following statements will cause a compiler error.

// PrintOrderDetails(productName: "Red Mug", 31, "Gift Shop");

// PrintOrderDetails(31, sellerName: "Gift Shop", "Red Mug");

// PrintOrderDetails(31, "Red Mug", sellerName: "Gift Shop");

static void PrintOrderDetails(string sellerName, int orderNum, string

productName)

if (string.IsNullOrWhiteSpace(sellerName))

throw new ArgumentException(message: "Seller name cannot be null

or empty.", paramName: nameof(sellerName));

Console.WriteLine($"Seller: {sellerName}, Order #: {orderNum},

Product: {productName}");

Argumentos opcionales
La definición de un método, constructor, indexador o delegado puede especificar que
sus parámetros son necesarios u opcionales. Todas las llamadas deben proporcionar
argumentos para todos los parámetros necesarios, pero pueden omitir los argumentos
para los parámetros opcionales.

Cada parámetro opcional tiene un valor predeterminado como parte de su definición. Si

no se envía ningún argumento para ese parámetro, se usa el valor predeterminado. Un
valor predeterminado debe ser uno de los siguientes tipos de expresiones:

una expresión constante;

una expresión con el formato new ValType() , donde ValType es un tipo de valor,
como enum o struct;
una expresión con el formato default(ValType), donde ValType es un tipo de valor.
Los parámetros opcionales se definen al final de la lista de parámetros después de los
parámetros necesarios. Si el autor de la llamada proporciona un argumento para algún
parámetro de una sucesión de parámetros opcionales, debe proporcionar argumentos
para todos los parámetros opcionales anteriores. No se admiten espacios separados por
comas en la lista de argumentos. Por ejemplo, en el código siguiente, el método de
instancia ExampleMethod se define con un parámetro necesario y dos opcionales.

C#

public void ExampleMethod(int required, string optionalstr = "default

string",

int optionalint = 10)

La llamada siguiente a ExampleMethod genera un error del compilador, porque se

proporciona un argumento para el tercer parámetro pero no para el segundo.

C#

//anExample.ExampleMethod(3, ,4);

Pero si conoce el nombre del tercer parámetro, puede usar un argumento con nombre
para realizar la tarea.

C#

anExample.ExampleMethod(3, optionalint: 4);

En IntelliSense los corchetes se usan para indicar parámetros opcionales, como se

muestra en la ilustración siguiente:

７ Nota

También puede declarar parámetros opcionales con la clase OptionalAttribute de

.NET. Los parámetros OptionalAttribute no requieren un valor predeterminado.

Ejemplo
En el ejemplo siguiente, el constructor de ExampleClass tiene un solo parámetro, que es
opcional. El método de instancia ExampleMethod tiene un parámetro necesario, required ,
y dos parámetros opcionales, optionalstr y optionalint . El código de Main muestra las
distintas formas en que se pueden invocar el constructor y el método.

C#

namespace OptionalNamespace

class OptionalExample

static void Main(string[] args)

// Instance anExample does not send an argument for the

constructor's

// optional parameter.

ExampleClass anExample = new ExampleClass();

anExample.ExampleMethod(1, "One", 1);

anExample.ExampleMethod(2, "Two");

anExample.ExampleMethod(3);

// Instance anotherExample sends an argument for the

constructor's

// optional parameter.

ExampleClass anotherExample = new ExampleClass("Provided name");

anotherExample.ExampleMethod(1, "One", 1);

anotherExample.ExampleMethod(2, "Two");

anotherExample.ExampleMethod(3);

// The following statements produce compiler errors.

// An argument must be supplied for the first parameter, and it

// must be an integer.

//anExample.ExampleMethod("One", 1);

//anExample.ExampleMethod();

// You cannot leave a gap in the provided arguments.

//anExample.ExampleMethod(3, ,4);

//anExample.ExampleMethod(3, 4);

// You can use a named parameter to make the previous

// statement work.

anExample.ExampleMethod(3, optionalint: 4);

class ExampleClass

private string _name;

// Because the parameter for the constructor, name, has a default

// value assigned to it, it is optional.

public ExampleClass(string name = "Default name")

_name = name;

// The first parameter, required, has no default value assigned

// to it. Therefore, it is not optional. Both optionalstr and

// optionalint have default values assigned to them. They are

optional.

public void ExampleMethod(int required, string optionalstr =

"default string",

int optionalint = 10)

Console.WriteLine(

$"{_name}: {required}, {optionalstr}, and {optionalint}.");

// The output from this example is the following:

// Default name: 1, One, and 1.

// Default name: 2, Two, and 10.

// Default name: 3, default string, and 10.

// Provided name: 1, One, and 1.

// Provided name: 2, Two, and 10.

// Provided name: 3, default string, and 10.

// Default name: 3, default string, and 4.

En el código anterior se muestran varios ejemplos en los que los parámetros opcionales
no se aplican correctamente. En primer lugar, se muestra que se debe proporcionar un
argumento para el primer parámetro, que es obligatorio.

Interfaces COM
Los argumentos opcionales y con nombre, además de compatibilidad con objetos
dinámicos, mejoran considerablemente la interoperabilidad con las API de COM, como
las API de automatización de Office.

Por ejemplo, el método AutoFormat de la interfaz Range de Microsoft Office Excel tiene
siete parámetros, todos ellos opcionales. Estos parámetros se muestran en la ilustración
siguiente:

Pero la llamada a AutoFormat se puede simplificar considerablemente mediante

argumentos opcionales y con nombre. Los parámetros opcionales y con nombre
permiten omitir el argumento de un parámetro opcional si no se quiere cambiar el valor
predeterminado del parámetro. En la siguiente llamada, solo se especifica un valor para
uno de los siete parámetros.

C#

var excelApp = new Microsoft.Office.Interop.Excel.Application();

excelApp.Workbooks.Add();

excelApp.Visible = true;

var myFormat =

Microsoft.Office.Interop.Excel.XlRangeAutoFormat.xlRangeAutoFormatAccounting
1;

excelApp.Range["A1", "B4"].AutoFormat( Format: myFormat );

Para obtener más información y ejemplos, vea Procedimiento para usar argumentos
opcionales y con nombre en la programación de Office (Guía de programación de C#) y
Procedimiento para tener acceso a objetos de interoperabilidad de Office mediante las
características de Visual C# (Guía de programación de C#).

Resolución de sobrecarga
El uso de argumentos opcionales y con nombre afecta a la resolución de sobrecarga de
las maneras siguientes:

Un método, indexador o constructor es un candidato para la ejecución si cada uno

de sus parámetros es opcional o corresponde, por nombre o por posición, a un
solo argumento de la instrucción de llamada y el argumento se puede convertir al
tipo del parámetro.
Si se encuentra más de un candidato, se aplican las reglas de resolución de
sobrecarga de las conversiones preferidas a los argumentos que se especifican
explícitamente. Los argumentos omitidos en parámetros opcionales se ignoran.
Si dos candidatos se consideran igualmente correctos, la preferencia pasa a un
candidato que no tenga parámetros opcionales cuyos argumentos se hayan
omitido en la llamada. Generalmente, la resolución de sobrecarga prefiere aquellos
candidatos que tengan menos parámetros.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Uso de argumentos opcionales y con
nombre en la programación de Office
Artículo • 09/03/2023 • Tiempo de lectura: 5 minutos

Los argumentos con nombre y los argumentos opcionales mejoran la comodidad, la

flexibilidad y la legibilidad en la programación de C#. Además, estas características
facilitan enormemente el acceso a interfaces COM, como las API de automatización de
Microsoft Office.

） Importante

VSTO se basa en .NET Framework. Los complementos COM también se pueden

escribir con .NET Framework. No se pueden crear complementos de Office con
.NET Core y .NET 5 o versiones posteriores, las últimas versiones de .NET. Esto se
debe a que .NET Core/.NET 5 o versiones posteriores no pueden funcionar junto
con .NET Framework en el mismo proceso, y se pueden provocar errores de carga
de complementos. Puede seguir usando .NET Framework a fin de escribir
complementos VSTO y COM para Office. Microsoft no actualizará VSTO ni la
plataforma de complementos COM para usar .NET Core, o .NET 5 o versiones
posteriores. Puede utilizar .NET Core y .NET 5 o versiones posteriores, incluido
ASP.NET Core, para crear el lado servidor de complementos web de Office.

En el ejemplo siguiente, el método ConvertToTable tiene 16 parámetros que representan

las características de una tabla, como el número de columnas y filas, el formato, los
bordes, las fuentes y los colores. Los 16 parámetros son opcionales, ya que la mayoría
de las veces no interesa especificar valores concretos para todos ellos. Sin embargo, sin
argumentos con nombre ni opcionales, debe proporcionar un valor o un valor de
marcador de posición. Con los argumentos opcionales y con nombre, puede especificar
valores solo para los parámetros necesarios para el proyecto.

Debe tener Microsoft Office Word instalado en el equipo para completar estos
procedimientos.

７ Nota

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos

de los elementos de la interfaz de usuario de Visual Studio en las siguientes
instrucciones. La edición de Visual Studio que se tenga y la configuración que se
 utilice determinan estos elementos. Para obtener más información, vea
Personalizar el IDE.

Creación de una nueva aplicación de consola

Inicie Visual Studio. En el menú Archivo , seleccione Nuevoy haga clic en Proyecto. En el
panel Categorías de plantillas, expanda C# y, a continuación, seleccione Windows. En la
parte superior del panel Plantillas, asegúrese de que .NET Framework 4 aparece en el
cuadro Plataforma de destino. En el panel Plantillas, seleccione Aplicación de consola.
Escriba un nombre para el proyecto en el campo Nombre. Seleccione Aceptar. El
proyecto nuevo aparece en el Explorador de soluciones.

Agregar una referencia

En el Explorador de soluciones, haga clic con el botón derecho en el nombre del
proyecto y luego seleccione Agregar referencia. Aparecerá el cuadro de diálogo
Agregar referencia. En la página .NET, seleccione Microsoft.Office.Interop.Word en la
lista Nombre de componente. Seleccione Aceptar.

Agregar las directivas using necesarias

En el Explorador de soluciones, haga clic con el botón derecho en el archivo Program.cs
y luego seleccione Ver código. Agregue las directivas using siguientes a la parte
superior del archivo de código:

C#

using Word = Microsoft.Office.Interop.Word;

Mostrar texto en un documento de Word

En la clase Program en Program.cs, agregue el método siguiente para crear una
aplicación de Word y un documento de Word. El método Add tiene cuatro parámetros
opcionales. En este ejemplo se usan los valores predeterminados. Por lo tanto, no se
necesitan argumentos en la instrucción de llamada.

C#
 static void DisplayInWord()

var wordApp = new Word.Application();

wordApp.Visible = true;

// docs is a collection of all the Document objects currently

// open in Word.

Word.Documents docs = wordApp.Documents;

// Add a document to the collection and name it doc.

Word.Document doc = docs.Add();

Agregue el código siguiente al final del método para definir dónde se muestra texto en
el documento y qué texto se muestra:

C#

// Define a range, a contiguous area in the document, by specifying

// a starting and ending character position. Currently, the document

// is empty.

Word.Range range = doc.Range(0, 0);

// Use the InsertAfter method to insert a string at the end of the

// current range.

range.InsertAfter("Testing, testing, testing. . .");

Ejecución de la aplicación
Agregue la instrucción siguiente a Principal:

C#

DisplayInWord();

Presione CTRL + F5 para ejecutar el proyecto. Aparecerá un documento de Word con el

texto especificado.

Cambiar el texto a una tabla

Use el método ConvertToTable para incluir el texto en una tabla. El método tiene
16 parámetros opcionales. IntelliSense coloca los parámetros opcionales entre
corchetes, tal como se muestra en la ilustración siguiente.
Los argumentos opcionales y con nombre permiten especificar valores solo para los
parámetros que quiere cambiar. Agregue el código siguiente al final del método
DisplayInWord para crear una tabla. El argumento especifica que las comas de la cadena

de texto de range separan las celdas de la tabla.

C#

// Convert to a simple table. The table will have a single row with

// three columns.

range.ConvertToTable(Separator: ",");

Presione CTRL + F5 para ejecutar el proyecto.

Experimentar con otros parámetros

Cambie la tabla de modo que tenga una columna y tres filas, reemplace la última línea
de DisplayInWord por la instrucción siguiente y, a continuación, escriba CTRL + F5 .

C#

range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1);

Para especificar un formato predefinido para la tabla, reemplace la última línea de

DisplayInWord por la instrucción siguiente y después escriba CTRL + F5 . El formato

puede ser cualquiera de las constantes WdTableFormat.

C#

range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1,

Format: Word.WdTableFormat.wdTableFormatElegant);

Ejemplo
En el código siguiente se incluye el ejemplo completo:
C#

using System;

using Word = Microsoft.Office.Interop.Word;

namespace OfficeHowTo

class WordProgram

static void Main(string[] args)

DisplayInWord();

static void DisplayInWord()

var wordApp = new Word.Application();

wordApp.Visible = true;

// docs is a collection of all the Document objects currently

// open in Word.

Word.Documents docs = wordApp.Documents;

// Add a document to the collection and name it doc.

Word.Document doc = docs.Add();

// Define a range, a contiguous area in the document, by

specifying

// a starting and ending character position. Currently, the

document

// is empty.

Word.Range range = doc.Range(0, 0);

// Use the InsertAfter method to insert a string at the end of

the

// current range.

range.InsertAfter("Testing, testing, testing. . .");

// You can comment out any or all of the following statements to

// see the effect of each one in the Word document.

// Next, use the ConvertToTable method to put the text into a

table.

// The method has 16 optional parameters. You only have to

specify

// values for those you want to change.

// Convert to a simple table. The table will have a single row

with

// three columns.

range.ConvertToTable(Separator: ",");

// Change to a single column with three rows..

range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns:

1);

 // Format the table.

range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns:

1,

Format: Word.WdTableFormat.wdTableFormatElegant);

Constructores (guía de programación de

C#)
Artículo • 31/01/2023 • Tiempo de lectura: 3 minutos

Cada vez que se crea una instancia de una clase o un struct , se llama a su constructor.
Una clase o struct puede tener varios constructores que toman argumentos diferentes.
Los constructores permiten al programador establecer valores predeterminados, limitar
la creación de instancias y escribir código flexible y fácil de leer. Para obtener más
información y ejemplos, vea Constructores de instancias y Uso de constructores.

Hay varias acciones que forman parte de la inicialización de una nueva instancia. Estas
acciones tienen lugar en el orden siguiente:

1. Los campos de instancia se establecen en 0. Normalmente, esto lo hace el tiempo

de ejecución.
2. Los inicializadores de campo se ejecutan. Inicializadores de campo en la ejecución
de tipo más derivado.
3. Se ejecutan inicializadores de campo de tipo base. Inicializadores de campo que
comienzan con la base directa a través de cada tipo base a System.Object.
4. Los constructores de instancia base se ejecutan. Cualquier constructor de instancia,
empezando por Object.Object a través de cada clase base a la clase base directa.
5. El constructor de instancia se ejecuta. El constructor de instancia para el tipo se
ejecuta.
6. Se ejecutan inicializadores de objeto. Si la expresión incluye inicializadores de
objeto, se ejecutan después de que se ejecute el constructor de la instancia. Los
inicializadores de objeto se ejecutan en el orden textual.

Las acciones anteriores tienen lugar cuando se inicializa una nueva instancia. Si se
establece una nueva instancia de en struct su default valor, todos los campos de
instancia se establecen en 0.

Si el constructor estático no se ha ejecutado, el constructor estático se ejecuta antes de

que se realice alguna de las acciones del constructor de instancia.

Sintaxis del constructor

Un constructor es un método cuyo nombre es igual que el nombre de su tipo. Su firma
del método incluye solo un modificador de acceso opcional, el nombre del método y su
lista de parámetros; no incluye un tipo de valor devuelto. En el ejemplo siguiente se
muestra el constructor de una clase denominada Person .
 C#

public class Person

private string last;

private string first;

public Person(string lastName, string firstName)

last = lastName;

first = firstName;

// Remaining implementation of Person class.

Si un constructor puede implementarse como una instrucción única, puede usar una
definición del cuerpo de expresión. En el ejemplo siguiente se define una clase Location
cuyo constructor tiene un único parámetro de cadena denominado name. La definición
del cuerpo de expresión asigna el argumento al campo locationName .

C#

public class Location

private string locationName;

public Location(string name) => Name = name;

public string Name

get => locationName;

set => locationName = value;

Constructores estáticos
En los ejemplos anteriores se han mostrado constructores de instancia, que crean un
objeto nuevo. Una clase o struct también puede tener un constructor estático, que
inicializa los miembros estáticos del tipo. Los constructores estáticos no tienen
parámetros. Si no proporciona un constructor estático para inicializar los campos
estáticos, el compilador de C# inicializa los campos estáticos en su valor
predeterminado, tal como se muestra en el artículo Valores predeterminados de los
tipos de C#.
En el ejemplo siguiente se usa un constructor estático para inicializar un campo estático.

C#

public class Adult : Person

private static int minimumAge;

public Adult(string lastName, string firstName) : base(lastName,

firstName)

{ }

static Adult()

minimumAge = 18;

// Remaining implementation of Adult class.

También puede definir un constructor estático con una definición de cuerpo de

expresión, como se muestra en el ejemplo siguiente.

C#

public class Child : Person

private static int maximumAge;

public Child(string lastName, string firstName) : base(lastName,

firstName)

{ }

static Child() => maximumAge = 18;

// Remaining implementation of Child class.

Para obtener más información y ejemplos, vea Constructores estáticos.

En esta sección
Utilizar constructores

Constructores de instancias

Constructores privados

Constructores estáticos
Escritura de un constructor de copia

Vea también
Guía de programación de C#
El sistema de tipos de C#
Finalizadores
static
Why Do Initializers Run In The Opposite Order As Constructors? Part One (¿Por qué
los inicializadores se ejecutan en orden contrario a los constructores? Parte uno)
Utilizar constructores (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Cuando se crea una instancia de una class o un struct, se llama a su constructor. Los
constructores tienen el mismo nombre que la class o el struct y suelen inicializar los
miembros de datos del nuevo objeto.

En el ejemplo siguiente, una clase denominada Taxi se define mediante un constructor

simple. Luego, se crea una instancia de la clase con el operador new. El constructor Taxi
se invoca con el operador new inmediatamente después de asignar memoria para el
nuevo objeto.

C#

public class Taxi

public bool IsInitialized;

public Taxi()

IsInitialized = true;

class TestTaxi

static void Main()

Taxi t = new Taxi();

Console.WriteLine(t.IsInitialized);

Un constructor que no toma ningún parámetro se denomina constructor sin parámetros.

Los constructores sin parámetros se invocan cada vez que se crea una instancia de un
objeto mediante el operador new y no se especifica ningún argumento en new . Para
obtener más información, vea Instance Constructors (Constructores de instancias [Guía
de programación de C#]).

A menos que la clase sea static, las clases sin constructores tienen un constructor
público sin parámetros por el compilador de C# con el fin de habilitar la creación de
instancias de clase. Para más información, vea Clases estáticas y sus miembros.
Puede impedir que se cree una instancia de una clase convirtiendo el constructor en
privado, de la manera siguiente:

C#

class NLog

// Private Constructor:

private NLog() { }

public static double e = Math.E; //2.71828...

Para obtener más información, vea Private Constructors (Constructores privados [Guía
de programación de C#]).

Los constructores de tipos struct son similares a los constructores de clases, pero los
structs no pueden contener un constructor sin parámetros explícito porque el
compilador proporciona uno automáticamente. Este constructor inicializa cada campo
del struct en los valores predeterminados. Pero este constructor sin parámetros solo se
invoca si las instancias de struct se crean con new . Por ejemplo, este código usa el
constructor sin parámetros para Int32, por lo que se tiene la certeza de que el entero se
inicializa:

C#

int i = new int();

Console.WriteLine(i);

７ Nota

A partir de C# 10, un tipo de estructura puede contener un constructor sin

parámetros explícito. Para más información, consulte la sección Inicialización de
estructuras y valores predeterminados del artículo Tipos de estructuras.

Sin embargo, el siguiente código genera un error del compilador porque no usa new y
porque intenta usar un objeto que no se ha inicializado:

C#

int i;

Console.WriteLine(i);

También puede inicializar o asignar los objetos basados en structs (incluidos todos los
tipos numéricos integrados) y luego usarlos como en el ejemplo siguiente:

C#

int a = 44; // Initialize the value type...

int b;

b = 33; // Or assign it before using it.

Console.WriteLine("{0}, {1}", a, b);

Así que no es necesario llamar al constructor sin parámetros para un tipo de valor.

Tanto las clases como los structs pueden definir constructores que toman parámetros.
Los constructores que toman parámetros deben llamarse mediante una instrucción new
o base. Las clases y structs también pueden definir varios constructores y no es
necesario definir un constructor sin parámetros. Por ejemplo:

C#

public class Employee

public int Salary;

public Employee() { }

public Employee(int annualSalary)

Salary = annualSalary;

public Employee(int weeklySalary, int numberOfWeeks)

Salary = weeklySalary * numberOfWeeks;

Esta clase se puede crear mediante cualquiera de las siguientes instrucciones:

C#

Employee e1 = new Employee(30000);

Employee e2 = new Employee(500, 52);

Un constructor puede usar la palabra clave base para llamar al constructor de una clase
base. Por ejemplo:

C#
 public class Manager : Employee

public Manager(int annualSalary)

: base(annualSalary)

//Add further instructions here.

En este ejemplo, se llama al constructor de la clase base antes de ejecutar el bloque del
constructor. La palabra clave base puede usarse con o sin parámetros. Los parámetros
del constructor se pueden usar como parámetros en base o como parte de una
expresión. Para obtener más información, vea base.

En una clase derivada, si un constructor de clase base no se llama explícitamente con la

palabra clave base , se llama implícitamente al constructor sin parámetros, si hay alguno.
Esto significa que las siguientes declaraciones del constructor son en efecto iguales:

C#

public Manager(int initialData)

//Add further instructions here.

C#

public Manager(int initialData)

: base()

//Add further instructions here.

Si una clase base no proporciona un constructor sin parámetros, la clase derivada debe
realizar una llamada explícita a un constructor base mediante base .

Un constructor puede invocar otro constructor en el mismo objeto mediante la palabra

clave this. Igual que base , this puede usarse con o sin parámetros. Además, los
parámetros del constructor están disponibles como parámetros en this o como parte
de una expresión. Por ejemplo, el segundo constructor del ejemplo anterior se puede
reescribir con this :

C#
 public Employee(int weeklySalary, int numberOfWeeks)

: this(weeklySalary * numberOfWeeks)

El uso de la palabra clave this en el ejemplo anterior llama a este constructor:

C#

public Employee(int annualSalary)

Salary = annualSalary;

Los constructores se pueden marcar como public, private, protected, internal, protected
internal o private protected. Estos modificadores de acceso definen cómo los usuarios
de la clase pueden construir la clase. Para obtener más información, consulte
Modificadores de acceso.

Un constructor puede declararse estático mediante la palabra clave static. Los

constructores estáticos se llaman automáticamente, inmediatamente antes de acceder a
los campos estáticos y, por lo general, se usan para inicializar miembros de clase
estática. Para obtener más información, vea Static Constructors (Constructores estáticos
[Guía de programación de C#]).

Especificación del lenguaje C#

Para obtener más información, vea las secciones Constructores de instancia y
Constructores estáticos de la Especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Guía de programación de C#
El sistema de tipos de C#
Constructores
Finalizadores
Constructores de instancias (guía de
programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

Un constructor de instancia se declara para especificar el código que se ejecuta al crear

una instancia de un tipo con la expresión new. Para inicializar una clase estática, o
variables estáticas en una clase no estática, puede definir un constructor estático.

Como se muestra en el ejemplo siguiente, puede declarar varios constructores de

instancia en un tipo:

C#

class Coords

public Coords()

: this(0, 0)

{ }

public Coords(int x, int y)

X = x;

Y = y;

public int X { get; set; }

public int Y { get; set; }

public override string ToString() => $"({X},{Y})";

class Example

static void Main()

var p1 = new Coords();

Console.WriteLine($"Coords #1 at {p1}");

// Output: Coords #1 at (0,0)

var p2 = new Coords(5, 3);

Console.WriteLine($"Coords #2 at {p2}");

// Output: Coords #2 at (5,3)

En el ejemplo anterior, el primer constructor, sin parámetros, llama al segundo

constructor con los dos argumentos igual a 0 . Para hacerlo, use la palabra clave this .
Al declarar un constructor de instancia en una clase derivada, puede llamar a un
constructor de una clase base. Para ello, use la palabra clave base , como se muestra en
el ejemplo siguiente:

C#

abstract class Shape

public const double pi = Math.PI;

protected double x, y;

public Shape(double x, double y)

this.x = x;

this.y = y;

public abstract double Area();

class Circle : Shape

public Circle(double radius)

: base(radius, 0)

{ }

public override double Area() => pi * x * x;

class Cylinder : Circle

{

public Cylinder(double radius, double height)

: base(radius)

y = height;

public override double Area() => (2 * base.Area()) + (2 * pi * x * y);

class Example

static void Main()

double radius = 2.5;

double height = 3.0;

var ring = new Circle(radius);

Console.WriteLine($"Area of the circle = {ring.Area():F2}");

// Output: Area of the circle = 19.63

var tube = new Cylinder(radius, height);

Console.WriteLine($"Area of the cylinder = {tube.Area():F2}");

 // Output: Area of the cylinder = 86.39

Constructores sin parámetros

Si una clase no tiene constructores de instancia explícitos, C# proporciona un
constructor sin parámetros que puede usar para crear instancias de una instancia de esa
clase, como se muestra en el ejemplo siguiente:

C#

public class Person

public int age;

public string name = "unknown";

class Example

static void Main()

var person = new Person();

Console.WriteLine($"Name: {person.name}, Age: {person.age}");

// Output: Name: unknown, Age: 0

Ese constructor inicializa los campos de instancia y las propiedades según los
inicializadores correspondientes. Si un campo o una propiedad no tiene ningún
inicializador, su valor se establece en el valor predeterminado del tipo de la propiedad o
del campo. Si declara al menos un constructor de instancia en una clase, C# no
proporciona un constructor sin parámetros.

Un tipo de estructura siempre proporciona un constructor sin parámetros, como se

muestra a continuación:

En C# 9.0 y versiones anteriores, es un constructor sin parámetros implícito que

genera el valor predeterminado de un tipo.
En C# 10 y versiones posteriores, es un constructor sin parámetros implícito que
genera el valor predeterminado de un tipo, o bien un constructor sin parámetros
declarado de forma explícita. Para más información, consulte la sección
Inicialización de estructuras y valores predeterminados del artículo Tipos de
estructuras.
Vea también
Guía de programación de C#
Clases, estructuras y registros
Constructores
Finalizadores
base
this
Constructores privados (Guía de
programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

Un constructor privado es un constructor de instancia especial. Se usa generalmente en

clases que contienen solo miembros estáticos. Si una clase tiene uno o más
constructores privados y ningún constructor público, el resto de clases (excepto las
anidadas) no podrán crear instancias de esta clase. Por ejemplo:

C#

class NLog

// Private Constructor:

private NLog() { }

public static double e = Math.E; //2.71828...

La declaración de un constructor vacío evita la generación automática de un constructor

sin parámetros. Observe que si no usa un modificador de acceso en el constructor, este
será privado de manera predeterminada. En cambio, normalmente se usa el modificador
private de manera explícita para aclarar que no es posible crear una instancia de la clase.

Los constructores privados se usan para evitar la creación de instancias de una clase
cuando no hay campos o métodos de instancia, por ejemplo, la clase Math, o cuando se
llama a un método para obtener una instancia de una clase. Si todos los métodos de la
clase son estáticos, considere convertir la clase completa en estática. Para obtener más
información, vea Clases estáticas y sus miembros.

Ejemplo
El siguiente es un ejemplo de clase que usa un constructor privado.

C#

public class Counter

private Counter() { }

public static int currentCount;

public static int IncrementCount()

return ++currentCount;

class TestCounter

static void Main()

// If you uncomment the following statement, it will generate

// an error because the constructor is inaccessible:

// Counter aCounter = new Counter(); // Error

Counter.currentCount = 100;

Counter.IncrementCount();
Console.WriteLine("New count: {0}", Counter.currentCount);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

// Output: New count: 101

Observe que si quita el comentario de la siguiente instrucción del ejemplo, se producirá

un error porque el constructor es inaccesible debido a su nivel de protección:

C#

// Counter aCounter = new Counter(); // Error

Vea también
Guía de programación de C#
El sistema de tipos de C#
Constructores
Finalizadores
private
public
Constructores estáticos (Guía de
programación de C#)
Artículo • 31/01/2023 • Tiempo de lectura: 5 minutos

Un constructor estático se usa para inicializar cualquier dato estático o realizar una
acción determinada que solo debe realizarse una vez. Es llamado automáticamente
antes de crear la primera instancia o de hacer referencia a cualquier miembro estático.
Se llamará a un constructor estático como máximo una vez.

C#

class SimpleClass

// Static variable that must be initialized at run time.

static readonly long baseline;

// Static constructor is called at most one time, before any

// instance constructor is invoked or member is accessed.

static SimpleClass()

baseline = DateTime.Now.Ticks;

Hay varias acciones que forman parte de la inicialización estática. Estas acciones tienen
lugar en el orden siguiente:

1. Los campos estáticos se establecen en 0. Normalmente, esto lo hace el tiempo de

ejecución.
2. Se ejecutan inicializadores de campo estáticos. Inicializadores de campo estáticos en
la ejecución de tipo más derivado.
3. Se ejecutan inicializadores de campo estático de tipo base. Inicializadores de campo
estáticos a partir de la base directa a través de cada tipo base a System.Object.
4. Se ejecutan constructores estáticos base. Cualquier constructor estático, empezando
por Object.Object a través de cada clase base a la clase base directa.
5. El constructor estático se ejecuta. El constructor estático para el tipo se ejecuta.

Comentarios
Los constructores estáticos tienen las propiedades siguientes:

Un constructor estático no permite modificadores de acceso ni tiene parámetros.

Una clase o struct solo puede tener un constructor estático.
 Los constructores estáticos no se pueden heredar ni sobrecargar.
No se puede llamar a un constructor estático directamente y solo está pensado
para que Common Language Runtime (CLR) lo llame. Se invoca automáticamente.
El usuario no puede controlar cuándo se ejecuta el constructor estático en el
programa.
A un constructor estático se le llama automáticamente. Inicializa la clase antes de
crear la primera instancia o de hacer referencia a cualquier miembro estático
declarado en esa clase (no sus clases base). Un constructor estático se ejecuta
antes que un constructor de instancia. Si los inicializadores de variable del campo
estático están presentes en la clase o el constructor estático, se ejecutarán en el
orden textual en el que aparecen en la declaración. Los inicializadores se ejecutan
inmediatamente antes de la ejecución del constructor estático.
Si no proporciona un constructor estático para inicializar los campos estáticos,
todos los campos estáticos se inicializan en su valor predeterminado como se
muestra en Valores predeterminados de los tipos de C#.
Si un constructor estático inicia una excepción, el motor en tiempo de ejecución no
lo invoca una segunda vez y el tipo seguirá sin inicializar durante el período de
duración del dominio de aplicación. Normalmente, se inicia una excepción
TypeInitializationException cuando un constructor estático no puede crear una
instancia de un tipo o para una excepción no controlada que se produce dentro de
un constructor estático. En el caso de los constructores estáticos no definidos de
forma explícita en el código fuente, la solución de problemas puede requerir la
inspección del código de lenguaje intermedio (IL).
La presencia de un constructor estático evita la adición del atributo de tipo
BeforeFieldInit. Esto limita la optimización en tiempo de ejecución.
Un campo declarado como static readonly solo se puede asignar como parte de
su declaración o en un constructor estático. Si no se necesita un constructor
estático explícito, inicialice campos estáticos en la declaración, en lugar de a través
de un constructor estático para una mejor optimización en tiempo de ejecución.
El entorno de ejecución llama a un constructor estático no más de una vez en un
dominio de aplicación única. Esa llamada se realiza en una región bloqueada en
función del tipo específico de la clase. No se necesitan mecanismos de bloqueo
adicionales en el cuerpo de un constructor estático. Para evitar el riesgo de
interbloqueos, no bloquee el subproceso actual en constructores estáticos e
inicializadores. Por ejemplo, no espere por tareas, subprocesos, identificadores de
espera o eventos, no adquiera bloqueos y no ejecute operaciones en paralelo de
bloqueo, como bucles paralelos, Parallel.Invoke y consultas de Parallel LINQ.

７ Nota
 Aunque no es directamente accesible, la presencia de un constructor estático
explícito debe documentarse para ayudar con la solución de problemas de
excepciones de inicialización.

Uso
Los constructores estáticos se usan normalmente cuando la clase hace uso de un
archivo de registro y el constructor escribe entradas en dicho archivo.
Los constructores estáticos también son útiles al crear clases contenedoras para
código no administrado, cuando el constructor puede llamar al método
LoadLibrary .

Los constructores estáticos también son un lugar adecuado para aplicar

comprobaciones en tiempo de ejecución en el parámetro de tipo que no se puede
comprobar en tiempo de compilación a través de restricciones de parámetro de
tipo.

Ejemplo
En este ejemplo, la clase Bus tiene un constructor estático. Cuando se crea la primera
instancia de Bus ( bus1 ), se invoca el constructor estático para inicializar la clase. En el
resultado del ejemplo, se comprueba que el constructor estático se ejecuta solo una vez,
incluso si se crean dos instancias de Bus , y que se ejecuta antes de que se ejecute el
constructor de instancia.

C#

public class Bus

// Static variable used by all Bus instances.

// Represents the time the first bus of the day starts its route.

protected static readonly DateTime globalStartTime;

// Property for the number of each bus.

protected int RouteNumber { get; set; }

// Static constructor to initialize the static variable.

// It is invoked before the first instance constructor is run.

static Bus()

globalStartTime = DateTime.Now;

// The following statement produces the first line of output,

// and the line occurs only once.

Console.WriteLine("Static constructor sets global start time to

{0}",

globalStartTime.ToLongTimeString());

// Instance constructor.

public Bus(int routeNum)

RouteNumber = routeNum;

Console.WriteLine("Bus #{0} is created.", RouteNumber);

// Instance method.

public void Drive()

TimeSpan elapsedTime = DateTime.Now - globalStartTime;

// For demonstration purposes we treat milliseconds as minutes to

simulate

// actual bus times. Do not do this in your actual bus schedule

program!

Console.WriteLine("{0} is starting its route {1:N2} minutes after

global start time {2}.",

this.RouteNumber,

elapsedTime.Milliseconds,

globalStartTime.ToShortTimeString());

class TestBus

static void Main()

// The creation of this instance activates the static constructor.

Bus bus1 = new Bus(71);

// Create a second bus.

Bus bus2 = new Bus(72);

// Send bus1 on its way.

bus1.Drive();

// Wait for bus2 to warm up.

System.Threading.Thread.Sleep(25);

// Send bus2 on its way.

bus2.Drive();

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Sample output:

Static constructor sets global start time to 3:57:08 PM.

Bus #71 is created.

 Bus #72 is created.

71 is starting its route 6.00 minutes after global start time 3:57 PM.

72 is starting its route 31.00 minutes after global start time 3:57 PM.

*/

Especificación del lenguaje C#

Para obtener más información, consulte la sección sobre constructores estáticos de la
Especificación del lenguaje C#.

Vea también
Guía de programación de C#
El sistema de tipos de C#
Constructores
Clases estáticas y sus miembros
Finalizadores
Instrucciones de diseño de constructores
Advertencia de seguridad - CA2121: Los constructores estáticos deben ser
privados
Inicializadores de módulo
Procedimiento para escribir un
constructor de copia (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los registros de C# proporcionan un constructor de copia para objetos, pero debe

escribir uno para las clases personalmente.

Ejemplo
En el ejemplo siguiente, Person class define un constructor de copias que toma, como
argumento, una instancia de Person . Los valores de las propiedades de los argumentos
se asignan a las propiedades de la nueva instancia de Person . El código contiene un
constructor de copias alternativo que envía las propiedades Name y Age de la instancia
que quiere copiar al constructor de instancia de la clase.

C#

class Person

// Copy constructor.

public Person(Person previousPerson)

Name = previousPerson.Name;

Age = previousPerson.Age;
}

//// Alternate copy constructor calls the instance constructor.

//public Person(Person previousPerson)

// : this(previousPerson.Name, previousPerson.Age)

//{

//}

// Instance constructor.

public Person(string name, int age)

Name = name;

Age = age;

public int Age { get; set; }

public string Name { get; set; }

public string Details()

return Name + " is " + Age.ToString();

class TestPerson

static void Main()

// Create a Person object by using the instance constructor.

Person person1 = new Person("George", 40);

// Create another Person object, copying person1.

Person person2 = new Person(person1);

// Change each person's age.

person1.Age = 39;

person2.Age = 41;

// Change person2's name.

person2.Name = "Charles";

// Show details to verify that the name and age fields are distinct.

Console.WriteLine(person1.Details());

Console.WriteLine(person2.Details());

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

// Output:

// George is 39

// Charles is 41

Vea también
ICloneable
Registros
Guía de programación de C#
El sistema de tipos de C#
Constructores
Finalizadores
Finalizadores (Guía de programación de
C#)
Artículo • 28/11/2022 • Tiempo de lectura: 5 minutos

Los finalizadores (anteriormente conocidos como destructores) se usan para realizar

cualquier limpieza final necesaria cuando el recolector de elementos no utilizados
recopila una instancia de clase. En la mayoría de los casos, puede evitar escribir un
finalizador mediante System.Runtime.InteropServices.SafeHandle o clases derivadas para
encapsular cualquier identificador no administrado.

Comentarios
Los finalizadores no se pueden definir en structs. Solo se usan con clases.
Una clase solo puede tener un finalizador.
Los finalizadores no se pueden heredar ni sobrecargar.
No se puede llamar a los finalizadores. Se invocan automáticamente.
Un finalizador no permite modificadores ni tiene parámetros.

Por ejemplo, el siguiente código muestra una declaración de un finalizador para la clase
Car .

C#

class Car

~Car() // finalizer

// cleanup statements...

Un finalizador también puede implementarse como una definición de cuerpo de

expresión, como se muestra en el ejemplo siguiente.

C#

public class Destroyer

public override string ToString() => GetType().Name;

~Destroyer() => Console.WriteLine($"The {ToString()} finalizer is

executing.");

El finalizador llama implícitamente a Finalize en la clase base del objeto. Por lo tanto,
una llamada a un finalizador se convierte implícitamente al siguiente código:

C#

protected override void Finalize()

try

// Cleanup statements...

finally

base.Finalize();

Este diseño significa que se realizan llamadas al método Finalize de manera recursiva
para todas las instancias de la cadena de herencia, desde la más a la menos derivada.

７ Nota

Los finalizadores vacíos no deben usarse. Cuando una clase contiene un finalizador,
se crea una entrada en la cola Finalize . El recolector de elementos no utilizados
procesa esta cola. Cuando esto sucede, llama a cada finalizador. Los finalizadores
innecesarios, como los vacíos, los que solo llaman al finalizador de clase base o los
que solo llaman a métodos emitidos condicionalmente provocan una pérdida
innecesaria de rendimiento.

El programador no puede controlar cuándo se llama al finalizador; es el recolector de

elementos no utilizados el que decide cuándo hacerlo. El recolector de elementos no
utilizados comprueba si hay objetos que ya no están siendo usados por ninguna
aplicación. Si considera un objeto elegible para su finalización, llama al finalizador (si
existe) y reclama la memoria usada para almacenar el objeto. Es posible forzar la
recolección de elementos no utilizados si se llama a Collect, pero debe evitarse esta
llamada porque puede dar lugar a problemas de rendimiento.

７ Nota

El hecho de que los finalizadores se ejecuten o no como parte de la finalización de

aplicaciones es específico de cada implementación de .NET. Cuando finaliza una
aplicación, .NET Framework hace todo lo posible para llamar a todos los
finalizadores en los objetos cuyos elementos no se han detectado durante la
 recolección de elementos no utilizados, a menos que se haya suprimido esa
limpieza (por ejemplo, mediante una llamada al método de biblioteca
GC.SuppressFinalize ). En .NET 5 (incluido .NET Core) y versiones posteriores no se

llama a los finalizadores como parte de la finalización de la aplicación. Para obtener

más información, vea la incidencia de GitHub dotnet/csharpstandard n.º 291 .

Si necesita realizar la limpieza de forma confiable cuando existe una aplicación, registre
un controlador para el evento System.AppDomain.ProcessExit. Ese controlador
garantizaría la llamada a IDisposable.Dispose(), o a IAsyncDisposable.DisposeAsync(),
para todos los objetos que requieren limpieza antes de que la aplicación se cierre. Dado
que no se puede llamar directamente a Finalizar y no se puede garantizar que el
recolector de elementos no utilizados llame a todos los finalizadores antes de salir, debe
usar Dispose o DisposeAsync para asegurarse de que se liberan los recursos.

Uso de finalizadores para liberar recursos

En general, C# no requiere tanta administración de memoria por parte del desarrollador
como los lenguajes que no están diseñados para un runtime con recolección de
elementos no utilizados. Esto es debido a que el recolector de elementos no utilizados
de .NET administra implícitamente la asignación y liberación de memoria para los
objetos. En cambio, cuando la aplicación encapsule recursos no administrados, como
ventanas, archivos y conexiones de red, debería usar finalizadores para liberar dichos
recursos. Cuando el objeto cumple los requisitos para su finalización, el recolector de
elementos no utilizados ejecuta el método Finalize del objeto.

Liberación explícita de recursos

Si la aplicación usa un recurso externo costoso, también es recomendable liberar
explícitamente el recurso antes de que el recolector de elementos no utilizados libere el
objeto. Para liberar el recurso, implemente un método Dispose desde la interfaz
IDisposable que realiza la limpieza necesaria del objeto. Esto puede mejorar
considerablemente el rendimiento de la aplicación. Aun con este control explícito sobre
los recursos, el finalizador se convierte en una salvaguarda para limpiar recursos si se
produce un error en la llamada al método Dispose .

Para obtener más información sobre la limpieza de recursos, vea los siguientes artículos:

Limpieza de recursos no administrados

Implementación de un método Dispose
Implementación de un método DisposeAsync
 using (instrucción)

Ejemplo
En el siguiente ejemplo se crean tres clases que forman una cadena de herencia. La clase
First es la clase base, Second se deriva de First y Third se deriva de Second . Los tres
tienen finalizadores. En Main , se crea una instancia de la clase más derivada. La salida de
este código depende de la implementación de .NET a la que se dirige la aplicación:

.NET Framework: en la salida se muestra que se llama automáticamente a los

finalizadores de las tres clases cuando finaliza la aplicación, en orden, del más
derivado al menos.
NET 5 (incluido .NET Core) o una versión posterior: no hay ninguna salida, porque
esta implementación de .NET no llama a los finalizadores cuando finaliza la
aplicación.

C#

class First

~First()

System.Diagnostics.Trace.WriteLine("First's finalizer is called.");

class Second : First

~Second()

System.Diagnostics.Trace.WriteLine("Second's finalizer is called.");

class Third : Second

~Third()

System.Diagnostics.Trace.WriteLine("Third's finalizer is called.");

/*

Test with code like the following:

Third t = new Third();

t = null;

When objects are finalized, the output would be:

Third's finalizer is called.

 Second's finalizer is called.

First's finalizer is called.

*/

Especificación del lenguaje C#

Para más información, consulte la sección Finalizadores de la especificación del lenguaje
C#.

Consulte también
IDisposable
Guía de programación de C#
Constructores
Recolección de elementos no utilizados
Inicializadores de objeto y de colección
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 10 minutos

C# permite crear instancias de un objeto o colección y realizar asignaciones de

miembros en una sola instrucción.

Inicializadores de objeto
Los inicializadores de objeto permiten asignar valores a cualquier campo o propiedad
accesible de un objeto en el momento de su creación sin tener que invocar un
constructor seguido de líneas de instrucciones de asignación. La sintaxis de inicializador
de objetos permite especificar argumentos para un constructor u omitir los argumentos
(y la sintaxis de paréntesis). En el ejemplo siguiente se muestra cómo usar un
inicializador de objeto con un tipo con nombre, Cat , y cómo invocar el constructor sin
parámetros. Tenga en cuenta el uso de propiedades implementadas automáticamente
en la clase Cat . Para obtener más información, vea Propiedades implementadas
automáticamente.

C#

public class Cat

// Auto-implemented properties.

public int Age { get; set; }

public string Name { get; set; }

public Cat()

public Cat(string name)

this.Name = name;

C#

Cat cat = new Cat { Age = 10, Name = "Fluffy" };

Cat sameCat = new Cat("Fluffy"){ Age = 10 };

La sintaxis de los inicializadores de objeto le permite crear una instancia, y después

asigna el objeto recién creado, con las propiedades asignadas, a la variable de la
asignación.

Los inicializadores de objeto pueden establecer indizadores, además de asignar campos

y propiedades. Tenga en cuenta esta clase básica Matrix :

C#

public class Matrix

private double[,] storage = new double[3, 3];

public double this[int row, int column]

// The embedded array will throw out of range exceptions as

appropriate.

get { return storage[row, column]; }

set { storage[row, column] = value; }

Se podría inicializar la matriz de identidad con el código siguiente:

C#

var identity = new Matrix

[0, 0] = 1.0,

[0, 1] = 0.0,

[0, 2] = 0.0,

[1, 0] = 0.0,

[1, 1] = 1.0,

[1, 2] = 0.0,

[2, 0] = 0.0,

[2, 1] = 0.0,

[2, 2] = 1.0,

};

Puede usarse cualquier indizador accesible que contenga un establecedor accesible

como una de las expresiones de un inicializador de objeto, independientemente del
número o los tipos de argumentos. Los argumentos del índice forman el lado izquierdo
de la asignación, mientras que el valor es el lado derecho de la expresión. Por ejemplo,
todos estos son válidos si IndexersExample tiene los indizadores adecuados:

C#
 var thing = new IndexersExample {

name = "object one",

[1] = '1',

[2] = '4',

[3] = '9',

Size = Math.PI,

['C',4] = "Middle C"

Para que el código anterior se compile, el tipo IndexersExample debe tener los
siguientes miembros:

C#

public string name;

public double Size { set { ... }; }

public char this[int i] { set { ... }; }

public string this[char c, int i] { set { ... }; }

Inicializadores de objeto con tipos anónimos

Aunque los inicializadores de objeto se pueden usar en cualquier contexto, resultan
especialmente útiles en las expresiones de consulta LINQ. Las expresiones de consulta
usan con frecuencia tipos anónimos, que solo se pueden inicializar con un inicializador
de objeto, como se muestra en la siguiente declaración.

C#

var pet = new { Age = 10, Name = "Fluffy" };

Los tipos anónimos permiten a la cláusula select de una expresión de consulta LINQ
transformar objetos de la secuencia original en objetos cuyo valor y forma pueden ser
distintos de los originales. Esto resulta útil si desea almacenar solo una parte de la
información de cada objeto en una secuencia. En el ejemplo siguiente, suponga que un
objeto del producto ( p ) contiene numerosos campos y métodos y que solo le interesa
crear una secuencia de objetos que contenga el nombre del producto y el precio por
unidad.

C#

var productInfos =

from p in products

select new { p.ProductName, p.UnitPrice };

Al ejecutarse esta consulta, la variable productInfos incluirá una secuencia de objetos a

la que se puede tener acceso en una instrucción foreach , como se muestra en este
ejemplo:

C#

foreach(var p in productInfos){...}

Cada objeto del nuevo tipo anónimo tiene dos propiedades públicas que reciben los
mismos nombres que las propiedades o los campos del objeto original. También puede
cambiar el nombre de un campo al crear un tipo anónimo; en el ejemplo siguiente se
cambia el nombre del campo UnitPrice a Price .

C#

select new {p.ProductName, Price = p.UnitPrice};

Inicializadores de colección
Los inicializadores de colección le permiten especificar uno o varios inicializadores de
elemento al inicializar un tipo de colección que implementa IEnumerable y tiene Add
con la firma apropiada como un método de instancia o un método de extensión. Los
inicializadores de elemento pueden ser un valor simple, una expresión o un inicializador
de objeto. Si se usa un inicializador de colección, no es necesario especificar varias
llamadas; el compilador las agrega automáticamente.

En el ejemplo siguiente se muestran dos inicializadores de colección simples:

C#

List<int> digits = new List<int> { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };

List<int> digits2 = new List<int> { 0 + 1, 12 % 3, MakeInt() };

El inicializador de colección siguiente usa inicializadores de objeto para inicializar los

objetos de la clase Cat definida en un ejemplo anterior. Observe que los inicializadores
de objeto individuales se escriben entre llaves y se separan por comas.

C#

List<Cat> cats = new List<Cat>

new Cat{ Name = "Sylvester", Age=8 },

new Cat{ Name = "Whiskers", Age=2 },

 new Cat{ Name = "Sasha", Age=14 }

};

Puede especificar null como elemento de un inicializador de colección si el método Add

de la colección lo permite.

C#

List<Cat> moreCats = new List<Cat>

new Cat{ Name = "Furrytail", Age=5 },

new Cat{ Name = "Peaches", Age=4 },

null

};

Puede especificar elementos indexados si la colección admite indexación de lectura y

escritura.

C#

var numbers = new Dictionary<int, string>

[7] = "seven",

[9] = "nine",

[13] = "thirteen"

};

El ejemplo anterior genera código que llama a Item[TKey] para establecer los valores.
Puede inicializar también diccionarios y otros contenedores asociativos con la sintaxis
siguiente. Tenga en cuenta que en lugar de sintaxis de indizador, con paréntesis y una
asignación, usa un objeto con varios valores:

C#

var moreNumbers = new Dictionary<int, string>

{19, "nineteen" },

{23, "twenty-three" },

{42, "forty-two" }

};

Este ejemplo de inicializador llama a Add(TKey, TValue) para agregar los tres elementos
al diccionario. Estas dos maneras distintas de inicializar colecciones asociativas tienen un
comportamiento ligeramente diferente debido a las llamadas a métodos que genera el
compilador. Ambas variantes funcionan con la clase Dictionary . Es posible que otros
tipos solo admitan una o la otra, en función de su API pública.
Inicializadores de objeto con inicialización de
propiedades de solo lectura de colección
Algunas clases pueden tener propiedades de colección donde la propiedad es de solo
lectura, como la propiedad Cats de CatOwner en el caso siguiente:

C#

public class CatOwner

public IList<Cat> Cats { get; } = new List<Cat>();

No podrá usar la sintaxis del inicializador de colección abordada hasta ahora, ya que no
se puede asignar una nueva lista a la propiedad:

C#

CatOwner owner = new CatOwner

Cats = new List<Cat>

new Cat{ Name = "Sylvester", Age=8 },

new Cat{ Name = "Whiskers", Age=2 },

new Cat{ Name = "Sasha", Age=14 }

};

Sin embargo, se pueden agregar nuevas entradas a Cats mediante la sintaxis de

inicialización omitiendo la creación de lista ( new List<Cat> ), como se muestra a
continuación:

C#

CatOwner owner = new CatOwner

Cats =

new Cat{ Name = "Sylvester", Age=8 },

new Cat{ Name = "Whiskers", Age=2 },

new Cat{ Name = "Sasha", Age=14 }

};

El conjunto de entradas que se van a agregar simplemente aparecen entre llaves. Lo

anterior es idéntico a escribir lo siguiente:
 C#

CatOwner owner = new CatOwner();

owner.Cats.Add(new Cat{ Name = "Sylvester", Age=8 });

owner.Cats.Add(new Cat{ Name = "Whiskers", Age=2 });

owner.Cats.Add(new Cat{ Name = "Sasha", Age=14 });

Ejemplos
En el ejemplo siguiente se combinan los conceptos de inicializadores de objeto y
colección.

C#

public class InitializationSample

public class Cat

// Auto-implemented properties.

public int Age { get; set; }

public string Name { get; set; }

public Cat() { }

public Cat(string name)

Name = name;

public static void Main()

Cat cat = new Cat { Age = 10, Name = "Fluffy" };

Cat sameCat = new Cat("Fluffy"){ Age = 10 };

List<Cat> cats = new List<Cat>

new Cat { Name = "Sylvester", Age = 8 },

new Cat { Name = "Whiskers", Age = 2 },

new Cat { Name = "Sasha", Age = 14 }

};

List<Cat> moreCats = new List<Cat>

new Cat { Name = "Furrytail", Age = 5 },

new Cat { Name = "Peaches", Age = 4 },

null

};

// Display results.

System.Console.WriteLine(cat.Name);

 foreach (Cat c in cats)

System.Console.WriteLine(c.Name);

foreach (Cat c in moreCats)

if (c != null)

System.Console.WriteLine(c.Name);

else

System.Console.WriteLine("List element has null value.");

// Output:

//Fluffy

//Sylvester

//Whiskers

//Sasha

//Furrytail

//Peaches

//List element has null value.

El ejemplo siguiente muestra un objeto que implementa IEnumerable y que contiene un

método Add con varios parámetros. Usa un inicializador de colección con varios
elementos por cada elemento de la lista correspondiente a la firma del método Add .

C#

public class FullExample

class FormattedAddresses : IEnumerable<string>

private List<string> internalList = new List<string>();

public IEnumerator<string> GetEnumerator() =>

internalList.GetEnumerator();

System.Collections.IEnumerator
System.Collections.IEnumerable.GetEnumerator() =>
internalList.GetEnumerator();

public void Add(string firstname, string lastname,

string street, string city,

string state, string zipcode) => internalList.Add(

$@"{firstname} {lastname}

{street}

{city}, {state} {zipcode}"

);

public static void Main()

FormattedAddresses addresses = new FormattedAddresses()

{"John", "Doe", "123 Street", "Topeka", "KS", "00000" },

 {"Jane", "Smith", "456 Street", "Topeka", "KS", "00000" }

};

Console.WriteLine("Address Entries:");

foreach (string addressEntry in addresses)

Console.WriteLine("\r\n" + addressEntry);

/*

* Prints:

Address Entries:

John Doe

123 Street

Topeka, KS 00000

Jane Smith

456 Street

Topeka, KS 00000

*/

Los métodos Add pueden usar la palabra clave params para tomar un número variable
de argumentos, como se muestra en el ejemplo siguiente. En este ejemplo además se
muestra la implementación personalizada de un indizador para inicializar una colección
mediante índices.

C#

public class DictionaryExample

class RudimentaryMultiValuedDictionary<TKey, TValue> :

IEnumerable<KeyValuePair<TKey, List<TValue>>>

private Dictionary<TKey, List<TValue>> internalDictionary = new

Dictionary<TKey, List<TValue>>();

public IEnumerator<KeyValuePair<TKey, List<TValue>>> GetEnumerator()

=> internalDictionary.GetEnumerator();

System.Collections.IEnumerator
System.Collections.IEnumerable.GetEnumerator() =>
internalDictionary.GetEnumerator();

public List<TValue> this[TKey key]

get => internalDictionary[key];

set => Add(key, value);

public void Add(TKey key, params TValue[] values) => Add(key,

(IEnumerable<TValue>)values);

public void Add(TKey key, IEnumerable<TValue> values)

if (!internalDictionary.TryGetValue(key, out List<TValue>

storedValues))

internalDictionary.Add(key, storedValues = new List<TValue>

());

storedValues.AddRange(values);

public static void Main()

RudimentaryMultiValuedDictionary<string, string>
rudimentaryMultiValuedDictionary1
= new RudimentaryMultiValuedDictionary<string, string>()

{"Group1", "Bob", "John", "Mary" },

{"Group2", "Eric", "Emily", "Debbie", "Jesse" }

};

RudimentaryMultiValuedDictionary<string, string>
rudimentaryMultiValuedDictionary2
= new RudimentaryMultiValuedDictionary<string, string>()

["Group1"] = new List<string>() { "Bob", "John", "Mary" },

["Group2"] = new List<string>() { "Eric", "Emily", "Debbie",

"Jesse" }

};

RudimentaryMultiValuedDictionary<string, string>
rudimentaryMultiValuedDictionary3
= new RudimentaryMultiValuedDictionary<string, string>()

{"Group1", new string []{ "Bob", "John", "Mary" } },

{ "Group2", new string[]{ "Eric", "Emily", "Debbie", "Jesse"

} }

};

Console.WriteLine("Using first multi-valued dictionary created with

a collection initializer:");

foreach (KeyValuePair<string, List<string>> group in

rudimentaryMultiValuedDictionary1)

Console.WriteLine($"\r\nMembers of group {group.Key}: ");

foreach (string member in group.Value)

Console.WriteLine(member);

 Console.WriteLine("\r\nUsing second multi-valued dictionary created

with a collection initializer using indexing:");

foreach (KeyValuePair<string, List<string>> group in

rudimentaryMultiValuedDictionary2)

Console.WriteLine($"\r\nMembers of group {group.Key}: ");

foreach (string member in group.Value)

Console.WriteLine(member);

Console.WriteLine("\r\nUsing third multi-valued dictionary created

with a collection initializer using indexing:");

foreach (KeyValuePair<string, List<string>> group in

rudimentaryMultiValuedDictionary3)

Console.WriteLine($"\r\nMembers of group {group.Key}: ");

foreach (string member in group.Value)

Console.WriteLine(member);

/*

* Prints:

Using first multi-valued dictionary created with a collection

initializer:

Members of group Group1:

Bob

John

Mary

Members of group Group2:

Eric

Emily

Debbie

Jesse

Using second multi-valued dictionary created with a collection

initializer using indexing:

Members of group Group1:

Bob

John

Mary

Members of group Group2:

 Eric

Emily

Debbie

Jesse

Using third multi-valued dictionary created with a collection

initializer using indexing:

Members of group Group1:

Bob

John

Mary

Members of group Group2:

Eric

Emily

Debbie

Jesse

*/

Vea también
Uso de inicializadores de objetos (regla de estilo IDE0017)
Uso de inicializadores de colección (regla de estilo IDE0028)
Guía de programación de C#
LINQ en C#
Tipos anónimos
Procedimiento para inicializar objetos
usando un inicializador de objeto (Guía
de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Puede usar inicializadores de objeto para inicializar objetos de tipo de una forma
declarativa sin tener que invocar explícitamente un constructor para el tipo.

En los siguientes ejemplos se muestra cómo usar los inicializadores de objeto con
objetos con nombre. El compilador procesa los inicializadores de objeto primero
obteniendo acceso al constructor de instancia sin parámetros y después procesando las
inicializaciones de miembro. Por lo tanto, si el constructor sin parámetros se declara
como private en la clase, se producirá un error en los inicializadores de objeto que
requieren acceso público.

Debe usar un inicializador de objeto si va a definir un tipo anónimo. Para obtener más
información, vea Procedimiento para devolver subconjuntos de propiedades de
elementos en una consulta.

Ejemplo
En el siguiente ejemplo se muestra cómo inicializar un nuevo tipo StudentName usando
inicializadores de objeto. Este ejemplo establece propiedades en el tipo StudentName :

C#

public class HowToObjectInitializers

public static void Main()

// Declare a StudentName by using the constructor that has two

parameters.

StudentName student1 = new StudentName("Craig", "Playstead");

// Make the same declaration by using an object initializer and

sending

// arguments for the first and last names. The parameterless

constructor is

// invoked in processing this declaration, not the constructor that

has

// two parameters.

StudentName student2 = new StudentName

 FirstName = "Craig",

LastName = "Playstead"

};

// Declare a StudentName by using an object initializer and sending

// an argument for only the ID property. No corresponding

constructor is

// necessary. Only the parameterless constructor is used to process

object

// initializers.

StudentName student3 = new StudentName

ID = 183

};

// Declare a StudentName by using an object initializer and sending

// arguments for all three properties. No corresponding constructor

is

// defined in the class.

StudentName student4 = new StudentName

FirstName = "Craig",

LastName = "Playstead",

ID = 116

};

Console.WriteLine(student1.ToString());

Console.WriteLine(student2.ToString());

Console.WriteLine(student3.ToString());

Console.WriteLine(student4.ToString());

// Output:

// Craig 0

// Craig 0

// 183

// Craig 116

public class StudentName

// This constructor has no parameters. The parameterless constructor

// is invoked in the processing of object initializers.

// You can test this by changing the access modifier from public to

// private. The declarations in Main that use object initializers

will

// fail.

public StudentName() { }

// The following constructor has parameters for two of the three

// properties.

public StudentName(string first, string last)

FirstName = first;

LastName = last;

 // Properties.

public string FirstName { get; set; }

public string LastName { get; set; }

public int ID { get; set; }

public override string ToString() => FirstName + " " + ID;

Los inicializadores de objeto pueden usarse para establecer indizadores en un objeto. En

el ejemplo siguiente se define una clase BaseballTeam que usa un indizador para
obtener y establecer jugadores en posiciones diferentes. El inicializador puede asignar
jugadores en función de la abreviatura de la posición o del número usado para las
puntuaciones de béisbol de cada posición:

C#

public class HowToIndexInitializer

public class BaseballTeam

private string[] players = new string[9];

private readonly List<string> positionAbbreviations = new

List<string>

"P", "C", "1B", "2B", "3B", "SS", "LF", "CF", "RF"

};

public string this[int position]

// Baseball positions are 1 - 9.

get { return players[position-1]; }

set { players[position-1] = value; }

public string this[string position]

get { return players[positionAbbreviations.IndexOf(position)]; }

set { players[positionAbbreviations.IndexOf(position)] = value;

}

public static void Main()

var team = new BaseballTeam

["RF"] = "Mookie Betts",

[4] = "Jose Altuve",

["CF"] = "Mike Trout"

};

Console.WriteLine(team["2B"]);

Vea también
Guía de programación de C#
Inicializadores de objeto y colección
Procedimientos: inicialización de un
diccionario con un inicializador de
colección (guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Una clase Dictionary<TKey,TValue> contiene una colección de pares clave-valor. Su

método Add toma dos parámetros: uno para la clave y otro para el valor. Una manera
de inicializar Dictionary<TKey,TValue>, o cualquier colección cuyo método Add tome
varios parámetros, es incluir entre llaves cada conjunto de parámetros, como se muestra
en el ejemplo siguiente. Otra opción es usar un inicializador de índice, lo que también se
muestra en el ejemplo siguiente.

Ejemplo
En el ejemplo de código siguiente, Dictionary<TKey,TValue> se inicializa con instancias
de tipo StudentName . La primera inicialización usa el método Add con dos argumentos.
El compilador genera una llamada a Add por cada uno de los pares de claves int y
valores StudentName . La segunda usa un método de indizador de lectura y escritura
público de la clase Dictionary :

C#

public class HowToDictionaryInitializer

class StudentName

public string FirstName { get; set; }

public string LastName { get; set; }

public int ID { get; set; }

public static void Main()

var students = new Dictionary<int, StudentName>()

{ 111, new StudentName { FirstName="Sachin", LastName="Karnik",

ID=211 } },

{ 112, new StudentName { FirstName="Dina",

LastName="Salimzianova", ID=317 } },

{ 113, new StudentName { FirstName="Andy", LastName="Ruth",

ID=198 } }

};

 foreach(var index in Enumerable.Range(111, 3))

Console.WriteLine($"Student {index} is
{students[index].FirstName} {students[index].LastName}");

Console.WriteLine();

var students2 = new Dictionary<int, StudentName>()

[111] = new StudentName { FirstName="Sachin", LastName="Karnik",

ID=211 },

[112] = new StudentName { FirstName="Dina",

LastName="Salimzianova", ID=317 } ,

[113] = new StudentName { FirstName="Andy", LastName="Ruth",

ID=198 }

};

foreach (var index in Enumerable.Range(111, 3))

Console.WriteLine($"Student {index} is
{students2[index].FirstName} {students2[index].LastName}");

Observe los dos pares de llaves de cada elemento de la colección en la primera

declaración. Las llaves internas contienen el inicializador de objeto para StudentName ,
mientras que las externas contienen el inicializador para el par clave-valor que se va a
agregar a la clase Dictionary<TKey,TValue> students . Por último, el inicializador
completo de la colección para el diccionario se encierra entre llaves. En la segunda
inicialización, el lado izquierdo de la asignación es la clave y el lado derecho es el valor,
con un inicializador de objeto para StudentName .

Vea también
Guía de programación de C#
Inicializadores de objeto y colección
Tipos anidados (Guía de programación
de C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

Un tipo definido en una clase, estructura o interfaz se denomina tipo anidado. Por
ejemplo

C#

public class Container

class Nested

Nested() { }

Con independencia de si el tipo externo es una clase, una interfaz o una estructura, los
tipos anidados se establecen de manera predeterminada en private; solo son accesibles
desde su tipo contenedor. En el ejemplo anterior, la clase Nested es inaccesible a los
tipos externos.

También puede especificar un modificador de acceso para definir la accesibilidad de un

tipo anidado, de la manera siguiente:

Los tipos anidados de una clase pueden ser public, protected, internal, protected
internal, private o private protected.

En cambio, al definir una clase anidada protected , protected internal o private

protected dentro de una clase sellada, se genera una advertencia del compilador

CS0628, "Nuevo miembro protegido declarado en la clase sealed".

Tenga en cuenta también que la creación de un tipo anidado externamente visible

infringe la regla de calidad del código CA1034 "Los tipos anidados no deben ser
visibles".

Los tipos anidados de un struct pueden ser public, internal o private.

En el ejemplo siguiente se convierte la clase Nested en public:

C#

public class Container

 public class Nested

Nested() { }

El tipo anidado o interno puede tener acceso al tipo contenedor o externo. Para tener
acceso al tipo contenedor, páselo como un argumento al constructor del tipo anidado.
Por ejemplo:

C#

public class Container

public class Nested

private Container parent;

public Nested()

public Nested(Container parent)

this.parent = parent;

Un tipo anidado tiene acceso a todos los miembros que estén accesibles para el tipo
contenedor. Puede tener acceso a los miembros privados y protegidos del tipo
contenedor, incluidos los miembros protegidos heredados.

En la declaración anterior, el nombre completo de la clase Nested es Container.Nested .

Este es el nombre que se utiliza para crear una instancia nueva de la clase anidada, de la
siguiente manera:

C#

Container.Nested nest = new Container.Nested();

Vea también
Guía de programación de C#
El sistema de tipos de C#
Modificadores de acceso
Constructores
Regla CA1034
Clases y métodos parciales (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

Es posible dividir la definición de una clase, un struct, una interfaz o un método en dos o
más archivos de código fuente. Cada archivo de código fuente contiene una sección de
la definición de tipo o método, y todos los elementos se combinan cuando se compila la
aplicación.

Clases parciales
Es recomendable dividir una definición de clase en varias situaciones:

Cuando se trabaja con proyectos grandes, el hecho de repartir una clase entre
archivos independientes permite que varios programadores trabajen en ella al
mismo tiempo.
Cuando se trabaja con código fuente generado automáticamente, se puede
agregar código a la clase sin tener que volver a crear el archivo de código fuente.
Visual Studio usa este enfoque al crear formularios Windows Forms, código de
contenedor de servicio Web, etc. Puede crear código que use estas clases sin
necesidad de modificar el archivo creado por Visual Studio.
Al usar generadores de código fuente para generar funcionalidades adicionales en
una clase.

Para dividir una definición de clase, use el modificador de palabra clave partial, como se
muestra aquí:

C#

public partial class Employee

public void DoWork()

public partial class Employee

public void GoToLunch()

La palabra clave partial indica que se pueden definir en el espacio de nombres otros
elementos de la clase, la estructura o la interfaz. Todos los elementos deben usar la
palabra clave partial . Todos los elementos deben estar disponibles en tiempo de
compilación para formar el tipo final. Todos los elementos deben tener la misma
accesibilidad, como public , private , etc.

Si algún elemento se declara abstracto, todo el tipo se considera abstracto. Si algún

elemento se declara sellado, todo el tipo se considera sellado. Si algún elemento declara
un tipo base, todo el tipo hereda esa clase.

Todos los elementos que especifiquen una clase base deben coincidir, pero los
elementos que omitan una clase base heredan igualmente el tipo base. Los elementos
pueden especificar diferentes interfaces base, y el tipo final implementa todas las
interfaces enumeradas por todas las declaraciones parciales. Todas las clases, structs o
miembros de interfaz declarados en una definición parcial están disponibles para todos
los demás elementos. El tipo final es la combinación de todos los elementos en tiempo
de compilación.

７ Nota

El modificador partial no está disponible en declaraciones de delegado o

enumeración.

En el ejemplo siguiente se muestra que los tipos anidados pueden ser parciales, incluso
si el tipo en el que están anidados no es parcial.

C#

class Container

partial class Nested

void Test() { }

partial class Nested

void Test2() { }

En tiempo de compilación, se combinan los atributos de definiciones de tipo parcial. Por

ejemplo, consideremos las siguientes declaraciones:
 C#

[SerializableAttribute]

partial class Moon { }

[ObsoleteAttribute]

partial class Moon { }

Son equivalentes a las declaraciones siguientes:

C#

[SerializableAttribute]

[ObsoleteAttribute]

class Moon { }

A continuación se indican los elementos que se combinan de todas las definiciones de

tipo parcial:

comentarios XML
interfaces
atributos de parámetro de tipo genérico
class (atributos)
miembros

Por ejemplo, consideremos las siguientes declaraciones:

C#

partial class Earth : Planet, IRotate { }

partial class Earth : IRevolve { }

Son equivalentes a las declaraciones siguientes:

C#

class Earth : Planet, IRotate, IRevolve { }

Restricciones
Debe seguir varias reglas al trabajar con definiciones de clase parcial:

Todas las definiciones de tipo parcial que van a formar parte del mismo tipo deben
modificarse con partial . Por ejemplo, las declaraciones de clase siguientes
 generan un error:

C#

public partial class A { }

//public class A { } // Error, must also be marked partial

El modificador partial solo puede aparecer inmediatamente antes de las palabras

clave class , struct o interface .
Se permiten tipos parciales anidados en definiciones de tipo parcial, como se
muestra en el ejemplo siguiente:

C#

partial class ClassWithNestedClass

partial class NestedClass { }

partial class ClassWithNestedClass

partial class NestedClass { }

Todas las definiciones de tipo parcial que van a formar parte del mismo tipo deben
definirse en el mismo ensamblado y en el mismo módulo (archivo .exe o .dll). Las
definiciones parciales no pueden abarcar varios módulos.
El nombre de clase y los parámetros de tipo genérico deben coincidir en todas las
definiciones de tipo parcial. Los tipos genéricos pueden ser parciales. Cada
declaración parcial debe usar los mismos nombres de parámetro en el mismo
orden.
Las siguientes palabras clave son opcionales en una definición de tipo parcial, pero
si están presentes la definición, no pueden entrar en conflicto con las palabras
clave especificadas en otra definición parcial para el mismo tipo:
public
private
protected
internal
abstract
sealed
clase base
modificador new (elementos anidados)
restricciones genéricas

Para obtener más información, vea Restricciones de tipos de parámetros.

Ejemplos
En el ejemplo siguiente, los campos y el constructor de la clase, Coords , se declaran en
una definición de clase parcial y el miembro PrintCoords se declara en otra definición
de clase parcial.

C#

public partial class Coords

private int x;

private int y;

public Coords(int x, int y)

this.x = x;

this.y = y;

public partial class Coords

public void PrintCoords()

Console.WriteLine("Coords: {0},{1}", x, y);

class TestCoords

static void Main()

Coords myCoords = new Coords(10, 15);

myCoords.PrintCoords();

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

// Output: Coords: 10,15

En el ejemplo siguiente se muestra que también se pueden desarrollar structs e

interfaces parciales.

C#

partial interface ITest

{

void Interface_Test();

partial interface ITest

{

void Interface_Test2();

partial struct S1

void Struct_Test() { }

partial struct S1

void Struct_Test2() { }

Métodos Partial
Una clase o struct parcial puede contener un método parcial. Un elemento de la clase
contiene la firma del método. Una implementación se puede definir en el mismo
elemento o en otro. Si no se proporciona la implementación, el método y todas las
llamadas al método se quitan en tiempo de compilación. La implementación puede ser
necesaria en función de la signatura del método. No es necesario que un método parcial
tenga una implementación en los casos siguientes:

No tiene ningún modificador de accesibilidad (incluido el predeterminado private).

Devuelve void.
No tiene parámetros out.
No tiene ninguno de los modificadores virtual, override, sealed, new o extern.

Cualquier método que no cumpla todas estas restricciones (por ejemplo, public virtual
partial void ) debe proporcionar una implementación. Esa implementación la puede
proporcionar un generador de código fuente.

Los métodos parciales permiten que el implementador de una parte de una clase
declare un método. El implementador de otra parte de la clase puede definir ese
método. Hay dos escenarios en los que esto es útil: plantillas que generan código
reutilizable y generadores de código fuente.

Código de plantilla: la plantilla reserva un nombre de método y una firma para

que el código generado pueda llamar al método. Estos métodos siguen las
restricciones que permiten a un desarrollador decidir si implementar el método. Si
el método no se implementa, el compilador quita la firma del método y todas las
llamadas al método. Las llamadas al método, incluidos los resultados que se
 producirían por la evaluación de los argumentos de las llamadas, no tienen efecto
en tiempo de ejecución. Por lo tanto, el código de la clase parcial puede usar
libremente un método parcial, incluso si no se proporciona la implementación. No
se producirá ningún error en tiempo de compilación o en tiempo de ejecución si
se llama al método pero no se implementa.
Generadores de código fuente: los generadores de código fuente proporcionan
una implementación para los métodos. El desarrollador humano puede agregar la
declaración de método (a menudo con atributos leídos por el generador de código
fuente). El desarrollador puede escribir código que llame a estos métodos. El
generador de código fuente se ejecuta durante la compilación y proporciona la
implementación. En este escenario, no se suelen seguir las restricciones de los
métodos parciales que pueden no implementarse.

C#

// Definition in file1.cs

partial void OnNameChanged();

// Implementation in file2.cs

partial void OnNameChanged()

// method body

Las declaraciones de método parcial deben comenzar con la palabra clave

contextual partial.
Las signaturas de métodos parciales de los dos elementos del tipo parcial deben
coincidir.
Los métodos parciales pueden tener modificadores static y unsafe.
Los métodos parciales pueden ser genéricos. Las restricciones se colocan en la
declaración de método parcial de definición y opcionalmente pueden repetirse en
el de implementación. Los nombres del parámetro y del parámetro de tipo no
tienen que ser iguales en la declaración de implementación y en la declaración de
definición.
Puede crear un delegado para un método parcial que se ha definido e
implementado, pero no para un método parcial que solo se ha definido.

Especificación del lenguaje C#

Para obtener más información, vea la sección Tipos parciales de la Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.
Consulte también
Guía de programación de C#
Clases
Tipos de estructura
Interfaces
partial (Tipos)
Procedimiento para devolver
subconjuntos de propiedades de
elementos en una consulta (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Use un tipo anónimo en una expresión de consulta cuando se cumplan estas dos
condiciones:

Solo quiere algunas de las propiedades de cada elemento de origen.

No es necesario almacenar los resultados de la consulta fuera del ámbito del

método en el que se ejecuta la consulta.

Si solo quiere devolver una propiedad o campo de cada elemento de origen, puede usar
simplemente el operador de punto en la cláusula select . Por ejemplo, para devolver
solo el ID de cada student , escriba la cláusula select como sigue:

C#

select student.ID;

Ejemplo
En el ejemplo siguiente se muestra cómo usar un tipo anónimo para devolver solo un
subconjunto de las propiedades de cada elemento de origen que coincida con la
condición especificada.

C#

private static void QueryByScore()

// Create the query. var is required because

// the query produces a sequence of anonymous types.

var queryHighScores =

from student in students

where student.ExamScores[0] > 95

select new { student.FirstName, student.LastName };

// Execute the query.

foreach (var obj in queryHighScores)

 // The anonymous type's properties were not named. Therefore

// they have the same names as the Student properties.

Console.WriteLine(obj.FirstName + ", " + obj.LastName);

/* Output:

Adams, Terry

Fakhouri, Fadi

Garcia, Cesar

Omelchenko, Svetlana

Zabokritski, Eugene

*/

Tenga en cuenta que, si no se especifica ningún nombre, el tipo anónimo usa los
nombres del elemento de origen para sus propiedades. Para asignar nombres nuevos a
las propiedades del tipo anónimo, escriba la instrucción select como sigue:

C#

select new { First = student.FirstName, Last = student.LastName };

Si lo intenta en el ejemplo anterior, también debe cambiar la instrucción

Console.WriteLine :

C#

Console.WriteLine(student.First + " " + student.Last);

Compilar el código
Para ejecutar este código, copie y pegue la clase en una aplicación de consola de C#
con una directiva using de System.Linq.

Consulte también
Guía de programación de C#
Tipos anónimos
LINQ en C#
Implementación de interfaz explícita
(Guía de programación de C#)
Artículo • 11/02/2023 • Tiempo de lectura: 3 minutos

Si una clase implementa dos interfaces que contienen un miembro con la misma firma,
entonces al implementar ese miembro en la clase ambas interfaces usarán ese miembro
como su implementación. En el ejemplo siguiente, todas las llamadas a Paint invocan el
mismo método. En este primer ejemplo se definen los tipos:

C#

public interface IControl

void Paint();

public interface ISurface

void Paint();

public class SampleClass : IControl, ISurface

// Both ISurface.Paint and IControl.Paint call this method.

public void Paint()

Console.WriteLine("Paint method in SampleClass");

En el ejemplo siguiente se llama a los métodos:

C#

SampleClass sample = new SampleClass();

IControl control = sample;

ISurface surface = sample;

// The following lines all call the same method.

sample.Paint();

control.Paint();

surface.Paint();

// Output:

// Paint method in SampleClass

// Paint method in SampleClass

// Paint method in SampleClass

Pero es posible que no quiera que se llame a la misma implementación para las dos
interfaces. Para llamar a otra implementación en función de la interfaz en uso, puede
implementar un miembro de interfaz de forma explícita. Una implementación de interfaz
explícita es un miembro de clase al que solo se llama a través de la interfaz especificada.
Asigne al miembro de clase el nombre de la interfaz y un punto como prefijo. Por
ejemplo:

C#

public class SampleClass : IControl, ISurface

void IControl.Paint()

System.Console.WriteLine("IControl.Paint");

void ISurface.Paint()

System.Console.WriteLine("ISurface.Paint");

El miembro de clase IControl.Paint solo está disponible a través de la interfaz

IControl , y ISurface.Paint solo está disponible mediante ISurface . Las dos

implementaciones de método son independientes, y ninguna está disponible

directamente en la clase. Por ejemplo:

C#

SampleClass sample = new SampleClass();

IControl control = sample;

ISurface surface = sample;

// The following lines all call the same method.

//sample.Paint(); // Compiler error.

control.Paint(); // Calls IControl.Paint on SampleClass.

surface.Paint(); // Calls ISurface.Paint on SampleClass.

// Output:

// IControl.Paint

// ISurface.Paint

La implementación explícita también se usa para resolver casos donde dos interfaces
declaran miembros diferentes del mismo nombre como una propiedad y un método.
Para implementar ambas interfaces, una clase tiene que usar la implementación explícita
para la propiedad P o el método P , o ambos, para evitar un error del compilador. Por
ejemplo:
 C#

interface ILeft

int P { get;}

interface IRight

int P();

class Middle : ILeft, IRight

public int P() { return 0; }

int ILeft.P { get { return 0; } }

Una implementación de interfaz explícita no tiene un modificador de acceso, ya que no

es accesible como miembro del tipo en el que se define. En su lugar, solo es accesible
cuando se llama mediante una instancia de la interfaz. Si especifica un modificador de
acceso para una implementación de interfaz explícita, obtendrá el error del compilador
CS0106. Para obtener más información, vea interface (Referencia de C#).

Puede definir una implementación para los miembros declarados en una interfaz. Si una
clase hereda una implementación de método de una interfaz, ese método solo es
accesible a través de una referencia del tipo de interfaz. El miembro heredado no
aparece como parte de la interfaz pública. En el ejemplo siguiente se define una
implementación predeterminada para un método de interfaz:

C#

public interface IControl

void Paint() => Console.WriteLine("Default Paint method");

public class SampleClass : IControl

// Paint() is inherited from IControl.

En el ejemplo siguiente se invoca la implementación predeterminada:

C#

var sample = new SampleClass();

//sample.Paint();// "Paint" isn't accessible.

var control = sample as IControl;

control.Paint();

Cualquier clase que implemente la interfaz IControl puede invalidar el método Paint
predeterminado, ya sea como un método público, o bien como una implementación de
interfaz explícita.

Consulte también
Guía de programación de C#
Programación orientada a objetos
Interfaces
Herencia
Procedimiento Implementar
explícitamente miembros de interfaz
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Este ejemplo declara una interfaz, IDimensions , y una clase, Box , que implementa
explícitamente los miembros de interfaz GetLength y GetWidth . Se tiene acceso a los
miembros mediante la instancia de interfaz dimensions .

Ejemplo
C#

interface IDimensions

float GetLength();

float GetWidth();

class Box : IDimensions

float lengthInches;

float widthInches;

Box(float length, float width)

lengthInches = length;

widthInches = width;

// Explicit interface member implementation:

float IDimensions.GetLength()
{

return lengthInches;

// Explicit interface member implementation:

float IDimensions.GetWidth()

return widthInches;

static void Main()

// Declare a class instance box1:

Box box1 = new Box(30.0f, 20.0f);

// Declare an interface instance dimensions:

 IDimensions dimensions = box1;

// The following commented lines would produce compilation

// errors because they try to access an explicitly implemented

// interface member from a class instance:

//System.Console.WriteLine("Length: {0}", box1.GetLength());

//System.Console.WriteLine("Width: {0}", box1.GetWidth());

// Print out the dimensions of the box by calling the methods

// from an instance of the interface:

System.Console.WriteLine("Length: {0}", dimensions.GetLength());

System.Console.WriteLine("Width: {0}", dimensions.GetWidth());

/* Output:

Length: 30

Width: 20

*/

Programación sólida
Tenga en cuenta que las siguientes líneas, en el método Main , se comentan porque
producirían errores de compilación. No se puede tener acceso a un miembro de
interfaz que se implementa explícitamente desde una instancia class:

C#

//System.Console.WriteLine("Length: {0}", box1.GetLength());

//System.Console.WriteLine("Width: {0}", box1.GetWidth());

Tenga en cuenta también que las líneas siguientes, en el método Main , imprimen
correctamente las dimensiones del cuadro porque se llama a los métodos desde
una instancia de la interfaz:

C#

System.Console.WriteLine("Length: {0}", dimensions.GetLength());

System.Console.WriteLine("Width: {0}", dimensions.GetWidth());

Consulte también
Guía de programación de C#
Programación orientada a objetos
Interfaces
Procedimiento para implementar miembros de dos interfaces de forma explícita
Procedimiento Implementar
explícitamente miembros de dos
interfaces (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La implementación explícita de interfaces también permite al programador implementar

dos interfaces que tienen los mismos nombres de miembros y dar a cada miembro de
una interfaz una implementación independiente. En este ejemplo se muestran las
dimensiones de un cuadro en unidades métricas e inglesas. La clase Box implementa
dos interfaces, IEnglishDimensions e IMetricDimensions, que representan los diferentes
sistemas de medida. Ambas interfaces tienen nombres de miembros idénticos, Length y
Width.

Ejemplo
C#

// Declare the English units interface:

interface IEnglishDimensions

float Length();

float Width();

// Declare the metric units interface:

interface IMetricDimensions

float Length();

float Width();

// Declare the Box class that implements the two interfaces:

// IEnglishDimensions and IMetricDimensions:

class Box : IEnglishDimensions, IMetricDimensions

float lengthInches;

float widthInches;

public Box(float lengthInches, float widthInches)

this.lengthInches = lengthInches;

this.widthInches = widthInches;

// Explicitly implement the members of IEnglishDimensions:

 float IEnglishDimensions.Length() => lengthInches;

float IEnglishDimensions.Width() => widthInches;

// Explicitly implement the members of IMetricDimensions:

float IMetricDimensions.Length() => lengthInches * 2.54f;

float IMetricDimensions.Width() => widthInches * 2.54f;

static void Main()

// Declare a class instance box1:

Box box1 = new Box(30.0f, 20.0f);

// Declare an instance of the English units interface:

IEnglishDimensions eDimensions = box1;

// Declare an instance of the metric units interface:

IMetricDimensions mDimensions = box1;

// Print dimensions in English units:

System.Console.WriteLine("Length(in): {0}", eDimensions.Length());

System.Console.WriteLine("Width (in): {0}", eDimensions.Width());

// Print dimensions in metric units:

System.Console.WriteLine("Length(cm): {0}", mDimensions.Length());

System.Console.WriteLine("Width (cm): {0}", mDimensions.Width());

/* Output:

Length(in): 30

Width (in): 20

Length(cm): 76.2

Width (cm): 50.8

*/

Programación sólida
Si quiere realizar las medidas en unidades inglesas de manera predeterminada,
implemente los métodos Length y Width con normalidad e implemente explícitamente
los métodos Length y Width de la interfaz IMetricDimensions:

C#

// Normal implementation:

public float Length() => lengthInches;

public float Width() => widthInches;

// Explicit implementation:

float IMetricDimensions.Length() => lengthInches * 2.54f;

float IMetricDimensions.Width() => widthInches * 2.54f;

En este caso, se puede tener acceso a las unidades inglesas desde la instancia de clase y
acceso a las unidades métricas desde la instancia de interfaz:

C#

public static void Test()

Box box1 = new Box(30.0f, 20.0f);

IMetricDimensions mDimensions = box1;

System.Console.WriteLine("Length(in): {0}", box1.Length());

System.Console.WriteLine("Width (in): {0}", box1.Width());

System.Console.WriteLine("Length(cm): {0}", mDimensions.Length());

System.Console.WriteLine("Width (cm): {0}", mDimensions.Width());

Consulte también
Guía de programación de C#
Programación orientada a objetos
Interfaces
Procedimiento para implementar miembros de interfaz de forma explícita
Delegados (Guía de programación de
C#)
Artículo • 10/02/2023 • Tiempo de lectura: 3 minutos

Un delegado es un tipo que representa referencias a métodos con una lista de

parámetros determinada y un tipo de valor devuelto. Cuando se crea una instancia de
un delegado, puede asociar su instancia a cualquier método mediante una signatura
compatible y un tipo de valor devuelto. Puede invocar (o llamar) al método a través de
la instancia del delegado.

Los delegados se utilizan para pasar métodos como argumentos a otros métodos. Los
controladores de eventos no son más que métodos que se invocan a través de
delegados. Cree un método personalizado y una clase, como un control de Windows,
podrá llamar al método cuando se produzca un determinado evento. En el siguiente
ejemplo se muestra una declaración de delegado:

C#

public delegate int PerformCalculation(int x, int y);

Cualquier método de cualquier clase o struct accesible que coincida con el tipo de
delegado se puede asignar al delegado. El método puede ser estático o de instancia.
Esta flexibilidad significa que puede cambiar las llamadas de método mediante
programación, o bien agregar código nuevo a las clases existentes.

７ Nota

En el contexto de la sobrecarga de métodos, la signatura de un método no incluye

el valor devuelto. Sin embargo, en el contexto de los delegados, la signatura sí lo
incluye. En otras palabras, un método debe tener el mismo tipo de valor devuelto
que el delegado.

Esta capacidad de hacer referencia a un método como parámetro hace que los
delegados sean idóneos para definir métodos de devolución de llamada. Puede escribir
un método que compare dos objetos en la aplicación. Ese método se puede usar en un
delegado para un algoritmo de ordenación. Como el código de comparación es
independiente de la biblioteca, el método de ordenación puede ser más general.

Se han agregado punteros de función a C# 9 para escenarios similares, donde se

necesita más control sobre la convención de llamadas. El código asociado a un
delegado se invoca mediante un método virtual agregado a un tipo de delegado.
Mediante los punteros de función puede especificar otras convenciones.

Información general sobre los delegados

Los delegados tienen las propiedades siguientes:

Los delegados son similares a los punteros de función de C++, pero los primeros
están completamente orientados a objetos y, a diferencia de los punteros de C++
de funciones de miembro, los delegados encapsulan una instancia de objeto y un
método.
Los delegados permiten pasar los métodos como parámetros.
Los delegados pueden usarse para definir métodos de devolución de llamada.
Los delegados pueden encadenarse entre sí; por ejemplo, se puede llamar a varios
métodos en un solo evento.
No es necesario que los métodos coincidan exactamente con el tipo de delegado.
Para obtener más información, consulte Usar varianza en delegados.
Las expresiones lambda son una manera más concisa de escribir bloques de
código alineado. En determinados contextos, las expresiones lambda se compilan
en tipos de delegado. Para más información sobre las expresiones lambda,
consulte Expresiones lambda.

En esta sección
Utilizar delegados
Cuándo usar delegados en lugar de interfaces (Guía de programación de C#)
Delegados con métodos con nombre y delegados con métodos anónimos
Uso de varianza en delegados
Procedimiento para combinar delegados (delegados de multidifusión)
Procedimiento para declarar un delegado, crear instancias del mismo y usarlo

Especificación del lenguaje C#

Para obtener más información, vea la sección Delegados de Especificación del lenguaje
C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Capítulos destacados del libro

Delegates, Events, and Lambda Expressions (Delegados, eventos y expresiones
lambda) en C# 3.0 Cookbook, Tercera edición: More than 250 solutions for C# 3.0
 programmers (Más de 250 soluciones para programadores de C# 3.0)
Delegates and Events (Delegados y eventos) en Learning C# 3.0: Fundamentals of
C# 3.0

Consulte también
Delegate
Guía de programación de C#
Eventos
Utilizar delegados (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Un delegado es un tipo que encapsula de forma segura un método, similar a un puntero

de función en C y C++. A diferencia de los punteros de función de C, los delegados
están orientados a objetos, proporcionan seguridad de tipos y son seguros. El tipo de
un delegado se define por el nombre del delegado. En el ejemplo siguiente, se declara
un delegado denominado Del que puede encapsular un método que toma una string
como argumento y devuelve void:

C#

public delegate void Del(string message);

Normalmente, un objeto delegado se construye al proporcionar el nombre del método

que el delegado encapsulará o con una expresión lambda. Una vez que se crea una
instancia de delegado, el delegado pasará al método una llamada de método realizada
al delegado. Los parámetros pasados al delegado por el autor de la llamada se pasan a
su vez al método, y el valor devuelto desde el método, si lo hubiera, es devuelto por el
delegado al autor de la llamada. Esto se conoce como invocar al delegado. Un delegado
con instancias se puede invocar como si fuera el propio método encapsulado. Por
ejemplo:

C#

// Create a method for a delegate.

public static void DelegateMethod(string message)

Console.WriteLine(message);

C#

// Instantiate the delegate.

Del handler = DelegateMethod;

// Call the delegate.

handler("Hello World");

Los tipos de delegado se derivan de la clase Delegate en .NET. Los tipos de delegados
son sealed (no se pueden derivar) y no se pueden derivar clases personalizadas de
Delegate. Dado que el delegado con instancias es un objeto, puede pasarse como
argumento o asignarse a una propiedad. De este modo, un método puede aceptar un
delegado como parámetro y llamar al delegado en algún momento posterior. Esto se
conoce como devolución de llamada asincrónica y es un método común para notificar a
un llamador que un proceso largo ha finalizado. Cuando se utiliza un delegado de esta
manera, el código que usa al delegado no necesita ningún conocimiento de la
implementación del método empleado. La funcionalidad es similar a la encapsulación
que proporcionan las interfaces.

Otro uso común de devoluciones de llamada es definir un método de comparación

personalizado y pasar ese delegado a un método de ordenación. Permite que el código
del llamador se convierta en parte del algoritmo de ordenación. En el siguiente método
de ejemplo se usa el tipo Del como parámetro:

C#

public static void MethodWithCallback(int param1, int param2, Del callback)

callback("The number is: " + (param1 + param2).ToString());

Luego puede pasar el delegado creado anteriormente a ese método:

C#

MethodWithCallback(1, 2, handler);

Y recibir los siguientes resultados en la consola:

Consola

The number is: 3

Si se usa el delegado como abstracción, no es necesario que MethodWithCallback llame

directamente a la consola —no tiene que estar diseñado pensando en una consola—. Lo
que MethodWithCallback hace es simplemente preparar una cadena y pasarla a otro
método. Esto es especialmente eficaz, puesto que un método delegado puede utilizar
cualquier número de parámetros.

Cuando se crea un delegado para encapsular un método de instancia, el delegado hace

referencia tanto a la instancia como al método. Un delegado no tiene conocimiento del
tipo de instancia —aparte del método al que encapsula—, por lo que un delegado
puede hacer referencia a cualquier tipo de objeto siempre que haya un método en ese
objeto que coincida con la signatura del delegado. Cuando se crea un delegado para
encapsular un método estático, solo hace referencia al método. Considere las siguientes
declaraciones:

C#

public class MethodClass

public void Method1(string message) { }

public void Method2(string message) { }

Junto con el DelegateMethod estático mostrado anteriormente, ahora tenemos tres

métodos que se pueden encapsularse mediante una instancia de Del .

Un delegado puede llamar a más de un método cuando se invoca. Esto se conoce como
multidifusión. Para agregar un método adicional a la lista de métodos del delegado —la
lista de invocación—, simplemente es necesario agregar dos delegados mediante los
operadores de adición o asignación y suma ('+' o '+='). Por ejemplo:

C#

var obj = new MethodClass();

Del d1 = obj.Method1;

Del d2 = obj.Method2;

Del d3 = DelegateMethod;

//Both types of assignment are valid.

Del allMethodsDelegate = d1 + d2;

allMethodsDelegate += d3;

En este momento allMethodsDelegate contiene tres métodos en su lista de invocación:

Method1 , Method2 y DelegateMethod . Los tres delegados originales, d1 , d2 y d3 ,
permanecen sin cambios. Cuando se invoca allMethodsDelegate , todos los métodos se
llaman en orden. Si el delegado usa parámetros de referencia, la referencia se pasa
secuencialmente a cada uno de los tres métodos por turnos, y cualquier cambio que
realice un método es visible para el siguiente método. Cuando alguno de los métodos
produce una excepción que no se captura dentro del método, esa excepción se pasa al
llamador del delegado y no se llama a los métodos siguientes de la lista de invocación.
Si el delegado tiene un valor devuelto o los parámetros de salida, devuelve el valor
devuelto y los parámetros del último método invocado. Para quitar un método de la
lista de invocación, utilice los operadores de decremento o de asignación de
decremento ( - o -= ). Por ejemplo:
 C#

//remove Method1

allMethodsDelegate -= d1;

// copy AllMethodsDelegate while removing d2

Del oneMethodDelegate = allMethodsDelegate - d2;

Dado que los tipos de delegado se derivan de System.Delegate , los métodos y

propiedades definidas por esa clase se pueden llamar en el delegado. Por ejemplo, para
buscar el número de métodos en la lista de invocación de un delegado, se puede
escribir:

C#

int invocationCount = d1.GetInvocationList().GetLength(0);

Los delegados con más de un método en su lista de invocación derivan de

MulticastDelegate, que es una subclase de System.Delegate . El código anterior funciona
en ambos casos porque las dos clases admiten GetInvocationList .

Los delegados de multidifusión se utilizan mucho en el control de eventos. Los objetos

de origen de evento envían notificaciones de evento a los objetos de destinatario que
se han registrado para recibir ese evento. Para suscribirse a un evento, el destinatario
crea un método diseñado para controlar el evento; a continuación, crea a un delegado
para dicho método y pasa el delegado al origen de eventos. El origen llama al delegado
cuando se produce el evento. Después, el delegado llama al método que controla los
eventos en el destinatario y entrega los datos del evento. El origen del evento define el
tipo de delegado para un evento determinado. Para obtener más información, consulte
Eventos.

La comparación de delegados de dos tipos distintos asignados en tiempo de

compilación generará un error de compilación. Si las instancias de delegado son
estáticamente del tipo System.Delegate , entonces se permite la comparación, pero
devolverá false en tiempo de ejecución. Por ejemplo:

C#

delegate void Delegate1();

delegate void Delegate2();

static void method(Delegate1 d, Delegate2 e, System.Delegate f)

// Compile-time error.

//Console.WriteLine(d == e);

 // OK at compile-time. False if the run-time type of f

// is not the same as that of d.

Console.WriteLine(d == f);

Consulte también
Guía de programación de C#
Delegados
Uso de varianza en delegados
Varianza en delegados
Uso de varianza para los delegados genéricos Func y Action
Eventos
Delegados con métodos con nombre y
Métodos anónimos (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Un delegado puede asociarse con un método con nombre. Cuando crea una instancia
de un delegado mediante un método con nombre, el método se pasa como un
parámetro, por ejemplo:

C#

// Declare a delegate.

delegate void Del(int x);

// Define a named method.

void DoWork(int k) { /* ... */ }

// Instantiate the delegate using the method as a parameter.

Del d = obj.DoWork;

Esto se llama con un método con nombre. Los delegados construidos con un método
con nombre pueden encapsular un método estático o un método de instancia. Los
métodos con nombre son la única manera de crear una instancia de un delegado en
versiones anteriores de C#. En cambio, en una situación en la que crear un método
nuevo es una sobrecarga no deseada, C# le permite crear una instancia de un delegado
y especificar inmediatamente un bloque de código que el delegado procesará cuando
se llame. El bloque puede contener una expresión lambda o un método anónimo.

El método que pasa como un parámetro de delegado debe tener la misma firma que la
declaración de delegado. Una instancia de delegado puede encapsular un método de
instancia o estático.

７ Nota

Aunque el delegado puede usar un parámetro out, no recomendamos su uso con

delegados de eventos de multidifusión porque no puede conocer a qué delegado
se llamará.

A partir de C# 10, los grupos de métodos con una única sobrecarga tienen un tipo
natural. Esto significa que el compilador puede deducir el tipo de valor devuelto y los
tipos de parámetro para el tipo delegado:

C#

var read = Console.Read; // Just one overload; Func<int> inferred

var write = Console.Write; // ERROR: Multiple overloads, can't choose

Ejemplos
A continuación se muestra un ejemplo sencillo de cómo declarar y usar un delegado.
Tenga en cuenta que tanto el delegado, Del , como el método asociado,
MultiplyNumbers , tienen la misma firma

C#

// Declare a delegate

delegate void Del(int i, double j);

class MathClass

static void Main()

MathClass m = new MathClass();

// Delegate instantiation using "MultiplyNumbers"

Del d = m.MultiplyNumbers;

// Invoke the delegate object.

Console.WriteLine("Invoking the delegate using 'MultiplyNumbers':");

for (int i = 1; i <= 5; i++)

d(i, 2);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

// Declare the associated method.

void MultiplyNumbers(int m, double n)

Console.Write(m * n + " ");

/* Output:

Invoking the delegate using 'MultiplyNumbers':

2 4 6 8 10

*/

En el ejemplo siguiente, un delegado se asigna a métodos estáticos y de instancia y

devuelve información específica de cada uno.

C#

// Declare a delegate

delegate void Del();

class SampleClass

public void InstanceMethod()

Console.WriteLine("A message from the instance method.");

static public void StaticMethod()

Console.WriteLine("A message from the static method.");

class TestSampleClass

static void Main()

var sc = new SampleClass();

// Map the delegate to the instance method:

Del d = sc.InstanceMethod;

d();

// Map to the static method:

d = SampleClass.StaticMethod;

d();

/* Output:

A message from the instance method.

A message from the static method.

*/

Consulte también
Guía de programación de C#
Delegados
Procedimiento para combinar delegados (delegados de multidifusión)
Eventos
Procedimiento para combinar
delegados (delegados de multidifusión)
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se muestra cómo crear delegados de multidifusión. Una propiedad útil
de los objetos delegados es que puedan asignarse objetos múltiples a una instancia de
delegado con el operador + . El delegado de multidifusión contiene una lista de los
delegados asignados. Cuando se llama al delegado de multidifusión, invoca a los
delegados de la lista, en orden. Solo los delegados del mismo tipo pueden combinarse.

El operador - puede usarse para quitar un delegado de componente de un delegado

de multidifusión.

Ejemplo
C#

using System;

// Define a custom delegate that has a string parameter and returns void.

delegate void CustomDel(string s);

class TestClass

// Define two methods that have the same signature as CustomDel.

static void Hello(string s)

Console.WriteLine($" Hello, {s}!");

static void Goodbye(string s)

Console.WriteLine($" Goodbye, {s}!");

static void Main()

// Declare instances of the custom delegate.

CustomDel hiDel, byeDel, multiDel, multiMinusHiDel;

// In this example, you can omit the custom delegate if you

// want to and use Action<string> instead.

//Action<string> hiDel, byeDel, multiDel, multiMinusHiDel;

 // Initialize the delegate object hiDel that references the

// method Hello.

hiDel = Hello;

// Initialize the delegate object byeDel that references the

// method Goodbye.

byeDel = Goodbye;

// The two delegates, hiDel and byeDel, are combined to

// form multiDel.

multiDel = hiDel + byeDel;

// Remove hiDel from the multicast delegate, leaving byeDel,

// which calls only the method Goodbye.

multiMinusHiDel = multiDel - hiDel;

Console.WriteLine("Invoking delegate hiDel:");

hiDel("A");

Console.WriteLine("Invoking delegate byeDel:");

byeDel("B");

Console.WriteLine("Invoking delegate multiDel:");

multiDel("C");

Console.WriteLine("Invoking delegate multiMinusHiDel:");

multiMinusHiDel("D");

/* Output:

Invoking delegate hiDel:

Hello, A!

Invoking delegate byeDel:

Goodbye, B!

Invoking delegate multiDel:

Hello, C!

Goodbye, C!

Invoking delegate multiMinusHiDel:

Goodbye, D!

*/

Consulte también
MulticastDelegate
Guía de programación de C#
Eventos
Procedimiento Declarar un delegado,
crear instancias del mismo y utilizarlo
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Puede declarar delegados mediante cualquiera de los métodos siguientes:

Declare un tipo de delegado y declare un método con una firma coincidente:

C#

// Declare a delegate.

delegate void Del(string str);

// Declare a method with the same signature as the delegate.

static void Notify(string name)

Console.WriteLine($"Notification received for: {name}");

C#

// Create an instance of the delegate.

Del del1 = new Del(Notify);

Asigne un grupo de métodos a un tipo delegado:

C#

// C# 2.0 provides a simpler way to declare an instance of Del.

Del del2 = Notify;

Declare un método anónimo:

C#

// Instantiate Del by using an anonymous method.

Del del3 = delegate(string name)

{ Console.WriteLine($"Notification received for: {name}"); };

Use una expresión lambda:

C#
 // Instantiate Del by using a lambda expression.

Del del4 = name => { Console.WriteLine($"Notification received for:

{name}"); };

Para obtener más información, vea Expresiones lambda.

En el ejemplo siguiente se ilustra cómo declarar un delegado, crear una instancia del
mismo y utilizarlo La clase BookDB encapsula una base de datos de una librería que
mantiene una base de datos de libros. Expone un método ProcessPaperbackBooks , que
busca todos los libros de bolsillo en la base de datos y llama a un delegado para cada
uno. El tipo delegate utilizado se denomina ProcessBookCallback . La clase Test utiliza
esta clase para imprimir los títulos y el precio medio de los libros de bolsillo.

El uso de delegados promueve una separación adecuada de la funcionalidad entre la

base de datos de la librería y el código de cliente. El código de cliente no sabe cómo se
almacenan los libros ni cómo el código de la biblioteca encuentra los libros de bolsillo.
El código de la librería no sabe qué procesamiento se realiza con los libros de bolsillo
después de que los encuentra.

Ejemplo
C#

// A set of classes for handling a bookstore:

namespace Bookstore

using System.Collections;

// Describes a book in the book list:

public struct Book

public string Title; // Title of the book.

public string Author; // Author of the book.

public decimal Price; // Price of the book.

public bool Paperback; // Is it paperback?

public Book(string title, string author, decimal price, bool

paperBack)

Title = title;

Author = author;

Price = price;

Paperback = paperBack;

// Declare a delegate type for processing a book:

 public delegate void ProcessBookCallback(Book book);

// Maintains a book database.

public class BookDB

// List of all books in the database:

ArrayList list = new ArrayList();

// Add a book to the database:

public void AddBook(string title, string author, decimal price, bool

paperBack)

list.Add(new Book(title, author, price, paperBack));

// Call a passed-in delegate on each paperback book to process it:

public void ProcessPaperbackBooks(ProcessBookCallback processBook)

foreach (Book b in list)

if (b.Paperback)

// Calling the delegate:

processBook(b);

// Using the Bookstore classes:

namespace BookTestClient

using Bookstore;

// Class to total and average prices of books:

class PriceTotaller

int countBooks = 0;

decimal priceBooks = 0.0m;

internal void AddBookToTotal(Book book)

countBooks += 1;

priceBooks += book.Price;

internal decimal AveragePrice()

return priceBooks / countBooks;

// Class to test the book database:

class Test

// Print the title of the book.

 static void PrintTitle(Book b)

Console.WriteLine($" {b.Title}");

// Execution starts here.

static void Main()

BookDB bookDB = new BookDB();

// Initialize the database with some books:

AddBooks(bookDB);

// Print all the titles of paperbacks:

Console.WriteLine("Paperback Book Titles:");

// Create a new delegate object associated with the static

// method Test.PrintTitle:

bookDB.ProcessPaperbackBooks(PrintTitle);

// Get the average price of a paperback by using

// a PriceTotaller object:

PriceTotaller totaller = new PriceTotaller();

// Create a new delegate object associated with the nonstatic

// method AddBookToTotal on the object totaller:

bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal);

Console.WriteLine("Average Paperback Book Price: ${0:#.##}",

totaller.AveragePrice());

// Initialize the book database with some test books:

static void AddBooks(BookDB bookDB)

bookDB.AddBook("The C Programming Language", "Brian W. Kernighan

and Dennis M. Ritchie", 19.95m, true);

bookDB.AddBook("The Unicode Standard 2.0", "The Unicode

Consortium", 39.95m, true);

bookDB.AddBook("The MS-DOS Encyclopedia", "Ray Duncan", 129.95m,

false);

bookDB.AddBook("Dogbert's Clues for the Clueless", "Scott

Adams", 12.00m, true);

/* Output:

Paperback Book Titles:

The C Programming Language

The Unicode Standard 2.0

Dogbert's Clues for the Clueless

Average Paperback Book Price: $23.97

*/

Programación sólida
Declaración de un delegado.

La instrucción siguiente declara un nuevo tipo de delegado.

C#

public delegate void ProcessBookCallback(Book book);

Cada tipo de delegado describe el número y los tipos de argumentos, y el tipo del
valor devuelto de los métodos que puede encapsular. Siempre que se necesite un
nuevo conjunto de tipos de argumentos o de tipos de valores devueltos, se debe
declarar un nuevo tipo de delegado.

Creación de instancias de un delegado.

Después de haber declarado un tipo de delegado, debe crearse un objeto

delegado y asociarse con un método particular. En el ejemplo anterior, esto se
hace pasando el método PrintTitle al método ProcessPaperbackBooks como en el
ejemplo siguiente:

C#

bookDB.ProcessPaperbackBooks(PrintTitle);

Esto crea un objeto delegado nuevo asociado con el método

estático Test.PrintTitle . De forma similar, el método no estático AddBookToTotal
del objeto totaller se pasa como en el ejemplo siguiente:

C#

bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal);

En ambos casos, se pasa un nuevo objeto delegado al método

ProcessPaperbackBooks .

Después de que se ha creado un delegado, el método con el que está asociado

nunca cambia; los objetos delegados son inmutables.

Llamada a un delegado.

Después de haber creado un objeto delegado, este suele pasarse a otro código
que llamará al delegado. La llamada a un objeto delegado se realiza mediante la
 utilización del nombre de dicho objeto, seguido de los argumentos entre
paréntesis que se deben pasar al delegado. A continuación se expone un ejemplo
de llamada a un delegado:

C#

processBook(b);

Se puede llamar a un delegado de forma sincrónica, como en este ejemplo, o bien

de forma asincrónica con los métodos BeginInvoke y EndInvoke .

Consulte también
Guía de programación de C#
Eventos
Delegados
Matrices (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Puede almacenar varias variables del mismo tipo en una estructura de datos de matriz.
Puede declarar una matriz mediante la especificación del tipo de sus elementos. Si
quiere que la matriz almacene elementos de cualquier tipo, puede especificar object
como su tipo. En el sistema de tipos unificado de C#, todos los tipos, los predefinidos y
los definidos por el usuario, los tipos de referencia y los tipos de valores, heredan
directa o indirectamente de Object.

C#

type[] arrayName;

Ejemplo
Los ejemplos siguientes crean matrices unidimensionales, multidimensionales y
escalonadas:

C#

class TestArraysClass

static void Main()

// Declare a single-dimensional array of 5 integers.

int[] array1 = new int[5];

// Declare and set array element values.

int[] array2 = new int[] { 1, 3, 5, 7, 9 };

// Alternative syntax.

int[] array3 = { 1, 2, 3, 4, 5, 6 };

// Declare a two dimensional array.

int[,] multiDimensionalArray1 = new int[2, 3];

// Declare and set array element values.

int[,] multiDimensionalArray2 = { { 1, 2, 3 }, { 4, 5, 6 } };

// Declare a jagged array.

int[][] jaggedArray = new int[6][];

// Set the values of the first array in the jagged array structure.

jaggedArray[0] = new int[4] { 1, 2, 3, 4 };

Información general sobre la matriz

Una matriz tiene las propiedades siguientes:

Puede ser una matriz unidimensional, multidimensional o escalonada.

El número de dimensiones y la longitud de cada dimensión se establecen al crear
la instancia de matriz. No se pueden cambiar estos valores durante la vigencia de
la instancia.
Los valores predeterminados de los elementos numéricos de matriz se establecen
en cero y los elementos de referencia se establecen en null .
Una matriz escalonada es una matriz de matrices y, por consiguiente, sus
elementos son tipos de referencia y se inicializan en null .
Las matrices se indexan con cero: una matriz con n elementos se indexa de 0 a n-
1.

Los elementos de una matriz puede ser cualquier tipo, incluido un tipo de matriz.
Los tipos de matriz son tipos de referencia que proceden del tipo base abstracto
Array. Todas las matrices implementan IList y IEnumerable. Puede usar la
instrucción foreach para recorrer en iteración una matriz. Las matrices de
dimensión única también implementan IList<T> y IEnumerable<T>.

Comportamiento del valor predeterminado

Para los tipos de valor, los elementos de la matriz se inicializan con el valor
predeterminado, el patrón de 0 bits; los elementos tendrán el valor 0 .
Todos los tipos de referencia (incluidos los que no aceptan valores NULL) tienen
los valores null .
Para los tipos de valor que aceptan valores NULL, HasValue se establece en false ,
y los elementos se establecerán en null .

Matrices como objetos

En C#, las matrices son actualmente objetos, y no simplemente regiones direccionables
de memoria contigua como en C y C++. Array es el tipo base abstracto de todos los
tipos de matriz. Puede usar las propiedades, y otros miembros de clase, que tiene Array.
Un ejemplo de esto sería usar la propiedad Length para obtener la longitud de una
matriz. El código siguiente asigna la longitud de la matriz numbers , que es 5 , a una
variable denominada lengthOfNumbers :

C#

int[] numbers = { 1, 2, 3, 4, 5 };

int lengthOfNumbers = numbers.Length;

La clase Array proporciona muchos otros métodos útiles y propiedades para ordenar,
buscar y copiar matrices. En los ejemplos siguientes se usa la propiedad Rank para
mostrar el número de dimensiones de una matriz.

C#

class TestArraysClass

static void Main()

// Declare and initialize an array.

int[,] theArray = new int[5, 10];

System.Console.WriteLine("The array has {0} dimensions.",

theArray.Rank);

// Output: The array has 2 dimensions.

Vea también
Uso de matrices unidimensionales
Uso de matrices multidimensionales
Uso de matrices escalonadas
Utilizar foreach con matrices
Pasar matrices como argumentos
Matrices con tipo implícito
Guía de programación de C#
Colecciones

Para obtener más información, consulte la Especificación del lenguaje C#. La

especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Matrices unidimensionales (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Cree una matriz unidimensional mediante el operador new; para ello, especifique el tipo
de elemento de matriz y el número de elementos. En el ejemplo siguiente se declara
una matriz de cinco enteros:

C#

int[] array = new int[5];

Esta matriz contiene los elementos de array[0] a array[4] . Los elementos de la matriz
se inicializan en el valor predeterminado del tipo de elemento, 0 para los enteros.

Las matrices pueden almacenar cualquier tipo de elemento que se especifique, como en
el ejemplo siguiente, en el que se declara una matriz de cadenas:

C#

string[] stringArray = new string[6];

Inicialización de matriz
Puede inicializar los elementos de una matriz al declararla. El especificador de longitud
no es necesario porque la medida se infiere a partir del número de elementos de la lista
de inicialización. Por ejemplo:

C#

int[] array1 = new int[] { 1, 3, 5, 7, 9 };

En el código siguiente se muestra una declaración de una matriz de cadenas donde

cada elemento de la matriz se inicializa mediante el nombre de un día:

C#

string[] weekDays = new string[] { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri",
"Sat" };

Puede evitar la expresión new y el tipo de matriz al inicializar una matriz en la

declaración, tal como se muestra en el código siguiente. Esto se conoce como matriz
con tipo implícito:

C#

int[] array2 = { 1, 3, 5, 7, 9 };

string[] weekDays2 = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" };

Puede declarar una variable de matriz sin crearla, pero debe usar el operador new
cuando asigne una nueva matriz a esta variable. Por ejemplo:

C#

int[] array3;

array3 = new int[] { 1, 3, 5, 7, 9 }; // OK

//array3 = {1, 3, 5, 7, 9}; // Error

Matrices de tipo de valor y tipo de referencia

Tenga en cuenta la siguiente declaración de matriz:

C#

SomeType[] array4 = new SomeType[10];

El resultado de esta instrucción depende de si SomeType es un tipo de valor o un tipo de

referencia. Si es un tipo de valor, la instrucción crea una matriz de 10 elementos, y cada
uno de ellos tiene el tipo SomeType . Si SomeType es un tipo de referencia, la instrucción
crea una matriz de 10 elementos y cada uno de ellos se inicializa en una referencia nula.
En ambas instancias, los elementos se inicializan en el valor predeterminado para el tipo
de elemento. Para obtener más información sobre los tipos de valor y de referencia,
consulte Tipos de valor y Tipos de referencia.

Recuperación de datos de una matriz

Puede recuperar los datos de una matriz con un índice. Por ejemplo:

C#

string[] weekDays2 = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" };

 Console.WriteLine(weekDays2[0]);

Console.WriteLine(weekDays2[1]);

Console.WriteLine(weekDays2[2]);

Console.WriteLine(weekDays2[3]);

Console.WriteLine(weekDays2[4]);

Console.WriteLine(weekDays2[5]);

Console.WriteLine(weekDays2[6]);

/*Output:

Sun

Mon

Tue

Wed

Thu

Fri

Sat

*/

Vea también
Array
Matrices
Matrices multidimensionales
Matrices escalonadas
Matrices multidimensionales (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las matrices pueden tener varias dimensiones. Por ejemplo, la siguiente declaración crea
una matriz bidimensional de cuatro filas y dos columnas.

C#

int[,] array = new int[4, 2];

La siguiente declaración crea una matriz de tres dimensiones, 4, 2 y 3.

C#

int[,,] array1 = new int[4, 2, 3];

Inicialización de matriz
La matriz se puede inicializar en la declaración como se muestra en el ejemplo siguiente.

C#

// Two-dimensional array.

int[,] array2D = new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };

// The same array with dimensions specified.

int[,] array2Da = new int[4, 2] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };

// A similar array with string elements.

string[,] array2Db = new string[3, 2] { { "one", "two" }, { "three", "four"

},

{ "five", "six" } };

// Three-dimensional array.

int[,,] array3D = new int[,,] { { { 1, 2, 3 }, { 4, 5, 6 } },

{ { 7, 8, 9 }, { 10, 11, 12 } } };

// The same array with dimensions specified.

int[,,] array3Da = new int[2, 2, 3] { { { 1, 2, 3 }, { 4, 5, 6 } },

{ { 7, 8, 9 }, { 10, 11, 12 } } };

// Accessing array elements.

System.Console.WriteLine(array2D[0, 0]);

System.Console.WriteLine(array2D[0, 1]);

System.Console.WriteLine(array2D[1, 0]);

System.Console.WriteLine(array2D[1, 1]);

System.Console.WriteLine(array2D[3, 0]);

 System.Console.WriteLine(array2Db[1, 0]);

System.Console.WriteLine(array3Da[1, 0, 1]);

System.Console.WriteLine(array3D[1, 1, 2]);

// Getting the total count of elements or the length of a given dimension.

var allLength = array3D.Length;

var total = 1;

for (int i = 0; i < array3D.Rank; i++)

total *= array3D.GetLength(i);

System.Console.WriteLine("{0} equals {1}", allLength, total);

// Output:

// 1

// 2

// 3

// 4

// 7

// three

// 8

// 12

// 12 equals 12

También se puede inicializar la matriz sin especificar el rango.

C#

int[,] array4 = { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };

Si opta por declarar una variable de matriz sin inicializarla, deberá usar el operador new
para asignar una matriz a la variable. El uso de new se muestra en el ejemplo siguiente.

C#

int[,] array5;

array5 = new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } }; // OK

//array5 = {{1,2}, {3,4}, {5,6}, {7,8}}; // Error

En el ejemplo siguiente se asigna un valor a un elemento de matriz determinado.

C#

array5[2, 1] = 25;

De igual forma, en el ejemplo siguiente se obtiene el valor de un elemento de matriz

determinado y se asigna a la variable elementValue .
 C#

int elementValue = array5[2, 1];

El ejemplo de código siguiente inicializa los elementos de matriz con valores

predeterminados (salvo las matrices escalonadas).

C#

int[,] array6 = new int[10, 10];

Vea también
Guía de programación de C#
Matrices
Matrices unidimensionales
Matrices escalonadas
Matrices escalonadas (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Una matriz escalonada es una matriz cuyos elementos son matrices, posiblemente de
diferentes tamaños. A veces, una matriz escalonada se denomina "matriz de matrices".
En los ejemplos siguientes se muestra cómo declarar, inicializar y acceder a matrices
escalonadas.

La siguiente es una declaración de una matriz unidimensional que tiene tres elementos,
cada uno de los cuales es una matriz unidimensional de enteros:

C#

int[][] jaggedArray = new int[3][];

Para poder usar jaggedArray , se deben inicializar sus elementos. Puede inicializar los
elementos de esta forma:

C#

jaggedArray[0] = new int[5];

jaggedArray[1] = new int[4];

jaggedArray[2] = new int[2];

Cada uno de los elementos es una matriz unidimensional de enteros. El primer elemento
es una matriz de 5 enteros, el segundo es una matriz de 4 enteros y el tercero es una
matriz de 2 enteros.

También es posible usar inicializadores para rellenar los elementos de matriz con
valores, en cuyo caso no es necesario el tamaño de la matriz. Por ejemplo:

C#

jaggedArray[0] = new int[] { 1, 3, 5, 7, 9 };

jaggedArray[1] = new int[] { 0, 2, 4, 6 };

jaggedArray[2] = new int[] { 11, 22 };

También puede inicializar la matriz en la declaración de esta forma:

C#
 int[][] jaggedArray2 = new int[][]

new int[] { 1, 3, 5, 7, 9 },

new int[] { 0, 2, 4, 6 },

new int[] { 11, 22 }

};

Puede usar la siguiente forma abreviada. Tenga en cuenta que no puede omitir el
operador new de la inicialización de elementos porque no hay ninguna inicialización
predeterminada para los elementos:

C#

int[][] jaggedArray3 =

new int[] { 1, 3, 5, 7, 9 },

new int[] { 0, 2, 4, 6 },

new int[] { 11, 22 }

};

Una matriz escalonada es una matriz de matrices y, por consiguiente, sus elementos son
tipos de referencia y se inicializan en null .

Puede tener acceso a elementos individuales de la matriz como en estos ejemplos:

C#

// Assign 77 to the second element ([1]) of the first array ([0]):

jaggedArray3[0][1] = 77;

// Assign 88 to the second element ([1]) of the third array ([2]):

jaggedArray3[2][1] = 88;

Es posible mezclar matrices multidimensionales y escalonadas. La siguiente es una

declaración e inicialización de una matriz escalonada unidimensional que contiene tres
elementos de matriz bidimensional de tamaños diferentes. Para obtener más
información, vea Matrices multidimensionales.

C#

int[][,] jaggedArray4 = new int[3][,]

new int[,] { {1,3}, {5,7} },

new int[,] { {0,2}, {4,6}, {8,10} },

new int[,] { {11,22}, {99,88}, {0,9} }

};

Puede tener acceso a los elementos individuales como se muestra en este ejemplo, que
muestra el valor del elemento [1,0] de la primera matriz (valor 5 ):

C#

System.Console.Write("{0}", jaggedArray4[0][1, 0]);

El método Length devuelve el número de matrices contenidos en la matriz escalonada.

Por ejemplo, suponiendo que ha declarado la matriz anterior, esta línea:

C#

System.Console.WriteLine(jaggedArray4.Length);

devuelve un valor de 3.

Ejemplo
En este ejemplo, se crea una matriz cuyos elementos son matrices. Cada uno de los
elementos de matriz tiene un tamaño diferente.

C#

class ArrayTest

static void Main()

// Declare the array of two elements.

int[][] arr = new int[2][];

// Initialize the elements.

arr[0] = new int[5] { 1, 3, 5, 7, 9 };

arr[1] = new int[4] { 2, 4, 6, 8 };

// Display the array elements.

for (int i = 0; i < arr.Length; i++)

System.Console.Write("Element({0}): ", i);

for (int j = 0; j < arr[i].Length; j++)

System.Console.Write("{0}{1}", arr[i][j], j ==
(arr[i].Length - 1) ? "" : " ");

System.Console.WriteLine();

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

 System.Console.ReadKey();
}

/* Output:

Element(0): 1 3 5 7 9

Element(1): 2 4 6 8

*/

Vea también
Array
Guía de programación de C#
Matrices
Matrices unidimensionales
Matrices multidimensionales
Uso de foreach con matrices (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La instrucción foreach ofrece una manera sencilla y limpia de iterar los elementos de
una matriz.

Para matrices unidimensionales, la instrucción foreach procesa los elementos en orden

creciente de índice, comenzando con el índice 0 y terminando con el índice Length - 1 :

C#

int[] numbers = { 4, 5, 6, 1, 2, 3, -2, -1, 0 };

foreach (int i in numbers)

System.Console.Write("{0} ", i);

// Output: 4 5 6 1 2 3 -2 -1 0

En el caso de matrices multidimensionales, los elementos se recorren de tal manera que

primero se incrementan los índices de la dimensión más a la derecha, luego la siguiente
dimensión a la izquierda, y así sucesivamente a la izquierda:

C#

int[,] numbers2D = new int[3, 2] { { 9, 99 }, { 3, 33 }, { 5, 55 } };

// Or use the short form:

// int[,] numbers2D = { { 9, 99 }, { 3, 33 }, { 5, 55 } };

foreach (int i in numbers2D)

System.Console.Write("{0} ", i);

// Output: 9 99 3 33 5 55

En cambio, con las matrices multidimensionales, usar un bucle for anidado ofrece un
mayor control sobre el orden en el que se procesan los elementos de la matriz.

Vea también
Array
Guía de programación de C#
Matrices
Matrices unidimensionales
Matrices multidimensionales
Matrices escalonadas
Pasar matrices como argumentos (Guía
de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las matrices se pueden pasar como argumentos a parámetros de método. Dado que las
matrices son tipos de referencia, el método puede cambiar el valor de los elementos.

Pasar matrices unidimensionales como

argumentos
Puede pasar una matriz unidimensional inicializada a un método. Por ejemplo, la
siguiente instrucción envía una matriz a un método de impresión.

C#

int[] theArray = { 1, 3, 5, 7, 9 };

PrintArray(theArray);

En el siguiente código, se muestra una implementación parcial del método de

impresión.

C#

void PrintArray(int[] arr)

// Method code.

Puede inicializar y pasar una nueva matriz en un solo paso, como se muestra en el
ejemplo siguiente.

C#

PrintArray(new int[] { 1, 3, 5, 7, 9 });

Ejemplo
En el ejemplo siguiente, una matriz de cadenas se inicializa y pasa como un argumento
a un método DisplayArray para cadenas. El método muestra los elementos de la matriz.
A continuación, el método ChangeArray invierte los elementos de la matriz y, después, el
método ChangeArrayElements modifica los tres primeros elementos de la matriz.
Después de cada devolución de método, el método DisplayArray muestra que pasar
una matriz por valor no impide que se cambien los elementos de la matriz.

C#

using System;

class ArrayExample

static void DisplayArray(string[] arr) =>

Console.WriteLine(string.Join(" ", arr));

// Change the array by reversing its elements.

static void ChangeArray(string[] arr) => Array.Reverse(arr);

static void ChangeArrayElements(string[] arr)

// Change the value of the first three array elements.

arr[0] = "Mon";
arr[1] = "Wed";
arr[2] = "Fri";
}

static void Main()

// Declare and initialize an array.

string[] weekDays = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri",

"Sat" };

// Display the array elements.

DisplayArray(weekDays);

Console.WriteLine();

// Reverse the array.

ChangeArray(weekDays);

// Display the array again to verify that it stays reversed.

Console.WriteLine("Array weekDays after the call to ChangeArray:");

DisplayArray(weekDays);

Console.WriteLine();

// Assign new values to individual array elements.

ChangeArrayElements(weekDays);

// Display the array again to verify that it has changed.

Console.WriteLine("Array weekDays after the call to

ChangeArrayElements:");

DisplayArray(weekDays);

// The example displays the following output:

// Sun Mon Tue Wed Thu Fri Sat

//

// Array weekDays after the call to ChangeArray:

// Sat Fri Thu Wed Tue Mon Sun

 //

// Array weekDays after the call to ChangeArrayElements:

// Mon Wed Fri Wed Tue Mon Sun

Pasar matrices multidimensionales como

argumentos
Pase una matriz multidimensional inicializada a un método de la misma manera que
pasa una matriz unidimensional.

C#

int[,] theArray = { { 1, 2 }, { 2, 3 }, { 3, 4 } };

Print2DArray(theArray);

En el código siguiente, se muestra una declaración parcial de un método de impresión

que acepta una matriz bidimensional como su argumento.

C#

void Print2DArray(int[,] arr)

// Method code.

Puede inicializar y pasar una matriz nueva en un solo paso, como se muestra en el
ejemplo siguiente:

C#

Print2DArray(new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } });

Ejemplo
En el ejemplo siguiente, una matriz bidimensional de enteros se inicializa y pasa al
método Print2DArray . El método muestra los elementos de la matriz.

C#

class ArrayClass2D

static void Print2DArray(int[,] arr)

 // Display the array elements.

for (int i = 0; i < arr.GetLength(0); i++)

for (int j = 0; j < arr.GetLength(1); j++)

System.Console.WriteLine("Element({0},{1})={2}", i, j,
arr[i, j]);

static void Main()

// Pass the array as an argument.

Print2DArray(new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } });

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
}

/* Output:

Element(0,0)=1

Element(0,1)=2

Element(1,0)=3

Element(1,1)=4

Element(2,0)=5

Element(2,1)=6

Element(3,0)=7

Element(3,1)=8

*/

Vea también
Guía de programación de C#
Matrices
Matrices unidimensionales
Matrices multidimensionales
Matrices escalonadas
Matrices con asignación implícita de
tipos (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Puede crear una matriz con tipo implícito en la que se deduce el tipo de la instancia de
matriz de los elementos especificados en el inicializador de matriz. Las reglas de
cualquier variable con tipo implícito también se aplican a las matrices con tipo implícito.
Para más información, vea Variables locales con asignación implícita de tipos.

Normalmente, se usan matrices con tipo implícito en expresiones de consulta junto con
tipos anónimos e inicializadores de objeto y colección.

En los ejemplos siguientes, se muestra cómo crear una matriz con tipo implícito:

C#

class ImplicitlyTypedArraySample

static void Main()

var a = new[] { 1, 10, 100, 1000 }; // int[]

var b = new[] { "hello", null, "world" }; // string[]

// single-dimension jagged array

var c = new[]

new[]{1,2,3,4},

new[]{5,6,7,8}

};

// jagged array of strings

var d = new[]

new[]{"Luca", "Mads", "Luke", "Dinesh"},

new[]{"Karen", "Suma", "Frances"}

};

En el ejemplo anterior observe que, con las matrices con tipo implícito, no se usan
corchetes en el lado izquierdo de la instrucción de inicialización. Tenga en cuenta
también que las matrices escalonadas se inicializan mediante new [] al igual que las
matrices unidimensionales.
Matrices con tipo implícito en inicializadores de
objeto
Al crear un tipo anónimo que contiene una matriz, esta debe tener tipo implícito en el
inicializador de objeto del tipo. En el ejemplo siguiente, contacts es una matriz con
tipos implícitos anónimos, cada uno de los cuales contiene una matriz denominada
PhoneNumbers . Tenga en cuenta que la palabra clave var no se usa dentro de los
inicializadores de objeto.

C#

var contacts = new[]

new {

Name = " Eugene Zabokritski",

PhoneNumbers = new[] { "206-555-0108", "425-555-0001" }

},

new {

Name = " Hanying Feng",

PhoneNumbers = new[] { "650-555-0199" }

};

Vea también
Guía de programación de C#
Variables locales con asignación implícita de tipos
Matrices
Tipos anónimos
Inicializadores de objeto y colección
var
LINQ en C#
Cadenas y literales de cadena
Artículo • 10/02/2023 • Tiempo de lectura: 17 minutos

Una cadena es un objeto de tipo String cuyo valor es texto. Internamente, el texto se
almacena como una colección secuencial de solo lectura de objetos Char. No hay
ningún carácter que finalice en NULL al final de una cadena de C#; por lo tanto, la
cadena de C# puede contener cualquier número de caracteres nulos insertados ("\0"). La
propiedad Length de una cadena representa el número de objetos Char que contiene,
no el número de caracteres Unicode. Para obtener acceso a los puntos de código
Unicode individuales de una cadena, use el objeto StringInfo.

cadena frente System.String

En C#, la palabra clave string es un alias de String. Por lo tanto, String y string son
equivalentes, aunque se recomienda usar el alias proporcionado string , ya que
funciona incluso sin using System; . La clase String proporciona muchos métodos para
crear, manipular y comparar cadenas de forma segura. Además, el lenguaje C#
sobrecarga algunos operadores para simplificar las operaciones de cadena comunes.
Para más información sobre la palabra clave, consulte string. Para obtener más
información sobre el tipo y sus métodos, vea String.

Declaración e inicialización de cadenas

Puede declarar e inicializar cadenas de varias maneras, tal como se muestra en el
ejemplo siguiente:

C#

// Declare without initializing.

string message1;

// Initialize to null.

string message2 = null;

// Initialize as an empty string.

// Use the Empty constant instead of the literal "".

string message3 = System.String.Empty;

// Initialize with a regular string literal.

string oldPath = "c:\\Program Files\\Microsoft Visual Studio 8.0";

// Initialize with a verbatim string literal.

string newPath = @"c:\Program Files\Microsoft Visual Studio 9.0";

 // Use System.String if you prefer.

System.String greeting = "Hello World!";

// In local variables (i.e. within a method body)

// you can use implicit typing.

var temp = "I'm still a strongly-typed System.String!";

// Use a const string to prevent 'message4' from

// being used to store another string value.

const string message4 = "You can't get rid of me!";

// Use the String constructor only when creating

// a string from a char*, char[], or sbyte*. See

// System.String documentation for details.

char[] letters = { 'A', 'B', 'C' };

string alphabet = new string(letters);

El operador new no se usa para crear un objeto de cadena, salvo cuando se inicialice la
cadena con una matriz de caracteres.

Inicialice una cadena con el valor constante Empty para crear un objeto String cuya
cadena tenga longitud cero. La representación literal de la cadena de una cadena de
longitud cero es "". Mediante la inicialización de las cadenas con el valor Empty en lugar
de null, puede reducir las posibilidades de que se produzca una excepción
NullReferenceException. Use el método estático IsNullOrEmpty(String) para comprobar
el valor de una cadena antes de intentar obtener acceso a ella.

Inmutabilidad de las cadenas

Los objetos de cadena son inmutables: no se pueden cambiar después de haberse
creado. Todos los métodos String y operadores de C# que parecen modificar una
cadena en realidad devuelven los resultados en un nuevo objeto de cadena. En el
siguiente ejemplo, cuando el contenido de s1 y s2 se concatena para formar una sola
cadena, las dos cadenas originales no se modifican. El operador += crea una nueva
cadena que contiene el contenido combinado. Este nuevo objeto se asigna a la variable
s1 y el objeto original que se asignó a s1 se libera para la recolección de elementos no
utilizados porque ninguna otra variable contiene una referencia a él.

C#

string s1 = "A string is more ";

string s2 = "than the sum of its chars.";

// Concatenate s1 and s2. This actually creates a new

// string object and stores it in s1, releasing the

 // reference to the original object.

s1 += s2;

System.Console.WriteLine(s1);

// Output: A string is more than the sum of its chars.

Dado que una "modificación" de cadena es en realidad una creación de cadena, debe
tener cuidado al crear referencias a las cadenas. Si crea una referencia a una cadena y
después "modifica" la cadena original, la referencia seguirá apuntando al objeto original
en lugar de al objeto nuevo creado al modificarse la cadena. El código siguiente muestra
este comportamiento:

C#

string str1 = "Hello ";

string str2 = str1;

str1 += "World";

System.Console.WriteLine(str2);

//Output: Hello

Para más información acerca de cómo crear cadenas nuevas basadas en modificaciones
como las operaciones de buscar y reemplazar en la cadena original, consulte
Modificación del contenido de cadenas.

Literales de cadena entre comillas

Los literales de cadena entre comillas comienzan y terminan con un solo carácter de
comilla doble ( " ) en la misma línea. Los literales de cadena entre comillas son más
adecuados para las cadenas que caben en una sola línea y no incluyen ninguna
secuencia de escape. Un literal de cadena entre comillas debe insertar caracteres de
escape, como se muestra en el ejemplo siguiente:

C#

string columns = "Column 1\tColumn 2\tColumn 3";

//Output: Column 1 Column 2 Column 3

string rows = "Row 1\r\nRow 2\r\nRow 3";

/* Output:

Row 1

Row 2

Row 3

*/

 string title = "\"The \u00C6olean Harp\", by Samuel Taylor Coleridge";

//Output: "The Æolean Harp", by Samuel Taylor Coleridge

Literales de cadenas literales

Los literales de cadena textual son más adecuados para cadenas de varias líneas,
cadenas que contienen caracteres de barra diagonal inversa o comillas dobles
insertadas. Las cadenas textuales conservan los caracteres de nueva línea como parte
del texto de la cadena. Utilice comillas dobles para insertar una comilla simple dentro de
una cadena textual. En el ejemplo siguiente se muestran algunos usos habituales de las
cadenas textuales:

C#

string filePath = @"C:\Users\scoleridge\Documents\";

//Output: C:\Users\scoleridge\Documents\

string text = @"My pensive SARA ! thy soft cheek reclined

Thus on mine arm, most soothing sweet it is

To sit beside our Cot,...";

/* Output:

My pensive SARA ! thy soft cheek reclined

Thus on mine arm, most soothing sweet it is

To sit beside our Cot,...

*/

string quote = @"Her name was ""Sara.""";

//Output: Her name was "Sara."

Literales de cadena sin formato

A partir de C# 11, puede usar literales de cadena sin formato para crear más fácilmente
cadenas de varias líneas o usar cualquier carácter que requiera secuencias de escape.
Los literales de cadena sin formato eliminan la necesidad de usar secuencias de escape.
Puede escribir la cadena, incluido el formato de espacio en blanco, cómo quiera que
aparezca en la salida. El literal de cadena sin formato:

Comienza y termina con una secuencia de al menos tres caracteres de comilla

doble ( """ ). Se permite que más de tres caracteres consecutivos inicien y terminen
la secuencia con el fin de admitir literales de cadena que contengan tres (o más)
caracteres de comilla repetidos.
Los literales de cadena sin formato de una sola línea requieren los caracteres de
comilla de apertura y cierre en la misma línea.
 Los literales de cadena sin formato de varias líneas requieren que los caracteres de
comilla de apertura y cierre estén en su propia línea.
En los literales de cadena sin formato de varias líneas, los espacios en blanco a la
izquierda de las comillas de cierre se quitan.

En los ejemplos siguientes se muestran estas reglas:

C#

string singleLine = """Friends say "hello" as they pass by.""";

string multiLine = """

"Hello World!" is typically the first program someone writes.

""";

string embeddedXML = """

<element attr = "content">

<body style="normal">

Here is the main text

</body>

<footer>

Excerpts from "An amazing story"

</footer>

</element >

""";

// The line "<element attr = "content">" starts in the first column.

// All whitespace left of that column is removed from the string.

string rawStringLiteralDelimiter = """"

Raw string literals are delimited

by a string of at least three double quotes,

like this: """

"""";

En los ejemplos siguientes se muestran los errores del compilador notificados en

función de estas reglas:

C#

// CS8997: Unterminated raw string literal.

var multiLineStart = """This

is the beginning of a string

""";

// CS9000: Raw string literal delimiter must be on its own line.

var multiLineEnd = """

This is the beginning of a string """;

// CS8999: Line does not start with the same whitespace as the closing line

// of the raw string literal

var noOutdenting = """

A line of text.

 Trying to outdent the second line.

""";

Los dos primeros ejemplos no son válidos porque los literales de cadena sin formato de
varias líneas requieren la secuencia de comillas de apertura y cierre en su propia línea. El
tercer ejemplo no es válido porque se anula la sangría del texto de la secuencia de
comillas de cierre.

Al usar literales de cadena entre comillas o literales de cadena textuales, debe

considerar los literales de cadena sin formato al generar texto que incluya caracteres
que requieran secuencias de escape. Los literales de cadena sin formato serán más
fáciles para todos, ya que se parecerán más al texto de salida. Por ejemplo, considere el
código siguiente que incluye una cadena de JSON con formato:

C#

string jsonString = """

{

"Date": "2019-08-01T00:00:00-07:00",

"TemperatureCelsius": 25,

"Summary": "Hot",

"DatesAvailable": [

"2019-08-01T00:00:00-07:00",

"2019-08-02T00:00:00-07:00"

],

"TemperatureRanges": {

"Cold": {

"High": 20,

"Low": -10

},

"Hot": {

"High": 60,

"Low": 20

},

"SummaryWords": [

"Cool",

"Windy",

"Humid"

""";

Compare ese texto con el texto equivalente de nuestro ejemplo de serialización JSON,
que no usa esta nueva característica.

Secuencias de escape de cadena

Secuencia Nombre de carácter Codificación Unicode
de escape

\' Comilla simple 0x0027

\" Comilla doble 0x0022

\\ Barra diagonal inversa 0x005C

\0 Null 0x0000

\a Alerta 0x0007

\b Retroceso 0x0008

\f Avance de página 0x000C

\n Nueva línea 0x000A

\r Retorno de carro 0x000D

\t Tabulación horizontal 0x0009

\v Tabulación vertical 0x000B

\u Secuencia de escape Unicode (UTF-16) \uHHHH (intervalo: 0000 - FFFF; ejemplo:

\u00E7 = "ç")

\U Secuencia de escape Unicode (UTF-32) \U00HHHHHH (intervalo: 000000 - 10FFFF;

ejemplo: \U0001F47D = "👽")

\x Secuencia de escape Unicode similar a \xH[H][H][H] (intervalo: 0 - FFFF;

"\u" excepto con longitud variable ejemplo: \x00E7 o \x0E7 o \xE7 = "ç")

２ Advertencia

Cuando se usa la secuencia de escape \x y se especifican menos de 4 dígitos

hexadecimales, si los caracteres que van inmediatamente después de la secuencia
de escape son dígitos hexadecimales válidos (es decir, 0-9, A-f y a-f), se interpretará
que forman parte de la secuencia de escape. Por ejemplo, \xA1 genera "¡", que es
el punto de código U+00A1. Sin embargo, si el carácter siguiente es "A" o "a", la
secuencia de escape se interpretará entonces como \xA1A y producirá "ਚ", que es
el punto de código U+0A1A. En casos así, se pueden especificar los 4 dígitos
hexadecimales (por ejemplo, \x00A1 ) para evitar posibles errores de interpretación.

７ Nota
 En tiempo de compilación, las cadenas textuales se convierten en cadenas
normales con las mismas secuencias de escape. Por lo tanto, si se muestra una
cadena textual en la ventana Inspección del depurador, verá los caracteres de
escape agregados por el compilador, no la versión textual del código fuente. Por
ejemplo, la cadena textual @"C:\files.txt" aparecerá en la ventana de inspección
como "C:\files.txt".

Cadenas de formato
Una cadena de formato es una cadena cuyo contenido se determina de manera
dinámica en tiempo de ejecución. Las cadenas de formato se crean mediante la
inserción de expresiones interpoladas o marcadores de posición entre llaves dentro de
una cadena. Todo lo incluido entre llaves ( {...} ) se resolverá en un valor y se generará
como una cadena con formato en tiempo de ejecución. Existen dos métodos para crear
cadenas de formato: interpolación de cadenas y formato compuesto.

Interpolación de cadenas
Disponible en C# 6.0 y versiones posteriores, las cadenas interpoladas se identifican por
el carácter especial $ e incluyen expresiones interpoladas entre llaves. Si no está
familiarizado con la interpolación de cadenas, consulte el tutorial interactivo
Interpolación de cadenas en C# para obtener información general rápidamente.

Use la interpolación de cadenas para mejorar la legibilidad y el mantenimiento del

código. Con la interpolación de cadenas se obtienen los mismos resultados que con el
método String.Format , pero mejora la facilidad de uso y la claridad en línea.

C#

var jh = (firstName: "Jupiter", lastName: "Hammon", born: 1711, published:

1761);

Console.WriteLine($"{jh.firstName} {jh.lastName} was an African American

poet born in {jh.born}.");

Console.WriteLine($"He was first published in {jh.published} at the age of

{jh.published - jh.born}.");

Console.WriteLine($"He'd be over {Math.Round((2018d - jh.born) / 100d) *

100d} years old today.");

// Output:

// Jupiter Hammon was an African American poet born in 1711.

// He was first published in 1761 at the age of 50.

// He'd be over 300 years old today.

A partir de C# 10, se puede utilizar la interpolación de cadenas para inicializar una

cadena constante cuando todas las expresiones utilizadas para los marcadores de
posición son también cadenas constantes.

A partir de C# 11, puede combinar literales de cadena sin formato con interpolaciones
de cadenas. La cadena de formato se inicia y termina con tres o más comillas dobles
sucesivas. Si la cadena de salida debe contener el carácter { o } , puede usar caracteres
$ adicionales para especificar cuántos caracteres { y } comienzan y terminan una
interpolación. Todas las secuencias de menos caracteres { o } se incluye en la salida. En
el ejemplo siguiente se muestra cómo puede usar esa característica para mostrar la
distancia de un punto desde el origen y colocar el punto entre llaves:

C#

int X = 2;

int Y = 3;

var pointMessage = $$"""The point {{{X}}, {{Y}}} is {{Math.Sqrt(X * X + Y *

Y)}} from the origin.""";

Console.WriteLine(pointMessage);

// Output:

// The point {2, 3} is 3.605551275463989 from the origin.

Formatos compuestos
String.Format emplea marcadores de posición entre llaves para crear una cadena de
formato. Los resultados de este ejemplo son similares a la salida del método de
interpolación de cadenas usado anteriormente.

C#

var pw = (firstName: "Phillis", lastName: "Wheatley", born: 1753, published:

1773);

Console.WriteLine("{0} {1} was an African American poet born in {2}.",

pw.firstName, pw.lastName, pw.born);

Console.WriteLine("She was first published in {0} at the age of {1}.",

pw.published, pw.published - pw.born);

Console.WriteLine("She'd be over {0} years old today.", Math.Round((2018d -

pw.born) / 100d) * 100d);

// Output:

// Phillis Wheatley was an African American poet born in 1753.

// She was first published in 1773 at the age of 20.

// She'd be over 300 years old today.

Para más información sobre cómo dar formato a los tipos .NET, consulte Aplicación de
formato a tipos en .NET.

Subcadenas
Una subcadena es cualquier secuencia de caracteres que se encuentra en una cadena.
Use el método Substring para crear una nueva cadena de una parte de la cadena
original. Puede buscar una o más apariciones de una subcadena con el método IndexOf.
Use el método Replace para reemplazar todas las apariciones de una subcadena
especificada por una nueva cadena. Al igual que el método Substring, Replace devuelve
en realidad una cadena nueva y no modifica la cadena original. Para más información,
consulte Cómo: Buscar cadenas y Procedimiento para modificar el contenido de
cadenas.

C#

string s3 = "Visual C# Express";

System.Console.WriteLine(s3.Substring(7, 2));

// Output: "C#"

System.Console.WriteLine(s3.Replace("C#", "Basic"));

// Output: "Visual Basic Express"

// Index values are zero-based

int index = s3.IndexOf("C");

// index = 7

Acceso a caracteres individuales

Puede utilizar la notación de matriz con un valor de índice para adquirir acceso de solo
lectura a caracteres individuales, como en el ejemplo siguiente:

C#

string s5 = "Printing backwards";

for (int i = 0; i < s5.Length; i++)

System.Console.Write(s5[s5.Length - i - 1]);

// Output: "sdrawkcab gnitnirP"

Si el método String no proporciona la funcionalidad que debe tener para modificar los
caracteres individuales de una cadena, puede usar un objeto StringBuilder para
modificar los caracteres individuales "en contexto" y, después, crear una cadena para
almacenar los resultados mediante el método StringBuilder. En el ejemplo siguiente, se
supone que debe modificar la cadena original de una manera determinada y, después,
almacenar los resultados para un uso futuro:

C#

string question = "hOW DOES mICROSOFT wORD DEAL WITH THE cAPS lOCK KEY?";

System.Text.StringBuilder sb = new System.Text.StringBuilder(question);

for (int j = 0; j < sb.Length; j++)

if (System.Char.IsLower(sb[j]) == true)

sb[j] = System.Char.ToUpper(sb[j]);

else if (System.Char.IsUpper(sb[j]) == true)

sb[j] = System.Char.ToLower(sb[j]);

// Store the new string.

string corrected = sb.ToString();

System.Console.WriteLine(corrected);

// Output: How does Microsoft Word deal with the Caps Lock key?

Cadenas nulas y cadenas vacías

Una cadena vacía es una instancia de un objeto System.String que contiene cero
caracteres. Las cadenas vacías se utilizan a menudo en distintos escenarios de
programación para representar un campo de texto en blanco. Puede llamar a métodos
en cadenas vacías porque son objetos System.String válidos. Las cadenas vacías se
inicializan como sigue:

C#

string s = String.Empty;

En cambio, una cadena nula no hace referencia a una instancia de un objeto

System.String y cualquier intento de llamar a un método en una cadena nula produce
una excepción NullReferenceException. Sin embargo, puede utilizar cadenas nulas en
operaciones de comparación y concatenación con otras cadenas. En los ejemplos
siguientes se muestran algunos casos en que una referencia a una cadena nula provoca
y no provoca una excepción:

C#

string str = "hello";

string nullStr = null;

 string emptyStr = String.Empty;

string tempStr = str + nullStr;

// Output of the following line: hello

Console.WriteLine(tempStr);

bool b = (emptyStr == nullStr);

// Output of the following line: False

Console.WriteLine(b);

// The following line creates a new empty string.

string newStr = emptyStr + nullStr;

// Null strings and empty strings behave differently. The following

// two lines display 0.

Console.WriteLine(emptyStr.Length);

Console.WriteLine(newStr.Length);
// The following line raises a NullReferenceException.

//Console.WriteLine(nullStr.Length);

// The null character can be displayed and counted, like other chars.

string s1 = "\x0" + "abc";

string s2 = "abc" + "\x0";

// Output of the following line: * abc*

Console.WriteLine("*" + s1 + "*");

// Output of the following line: *abc *

Console.WriteLine("*" + s2 + "*");

// Output of the following line: 4

Console.WriteLine(s2.Length);

Uso de stringBuilder para la creación rápida de

cadenas
Las operaciones de cadena en .NET están muy optimizadas y en la mayoría de los casos
no afectan significativamente al rendimiento. Sin embargo, en algunos escenarios, como
los bucles de pequeñas dimensiones que se ejecutan cientos o miles de veces, las
operaciones de cadena pueden afectar al rendimiento. La clase StringBuilder crea un
búfer de cadena que proporciona un mejor rendimiento si el programa realiza muchas
manipulaciones de cadenas. La cadena StringBuilder también permite reasignar
caracteres individuales, algo que el tipo de datos de cadena integrado no admite. Por
ejemplo, este código cambia el contenido de una cadena sin crear una nueva:

C#

System.Text.StringBuilder sb = new System.Text.StringBuilder("Rat: the ideal

pet");

sb[0] = 'C';

 System.Console.WriteLine(sb.ToString());

//Outputs Cat: the ideal pet

En este ejemplo, se usa un objeto StringBuilder para crear una cadena a partir de un
conjunto de tipos numéricos:

C#

var sb = new StringBuilder();

// Create a string composed of numbers 0 - 9

for (int i = 0; i < 10; i++)

sb.Append(i.ToString());

Console.WriteLine(sb); // displays 0123456789

// Copy one character of the string (not possible with a System.String)

sb[0] = sb[9];

Console.WriteLine(sb); // displays 9123456789

Cadenas, métodos de extensión y LINQ

Dado que el tipo String implementa IEnumerable<T>, puede usar los métodos de
extensión definidos en la clase Enumerable en cadenas. Para evitar el desorden visual,
estos métodos se excluyen de IntelliSense para el tipo String, pero aun así están
disponibles. También puede usar expresiones de consulta LINQ en cadenas. Para más
información, consulte LINQ y cadenas.

Artículos relacionados
En Modificación del contenido de las cadenas se muestran técnicas para
transformar las cadenas y modificar su contenido.
En Comparación de cadenas se muestra cómo realizar comparaciones ordinales y
culturales específicas de las cadenas.
En Concatenación de varias cadenasse muestran diversas formas de combinar
varias cadenas en una.
Análisis de cadenas mediante String.Split: contiene ejemplos de código que
muestran cómo usar el método String.Split para analizar cadenas.
En Búsqueda de cadenas se explica cómo usar la búsqueda con texto o patrones
específicos de las cadenas.
En Determinación de si una cadena representa un valor numérico se muestra cómo
analizar de forma segura una cadena para ver si tiene un valor numérico válido.
En Interpolación de cadenas se describe la característica de interpolación de
cadenas que proporciona una sintaxis adecuada para dar formato a las cadenas.
En Operaciones básicas de cadenas se proporcionan vínculos a artículos que usan
los métodos System.String y System.Text.StringBuilder para realizar operaciones
básicas de cadenas.
En Análisis de cadenas se describe cómo convertir representaciones de cadenas de
tipos base de .NET en instancias de los tipos correspondientes.
En Análisis de cadenas de fecha y hora en .NET se muestra cómo convertir una
cadena, como "01/24/2008", en un objeto System.DateTime.
En Comparación de cadenas se incluye información sobre cómo comparar cadenas
y se proporcionan ejemplos de C# y Visual Basic.
En Uso de la clase StringBuilder se describe cómo crear y modificar objetos de
cadena dinámicos con la clase StringBuilder.
En LINQ y cadenas se proporciona información sobre cómo realizar varias
operaciones de cadena utilizando consultas LINQ.
Procedimiento Determinar si una
cadena representa un valor numérico
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Para determinar si una cadena es una representación válida de un tipo numérico

especificado, use el método estático TryParse implementado por todos los tipos
numéricos primitivos y también por tipos como DateTime y IPAddress. En el ejemplo
siguiente se muestra cómo determinar si "108" es un valor int válido.

C#

int i = 0;

string s = "108";

bool result = int.TryParse(s, out i); //i now = 108

Si la cadena contiene caracteres no numéricos o el valor numérico es demasiado grande

o demasiado pequeño para el tipo determinado que ha especificado, TryParse devuelve
el valor false y establece el parámetro out en cero. De lo contrario, devuelve el valor true
y establece el parámetro out en el valor numérico de la cadena.

７ Nota

Una cadena puede contener solamente caracteres numéricos pero no ser válida
para el tipo cuyo método TryParse se está usando. Por ejemplo, "256" no es un
valor válido para byte pero sí para int . "98,6" no es un valor válido para int pero
sí para decimal .

Ejemplo
En los ejemplos siguientes se muestra cómo usar TryParse con representaciones de
cadena de los valores long , byte y decimal .

C#

string numString = "1287543"; //"1287543.0" will return false for a long

long number1 = 0;

bool canConvert = long.TryParse(numString, out number1);

 if (canConvert == true)

Console.WriteLine("number1 now = {0}", number1);

else

Console.WriteLine("numString is not a valid long");

byte number2 = 0;

numString = "255"; // A value of 256 will return false

canConvert = byte.TryParse(numString, out number2);

if (canConvert == true)

Console.WriteLine("number2 now = {0}", number2);

else

Console.WriteLine("numString is not a valid byte");

decimal number3 = 0;

numString = "27.3"; //"27" is also a valid decimal

canConvert = decimal.TryParse(numString, out number3);

if (canConvert == true)

Console.WriteLine("number3 now = {0}", number3);

else

Console.WriteLine("number3 is not a valid decimal");

Programación sólida
Los tipos numéricos primitivos también implementan el método estático Parse , que
produce una excepción si la cadena no es un número válido. TryParse es, en general,
más eficaz porque simplemente devuelve false si el número no es válido.

Seguridad de .NET
Use siempre los métodos TryParse o Parse para validar los datos proporcionados por
el usuario en controles como cuadros de texto y cuadros combinados.

Vea también
Procedimiento Convertir una matriz de bytes en un valor int
Procedimiento Convertir una cadena en un número
Procedimiento Convertir cadenas hexadecimales en tipos numéricos
Análisis de cadenas numéricas
Aplicación de formato a tipos
Indizadores (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Los indizadores permiten indizar las instancias de una clase o struct como matrices. El
valor indizado se puede establecer o recuperar sin especificar explícitamente un
miembro de tipo o de instancia. Son similares a propiedades, excepto en que sus
descriptores de acceso usan parámetros.

En el ejemplo siguiente se define una clase genérica con métodos de descriptor de

acceso get y set sencillos para asignar y recuperar valores. La clase Program crea una
instancia de esta clase para almacenar cadenas.

C#

using System;

class SampleCollection<T>

// Declare an array to store the data elements.

private T[] arr = new T[100];

// Define the indexer to allow client code to use [] notation.

public T this[int i]

get { return arr[i]; }

set { arr[i] = value; }

class Program

static void Main()

var stringCollection = new SampleCollection<string>();

stringCollection[0] = "Hello, World";

Console.WriteLine(stringCollection[0]);

// The example displays the following output:

// Hello, World.

７ Nota

Para obtener más ejemplos, vea Secciones relacionadas.

Definiciones de cuerpos de expresión
Es habitual que un descriptor de acceso get o set de un indizador conste de una única
instrucción que devuelve o establece un valor. Los miembros con forma de expresión
proporcionan una sintaxis simplificada para admitir este escenario. A partir de C# 6, un
indizador de solo lectura puede implementarse como un miembro con forma de
expresión, como se muestra en el ejemplo siguiente.

C#

using System;

class SampleCollection<T>

// Declare an array to store the data elements.

private T[] arr = new T[100];

int nextIndex = 0;

// Define the indexer to allow client code to use [] notation.

public T this[int i] => arr[i];

public void Add(T value)

if (nextIndex >= arr.Length)

throw new IndexOutOfRangeException($"The collection can hold only

{arr.Length} elements.");

arr[nextIndex++] = value;

class Program

static void Main()

var stringCollection = new SampleCollection<string>();

stringCollection.Add("Hello, World");

System.Console.WriteLine(stringCollection[0]);

// The example displays the following output:

// Hello, World.

Tenga en cuenta que => presenta el cuerpo de la expresión y que la palabra clave get
no se utiliza.

A partir de C# 7.0, los descriptores de acceso get y set se pueden implementar como
miembros con forma de expresión. En este caso, sí deben utilizarse las palabras clave
get y set . Por ejemplo:
 C#

using System;

class SampleCollection<T>

// Declare an array to store the data elements.

private T[] arr = new T[100];

// Define the indexer to allow client code to use [] notation.

public T this[int i]

get => arr[i];

set => arr[i] = value;

class Program

static void Main()

var stringCollection = new SampleCollection<string>();

stringCollection[0] = "Hello, World.";

Console.WriteLine(stringCollection[0]);

// The example displays the following output:

// Hello, World.

Información general sobre los indizadores

Los indizadores permiten indizar objetos de manera similar a como se hace con las
matrices.

Un descriptor de acceso get devuelve un valor. Un descriptor de acceso set

asigna un valor.

La palabra clave this se usa para definir los indizadores.

La palabra clave value se usa para definir el valor que va a asignar el descriptor de
acceso set .

Los indizadores no tienen que ser indizados por un valor entero; depende de usted
cómo definir el mecanismo de búsqueda concreto.

Los indizadores se pueden sobrecargar.

 Los indizadores pueden tener más de un parámetro formal, por ejemplo, al tener
acceso a una matriz bidimensional.

Secciones relacionadas
Utilizar indizadores

Indizadores en Interfaces

Comparación entre propiedades e indizadores

Restringir la accesibilidad del descriptor de acceso

Especificación del lenguaje C#

Para obtener más información, vea la sección Indizadores de Especificación del lenguaje
C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Guía de programación de C#
Propiedades
Uso de indizadores (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Los indizadores son una comodidad sintáctica que le permiten crear una clase,
estructura o interfaz a la que las aplicaciones cliente pueden acceder como una matriz.
El compilador generará una propiedad Item (o una propiedad con otro nombre si está
presente IndexerNameAttribute) y los métodos de descriptor de acceso adecuados. Los
indexadores se implementan con más frecuencia en tipos cuyo propósito principal
consiste en encapsular una matriz o colección interna. Por ejemplo, imagine que tiene
una clase TempRecord que representa la temperatura en grados Fahrenheit que se
registra en 10 momentos diferentes durante un período de 24 horas. La clase contiene
una matriz temps de tipo float[] para almacenar los valores de temperatura. Si
implementa un indizador en esta clase, los clientes pueden tener acceso a las
temperaturas en una instancia de TempRecord como float temp = tempRecord[4] en
lugar de como float temp = tempRecord.temps[4] . La notación del indizador no solo
simplifica la sintaxis para las aplicaciones cliente; también hace que la clase y su
finalidad sean más intuitivas para que otros desarrolladores las entiendan.

Para declarar un indizador en una clase o un struct, use la palabra clave this, como en
este ejemplo:

C#

// Indexer declaration

public int this[int index]

// get and set accessors

） Importante

Al declarar un indizador, se generará automáticamente una propiedad denominada

Item en el objeto. No se puede acceder directamente a la propiedad Item desde la

instancia de expresión de acceso a miembros. Además, si agrega una propiedad

Item propia a un objeto con un indizador, obtendrá un error del compilador
CS0102. Para evitar este error, use IndexerNameAttribute para cambiar el nombre
del indizador como se detalla a continuación.
Comentarios
Los tipos de un indexador y de sus parámetros deben ser al menos igual de accesibles
que el propio indexador. Para obtener más información sobre los niveles de
accesibilidad, vea Modificadores de acceso.

Para obtener más información sobre cómo usar los indexadores con una interfaz, vea
Indizadores en interfaces.

La firma de un indexador consta del número y los tipos de sus parámetros formales. No
incluye el tipo de indizador ni los nombres de los parámetros formales. Si declara más
de un indexador en la misma clase, deben tener firmas diferentes.

Un indexador no se clasifica como una variable; por lo tanto, un valor de indexador no

se puede pasar por referencia (como un parámetro ref o out) a menos que su valor sea
una referencia (es decir, se devuelve por referencia).

Para proporcionar el indizador con un nombre que puedan usar otros lenguajes, use
System.Runtime.CompilerServices.IndexerNameAttribute, como se muestra en el
ejemplo siguiente:

C#

// Indexer declaration

[System.Runtime.CompilerServices.IndexerName("TheItem")]
public int this[int index]

// get and set accessors

Este indizador tendrá el nombre TheItem , ya que lo reemplaza el atributo de nombre del
indizador. De forma predeterminada, el nombre del indizador es Item .

Ejemplo 1
En el ejemplo siguiente, se muestra cómo declarar un campo de matriz privada, temps ,
como un indexador. El indexador permite el acceso directo a la instancia tempRecord[i] .
La alternativa a usar el indexador es declarar la matriz como un miembro public y tener
acceso directamente a sus miembros tempRecord.temps[i] .

C#

public class TempRecord

{

 // Array of temperature values

float[] temps = new float[10]

56.2F, 56.7F, 56.5F, 56.9F, 58.8F,

61.3F, 65.9F, 62.1F, 59.2F, 57.5F

};

// To enable client code to validate input

// when accessing your indexer.

public int Length => temps.Length;

// Indexer declaration.

// If index is out of range, the temps array will throw the exception.

public float this[int index]

get => temps[index];

set => temps[index] = value;

Tenga en cuenta que, cuando se evalúa el acceso de un indexador (por ejemplo, en una
instrucción Console.Write ), se invoca al descriptor de acceso get. Por tanto, si no hay
ningún descriptor de acceso get , se produce un error en tiempo de compilación.

C#

class Program

static void Main()

var tempRecord = new TempRecord();

// Use the indexer's set accessor

tempRecord[3] = 58.3F;

tempRecord[5] = 60.1F;

// Use the indexer's get accessor

for (int i = 0; i < 10; i++)

Console.WriteLine($"Element #{i} = {tempRecord[i]}");

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Element #0 = 56.2

Element #1 = 56.7

Element #2 = 56.5

Element #3 = 58.3

Element #4 = 58.8

 Element #5 = 60.1

Element #6 = 65.9

Element #7 = 62.1

Element #8 = 59.2

Element #9 = 57.5

*/

Indexación con otros valores

C# no limita el tipo de parámetro indizador a un entero. Por ejemplo, puede ser útil usar
una cadena con un indexador. Este tipo de indexador podría implementarse al buscar la
cadena de la colección y devolver el valor adecuado. Como los descriptores de acceso
se pueden sobrecargar, pueden coexistir las versiones de cadena y entero.

Ejemplo 2
En el ejemplo siguiente se declara una clase que almacena los días de la semana. Un
descriptor de acceso get toma una cadena, el nombre de un día, y devuelve el entero
correspondiente. Por ejemplo, "Sunday" devuelve 0, "Monday" devuelve 1 y así
sucesivamente.

C#

// Using a string as an indexer value

class DayCollection

string[] days = { "Sun", "Mon", "Tues", "Wed", "Thurs", "Fri", "Sat" };

// Indexer with only a get accessor with the expression-bodied

definition:

public int this[string day] => FindDayIndex(day);

private int FindDayIndex(string day)

for (int j = 0; j < days.Length; j++)

if (days[j] == day)

return j;

throw new ArgumentOutOfRangeException(

nameof(day),

$"Day {day} is not supported.\nDay input must be in the form

\"Sun\", \"Mon\", etc");

Ejemplo de consumo 2
C#

class Program

static void Main(string[] args)

var week = new DayCollection();

Console.WriteLine(week["Fri"]);

try

Console.WriteLine(week["Made-up day"]);

catch (ArgumentOutOfRangeException e)

Console.WriteLine($"Not supported input: {e.Message}");

// Output:

// 5

// Not supported input: Day Made-up day is not supported.

// Day input must be in the form "Sun", "Mon", etc (Parameter 'day')

Ejemplo 3
En el ejemplo siguiente se declara una clase que almacena los días de la semana
mediante la enumeración System.DayOfWeek. Un descriptor de acceso get toma un
valor DayOfWeek , el nombre de un día, y devuelve el entero correspondiente. Por
ejemplo, DayOfWeek.Sunday devuelve 0, DayOfWeek.Monday devuelve 1, y así
sucesivamente.

C#

using Day = System.DayOfWeek;

class DayOfWeekCollection

Day[] days =

Day.Sunday, Day.Monday, Day.Tuesday, Day.Wednesday,

Day.Thursday, Day.Friday, Day.Saturday

 };

// Indexer with only a get accessor with the expression-bodied

definition:

public int this[Day day] => FindDayIndex(day);

private int FindDayIndex(Day day)

for (int j = 0; j < days.Length; j++)

if (days[j] == day)

return j;

throw new ArgumentOutOfRangeException(

nameof(day),

$"Day {day} is not supported.\nDay input must be a defined

System.DayOfWeek value.");

Ejemplo de consumo 3
C#

class Program

static void Main()

var week = new DayOfWeekCollection();

Console.WriteLine(week[DayOfWeek.Friday]);

try

Console.WriteLine(week[(DayOfWeek)43]);

catch (ArgumentOutOfRangeException e)

Console.WriteLine($"Not supported input: {e.Message}");

// Output:

// 5

// Not supported input: Day 43 is not supported.

// Day input must be a defined System.DayOfWeek value. (Parameter 'day')

Programación sólida
Hay dos formas principales en que se pueden mejorar la seguridad y confiabilidad de
los indexadores:

Asegúrese de incorporar algún tipo de estrategia de control de errores para

controlar la posibilidad de que el código de cliente pase un valor de índice no
válido. En el primer ejemplo de este tema, la clase TempRecord proporciona una
propiedad Length que permite al código de cliente comprobar la entrada antes de
pasarla al indexador. También puede colocar el código de control de errores en el
propio indexador. Asegúrese de documentar para los usuarios cualquier excepción
que se produzca dentro de un descriptor de acceso del indexador.

Establezca la accesibilidad de los descriptores de acceso get and set para que sea
tan restrictiva como razonable. Esto es importante para el descriptor de acceso
set en particular. Para más información, vea Restringir la accesibilidad del
descriptor de acceso.

Vea también
Guía de programación de C#
Indizadores
Propiedades
Indizadores en interfaces (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los indexadores se pueden declarar en una interfaz. Los descriptores de acceso de los
indexadores de interfaz se diferencian de los descriptores de acceso de los indexadores
de clase de las maneras siguientes:

Los descriptores de acceso de interfaz no usan modificadores.

Normalmente, un descriptor de acceso de interfaz no tiene un cuerpo.

El propósito del descriptor de acceso es indicar si el indizador es de lectura y escritura,

de solo lectura o de solo escritura. Puede proporcionar una implementación para un
indizador definido en una interfaz, pero esto es poco frecuente. Los indizadores suelen
definir una API para acceder a los campos de datos y los campos de datos no se pueden
definir en una interfaz.

A continuación tiene un ejemplo de un descriptor de acceso de indexador de interfaz:

C#

public interface ISomeInterface

//...

// Indexer declaration:

string this[int index]

get;

set;

La firma de un indexador debe ser diferente de las firmas de los demás indexadores
declarados en la misma interfaz.

Ejemplo
En el siguiente ejemplo, se muestra cómo implementar indexadores de interfaz.

C#

// Indexer on an interface:

public interface IIndexInterface

// Indexer declaration:

int this[int index]

get;

set;

// Implementing the interface.

class IndexerClass : IIndexInterface

private int[] arr = new int[100];

public int this[int index] // indexer declaration

// The arr object will throw IndexOutOfRange exception.

get => arr[index];

set => arr[index] = value;

C#

IndexerClass test = new IndexerClass();

System.Random rand = System.Random.Shared;

// Call the indexer to initialize its elements.

for (int i = 0; i < 10; i++)

test[i] = rand.Next();

for (int i = 0; i < 10; i++)

System.Console.WriteLine($"Element #{i} = {test[i]}");

/* Sample output:

Element #0 = 360877544

Element #1 = 327058047

Element #2 = 1913480832

Element #3 = 1519039937

Element #4 = 601472233

Element #5 = 323352310

Element #6 = 1422639981

Element #7 = 1797892494

Element #8 = 875761049

Element #9 = 393083859

*/

En el ejemplo anterior, podría usar la implementación del miembro de interfaz explícita

al usar el nombre completo del miembro de interfaz. Por ejemplo

C#
 string IIndexInterface.this[int index]

En cambio, el nombre completo solo es necesario para evitar la ambigüedad cuando la

clase implementa más de una interfaz con la misma firma de indexador. Por ejemplo, si
una clase Employee implementa dos interfaces ICitizen y IEmployee y ambas interfaces
tienen la misma firma de indexador, la implementación del miembro de interfaz explícita
es necesaria. Es decir, la siguiente declaración de indexador:

C#

string IEmployee.this[int index]

implementa el indexador en la interfaz IEmployee , mientras que la siguiente declaración:

C#

string ICitizen.this[int index]

implementa el indexador en la interfaz ICitizen .

Vea también
Guía de programación de C#
Indizadores
Propiedades
Interfaces
Comparación entre propiedades e
indizadores (Guía de programación de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los indexadores son como propiedades. Excepto por las diferencias que se muestran en
la tabla siguiente, todas las reglas que se definen para los descriptores de acceso de
propiedad se aplican también a los descriptores de acceso de indexador.

Propiedad. Indexador

Permite que los métodos se llamen Permite que se pueda tener acceso a los elementos de una
como si fueran miembros de datos colección interna de un objeto mediante la notación de
públicos. matriz en el propio objeto.

Se ha tenido acceso mediante un Se ha tenido acceso mediante un índice.

nombre simple.

Puede ser un miembro de Debe ser un miembro de instancia.

instancia o estático.

Un descriptor de acceso get de Un descriptor de acceso get de un indexador tiene la

una propiedad no tiene misma lista de parámetros formales que el indexador.
parámetros.

Un descriptor de acceso set de una Un descriptor de acceso set de un indexador tiene la

propiedad contiene el parámetro misma lista de parámetros formales que el indexador, y
value implícito. también para el parámetro value.

Admite la sintaxis abreviada con Admite miembros de cuerpo de expresión para obtener solo
Propiedades autoimplementadas. indexadores.

Consulte también
Guía de programación de C#
Indizadores
Propiedades
Eventos (Guía de programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

Cuando ocurre algo interesante, los eventos habilitan una clase u objeto para notificarlo
a otras clases u objetos. La clase que envía (o genera) el evento recibe el nombre de
publicador y las clases que reciben (o controlan) el evento se denominan suscriptores.

En una aplicación web o una aplicación de Windows Forms en C# típica, se puede

suscribir a eventos generados por controles, como botones y cuadros de lista. Puede
usar el entorno de desarrollo integrado (IDE) de Visual C# para examinar los eventos
que publica un control y seleccionar los que quiera administrar. El IDE proporciona una
forma sencilla de agregar automáticamente un método de controlador de eventos vacío
y el código para suscribirse al evento. Para obtener más información, vea Procedimiento
para suscribir y cancelar la suscripción a eventos.

Información general sobre eventos

Los eventos tienen las siguientes propiedades:

El publicador determina el momento en el que se genera un evento; los

suscriptores determinan la acción que se lleva a cabo en respuesta al evento.

Un evento puede tener varios suscriptores. Un suscriptor puede controlar varios

eventos de varios publicadores.

Nunca se generan eventos que no tienen suscriptores.

Los eventos se suelen usar para indicar acciones del usuario, como los clics de los
botones o las selecciones de menú en las interfaces gráficas de usuario.

Cuando un evento tiene varios suscriptores, los controladores de eventos se

invocan sincrónicamente cuando se genera un evento. Para invocar eventos de
forma asincrónica, consulte Llamar a métodos sincrónicos de forma asincrónica.

En la biblioteca de clases de .NET, los eventos se basan en el delegado

EventHandler y en la clase base EventArgs.

Secciones relacionadas
Para obtener más información, consulte:

Procedimiento para suscribir y cancelar la suscripción a eventos

 Procedimiento para publicar eventos que cumplan las instrucciones de .NET

Procedimiento para generar eventos de una clase base en clases derivadas

Procedimiento para implementar eventos de interfaz

Procedimiento para implementar descriptores de acceso de eventos

personalizados

Especificación del lenguaje C#

Para obtener más información, consulte la sección Eventos de Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.

Capítulos destacados del libro

Delegates, Events, and Lambda Expressions (Delegados, eventos y expresiones lambda)
en C# 3.0 Cookbook, Tercera edición: More than 250 solutions for C# 3.0 programmers
(Más de 250 soluciones para programadores de C# 3.0)

Delegates and Events (Delegados y eventos) en Learning C# 3.0: Fundamentals of C# 3.0

Consulte también
EventHandler
Guía de programación de C#
Delegados
Crear controladores de eventos en Windows Forms
Procedimiento Suscribir y cancelar la
suscripción a eventos (Guía de
programación de C#)
Artículo • 10/03/2023 • Tiempo de lectura: 3 minutos

La suscripción a un evento publicado por otra clase se realiza cuando quiere escribir
código personalizado al que se llama cuando se produce ese evento. Por ejemplo,
puede suscribirse al evento click de un botón para que la aplicación realice alguna
operación cuando el usuario haga clic en el botón.

Para suscribirse a eventos mediante el IDE de Visual

Studio
1. Si no puede ver la ventana Propiedades, en la vista Diseño haga clic con el botón
derecho en el formulario o control para el que quiere crear un controlador de
eventos y seleccione Propiedades.

2. En la parte superior de la ventana Propiedades, haga clic en el icono Eventos.

3. Haga doble clic en el evento que quiera crear, por ejemplo, el evento Load .

Visual C# crea un método de controlador de eventos vacío y lo agrega al código.

También puede agregar manualmente el código en la vista Código. Por ejemplo,
las líneas siguientes de código declaran un método de controlador de eventos al
que se llamará cuando la clase Form genere el evento Load .

C#

private void Form1_Load(object sender, System.EventArgs e)

// Add your form load event handling code here.

La línea de código que es necesaria para suscribirse al evento también se genera

automáticamente con el método InitializeComponent en el archivo
Form1.Designer.cs del proyecto. Se parece a lo siguiente:

C#

this.Load += new System.EventHandler(this.Form1_Load);

Para suscribirse a eventos mediante programación
1. Defina un método de controlador de eventos cuya firma coincida con la firma de
delegado del evento. Por ejemplo, si el evento se basa en el tipo de delegado
EventHandler, el siguiente código representa el código auxiliar del método:

C#

void HandleCustomEvent(object sender, CustomEventArgs a)

// Do something useful here.

2. Use el operador de suma y asignación ( += ) para asociar el controlador de eventos

al evento. En el ejemplo siguiente, se asume que un objeto denominado publisher
tiene un evento denominado RaiseCustomEvent . Observe que la clase de suscriptor
necesita una referencia a la clase de editor para suscribirse a sus eventos.

C#

publisher.RaiseCustomEvent += HandleCustomEvent;

También puede usar una expresión lambda para especificar un controlador de

eventos:

C#

public Form1()

InitializeComponent();

this.Click += (s,e) =>

MessageBox.Show(((MouseEventArgs)e).Location.ToString());

};

Para suscribirse a eventos mediante una función anónima

Si no tiene que cancelar la suscripción a un evento más adelante, puede usar el
operador de asignación y suma ( += ) para asociar una función anónima como
controlador de eventos. En el ejemplo siguiente, se presupone que un objeto
denominado publisher tiene un evento denominado RaiseCustomEvent y que se ha
definido una clase CustomEventArgs para proporcionar algún tipo de información
específica del evento. Observe que la clase de suscriptor necesita una referencia a
publisher para suscribirse a sus eventos.

C#

publisher.RaiseCustomEvent += (object o, CustomEventArgs e) =>

string s = o.ToString() + " " + e.ToString();

Console.WriteLine(s);

};

No podrá cancelar la suscripción a un evento fácilmente si ha usado una función

anónima para suscribirse a él. Para cancelar la suscripción en este escenario, regrese al
código donde se ha suscrito al evento, almacene la función anónima en una variable de
delegado y, después, agregue el delegado al evento. Se recomienda que no use
funciones anónimas para suscribirse a eventos si tiene que cancelar la suscripción al
evento en el código más adelante. Para obtener más información sobre las funciones
anónimas, consulte Expresiones lambda.

Cancelar una suscripción

Para impedir que se invoque el controlador de eventos cuando se produce el evento,
puede cancelar la suscripción al evento. Para evitar que se pierdan recursos, debe
cancelar la suscripción a los eventos antes de eliminar un objeto suscriptor. Hasta que se
cancela la suscripción a un evento, el delegado multidifusión subyacente al evento en el
objeto de publicación tiene una referencia al delegado que encapsula el controlador de
eventos del suscriptor. Mientras el objeto de publicación mantenga esa referencia, la
recolección de elementos no utilizados no eliminará el objeto suscriptor.

Para cancelar la suscripción a un evento

Use el operador de resta y asignación ( -= ) para cancelar la suscripción a un
evento:

C#

publisher.RaiseCustomEvent -= HandleCustomEvent;

Cuando se haya cancelado la suscripción a un evento de todos los suscriptores, la

instancia del evento en la clase de editor se establecerá en null .
Vea también
Eventos
event
Procedimiento para publicar eventos que cumplan las instrucciones de .NET
Operadores - y -=
Operadores + y +=
Procedimiento Publicar eventos que
cumplan las directrices de .NET (guía de
programación de C#)
Artículo • 10/01/2023 • Tiempo de lectura: 3 minutos

En el siguiente procedimiento se muestra cómo agregar eventos que cumplan el patrón

de .NET estándar a las clases y structs. Todos los eventos de la biblioteca de clases de
.NET se basan en el delegado EventHandler, que se define de la siguiente manera:

C#

public delegate void EventHandler(object sender, EventArgs e);

７ Nota

.NET Framework 2.0 incluye una versión genérica de este delegado,

EventHandler<TEventArgs>. En los siguientes ejemplos se muestra cómo usar las
dos versiones.

Aunque los eventos de las clases que defina se pueden basar en cualquier tipo de
delegado válido, incluidos los delegados que devuelven un valor, por lo general se
recomienda que base los eventos en el patrón de .NET mediante EventHandler, como se
muestra en el ejemplo siguiente.

El nombre EventHandler puede dar lugar a un poco de confusión, ya que realmente no

controla el evento. EventHandler y EventHandler<TEventArgs> genérico son tipos de
delegado. Un método o una expresión lambda cuya firma coincide con la definición de
delegado es el controlador de eventos y se invocará cuando se genere el evento.

Publicación de eventos basados en el patrón

EventHandler
1. (Omita este paso y vaya al paso 3a si no tiene que enviar datos personalizados con
el evento). Declare la clase de los datos personalizados en un ámbito que sea
visible para las clases de publicador y suscriptor. Luego, agregue los miembros
necesarios para almacenar los datos de eventos personalizados. En este ejemplo se
devuelve una cadena simple.
 C#

public class CustomEventArgs : EventArgs

public CustomEventArgs(string message)

Message = message;

public string Message { get; set; }

2. (Omita este paso si usa la versión genérica de EventHandler<TEventArgs>).

Declare un delegado en la clase de publicación. Asígnele un nombre que termine
con EventHandler . El segundo parámetro especifica el tipo EventArgs
personalizado.

C#

public delegate void CustomEventHandler(object sender, CustomEventArgs

args);

3. Declare el evento en la clase de publicación llevando a cabo uno de los siguientes

pasos.

a. Si no tiene ninguna clase EventArgs personalizada, el tipo Event será el

delegado EventHandler no genérico. No es necesario declarar el delegado,
porque ya está declarado en el espacio de nombres System que se incluye al
crear el proyecto de C#. Agregue el código siguiente a la clase de publicador.

C#

public event EventHandler RaiseCustomEvent;

b. Si usa la versión no genérica de EventHandler y tiene una clase personalizada

derivada de EventArgs, declare el evento dentro de la clase de publicación y use
el delegado del paso 2 como tipo.

C#

public event CustomEventHandler RaiseCustomEvent;

c. Si usa la versión genérica, no necesita ningún delegado personalizado. En su

lugar, en la clase de publicación, especifique el tipo de evento como
 EventHandler<CustomEventArgs> , sustituyendo el nombre de su propia clase que

aparece entre corchetes angulares.

C#

public event EventHandler<CustomEventArgs> RaiseCustomEvent;

Ejemplo
En el siguiente ejemplo se muestran los pasos anteriores mediante el uso de una clase
EventArgs personalizada y EventHandler<TEventArgs> como tipo de evento.

C#

using System;

namespace DotNetEvents

// Define a class to hold custom event info

public class CustomEventArgs : EventArgs

public CustomEventArgs(string message)

Message = message;

public string Message { get; set; }

// Class that publishes an event

class Publisher

// Declare the event using EventHandler<T>

public event EventHandler<CustomEventArgs> RaiseCustomEvent;

public void DoSomething()

// Write some code that does something useful here

// then raise the event. You can also raise an event

// before you execute a block of code.

OnRaiseCustomEvent(new CustomEventArgs("Event triggered"));

// Wrap event invocations inside a protected virtual method

// to allow derived classes to override the event invocation

behavior

protected virtual void OnRaiseCustomEvent(CustomEventArgs e)

// Make a temporary copy of the event to avoid possibility of

// a race condition if the last subscriber unsubscribes

 // immediately after the null check and before the event is

raised.

EventHandler<CustomEventArgs> raiseEvent = RaiseCustomEvent;

// Event will be null if there are no subscribers

if (raiseEvent != null)

// Format the string to send inside the CustomEventArgs

parameter

e.Message += $" at {DateTime.Now}";

// Call to raise the event.

raiseEvent(this, e);

//Class that subscribes to an event

class Subscriber

private readonly string _id;

public Subscriber(string id, Publisher pub)

_id = id;

// Subscribe to the event

pub.RaiseCustomEvent += HandleCustomEvent;

// Define what actions to take when the event is raised.

void HandleCustomEvent(object sender, CustomEventArgs e)

Console.WriteLine($"{_id} received this message: {e.Message}");

class Program

static void Main()

var pub = new Publisher();

var sub1 = new Subscriber("sub1", pub);

var sub2 = new Subscriber("sub2", pub);

// Call the method that raises the event.

pub.DoSomething();

// Keep the console window open

Console.WriteLine("Press any key to continue...");

Console.ReadLine();

Vea también
Delegate
Guía de programación de C#
Eventos
Delegados
Procedimiento Producir eventos de una
clase base en clases derivadas (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En el siguiente ejemplo sencillo se muestra la forma estándar de declarar eventos en

una clase base para que también se puedan generar desde clases derivadas. Este patrón
se usa mucho en las clases de Windows Forms de las bibliotecas de clases de .NET.

Al crear una clase que se pueda usar como clase base para otras clases, debe considerar
el hecho de que los eventos son un tipo especial de delegado que solo se pueden
invocar desde la clase que los haya declarado. Las clases derivadas no pueden invocar
directamente a eventos declarados en la clase base. Aunque a veces pueda querer un
evento que solo la clase base pueda generar, en la mayoría de los casos debería
habilitar la clase derivada para invocar a eventos de clase base. Para ello, puede crear un
método de invocación protegido en la clase base que encapsula el evento. Al llamar o
invalidar a este método de invocación, las clases derivadas pueden invocar directamente
al evento.

７ Nota

No declare eventos virtuales en una clase base y los invalide en una clase derivada.
El compilador de C# no los controla correctamente y no es posible decir si un
suscriptor del evento derivado se está suscribiendo realmente al evento de clase
base.

Ejemplo
C#

namespace BaseClassEvents

// Special EventArgs class to hold info about Shapes.

public class ShapeEventArgs : EventArgs

public ShapeEventArgs(double area)

NewArea = area;

 public double NewArea { get; }

// Base class event publisher

public abstract class Shape

protected double _area;

public double Area

get => _area;

set => _area = value;

// The event. Note that by using the generic EventHandler<T> event

type

// we do not need to declare a separate delegate type.

public event EventHandler<ShapeEventArgs> ShapeChanged;

public abstract void Draw();

//The event-invoking method that derived classes can override.

protected virtual void OnShapeChanged(ShapeEventArgs e)

// Safely raise the event for all subscribers

ShapeChanged?.Invoke(this, e);

public class Circle : Shape

private double _radius;

public Circle(double radius)

_radius = radius;

_area = 3.14 * _radius * _radius;

public void Update(double d)

_radius = d;

_area = 3.14 * _radius * _radius;

OnShapeChanged(new ShapeEventArgs(_area));

protected override void OnShapeChanged(ShapeEventArgs e)

// Do any circle-specific processing here.

// Call the base class event invocation method.

base.OnShapeChanged(e);

 public override void Draw()

Console.WriteLine("Drawing a circle");

public class Rectangle : Shape

private double _length;

private double _width;

public Rectangle(double length, double width)

_length = length;

_width = width;

_area = _length * _width;

public void Update(double length, double width)

_length = length;

_width = width;

_area = _length * _width;

OnShapeChanged(new ShapeEventArgs(_area));

protected override void OnShapeChanged(ShapeEventArgs e)

// Do any rectangle-specific processing here.

// Call the base class event invocation method.

base.OnShapeChanged(e);

public override void Draw()

Console.WriteLine("Drawing a rectangle");

// Represents the surface on which the shapes are drawn

// Subscribes to shape events so that it knows

// when to redraw a shape.

public class ShapeContainer

private readonly List<Shape> _list;

public ShapeContainer()

_list = new List<Shape>();

public void AddShape(Shape shape)

_list.Add(shape);

 // Subscribe to the base class event.

shape.ShapeChanged += HandleShapeChanged;

// ...Other methods to draw, resize, etc.

private void HandleShapeChanged(object sender, ShapeEventArgs e)

if (sender is Shape shape)

// Diagnostic message for demonstration purposes.

Console.WriteLine($"Received event. Shape area is now

{e.NewArea}");

// Redraw the shape here.

shape.Draw();

class Test

static void Main()

//Create the event publishers and subscriber

var circle = new Circle(54);

var rectangle = new Rectangle(12, 9);

var container = new ShapeContainer();

// Add the shapes to the container.

container.AddShape(circle);

container.AddShape(rectangle);

// Cause some events to be raised.

circle.Update(57);

rectangle.Update(7, 7);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to continue...");

Console.ReadKey();

/* Output:

Received event. Shape area is now 10201.86

Drawing a circle

Received event. Shape area is now 49

Drawing a rectangle

*/

Consulte también
Guía de programación de C#
Eventos
Delegados
Modificadores de acceso
Crear controladores de eventos en Windows Forms
Procedimiento Implementar eventos de
interfaz (Guía de programación de C#)
Artículo • 10/03/2023 • Tiempo de lectura: 3 minutos

Un interfaz puede declarar un evento. En el siguiente ejemplo, se muestra cómo

implementar eventos de interfaz en una clase. Básicamente, las reglas son las mismas
que para implementar cualquier propiedad o método de interfaz.

Para implementar eventos de interfaz en una

clase
Declare el evento en la clase y, después, invóquelo en las áreas apropiadas.

C#

namespace ImplementInterfaceEvents

public interface IDrawingObject

event EventHandler ShapeChanged;

public class MyEventArgs : EventArgs

// class members

public class Shape : IDrawingObject

public event EventHandler ShapeChanged;

void ChangeShape()

// Do something here before the event…

OnShapeChanged(new MyEventArgs(/*arguments*/));

// or do something here after the event.

protected virtual void OnShapeChanged(MyEventArgs e)

ShapeChanged?.Invoke(this, e);

Ejemplo
En el ejemplo siguiente se muestra cómo controlar la situación menos común en que la
clase hereda de dos o más interfaces y cada interfaz tiene un evento con el mismo
nombre. En esta situación, debe proporcionar una implementación de interfaz explícita
para uno de los eventos como mínimo. Al escribir una implementación de interfaz
explícita para un evento, también debe escribir los descriptores de acceso del evento
add y remove . Normalmente, los proporciona el compilador, pero en este caso no es

posible.

Al proporcionar sus propios descriptores de acceso, puede especificar si los dos eventos
se representan mediante el mismo evento en la clase o mediante eventos diferentes. Por
ejemplo, si los eventos deben provocarse en momentos diferentes según las
especificaciones de la interfaz, puede asociar cada evento a una implementación distinta
en su clase. En el ejemplo siguiente, los suscriptores determinan qué evento OnDraw
recibirán al convertir la referencia de forma en IShape o en IDrawingObject .

C#

namespace WrapTwoInterfaceEvents

using System;

public interface IDrawingObject

// Raise this event before drawing

// the object.

event EventHandler OnDraw;

public interface IShape

// Raise this event after drawing

// the shape.

event EventHandler OnDraw;

// Base class event publisher inherits two

// interfaces, each with an OnDraw event

public class Shape : IDrawingObject, IShape

// Create an event for each interface event

event EventHandler PreDrawEvent;

event EventHandler PostDrawEvent;

object objectLock = new Object();

// Explicit interface implementation required.

// Associate IDrawingObject's event with

// PreDrawEvent

 #region IDrawingObjectOnDraw

event EventHandler IDrawingObject.OnDraw

add

lock (objectLock)
{

PreDrawEvent += value;

remove

lock (objectLock)
{

PreDrawEvent -= value;

#endregion

// Explicit interface implementation required.

// Associate IShape's event with

// PostDrawEvent

event EventHandler IShape.OnDraw

add

lock (objectLock)
{

PostDrawEvent += value;

remove

lock (objectLock)
{

PostDrawEvent -= value;

// For the sake of simplicity this one method

// implements both interfaces.

public void Draw()

// Raise IDrawingObject's event before the object is drawn.

PreDrawEvent?.Invoke(this, EventArgs.Empty);

Console.WriteLine("Drawing a shape.");

// Raise IShape's event after the object is drawn.

PostDrawEvent?.Invoke(this, EventArgs.Empty);

public class Subscriber1

 // References the shape object as an IDrawingObject

public Subscriber1(Shape shape)

IDrawingObject d = (IDrawingObject)shape;

d.OnDraw += d_OnDraw;
}

void d_OnDraw(object sender, EventArgs e)

Console.WriteLine("Sub1 receives the IDrawingObject event.");

// References the shape object as an IShape

public class Subscriber2

public Subscriber2(Shape shape)

IShape d = (IShape)shape;

d.OnDraw += d_OnDraw;
}

void d_OnDraw(object sender, EventArgs e)

Console.WriteLine("Sub2 receives the IShape event.");

public class Program

static void Main(string[] args)

Shape shape = new Shape();

Subscriber1 sub = new Subscriber1(shape);

Subscriber2 sub2 = new Subscriber2(shape);

shape.Draw();

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

/* Output:

Sub1 receives the IDrawingObject event.

Drawing a shape.

Sub2 receives the IShape event.

*/

Consulte también
Guía de programación de C#
Eventos
Delegados
Implementación de interfaz explícita
Procedimiento para generar eventos de una clase base en clases derivadas
Procedimiento Implementar
descriptores de acceso de eventos
personalizados (Guía de programación
de C#)
Artículo • 10/03/2023 • Tiempo de lectura: 2 minutos

Un evento es un tipo especial de delegado de multidifusión que solo puede invocarse

desde dentro de la clase en la que se declara. El código cliente se suscribe al evento
proporcionando una referencia a un método que debería invocarse cuando se
desencadena el evento. Estos métodos se agregan a la lista de invocación del delegado
a través de descriptores de acceso de eventos, que son similares a los descriptores de
acceso de propiedad, con la diferencia de que los descriptores de acceso de eventos se
denominan add y remove . En la mayoría de los casos, no tiene que proporcionar
descriptores de acceso de eventos personalizados. Cuando no proporciona ningún
descriptor de acceso de eventos personalizado en el código, el compilador los agrega
automáticamente. En cambio, en algunos casos puede que tenga que proporcionar un
comportamiento personalizado. Uno de estos casos se muestra en el tema
Procedimiento Implementar eventos de interfaz.

Ejemplo
En el ejemplo siguiente se muestra cómo implementar descriptores de acceso de
eventos add y remove personalizados. Aunque puede sustituir cualquier código dentro
de los descriptores de acceso, recomendamos que bloquee el evento antes de agregar o
quitar un nuevo método de control de eventos.

C#

event EventHandler IDrawingObject.OnDraw

add

lock (objectLock)

PreDrawEvent += value;

remove

lock (objectLock)

 PreDrawEvent -= value;

Vea también
Eventos
event
Parámetros de tipos genéricos (Guía de
programación de C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

En un tipo genérico o en una definición de método, un parámetro de tipo es un

marcador de posición para un tipo específico que un cliente especifica cuando crean
instancias de una variable del tipo genérico. Una clase genérica, como GenericList<T>
que se muestra en Introducción a los genéricos, no puede usarse como está porque no
es realmente un tipo; es más parecida a un plano para un tipo. Para usar
GenericList<T> , el código cliente debe declarar y crear instancias de un tipo construido
especificando un argumento de tipo dentro de corchetes angulares. El argumento de
tipo de esta clase determinada puede ser cualquier tipo reconocido por el compilador.
Puede crearse cualquier número de instancias de tipo construidas, usando cada una un
argumento de tipo diferente, de la manera siguiente:

C#

GenericList<float> list1 = new GenericList<float>();

GenericList<ExampleClass> list2 = new GenericList<ExampleClass>();

GenericList<ExampleStruct> list3 = new GenericList<ExampleStruct>();

En cada una de estas instancias de GenericList<T> , cada aparición de T en la clase se

sustituye en tiempo de ejecución con el argumento de tipo. Mediante esta sustitución,
hemos creado tres objetos eficaces y con seguridad de tipos independientes con una
definición de clase única. Para obtener más información sobre cómo se realiza esta
sustitución mediante CLR, vea Genéricos en tiempo de ejecución.

Instrucciones de nomenclatura de los

parámetros de tipo
Asigne nombres descriptivos a los parámetros de tipo genérico, a no ser que un
nombre de una sola letra sea completamente claro y un nombre descriptivo no
agregue ningún valor.

C#

public interface ISessionChannel<TSession> { /*...*/ }

public delegate TOutput Converter<TInput, TOutput>(TInput from);

public class List<T> { /*...*/ }

 Considere el uso de T como el nombre del parámetro de tipo para los tipos con un
parámetro de tipo de una sola letra.

C#

public int IComparer<T>() { return 0; }

public delegate bool Predicate<T>(T item);

public struct Nullable<T> where T : struct { /*...*/ }

Establezca el prefijo "T" a los nombres de parámetro de tipo descriptivos.

C#

public interface ISessionChannel<TSession>

TSession Session { get; }

Considere la posibilidad de indicar restricciones que se encuentran en un

parámetro de tipo en el nombre del parámetro. Por ejemplo, un parámetro
restringido a ISession puede llamarse TSession .

La regla de análisis de código CA1715 puede usarse para asegurarse de que los
parámetros de tipo se denominan apropiadamente.

Consulte también
System.Collections.Generic
Guía de programación de C#
Genéricos
Diferencias entre plantillas de C++ y tipos genéricos de C#
Restricciones de tipos de parámetros
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 13 minutos

Las restricciones informan al compilador sobre las capacidades que debe tener un
argumento de tipo. Sin restricciones, el argumento de tipo puede ser cualquier tipo. El
compilador solo puede suponer los miembros de System.Object, que es la clase base
fundamental de los tipos .NET. Para más información, vea Por qué usar restricciones. Si
el código de cliente usa un tipo que no cumple una restricción, el compilador emite un
error. Las restricciones se especifican con la palabra clave contextual where . En la tabla
siguiente se muestran los distintos tipos de restricciones:

Restricción Descripción

where T : El argumento de tipo debe ser un tipo de valor que no acepta valores NULL. Para
struct más información sobre los tipos de valor que admiten un valor NULL, consulte
Tipos de valor que admiten un valor NULL. Todos los tipos de valor tienen un
constructor sin parámetros accesible, por lo que la restricción struct implica la
restricción new() y no se puede combinar con la restricción new() . No puede
combinar la restricción struct con la restricción unmanaged .

where T : El argumento de tipo debe ser un tipo de referencia. Esta restricción se aplica
class también a cualquier clase, interfaz, delegado o tipo de matriz. En un contexto que
acepta valores NULL, T debe ser un tipo de referencia que no acepta valores NULL.

where T : El argumento de tipo debe ser un tipo de referencia, que acepte o no valores NULL.
class? Esta restricción se aplica también a cualquier clase, interfaz, delegado o tipo de
matriz.

where T : El argumento de tipo debe ser un tipo que no acepta valores NULL. El argumento
notnull puede ser un tipo de referencia que no acepta valores NULL, o bien un tipo de
valor que no acepta valores NULL.

where T : Esta restricción resuelve la ambigüedad cuando es necesario especificar un

default parámetro de tipo sin restricciones al invalidar un método o proporcionar una
implementación de interfaz explícita. La restricción default implica el método base
sin la restricción class o struct . Para obtener más información, vea la propuesta
de especificación de la restricción default.

where T : El argumento de tipo debe ser un tipo no administrado que no acepta valores
unmanaged NULL. La restricción unmanaged implica la restricción struct y no se puede
combinar con las restricciones struct ni new() .
 Restricción Descripción

where T : El argumento de tipo debe tener un constructor sin parámetros público. Cuando se
new() usa conjuntamente con otras restricciones, la restricción new() debe especificarse
en último lugar. La restricción new() no se puede combinar con las restricciones
struct ni unmanaged .

where T : El argumento de tipo debe ser o derivarse de la clase base especificada. En un

<nombre contexto que acepta valores NULL, T debe ser un tipo de referencia que no acepta
de clase valores NULL derivado de la clase base especificada.
base>

where T : El argumento de tipo debe ser o derivarse de la clase base especificada. En un

<nombre contexto que acepta valores NULL, T puede ser un tipo que acepta o no acepta
de clase valores NULL derivado de la clase base especificada.
base>?

where T : El argumento de tipo debe ser o implementar la interfaz especificada. Pueden

<nombre especificarse varias restricciones de interfaz. La interfaz de restricciones también
de puede ser genérica. En un contexto que acepta valores NULL, T debe ser un tipo
interfaz> que no acepta valores NULL que implementa la interfaz especificada.

where T : El argumento de tipo debe ser o implementar la interfaz especificada. Pueden

<nombre especificarse varias restricciones de interfaz. La interfaz de restricciones también
de puede ser genérica. En un contexto que acepta valores NULL, T puede ser un tipo
interfaz>? de referencia que acepta valores NULL, un tipo de referencia que no acepta valores
NULL o un tipo de valor. T no puede ser un tipo de valor que admite un valor
NULL.

where T : El argumento de tipo proporcionado por T debe ser o se debe derivar del
U argumento proporcionado para U . En un contexto que admite un valor NULL, si U
puede ser un tipo de referencia que no acepta valores NULL, T debe ser un tipo de
referencia que no acepta valores NULL. Si U es un tipo de referencia que admite un
valor NULL, T puede aceptar valores NULL o no.

Por qué usar restricciones

Las restricciones especifican las funciones y expectativas de un parámetro de tipo. La
declaración de esas restricciones significa que puede usar las operaciones y las llamadas
de método del tipo de restricción. Si la clase o el método genérico usa cualquier
operación en los miembros genéricos más allá de una asignación simple o una llamada
a un método que System.Object no admita, se aplicarán restricciones al parámetro de
tipo. Por ejemplo, la restricción de clase base indica al compilador que solo los objetos
de este tipo o derivados de este tipo se usarán como argumentos de tipo. Una vez que
el compilador tenga esta garantía, puede permitir que los métodos de ese tipo se
llamen en la clase genérica. En el ejemplo de código siguiente se muestran las funciones
que podemos agregar a la clase GenericList<T> (en Introducción a los genéricos)
mediante la aplicación de una restricción de clase base.

C#

public class Employee

public Employee(string name, int id) => (Name, ID) = (name, id);

public string Name { get; set; }

public int ID { get; set; }

public class GenericList<T> where T : Employee

private class Node

public Node(T t) => (Next, Data) = (null, t);

public Node? Next { get; set; }

public T Data { get; set; }

private Node? head;

public void AddHead(T t)

Node n = new Node(t) { Next = head };

head = n;

public IEnumerator<T> GetEnumerator()

Node? current = head;

while (current != null)

yield return current.Data;

current = current.Next;

public T? FindFirstOccurrence(string s)

Node? current = head;

T? t = null;

while (current != null)

//The constraint enables access to the Name property.

if (current.Data.Name == s)

t = current.Data;
break;

 else

current = current.Next;

return t;

La restricción permite que la clase genérica use la propiedad Employee.Name . La

restricción especifica que está garantizado que todos los elementos de tipo T sean un
objeto Employee u objeto que hereda de Employee .

Pueden aplicarse varias restricciones en el mismo parámetro de tipo, y las propias

restricciones pueden ser tipos genéricos, de la manera siguiente:

C#

class EmployeeList<T> where T : Employee, IEmployee, System.IComparable<T>,

new()

// ...

Al aplicar la restricción where T : class , evite los operadores == y != en el parámetro

de tipo porque estos operadores se probarán solo para la identidad de referencia, no
para la igualdad de valor. Este comportamiento se produce incluso si estos operadores
están sobrecargados en un tipo que se usa como un argumento. En el código siguiente
se ilustra este punto; el resultado es False incluso cuando la clase String sobrecarga al
operador == .

C#

public static void OpEqualsTest<T>(T s, T t) where T : class

System.Console.WriteLine(s == t);

private static void TestStringEquality()

string s1 = "target";

System.Text.StringBuilder sb = new System.Text.StringBuilder("target");

string s2 = sb.ToString();

OpEqualsTest<string>(s1, s2);

El compilador solo sabe que T es un tipo de referencia en tiempo de compilación y

debe usar los operadores predeterminados que son válidos para todos los tipos de
referencia. Si debe probar la igualdad de valor, la manera recomendada también es
aplicar la restricción where T : IEquatable<T> o where T : IComparable<T> e
implementar esa interfaz en cualquier clase que se usará para construir la clase genérica.

Restringir varios parámetros

Puede aplicar restricciones a varios parámetros, y varias restricciones a un solo
parámetro, como se muestra en el siguiente ejemplo:

C#

class Base { }

class Test<T, U>

where U : struct

where T : Base, new()

{ }

Parámetros de tipo sin enlazar

Los parámetros de tipo que no tienen restricciones, como T en la clase pública
SampleClass<T>{} , se denominan parámetros de tipo sin enlazar. Los parámetros de tipo
sin enlazar tienen las reglas siguientes:

Los operadores != y == no pueden usarse porque no existe ninguna garantía de

que el argumento de tipo concreto admita estos operadores.
Pueden convertirse a y desde System.Object o convertirse explícitamente en
cualquier tipo de interfaz.
Puede compararlos con NULL. Si un parámetro sin enlazar se compara con null , la
comparación siempre devolverá False si el argumento de tipo es un tipo de valor.

Parámetros de tipo como restricciones

El uso de un parámetro de tipo genérico como una restricción es útil cuando una
función de miembro con su propio parámetro de tipo tiene que restringir ese parámetro
al parámetro de tipo del tipo contenedor, como se muestra en el ejemplo siguiente:

C#
 public class List<T>

public void Add<U>(List<U> items) where U : T {/*...*/}

En el ejemplo anterior, T es una restricción de tipo en el contexto del método Add , y un

parámetro de tipo sin enlazar en el contexto de la clase List .

Los parámetros de tipo también pueden usarse como restricciones en definiciones de

clase genéricas. El parámetro de tipo debe declararse dentro de los corchetes angulares
junto con los demás parámetros de tipo:

C#

//Type parameter V is used as a type constraint.

public class SampleClass<T, U, V> where T : V { }

La utilidad de los parámetros de tipo como restricciones con clases genéricas es

limitada, ya que el compilador no puede dar por supuesto nada sobre el parámetro de
tipo, excepto que deriva de System.Object . Use parámetros de tipo como restricciones
en clases genéricas en escenarios en los que quiere aplicar una relación de herencia
entre dos parámetros de tipo.

Restricción notnull
Puede usar la restricción notnull para especificar que el argumento de tipo debe ser un
tipo de valor que no acepta valores NULL o un tipo de referencia que no acepta valores
NULL. A diferencia de la mayoría de las demás restricciones, si un argumento de tipo
infringe la restricción notnull , el compilador genera una advertencia en lugar de un
error.

La restricción notnull tiene efecto solo cuando se usa en un contexto que admite un
valor NULL. Si agrega la restricción notnull en un contexto en el que se desconocen los
valores NULL, el compilador no genera advertencias ni errores para las infracciones de la
restricción.

Restricción class
La restricción class en un contexto que acepta valores NULL especifica que el
argumento de tipo debe ser un tipo de referencia que no acepta valores NULL. En un
contexto que admite un valor NULL, cuando un argumento de tipo es un tipo de
referencia que admite un valor NULL, el compilador genera una advertencia.

Restricción default
La incorporación de tipos de referencia que aceptan valores NULL complica el uso de
T? en un método o tipo genérico. T? se puede usar con la restricción struct o class ,
pero una de ellas debe estar presente. Cuando se ha usado la restricción class , T? se
refiere al tipo de referencia que acepta valores NULL para T . A partir de C# 9, T? se
puede usar cuando no se aplica ninguna restricción. En ese caso, T? se interpreta como
T? para tipos de valor y los tipos de referencia. Sin embargo, si T es una instancia de

Nullable<T>, T? es igual que T . En otras palabras, no se convierte en T?? .

Dado que T? ahora se puede usar sin las restricciones class o struct , pueden surgir
ambigüedades en invalidaciones o implementaciones de interfaz explícitas. En ambos
casos, la invalidación no incluye las restricciones, pero las hereda de la clase base.
Cuando la clase base no aplica las restricciones class o struct , las clases derivadas
deben especificar de algún modo que una invalidación se aplica al método base sin
ninguna restricción. Ahí es cuando el método derivado aplica la restricción default . La
restricción default no aclara ni la restricción class ni la struct .

Restricción no administrada
Puede usar la restricción unmanaged para especificar que el parámetro de tipo debe ser
un tipo no administrado que no acepta valores NULL. La restricción unmanaged permite
escribir rutinas reutilizables para trabajar con tipos que se pueden manipular como
bloques de memoria, como se muestra en el ejemplo siguiente:

C#

unsafe public static byte[] ToByteArray<T>(this T argument) where T :

unmanaged

var size = sizeof(T);

var result = new Byte[size];

Byte* p = (byte*)&argument;

for (var i = 0; i < size; i++)

result[i] = *p++;

return result;

El método anterior debe compilarse en un contexto unsafe , ya que usa el operador

sizeof en un tipo que se desconoce si es integrado. Sin la restricción unmanaged , el
operador sizeof no está disponible.

La restricción unmanaged implica la restricción struct y no se puede combinar con ella.

Dado que la restricción struct implica la restricción new() , la restricción unmanaged
tampoco se puede combinar con la restricción new() .

Restricciones de delegado
Puede usar System.Delegate o System.MulticastDelegate como una restricción de clase
base. CLR siempre permitía esta restricción, pero el lenguaje C# no la permitía. La
restricción System.Delegate permite escribir código que funciona con los delegados en
un modo con seguridad de tipos. En el código siguiente se define un método de
extensión que combina dos delegados siempre y cuando sean del mismo tipo:

C#

public static TDelegate? TypeSafeCombine<TDelegate>(this TDelegate source,

TDelegate target)

where TDelegate : System.Delegate

=> Delegate.Combine(source, target) as TDelegate;

Puede usar el método anterior para combinar delegados que sean del mismo tipo:

C#

Action first = () => Console.WriteLine("this");

Action second = () => Console.WriteLine("that");

var combined = first.TypeSafeCombine(second);

combined!();

Func<bool> test = () => true;

// Combine signature ensures combined delegates must

// have the same type.

//var badCombined = first.TypeSafeCombine(test);

Si quita la marca de comentario de la última línea, no se compilará. Tanto first como

test son tipos de delegado, pero son tipos de delegado distintos.

Restricciones de enumeración
También puede especificar el tipo System.Enum como una restricción de clase base. CLR
siempre permitía esta restricción, pero el lenguaje C# no la permitía. Los genéricos que
usan System.Enum proporcionan programación con seguridad de tipos para almacenar
en caché los resultados de usar los métodos estáticos en System.Enum . En el ejemplo
siguiente se buscan todos los valores válidos para un tipo de enumeración y, después,
se compila un diccionario que asigna esos valores a su representación de cadena.

C#

public static Dictionary<int, string> EnumNamedValues<T>() where T :

System.Enum

var result = new Dictionary<int, string>();

var values = Enum.GetValues(typeof(T));

foreach (int item in values)

result.Add(item, Enum.GetName(typeof(T), item)!);

return result;

Enum.GetValues y Enum.GetName usan reflexión, lo que tiene consecuencias en el

rendimiento. Puede llamar a EnumNamedValues para compilar una recopilación que se

almacene en caché y se vuelva a usar, en lugar de repetir las llamadas que requieren
reflexión.

Podría usarla como se muestra en el ejemplo siguiente para crear una enumeración y
compilar un diccionario con sus nombres y valores:

C#

enum Rainbow

Red,

Orange,

Yellow,

Green,

Blue,

Indigo,

Violet

C#

var map = EnumNamedValues<Rainbow>();

foreach (var pair in map)

Console.WriteLine($"{pair.Key}:\t{pair.Value}");

Los argumentos de tipo implementan la

interfaz declarada
Algunos escenarios requieren que un argumento proporcionado para un parámetro de
tipo implemente esa interfaz. Por ejemplo:

C#

public interface IAdditionSubtraction<T> where T : IAdditionSubtraction<T>

public abstract static T operator +(T left, T right);

public abstract static T operator -(T left, T right);

Este patrón permite al compilador de C# determinar el tipo contenedor para los

operadores sobrecargados, o algún método static virtual o static abstract .
Proporciona la sintaxis para que los operadores de suma y resta se puedan definir en un
tipo contenedor. Sin esta restricción, los parámetros y argumentos deben declararse
como interfaz, en lugar de parámetro de tipo:

C#

public interface IAdditionSubtraction<T> where T : IAdditionSubtraction<T>

public abstract static IAdditionSubtraction<T> operator +(

IAdditionSubtraction<T> left,

IAdditionSubtraction<T> right);

public abstract static IAdditionSubtraction<T> operator -(

IAdditionSubtraction<T> left,

IAdditionSubtraction<T> right);

La sintaxis anterior requeriría que los implementadores usaran la implementación de

interfaz explícita para esos métodos. Proporcionar la restricción adicional permite a la
interfaz definir los operadores en términos de los parámetros de tipo. Los tipos que
implementan la interfaz pueden implementar implícitamente los métodos de interfaz.

Consulte también
System.Collections.Generic
Guía de programación de C#
Introducción a los genéricos
Clases genéricas
new (restricción)
Clases genéricas (Guía de programación
de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Las clases genéricas encapsulan operaciones que no son específicas de un tipo de datos
determinado. El uso más común de las clases genéricas es con colecciones como listas
vinculadas, tablas hash, pilas, colas y árboles, entre otros. Las operaciones como la
adición y eliminación de elementos de la colección se realizan básicamente de la misma
manera independientemente del tipo de datos que se almacenan.

Para la mayoría de los escenarios que necesitan clases de colección, el enfoque

recomendado es usar las que se proporcionan en la biblioteca de clases .NET. Para más
información sobre el uso de estas clases, vea Colecciones genéricas en .NET.

Normalmente, crea clases genéricas empezando con una clase concreta existente, y
cambiando tipos en parámetros de tipo de uno en uno hasta que alcanza el equilibrio
óptimo de generalización y facilidad de uso. Al crear sus propias clases genéricas, entre
las consideraciones importantes se incluyen las siguientes:

Los tipos que se van a generalizar en parámetros de tipo.

Como norma, cuantos más tipos pueda parametrizar, más flexible y reutilizable
será su código. En cambio, demasiada generalización puede crear código que sea
difícil de leer o entender para otros desarrolladores.

Las restricciones, si existen, que se van a aplicar a los parámetros de tipo (Vea
Restricciones de parámetros de tipo).

Una buena norma es aplicar el máximo número de restricciones posible que

todavía le permitan tratar los tipos que debe controlar. Por ejemplo, si sabe que su
clase genérica está diseñada para usarse solo con tipos de referencia, aplique la
restricción de clase. Esto evitará el uso no previsto de su clase con tipos de valor, y
le permitirá usar el operador as en T , y comprobar si hay valores NULL.

Si separar el comportamiento genérico en clases base y subclases.

Como las clases genéricas pueden servir como clases base, las mismas
consideraciones de diseño se aplican aquí con clases no genéricas. Vea las reglas
sobre cómo heredar de clases base genéricas posteriormente en este tema.

Si implementar una o más interfaces genéricas.

 Por ejemplo, si está diseñando una clase que se usará para crear elementos en una
colección basada en genéricos, puede que tenga que implementar una interfaz
como IComparable<T> donde T es el tipo de su clase.

Para obtener un ejemplo de una clase genérica simple, vea Introducción a los genéricos.

Las reglas para los parámetros de tipo y las restricciones tienen varias implicaciones
para el comportamiento de clase genérico, especialmente respecto a la herencia y a la
accesibilidad de miembros. Antes de continuar, debe entender algunos términos. En una
clase genérica Node<T>, , el código de cliente puede hacer referencia a la clase
especificando un argumento de tipo, para crear un tipo construido cerrado ( Node<int> );
o dejando sin especificar el parámetro de tipo, por ejemplo, cuando se especifica una
clase base genérica, para crear un tipo construido abierto ( Node<T> ). Las clases genéricas
pueden heredar de determinadas clases base construidas abiertas o construidas
cerradas:

C#

class BaseNode { }

class BaseNodeGeneric<T> { }

// concrete type

class NodeConcrete<T> : BaseNode { }

//closed constructed type

class NodeClosed<T> : BaseNodeGeneric<int> { }

//open constructed type

class NodeOpen<T> : BaseNodeGeneric<T> { }

Las clases no genéricas, en otras palabras, concretas, pueden heredar de clases base
construidas cerradas, pero no desde clases construidas abiertas ni desde parámetros de
tipo porque no hay ninguna manera en tiempo de ejecución para que el código de
cliente proporcione el argumento de tipo necesario para crear instancias de la clase
base.

C#

//No error

class Node1 : BaseNodeGeneric<int> { }

//Generates an error

//class Node2 : BaseNodeGeneric<T> {}

//Generates an error

//class Node3 : T {}

Las clases genéricas que heredan de tipos construidos abiertos deben proporcionar
argumentos de tipo para cualquier parámetro de tipo de clase base que no se comparta
mediante la clase heredada, como se demuestra en el código siguiente:

C#

class BaseNodeMultiple<T, U> { }

//No error

class Node4<T> : BaseNodeMultiple<T, int> { }

//No error

class Node5<T, U> : BaseNodeMultiple<T, U> { }

//Generates an error

//class Node6<T> : BaseNodeMultiple<T, U> {}

Las clases genéricas que heredan de tipos construidos abiertos deben especificar
restricciones que son un superconjunto de las restricciones del tipo base, o que las
implican:

C#

class NodeItem<T> where T : System.IComparable<T>, new() { }

class SpecialNodeItem<T> : NodeItem<T> where T : System.IComparable<T>,

new() { }

Los tipos genéricos pueden usar varios parámetros de tipo y restricciones, de la manera
siguiente:

C#

class SuperKeyType<K, V, U>

where U : System.IComparable<U>

where V : new()

{ }

Tipos construidos cerrados y construidos abiertos pueden usarse como parámetros de

método:

C#

void Swap<T>(List<T> list1, List<T> list2)

//code to swap items

 void Swap(List<int> list1, List<int> list2)

//code to swap items

Si una clase genérica implementa una interfaz, todas las instancias de esa clase se
pueden convertir en esa interfaz.

Las clases genéricas son invariables. En otras palabras, si un parámetro de entrada

especifica un List<BaseClass> , obtendrá un error en tiempo de compilación si intenta
proporcionar un List<DerivedClass> .

Consulte también
System.Collections.Generic
Guía de programación de C#
Genéricos
Guardar el estado de los enumeradores
Un puzle de herencia, parte uno
Interfaces genéricas (Guía de
programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 5 minutos

A menudo es útil definir interfaces para las clases de colección genéricas o para las
clases genéricas que representan elementos de la colección. Para evitar operaciones de
conversión boxing y unboxing en tipos de valor, es mejor usar interfaces genéricas,
como IComparable<T>, en clases genéricas. En la biblioteca de clases de .NET se
definen varias interfaces genéricas para usarlas con las clases de colección del espacio
de nombres System.Collections.Generic. Para más información sobre estas interfaces,
consulte Interfaces genéricas.

Cuando una interfaz se especifica como restricción en un parámetro de tipo, solo se

pueden usar los tipos que implementan la interfaz. El ejemplo de código siguiente
muestra una clase SortedList<T> derivada de la clase GenericList<T> . Para obtener más
información, vea Introducción a los genéricos. SortedList<T> agrega la restricción where
T : IComparable<T> . Esta restricción permite al método BubbleSort de SortedList<T>

usar el método CompareTo genérico con los elementos de lista. En este ejemplo, los
elementos de lista son una clase simple, Person , que implementa IComparable<Person> .

C#

//Type parameter T in angle brackets.

public class GenericList<T> : System.Collections.Generic.IEnumerable<T>

protected Node head;

protected Node current = null;

// Nested class is also generic on T

protected class Node

public Node next;

private T data; //T as private member datatype

public Node(T t) //T used in non-generic constructor

next = null;

data = t;

public Node Next

get { return next; }

set { next = value; }

 public T Data //T as return type of property

get { return data; }

set { data = value; }

public GenericList() //constructor

head = null;

public void AddHead(T t) //T as method parameter type

Node n = new Node(t);

n.Next = head;

head = n;

// Implementation of the iterator

public System.Collections.Generic.IEnumerator<T> GetEnumerator()

Node current = head;

while (current != null)

yield return current.Data;

current = current.Next;

// IEnumerable<T> inherits from IEnumerable, therefore this class

// must implement both the generic and non-generic versions of

// GetEnumerator. In most cases, the non-generic method can

// simply call the generic method.

System.Collections.IEnumerator
System.Collections.IEnumerable.GetEnumerator()

return GetEnumerator();

public class SortedList<T> : GenericList<T> where T : System.IComparable<T>

// A simple, unoptimized sort algorithm that

// orders list elements from lowest to highest:

public void BubbleSort()

if (null == head || null == head.Next)

return;

bool swapped;

do

Node previous = null;

Node current = head;

swapped = false;

while (current.next != null)

// Because we need to call this method, the SortedList

// class is constrained on IComparable<T>

if (current.Data.CompareTo(current.next.Data) > 0)

Node tmp = current.next;

current.next = current.next.next;

tmp.next = current;

if (previous == null)

head = tmp;

else

previous.next = tmp;

previous = tmp;

swapped = true;

else

previous = current;

current = current.next;

} while (swapped);

// A simple class that implements IComparable<T> using itself as the

// type argument. This is a common design pattern in objects that

// are stored in generic lists.

public class Person : System.IComparable<Person>

string name;

int age;

public Person(string s, int i)

name = s;

age = i;

// This will cause list elements to be sorted on age values.

public int CompareTo(Person p)

return age - p.age;

 public override string ToString()

return name + ":" + age;

// Must implement Equals.

public bool Equals(Person p)

return (this.age == p.age);

public class Program

public static void Main()

//Declare and instantiate a new generic SortedList class.

//Person is the type argument.

SortedList<Person> list = new SortedList<Person>();

//Create name and age values to initialize Person objects.

string[] names = new string[]

"Franscoise",

"Bill",

"Li",

"Sandra",

"Gunnar",

"Alok",

"Hiroyuki",

"Maria",

"Alessandro",

"Raul"

};

int[] ages = new int[] { 45, 19, 28, 23, 18, 9, 108, 72, 30, 35 };

//Populate the list.

for (int x = 0; x < 10; x++)

list.AddHead(new Person(names[x], ages[x]));

//Print out unsorted list.

foreach (Person p in list)

System.Console.WriteLine(p.ToString());

System.Console.WriteLine("Done with unsorted list");

//Sort the list.

list.BubbleSort();

//Print out sorted list.

 foreach (Person p in list)

System.Console.WriteLine(p.ToString());

System.Console.WriteLine("Done with sorted list");

Se pueden especificar varias interfaces como restricciones en un solo tipo, de la

siguiente manera:

C#

class Stack<T> where T : System.IComparable<T>, IEnumerable<T>

Una interfaz puede definir más de un parámetro de tipo, de la siguiente manera:

C#

interface IDictionary<K, V>

Las reglas de herencia que se aplican a las clases también se aplican a las interfaces:

C#

interface IMonth<T> { }

interface IJanuary : IMonth<int> { } //No error

interface IFebruary<T> : IMonth<int> { } //No error

interface IMarch<T> : IMonth<T> { } //No error

//interface IApril<T> : IMonth<T, U>

{} //Error

Las interfaces genéricas pueden heredar de interfaces no genéricas si son covariantes, lo

que significa que solo usan su parámetro de tipo como valor devuelto. En la biblioteca
de clases de .NET, IEnumerable<T> hereda de IEnumerable porque IEnumerable<T>
solo usa T en el valor devuelto de GetEnumerator y en el captador de propiedad
Current.

Las clases concretas pueden implementar interfaces construidas cerradas, de la

siguiente manera:

C#
 interface IBaseInterface<T> { }

class SampleClass : IBaseInterface<string> { }

Las clases genéricas pueden implementar interfaces genéricas o interfaces construidas

cerradas siempre que la lista de parámetros de la clase suministre todos los argumentos
que necesita la interfaz, de la siguiente manera:

C#

interface IBaseInterface1<T> { }

interface IBaseInterface2<T, U> { }

class SampleClass1<T> : IBaseInterface1<T> { } //No error

class SampleClass2<T> : IBaseInterface2<T, string> { } //No error

Las reglas que controlan la sobrecarga de métodos son las mismas para los métodos
incluidos en las clases genéricas, los structs genéricos o las interfaces genéricas. Para
obtener más información, vea Métodos genéricos.

A partir de C# 11, las interfaces pueden declarar miembros static abstract o static
virtual . Las interfaces que declaran miembros static abstract o static virtual son

casi siempre interfaces genéricas. El compilador debe resolver las llamadas a los
métodos static virtual y static abstract en tiempo de compilación. Los métodos
static virtual y static abstract declarados en interfaces no tienen un mecanismo de

distribución en tiempo de ejecución análogo a los métodos virtual o abstract

declarados en clases. En su lugar, el compilador usa la información de tipos disponible
en tiempo de compilación. Estos miembros se declaran normalmente en interfaces
genéricas. Además, la mayoría de las interfaces que declaran métodos static virtual o
static abstract declaran que uno de los parámetros de tipo debe implementar la

interfaz declarada. A continuación, el compilador usa los argumentos de tipo

proporcionados para resolver el tipo del miembro declarado.

Consulte también
Guía de programación de C#
Introducción a los genéricos
interface
Genéricos
Métodos genéricos (Guía de
programación de C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

Un método genérico es un método que se declara con parámetros de tipo, de la manera

siguiente:

C#

static void Swap<T>(ref T lhs, ref T rhs)

T temp;

temp = lhs;

lhs = rhs;

rhs = temp;

En el siguiente ejemplo de código se muestra una manera de llamar al método con int
para el argumento de tipo:

C#

public static void TestSwap()

int a = 1;

int b = 2;

Swap<int>(ref a, ref b);

System.Console.WriteLine(a + " " + b);

También puede omitir el argumento de tipo y el compilador lo deducirá. La siguiente

llamada a Swap es equivalente a la llamada anterior:

C#

Swap(ref a, ref b);

Las mismas reglas para la inferencia de tipos se aplican a los métodos estáticos y a los
métodos de instancia. El compilador puede deducir los parámetros de tipo basados en
los argumentos de método que se pasan; no puede deducir los parámetros de tipo solo
desde un valor devuelto o una restricción. Por lo tanto, la inferencia de tipos no
funciona con métodos que no tienen parámetros. La inferencia de tipos se produce en
tiempo de compilación antes de que el compilador intente resolver las firmas de
método sobrecargadas. El compilador aplica la lógica de inferencia de tipos a todos los
métodos genéricos que comparten el mismo nombre. En el paso de resolución de
sobrecarga, el compilador incluye solo esos métodos genéricos en los que la inferencia
de tipos se ha realizado correctamente.

Dentro de una clase genérica, los métodos no genéricos pueden tener acceso a los
parámetros de tipo de nivel de clase, de la manera siguiente:

C#

class SampleClass<T>

void Swap(ref T lhs, ref T rhs) { }

Si define un método genérico que toma los mismos parámetros de tipo que la clase
contenedora, el compilador genera la advertencia CS0693 porque, dentro del ámbito
del método, el argumento que se ha proporcionado para el T interno oculta el
argumento que se ha proporcionado para el T externo. Si necesita la flexibilidad de
llamar a un método de la clase genérica con argumentos de tipo diferentes de los que
se han proporcionado cuando se ha creado una instancia de la clase, considere la
posibilidad de proporcionar otro identificador para el parámetro de tipo del método,
como se muestra en GenericList2<T> en el ejemplo siguiente.

C#

class GenericList<T>

// CS0693

void SampleMethod<T>() { }

class GenericList2<T>

//No warning

void SampleMethod<U>() { }

Use restricciones para permitir operaciones más especializadas en parámetros de tipo

de métodos. Esta versión de Swap<T> , ahora denominada SwapIfGreater<T> , solo puede
usarse con argumentos de tipo que implementan IComparable<T>.

C#
 void SwapIfGreater<T>(ref T lhs, ref T rhs) where T : System.IComparable<T>

T temp;

if (lhs.CompareTo(rhs) > 0)

temp = lhs;

lhs = rhs;

rhs = temp;

Los métodos genéricos pueden sobrecargarse en varios parámetros de tipo. Por

ejemplo, todos los métodos siguientes pueden ubicarse en la misma clase:

C#

void DoWork() { }

void DoWork<T>() { }

void DoWork<T, U>() { }

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#.

Vea también
System.Collections.Generic
Guía de programación de C#
Introducción a los genéricos
Métodos
Genéricos y matrices (Guía de
programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

Las matrices unidimensionales que tienen un límite inferior de cero implementan

IList<T> automáticamente. Esto le permite crear métodos genéricos que pueden usar el
mismo código para recorrer en iteración matrices y otros tipos de colección. Esta técnica
es útil principalmente para leer datos en colecciones. La interfaz IList<T> no puede
usarse para agregar o quitar elementos de una matriz. Se generará una excepción si
intenta llamar a un método IList<T> como RemoveAt en una matriz en este contexto.

En el siguiente ejemplo de código se muestra cómo un método genérico único que

toma un parámetro de entrada IList<T> puede recorrer en iteración una lista y una
matriz, en este caso una matriz de enteros.

C#

class Program

static void Main()

int[] arr = { 0, 1, 2, 3, 4 };

List<int> list = new List<int>();

for (int x = 5; x < 10; x++)

list.Add(x);

ProcessItems<int>(arr);

ProcessItems<int>(list);

static void ProcessItems<T>(IList<T> coll)

// IsReadOnly returns True for the array and False for the List.

System.Console.WriteLine

("IsReadOnly returns {0} for this collection.",

coll.IsReadOnly);

// The following statement causes a run-time exception for the

// array, but not for the List.

//coll.RemoveAt(4);

foreach (T item in coll)

System.Console.Write(item.ToString() + " ");

 System.Console.WriteLine();

Consulte también
System.Collections.Generic
Guía de programación de C#
Genéricos
Matrices
Genéricos
Delegados genéricos (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Un delegado puede definir sus propios parámetros de tipo. El código que hace
referencia al delegado genérico puede especificar el tipo de argumento para crear un
tipo construido abierto, igual que al crear una instancia de una clase genérica o al llamar
a un método genérico, como se muestra en el siguiente ejemplo:

C#

public delegate void Del<T>(T item);

public static void Notify(int i) { }

Del<int> m1 = new Del<int>(Notify);

C# 2.0 tiene una nueva característica denominada conversión de grupo de métodos,

que se aplica a los tipos delegados concretos y genéricos, y permite escribir la línea
anterior con esta sintaxis simplificada:

C#

Del<int> m2 = Notify;

Los delegados definidos dentro de una clase genérica pueden usar los parámetros de
tipo de la clase genérica de la misma manera que lo hacen los métodos de clase.

C#

class Stack<T>

T[] items;

int index;

public delegate void StackDelegate(T[] items);

El código que hace referencia al delegado debe especificar el argumento de tipo de la

clase contenedora, de la siguiente manera:

C#
 private static void DoWork(float[] items) { }

public static void TestStack()

Stack<float> s = new Stack<float>();

Stack<float>.StackDelegate d = DoWork;

Los delegados genéricos son especialmente útiles para definir eventos basados en el
patrón de diseño habitual porque el argumento del remitente puede estar fuertemente
tipado y ya no tiene que convertirse a y de Object.

C#

delegate void StackEventHandler<T, U>(T sender, U eventArgs);

class Stack<T>

public class StackEventArgs : System.EventArgs { }

public event StackEventHandler<Stack<T>, StackEventArgs> StackEvent;

protected virtual void OnStackChanged(StackEventArgs a)

StackEvent(this, a);

class SampleClass

public void HandleStackChange<T>(Stack<T> stack, Stack<T>.StackEventArgs

args) { }

public static void Test()

Stack<double> s = new Stack<double>();

SampleClass o = new SampleClass();

s.StackEvent += o.HandleStackChange;

Consulte también
System.Collections.Generic
Guía de programación de C#
Introducción a los genéricos
Métodos genéricos
Clases genéricas
Interfaces genéricas
Delegados
Genéricos
Diferencias entre plantillas de C++ y
tipos genéricos de C# (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los tipos genéricos de C# y las plantillas de C++ son dos características de lenguaje que
ofrecen compatibilidad con tipos parametrizados. Pero existen muchas diferencias entre
ambos. En el nivel de sintaxis, los tipos genéricos de C# resultan un enfoque más
sencillo que los tipos parametrizados sin la complejidad de las plantillas de C++.
Además, C# no intenta ofrecer toda la funcionalidad que ofrecen las plantillas de C++.
En el nivel de implementación, la principal diferencia es que las sustituciones de tipo
genérico de C# se realizan en tiempo de ejecución y, por tanto, se conserva la
información de tipo genérico para los objetos con instancias. Para obtener más
información, vea Genéricos en el motor en tiempo de ejecución.

Estas son las principales diferencias entre plantillas de C++ y tipos genéricos de C#:

Los tipos genéricos de C# no ofrecen tanta flexibilidad como las plantillas de C++.
Por ejemplo, no es posible llamar a operadores aritméticos en una clase de tipos
genéricos de C#, aunque es posible llamar a operadores definidos por el usuario.

C# no permite parámetros de plantilla sin tipo, como template C<int i> {} .

C# no admite la especialización explícita; es decir, una implementación

personalizada de una plantilla para un tipo específico.

C# no admite la especialización parcial: una implementación personalizada de un

subconjunto de los argumentos de tipo.

C# no permite que el parámetro de tipo se use como clase base del tipo genérico.

C# no permite que los parámetros de tipo tengan tipos predeterminados.

En C#, un parámetro de tipo genérico no puede ser un tipo genérico, aunque se

pueden usar tipos construidos como genéricos. C++ permite parámetros de
plantilla.

C++ permite código que podría no ser válido para todos los parámetros de tipo
en la plantilla, que luego busca el tipo específico que se usa como parámetro de
tipo. C# requiere que el código de una clase se escriba de manera que funcione
con cualquier tipo que cumpla las restricciones. Por ejemplo, en C++ es posible
 escribir una función que use los operadores aritméticos + y - en objetos del
parámetro de tipo, lo que producirá un error en el momento de creación de
instancias de la plantilla con un tipo que no admita estos operadores. C# no
permite esto; las únicas construcciones de lenguaje permitidas son las que se
pueden deducir de las restricciones.

Consulte también
Guía de programación de C#
Introducción a los genéricos
Templates (Plantillas [C++])
Genéricos en el motor en tiempo de
ejecución (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Cuando se compila un tipo o método genérico en el lenguaje intermedio de Microsoft

(MSIL), contiene metadatos que lo identifican como poseedor de parámetros de tipo. La
forma en que se usa MSIL para un tipo genérico depende de si el parámetro de tipo
proporcionado es un tipo de valor o de referencia.

Cuando se construye por primera vez un tipo genérico con un tipo de valor como
parámetro, el motor de ejecución crea un tipo genérico especializado sustituyendo el
parámetro o los parámetros proporcionados en los lugares adecuados del MSIL. Los
tipos genéricos especializados se crean una vez para cada tipo de valor único que se usa
como parámetro.

Por ejemplo, suponga que el código de su programa ha declarado una pila compuesta
por enteros:

C#

Stack<int> stack;

En este momento, el motor de ejecución genera una versión especializada de la clase

Stack<T> sustituyendo el entero adecuadamente para su parámetro. Ahora, cada vez
que el código de su programa use una pila de enteros, el motor en tiempo de ejecución
vuelve a usar la clase especializada generada Stack<T>. En el ejemplo siguiente, se
crean dos instancias de una pila de enteros y comparten una instancia única del código
Stack<int> :

C#

Stack<int> stackOne = new Stack<int>();

Stack<int> stackTwo = new Stack<int>();

En cambio, suponga que otra clase Stack<T> con un tipo de valor diferente, como un
long o una estructura definida por el usuario como parámetro, se crea en otro punto

del código. Como resultado, el motor de ejecución genera otra versión del tipo genérico
y sustituye un long en los lugares apropiados en el MSIL. Las conversiones ya no son
necesarias porque cada clase genérica especializada contiene de forma nativa el tipo de
valor.
Los genéricos funcionan de forma ligeramente distinta para los tipos de referencia.
Cuando se construye un tipo genérico por primera vez con un tipo de referencia, el
motor en tiempo de ejecución crea un tipo genérico especializado sustituyendo las
referencias a objetos para los parámetros del MSIL. Después, cada vez que se crea una
instancia de un tipo construido con un tipo de referencia como parámetro,
independientemente del tipo que sea, el motor de ejecución vuelve a usar la versión
especializada del tipo genérico previamente creada. Esto es posible porque todas las
referencias son del mismo tamaño.

Por ejemplo, suponga que tiene dos tipos de referencia, una clase Customer y una clase
Order , y que ha creado una pila de tipos Customer :

C#

class Customer { }

class Order { }

C#

Stack<Customer> customers;

En este punto, el motor de ejecución genera una versión especializada de la clase

Stack<T> que, en lugar de almacenar los datos, almacena referencias a objetos que se
rellenarán más tarde. Suponga que la línea siguiente de código crea una pila de otro
tipo de referencia, que se denomina Order :

C#

Stack<Order> orders = new Stack<Order>();

A diferencia de lo que sucede con los tipos de valor, no se crea otra versión
especializada de la clase Stack<T> para el tipo Order . En su lugar, se crea una instancia
de la versión especializada de la clase Stack<T> y se establece la variable orders para
hacer referencia a ella. Suponga que encuentra una línea de código para crear una pila
de tipo Customer :

C#

customers = new Stack<Customer>();

Como con el uso anterior de la clase Stack<T> creada usando el tipo Order , se crea otra
instancia de la clase especializada Stack<T>. Los punteros contenidos allí se establecen
para hacer referencia a un área de memoria del tamaño de un tipo Customer . Dado que
el número de tipos de referencia puede variar significativamente de un programa a otro,
la implementación de genéricos de C# reduce significativamente la cantidad de código
limitando a uno el número de clases especializadas creadas por el compilador para las
clases genéricas de tipos de referencia.

Además, cuando se crea una instancia de una clase de C# genérica mediante un

parámetro de tipo de valor o de referencia se puede consultar en tiempo de ejecución
mediante reflexión, y se puede comprobar tanto su tipo real como su parámetro de tipo.

Vea también
System.Collections.Generic
Guía de programación de C#
Introducción a los genéricos
Genéricos
Genéricos y reflexión (Guía de
programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 3 minutos

Dado que Common Language Runtime (CLR) tiene acceso a la información de tipos
genéricos en tiempo de ejecución, se puede usar la reflexión para obtener información
sobre los tipos genéricos de la misma manera que para los tipos no genéricos. Para
obtener más información, vea Genéricos en el motor en tiempo de ejecución.

En .NET Framework 2.0 se agregan nuevos miembros a la clase Type para habilitar la

información de tiempo de ejecución para tipos genéricos. Vea la documentación sobre
estas clases para obtener más información sobre cómo usar estos métodos y
propiedades. El espacio de nombres System.Reflection.Emit también contiene los
miembros nuevos que admiten genéricos. Vea Cómo: Definir un tipo genérico con
emisión de reflexión.

Para obtener una lista de las condiciones invariables para los términos usados en la
reflexión genérica, vea los comentarios de la propiedad IsGenericType.

Nombre de miembro Descripción

System.Type

IsGenericType Devuelve true si un tipo es genérico.

GetGenericArguments Devuelve una matriz de objetos Type que representan los

argumentos de tipo proporcionados para un tipo construido, o
los parámetros de tipo de una definición de tipo genérico.

GetGenericTypeDefinition Devuelve la definición de tipo genérico subyacente para el tipo

construido actual.

GetGenericParameterConstraints Devuelve una matriz de objetos Type que representan las

restricciones en el parámetro de tipo genérico actual.

ContainsGenericParameters Devuelve true si el tipo o cualquiera de sus tipos o métodos

envolventes contiene los parámetros de tipo para los que no
se proporcionaron tipos específicos.

GenericParameterAttributes Obtiene una combinación de marcas

GenericParameterAttributes que describen las restricciones
especiales del parámetro de tipo genérico actual.
 Nombre de miembro Descripción
System.Type

GenericParameterPosition Para un objeto Type que representa un parámetro de tipo,

obtiene la posición del parámetro de tipo en la lista de
parámetros de tipo de la definición de tipo genérico o de
método genérico que declaró el parámetro de tipo.

IsGenericParameter Obtiene un valor que indica si el objeto Type actual representa

un parámetro de tipo de una definición de un tipo o método
genérico.

IsGenericTypeDefinition Obtiene un valor que indica si el objeto Type actual representa

una definición de tipo genérico, a partir de la cual se pueden
construir otros tipos genéricos. Devuelve true si el tipo
representa la definición de un tipo genérico.

DeclaringMethod Devuelve el método genérico que definió el parámetro de tipo

genérico actual o NULL si el parámetro de tipo no se definió
mediante un método genérico.

MakeGenericType Sustituye los elementos de una matriz de tipos por los

parámetros de tipo de la definición de tipo genérico actual y
devuelve un objeto Type que representa el tipo construido
resultante.

Además, los miembros de la clase MethodInfo habilitan la información en tiempo de

ejecución para métodos genéricos. Para obtener una lista de las condiciones invariables
para los términos usados para reflejarse en métodos genéricos, vea los comentarios de
la propiedad IsGenericMethod.

Nombre de miembro Descripción

System.Reflection.MemberInfo

IsGenericMethod Devuelve true si un método es genérico.

GetGenericArguments Devuelve una matriz de objetos Type que representan los

argumentos de tipo de un método genérico construido o los
parámetros de tipo de una definición de método genérico.

GetGenericMethodDefinition Devuelve la definición de método genérico subyacente para el

método construido actual.

ContainsGenericParameters Devuelve true si el método o cualquiera de sus tipos

envolventes contiene los parámetros de tipo para los que no
se proporcionaron tipos específicos.

IsGenericMethodDefinition Devuelve True si el tipo MethodInfo actual representa la

definición de un método genérico.
Nombre de miembro Descripción
System.Reflection.MemberInfo

MakeGenericMethod Sustituye los elementos de una matriz de tipos por los

parámetros de tipo de la definición de método genérico
actual y devuelve un objeto MethodInfo que representa el
método construido resultante.

Vea también
Guía de programación de C#
Genéricos
Reflexión y tipos genéricos
Genéricos
Genéricos y atributos (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los atributos pueden aplicarse a los tipos genéricos de la misma manera que los tipos
no genéricos. Para obtener más información sobre la aplicación de los atributos, vea
Atributos.

Los atributos personalizados solo se permiten para hacer referencia a tipos genéricos
abiertos, que son tipos genéricos para los que no se proporciona ningún argumento de
tipo, y tipos genéricos construidos cerrados, que proporcionan argumentos para todos
los parámetros de tipo.

En los ejemplos siguientes se usa este atributo personalizado:

C#

class CustomAttribute : Attribute

public object? info;

Un atributo puede hacer referencia a un tipo genérico abierto:

C#

public class GenericClass1<T> { }

[CustomAttribute(info = typeof(GenericClass1<>))]

class ClassA { }

Especifica varios parámetros de tipo con el número de comas apropiado. En este

ejemplo, GenericClass2 tiene dos parámetros de tipo:

C#

public class GenericClass2<T, U> { }

[CustomAttribute(info = typeof(GenericClass2<,>))]

class ClassB { }

Un atributo puede hacer referencia a un tipo genérico construido cerrado:

 C#

public class GenericClass3<T, U, V> { }

[CustomAttribute(info = typeof(GenericClass3<int, double, string>))]

class ClassC { }

Un atributo que hace referencia a un parámetro de tipo genérico provocará un error en

tiempo de compilación:

C#

[CustomAttribute(info = typeof(GenericClass3<int, T, string>))] //Error

CS0416

class ClassD<T> { }

A partir de C# 11, un tipo genérico puede heredar de Attribute:

C#

public class CustomGenericAttribute<T> : Attribute { } //Requires C# 11

Para obtener información sobre un tipo genérico o un parámetro de tipo en tiempo de

ejecución, puede usar los métodos de System.Reflection. Para obtener más información,
vea Genéricos y reflexión.

Consulte también
Guía de programación de C#
Genéricos
Atributos
Sistema de archivos y el Registro (Guía
de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En los artículos siguientes se muestra cómo usar C# y .NET para realizar diversas
operaciones básicas en los archivos, las carpetas y el Registro.

En esta sección
Título Descripción

Procedimiento para recorrer en iteración Muestra cómo realizar una iteración manual a través
un árbol de directorio de un árbol de directorio.

Procedimiento para obtener información Muestra cómo recuperar información como las horas
sobre archivos, carpetas y unidades de creación y el tamaño, así como sobre archivos,
carpetas y unidades.

Procedimiento para crear archivos o Muestra cómo crear un archivo o una carpeta
carpetas nuevos.

Procedimiento para copiar, eliminar y Muestra cómo copiar, eliminar y mover archivos y
mover archivos y carpetas (Guía de carpetas.
programación de C#)

Procedimiento para proporcionar un Muestra cómo mostrar un cuadro de diálogo de

cuadro de diálogo de progreso para progreso estándar de Windows para determinadas
operaciones de archivos operaciones de archivo.

Procedimiento para escribir en un archivo Muestra cómo escribir en un archivo de texto.

texto

Procedimiento para leer de un archivo de Muestra cómo leer de un archivo de texto.

texto

Procedimiento para leer un archivo de Muestra cómo recuperar el texto de un archivo línea
texto línea a línea a línea.

Procedimiento para crear una clave en el Muestra cómo escribir una clave en el registro del
Registro sistema.

Secciones relacionadas
E/S de archivos y secuencias
Procedimiento para copiar, eliminar y mover archivos y carpetas (Guía de
programación de C#)
Guía de programación de C#
System.IO
Procedimiento Recorrer en iteración un
árbol de directorio (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

La frase "recorrer en iteración un árbol de directorios" significa obtener acceso a cada

uno de los archivos de todos los subdirectorios anidados bajo una carpeta raíz
especificada hasta un nivel de profundidad cualquiera. No es necesario abrir cada
archivo. Simplemente puede recuperar el nombre del archivo o subdirectorio como un
string , o puede recuperar información adicional en el formato de un objeto

System.IO.FileInfo o System.IO.DirectoryInfo.

７ Nota

En Windows, los términos "directorio" y "carpeta" se usan indistintamente. La

mayor parte de la documentación y del texto de la interfaz de usuario usa el
término "carpeta", pero las bibliotecas de clases de .NET usan el término
"directorio".

En el caso más simple, en el que sabe con seguridad que tiene permisos de acceso para
todos los directorios incluidos en una raíz especificada, puede usar la marca
System.IO.SearchOption.AllDirectories . Esta marca devuelve todos los subdirectorios
anidados que coinciden con el patrón especificado. En el ejemplo siguiente se muestra
cómo usar esta marca.

C#

root.GetDirectories("*.*", System.IO.SearchOption.AllDirectories);

El punto débil de este enfoque es que si uno de los subdirectorios incluidos en la raíz
especificada produce una excepción DirectoryNotFoundException o
UnauthorizedAccessException, se produce un error en todo el método y no devuelve
ningún directorio. Sucede lo mismo cuando usa el método GetFiles. Si tiene que
controlar estas excepciones en subcarpetas específicas, debe recorrer manualmente el
árbol de directorios, como se muestra en los ejemplos siguientes.

Al recorrer manualmente un árbol de directorios, puede controlar primero los archivos

(recorrido en preorden) o los subdirectorios (recorrido en postorden). Si realiza un
recorrido en preorden, visitará los archivos directamente en esa carpeta y, a
continuación, recorrerá todo el árbol en la carpeta actual. El recorrido en postorden
funciona al revés, recorriendo todo el árbol por debajo antes de llegar a los archivos de
la carpeta actual. Los ejemplos que se proporcionan más adelante en este documento
realizan un recorrido en preorden, pero puede modificarlos fácilmente para que realicen
un recorrido en postorden.

Otra opción consiste en usar la recursividad o un recorrido basado en la pila. Los

ejemplos que se proporcionan más adelante en este documento muestran ambos
enfoques.

Si tiene que realizar diversas operaciones en los archivos y las carpetas, puede dividir
estos ejemplos en partes mediante la refactorización de la operación en funciones
separadas que se puedan invocar usando un solo delegado.

７ Nota

Los sistemas de archivos NTFS pueden contener puntos de reanálisis en forma de

puntos de unión, vínculos simbólicos y vínculos físicos. Los métodos de .NET
Framework como GetFiles y GetDirectories no devolverán ningún subdirectorio en
un punto de reanálisis. Este comportamiento protege frente al riesgo de provocar
un bucle infinito cuando dos puntos de reanálisis se hacen referencia entre sí. En
general, debería ser muy cuidadoso al tratar con puntos de reanálisis para
asegurarse de no modificar o eliminar archivos involuntariamente. Si quiere
obtener un control preciso de los puntos de reanálisis, use la invocación de
plataforma o código nativo para llamar directamente a los métodos de sistema de
archivos Win32 adecuados.

Ejemplos
En el ejemplo siguiente se muestra cómo recorrer un árbol de directorios mediante
recursividad. El enfoque recursivo resulta elegante, pero puede producir una excepción
de desbordamiento de la pila si el árbol de directorios es grande y cuenta con muchos
elementos anidados.

Las excepciones concretas que se controlan y las acciones determinadas que se realizan
en cada archivo o carpeta se proporcionan simplemente como ejemplos. Debe
modificar este código para que se ajuste a sus requisitos concretos. Para obtener más
información, vea los comentarios del código.

C#
public class RecursiveFileSearch

static System.Collections.Specialized.StringCollection log = new

System.Collections.Specialized.StringCollection();

static void Main()

// Start with drives if you have to search the entire computer.

string[] drives = System.Environment.GetLogicalDrives();

foreach (string dr in drives)

System.IO.DriveInfo di = new System.IO.DriveInfo(dr);

// Here we skip the drive if it is not ready to be read. This

// is not necessarily the appropriate action in all scenarios.

if (!di.IsReady)

Console.WriteLine("The drive {0} could not be read",

di.Name);

continue;

System.IO.DirectoryInfo rootDir = di.RootDirectory;

WalkDirectoryTree(rootDir);

// Write out all the files that could not be processed.

Console.WriteLine("Files with restricted access:");

foreach (string s in log)

Console.WriteLine(s);
}

// Keep the console window open in debug mode.

Console.WriteLine("Press any key");

Console.ReadKey();

static void WalkDirectoryTree(System.IO.DirectoryInfo root)

System.IO.FileInfo[] files = null;

System.IO.DirectoryInfo[] subDirs = null;

// First, process all the files directly under this folder

try

files = root.GetFiles("*.*");

// This is thrown if even one of the files requires permissions

greater

// than the application provides.

catch (UnauthorizedAccessException e)

// This code just writes out the message and continues to

recurse.

 // You may decide to do something different here. For example,

you

// can try to elevate your privileges and access the file again.

log.Add(e.Message);

catch (System.IO.DirectoryNotFoundException e)

Console.WriteLine(e.Message);

if (files != null)

foreach (System.IO.FileInfo fi in files)

// In this example, we only access the existing FileInfo

object. If we

// want to open, delete or modify the file, then

// a try-catch block is required here to handle the case

// where the file has been deleted since the call to

TraverseTree().

Console.WriteLine(fi.FullName);

// Now find all the subdirectories under this directory.

subDirs = root.GetDirectories();

foreach (System.IO.DirectoryInfo dirInfo in subDirs)

// Resursive call for each subdirectory.

WalkDirectoryTree(dirInfo);

En el ejemplo siguiente se muestra cómo recorrer en iteración los archivos y las carpetas
de un árbol de directorios sin usar la recursividad. Esta técnica usa el tipo de colección
genérica Stack<T>, que es una pila de tipo LIFO (último en entrar, primero en salir).

Las excepciones concretas que se controlan y las acciones determinadas que se realizan
en cada archivo o carpeta se proporcionan simplemente como ejemplos. Debe
modificar este código para que se ajuste a sus requisitos concretos. Para obtener más
información, vea los comentarios del código.

C#

public class StackBasedIteration

static void Main(string[] args)

 // Specify the starting folder on the command line, or in

// Visual Studio in the Project > Properties > Debug pane.

TraverseTree(args[0]);

Console.WriteLine("Press any key");

Console.ReadKey();

public static void TraverseTree(string root)

// Data structure to hold names of subfolders to be

// examined for files.

Stack<string> dirs = new Stack<string>(20);

if (!System.IO.Directory.Exists(root))

throw new ArgumentException();

dirs.Push(root);

while (dirs.Count > 0)

string currentDir = dirs.Pop();

string[] subDirs;

try

subDirs = System.IO.Directory.GetDirectories(currentDir);

// An UnauthorizedAccessException exception will be thrown if we

do not have

// discovery permission on a folder or file. It may or may not

be acceptable

// to ignore the exception and continue enumerating the

remaining files and

// folders. It is also possible (but unlikely) that a

DirectoryNotFound exception

// will be raised. This will happen if currentDir has been

deleted by

// another application or thread after our call to

Directory.Exists. The

// choice of which exceptions to catch depends entirely on the

specific task

// you are intending to perform and also on how much you know
with certainty

// about the systems on which this code will run.

catch (UnauthorizedAccessException e)

Console.WriteLine(e.Message);

continue;

catch (System.IO.DirectoryNotFoundException e)

Console.WriteLine(e.Message);

continue;

 string[] files = null;

try

files = System.IO.Directory.GetFiles(currentDir);

catch (UnauthorizedAccessException e)

Console.WriteLine(e.Message);

continue;

catch (System.IO.DirectoryNotFoundException e)

Console.WriteLine(e.Message);

continue;

// Perform the required action on each file here.

// Modify this block to perform your required task.

foreach (string file in files)

try

// Perform whatever action is required in your scenario.

System.IO.FileInfo fi = new System.IO.FileInfo(file);

Console.WriteLine("{0}: {1}, {2}", fi.Name, fi.Length,

fi.CreationTime);

catch (System.IO.FileNotFoundException e)

// If file was deleted by a separate application

// or thread since the call to TraverseTree()

// then just continue.

Console.WriteLine(e.Message);

continue;

// Push the subdirectories onto the stack for traversal.

// This could also be done before handing the files.

foreach (string str in subDirs)

dirs.Push(str);

Generalmente se tarda mucho tiempo en comprobar cada carpeta para determinar si su

aplicación tiene permiso para abrirla. Por consiguiente, el ejemplo de código incluye esa
parte de la operación en un bloque try/catch . Puede modificar el bloque catch de
manera que, cuando se le deniegue el acceso a una carpeta, intente elevar sus permisos
y obtener acceso a esta de nuevo. Como norma, detecte solamente las excepciones que
puede controlar sin dejar la aplicación en un estado desconocido.

Si debe almacenar el contenido de un árbol de directorios, ya sea en memoria o en el

disco, la mejor opción es almacenar solamente la propiedad FullName (de tipo string )
para cada archivo. Después, puede usar esta cadena para crear un nuevo objeto FileInfo
o DirectoryInfo, según sea necesario, o para abrir cualquier archivo que requiera un
procesamiento adicional.

Programación sólida
Un código eficaz de iteración de archivos debe tener en cuenta las numerosas
dificultades del sistema de archivos. Para más información sobre el sistema de archivos
de Windows, vea NTFS overview (Introducción a NTFS).

Vea también
System.IO
LINQ y directorios de archivos
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento para obtener
información sobre archivos, carpetas y
unidades (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En .NET, puede acceder a información del sistema de archivos mediante las clases
siguientes:

System.IO.FileInfo

System.IO.DirectoryInfo

System.IO.DriveInfo

System.IO.Directory

System.IO.File

Las clases FileInfo y DirectoryInfo representan un archivo o directorio y contienen

propiedades que exponen muchos de los atributos de archivo admitidos por el sistema
de archivos NTFS. También contienen métodos para abrir, cerrar, mover y eliminar
archivos y carpetas. Para crear instancias de estas clases, pase una cadena que
represente el nombre del archivo, carpeta o unidad en el constructor:

C#

System.IO.DriveInfo di = new System.IO.DriveInfo(@"C:\");

También puede obtener los nombres de archivos, carpetas o unidades mediante

llamadas a DirectoryInfo.GetDirectories, DirectoryInfo.GetFiles y DriveInfo.RootDirectory.

Las clases System.IO.Directory y System.IO.File proporcionan métodos estáticos para

recuperar información sobre directorios y archivos.

Ejemplo
En el ejemplo siguiente se muestran diversas maneras de obtener acceso a información
sobre archivos y carpetas.

C#
class FileSysInfo

static void Main()

// You can also use System.Environment.GetLogicalDrives to

// obtain names of all logical drives on the computer.

System.IO.DriveInfo di = new System.IO.DriveInfo(@"C:\");

Console.WriteLine(di.TotalFreeSpace);

Console.WriteLine(di.VolumeLabel);

// Get the root directory and print out some information about it.

System.IO.DirectoryInfo dirInfo = di.RootDirectory;

Console.WriteLine(dirInfo.Attributes.ToString());

// Get the files in the directory and print out some information
about them.

System.IO.FileInfo[] fileNames = dirInfo.GetFiles("*.*");

foreach (System.IO.FileInfo fi in fileNames)

Console.WriteLine("{0}: {1}: {2}", fi.Name, fi.LastAccessTime,

fi.Length);

// Get the subdirectories directly that is under the root.

// See "How to: Iterate Through a Directory Tree" for an example of

how to

// iterate through an entire tree.

System.IO.DirectoryInfo[] dirInfos = dirInfo.GetDirectories("*.*");

foreach (System.IO.DirectoryInfo d in dirInfos)

Console.WriteLine(d.Name);

// The Directory and File classes provide several static methods

// for accessing files and directories.

// Get the current application directory.

string currentDirName = System.IO.Directory.GetCurrentDirectory();

Console.WriteLine(currentDirName);

// Get an array of file names as strings rather than FileInfo

objects.

// Use this method when storage space is an issue, and when you
might

// hold on to the file name reference for a while before you try to
access

// the file.

string[] files = System.IO.Directory.GetFiles(currentDirName,

"*.txt");

foreach (string s in files)

 // Create the FileInfo object only when needed to ensure

// the information is as current as possible.

System.IO.FileInfo fi = null;

try

fi = new System.IO.FileInfo(s);

catch (System.IO.FileNotFoundException e)

// To inform the user and continue is

// sufficient for this demonstration.

// Your application may require different behavior.

Console.WriteLine(e.Message);

continue;

Console.WriteLine("{0} : {1}",fi.Name, fi.Directory);

// Change the directory. In this case, first check to see

// whether it already exists, and create it if it does not.

// If this is not appropriate for your application, you can

// handle the System.IO.IOException that will be raised if the

// directory cannot be found.

if (!System.IO.Directory.Exists(@"C:\Users\Public\TestFolder\"))

System.IO.Directory.CreateDirectory(@"C:\Users\Public\TestFolder\");

System.IO.Directory.SetCurrentDirectory(@"C:\Users\Public\TestFolder\");

currentDirName = System.IO.Directory.GetCurrentDirectory();

Console.WriteLine(currentDirName);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

Programación sólida
Al procesar cadenas de ruta de acceso especificadas por el usuario, también debe
controlar las excepciones para las condiciones siguientes:

El nombre del archivo es incorrecto. Por ejemplo, contiene caracteres no válidos o

solo espacios en blanco.

El nombre del archivo es nulo.

 La longitud del nombre de archivo es superior a la longitud máxima definida por el
sistema.

El nombre de archivo contiene un signo de dos puntos (:).

Si la aplicación no tiene permisos suficientes para leer el archivo especificado, el método

Exists devuelve false con independencia de si existe una ruta de acceso; el método

no produce una excepción.

Vea también
System.IO
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento Crear archivos o carpetas
(Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Puede crear una carpeta en el equipo mediante programación, crear una subcarpeta,
crear un archivo en la subcarpeta y escribir datos en el archivo.

Ejemplo
C#

public class CreateFileOrFolder

static void Main()

// Specify a name for your top-level folder.

string folderName = @"c:\Top-Level Folder";

// To create a string that specifies the path to a subfolder under

your

// top-level folder, add a name for the subfolder to folderName.

string pathString = System.IO.Path.Combine(folderName, "SubFolder");

// You can write out the path name directly instead of using the
Combine

// method. Combine just makes the process easier.

string pathString2 = @"c:\Top-Level Folder\SubFolder2";

// You can extend the depth of your path if you want to.

//pathString = System.IO.Path.Combine(pathString, "SubSubFolder");

// Create the subfolder. You can verify in File Explorer that you
have this

// structure in the C: drive.

// Local Disk (C:)

// Top-Level Folder

// SubFolder

System.IO.Directory.CreateDirectory(pathString);

// Create a file name for the file you want to create.

string fileName = System.IO.Path.GetRandomFileName();

// This example uses a random string for the name, but you also can
specify

// a particular name.

//string fileName = "MyNewFile.txt";

// Use Combine again to add the file name to the path.

 pathString = System.IO.Path.Combine(pathString, fileName);

// Verify the path that you have constructed.

Console.WriteLine("Path to my file: {0}\n", pathString);

// Check that the file doesn't already exist. If it doesn't exist,

create

// the file and write integers 0 - 99 to it.

// DANGER: System.IO.File.Create will overwrite the file if it

already exists.

// This could happen even with random file names, although it is

unlikely.

if (!System.IO.File.Exists(pathString))

using (System.IO.FileStream fs =
System.IO.File.Create(pathString))

for (byte i = 0; i < 100; i++)

{

fs.WriteByte(i);

else

Console.WriteLine("File \"{0}\" already exists.", fileName);

return;

// Read and display the data from your file.

try

byte[] readBuffer = System.IO.File.ReadAllBytes(pathString);

foreach (byte b in readBuffer)

Console.Write(b + " ");

Console.WriteLine();

catch (System.IO.IOException e)

Console.WriteLine(e.Message);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
}

// Sample output:

// Path to my file: c:\Top-Level Folder\SubFolder\ttxvauxe.vv0

//0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
27 28 29

//30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
 53 54 55 56

// 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
80 81 82 8

//3 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99

Si la carpeta ya existe, CreateDirectory no efectúa ninguna acción y no se devuelve

ninguna excepción. Sin embargo, File.Create reemplaza un archivo existente por otro
nuevo. En el ejemplo se usa una instrucción if - else para evitar que se sustituya un
archivo existente.

Al realizar los siguientes cambios en el ejemplo, puede especificar diferentes resultados

en función de si ya existe un archivo con un nombre determinado. Si no existe ese
archivo, el código crea uno. Si ese archivo ya existe, el código anexa datos a ese archivo.

Especifique un nombre de archivo no aleatorio.

C#

// Comment out the following line.

//string fileName = System.IO.Path.GetRandomFileName();

// Replace that line with the following assignment.

string fileName = "MyNewFile.txt";

Sustituya la instrucción if - else por la instrucción using en el código siguiente.

C#

using (System.IO.FileStream fs = new System.IO.FileStream(pathString,

FileMode.Append))

for (byte i = 0; i < 100; i++)

fs.WriteByte(i);

Ejecute el ejemplo varias veces para comprobar que los datos se agreguen al archivo
cada vez.

Para obtener más valores FileMode que puede probar, consulte FileMode.

Las condiciones siguientes pueden provocar una excepción:

El nombre de la carpeta tiene un formato incorrecto. Por ejemplo, contiene

caracteres no válidos o solo tiene espacios en blanco (clase ArgumentException).
 Use la clase Path para crear nombres de ruta válidos.

La carpeta principal de la que se va a crear es de solo lectura (clase IOException).

El nombre de la carpeta es null (clase ArgumentNullException).

El nombre de la carpeta es demasiado largo (clase PathTooLongException).

El nombre de la carpeta es solo un carácter de dos puntos, ":" (clase

PathTooLongException).

Seguridad de .NET
En los casos de confiabilidad parcial, es posible que se devuelva una instancia de la clase
SecurityException.

Si no tiene permiso para crear la carpeta, el ejemplo devuelve una instancia de la clase
UnauthorizedAccessException.

Vea también
System.IO
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento Copiar, eliminar y mover
archivos y carpetas (Guía de
programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 3 minutos

En los siguientes ejemplos se muestra cómo copiar, mover y eliminar archivos y carpetas
de una manera sincrónica con las clases System.IO.File, System.IO.Directory,
System.IO.FileInfo y System.IO.DirectoryInfo desde el espacio de nombres System.IO. En
estos ejemplos no se proporciona una barra de progreso ni ninguna otra interfaz de
usuario. Si quiere proporcionar un cuadro de diálogo de progreso estándar, consulte
Procedimiento Proporcionar un cuadro de diálogo de progreso para operaciones de
archivos.

Use System.IO.FileSystemWatcher para proporcionar eventos que le permitan calcular el

progreso al realizar operaciones en varios archivos. Otro enfoque consiste en usar la
invocación de plataforma para llamar a los métodos pertinentes relacionados con
archivos en el shell de Windows. Para obtener información sobre cómo realizar estas
operaciones de archivo de forma asincrónica, vea E/S de archivos asincrónica.

Ejemplos
En el ejemplo siguiente se muestra cómo copiar archivos y directorios.

C#

// Simple synchronous file copy operations with no user interface.

// To run this sample, first create the following directories and files:

// C:\Users\Public\TestFolder

// C:\Users\Public\TestFolder\test.txt

// C:\Users\Public\TestFolder\SubDir\test.txt

public class SimpleFileCopy

static void Main()

string fileName = "test.txt";

string sourcePath = @"C:\Users\Public\TestFolder";

string targetPath = @"C:\Users\Public\TestFolder\SubDir";

// Use Path class to manipulate file and directory paths.

string sourceFile = System.IO.Path.Combine(sourcePath, fileName);

string destFile = System.IO.Path.Combine(targetPath, fileName);

// To copy a folder's contents to a new location:

// Create a new target folder.

 // If the directory already exists, this method does not create a

new directory.

System.IO.Directory.CreateDirectory(targetPath);

// To copy a file to another location and

// overwrite the destination file if it already exists.

System.IO.File.Copy(sourceFile, destFile, true);

// To copy all the files in one directory to another directory.

// Get the files in the source folder. (To recursively iterate

through

// all subfolders under the current directory, see

// "How to: Iterate Through a Directory Tree.")

// Note: Check for target path was performed previously

// in this code example.

if (System.IO.Directory.Exists(sourcePath))

string[] files = System.IO.Directory.GetFiles(sourcePath);

// Copy the files and overwrite destination files if they

already exist.

foreach (string s in files)

// Use static Path methods to extract only the file name

from the path.

fileName = System.IO.Path.GetFileName(s);

destFile = System.IO.Path.Combine(targetPath, fileName);

System.IO.File.Copy(s, destFile, true);

else

Console.WriteLine("Source path does not exist!");

// Keep console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

En el ejemplo siguiente se muestra cómo mover archivos y directorios.

C#

// Simple synchronous file move operations with no user interface.

public class SimpleFileMove

static void Main()

string sourceFile = @"C:\Users\Public\public\test.txt";

string destinationFile = @"C:\Users\Public\private\test.txt";

 // To move a file or folder to a new location:

System.IO.File.Move(sourceFile, destinationFile);

// To move an entire directory. To programmatically modify or

combine

// path strings, use the System.IO.Path class.

System.IO.Directory.Move(@"C:\Users\Public\public\test\",
@"C:\Users\Public\private");

En el ejemplo siguiente se muestra cómo eliminar archivos y directorios.

C#

// Simple synchronous file deletion operations with no user interface.

// To run this sample, create the following files on your drive:

// C:\Users\Public\DeleteTest\test1.txt

// C:\Users\Public\DeleteTest\test2.txt

// C:\Users\Public\DeleteTest\SubDir\test2.txt

public class SimpleFileDelete

static void Main()

// Delete a file by using File class static method...

if(System.IO.File.Exists(@"C:\Users\Public\DeleteTest\test.txt"))

// Use a try block to catch IOExceptions, to

// handle the case of the file already being

// opened by another process.

try

System.IO.File.Delete(@"C:\Users\Public\DeleteTest\test.txt");

catch (System.IO.IOException e)

Console.WriteLine(e.Message);

return;

// ...or by using FileInfo instance method.

System.IO.FileInfo fi = new
System.IO.FileInfo(@"C:\Users\Public\DeleteTest\test2.txt");

try

fi.Delete();

catch (System.IO.IOException e)

Console.WriteLine(e.Message);

// Delete a directory. Must be writable or empty.

try

System.IO.Directory.Delete(@"C:\Users\Public\DeleteTest");

catch (System.IO.IOException e)

Console.WriteLine(e.Message);

// Delete a directory and all subdirectories with Directory static

method...

if(System.IO.Directory.Exists(@"C:\Users\Public\DeleteTest"))

try

System.IO.Directory.Delete(@"C:\Users\Public\DeleteTest",
true);

catch (System.IO.IOException e)

Console.WriteLine(e.Message);

// ...or with DirectoryInfo instance method.

System.IO.DirectoryInfo di = new
System.IO.DirectoryInfo(@"C:\Users\Public\public");

// Delete this dir and all subdirs.

try

di.Delete(true);

catch (System.IO.IOException e)

Console.WriteLine(e.Message);

Consulte también
System.IO
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento para proporcionar un cuadro de diálogo de progreso para
operaciones de archivos
E/S de archivos y secuencias
Tareas de E/S comunes
Procedimiento Proporcionar un cuadro
de diálogo de progreso para
operaciones de archivos (Guía de
programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Puede proporcionar un cuadro de diálogo estándar que muestra el progreso en las

operaciones de archivo en Windows si usa el método CopyFile(String, String, UIOption)
en el espacio de nombres Microsoft.VisualBasic.

７ Nota

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos

de los elementos de la interfaz de usuario de Visual Studio en las siguientes
instrucciones. La edición de Visual Studio que se tenga y la configuración que se
utilice determinan estos elementos. Para obtener más información, vea
Personalizar el IDE.

Para agregar una referencia en Visual Studio

1. En la barra de menús, elija Proyecto, Agregar referencia.

Aparecerá el cuadro de diálogo Administrador de referencias.

2. En el área Ensamblados, elija Framework si no está ya seleccionado.

3. En la lista de nombres, seleccione la casilla Microsoft.VisualBasic y elija el botón

Aceptar para cerrar el cuadro de diálogo.

Ejemplo
El siguiente código copia el directorio que especifica sourcePath en el directorio que
especifica destinationPath . Este código también proporciona un cuadro de diálogo
estándar en el que se muestra el tiempo estimado restante antes de que finalice la
operación.

C#
 // The following using directive requires a project reference to
Microsoft.VisualBasic.

using Microsoft.VisualBasic.FileIO;

class FileProgress

static void Main()

// Specify the path to a folder that you want to copy. If the folder
is small,

// you won't have time to see the progress dialog box.

string sourcePath = @"C:\Windows\symbols\";

// Choose a destination for the copied files.

string destinationPath = @"C:\TestFolder";

FileSystem.CopyDirectory(sourcePath, destinationPath,

UIOption.AllDialogs);
}

Consulte también
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento Escribir en un archivo de
texto (Guía de programación de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En este artículo hay varios ejemplos en los que muestran distintas formas de escribir
texto en un archivo. En los dos primeros se usan métodos estáticos útiles de la clase
System.IO.File para escribir cada elemento de cualquier interfaz IEnumerable<string> y
un elemento string en un archivo de texto. En el tercer ejemplo se muestra cómo
agregar texto a un archivo cuando hay que procesar cada línea individualmente a
medida que se escribe en el archivo. En los tres primeros ejemplos se sobrescribe todo
el contenido existente del archivo. En el último ejemplo se muestra cómo anexar texto a
un archivo existente.

Todos estos ejemplos escriben literales de cadena en los archivos. Si quiere aplicar
formato al texto escrito en un archivo, use el método Format o la característica
interpolación de cadenas de C#.

Escritura de una colección de cadenas en un

archivo
C#

class WriteAllLines

public static async Task ExampleAsync()

string[] lines =

"First line", "Second line", "Third line"

};

await File.WriteAllLinesAsync("WriteLines.txt", lines);

En el ejemplo de código fuente anterior:

Se crea una instancia de una matriz de cadenas con tres valores.

Se espera una llamada a File.WriteAllLinesAsync que:

Crea de forma asincrónica un nombre de archivo WriteLines.txt. Si el archivo ya
existe, se sobrescribe.
 Escribe las líneas especificadas en el archivo.
Cierra el archivo, y vacía y elimina automáticamente según sea necesario.

Escritura de una cadena en un archivo

C#

class WriteAllText

public static async Task ExampleAsync()

string text =

"A class is the most powerful data type in C#. Like a structure,
" +

"a class defines the data and behavior of the data type. ";

await File.WriteAllTextAsync("WriteText.txt", text);

En el ejemplo de código fuente anterior:

Se crea una instancia de una cadena en función del literal de cadena asignado.

Se espera una llamada a File.WriteAllTextAsync que:

Crea de forma asincrónica un nombre de archivo WriteText.txt. Si el archivo ya
existe, se sobrescribe.
Escribe el texto especificado en el archivo.
Cierra el archivo, y vacía y elimina automáticamente según sea necesario.

Escritura de cadenas seleccionadas de una

matriz en un archivo
C#

class StreamWriterOne

public static async Task ExampleAsync()

string[] lines = { "First line", "Second line", "Third line" };

using StreamWriter file = new("WriteLines2.txt");

foreach (string line in lines)

if (!line.Contains("Second"))

 await file.WriteLineAsync(line);

En el ejemplo de código fuente anterior:

Se crea una instancia de una matriz de cadenas con tres valores.

Se crea una instancia de un objeto StreamWriter con una ruta de acceso de archivo
de WriteLines2.txt como una declaración using.
Itera por todas las líneas.
Espera condicionalmente una llamada a StreamWriter.WriteLineAsync(String), que
escribe la línea en el archivo cuando la línea no contiene "Second" .

Anexión de texto a un archivo existente

C#

class StreamWriterTwo

public static async Task ExampleAsync()

using StreamWriter file = new("WriteLines2.txt", append: true);

await file.WriteLineAsync("Fourth line");

En el ejemplo de código fuente anterior:

Se crea una instancia de una matriz de cadenas con tres valores.

Crea una instancia de un objeto StreamWriter con una ruta de acceso de archivo
de WriteLines2.txt como una declaración using, y se pasa true para anexar.
Espera una llamada a StreamWriter.WriteLineAsync(String), que escribe la cadena
en el archivo como una línea anexada.

Excepciones
Las condiciones siguientes pueden provocar una excepción:

InvalidOperationException; El archivo ya existe y es de solo lectura.

PathTooLongException; Puede que el nombre de ruta de acceso sea demasiado
largo.
IOException; Es posible que el disco esté lleno.
Existen condiciones adicionales que pueden iniciar excepciones cuando se trabaja con el
sistema de archivos; es mejor programar de forma defensiva.

Vea también
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento Leer de un archivo de
texto (Guía de programación de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se lee el contenido de un archivo de texto con los métodos estáticos
ReadAllText y ReadAllLines de la clase System.IO.File.

Para obtener un ejemplo en el que se usa StreamReader, consulte Procedimiento Leer

un archivo de texto línea a línea.

７ Nota

Los archivos que se usan en este ejemplo se crean en el tema Procedimiento

Escribir en un archivo texto.

Ejemplo
C#

class ReadFromFile

static void Main()

// The files used in this example are created in the topic

// How to: Write to a Text File. You can change the path and

// file name to substitute text files of your own.

// Example #1

// Read the file as one string.

string text =
System.IO.File.ReadAllText(@"C:\Users\Public\TestFolder\WriteText.txt");

// Display the file contents to the console. Variable text is a

string.

System.Console.WriteLine("Contents of WriteText.txt = {0}", text);

// Example #2

// Read each line of the file into a string array. Each element

// of the array is one line of the file.

string[] lines =
System.IO.File.ReadAllLines(@"C:\Users\Public\TestFolder\WriteLines2.txt");

// Display the file contents by using a foreach loop.

System.Console.WriteLine("Contents of WriteLines2.txt = ");

foreach (string line in lines)

// Use a tab to indent each line of the file.

Console.WriteLine("\t" + line);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
}

Compilar el código
Copie el código y péguelo en una aplicación de consola de C#.

Si no está usando los archivos de texto de Procedimiento Escribir en un archivo texto,

reemplace el argumento a ReadAllText y a ReadAllLines por la ruta de acceso
adecuada y el nombre de archivo en el equipo.

Programación sólida
Las condiciones siguientes pueden provocar una excepción:

El archivo no existe o no existe en la ubicación especificada. Compruebe la ruta de

acceso y la ortografía del nombre de archivo.

Seguridad de .NET
No confíe en el nombre de un archivo para determinar el contenido del archivo. Por
ejemplo, el archivo myFile.cs puede que no sea un archivo de código fuente de C#.

Vea también
System.IO
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento para leer un archivo de
texto de línea en línea (guía de
programación de C#)
Artículo • 04/01/2023 • Tiempo de lectura: 2 minutos

En este ejemplo se lee el contenido de un archivo de texto línea a línea en una cadena
mediante el método ReadLines de la clase File . Cada línea de texto se almacena en la
cadena line y se muestra en la pantalla.

Ejemplo
C#

int counter = 0;

// Read the file and display it line by line.

foreach (string line in System.IO.File.ReadLines(@"c:\test.txt"))

System.Console.WriteLine(line);

counter++;

System.Console.WriteLine("There were {0} lines.", counter);

// Suspend the screen.

System.Console.ReadLine();

Compilar el código
Copie el código y péguelo en el método Main de una aplicación de consola.

Reemplace "c:\test.txt" por el nombre de archivo real.

Programación sólida
Las condiciones siguientes pueden provocar una excepción:

El archivo podría no existir.

Seguridad de .NET
No tome ninguna decisión sobre el contenido del archivo basándose en su nombre. Por
ejemplo, es posible que el archivo myFile.cs no sea un archivo de código fuente de C#.

Vea también
System.IO
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Procedimiento para crear una clave del
Registro (guía de programación de C#)
Artículo • 28/11/2022 • Tiempo de lectura: 2 minutos

En este ejemplo se agrega el par de valores "Name" e "Isabella" al Registro del usuario
actual en la clave "Names".

Ejemplo
C#

Microsoft.Win32.RegistryKey key;

key = Microsoft.Win32.Registry.CurrentUser.CreateSubKey("Names");

key.SetValue("Name", "Isabella");

key.Close();

Compilar el código
Copie el código y péguelo en el método Main de una aplicación de consola.

Sustituya el parámetro Names por el nombre de una clave que exista directamente
en el nodo HKEY_CURRENT_USER del Registro.

Sustituya el parámetro Name por el nombre de un valor que exista directamente en

el nodo Names.

Programación sólida
Examine la estructura del Registro para buscar una ubicación adecuada para la clave. Por
ejemplo, es posible que quiera abrir la clave Software del usuario actual y crear una
clave con el nombre de la empresa. Luego agregue los valores del Registro a la clave de
la empresa.

Las condiciones siguientes pueden generar una excepción:

Que el nombre de la clave sea nulo.

Que el usuario no tenga permisos para crear claves del Registro.

Que el nombre de la clave supere el límite de 255 caracteres.

 Que la clave esté cerrada.

Que la clave del Registro sea de solo lectura.

Seguridad de .NET
Es más seguro escribir datos en la carpeta de usuario
( Microsoft.Win32.Registry.CurrentUser ) que en el equipo local
( Microsoft.Win32.Registry.LocalMachine ).

Cuando se crea un valor del Registro, se debe decidir qué hacer si ese valor ya existe.
Puede que otro proceso, quizás uno malintencionado, ya haya creado el valor y tenga
acceso a él. Al colocar datos en el valor del Registro, estos están a disposición del otro
proceso. Para evitarlo, use el método Método
Overload:Microsoft.Win32.RegistryKey.GetValue . Si la clave aún no existe, devuelve null.

No es seguro almacenar secretos, como contraseñas, en el Registro como texto sin

formato, aunque la clave del Registro esté protegida mediante listas de control de
acceso (ACL).

Vea también
System.IO
Guía de programación de C#
Registro y sistema de archivos (Guía de programación de C#)
Read, write and delete from the registry with C# (Leer, escribir y eliminar en el
Registro con C#)
Interoperability Overview
Artículo • 25/02/2023 • Tiempo de lectura: 3 minutos

Interoperability enables you to preserve and take advantage of existing investments in

unmanaged code. Code that runs under the control of the common language runtime
(CLR) is managed code, and code that runs outside the CLR is unmanaged code. COM,
COM+, C++ components, ActiveX components, and Microsoft Windows API are
examples of unmanaged code.

.NET enables interoperability with unmanaged code through platform invoke services,
the System.Runtime.InteropServices namespace, C++ interoperability, and COM
interoperability (COM interop).

Platform Invoke
Platform invoke is a service that enables managed code to call unmanaged functions
implemented in dynamic link libraries (DLLs), such as the Microsoft Windows API. It
locates and invokes an exported function and marshals its arguments (integers, strings,
arrays, structures, and so on) across the interoperation boundary as needed.

For more information, see Consuming Unmanaged DLL Functions and How to use
platform invoke to play a WAV file.

７ Nota

The Common Language Runtime (CLR) manages access to system resources.

Calling unmanaged code that is outside the CLR bypasses this security mechanism,
and therefore presents a security risk. For example, unmanaged code might call
resources in unmanaged code directly, bypassing CLR security mechanisms. For
more information, see Security in .NET.

C++ Interop
You can use C++ interop, also known as It Just Works (IJW), to wrap a native C++ class.
C++ interop enables code authored in C# or another .NET language to access it. You
write C++ code to wrap a native DLL or COM component. Unlike other .NET languages,
Visual C++ has interoperability support that enables managed and unmanaged code in
the same application and even in the same file. You then build the C++ code by using
the /clr compiler switch to produce a managed assembly. Finally, you add a reference to
the assembly in your C# project and use the wrapped objects just as you would use
other managed classes.

Exposing COM Components to C#

You can consume a COM component from a C# project. The general steps are as
follows:

1. Locate a COM component to use and register it. Use regsvr32.exe to register or
un–register a COM DLL.
2. Add to the project a reference to the COM component or type library.
When you
add the reference, Visual Studio uses the Tlbimp.exe (Type Library Importer), which
takes a type library as input, to output a .NET interop assembly. The assembly, also
named a runtime callable wrapper (RCW), contains managed classes and interfaces
that wrap the COM classes and interfaces that are in the type library. Visual Studio
adds to the project a reference to the generated assembly.
3. Create an instance of a class defined in the RCW. Creating an instance of that class
creates an instance of the COM object.
4. Use the object just as you use other managed objects. When the object is
reclaimed by garbage collection, the instance of the COM object is also released
from memory.

For more information, see Exposing COM Components to the .NET Framework.

Exposing C# to COM
COM clients can consume C# types that have been correctly exposed. The basic steps to
expose C# types are as follows:

1. Add interop attributes in the C# project.

You can make an assembly COM visible by
modifying C# project properties. For more information, see Assembly Information
Dialog Box.
2. Generate a COM type library and register it for COM usage.
You can modify C#
project properties to automatically register the C# assembly for COM interop.
Visual Studio uses the Regasm.exe (Assembly Registration Tool), using the /tlb
command-line switch, which takes a managed assembly as input, to generate a
type library. This type library describes the public types in the assembly and adds
registry entries so that COM clients can create managed classes.

For more information, see Exposing .NET Framework Components to COM and Example
COM Class.
See also
Improving Interop Performance
Introduction to Interoperability between COM and .NET
Introduction to COM Interop in Visual Basic
Marshaling between Managed and Unmanaged Code
Interoperating with Unmanaged Code
Interoperability Overview
Artículo • 25/02/2023 • Tiempo de lectura: 3 minutos

Interoperability enables you to preserve and take advantage of existing investments in

unmanaged code. Code that runs under the control of the common language runtime
(CLR) is managed code, and code that runs outside the CLR is unmanaged code. COM,
COM+, C++ components, ActiveX components, and Microsoft Windows API are
examples of unmanaged code.

.NET enables interoperability with unmanaged code through platform invoke services,
the System.Runtime.InteropServices namespace, C++ interoperability, and COM
interoperability (COM interop).

Platform Invoke
Platform invoke is a service that enables managed code to call unmanaged functions
implemented in dynamic link libraries (DLLs), such as the Microsoft Windows API. It
locates and invokes an exported function and marshals its arguments (integers, strings,
arrays, structures, and so on) across the interoperation boundary as needed.

For more information, see Consuming Unmanaged DLL Functions and How to use
platform invoke to play a WAV file.

７ Nota

The Common Language Runtime (CLR) manages access to system resources.

Calling unmanaged code that is outside the CLR bypasses this security mechanism,
and therefore presents a security risk. For example, unmanaged code might call
resources in unmanaged code directly, bypassing CLR security mechanisms. For
more information, see Security in .NET.

C++ Interop
You can use C++ interop, also known as It Just Works (IJW), to wrap a native C++ class.
C++ interop enables code authored in C# or another .NET language to access it. You
write C++ code to wrap a native DLL or COM component. Unlike other .NET languages,
Visual C++ has interoperability support that enables managed and unmanaged code in
the same application and even in the same file. You then build the C++ code by using
the /clr compiler switch to produce a managed assembly. Finally, you add a reference to
the assembly in your C# project and use the wrapped objects just as you would use
other managed classes.

Exposing COM Components to C#

You can consume a COM component from a C# project. The general steps are as
follows:

1. Locate a COM component to use and register it. Use regsvr32.exe to register or
un–register a COM DLL.
2. Add to the project a reference to the COM component or type library.
When you
add the reference, Visual Studio uses the Tlbimp.exe (Type Library Importer), which
takes a type library as input, to output a .NET interop assembly. The assembly, also
named a runtime callable wrapper (RCW), contains managed classes and interfaces
that wrap the COM classes and interfaces that are in the type library. Visual Studio
adds to the project a reference to the generated assembly.
3. Create an instance of a class defined in the RCW. Creating an instance of that class
creates an instance of the COM object.
4. Use the object just as you use other managed objects. When the object is
reclaimed by garbage collection, the instance of the COM object is also released
from memory.

For more information, see Exposing COM Components to the .NET Framework.

Exposing C# to COM
COM clients can consume C# types that have been correctly exposed. The basic steps to
expose C# types are as follows:

1. Add interop attributes in the C# project.

You can make an assembly COM visible by
modifying C# project properties. For more information, see Assembly Information
Dialog Box.
2. Generate a COM type library and register it for COM usage.
You can modify C#
project properties to automatically register the C# assembly for COM interop.
Visual Studio uses the Regasm.exe (Assembly Registration Tool), using the /tlb
command-line switch, which takes a managed assembly as input, to generate a
type library. This type library describes the public types in the assembly and adds
registry entries so that COM clients can create managed classes.

For more information, see Exposing .NET Framework Components to COM and Example
COM Class.
See also
Improving Interop Performance
Introduction to Interoperability between COM and .NET
Introduction to COM Interop in Visual Basic
Marshaling between Managed and Unmanaged Code
Interoperating with Unmanaged Code
Cómo acceder a objetos de
interoperabilidad de Office
Artículo • 09/03/2023 • Tiempo de lectura: 11 minutos

C# tiene nuevas características que simplifican el acceso a objetos de la API de Office.

Las nuevas características incluyen argumentos con nombre y opcionales, un nuevo tipo
llamado dynamic y la capacidad de pasar argumentos a parámetros de referencia en los
métodos COM como si fueran parámetros de valor.

En este artículo se utilizarán las nuevas características para escribir código que crea y
muestra una hoja de cálculo de Microsoft Office Excel. Se escribe código para agregar
un documento de Office Word que contiene un icono que está vinculado a la hoja de
cálculo de Excel.

Para completar este tutorial, es necesario tener Microsoft Office Excel 2007 y Microsoft
Office Word 2007 —o una versión posterior— instalados en el equipo.

７ Nota

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos

de los elementos de la interfaz de usuario de Visual Studio en las siguientes
instrucciones. La edición de Visual Studio que se tenga y la configuración que se
utilice determinan estos elementos. Para obtener más información, vea
Personalizar el IDE.

） Importante

VSTO se basa en .NET Framework. Los complementos COM también se pueden

escribir con .NET Framework. No se pueden crear complementos de Office con
.NET Core y .NET 5 o versiones posteriores, las últimas versiones de .NET. Esto se
debe a que .NET Core/.NET 5 o versiones posteriores no pueden funcionar junto
con .NET Framework en el mismo proceso, y se pueden provocar errores de carga
de complementos. Puede seguir usando .NET Framework a fin de escribir
complementos VSTO y COM para Office. Microsoft no actualizará VSTO ni la
plataforma de complementos COM para usar .NET Core, o .NET 5 o versiones
posteriores. Puede utilizar .NET Core y .NET 5 o versiones posteriores, incluido
ASP.NET Core, para crear el lado servidor de complementos web de Office.
Para crear una aplicación de consola nueva
1. Inicie Visual Studio.
2. En el menú Archivo , seleccione Nuevoy haga clic en Proyecto. Aparecerá el
cuadro de diálogo Nuevo proyecto .
3. En el panel Plantillas instaladas, expanda C# y, a continuación, seleccione
Windows.
4. En la parte superior del cuadro de diálogo Nuevo proyecto, asegúrese de
seleccionar .NET Framework 4 (o una versión posterior) como plataforma de
destino.
5. En el panel Plantillas, seleccione Aplicación de consola.
6. Escriba un nombre para el proyecto en el campo Nombre.
7. Seleccione Aceptar.

El proyecto nuevo aparece en el Explorador de soluciones.

Para agregar referencias

1. En el Explorador de soluciones, haga clic con el botón derecho en el nombre del
proyecto y luego seleccione Agregar referencia. Aparecerá el cuadro de diálogo
Agregar referencia.
2. En la página de Ensamblados, seleccione Microsoft.Office.Interop.Word en la lista
Nombre de componente y, después, mantenga presionada la tecla CTRL y
seleccione Microsoft.Office.Interop.Excel. Si no ve los ensamblados, es posible
que tenga que instalarlos. Vea Cómo: Instalación de ensamblados de
interoperabilidad primarios de Office.
3. Seleccione Aceptar.

Para agregar las directivas using necesarias

En el Explorador de soluciones, haga clic con el botón derecho en el archivo Program.cs
y luego seleccione Ver código. Agregue las directivas using siguientes a la parte
superior del archivo de código:

C#

using Excel = Microsoft.Office.Interop.Excel;

using Word = Microsoft.Office.Interop.Word;

Para crear una lista de las cuentas bancarias

Pegue la definición de clase siguiente en Program.cs, bajo la clase Program .

C#

public class Account

public int ID { get; set; }

public double Balance { get; set; }

Agregue el código siguiente al método Main para crear una lista bankAccounts lista que
contenga dos cuentas.

C#

// Create a list of accounts.

var bankAccounts = new List<Account> {

new Account {

ID = 345678,

Balance = 541.27

},

new Account {

ID = 1230221,

Balance = -127.44

};

Para declarar un método que exporta

información de cuentas a Excel
1. Agregue el método siguiente a la clase Program para configurar una hoja de
cálculo de Excel. El método Add tiene un parámetro opcional para especificar una
plantilla determinada. Los parámetros opcionales permiten omitir el argumento
para ese parámetro si se desea utilizar el valor predeterminado del parámetro.
Dado que no ha proporcionado ningún argumento, Add usa la plantilla
predeterminada y crea un libro. La instrucción equivalente en versiones anteriores
de C# requiere un argumento de marcador de posición:
ExcelApp.Workbooks.Add(Type.Missing) .

C#

static void DisplayInExcel(IEnumerable<Account> accounts)

var excelApp = new Excel.Application();

// Make the object visible.

 excelApp.Visible = true;

// Create a new, empty workbook and add it to the collection returned

// by property Workbooks. The new workbook becomes the active workbook.

// Add has an optional parameter for specifying a particular template.

// Because no argument is sent in this example, Add creates a new

workbook.

excelApp.Workbooks.Add();

// This example uses a single workSheet. The explicit type casting is

// removed in a later procedure.

Excel._Worksheet workSheet = (Excel.Worksheet)excelApp.ActiveSheet;

Agregue el siguiente código al final de DisplayInExcel . El código inserta valores en las

dos primeras columnas de la primera fila de la hoja de cálculo.

C#

// Establish column headings in cells A1 and B1.

workSheet.Cells[1, "A"] = "ID Number";

workSheet.Cells[1, "B"] = "Current Balance";

Agregue el siguiente código al final de DisplayInExcel . El bucle foreach coloca la

información de la lista de cuentas en las dos primeras columnas de filas sucesivas de la
hoja de cálculo.

C#

var row = 1;

foreach (var acct in accounts)

row++;

workSheet.Cells[row, "A"] = acct.ID;

workSheet.Cells[row, "B"] = acct.Balance;

Agregue el código siguiente al final de DisplayInExcel para ajustar los anchos de

columna a fin de adaptarlos al contenido.

C#

workSheet.Columns[1].AutoFit();

workSheet.Columns[2].AutoFit();

Las versiones anteriores de C# requieren una conversión explícita para estas

operaciones, ya que ExcelApp.Columns[1] devuelve Object y AutoFit es un método
Range de Excel. Las siguientes líneas muestran la conversión.

C#

((Excel.Range)workSheet.Columns[1]).AutoFit();

((Excel.Range)workSheet.Columns[2]).AutoFit();

En C#, el valor devuelto Object se convierte automáticamente en dynamic si se hace

referencia al ensamblado mediante la opción del compilador EmbedInteropTypes o, de
forma equivalente, si la propiedad Incrustar tipos de interoperabilidad de Excel es true.
El valor predeterminado de esta propiedad es true.

Para ejecutar el proyecto

Agregue la línea siguiente al final de Main .

C#

// Display the list in an Excel spreadsheet.

DisplayInExcel(bankAccounts);

Presione CTRL+F5. Aparece una hoja de cálculo de Excel que contiene los datos de las
dos cuentas.

Para agregar un documento de Word

El código siguiente abre una aplicación de Word y crea un icono que se vincula a la hoja
de cálculo de Excel. Pegue el método CreateIconInWordDoc , proporcionado más
adelante en este paso, en la clase Program . CreateIconInWordDoc usa argumentos con
nombre y opcionales para reducir la complejidad de las llamadas de método a Add y
PasteSpecial. Estas llamadas incorporan otras dos características que simplifican las
llamadas a métodos COM que tienen parámetros de referencia. En primer lugar, puede
enviar argumentos a los parámetros de referencia como si fueran parámetros de valor.
Es decir, puede enviar valores directamente, sin necesidad de crear una variable para
cada parámetro de referencia. El compilador genera variables temporales para contener
los valores de argumento y las descarta cuando se regresa de la llamada. En segundo
lugar, se puede omitir la palabra clave ref en la lista de argumentos.
El método Add tiene cuatro parámetros de referencia, todos ellos opcionales. Puede
omitir los argumentos de cualquiera o de todos los parámetros si desea usar sus valores
predeterminados.

El método PasteSpecial inserta el contenido del Portapapeles. El método tiene siete

parámetros de referencia, todos ellos opcionales. El siguiente código especifica los
argumentos para dos de ellos: Link , para crear un vínculo con el origen del contenido
del Portapapeles, y DisplayAsIcon , para mostrar el vínculo como un icono. Puede usar
argumentos con nombre para esos dos argumentos y omitir los demás. Aunque estos
argumentos son parámetros de referencia, no es necesario utilizar la palabra clave ref
ni crear variables para enviarlas como argumentos. Puede enviar los valores
directamente.

C#

static void CreateIconInWordDoc()

var wordApp = new Word.Application();

wordApp.Visible = true;

// The Add method has four reference parameters, all of which are

// optional. Visual C# allows you to omit arguments for them if

// the default values are what you want.

wordApp.Documents.Add();

// PasteSpecial has seven reference parameters, all of which are

// optional. This example uses named arguments to specify values

// for two of the parameters. Although these are reference

// parameters, you do not need to use the ref keyword, or to create

// variables to send in as arguments. You can send the values directly.

wordApp.Selection.PasteSpecial( Link: true, DisplayAsIcon: true);

Agregue la siguiente instrucción al final de Main .

C#

// Create a Word document that contains an icon that links to

// the spreadsheet.

CreateIconInWordDoc();

Agregue la siguiente instrucción al final de DisplayInExcel . El método Copy agrega la

hoja de cálculo en el Portapapeles.

C#
 // Put the spreadsheet contents on the clipboard. The Copy method has one

// optional parameter for specifying a destination. Because no argument

// is sent, the destination is the Clipboard.

workSheet.Range["A1:B3"].Copy();

Presione CTRL+F5. Un documento de Word aparecerá con un icono. Haga doble clic en
el icono para abrir la hoja de cálculo en primer plano.

Para establecer la propiedad Incrustar tipos de

interoperabilidad
Es posible realizar más mejoras si se llama a un tipo COM que no requiere un
ensamblado de interoperabilidad primario (PIA) en tiempo de ejecución. Si se elimina la
dependencia de PIA, la versión gana en independencia y se facilita la implementación.
Para obtener más información sobre las ventajas de la programación sin PIA, consulte
Tutorial: Insertar los tipos de los ensamblados administrados.

Además, la programación es más fácil porque el tipo dynamic representa los tipos
requeridos y devueltos que se declaran en los métodos COM. Las variables de tipo
dynamic no se evalúan hasta el tiempo de ejecución, lo que elimina la necesidad de la

conversión explícita. Para obtener más información, vea Uso del tipo dynamic.

El comportamiento predeterminado es insertar información de tipos en lugar de utilizar

los ensamblados de interoperabilidad primarios. Debido a ese comportamiento
predeterminado, algunos de los ejemplos anteriores se simplifican. No necesita ninguna
conversión explícita. Por ejemplo, la declaración de worksheet en DisplayInExcel se
escribe como Excel._Worksheet workSheet = excelApp.ActiveSheet en lugar de
Excel._Worksheet workSheet = (Excel.Worksheet)excelApp.ActiveSheet . Las llamadas a

AutoFit en el mismo método también requerirían conversión explícita sin el valor

predeterminado, porque ExcelApp.Columns[1] devuelve Object y AutoFit es un método

de Excel. En el código siguiente se muestra la conversión.

C#

((Excel.Range)workSheet.Columns[1]).AutoFit();

((Excel.Range)workSheet.Columns[2]).AutoFit();

Para cambiar el valor predeterminado y usar los ensamblados de interoperabilidad

primarios en lugar de incrustar información de tipos, expanda el nodo Referencias del
Explorador de soluciones y, después, seleccione Microsoft.Office.Interop.Excel o
Microsoft.Office.Interop.Word. Si no ve la ventana Propiedades, presione F4. Busque
Incrustar tipos de interoperabilidad en la lista de propiedades y cambie su valor a
False. Del mismo modo, se puede compilar mediante la opción del compilador
References en lugar de EmbedInteropTypes en un símbolo del sistema.

Para agregar formato adicional a la tabla

Reemplace las dos llamadas a AutoFit en DisplayInExcel con la siguiente instrucción.

C#

// Call to AutoFormat in Visual C# 2010.

workSheet.Range["A1", "B3"].AutoFormat(

Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2);

El método AutoFormat tiene siete parámetros de valor, todos ellos opcionales. Los
argumentos con nombre y los argumentos opcionales permiten proporcionar
argumentos para ninguno, algunos o todos ellos. En la instrucción anterior, se
proporciona un argumento para uno solo de los parámetros, Format . Puesto que
Format es el primer parámetro de la lista correspondiente, no es necesario proporcionar

el nombre de parámetro. Sin embargo, la instrucción puede ser más fácil de entender si
se incluye el nombre del parámetro, como se muestra en el código siguiente.

C#

// Call to AutoFormat in Visual C# 2010.

workSheet.Range["A1", "B3"].AutoFormat(Format:

Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2);

Presione CTRL+F5 para ver el resultado. Puede encontrar otros formatos incluidos en la
enumeración XlRangeAutoFormat.

Ejemplo
En el código siguiente se muestra el ejemplo completo.

C#

using System.Collections.Generic;
using Excel = Microsoft.Office.Interop.Excel;

using Word = Microsoft.Office.Interop.Word;

namespace OfficeProgramminWalkthruComplete

class Walkthrough

static void Main(string[] args)

// Create a list of accounts.

var bankAccounts = new List<Account>

new Account {

ID = 345678,

Balance = 541.27

},

new Account {

ID = 1230221,

Balance = -127.44

};

// Display the list in an Excel spreadsheet.

DisplayInExcel(bankAccounts);

// Create a Word document that contains an icon that links to

// the spreadsheet.

CreateIconInWordDoc();

static void DisplayInExcel(IEnumerable<Account> accounts)

var excelApp = new Excel.Application();

// Make the object visible.

excelApp.Visible = true;

// Create a new, empty workbook and add it to the collection

returned

// by property Workbooks. The new workbook becomes the active

workbook.

// Add has an optional parameter for specifying a praticular

template.

// Because no argument is sent in this example, Add creates a

new workbook.

excelApp.Workbooks.Add();

// This example uses a single workSheet.

Excel._Worksheet workSheet = excelApp.ActiveSheet;

// Earlier versions of C# require explicit casting.

//Excel._Worksheet workSheet =
(Excel.Worksheet)excelApp.ActiveSheet;

// Establish column headings in cells A1 and B1.

workSheet.Cells[1, "A"] = "ID Number";

workSheet.Cells[1, "B"] = "Current Balance";

var row = 1;

foreach (var acct in accounts)

row++;

 workSheet.Cells[row, "A"] = acct.ID;

workSheet.Cells[row, "B"] = acct.Balance;

workSheet.Columns[1].AutoFit();

workSheet.Columns[2].AutoFit();

// Call to AutoFormat in Visual C#. This statement replaces the

// two calls to AutoFit.

workSheet.Range["A1", "B3"].AutoFormat(

Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2);

// Put the spreadsheet contents on the clipboard. The Copy

method has one

// optional parameter for specifying a destination. Because no

argument

// is sent, the destination is the Clipboard.

workSheet.Range["A1:B3"].Copy();

static void CreateIconInWordDoc()

var wordApp = new Word.Application();

wordApp.Visible = true;

// The Add method has four reference parameters, all of which

are

// optional. Visual C# allows you to omit arguments for them if

// the default values are what you want.

wordApp.Documents.Add();

// PasteSpecial has seven reference parameters, all of which are

// optional. This example uses named arguments to specify values

// for two of the parameters. Although these are reference

// parameters, you do not need to use the ref keyword, or to

create

// variables to send in as arguments. You can send the values

directly.

wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true);

public class Account

public int ID { get; set; }

public double Balance { get; set; }

Consulte también
Type.Missing
dynamic
Argumentos opcionales y con nombre
Procedimiento para usar argumentos opcionales y con nombre en la programación
de Office
Procedimiento para usar propiedades
indizadas en la programación de
interoperabilidad COM
Artículo • 09/03/2023 • Tiempo de lectura: 2 minutos

Las propiedades indexadas funcionan junto con otras características de C#, como los
argumentos con nombre y opcionales, un nuevo tipo (dinámico) y la información de
tipo incrustada, para mejorar la programación en Microsoft Office.

） Importante

VSTO se basa en .NET Framework. Los complementos COM también se pueden

escribir con .NET Framework. No se pueden crear complementos de Office con
.NET Core y .NET 5 o versiones posteriores, las últimas versiones de .NET. Esto se
debe a que .NET Core/.NET 5 o versiones posteriores no pueden funcionar junto
con .NET Framework en el mismo proceso, y se pueden provocar errores de carga
de complementos. Puede seguir usando .NET Framework a fin de escribir
complementos VSTO y COM para Office. Microsoft no actualizará VSTO ni la
plataforma de complementos COM para usar .NET Core, o .NET 5 o versiones
posteriores. Puede utilizar .NET Core y .NET 5 o versiones posteriores, incluido
ASP.NET Core, para crear el lado servidor de complementos web de Office.

En versiones anteriores de C#, los métodos son solo accesibles como propiedades si el
método get no tiene ningún parámetro y el método set tiene solo un parámetro de
valor. En cambio, no todas las propiedades COM cumplen esas restricciones. Por
ejemplo, la propiedad Range[] de Excel tiene un descriptor de acceso get que requiere
un parámetro para el nombre del intervalo. Antes, como no había acceso directo a la
propiedad Range , había que usar el método get_Range en su lugar, como se muestra en
el ejemplo siguiente.

{language}

// Visual C# 2008 and earlier.

var excelApp = new Excel.Application();

// . . .

Excel.Range targetRange = excelApp.get_Range("A1", Type.Missing);

Las propiedades indexadas, en cambio, permiten escribir lo siguiente:

 {language}

// Visual C# 2010.

var excelApp = new Excel.Application();

// . . .

Excel.Range targetRange = excelApp.Range["A1"];

En el ejemplo anterior, también se usa la característica argumentos opcionales, que le

permite omitir Type.Missing .

Las propiedades indexadas permiten escribir el siguiente código.

{language}

// Visual C# 2010.

targetRange.Value = "Name";

No se pueden crear propiedades indexadas propias. La característica solo admite el uso

de las propiedades indizadas existentes.

Ejemplo
En el código siguiente se muestra un ejemplo completo. Para más información sobre
cómo preparar un proyecto con acceso a la API de Office, consulte Procedimiento Tener
acceso a objetos de interoperabilidad de Office mediante las características de Visual C#
(Guía de programación de C#).

{language}

// You must add a reference to Microsoft.Office.Interop.Excel to run

// this example.

using System;

using Excel = Microsoft.Office.Interop.Excel;

namespace IndexedProperties

class Program

static void Main(string[] args)

CSharp2010();

static void CSharp2010()

var excelApp = new Excel.Application();

excelApp.Workbooks.Add();

 excelApp.Visible = true;

Excel.Range targetRange = excelApp.Range["A1"];

targetRange.Value = "Name";

static void CSharp2008()

var excelApp = new Excel.Application();

excelApp.Workbooks.Add(Type.Missing);

excelApp.Visible = true;

Excel.Range targetRange = excelApp.get_Range("A1",

Type.Missing);

targetRange.set_Value(Type.Missing, "Name");

// Or

//targetRange.Value2 = "Name";

Vea también
Argumentos opcionales y con nombre
dynamic
Uso de tipo dinámico
Procedimiento para usar la invocación
de plataforma para reproducir un
archivo WAV
Artículo • 03/03/2023 • Tiempo de lectura: 2 minutos

En el siguiente ejemplo de código de C# se muestra cómo se usan los servicios de

invocación de plataforma para reproducir un archivo de sonido WAV en el sistema
operativo Windows.

Ejemplo
En este código de ejemplo se usa DllImportAttribute para importar el punto de entrada
del método winmm.dll de PlaySound como Form1 PlaySound() . El ejemplo tiene un
formulario Windows Forms simple con un botón. Al hacer clic en el botón, se abre un
cuadro de diálogo OpenFileDialog estándar de Windows para que pueda abrir un
archivo y reproducirlo. Cuando se selecciona un archivo de onda, se reproduce
mediante el método PlaySound() de la biblioteca winmm.dll. Para obtener más
información sobre este método, vea Using the PlaySound function with Waveform-
Audio Files (Uso de la función PlaySound con archivos para forma de onda de sonido).
Busque y seleccione un archivo que tenga una extensión .wav y, después, seleccione
Abrir para reproducirlo mediante la invocación de plataforma. Un cuadro de texto
muestra la ruta de acceso completa del archivo seleccionado.

C#

using System.Runtime.InteropServices;

namespace WinSound;

public partial class Form1 : Form

private TextBox textBox1;

private Button button1;

public Form1() // Constructor.

InitializeComponent();

[DllImport("winmm.DLL", EntryPoint = "PlaySound", SetLastError = true,

CharSet = CharSet.Unicode, ThrowOnUnmappableChar = true)]

private static extern bool PlaySound(string szSound, System.IntPtr hMod,

PlaySoundFlags flags);

 [System.Flags]

public enum PlaySoundFlags : int

SND_SYNC = 0x0000,

SND_ASYNC = 0x0001,

SND_NODEFAULT = 0x0002,

SND_LOOP = 0x0008,

SND_NOSTOP = 0x0010,

SND_NOWAIT = 0x00002000,

SND_FILENAME = 0x00020000,

SND_RESOURCE = 0x00040004
}

private void button1_Click(object sender, System.EventArgs e)

var dialog1 = new OpenFileDialog();

dialog1.Title = "Browse to find sound file to play";

dialog1.InitialDirectory = @"c:\";

//<Snippet5>

dialog1.Filter = "Wav Files (*.wav)|*.wav";

//</Snippet5>

dialog1.FilterIndex = 2;

dialog1.RestoreDirectory = true;

if (dialog1.ShowDialog() == DialogResult.OK)

textBox1.Text = dialog1.FileName;

PlaySound(dialog1.FileName, new System.IntPtr(),

PlaySoundFlags.SND_SYNC);

private void Form1_Load(object sender, EventArgs e)

// Including this empty method in the sample because in the IDE,

// when users click on the form, generates code that looks for a
default method

// with this name. We add it here to prevent confusion for those

using the samples.

El cuadro de diálogo Abrir archivos se puede filtrar con los valores correspondientes
para mostrar solo los archivos que tengan la extensión .wav.

Compilación del código

Cree un proyecto de aplicación Windows Forms para C# en Visual Studio y asígnele el
nombre WinSound. Copie el código anterior y péguelo sobre el contenido del archivo
Form1.cs. Copie el código siguiente y péguelo en el archivo Form1.Designer.cs, en el
método InitializeComponent() , después de cualquier código existente.

C#

this.button1 = new System.Windows.Forms.Button();

this.textBox1 = new System.Windows.Forms.TextBox();

this.SuspendLayout();

//

// button1

//

this.button1.Location = new System.Drawing.Point(192, 40);

this.button1.Name = "button1";

this.button1.Size = new System.Drawing.Size(88, 24);

this.button1.TabIndex = 0;

this.button1.Text = "Browse";

this.button1.Click += new System.EventHandler(this.button1_Click);

//

// textBox1

//

this.textBox1.Location = new System.Drawing.Point(8, 40);

this.textBox1.Name = "textBox1";

this.textBox1.Size = new System.Drawing.Size(168, 20);

this.textBox1.TabIndex = 1;

this.textBox1.Text = "File path";

//

// Form1

//

this.AutoScaleDimensions = new System.Drawing.SizeF(5, 13);

this.ClientSize = new System.Drawing.Size(292, 266);

this.Controls.Add(this.textBox1);

this.Controls.Add(this.button1);

this.Name = "Form1";

this.Text = "Platform Invoke WinSound C#";

this.ResumeLayout(false);

this.PerformLayout();

Compile y ejecute el código.

Consulte también
Aproximación a la invocación de plataforma
Serialización de datos con invocación de plataforma
Tutorial: Programación de Office en C#
Artículo • 09/03/2023 • Tiempo de lectura: 10 minutos

C# ofrece características que mejoran la programación de Microsoft Office. Las

características útiles de C# incluyen argumentos opcionales y con nombre, y devuelven
valores de tipo dynamic . En la programación COM, puede omitir la palabra clave ref y
obtener acceso a las propiedades indexadas.

En ambos lenguajes se puede insertar información de tipo, lo que permite la

implementación de ensamblados que interactúan con componentes COM sin necesidad
de implementar ensamblados de interoperabilidad primarios (PIA) en el equipo del
usuario. Para obtener más información, vea Tutorial: Insertar los tipos de los
ensamblados administrados.

En este tutorial se muestran estas características en el contexto de la programación de

Office, pero muchas de ellas también son útiles en la programación general. En el
tutorial, usa una aplicación complemento de Excel para crear un libro de Excel. Después,
crea un documento de Word que contiene un vínculo al libro. Por último, ve cómo
habilitar y deshabilitar la dependencia de un PIA.

） Importante

VSTO se basa en .NET Framework. Los complementos COM también se pueden

escribir con .NET Framework. No se pueden crear complementos de Office con
.NET Core y .NET 5 o versiones posteriores, las últimas versiones de .NET. Esto se
debe a que .NET Core/.NET 5 o versiones posteriores no pueden funcionar junto
con .NET Framework en el mismo proceso, y se pueden provocar errores de carga
de complementos. Puede seguir usando .NET Framework a fin de escribir
complementos VSTO y COM para Office. Microsoft no actualizará VSTO ni la
plataforma de complementos COM para usar .NET Core, o .NET 5 o versiones
posteriores. Puede aprovechar .NET Core y .NET 5 o versiones posteriores, incluido
ASP.NET Core, para crear el lado servidor de complementos web de Office.

Requisitos previos
Debe tener Microsoft Office Excel y Microsoft Office Word instalados en su equipo para
completar este tutorial.

７ Nota
 Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos
de los elementos de la interfaz de usuario de Visual Studio en las siguientes
instrucciones. La edición de Visual Studio que se tenga y la configuración que se
utilice determinan estos elementos. Para obtener más información, vea
Personalizar el IDE.

Configuración de una aplicación complemento

de Excel
1. Inicie Visual Studio.
2. En el menú Archivo , seleccione Nuevoy haga clic en Proyecto.
3. En el panel Plantillas instaladas, expanda C#, Office y, después, seleccione el año
de versión del producto de Office.
4. En el panel Plantillas, seleccione Excel <versión > Complemento.
5. En la parte superior del panel Plantillas, asegúrese de que .NET Framework 4 o
una versión posterior aparece en el cuadro Plataforma de destino.
6. Si quiere, escriba un nombre para el proyecto en el cuadro Nombre.
7. Seleccione Aceptar.
8. El proyecto nuevo aparece en el Explorador de soluciones.

Agregar referencias
1. En el Explorador de soluciones, haga clic con el botón derecho en el nombre del
proyecto y luego seleccione Agregar referencia. Aparecerá el cuadro de diálogo
Agregar referencia.
2. En la pestaña Ensamblados, seleccione Microsoft.Office.Interop.Excel, versión
<version>.0.0.0 (para obtener una clave de los números de versión de productos
de Office, vea Versiones de Microsoft ), en la lista Nombre de componente y,
después, mantenga presionada la tecla CTRL y seleccione
Microsoft.Office.Interop.Word, version <version>.0.0.0 . Si no ve los
ensamblados, es posible que tenga que instalarlos (vea Procedimientos para
instalar ensamblados de interoperabilidad primarios de Office).
3. Seleccione Aceptar.

Incorporación de las instrucciones Imports

necesarias o las directivas using
En el Explorador de soluciones, haga clic con el botón derecho en el archivo
ThisAddIn.cs y luego seleccione Ver código. Agregue las directivas using (C#)
siguientes en la parte superior del archivo de código si no están ya presentes.

C#

using System.Collections.Generic;
using Excel = Microsoft.Office.Interop.Excel;

using Word = Microsoft.Office.Interop.Word;

Creación de una lista de cuentas bancarias

En el Explorador de soluciones, haga clic con el botón derecho en el nombre del
proyecto, seleccione Agregar y luego Clase. Asigne un nombre a la clase Account.cs.
Seleccione Agregar. Reemplace la definición de la clase Account por el código siguiente.
Las definiciones de clase usan propiedades implementadas automáticamente.

C#

class Account

public int ID { get; set; }

public double Balance { get; set; }

Para crear una lista bankAccounts que contenga dos cuentas, agregue el código
siguiente al método ThisAddIn_Startup en ThisAddIn.cs. Las declaraciones de lista usan
inicializadores de colección.

C#

var bankAccounts = new List<Account>

new Account

ID = 345,

Balance = 541.27

},

new Account

ID = 123,

Balance = -127.44

};

Exportación de datos a Excel

En el mismo archivo, agregue el siguiente método a la clase ThisAddIn . El método
configura un libro de Excel, a donde exporta los datos.

C#

void DisplayInExcel(IEnumerable<Account> accounts,

Action<Account, Excel.Range> DisplayFunc)

var excelApp = this.Application;

// Add a new Excel workbook.

excelApp.Workbooks.Add();

excelApp.Visible = true;

excelApp.Range["A1"].Value = "ID";

excelApp.Range["B1"].Value = "Balance";

excelApp.Range["A2"].Select();

foreach (var ac in accounts)

DisplayFunc(ac, excelApp.ActiveCell);

excelApp.ActiveCell.Offset[1, 0].Select();

// Copy the results to the Clipboard.

excelApp.Range["A1:B3"].Copy();

El método Add tiene un parámetro opcional para especificar una plantilla

determinada. Los parámetros opcionales permiten omitir el argumento de ese
parámetro si se desea utilizar el valor predeterminado del parámetro. Como el
ejemplo anterior no tiene argumentos, Add usa la plantilla predeterminada y crea
un libro. La instrucción equivalente en versiones anteriores de C# requiere un
argumento de marcador de posición: excelApp.Workbooks.Add(Type.Missing) . Para
obtener más información, vea Argumentos opcionales y con nombre.
Las propiedades Range y Offset del objeto Range usan la característica de
propiedades indizadas. Esta característica permite utilizar estas propiedades de los
tipos COM mediante la siguiente sintaxis típica de C#. Las propiedades indizadas
también permiten utilizar la propiedad Value del objeto Range , eliminando la
necesidad de utilizar la propiedad Value2 . La propiedad Value está indizada, pero
el índice es opcional. Los argumentos opcionales y las propiedades indizadas
funcionan conjuntamente en el ejemplo siguiente.

C#

// Visual C# 2010 provides indexed properties for COM programming.

excelApp.Range["A1"].Value = "ID";

 excelApp.ActiveCell.Offset[1, 0].Select();

No se pueden crear propiedades indexadas propias. La característica solo admite el uso

de las propiedades indizadas existentes.

Agregue el código siguiente al final de DisplayInExcel para ajustar los anchos de

columna a fin de adaptarlos al contenido.

C#

excelApp.Columns[1].AutoFit();

excelApp.Columns[2].AutoFit();

Estas adiciones muestran otra característica de C#: el tratamiento de valores Object

devueltos por hosts COM, como Office, como si tuvieran un tipo dynamic. Los objetos
COM se tratan como dynamic de forma automática cuando Incrustar tipos de
interoperabilidad tiene su valor predeterminado, True , o equivalentemente, al hacer
referencia al ensamblado con la opción del compilador EmbedInteropTypes. Para
obtener más información sobre cómo insertar tipos de interoperabilidad, consulte los
procedimientos "Búsqueda de la referencia a un PIA" y "Restauración de la dependencia
de un PIA" más adelante en este artículo. Para obtener más información sobre dynamic ,
vea dynamic o Uso de tipo dinámico.

Invocación de DisplayInExcel
Agregue el código siguiente al final del método ThisAddIn_StartUp . La llamada a
DisplayInExcel contiene dos argumentos. El primer argumento es el nombre de la lista
de cuentas procesadas. El segundo argumento es una expresión lambda de varias líneas
que define cómo procesar los datos. Los valores ID y balance de cada cuenta se
muestran en las celdas adyacentes y la fila se muestra en rojo si el saldo es inferior a
cero. Para obtener más información, vea Expresiones lambda.

C#

DisplayInExcel(bankAccounts, (account, cell) =>

// This multiline lambda expression sets custom processing rules

// for the bankAccounts.

cell.Value = account.ID;

cell.Offset[0, 1].Value = account.Balance;

if (account.Balance < 0)

cell.Interior.Color = 255;

cell.Offset[0, 1].Interior.Color = 255;

});

Presione F5 para ejecutar el programa. Aparece una hoja de cálculo de Excel que
contiene los datos de las cuentas.

Incorporación de un documento de Word

Agregue el código siguiente al final del método ThisAddIn_StartUp para crear un
documento de Word que contenga un vínculo al libro de Excel.

C#

var wordApp = new Word.Application();

wordApp.Visible = true;

wordApp.Documents.Add();

wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true);

En este código se muestran varias de las características de C#: la capacidad de omitir la

palabra clave ref en programación COM, argumentos con nombre y argumentos
opcionales. El método PasteSpecial tiene siete parámetros y todos ellos son parámetros
de referencia opcionales. Los argumentos opcionales y con nombre permiten designar
los parámetros a los que se quiere tener acceso por nombre, y enviar argumentos
únicamente a esos parámetros. En este ejemplo, los argumentos indican la creación de
un vínculo al libro en el Portapapeles (parámetro Link ) y que el vínculo en el
documento de Word se muestra como un icono (parámetro DisplayAsIcon ). C# también
le permite omitir la palabra clave ref para estos argumentos.

Ejecución de la aplicación
Presione F5 para ejecutar la aplicación. Excel se abre y muestra una tabla que contiene la
información de las dos cuentas de bankAccounts . Entonces aparece un documento de
Word que contiene un vínculo a la tabla de Excel.

Limpieza del proyecto completado

En Visual Studio, seleccione Limpiar solución en el menú Compilación. De lo contrario,
el complemento se ejecutará cada vez que abra Excel en el equipo.

Búsqueda de la referencia de PIA

 1. Vuelva a ejecutar la aplicación, pero no seleccione Limpiar solución.
2. Seleccione Iniciar. Busque Microsoft Visual Studio <versión> y abra un símbolo
del sistema del desarrollador.
3. Escriba ildasm en la ventana Símbolo del sistema para desarrolladores de Visual
Studio y, luego, presione ENTRAR. Aparecerá la ventana IL DASM.
4. En el menú Archivo de la ventana de IL DASM, seleccione Archivo>Abrir. Haga
doble clic en Visual Studio <versión> y, después, haga doble clic en Proyectos.
Abra la carpeta de su proyecto y, en la carpeta bin/Debug, busque su_proyecto.dll.
Haga doble clic en su_proyecto.dll. Una nueva ventana muestra los atributos del
proyecto, además de las referencias a otros módulos y ensamblados. El
ensamblado incluye los espacios de nombres Microsoft.Office.Interop.Excel y
Microsoft.Office.Interop.Word . De manera predeterminada en Visual Studio, el
compilador importa los tipos necesarios desde un PIA con referencia a su
ensamblado. Para obtener más información, vea Cómo: Consulta del contenido de
un ensamblado.
5. Haga doble clic en el icono MANIFIESTO. Aparecerá una ventana con una lista de
ensamblados que contienen los elementos a los que hace referencia el proyecto.
Microsoft.Office.Interop.Excel y Microsoft.Office.Interop.Word no están en la

lista. Dado que importó los tipos que necesita el proyecto en el ensamblado, no es
necesario instalar referencias a un PIA. La importación de los tipos en el
ensamblado facilita la implementación. Los PIA no tienen que estar presentes en el
equipo del usuario. Una aplicación no requiere la implementación de una versión
específica de un PIA. Las aplicaciones pueden funcionar con varias versiones de
Office, siempre que existan las API necesarias en todas las versiones. Dado que la
implementación de los PIA ya no es necesaria, puede crear una aplicación en
escenarios avanzados que funcione con varias versiones de Office, incluidas
versiones anteriores. El código no puede usar ninguna API que no esté disponible
en la versión de Office con la que trabaja. No siempre está claro si una API
determinada estaba disponible en una versión anterior. No se recomienda trabajar
con versiones anteriores de Office.
6. Cierre la ventana del manifiesto y la del ensamblado.

Restauración de la dependencia de PIA

1. En el Explorador de soluciones, seleccione el botón Mostrar todos los archivos.
Expanda la carpeta Referencias y seleccione Microsoft.Office.Interop.Excel. Pulse
F4 para abrir la ventana Propiedades.
2. En la ventana Propiedades, cambie la propiedad Incrustar tipos de
interoperabilidad de True a False.
3. Repita los pasos 1 y 2 de este procedimiento para Microsoft.Office.Interop.Word .
 4. En C#, marque como comentario las dos llamadas a Autofit al final del método
DisplayInExcel .
5. Presione F5 para comprobar que el proyecto sigue ejecutándose correctamente.
6. Repita los pasos 1 a 3 del procedimiento anterior para abrir la ventana de
ensamblado. Observe que Microsoft.Office.Interop.Word y
Microsoft.Office.Interop.Excel ya no están en la lista de ensamblados

insertados.
7. Haga doble clic en el icono MANIFIESTO y desplácese por la lista de ensamblados
de referencia. Tanto Microsoft.Office.Interop.Word como
Microsoft.Office.Interop.Excel están en la lista. Dado que la aplicación hace

referencia a los PIA de Excel y Word y la propiedad Incrustar tipos de

interoperabilidad se establece en False, ambos ensamblados deben existir en el
equipo del usuario final.
8. En Visual Studio, seleccione Limpiar solución en el menú Compilación para limpiar
el proyecto completado.

Consulte también
Propiedades autoimplementadas (C#)
Inicializadores de objeto y colección
Argumentos opcionales y con nombre
dynamic
Uso de tipo dinámico
Expresiones lambda (C#)
Tutorial: Inserción de información de tipos de los ensamblados de Microsoft Office
en Visual Studio
Tutorial: Inserción de tipos de ensamblados administrados
Tutorial: Creación del primer complemento VSTO para Excel
Clase COM de ejemplo
Artículo • 03/03/2023 • Tiempo de lectura: 2 minutos

El código siguiente es un ejemplo de una clase que se expondría como un objeto COM.
Una vez que coloque este código en un archivo .cs agregado al proyecto, establezca la
propiedad Registrar para interoperabilidad COM en True. Para obtener más
información, vea Cómo: Registrar un componente para interoperabilidad COM.

Exponer objetos de C# para COM requiere declarar una interfaz de clase, una "interfaz
de eventos" si es necesario y la propia clase. Los miembros de clase deben seguir estas
reglas para que sean visibles en COM:

La clase debe ser pública.

Las propiedades, métodos y eventos deben ser públicos.
Las propiedades y métodos deben declararse en la interfaz de clase.
Los eventos deben declararse en la interfaz de eventos.

Los demás miembros públicos de la clase que no declare en estas interfaces no serán
visibles para COM, pero lo serán para otros objetos de .NET. Para exponer propiedades y
métodos en COM, se deben declarar en la interfaz de clase y marcar con el atributo
DispId , e implementarlos en la clase. El orden en que se declaran los miembros en la

interfaz es el orden que se usa para la tabla virtual de COM. Para exponer los eventos de
la clase, se deben declarar en la interfaz de eventos y marcarlos con un atributo DispId .
La clase no debe implementar esta interfaz.

La clase implementa la interfaz de clase y puede implementar más de una interfaz, pero
la primera implementación es la interfaz de clase predeterminada. Implemente los
métodos y propiedades expuestos para COM aquí. Deben ser públicos y coincidir con
las declaraciones de la interfaz de clase. Asimismo, declare los eventos iniciados por la
clase aquí. Deben ser públicos y coincidir con las declaraciones de la interfaz de eventos.

Ejemplo
C#

using System.Runtime.InteropServices;

namespace project_name

[Guid("EAA4976A-45C3-4BC5-BC0B-E474F4C3C83F")]

public interface ComClass1Interface

 [Guid("7BD20046-DF8C-44A6-8F6B-687FAA26FA71"),

InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]

public interface ComClass1Events

[Guid("0D53A3E8-E51A-49C7-944E-E72A2064F938"),

ClassInterface(ClassInterfaceType.None),

ComSourceInterfaces(typeof(ComClass1Events))]

public class ComClass1 : ComClass1Interface

Consulte también
Interoperabilidad
Página Compilar (Diseñador de proyectos) (C#)
Referencia de C#
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

En esta sección se proporciona material de referencia sobre palabras clave, operadores,

caracteres especiales, directivas de preprocesador, opciones del compilador y errores y
advertencias del compilador de C#.

En esta sección
Palabras clave de C#

Ofrece vínculos para información sobre palabras clave de C# y sintaxis.

Operadores de C#

Ofrece vínculos para información sobre operadores de C# y sintaxis.

Caracteres especiales de C#

Proporciona vínculos a información sobre los caracteres especiales contextuales en C# y

su uso.

Directivas de preprocesador de C#

Ofrece vínculos para información sobre los comandos del compilador para incrustar en
código fuente de C#.

Opciones del compilador de C#

Incluye información sobre las opciones del compilador y cómo usarlas.

Errores del compilador de C#

Incluye fragmentos de código que muestran la causa y la corrección de errores y

advertencias del compilador de C#.

Especificación del lenguaje C#

Especificación del lenguaje C# 6.0 Se trata de un borrador de propuesta para el lenguaje

C# 6.0. Este documento se perfeccionará por medio del trabajo con el comité de normas
de C# de ECMA. La versión 5.0 se ha publicado en diciembre de 2017 como el
documento Norma ECMA-334 estándar, quinta edición .

Las características que se han implementado en versiones de C# posteriores a 6.0 se

representan en las propuestas de especificación del lenguaje. Estos documentos
describen los deltas de la especificación del lenguaje con el fin de agregar estas nuevas
características. Están en formato de propuesta de borrador. Estas especificaciones se
perfeccionarán y enviarán al comité de normas de ECMA para su revisión formal e
incorporación a una versión futura del estándar de C#.
Propuestas de especificación de C# 7.0

Hay una serie de nuevas características implementadas en C# 7.0. Entre ellas, está la
coincidencia de patrones, las funciones locales, las declaraciones de variable out, las
expresiones throw, los literales binarios y los separadores de dígitos. Esta carpeta
contiene las especificaciones para cada una de esas características.

Propuestas de especificación de C# 7.1

Se han agregado nuevas características en C# 7.1. En primer lugar, puede escribir un

método Main que devuelva Task o Task<int> . Esto le permite agregar el modificador
async a Main . La expresión default puede usarse sin tipo en ubicaciones en las que sea
posible inferir el tipo. Además, se pueden inferir los nombres de los miembros de las
tuplas. Por último, se puede usar la coincidencia de patrones con genéricos.

Propuestas de especificación de C# 7.2

Se han agregado una serie de pequeñas características a C# 7.2. Puede pasar

argumentos por referencia de solo lectura mediante la palabra clave in . Se han
realizado diversos cambios de bajo nivel para admitir la seguridad en tiempo de
compilación para Span y tipos relacionados. Puede usar argumentos con nombre donde
los argumentos posteriores son posicionales, en algunos casos. El modificador de
acceso private protected permite especificar que los llamadores se limitan a los tipos
derivados que se implementan en el mismo ensamblado. El operador ?: se puede
resolver en una referencia a una variable. También puede dar formato a números
hexadecimales y binarios con un separador de dígito inicial.

Propuestas de especificación de C# 7.3

C# 7.3 es otra versión secundaria que incluye una serie de pequeñas actualizaciones.
Puede usar nuevas restricciones en parámetros de tipo genérico. Otros cambios hacen
que sea más fácil trabajar con campos fixed , incluido el uso de asignaciones stackalloc.
Las variables locales declaradas con la palabra clave ref pueden reasignarse para que
hagan referencia a un almacenamiento nuevo. Puede colocar atributos en propiedades
implementadas automáticamente que tengan como destino el campo de respaldo
generado por el compilador. Se pueden usar variables de expresión en inicializadores.
Las tuplas pueden compararse para comprobar si son iguales (o si no lo son). Además,
se han realizado algunas mejoras en la resolución de sobrecarga.

Propuestas de especificación de C# 8.0

C# 8.0 está disponible con .NET Core 3.0. Entre las características se incluyen tipos de
referencia que aceptan valores NULL, coincidencia de patrones recursiva, métodos de
interfaz predeterminados, secuencias asincrónicas, intervalos e índices, using basado en
patrones y declaraciones using, asignación de uso combinado de NULL y miembros de
instancia de solo lectura.
Propuestas de especificaciones de C# 9

C# 9 está disponible con .NET 5. Entre las características disponibles se incluyen las
siguientes: registros, instrucciones de nivel superior, mejoras en la coincidencia de
patrones, establecedores solo de inicialización, nuevas expresiones con tipo de destino,
inicializadores de módulos, ampliación de los métodos parciales, funciones anónimas
estáticas, expresiones condicionales con tipo de destino, tipos de retorno de
covariantes, extensión GetEnumerator en bucles Foreach, parámetros de descarte de
expresiones lambda, atributos en funciones locales, enteros de tamaño nativo, punteros
de funciones, supresión de la emisión de marcas localsinit y anotaciones de parámetros
de tipos sin restricciones.

Propuestas de especificaciones de C# 10

C# 10 está disponible con .NET 6. Las características incluyen estructuras de registro,
constructores de estructuras sin parámetros, directivas using globales, espacios de
nombres de ámbito de archivo, patrones de propiedades ampliados, cadenas
interpoladas mejoradas, cadenas interpoladas constantes, mejoras de lambda, expresión
de autor de llamada-argumento, directivas #line mejoradas, atributos genéricos,
análisis de asignaciones definitivas mejorados e invalidación de AsyncMethodBuilder .

Secciones relacionadas
Uso del entorno de desarrollo de Visual Studio para C#

Ofrece vínculos para los temas de tareas y conceptos y temas que describen el IDE y el
Editor.

Guía de programación de C#

Incluye información sobre cómo usar el lenguaje de programación de C#.

Control de versiones del lenguaje C#
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

El compilador de C# más actualizado determina una versión de lenguaje

predeterminada basada en los marcos o las plataformas de destino del proyecto.
Visual Studio no proporciona una interfaz de usuario para cambiar el valor, pero se
puede cambiar si se modifica el archivo csproj. La opción predeterminada garantiza que
se use la versión del lenguaje más reciente compatible con el marco de trabajo de
destino. Se beneficia del acceso a las características de lenguaje más recientes
compatibles con el destino del proyecto. Esta opción predeterminada también garantiza
que no se use un lenguaje que requiera tipos o el comportamiento en tiempo de
ejecución no esté disponible en la plataforma de destino. La elección de una versión del
lenguaje más reciente que la predeterminada puede provocar errores en tiempo de
compilación y en tiempo de ejecución difíciles de diagnosticar.

C# 11 solo se admite en .NET 7 y versiones más recientes. C# 10 solo se admite en
.NET 6 y versiones más recientes. C# 9 solo se admite en .NET 5 y versiones más
recientes.

Consulte la página Compatibilidad de la plataforma Visual Studio para más información

sobre qué versiones de .NET son compatibles con las versiones de Visual Studio.
Consulte la página Compatibilidad de la plataforma Visual Studio para Mac para más
información sobre qué versiones de .NET son compatibles con las versiones de
Visual Studio para Mac. Consulte la página de Mono para C# para ver la
compatibilidad de Mono con versiones de C#.

Valores predeterminados
El compilador determina un valor predeterminado según estas reglas:

Destino Versión Versión predeterminada del lenguaje C#

.NET 7.x C# 11

.NET 6.x C# 10

.NET 5.x C# 9.0

.NET Core 3.x C# 8.0

.NET Core 2.x C# 7.3

.NET Standard 2.1 C# 8.0

 Destino Versión Versión predeterminada del lenguaje C#

.NET Standard 2.0 C# 7.3

.NET Standard 1.x C# 7.3

.NET Framework todo C# 7.3

Cuando el proyecto tiene como destino un marco en versión preliminar que tenga una
versión de lenguaje preliminar correspondiente, la versión de lenguaje que se usa es la
que está en versión preliminar. Puede usar las características más recientes con esa
versión preliminar en cualquier entorno, sin que afecte a los proyectos que tienen como
destino una versión de .NET Core publicada.

） Importante

La nueva plantilla de proyecto de Visual Studio 2017 agregó una entrada

<LangVersion>latest</LangVersion> a los nuevos archivos de proyecto. Si actualiza
la plataforma de destino de estos proyectos, invalidan el comportamiento
predeterminado. Debe quitar <LangVersion>latest</LangVersion> del archivo del
proyecto al actualizar el SDK de .NET. Después, el proyecto usará la versión del
compilador recomendada para la plataforma de destino. Puede actualizar la
plataforma de destino para acceder a las características de lenguaje más recientes.

Invalidación de un valor predeterminado

Si debe especificar su versión de C# explícitamente, puede hacerlo de varias maneras:

Editar manualmente el archivo del proyecto.

Establecer la versión del lenguaje para varios proyectos en un subdirectorio.
Configure la opción del compilador LangVersion.

 Sugerencia

Puede ver la versión del lenguaje en Visual Studio en la página de propiedades del

proyecto. En la pestaña Compilar, el panel Opciones avanzadas muestra la versión
seleccionada.

Para saber qué versión de lenguaje está usando actualmente, incluya #error
version (con distinción de mayúsculas y minúsculas) en el código. Esto hace que el

compilador genere un error de compilador, CS8304, con un mensaje que contiene

 la versión del compilador que se usa y la versión del lenguaje seleccionada
actualmente. Vea #error (Referencia de C#) para obtener más información.

Edición del archivo del proyecto

Puede establecer la versión del lenguaje en el archivo del proyecto. Por ejemplo, si
quiere acceder explícitamente a las características en versión preliminar, agregue un
elemento similar al siguiente:

XML

<PropertyGroup>

<LangVersion>preview</LangVersion>

</PropertyGroup>

El valor preview usa la versión preliminar más reciente disponible del lenguaje C# que
admite el compilador.

Configurar varios proyectos

Para configurar varios proyectos, se puede crear un archivo Directory.Build.props que
contenga el elemento <LangVersion> . Por lo general, esto se hace en el directorio de la
solución. Agregue lo siguiente a un archivo Directory.Build.props en el directorio de la
solución:

XML

<Project>

<PropertyGroup>

<LangVersion>preview</LangVersion>

</PropertyGroup>

</Project>

Las compilaciones de todos los subdirectorios del directorio que contenga ese archivo
usarán la sintaxis de la versión preliminar de C#. Para obtener más información, consulte
Personalización de la compilación.

Referencia de la versión del lenguaje C#

En la siguiente tabla se muestran las versiones actuales del lenguaje C#. Es posible que
el compilador no entienda necesariamente todos los valores si es más antiguo. Si instala
el SDK de .NET más reciente, tendrá acceso a todo lo que aparece.

Valor Significado

preview El compilador acepta toda la sintaxis de lenguaje válida de la última versión

preliminar.

latest El compilador acepta la sintaxis de la última versión del compilador (incluida las
versión secundaria).

latestMajor
El compilador acepta la sintaxis de la versión principal más reciente del
o bien compilador.
default

11.0 El compilador solo acepta la sintaxis que se incluye en C# 11 o versiones

anteriores.

10.0 El compilador solo acepta la sintaxis que se incluye en C# 10 o versiones

anteriores.

9.0 El compilador solo acepta la sintaxis que se incluye en C# 9 o versiones anteriores.

8.0 El compilador acepta solo la sintaxis que se incluye en C# 8.0 o versiones

anteriores.

7.3 El compilador acepta solo la sintaxis que se incluye en C# 7.3 o versiones

anteriores.

7.2 El compilador acepta solo la sintaxis que se incluye en C# 7.2 o versiones

anteriores.

7.1 El compilador acepta solo la sintaxis que se incluye en C# 7.1 o versiones

anteriores.

7 El compilador acepta solo la sintaxis que se incluye en C# 7.0 o versiones

anteriores.

6 El compilador acepta solo la sintaxis que se incluye en C# 6.0 o versiones

anteriores.

5 El compilador acepta solo la sintaxis que se incluye en C# 5.0 o versiones

anteriores.

4 El compilador acepta solo la sintaxis que se incluye en C# 4.0 o versiones

anteriores.

3 El compilador acepta solo la sintaxis que se incluye en C# 3.0 o versiones

anteriores.

ISO-2
El compilador acepta solo la sintaxis que se incluye en ISO/IEC 23270:2006 C# (2.0).
o bien 2
Valor Significado

ISO-1
El compilador acepta solo la sintaxis que se incluye en ISO/IEC 23270:2003 C#
o bien 1 (1.0/1.2).
Tipos de valor (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Los tipos de valor y los tipos de referencia son las dos categorías principales de tipos de
C#. Una variable de un tipo de valor contiene una instancia del tipo. Esto difiere de una
variable de un tipo de referencia, que contiene una referencia a una instancia del tipo.
De forma predeterminada, al asignar, pasar un argumento a un método o devolver el
resultado de un método, se copian los valores de variable. En el caso de las variables de
tipo de valor, se copian las instancias de tipo correspondientes. En el ejemplo siguiente
se muestra ese comportamiento:

C#

using System;

public struct MutablePoint

public int X;

public int Y;

public MutablePoint(int x, int y) => (X, Y) = (x, y);

public override string ToString() => $"({X}, {Y})";

public class Program

public static void Main()

var p1 = new MutablePoint(1, 2);

var p2 = p1;

p2.Y = 200;

Console.WriteLine($"{nameof(p1)} after {nameof(p2)} is modified:

{p1}");

Console.WriteLine($"{nameof(p2)}: {p2}");

MutateAndDisplay(p2);

Console.WriteLine($"{nameof(p2)} after passing to a method: {p2}");

private static void MutateAndDisplay(MutablePoint p)

p.X = 100;

Console.WriteLine($"Point mutated in a method: {p}");

// Expected output:

// p1 after p2 is modified: (1, 2)

// p2: (1, 200)

 // Point mutated in a method: (100, 200)

// p2 after passing to a method: (1, 200)

Como se muestra en el ejemplo anterior, las operaciones en una variable de tipo de

valor solo afectan a esa instancia del tipo de valor, almacenado en la variable.

Si un tipo de valor contiene un miembro de datos de un tipo de referencia, solo se copia

la referencia a la instancia del tipo de referencia al copiar una instancia de tipo de valor.
Tanto la instancia de tipo de valor original como la copia tienen acceso a la misma
instancia de tipo de referencia. En el ejemplo siguiente se muestra ese comportamiento:

C#

using System;

using System.Collections.Generic;

public struct TaggedInteger

public int Number;

private List<string> tags;

public TaggedInteger(int n)

Number = n;

tags = new List<string>();

public void AddTag(string tag) => tags.Add(tag);

public override string ToString() => $"{Number} [{string.Join(", ",

tags)}]";

public class Program

public static void Main()

var n1 = new TaggedInteger(0);

n1.AddTag("A");

Console.WriteLine(n1); // output: 0 [A]

var n2 = n1;

n2.Number = 7;

n2.AddTag("B");

Console.WriteLine(n1); // output: 0 [A, B]

Console.WriteLine(n2); // output: 7 [A, B]

 ７ Nota

Para que el código sea menos propenso a errores y más sólido, defina y use tipos
de valor inmutables. En este artículo se usan tipos de valor mutables solo con fines
de demostración.

Clases de tipos de valor y restricciones de tipo

Un tipo de valor puede ser de una de las dos clases siguientes:

un tipo de estructura, que encapsula los datos y la funcionalidad relacionada;

un tipo de enumeración, que se define mediante un conjunto de constantes con
nombre y representa una opción o una combinación de opciones.

Un tipo de valor que admite un valor NULL T? representa todos los valores de su tipo de
valor T subyacente y un valor null adicional. No se puede asignar null a una variable
de un tipo de valor, a menos que sea un tipo de valor que acepte valores NULL.

Puede usar la restricción struct para especificar que un parámetro de tipo es un tipo de
valor que no acepta valores NULL. Los tipos de estructura y enumeración satisfacen la
restricción struct . Puede usar System.Enum en una restricción de clase base (conocida
como la restricción de enumeración) para especificar que un parámetro de tipo es un
tipo de enumeración.

Tipos de valor integrados

C# proporciona los siguientes tipos de valor integrados, también conocidos como tipos
simples:

Tipos numéricos integrales

Tipos numéricos de punto flotante
bool, que representa un valor booleano
char, que representa un carácter Unicode UTF-16

Todos los tipos simples son tipos de estructuras y se diferencian de otros tipos de
estructuras en que permiten determinadas operaciones adicionales:

Se pueden usar literales para proporcionar un valor de un tipo simple. Por ejemplo,
'A' es un literal del tipo char y 2001 es un literal del tipo int .
 Puede declarar constantes de los tipos simples con la palabra clave const. No es
posible tener constantes de otros tipos de estructuras.

Las expresiones constantes, cuyos operandos son todas constantes de los tipos
simples, se evalúan en tiempo de compilación.

Una tupla de valor es un tipo de valor, pero no un tipo simple.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Tipos de valor
Tipos simples
Variables

Vea también
Referencia de C#
System.ValueType
Tipos de referencia
Tipos numéricos enteros (referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Los tipos numéricos integrales representan números enteros. Todos los tipos numéricos
integrales son tipos de valor. También son tipos simples y se pueden inicializar con
literales. Todos los tipos numéricos enteros admiten operadores aritméticos, lógicos bit
a bit, de comparación y de igualdad.

Características de los tipos enteros

C# admite los siguientes tipos enteros predefinidos:

Palabra Intervalo Tamaño Tipo de .NET

clave/tipo de
C#

sbyte De -128 a 127 Entero de 8 bits con System.SByte

signo

byte De 0 a 255 Entero de 8 bits sin System.Byte

signo

short De -32 768 a 32 767 Entero de 16 bits con System.Int16

signo

ushort De 0 a 65.535 Entero de 16 bits sin System.UInt16

signo

int De -2.147.483.648 a 2.147.483.647 Entero de 32 bits con System.Int32

signo

uint De 0 a 4.294.967.295 Entero de 32 bits sin System.UInt32

signo

long De -9.223.372.036.854.775.808 a Entero de 64 bits con System.Int64

9.223.372.036.854.775.807 signo

ulong De 0 a 18.446.744.073.709.551.615 Entero de 64 bits sin System.UInt64

signo

nint Depende de la plataforma (calculada Entero de 64 bits o System.IntPtr

en tiempo de ejecución) 32 bits con signo

nuint Depende de la plataforma (calculada Entero de 64 bits o System.UIntPtr

en tiempo de ejecución) 32 bits sin signo
En todas las filas de la tabla, excepto en las dos últimas, cada palabra clave de tipo de
C# de la columna situada más a la izquierda es un alias del tipo de .NET
correspondiente. La palabra clave y el nombre de tipo de .NET son intercambiables. Por
ejemplo, en las declaraciones siguientes se declaran variables del mismo tipo:

C#

int a = 123;

System.Int32 b = 123;

Los tipos nint y nuint de las dos últimas filas de la tabla son enteros de tamaño nativo.
A partir de C# 9.0, puede usar las palabras clave nint y nuint para definir enteros de
tamaño nativo. Son enteros de 32 bits cuando se ejecutan en un proceso de 32 bits, o
bien enteros de 64 bits cuando se ejecutan en un proceso de 64 bits. Se pueden usar
para escenarios de interoperabilidad, bibliotecas de bajo nivel y para optimizar el
rendimiento en escenarios en los que se utilice la aritmética de enteros.

Los tipos enteros de tamaño nativo se representan internamente como los tipos
System.IntPtr y System.UIntPtr de .NET. A partir de C# 11, los tipos nint y nuint son
alias de los tipos subyacentes.

El valor predeterminado de cada tipo entero es cero, 0 .

Cada uno de los tipos enteros tiene las constantes MinValue y MaxValue que
proporcionan el valor mínimo y máximo de ese tipo. Estas propiedades son constantes
en tiempo de compilación, excepto en el caso de los tipos de tamaño nativo ( nint y
nuint ). Las propiedades MinValue y MaxValue se calculan en tiempo de ejecución para

los tipos de tamaño nativo. Los tamaños de esos tipos dependen de la configuración del
proceso.

Use la estructura System.Numerics.BigInteger para representar un entero con signo sin

límite superior ni inferior.

Literales enteros
Los literales enteros pueden ser

decimales: sin ningún prefijo

hexadecimales: con el prefijo de 0x o 0X
binarios: con el prefijo 0b o 0B

En el código siguiente se muestra un ejemplo de cada uno de ellos:

 C#

var decimalLiteral = 42;

var hexLiteral = 0x2A;

var binaryLiteral = 0b_0010_1010;

En el ejemplo anterior también se muestra el uso de _ como un separador de dígitos.

Puede usar el separador de dígitos con todos los tipos de literales numéricos.

El tipo de un literal entero viene determinado por su sufijo, como se indica a

continuación:

Si el literal no tiene sufijo, su tipo es el primero de los siguientes tipos en el que se

puede representar su valor: int , uint , long , ulong .

７ Nota

Los literales se interpretan como valores positivos. Por ejemplo, el literal

0xFF_FF_FF_FF representa el número 4294967295 del tipo uint , aunque tiene

la misma representación de bits que el número -1 del tipo int . Si necesita un

valor de un tipo determinado, convierta un literal en ese tipo. Use el operador
unchecked si un valor literal no se puede representar en el tipo de destino. Por

ejemplo, unchecked((int)0xFF_FF_FF_FF) genera -1 .

Si un literal entero tiene el sufijo U o u , su tipo es el primero de los siguientes

tipos en el que se puede representar su valor: uint , ulong .

Si un literal entero tiene el sufijo L o l , su tipo es el primero de los siguientes

tipos en el que se puede representar su valor: long , ulong .

７ Nota

Puede usar la letra minúscula l como sufijo. Sin embargo, esto genera una
advertencia del compilador porque la letra l se confunde fácilmente con el
dígito 1 . Use L para mayor claridad.

Si el literal tiene como sufijo UL , Ul , uL , ul , LU , Lu , lU o lu , su tipo es ulong .

Si el valor que representa un literal entero supera UInt64.MaxValue, se produce un error

de compilación CS1021.
Si el tipo determinado de un literal entero es int y el valor que representa el literal está
dentro del rango del tipo de destino, el valor se puede convertir de forma implícita en
sbyte , byte , short , ushort , uint , ulong , nint o nuint :

C#

byte a = 17;

byte b = 300; // CS0031: Constant value '300' cannot be converted to a

'byte'

Como se muestra en el ejemplo anterior, si el valor del literal no está dentro del
intervalo del tipo de destino, se produce el error CS0031 del compilador.

También puede usar una conversión para convertir el valor representado por un literal
entero en un tipo que no sea el determinado del literal:

C#

var signedByte = (sbyte)42;

var longVariable = (long)42;

Conversiones
Puede convertir un tipo numérico entero en cualquier otro tipo numérico entero. Si el
tipo de destino puede almacenar todos los valores del tipo de origen, la conversión es
implícita. De lo contrario, debe usar una expresión Cast para realizar una conversión
explícita. Para obtener más información, consulte Conversiones numéricas integradas.

Enteros con tamaño nativos

Los tipos enteros de tamaño nativo tienen un comportamiento especial porque el
almacenamiento viene determinado por el tamaño natural del entero en la máquina de
destino.

Para obtener el tamaño de un entero de tamaño nativo en tiempo de ejecución,

puede usar sizeof() . Pero el código se debe compilar en un contexto no seguro.
Por ejemplo:

C#

Console.WriteLine($"size of nint = {sizeof(nint)}");

Console.WriteLine($"size of nuint = {sizeof(nuint)}");

 // output when run in a 64-bit process

//size of nint = 8

//size of nuint = 8

// output when run in a 32-bit process

//size of nint = 4

//size of nuint = 4

También puede obtener el valor equivalente de las propiedades estáticas

IntPtr.Size y UIntPtr.Size.

Para obtener los valores mínimo y máximo de los enteros de tamaño nativo en
tiempo de ejecución, use MinValue y MaxValue como propiedades estáticas con las
palabras clave nint y nuint , como en el ejemplo siguiente:

C#

Console.WriteLine($"nint.MinValue = {nint.MinValue}");

Console.WriteLine($"nint.MaxValue = {nint.MaxValue}");

Console.WriteLine($"nuint.MinValue = {nuint.MinValue}");
Console.WriteLine($"nuint.MaxValue = {nuint.MaxValue}");

// output when run in a 64-bit process

//nint.MinValue = -9223372036854775808

//nint.MaxValue = 9223372036854775807

//nuint.MinValue = 0

//nuint.MaxValue = 18446744073709551615

// output when run in a 32-bit process

//nint.MinValue = -2147483648

//nint.MaxValue = 2147483647

//nuint.MinValue = 0

//nuint.MaxValue = 4294967295

Puede usar valores constantes en los rangos siguientes:

Para nint : entre Int32.MinValue y Int32.MaxValue.
Para nuint : entre UInt32.MinValue y UInt32.MaxValue.

El compilador proporciona conversiones implícitas y explícitas a otros tipos

numéricos. Para obtener más información, consulte Conversiones numéricas
integradas.

No hay ninguna sintaxis directa para los literales de entero de tamaño nativo. No
hay ningún sufijo para indicar que un literal es un entero de tamaño nativo, como
L para indicar long . En su lugar, puede usar conversiones implícitas o explícitas de

otros valores enteros. Por ejemplo:

 C#

nint a = 42

nint a = (nint)42;

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Tipos enteros
Literales enteros
C# 9: tipos enteros de tamaño nativo
C# 11: IntPtr numérico y UIntPtr

Vea también
Referencia de C#
Tipos de valor
Tipos de punto flotante
Cadenas con formato numérico estándar
Valores numéricos en .NET
Tipos numéricos de punto flotante
(referencia de C#)
Artículo • 05/10/2022 • Tiempo de lectura: 4 minutos

Los tipos numéricos de punto flotante representan números reales. Todos los tipos
numéricos de punto flotante son tipos de valor. También son tipos simples y se pueden
inicializar con literales. Todos los tipos de punto flotante numéricos admiten operadores
aritméticos, de comparación y de igualdad.

Características de los tipos de punto flotante

C# admite los siguientes tipos de punto flotante predefinidos:

Palabra Intervalo Precisión Tamaño Tipo de .NET

clave/tipo de aproximado
C#

float De ±1,5 x 10-45 a De 6 a 9 dígitos 4 bytes System.Single

±3,4 x 1038 aproximadamente

double De ±5,0 × 10−324 a De 15 a 17 dígitos 8 bytes System.Double

±1,7 × 10308 aproximadamente

decimal De ±1,0 x 10-28 to 28-29 dígitos 16 bytes System.Decimal

±7,9228 x 1028

En la tabla anterior, cada palabra clave de tipo de C# de la columna ubicada más a la

izquierda es un alias del tipo de .NET correspondiente. Son intercambiables. Por
ejemplo, en las declaraciones siguientes se declaran variables del mismo tipo:

C#

double a = 12.3;

System.Double b = 12.3;

El valor predeterminado de cada tipo de punto flotante es cero, 0 . Cada uno de los
tipos de punto flotante tiene las constantes MinValue y MaxValue que proporcionan el
valor finito mínimo y máximo de ese tipo. Los tipos float y double también brindan
constantes que representan valores infinitos y no numéricos. Por ejemplo, el tipo double
ofrece las siguientes constantes: Double.NaN, Double.NegativeInfinity y
Double.PositiveInfinity.
El tipo de decimal es adecuado cuando el grado de precisión requerido viene
determinado por el número de dígitos a la derecha del separador decimal. Estos
números se utilizan normalmente en aplicaciones financieras, para importes monetarios
(por ejemplo, 1,00 $), tasas de interés (por ejemplo, 2,625 %), etc. Los números pares
que son precisos únicamente para un dígito decimal se controlan de forma más precisa
en el tipo decimal : 0,1, por ejemplo, se puede representar exactamente mediante una
instancia de decimal , mientras que no hay una instancia double o float que representa
exactamente 0,1. Debido a esta diferencia en los tipos numéricos, se pueden producir
errores de redondeo inesperados en cálculos aritméticos cuando se usa double o float
para datos decimales. Puede usar double en lugar de decimal cuando optimizar el
rendimiento es más importante que asegurar la precisión. Sin embargo, cualquier
diferencia de rendimiento pasaría desapercibida para todas las aplicaciones, salvo las
que consumen más cálculos. Otra posible razón para evitar decimal es minimizar los
requisitos de almacenamiento. Por ejemplo, ML.NET usa float porque la diferencia
entre 4 bytes y 16 bytes se acumula para conjuntos de datos muy grandes. Para obtener
más información, vea System.Decimal.

En una expresión, puede combinar tipos enteros y tipos float y double . En este caso,
los tipos enteros se convierten implícitamente en uno de los tipos de punto flotante y, si
es necesario, el tipo float se convierte implícitamente en double . La expresión se
evalúa de la siguiente forma:

Si hay un tipo double en la expresión, esta se evalúa como double , o bien como
bool en comparaciones relacionales o de igualdad.
Si no hay un tipo double en la expresión, esta se evalúa como float , o bien como
bool en comparaciones relacionales o de igualdad.

También es posible combinar en una expresión tipos enteros y el tipo decimal . En este
caso, los tipos enteros se convierten implícitamente en el tipo decimal y la expresión se
evalúa como decimal , o bien como bool en comparaciones relacionales y de igualdad.

En una expresión, no se puede mezclar el tipo decimal con los tipos float y double . En
este caso, si quiere realizar operaciones aritméticas, de comparación o de igualdad,
debe convertir explícitamente los operandos del tipo decimal o a este mismo tipo,
como se muestra en el ejemplo siguiente:

C#

double a = 1.0;

decimal b = 2.1m;

Console.WriteLine(a + (double)b);

Console.WriteLine((decimal)a + b);

Puede usar cadenas con formato numérico estándar o cadenas con formato numérico
personalizado para dar formato a un valor de punto flotante.

Literales reales
El tipo de un literal real viene determinado por su sufijo, como se indica a continuación:

El literal sin sufijo o con el sufijo d o D es del tipo double

El literal con el sufijo f o F es del tipo float
El literal con el sufijo m o M es del tipo decimal

En el código siguiente se muestra un ejemplo de cada uno de ellos:

C#

double d = 3D;

d = 4d;

d = 3.934_001;

float f = 3_000.5F;

f = 5.4f;

decimal myMoney = 3_000.5m;

myMoney = 400.75M;

En el ejemplo anterior también se muestra el uso de como separador de _ dígitos. Puede

usar el separador de dígitos con todos los tipos de literales numéricos.

También puede usar la notación científica; es decir, especificar una parte exponencial de
un literal real, como se muestra en el ejemplo siguiente:

C#

double d = 0.42e2;

Console.WriteLine(d); // output 42

float f = 134.45E-2f;

Console.WriteLine(f); // output: 1.3445

decimal m = 1.5E6m;

Console.WriteLine(m); // output: 1500000

Conversiones
Solo hay una conversión implícita entre los tipos numéricos de punto flotante: de float
a double . Sin embargo, puede convertir un tipo de punto flotante a cualquier otro tipo
de punto flotante con la conversión explícita. Para obtener más información, consulte
Conversiones numéricas integradas.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Tipos de punto flotante

El tipo decimal
Literales reales

Vea también
Referencia de C#
Tipos de valor
Tipos enteros
Cadenas con formato numérico estándar
Valores numéricos en .NET
System.Numerics.Complex
Conversiones numéricas integradas
(referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

C# proporciona un conjunto de tipos numéricos enteros y de punto flotante. Existe una

conversión entre dos tipos numéricos, ya sea implícita o explícita. Debe usar una
expresión Cast para realizar una conversión explícita.

Conversiones numéricas implícitas

En la tabla siguiente se muestran las conversiones implícitas predefinidas entre los tipos
numéricos integrados:

De En

sbyte short , int , long , float , double , decimal o nint

byte short , ushort , int , uint , long , ulong , float , double , decimal , nint o nuint

short int , long , float , double , o decimal , o nint

ushort int , uint , long , ulong , float , double , o decimal , nint , o nuint

int long , float , double , o decimal , nint

uint long , ulong , float , double , o decimal , o nuint

long float , double o decimal

ulong float , double o decimal

float double

nint long , float , double o decimal

nuint ulong , float , double o decimal

７ Nota

Las conversiones implícitas de int , uint , long , ulong , nint o nuint a float y de
long , ulong , nint o nuint a double pueden provocar una pérdida de precisión,

pero nunca una pérdida de un orden de magnitud. El resto de conversiones

numéricas implícitas nunca pierden información.
Tenga en cuenta también lo siguiente:

Cualquier tipo numérico entero es implícitamente convertible en cualquier tipo

numérico de punto flotante.

No hay ninguna conversión implícita a los tipos byte y sbyte . No hay ninguna
conversión implícita de los tipos double y decimal .

No hay ninguna conversión implícita entre el tipo decimal y el tipo float o

double .

Un valor de una expresión constante de tipo int (por ejemplo, un valor

representado por un literal entero) se puede convertir implícitamente en sbyte ,
byte , short , ushort , uint , ulong , nint o nuint , siempre que esté dentro del

rango del tipo de destino:

C#

byte a = 13;

byte b = 300; // CS0031: Constant value '300' cannot be converted to a

'byte'

Como se muestra en el ejemplo anterior, si el valor constante no está dentro del

rango del tipo de destino, se produce el error del compilador CS0031.

Conversiones numéricas explícitas

La siguiente tabla muestra las conversiones explícitas predefinidas entre tipos numéricos
integrados para los que no hay ninguna conversión implícita:

De En

sbyte byte , ushort , uint , ulong o nuint

byte sbyte

short sbyte , byte , ushort , uint , ulong o nuint

ushort sbyte , byte o short

int sbyte , byte , short , ushort , uint , ulong o nuint

uint sbyte , byte , short , ushort , int o nint

long sbyte , byte , short , ushort , int , uint , ulong , nint o nuint
 De En

ulong sbyte , byte , short , ushort , int , uint , long , nint o nuint

float sbyte , byte , short , ushort , int , uint , long , ulong , decimal , nint o nuint

double sbyte , byte , short , ushort , int , uint , long , ulong , float , decimal , nint o nuint

decimal sbyte , byte , short , ushort , int , uint , long , ulong , float , double , nint o nuint

nint sbyte , byte , short , ushort , int , uint , ulong o nuint

nuint sbyte , byte , short , ushort , int , uint , long o nint

７ Nota

Una conversión numérica explícita podría provocar la pérdida de datos o producir

una excepción, normalmente una de tipo OverflowException.

Tenga en cuenta también lo siguiente:

Al convertir un valor de tipo entero en otro tipo entero, el resultado depende del
contexto de comprobación de desbordamiento. En un contexto comprobado, la
conversión se realiza correctamente si el valor de origen está dentro del intervalo
del tipo de destino. De lo contrario, se produce una excepción OverflowException.
En un contexto no comprobado, la conversión siempre se realiza correctamente y
continúa así:

Si el tipo de origen es mayor que el tipo de destino, el valor de origen se trunca

al descartar sus bits "extra" más significativos. El resultado se trata como un
valor del tipo de destino.

Si el tipo de origen es menor que el tipo de destino, el valor de origen se amplía

mediante signos o ceros para que tenga el mismo tamaño que el tipo de
destino. La ampliación mediante signos se usa si el tipo de origen tiene signo;
se emplea ampliación mediante ceros si el tipo de origen no tiene signo. El
resultado se trata como un valor del tipo de destino.

Si el tipo de origen es del mismo tamaño que el tipo de destino, el valor de

origen se trata como un valor del tipo de destino.

Cuando convierte un valor decimal en un tipo entero, este valor se redondea hacia
cero al valor entero más cercano. Si el valor entero resultante está fuera del rango
del tipo de destino, se genera una excepción OverflowException.
 Al convertir un valor double o float en un tipo entero, este valor se redondea
hacia cero al valor entero más cercano. Si el valor entero resultante está fuera del
intervalo del tipo de destino, el resultado depende del contexto de comprobación
de desbordamiento. En un contexto comprobado, se genera una excepción
OverflowException, mientras que en un contexto no comprobado, el resultado es
un valor no especificado del tipo de destino.

Cuando convierte double en float , el valor double se redondea al valor float

más cercano. Si el valor double es demasiado pequeño o demasiado grande para
adaptarse al tipo float , el resultado será cero o infinito.

Cuando convierte float o double en decimal , el valor de origen se convierte en la

representación decimal y se redondea al número más cercano después de la
posición decimal 28 si es necesario. Dependiendo del valor que tenga el valor de
origen, puede producirse uno de los siguientes resultados:

Si el valor de origen es demasiado pequeño para representarse como decimal ,

el resultado se convierte en cero.

Si el valor de origen es NaN (no es un número), infinito o demasiado grande

para representarse como un decimal , se genera OverflowException.

Cuando se convierte decimal en float o double , el valor de origen se redondea al

valor float o double más cercano, respectivamente.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Conversiones numéricas implícitas

Conversiones numéricas explícitas

Vea también
Referencia de C#
Conversiones de tipos
bool (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave de tipo bool es un alias para el tipo de estructura de .NET

System.Boolean que representa un valor booleano que puede ser true o false .

Para realizar operaciones lógicas con valores del tipo bool , use operadores lógicos
booleanos. El tipo bool es el tipo de resultado de los operadores de comparación e
igualdad. Una expresión bool puede ser una expresión condicional de control en las
instrucciones if, do, while y for, así como en el operador condicional ?:.

El valor predeterminado del tipo bool es false .

Literales
Puede usar los literales true y false para inicializar una variable bool o para pasar un
valor bool :

C#

bool check = true;

Console.WriteLine(check ? "Checked" : "Not checked"); // output: Checked

Console.WriteLine(false ? "Checked" : "Not checked"); // output: Not

checked

Lógica booleana de tres valores

Use el tipo bool? que acepta valores NULL si tiene que admitir la lógica de tres valores
(por ejemplo, si trabaja con bases de datos que admiten un tipo booleano de tres
valores). En el caso de los operandos bool? , los operadores predefinidos & y | admiten
la lógica de tres valores. Para más información, consulte la sección Operadores lógicos
booleanos que aceptan valores NULL del artículo Operadores lógicos booleanos.

Para más información sobre los tipos de valor que admiten un valor NULL, consulte
Tipos de valor que admiten un valor NULL.

Conversiones
C# solo proporciona dos conversiones que implican al tipo bool . Son una conversión
implícita al tipo bool? que acepta valores NULL correspondiente y una conversión
explícita del tipo bool? . Sin embargo, .NET proporciona métodos adicionales que se
pueden usar para realizar una conversión al tipo bool , o bien revertirla. Para obtener
más información, vea la sección Convertir a y desde valores booleanos de la página de
referencia de la API System.Boolean.

Especificación del lenguaje C#

Para obtener más información, vea la sección Tipo bool de la especificación del lenguaje
C#.

Vea también
Referencia de C#
Tipos de valor
operadores true y false
char (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave de tipo char es un alias para el tipo de estructura de .NET System.Char
que representa un carácter Unicode UTF-16.

Tipo Intervalo Tamaño Tipo de .NET

char U+0000 a U+FFFF 16 bits System.Char

El valor predeterminado del tipo char es \0 , es decir, U+0000.

El tipo char admite operadores de comparación, igualdad, incremento y decremento.

Además, en el caso de los operandos char , los operadores aritméticos y lógicos bit a bit
realizan una operación en los códigos de caracteres correspondientes y producen el
resultado del tipo int .

El tipo string representa el texto como una secuencia de valores char .

Literales
Puede especificar un valor de char con:

un literal de carácter.
una secuencia de escape Unicode, que es \u seguido de la representación
hexadecimal de cuatro símbolos de un código de carácter.
una secuencia de escape hexadecimal, que es \x seguido de la representación
hexadecimal de un código de carácter.

C#

var chars = new[]

'j',

'\u006A',

'\x006A',

(char)106,

};

Console.WriteLine(string.Join(" ", chars)); // output: j j j j

Como se muestra en el ejemplo anterior, también puede convertir el valor de un código

de carácter en el valor de char correspondiente.
 ７ Nota

En el caso de una secuencia de escape Unicode, debe especificar los cuatro dígitos
hexadecimales. Es decir, \u006A es una secuencia de escape válida, mientras que
\u06A y \u6A no son válidas.

En el caso de una secuencia de escape hexadecimal, puede omitir los ceros a la

izquierda. Es decir, las secuencias de escape \x006A , \x06A y \x6A son válidas y se
corresponden con el mismo carácter.

Conversiones
El tipo char se puede convertir implícitamente en los tipos enteros siguientes: ushort ,
int , uint , long y ulong . También se puede convertir implícitamente en los tipos
numéricos de punto flotante integrados: float , double y decimal . Se puede convertir
explícitamente en los tipos enteros sbyte , byte y short .

No hay ninguna conversión implícita de otros tipos al tipo char . Sin embargo, cualquier
tipo numérico entero o de punto flotante es implícitamente convertible a char .

Especificación del lenguaje C#

Para obtener más información, consulte la sección Tipos enteros de Especificación del
lenguaje C#.

Vea también
Referencia de C#
Tipos de valor
Cadenas
System.Text.Rune
Codificación de caracteres de .NET
Tipos de enumeración (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Un tipo de enumeración es un tipo de valor definido por un conjunto de constantes con

nombre del tipo numérico integral subyacente. Para definir un tipo de enumeración, use
la palabra clave enum y especifique los nombres de miembros de enumeración:

C#

enum Season

Spring,

Summer,

Autumn,

Winter

De forma predeterminada, los valores de constante asociados de miembros de

enumeración son del tipo int ; comienzan con cero y aumentan en uno después del
orden del texto de la definición. Puede especificar explícitamente cualquier otro tipo de
numérico entero como un tipo subyacente de un tipo de enumeración. También puede
especificar explícitamente los valores de constante asociados, como se muestra en el
ejemplo siguiente:

C#

enum ErrorCode : ushort

None = 0,

Unknown = 1,

ConnectionLost = 100,

OutlierReading = 200

No se puede definir un método dentro de la definición de un tipo de enumeración. Para

agregar funcionalidad a un tipo de enumeración, cree un método de extensión.

El valor predeterminado de un tipo de enumeración E es el valor generado por la

expresión (E)0 , incluso si cero no tiene el miembro de enumeración correspondiente.

Un tipo de enumeración se usa para representar una opción de un conjunto de valores

mutuamente excluyentes o una combinación de opciones. Para representar una
combinación de opciones, defina un tipo de enumeración como marcas de bits.
Tipos de enumeración como marcas de bits
Si quiere que un tipo de enumeración represente una combinación de opciones, defina
los miembros de enumeración de esas opciones de modo que una opción individual sea
un campo de bits. Es decir, los valores asociados de esos miembros de enumeración
deben ser las potencias de dos. Luego, puede usar los operadores lógicos bit a bit| o &
para combinar o formar intersección de combinaciones de opciones, respectivamente.
Para indicar que un tipo de enumeración declara campos de bits, aplíquele el atributo
Flags. Como se muestra en el ejemplo siguiente, también puede incluir algunas
combinaciones típicas en la definición de un tipo de enumeración.

C#

[Flags]

public enum Days

None = 0b_0000_0000, // 0

Monday = 0b_0000_0001, // 1

Tuesday = 0b_0000_0010, // 2

Wednesday = 0b_0000_0100, // 4

Thursday = 0b_0000_1000, // 8

Friday = 0b_0001_0000, // 16

Saturday = 0b_0010_0000, // 32

Sunday = 0b_0100_0000, // 64

Weekend = Saturday | Sunday

}

public class FlagsEnumExample

public static void Main()

Days meetingDays = Days.Monday | Days.Wednesday | Days.Friday;

Console.WriteLine(meetingDays);

// Output:

// Monday, Wednesday, Friday

Days workingFromHomeDays = Days.Thursday | Days.Friday;

Console.WriteLine($"Join a meeting by phone on {meetingDays &

workingFromHomeDays}");

// Output:

// Join a meeting by phone on Friday

bool isMeetingOnTuesday = (meetingDays & Days.Tuesday) ==

Days.Tuesday;

Console.WriteLine($"Is there a meeting on Tuesday:

{isMeetingOnTuesday}");

// Output:

// Is there a meeting on Tuesday: False

var a = (Days)37;

Console.WriteLine(a);

 // Output:

// Monday, Wednesday, Saturday

Para más información y ver algunos ejemplos, consulte la página de referencia de API de
System.FlagsAttribute y la sección miembros no exclusivos y el atributo Flags de la
página de referencia de API de System.Enum.

El tipo System.Enum y la restricción de

enumeración
El tipo System.Enum es la clase base abstracta de todos los tipos de enumeración.
Proporciona una serie de métodos para obtener información sobre un tipo de
enumeración y sus valores. Para más información y ver algunos ejemplos, consulte la
página de referencia de la API System.Enum.

Puede usar System.Enum en una restricción de clase base (conocida como la restricción
de enumeración) para especificar que un parámetro de tipo es un tipo de enumeración.
Cualquier tipo de enumeración también cumple la restricción struct , que se usa para
especificar que un parámetro de tipo es un tipo de valor que no acepta valores NULL.

Conversiones
Para cualquier tipo de enumeración, existen conversiones explícitas entre el tipo de
enumeración y su tipo entero subyacente. Si convierte (usacast) un valor de
enumeración a su tipo subyacente, el resultado es el valor entero asociado de un
miembro de enumeración.

C#

public enum Season

Spring,

Summer,

Autumn,

Winter

public class EnumConversionExample

public static void Main()

Season a = Season.Autumn;
 Console.WriteLine($"Integral value of {a} is {(int)a}"); // output:
Integral value of Autumn is 2

var b = (Season)1;

Console.WriteLine(b); // output: Summer

var c = (Season)4;

Console.WriteLine(c); // output: 4

Use el método Enum.IsDefined para determinar si un tipo de enumeración contiene un

miembro de enumeración con el valor asociado determinado.

Para cualquier tipo de enumeración, existen conversiones boxing y unboxing a y desde

el tipo System.Enum, respectivamente.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Enumeraciones
Operaciones y valores de enumeración
Operadores lógicos de enumeración
Operadores de comparación de enumeración
Conversiones de enumeración explícitas
Conversiones de enumeración implícitas

Vea también
Referencia de C#
Cadenas de formato de enumeración
Instrucciones de diseño: diseño de enumeraciones
Instrucciones de diseño: convenciones de nomenclatura de enumeración
Expresión
Instrucción switch
Tipos de estructura (Referencia de C#)
Artículo • 09/03/2023 • Tiempo de lectura: 10 minutos

Un tipo de estructura (o tipo struct) es un tipo de valor que puede encapsular datos y
funcionalidad relacionada. Para definir un tipo de estructura se usa la palabra clave
struct :

C#

public struct Coords

public Coords(double x, double y)

X = x;

Y = y;

public double X { get; }

public double Y { get; }

public override string ToString() => $"({X}, {Y})";

Para obtener información sobre los tipos ref struct y readonly ref struct , consulte el
artículo tipos de estructura de referencia.

Los tipos de estructura tienen semántica de valores. Es decir, una variable de un tipo de
estructura contiene una instancia del tipo. De forma predeterminada, los valores de
variable se copian al asignar, pasar un argumento a un método o devolver el resultado
de un método. Para las variables de tipo estructura, se copia una instancia del tipo. Para
más información, vea Tipos de valor.

Normalmente, los tipos de estructura se usan para diseñar tipos de pequeño tamaño
centrados en datos que proporcionan poco o ningún comportamiento. Por ejemplo, en
.NET se usan los tipos de estructura para representar un número (entero y real), un valor
booleano, un caracter Unicode, una instancia de tiempo. Si le interesa el
comportamiento de un tipo, considere la posibilidad de definir una clase. Los tipos de
clase tienen semántica de referencias. Es decir, una variable de un tipo de clase contiene
una referencia a una instancia del tipo, no la propia instancia.

Dado que los tipos de estructura tienen semántica del valor, le recomendamos que
defina tipos de estructura inmutables.
Estructura readonly
Se usa el modificador readonly para declarar que un tipo de estructura es inmutable.
Todos los miembros de datos de una estructura readonly debe ser de solo lectura tal
como se indica a continuación:

Cualquier declaración de campo debe tener el modificador readonly

Cualquier propiedad, incluidas las implementadas automáticamente, debe ser de
solo lectura. En C# 9.0 y versiones posteriores, una propiedad puede tener un
descriptor de acceso init.

Esto garantiza que ningún miembro de una estructura readonly modifique el estado de
la misma. Eso significa que otros miembros de instancia, excepto los constructores, son
implícitamente readonly.

７ Nota

En una estructura readonly , un miembro de datos de un tipo de referencia mutable

puede seguir mutando su propio estado. Por ejemplo, no puede reemplazar una
instancia de List<T>, pero puede agregarle nuevos elementos.

En el código siguiente se define una estructura readonly con establecedores de

propiedad de solo inicialización, disponibles en C# 9.0 y versiones posteriores:

C#

public readonly struct Coords

public Coords(double x, double y)

X = x;

Y = y;

public double X { get; init; }

public double Y { get; init; }

public override string ToString() => $"({X}, {Y})";

Miembros de instancia de readonly

También puede usar el modificador readonly para declarar que un miembro de
instancia no modifica el estado de una estructura. Si no puede declarar el tipo de
estructura completa como readonly , use el modificador readonly para marcar los
miembros de instancia que no modifican el estado de la estructura.

Dentro de un miembro de instancia readonly , no se puede realizar la asignación a

campos de instancia de la estructura. Pero un miembro readonly puede llamar a un
miembro que no sea readonly . En ese caso, el compilador crea una copia de la instancia
de la estructura y llama al miembro que no es readonly en esa copia. Como resultado,
la instancia de la estructura original no se modifica.

Normalmente, se aplica el modificador readonly a los siguientes tipos de miembros de

instancia:

Métodos:

C#

public readonly double Sum()

return X + Y;

También puede aplicar el modificador readonly a los métodos que invalidan los
métodos declarados en System.Object:

C#

public readonly override string ToString() => $"({X}, {Y})";

Propiedades e indizadores:

C#

private int counter;

public int Counter

readonly get => counter;

set => counter = value;

Si tiene que aplicar el modificador readonly a los dos descriptores de acceso de

una propiedad o un indizador, aplíquelo en la declaración de la propiedad o el
indizador.
 ７ Nota

El compilador declara un descriptor de acceso get de una propiedad

implementada automáticamente como readonly , con independencia de la
presencia del modificador readonly en la declaración de una propiedad.

En C# 9.0 y versiones posteriores, puede aplicar el modificador readonly a una

propiedad o un indizador con un descriptor de acceso init :

C#

public readonly double X { get; init; }

Puede aplicar el modificador readonly a campos estáticos de un tipo de estructura, pero

no a ningún otro miembro estático, como propiedades o métodos.

Es posible que el compilador use el modificador readonly para optimizaciones de

rendimiento. Para más información, consulte Cómo evitar asignaciones.

Mutación no destructiva
A partir de C# 10, puede usar la expresión with para generar una copia de una instancia
de tipo de estructura con las propiedades y los campos especificados modificados.
Como se muestra en el ejemplo siguiente, se usa la sintaxis del inicializador de objeto
para especificar qué miembros se van a modificar y sus nuevos valores.

C#

public readonly struct Coords

public Coords(double x, double y)

X = x;

Y = y;

public double X { get; init; }

public double Y { get; init; }

public override string ToString() => $"({X}, {Y})";

public static void Main()

var p1 = new Coords(0, 0);

 Console.WriteLine(p1); // output: (0, 0)

var p2 = p1 with { X = 3 };

Console.WriteLine(p2); // output: (3, 0)

var p3 = p1 with { X = 1, Y = 4 };

Console.WriteLine(p3); // output: (1, 4)

Estructura record
A partir de C# 10, puede definir tipos de estructura de registro. Los tipos de registro
proporcionan funcionalidad integrada para encapsular datos. Puede definir tipos record
struct y readonly record struct . Una estructura de registro no puede ser una ref

struct. Para más información y ver ejemplos, consulte Registros.

Inicialización de estructuras y valores

predeterminados
Una variable de tipo struct contiene directamente los datos de ese struct . Esto crea
una distinción entre un struct sin inicializar, que tiene su valor predeterminado y un
struct inicializado, que almacena los valores establecidos mediante su construcción.

Por ejemplo, considere el código siguiente:

C#

public readonly struct Measurement

public Measurement()

Value = double.NaN;

Description = "Undefined";

public Measurement(double value, string description)

Value = value;

Description = description;

public double Value { get; init; }

public string Description { get; init; }

public override string ToString() => $"{Value} ({Description})";

 public static void Main()

var m1 = new Measurement();

Console.WriteLine(m1); // output: NaN (Undefined)

var m2 = default(Measurement);

Console.WriteLine(m2); // output: 0 ()

var ms = new Measurement[2];

Console.WriteLine(string.Join(", ", ms)); // output: 0 (), 0 ()

Como se muestra en el ejemplo anterior, la expresión de valor predeterminado omite un

constructor sin parámetros y genera el valor predeterminado del tipo de estructura. La
creación de instancias de matriz de tipo de estructura también omite un constructor sin
parámetros y genera una matriz rellenada con los valores predeterminados de un tipo
de estructura.

La situación más común en la que verá los valores predeterminados es en matrices o en

otras colecciones en las que el almacenamiento interno incluye bloques de variables. En
el ejemplo siguiente se crea una matriz de 30 estructuras TemperatureRange , cada una de
las cuales tiene el valor predeterminado:

C#

// All elements have default values of 0:

TemperatureRange[] lastMonth = new TemperatureRange[30];

Todos los campos miembros de una estructura deben asignarse definitivamente cuando
se crean porque los tipos struct almacenan directamente sus datos. El valor default de
una estructura ha asignado definitivamente todos los campos a 0. Todos los campos
deben asignarse definitivamente cuando se invoca un constructor. Los campos se
inicializan mediante los mecanismos siguientes:

Puede agregar inicializadores de campo a cualquier campo o propiedad

implementada automáticamente.
Puede inicializar cualquier campo o propiedades automáticas en el cuerpo del
constructor.

A partir de C# 11, si no inicializa todos los campos de una estructura, el compilador

agrega código al constructor que inicializa esos campos en el valor predeterminado. El
compilador realiza su análisis de asignación definitiva habitual. Los campos a los que se
tiene acceso antes de asignarse o que no se asignan definitivamente cuando el
constructor termina de ejecutarse tienen asignados sus valores predeterminados antes
de que se ejecute el cuerpo del constructor. Si se accede a this antes de que se
asignen todos los campos, la estructura se inicializa en el valor predeterminado antes de
que se ejecute el cuerpo del constructor.

C#

public readonly struct Measurement

public Measurement(double value)

Value = value;

public Measurement(double value, string description)

Value = value;

Description = description;

public Measurement(string description)

Description = description;

public double Value { get; init; }

public string Description { get; init; } = "Ordinary measurement";

public override string ToString() => $"{Value} ({Description})";

public static void Main()

var m1 = new Measurement(5);

Console.WriteLine(m1); // output: 5 (Ordinary measurement)

var m2 = new Measurement();

Console.WriteLine(m2); // output: 0 ()

var m3 = default(Measurement);

Console.WriteLine(m3); // output: 0 ()

Cada struct tiene un constructor sin parámetros public . Si escribe un constructor sin
parámetros, debe ser público. Si una estructura declara cualquier inicializador de campo,
debe declarar explícitamente un constructor. No hace falta que dicho constructor no
tenga parámetros. Si una estructura declara un inicializador de campo pero no declara
ningún constructor, el compilador notifica un error. Cualquier constructor declarado
explícitamente (con parámetros o sin parámetros) ejecuta todos los inicializadores de
campo de esa estructura. Todos los campos sin un inicializador de campo o una
asignación en un constructor se establecen en el valor predeterminado. Para obtener
más información, vea la nota propuesta de la característica Constructores de structs sin
parámetros.

Si se puede acceder a todos los campos de instancia de un tipo de estructura, también

puede crear una instancia de él sin el operador new . En ese caso, debe inicializar todos
los campos de instancia antes del primer uso de la instancia. En el siguiente ejemplo se
muestra cómo hacerlo:

C#

public static class StructWithoutNew

public struct Coords

public double x;

public double y;

public static void Main()

Coords p;

p.x = 3;

p.y = 4;

Console.WriteLine($"({p.x}, {p.y})"); // output: (3, 4)

En el caso de los tipos de valor integrados, use los literales correspondientes para
especificar un valor del tipo.

Limitaciones del diseño de un tipo de

estructura
Las estructuras tienen la mayoría de las funcionalidades de un tipo class. Hay algunas
excepciones que se han quitado en versiones más recientes:

Un tipo de estructura no puede heredar de otro tipo de estructura o clase ni puede

ser la base de una clase. Pero un tipo de estructura puede implementar interfaces.
No se puede declarar un finalizador dentro de un tipo de estructura.
Antes de C# 11, un constructor de un tipo de estructura debe inicializar todos los
campos de instancia del tipo.
Antes de C# 10, no se puede declarar un constructor sin parámetros.
Antes de C# 10, no se puede inicializar una propiedad o un campo de instancia en
su declaración.
Pasar variables de tipo de estructura por
referencia
Cuando se pasa una variable de tipo de estructura a un método como argumento o se
devuelve un valor de tipo de estructura a partir de un método, se copia toda la instancia
de un tipo de estructura. El método de paso por valor puede afectar al rendimiento del
código en escenarios de alto rendimiento que impliquen tipos de estructura grandes.
Puede evitar la copia de valores si pasa una variable de tipo de estructura por referencia.
Use los modificadores de parámetro de método ref, out o in para indicar que un
argumento se debe pasar por referencia. Use valores devueltos de tipo ref para devolver
el resultado de un método por referencia. Para más información, consulte Cómo evitar
asignaciones.

Restricción struct
Use también la palabra clave struct de la restricción struct para especificar que un
parámetro de tipo es un tipo de valor que no acepta valores NULL. Los tipos de
estructura y enumeración satisfacen la restricción struct .

Conversiones
Para cualquier tipo de estructura (excepto los tipos de ref struct), hay conversiones
boxing y unboxing a los tipos System.ValueType y System.Object y también desde ellos.
También existen conversiones boxing y unboxing entre un tipo de estructura y cualquier
interfaz que implemente.

Especificación del lenguaje C#

Para más información, vea la sección Estructuras de la especificación del lenguaje C#.

Para más información sobre las características de struct , consulte las siguientes notas
de propuestas de características:

C# 7.2: Estructuras readonly (solo lectura)

C# 8: Miembros de instancias readonly
C# 10: Constructores de estructuras sin parámetros
C# 10: Permitir la expresión with en estructuras
C# 10 - Estructuras de registros
C# 11 - Estructuras predeterminadas automáticas
Vea también
Referencia de C#
El sistema de tipos de C#
Instrucciones de diseño: elección entre clase y estructura
Instrucciones de diseño: diseño de estructuras
Tipos de tupla (referencia de C#)
Artículo • 28/11/2022 • Tiempo de lectura: 9 minutos

La característica de tuplas proporciona una sintaxis concisa para agrupar varios

elementos de datos en una estructura de datos ligera. En el siguiente ejemplo se
muestra cómo se puede declarar una variable de tupla, inicializarla y acceder a sus
miembros de datos:

C#

(double, int) t1 = (4.5, 3);

Console.WriteLine($"Tuple with elements {t1.Item1} and {t1.Item2}.");

// Output:

// Tuple with elements 4.5 and 3.

(double Sum, int Count) t2 = (4.5, 3);

Console.WriteLine($"Sum of {t2.Count} elements is {t2.Sum}.");

// Output:

// Sum of 3 elements is 4.5.

Como se muestra en el ejemplo anterior, para definir un tipo de tupla, se especifican los
tipos de todos sus miembros de datos y, opcionalmente, los nombres de campos. No se
pueden definir métodos en un tipo de tupla, pero se pueden usar los métodos
proporcionados por .NET, como se muestra en el siguiente ejemplo:

C#

(double, int) t = (4.5, 3);

Console.WriteLine(t.ToString());

Console.WriteLine($"Hash code of {t} is {t.GetHashCode()}.");

// Output:

// (4.5, 3)

// Hash code of (4.5, 3) is 718460086.

Los tipos de tupla admiten operadores == de igualdad y != . Para obtener más

información, consulte la sección Igualdad de tupla.

Los tipos de tupla son tipos de valores; los elementos de tupla son campos públicos.
Esto hace que las tuplas sean tipos de valor mutables.

７ Nota

La característica de las tuplas requiere el tipo System.ValueTuple y los tipos

genéricos relacionados (por ejemplo, System.ValueTuple<T1,T2>), que están
 disponibles en .NET Core y .NET Framework 4.7 y versiones posteriores. Para usar
tuplas en un proyecto que tenga como destino .NET Framework 4.6.2 o versiones
anteriores, agregue el paquete NuGet System.ValueTuple al proyecto.

Puede definir tuplas con un gran número arbitrario de elementos:

C#

var t =

(1, 2, 3, 4, 5, 6, 7, 8, 9, 10,

11, 12, 13, 14, 15, 16, 17, 18,

19, 20, 21, 22, 23, 24, 25, 26);

Console.WriteLine(t.Item26); // output: 26

Casos de uso de tuplas

Uno de los casos de uso más comunes de tuplas es como un tipo devuelto del método.
Es decir, en lugar de definir outlos parámetros del método, puede agrupar los
resultados del método en un tipo devuelto de tupla, como se muestra en el ejemplo
siguiente:

C#

var xs = new[] { 4, 7, 9 };

var limits = FindMinMax(xs);

Console.WriteLine($"Limits of [{string.Join(" ", xs)}] are {limits.min} and

{limits.max}");

// Output:

// Limits of [4 7 9] are 4 and 9

var ys = new[] { -9, 0, 67, 100 };

var (minimum, maximum) = FindMinMax(ys);

Console.WriteLine($"Limits of [{string.Join(" ", ys)}] are {minimum} and

{maximum}");

// Output:

// Limits of [-9 0 67 100] are -9 and 100

(int min, int max) FindMinMax(int[] input)

if (input is null || input.Length == 0)

throw new ArgumentException("Cannot find minimum and maximum of a

null or empty array.");

var min = int.MaxValue;

var max = int.MinValue;

foreach (var i in input)

if (i < min)

min = i;

if (i > max)

max = i;

return (min, max);

Como se muestra en el ejemplo anterior, puede trabajar directamente con la instancia

de la tupla devuelta o deconstruirla en variables independientes.

También puede utilizar tipos de tupla en lugar de tipos anónimos; por ejemplo, en las
consultas LINQ. Para obtener más información, vea Elección entre tipos de tupla y
anónimos.

Normalmente, se usan tuplas para agrupar elementos de datos relacionados de forma

flexible. Esto suele ser útil en métodos de utilidad privados e internos. En el caso de la
API pública, considere la posibilidad de definir un tipo de clase o de estructura.

Nombres de campo de tupla

Puede especificar explícitamente los nombres de campo de tupla en una expresión de
inicialización de tuplas o en la definición de un tipo de tupla, como se muestra en el
siguiente ejemplo:

C#

var t = (Sum: 4.5, Count: 3);

Console.WriteLine($"Sum of {t.Count} elements is {t.Sum}.");

(double Sum, int Count) d = (4.5, 3);

Console.WriteLine($"Sum of {d.Count} elements is {d.Sum}.");

Si no especifica un nombre de campo, se puede deducir del nombre de la variable

correspondiente en una expresión de inicialización de tupla, como se muestra en el
ejemplo siguiente:

C#

var sum = 4.5;

var count = 3;

 var t = (sum, count);

Console.WriteLine($"Sum of {t.count} elements is {t.sum}.");

Esto se conoce como "inicializadores de proyección de tupla". El nombre de una variable

no se proyecta en un nombre de campo de tupla en los siguientes casos:

El nombre del candidato es un nombre de miembro de un tipo de tupla, por

ejemplo, Item3 , ToString o Rest .
El nombre del candidato es un duplicado de otro nombre de campo de tupla, ya
sea explícita o implícita.

En estos casos, se especifica el nombre de un campo o se accede a un campo por su

nombre predeterminado.

Los nombres predeterminados de los campos de tupla son Item1 , Item2 , Item3 , etc.
Siempre puede usar el nombre predeterminado de un campo, incluso cuando se
especifica un nombre de campo de forma explícita o inferida, como se muestra en el
siguiente ejemplo:

C#

var a = 1;

var t = (a, b: 2, 3);

Console.WriteLine($"The 1st element is {t.Item1} (same as {t.a}).");

Console.WriteLine($"The 2nd element is {t.Item2} (same as {t.b}).");

Console.WriteLine($"The 3rd element is {t.Item3}.");

// Output:

// The 1st element is 1 (same as 1).

// The 2nd element is 2 (same as 2).

// The 3rd element is 3.

En la asignación de tuplas y las comparaciones de igualdad de tuplas no se tienen en

cuenta los nombres de campo.

En el tiempo de compilación, el compilador sustituye los nombres de campo no

predeterminados por los nombres predeterminados correspondientes. Como resultado,
los nombres de campo especificados o inferidos no están disponibles en el tiempo de
ejecución.

 Sugerencia

Habilite la regla de estilo de código .NET IDE0037 para establecer una preferencia
sobre los nombres de campo de tupla explícitos o inferidos.
Asignación y deconstrucción de tuplas
C# admite la asignación entre tipos de tupla que satisfacen estas dos condiciones:

ambos tipos de tupla tienen el mismo número de elementos;

para cada posición de tupla, el tipo de elemento de tupla de la derecha es el
mismo que el tipo de elemento de tupla de la izquierda correspondiente, o bien
puede convertirse a este.

Los valores de elementos de tupla se asignan siguiendo el orden de los elementos de

tupla. Los nombres de los campos de tupla se omiten y no se asignan, como se muestra
en el siguiente ejemplo:

C#

(int, double) t1 = (17, 3.14);

(double First, double Second) t2 = (0.0, 1.0);

t2 = t1;

Console.WriteLine($"{nameof(t2)}: {t2.First} and {t2.Second}");

// Output:

// t2: 17 and 3.14

(double A, double B) t3 = (2.0, 3.0);

t3 = t2;

Console.WriteLine($"{nameof(t3)}: {t3.A} and {t3.B}");

// Output:

// t3: 17 and 3.14

También puede usar el operador de asignación = para deconstruir una instancia de tupla
en variables independientes. Para ello, siga uno de estos métodos:

Declarar explícitamente el tipo de cada variable entre paréntesis:

C#

var t = ("post office", 3.6);

(string destination, double distance) = t;

Console.WriteLine($"Distance to {destination} is {distance}

kilometers.");

// Output:

// Distance to post office is 3.6 kilometers.

Usar la palabra clave var fuera de los paréntesis para declarar las variables con
tipo implícito y permitir que el compilador deduzca sus tipos:

C#
 var t = ("post office", 3.6);

var (destination, distance) = t;

Console.WriteLine($"Distance to {destination} is {distance}

kilometers.");

// Output:

// Distance to post office is 3.6 kilometers.

Usar variables existentes:

C#

var destination = string.Empty;

var distance = 0.0;

var t = ("post office", 3.6);

(destination, distance) = t;

Console.WriteLine($"Distance to {destination} is {distance}

kilometers.");

// Output:

// Distance to post office is 3.6 kilometers.

Para obtener más información sobre la deconstrucción de tuplas y otros tipos, consulte
Deconstrucción de tuplas y otros tipos.

Igualdad de tupla
Los tipos de tupla admiten los == operadores y != . Estos operadores comparan los
miembros del operando izquierdo con los miembros correspondientes del operando
derecho, siguiendo el orden de los elementos de la tupla.

C#

(int a, byte b) left = (5, 10);

(long a, int b) right = (5, 10);

Console.WriteLine(left == right); // output: True

Console.WriteLine(left != right); // output: False

var t1 = (A: 5, B: 10);

var t2 = (B: 5, A: 10);
Console.WriteLine(t1 == t2); // output: True

Console.WriteLine(t1 != t2); // output: False

Como se muestra en el ejemplo anterior, las operaciones == y != no tienen en cuenta

los nombres de campo de tupla.

Dos tuplas son comparables cuando se cumplen estas dos condiciones:

 Ambas tuplas tienen el mismo número de elementos. Por ejemplo, t1 != t2 no se
compila si t1 y t2 tienen números diferentes de elementos.
Para cada posición de tupla, los elementos correspondientes de los operandos de
la tupla de la izquierda y de la derecha son comparables con los operadores == y
!= . Por ejemplo, (1, (2, 3)) == ((1, 2), 3) no se compila porque 1 no es

comparable con (1, 2) .

Los operadores == y != comparan las tuplas en modo de cortocircuito. Es decir, una

operación se detiene en cuanto da con un par de elementos que no son iguales o
alcanza los extremos de las tuplas. Sin embargo, antes de cualquier comparación, se
evalúan todos los elementos de tupla, como se muestra en el siguiente ejemplo:

C#

Console.WriteLine((Display(1), Display(2)) == (Display(3), Display(4)));

int Display(int s)

Console.WriteLine(s);

return s;

// Output:

// 1

// 2

// 3

// 4

// False

Tuplas como parámetros de salida

Normalmente, se refactoriza un método que tiene parámetros de out en un método que
devuelve una tupla. Sin embargo, hay casos en los que un parámetro de out puede ser
de un tipo de tupla. En el siguiente ejemplo básico se indica cómo trabajar con tuplas
como parámetros de out :

C#

var limitsLookup = new Dictionary<int, (int Min, int Max)>()

[2] = (4, 10),

[4] = (10, 20),

[6] = (0, 23)

};

if (limitsLookup.TryGetValue(4, out (int Min, int Max) limits))

 Console.WriteLine($"Found limits: min is {limits.Min}, max is

{limits.Max}");

// Output:

// Found limits: min is 10, max is 20

Tuplas frente a System.Tuple

Las tuplas de C#, que están respaldadas por tipos de System.ValueTuple, son diferentes
de las tuplas representadas por tipos de System.Tuple. Las diferencias principales son las
siguientes:

Los tipos de System.ValueTuple son tipos de valores. Los tipos de System.Tuple

son tipos de referencia.
Los tipos de System.ValueTuple son mutables. Los tipos de System.Tuple son
inmutables.
Los miembros de datos de tipos de System.ValueTuple son campos. Los miembros
de datos de tipos de System.Tuple son propiedades.

Especificación del lenguaje C#

Para obtener más información, consulte las siguientes notas de propuestas de
características:

Deducción de nombres de tupla (también conocidos como "inicializadores de

proyección de tupla")
Compatibilidad con == y != en tipos de tupla

Vea también
Referencia de C#
Tipos de valor
Elección entre tipos de tupla y anónimos
System.ValueTuple
Tipos de valor que admiten valores
NULL (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 8 minutos

Un tipo de valor que acepta valores NULL T? representa todos los valores de su tipo de
valor T subyacente y un valor null adicional. Por ejemplo, puede asignar cualquiera de
los tres valores siguientes a una variable bool? : true , false o null . Un tipo de valor
subyacente T no puede ser un tipo de valor que acepte valores NULL por sí mismo.

Todos los tipos que admiten valores NULL son instancias de la estructura
System.Nullable<T> genérica. Puede hacer referencia a un tipo de valor que admite
valores NULL con un tipo subyacente T en cualquiera de las formas intercambiables
siguientes: Nullable<T> o T? .

Normalmente, los tipos de valor que admiten valores NULL se usan cuando es necesario
representar el valor indefinido de un tipo de valor subyacente. Por ejemplo, una variable
booleana, o bool , solo puede ser true o false . Sin embargo, en algunas aplicaciones,
un valor de variable puede estar sin definir o faltar. Por ejemplo, un campo de base de
datos puede contener true o false , o puede no contener ningún valor, es decir, NULL .
Puede usar el tipo bool? en ese escenario.

Declaración y asignación
Como un tipo de valor se puede convertir de forma implícita al tipo de valor que admite
valores NULL correspondiente, un valor se puede asignar a un tipo que admite valores
NULL como se haría para su tipo de valor subyacente. También se puede asignar el valor
null . Por ejemplo:

C#

double? pi = 3.14;

char? letter = 'a';

int m2 = 10;

int? m = m2;

bool? flag = null;

// An array of a nullable value type:

int?[] arr = new int?[10];

El valor predeterminado de un tipo de valor que admite valores NULL se representa

como null , es decir, es una instancia cuya propiedad Nullable<T>.HasValue devuelve
false .

Examen de una instancia de tipo de valor que

admite valores NULL
Puede usar el operador is con un patrón de tipo para examinar una instancia de un tipo
de valor que admita valores NULL para null y recuperar un valor de un tipo subyacente:

C#

int? a = 42;

if (a is int valueOfA)

Console.WriteLine($"a is {valueOfA}");

else

Console.WriteLine("a does not have a value");

// Output:

// a is 42

Siempre puede usar las siguientes propiedades de solo lectura para examinar y obtener
un valor de una variable de tipo de valor que admite valores NULL:

Nullable<T>.HasValue indica si una instancia de un tipo que admite valores NULL

tiene un valor de su tipo subyacente.

Nullable<T>.Value obtiene el valor de un tipo subyacente si HasValue es true . Si

HasValue es false , la propiedad Value inicia una excepción
InvalidOperationException.

En el ejemplo siguiente se usa la propiedad HasValue para comprobar si la variable

contiene un valor antes de mostrarlo:

C#

int? b = 10;

if (b.HasValue)

Console.WriteLine($"b is {b.Value}");

else

 Console.WriteLine("b does not have a value");

// Output:

// b is 10

También se puede comparar una variable de un tipo de valor que admite valores NULL
con null en lugar de usar la propiedad HasValue , como se muestra en el ejemplo
siguiente:

C#

int? c = 7;

if (c != null)

Console.WriteLine($"c is {c.Value}");

else

Console.WriteLine("c does not have a value");

// Output:

// c is 7

Conversión de un tipo de valor que admite un

valor NULL a un tipo subyacente
Si desea asignar un valor de un tipo que admite valores NULL a una variable de tipo de
valor que no admite valores NULL, puede que tenga que especificar el valor que se va a
asignar en lugar de null . Use el operador de fusión de NULL ?? para ello (también
puede usar el método Nullable<T>.GetValueOrDefault(T) con el mismo fin):

C#

int? a = 28;

int b = a ?? -1;

Console.WriteLine($"b is {b}"); // output: b is 28

int? c = null;

int d = c ?? -1;

Console.WriteLine($"d is {d}"); // output: d is -1

Si desea utilizar el valor predeterminado del tipo de valor subyacente en lugar de null ,
use el método Nullable<T>.GetValueOrDefault().
También puede convertir de forma explícita un tipo de valor que admite valores NULL
en uno que no los admite, como se indica en el ejemplo siguiente:

C#

int? n = null;

//int m1 = n; // Doesn't compile

int n2 = (int)n; // Compiles, but throws an exception if n is null

En tiempo de ejecución, si el valor de un tipo de valor que admite un valor NULL es

null , la conversión explícita inicia una InvalidOperationException.

Un tipo de valor que no admite valores NULL T se convierte implícitamente al tipo que
admite valores NULL T? correspondiente.

Operadores de elevación
Los operadores unarios y binarios predefinidos o los operadores sobrecargados que
admite un tipo de valor T también se admiten en el tipo de valor que admite un valor
NULL T? correspondiente. Estos operadores, también conocidos como operadores de
elevación, generan un valor null si uno o los dos operandos son null ; de lo contrario,
el operador usa los valores contenidos de sus operandos para calcular el resultado. Por
ejemplo:

C#

int? a = 10;

int? b = null;

int? c = 10;

a++; // a is 11

a = a * c; // a is 110

a = a + b; // a is null

７ Nota

Para el tipo bool? , los operadores predefinidos & y | no siguen las reglas descritas
en esta sección: el resultado de una evaluación de operador puede ser distinto de
NULL incluso si uno de los operandos es null . Para más información, consulte la
sección Operadores lógicos booleanos que aceptan valores NULL del artículo
Operadores lógicos booleanos.
En el caso de los operadores de comparación < , > , <= y >= , si uno o ambos operandos
son null , el resultado es false ; de lo contrario, se comparan los valores contenidos de
los operandos. No asuma que, como una comparación determinada (por ejemplo, <= )
devuelve false , la comparación contraria ( > ) devolverá true . En el ejemplo siguiente se
muestra que 10 no es

mayor ni igual que null ,

ni es menor que null .

C#

int? a = 10;

Console.WriteLine($"{a} >= null is {a >= null}");

Console.WriteLine($"{a} < null is {a < null}");

Console.WriteLine($"{a} == null is {a == null}");

// Output:

// 10 >= null is False

// 10 < null is False

// 10 == null is False

int? b = null;

int? c = null;

Console.WriteLine($"null >= null is {b >= c}");

Console.WriteLine($"null == null is {b == c}");

// Output:

// null >= null is False

// null == null is True

En el caso de los operadores de igualdad == , si ambos operandos son null , el resultado

es true ; si solo uno de los operandos es null , el resultado es false ; de lo contrario, se
comparan los valores contenidos de los operandos.

En el caso de los operadores de desigualdad != , si ambos operandos son null , el

resultado es false ; si solo uno de los operandos es null , el resultado es true ; de lo
contrario, se comparan los valores contenidos de los operandos.

Si existe una conversión definida por el usuario entre dos tipos de valor, esa misma
conversión también se puede usar entre los correspondientes tipos que aceptan valores
NULL.

Conversión boxing y conversión unboxing

La conversión boxing de una instancia de un tipo de valor que acepta valores NULL T?
se realiza de la siguiente manera:
 Si HasValue devuelve false , se genera la referencia nula.
Si HasValue devuelve true , se aplica la conversión boxing al correspondiente valor
del tipo de valor subyacente T , no a la instancia de Nullable<T>.

Se puede aplicar conversión unboxing a un tipo de valor T con conversión boxing al

tipo T? que acepta valores NULL correspondiente, como se muestra en el ejemplo
siguiente:

C#

int a = 41;

object aBoxed = a;

int? aNullable = (int?)aBoxed;

Console.WriteLine($"Value of aNullable: {aNullable}");

object aNullableBoxed = aNullable;

if (aNullableBoxed is int valueOfA)

Console.WriteLine($"aNullableBoxed is boxed int: {valueOfA}");

// Output:

// Value of aNullable: 41

// aNullableBoxed is boxed int: 41

Identificación de tipos que admiten valores

NULL
El ejemplo siguiente muestra cómo determinar si una instancia System.Type representa
un tipo de valor construido que admite valores NULL, es decir, el tipo
System.Nullable<T> con un parámetro de tipo especificado T :

C#

Console.WriteLine($"int? is {(IsNullable(typeof(int?)) ? "nullable" : "non

nullable")} value type");

Console.WriteLine($"int is {(IsNullable(typeof(int)) ? "nullable" : "non-

nullable")} value type");

bool IsNullable(Type type) => Nullable.GetUnderlyingType(type) != null;

// Output:

// int? is nullable value type

// int is non-nullable value type

Como se muestra en el ejemplo, se usa el operador typeof para crear una instancia
System.Type.

Si quiere determinar si una instancia es de un tipo de valor que admite un valor NULL,
no use el método Object.GetType para obtener una instancia de Type para probarla con
el código anterior. Cuando se llama al método Object.GetType en una instancia de un
tipo de valor que admite un valor NULL, se aplica la conversión boxing a la instancia
para convertirla en Object. Como la conversión boxing de una instancia que no es NULL
de un tipo de valor que admite valores NULL equivale a la conversión boxing de un
valor del tipo subyacente, GetType devuelve una instancia Type que representa el tipo
de valor subyacente que admite valores NULL:

C#

int? a = 17;

Type typeOfA = a.GetType();

Console.WriteLine(typeOfA.FullName);

// Output:

// System.Int32

No use el operador is para determinar si una instancia es de un tipo de valor que admite
valores NULL. Como se muestra en el ejemplo siguiente, no se pueden distinguir los
tipos de instancias de un tipo de valor que admite valores NULL y su tipo subyacente
mediante el operador is :

C#

int? a = 14;

if (a is int)

Console.WriteLine("int? instance is compatible with int");

int b = 17;

if (b is int?)

Console.WriteLine("int instance is compatible with int?");

// Output:

// int? instance is compatible with int

// int instance is compatible with int?

En su lugar, use el Nullable.GetUnderlyingType del primer ejemplo y el operador typeof

para comprobar si una instancia es de un tipo de valor que acepte valores NULL.

７ Nota
 Los métodos que se describen en esta sección no son aplicables en el caso de los
tipos de referencia nula.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Nullable types (Tipos que aceptan valores NULL [Guía de programación de C#])
Operadores de elevación
Conversiones implícitas que aceptan valores NULL
Conversiones explícitas que aceptan valores NULL
Operadores de conversión de elevación

Vea también
Referencia de C#
¿Qué significa exactamente "elevado"?
System.Nullable<T>
System.Nullable
Nullable.GetUnderlyingType
Tipos de referencia que aceptan valores null
Tipos de referencia (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Hay dos clases de tipos en C#: tipos de referencia y tipos de valor. Las variables de tipos
de referencia almacenan referencias en sus datos (objetos), mientras que las variables de
tipos de valor contienen directamente los datos. Con los tipos de referencia, dos
variables pueden hacer referencia al mismo objeto y, por lo tanto, las operaciones en
una variable pueden afectar al objeto al que hace referencia la otra variable. Con los
tipos de valor, cada variable tiene su propia copia de los datos y no es posible que las
operaciones en una variable afecten a la otra (excepto en el caso de las variables de
parámetro in , ref y out ; consulte el modificador del parámetro in, ref y out).

Las palabras clave siguientes se usan para declarar tipos de referencia:

class
interface
delegate
record

C# también proporciona los siguientes tipos de referencia integrados:

dynamic
object
string

Vea también
Referencia de C#
Palabras clave de C#
Tipos de puntero
Tipos de valor
Tipos de referencia integrados
(referencia de C#)
Artículo • 25/02/2023 • Tiempo de lectura: 11 minutos

C# tiene muchos tipos de referencia integrados. Tienen palabras clave u operadores que
son sinónimos para un tipo en la biblioteca de .NET.

El tipo de objeto
El tipo object es un alias de System.Object en .NET. En el sistema de tipos unificado de
C#, todos los tipos, los predefinidos y los definidos por el usuario, los tipos de referencia
y los tipos de valores, heredan directa o indirectamente de System.Object. Puede
asignar valores de cualquier tipo a las variables de tipo object . Cualquier variable
object puede asignarse a su valor predeterminado con el literal null . Cuando una
variable de un tipo de valor se convierte en objeto, se dice que se aplica la conversión
boxing. Cuando una variable de tipo object se convierte en un tipo de valor, se dice que
se aplica la conversión unboxing. Para obtener más información, vea Conversión boxing
y unboxing.

Tipo string
El tipo string representa una secuencia de cero o más caracteres Unicode. string es
un alias de System.String en .NET.

Aunque string es un tipo de referencia, se definen los operadores de igualdad == y !=

para comparar los valores de los objetos string , no las referencias. La igualdad basada
en valores hace que las pruebas de igualdad de cadenas sean más intuitivas. Por
ejemplo:

C#

string a = "hello";

string b = "h";

// Append to contents of 'b'

b += "ello";

Console.WriteLine(a == b);

Console.WriteLine(object.ReferenceEquals(a, b));

En el ejemplo anterior se muestra "True" y luego "False" porque el contenido de las

cadenas es equivalente, pero a y b no hacen referencia a la misma instancia de cadena.
El operador + concatena cadenas:

C#

string a = "good " + "morning";

El código anterior crea un objeto de cadena que contiene "good morning".

Las cadenas son inmutables: el contenido de un objeto de cadena no se puede

modificar una vez creado el objeto. Por ejemplo, al escribir este código, el compilador
crea en realidad otro objeto de cadena para almacenar la nueva secuencia de caracteres,
y este nuevo objeto se asigna a b . La memoria que se había asignado para b (cuando
contiene la cadena "h") es entonces apto para la recolección de elementos.

C#

string b = "h";

b += "ello";

El [] operador puede usarse para el acceso de solo lectura a determinados caracteres

de una cadena. Los valores válidos comienzan por 0 y deben ser menores que la
longitud de la cadena:

C#

string str = "test";

char x = str[2]; // x = 's';

De igual manera, el operador [] también puede usarse para recorrer en iteración cada
carácter en una cadena:

C#

string str = "test";

for (int i = 0; i < str.Length; i++)

Console.Write(str[i] + " ");

// Output: t e s t

Literales de cadena
Los literales de cadena son de tipo string y se pueden escribir de tres formas: sin
formato, entre comillas y textuales.

Los literales de cadena sin formato están disponibles a partir de C# 11. Los literales de
cadena sin formato pueden contener texto arbitrario sin necesidad de secuencias de
escape. Los literales de cadena sin formato pueden incluir espacios en blanco, nuevas
líneas, comillas insertadas y otros caracteres especiales. Los literales de cadena sin
formato se incluyen entre tres comillas dobles como mínimo ("""):

C#

"""

This is a multi-line

string literal with the second line indented.

"""

Incluso puede incluir una secuencia de tres caracteres (o más) de comillas dobles. Si el
texto requiere una secuencia de comillas insertada, se inicia y finaliza el literal de cadena
sin formato con más comillas, según sea necesario:

C#

"""""

This raw string literal has four """", count them: """" four!

embedded quote characters in a sequence. That's why it starts and ends

with five double quotes.

You could extend this example with as many embedded quotes as needed for
your text.

"""""

Los literales de cadena sin formato suelen tener las secuencias de comillas iniciales y
finales en líneas independientes del texto insertado. Los literales de cadena sin formato
de varias líneas admiten cadenas entre comillas:

C#

var message = """

"This is a very important message."

""";

Console.WriteLine(message);

// output: "This is a very important message."

Cuando las comillas iniciales y finales están en líneas distintas, las líneas nuevas después
de la comilla inicial y final no se incluyen en el contenido final. La secuencia de comillas
de cierre dictamina la columna situada más a la izquierda del literal de cadena. Puede
aplicar sangría a un literal de cadena sin formato para que coincida con el formato de
código general:

C#

var message = """

"This is a very important message."

""";

Console.WriteLine(message);

// output: "This is a very important message."

// The leftmost whitespace is not part of the raw string literal

Se conservan las columnas a la derecha de la secuencia de comillas finales. Este

comportamiento permite cadenas sin procesar para formatos de datos como JSON,
YAML o XML, como se muestra en el ejemplo siguiente:

C#

var json= """

"prop": 0

""";

El compilador emite un error si alguna de las líneas de texto se extiende a la izquierda

de la secuencia de comillas de cierre. Las secuencias de comillas de apertura y cierre
pueden estar en la misma línea, siempre y cuando el literal de cadena no comience ni
termine con un carácter de comilla:

C#

var shortText = """He said "hello!" this morning.""";

Puede combinar literales de cadena sin formato con interpolación de cadenas para
incluir caracteres de comilla y llaves en la cadena de salida.

Los literales de cadena se incluyen entre comillas dobles ("):

C#

"good morning" // a string literal

Los literales de cadena pueden contener cualquier literal de carácter. Se incluyen

secuencias de escape. En el ejemplo siguiente se usa una secuencia de escape \\ para
la barra diagonal inversa, \u0066 para la letra f y \n para la nueva línea.
 C#

string a = "\\\u0066\n F";

Console.WriteLine(a);

// Output:

// \f

// F

７ Nota

El código de escape \udddd (donde dddd es un número de cuatro dígitos)

representa el carácter Unicode U+ dddd . También se reconocen los códigos de
escape Unicode de 8 dígitos: \Udddddddd .

Los literales de cadena textual empiezan por @ y también se incluyen entre comillas
dobles. Por ejemplo:

C#

@"good morning" // a string literal

La ventaja de las cadenas textuales es que las secuencias de escape no se procesan, lo

que facilita la escritura. Por ejemplo, el texto siguiente coincide con un nombre de
archivo completo de Windows:

C#

@"c:\Docs\Source\a.txt" // rather than "c:\\Docs\\Source\\a.txt"

Para incluir una comilla doble en una cadena @entrecomillada, duplique esto:

C#

@"""Ahoy!"" cried the captain." // "Ahoy!" cried the captain.

Literales de cadena de UTF-8

Las cadenas de .NET se almacenan mediante codificación UTF-16. UTF-8 es el estándar
para los protocolos web y otras bibliotecas importantes. A partir de C# 11, puede
agregar el u8 sufijo a un literal de cadena para especificar la codificación UTF-8. Los
literales UTF-8 se almacenan como ReadOnlySpan<byte> objetos. El tipo natural de un
literal de cadena UTF-8 es ReadOnlySpan<byte> . El uso de un literal de cadena UTF-8 crea
una declaración más clara que declarar el equivalente System.ReadOnlySpan<T>, como
se muestra en el código siguiente:

C#

ReadOnlySpan<byte> AuthWithTrailingSpace = new byte[] { 0x41, 0x55, 0x54,

0x48, 0x20 };

ReadOnlySpan<byte> AuthStringLiteral = "AUTH "u8;

Para almacenar un literal de cadena UTF-8 como una matriz, se requiere el uso de
ReadOnlySpan<T>.ToArray() para copiar los bytes que contienen el literal en la matriz
mutable:

C#

byte[] AuthStringLiteral = "AUTH "u8.ToArray();

Los literales de cadena UTF-8 no son constantes en tiempo de compilación; son

constantes en tiempo de ejecución. Por lo tanto, no se pueden usar como valor
predeterminado para un parámetro opcional. Los literales de cadena UTF-8 no se
pueden combinar con interpolación de cadenas. No se puede usar el $ token y el u8
sufijo en la misma expresión de cadena.

Tipo delegate
La declaración de un tipo delegado es similar a una firma de método. Tiene un valor
devuelto y un número cualquiera de parámetros de cualquier tipo:

C#

public delegate void MessageDelegate(string message);

public delegate int AnotherDelegate(MyType m, long num);

En. NET, los tipos System.Action y System.Func proporcionan definiciones genéricas

para muchos delegados comunes. Es probable que no sea necesario definir nuevos tipos
delegados personalizados. En su lugar, puede crear instancias de los tipos genéricos
proporcionados.

Un delegate es un tipo de referencia que puede usarse para encapsular un método con
nombre o anónimo. Los delegados son similares a los punteros de función en C++; pero
son más seguros y proporcionan mayor seguridad de tipos. Para las aplicaciones de
delegados, vea Delegados y Delegados genéricos. Los delegados son la base de los
eventos. Se pueden crear instancias de un delegado asociándolo a un método con
nombre o anónimo.

Para crear instancias del delegado debe usarse un método o una expresión lambda que
tenga un tipo de valor devuelto y parámetros de entrada compatibles. Para obtener más
información sobre el grado de variación permitida en la firma de método, vea Varianza
en delegados. Para el uso con métodos anónimos, el delegado y el código que se van a
asociar se declaran juntos.

Se produce un error en la combinación y eliminación de delegados con una excepción

en tiempo de ejecución cuando los tipos delegados implicados en el tiempo de
ejecución son diferentes debido a la conversión de variantes. En el ejemplo siguiente se
muestra una situación que produce un error:

C#

Action<string> stringAction = str => {};

Action<object> objectAction = obj => {};

// Valid due to implicit reference conversion of

// objectAction to Action<string>, but may fail

// at run time.

Action<string> combination = stringAction + objectAction;

Puede crear un delegado con el tipo de tiempo de ejecución correcto mediante la

creación de un objeto delegado. En el ejemplo siguiente se muestra cómo se puede
aplicar esta solución alternativa al ejemplo anterior.

C#

Action<string> stringAction = str => {};

Action<object> objectAction = obj => {};

// Creates a new delegate instance with a runtime type of Action<string>.

Action<string> wrappedObjectAction = new Action<string>(objectAction);

// The two Action<string> delegate instances can now be combined.

Action<string> combination = stringAction + wrappedObjectAction;

A partir de C# 9, puede declarar punteros de función, que usan una sintaxis similar. Un
puntero de función usa la instrucción calli en lugar de crear instancias de un tipo
delegado y llamar al método virtual Invoke .

Tipo dynamic
El tipo dynamic indica el uso de la variable y las referencias a su comprobación de tipos
en el tiempo de compilación de omisión de miembros. En su lugar, se resuelven estas
operaciones en tiempo de ejecución. El tipo dynamic simplifica el acceso a las API de
COM como las API de automatización de Office, a API dinámicas como las bibliotecas de
IronPython, y a Document Object Model (DOM) HTML.

El tipo dynamic se comporta como el tipo object en la mayoría de las circunstancias. En

concreto, se puede convertir cualquier expresión no NULL para el tipo dynamic . El tipo
dynamic se diferencia de object en que el compilador no resuelve o no comprueba el

tipo de las operaciones que contienen expresiones de tipo dynamic . El compilador

empaqueta información sobre la operación y esa información se usa después para
evaluar la operación en tiempo de ejecución. Como parte del proceso, las variables de
tipo dynamic están compiladas en las variables de tipo object . Por consiguiente, el tipo
dynamic solo existe en tiempo de compilación, no en tiempo de ejecución.

En el siguiente ejemplo se contrasta una variable de tipo dynamic con una variable de
tipo object . Para comprobar el tipo de cada variable en tiempo de compilación,
coloque el puntero del mouse sobre dyn u obj en las instrucciones WriteLine . Copie el
código siguiente en un editor donde IntelliSense esté disponible. IntelliSense muestra
dynamic para dyn y object para obj .

C#

class Program

static void Main(string[] args)

dynamic dyn = 1;

object obj = 1;

// Rest the mouse pointer over dyn and obj to see their

// types at compile time.

System.Console.WriteLine(dyn.GetType());

System.Console.WriteLine(obj.GetType());

Las instrucciones WriteLine muestran los tipos en tiempo de ejecución de dyn y obj . En
ese punto, ambos tienen el mismo tipo, entero. Se produce el siguiente resultado:

Consola

System.Int32

System.Int32

Para ver la diferencia entre dyn y obj en tiempo de compilación, agregue las dos líneas
siguientes entre las declaraciones y las instrucciones WriteLine en el ejemplo anterior.

C#

dyn = dyn + 3;

obj = obj + 3;

Un error del compilador se notifica para el intento de suma de un entero y un objeto en

la expresión obj + 3 . En cambio, no se notifica ningún error para dyn + 3 . En tiempo de
compilación no se comprueba la expresión que contiene dyn porque el tipo de dyn es
dynamic .

El ejemplo siguiente usa dynamic en varias declaraciones. El método Main también

contrasta la comprobación de tipo en tiempo de compilación con la comprobación de
tipo en tiempo de ejecución.

C#

using System;

namespace DynamicExamples

class Program

static void Main(string[] args)

ExampleClass ec = new ExampleClass();

Console.WriteLine(ec.ExampleMethod(10));

Console.WriteLine(ec.ExampleMethod("value"));

// The following line causes a compiler error because

ExampleMethod

// takes only one argument.

//Console.WriteLine(ec.ExampleMethod(10, 4));

dynamic dynamic_ec = new ExampleClass();

Console.WriteLine(dynamic_ec.ExampleMethod(10));

// Because dynamic_ec is dynamic, the following call to

ExampleMethod

// with two arguments does not produce an error at compile time.

// However, it does cause a run-time error.

//Console.WriteLine(dynamic_ec.ExampleMethod(10, 4));

class ExampleClass

static dynamic _field;

 dynamic Prop { get; set; }

public dynamic ExampleMethod(dynamic d)

dynamic local = "Local variable";

int two = 2;

if (d is int)

return local;

else

return two;

// Results:

// Local variable

// 2

// Local variable

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

§8.2.3 Tipo de objeto

§8.2.4 Tipo dinámico
§8.2.5 Tipo de cadena
§8.2.8 Tipos delegados
C# 11: Literales de cadena sin formato
C# 11: Literales de cadena sin formato

Vea también
Referencia de C#
Palabras clave de C#
Eventos
Uso de tipo dinámico
Procedimientos recomendados para el uso de cadenas
Operaciones básicas de cadenas
Creación de cadenas
Operadores de conversión y prueba de tipos
Procedimiento para convertir de forma segura mediante la coincidencia de
patrones y los operadores is y as
Tutorial: Crear y usar objetos dinámicos (C# y Visual Basic)
System.Object
System.String
System.Dynamic.DynamicObject
Registros (referencia de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 19 minutos

A partir de C# 9, se usa la palabra clave record para definir un tipo de referencia que
proporciona funcionalidad integrada para encapsular los datos. C# 10 permite la sintaxis
record class como sinónimo para aclarar un tipo de referencia y record struct para
definir un tipo de valor con una funcionalidad similar. Puede crear tipos de registros con
propiedades inmutables mediante parámetros posicionales o sintaxis de propiedades
estándar.

En los dos ejemplos siguientes se muestran tipos de referencia record (o record class ):

C#

public record Person(string FirstName, string LastName);

C#

public record Person

public required string FirstName { get; init; }

public required string LastName { get; init; }

};

En los dos ejemplos siguientes se muestran tipos de valor record struct :

C#

public readonly record struct Point(double X, double Y, double Z);

C#

public record struct Point

public double X { get; init; }

public double Y { get; init; }

public double Z { get; init; }

También puede crear registros con propiedades y campos mutables:

C#
 public record Person

public required string FirstName { get; set; }

public required string LastName { get; set; }

};

Las estructuras de registro también pueden ser mutables, tanto estructuras de registro
posicionales como estructuras de registro sin parámetros posicionales:

C#

public record struct DataMeasurement(DateTime TakenAt, double Measurement);

C#

public record struct Point

public double X { get; set; }

public double Y { get; set; }

public double Z { get; set; }

Aunque los registros pueden ser mutables, están destinados principalmente a admitir
modelos de datos inmutables. El tipo de registro ofrece las siguientes características:

Sintaxis concisa para crear un tipo de referencia con propiedades inmutables

Comportamiento integrado útil para un tipo de referencia centrado en datos:
Igualdad de valores
Sintaxis concisa para la mutación no destructiva
Formato integrado para la presentación
Compatibilidad con las jerarquías de herencia

En los ejemplos anteriores se muestran algunas diferencias entre los registros que son
tipos de referencia y que son tipos de valor:

Un elemento record o record class declara un tipo de referencia. La palabra clave

class es opcional, pero puede agregar claridad para los lectores. Un elemento
record struct declara un tipo de valor.

Las propiedades posicionales son inmutables en record class y readonly record

struct . Son mutables en record struct .

En el resto de este artículo se describen los tipos record class y record struct . Las
diferencias se detallan en cada sección. Debe elegir entre record class y record
struct , de la misma forma que se elige entre class y struct . El término registro se usa

para describir el comportamiento que se aplica a todos los tipos de registro. Se usa
record struct o record class para describir el comportamiento que se aplica solo a los

tipos de estructura o de clase, respectivamente. El tipo record se incorporó en C# 9,

mientras que los tipos record struct lo hicieron en C# 10.

Sintaxis posicional para la definición de

propiedad
Puede usar parámetros posicionales para declarar propiedades de un registro e
inicializar los valores de propiedad al crear una instancia:

C#

public record Person(string FirstName, string LastName);

public static void Main()

Person person = new("Nancy", "Davolio");

Console.WriteLine(person);

// output: Person { FirstName = Nancy, LastName = Davolio }

Cuando se usa la sintaxis posicional para la definición de propiedad, el compilador crea

lo siguiente:

Una propiedad pública implementada automáticamente para cada parámetro

posicional proporcionado en la declaración de registro.
Para los tipos record y readonly record struct : una propiedad init-only.
Para los tipos record struct : una propiedad read-write.
Un constructor primario cuyos parámetros coinciden con los parámetros
posicionales en la declaración del registro.
Para los tipos de estructura de registro, un constructor sin parámetros que
establece cada campo en su valor predeterminado.
Un método Deconstruct con un parámetro out para cada parámetro posicional
proporcionado en la declaración de registro. El método deconstruye las
propiedades definidas mediante la sintaxis posicional; omite las propiedades que
se definen mediante la sintaxis de propiedades estándar.

Es posible que le interese agregar atributos a cualquiera de estos elementos que el

compilador crea a partir de la definición de registro. Puede agregar un destino a
cualquier atributo que aplique a las propiedades del registro posicional. En el ejemplo
siguiente se aplica System.Text.Json.Serialization.JsonPropertyNameAttribute a cada
propiedad del registro Person . El destino property: indica que el atributo se aplica a la
propiedad generada por el compilador. Otros valores son field: para aplicar el atributo
al campo y param: para aplicar el atributo al parámetro.

C#

/// <summary>

/// Person record type

/// </summary>

/// <param name="FirstName">First Name</param>

/// <param name="LastName">Last Name</param>

/// <remarks>

/// The person type is a positional record containing the

/// properties for the first and last name. Those properties

/// map to the JSON elements "firstName" and "lastName" when

/// serialized or deserialized.

/// </remarks>

public record Person([property: JsonPropertyName("firstName")]string

FirstName,

[property: JsonPropertyName("lastName")]string LastName);

En el ejemplo anterior también se muestra cómo crear comentarios de documentación

XML para el registro. Puede agregar la etiqueta <param> para agregar documentación
para los parámetros del constructor principal.

Si la definición de propiedad implementada automáticamente generada no es la que

desea, puede definir su propia propiedad con el mismo nombre. Por ejemplo, puede
cambiar la accesibilidad o la mutabilidad, o proporcionar una implementación para el
descriptor de acceso get o set . Si declara la propiedad en el origen, debe inicializarla
desde el parámetro posicional del registro. Si la propiedad es una propiedad
implementada automáticamente, debe inicializarla. Si agrega un campo de respaldo en
el origen, debe inicializarlo. El deconstructor generado usará la definición de propiedad.
En el ejemplo siguiente se declaran las propiedades FirstName y LastName de un
registro posicional public , pero el parámetro posicional Id se restringe a internal .
Puede usar esta sintaxis para registros y tipos de estructura de registros.

C#

public record Person(string FirstName, string LastName, string Id)

internal string Id { get; init; } = Id;

public static void Main()

Person person = new("Nancy", "Davolio", "12345");

 Console.WriteLine(person.FirstName); //output: Nancy

Un tipo de registro no tiene que declarar ninguna propiedad posicional. Puede declarar
un registro sin propiedades posicionales, y otros campos y propiedades, como en el
ejemplo siguiente:

C#

public record Person(string FirstName, string LastName)

public string[] PhoneNumbers { get; init; } = Array.Empty<string>();

};

Si define propiedades mediante la sintaxis de propiedades estándar, pero omite el

modificador de acceso, las propiedades son private implícitamente.

Inmutabilidad
Un registro posicional y una estructura de registro de solo lectura posicional declaran
propiedades de solo inicialización. Una estructura de registro posicional declara
propiedades de lectura y escritura. Puede invalidar cualquiera de esos valores
predeterminados, como se ha mostrado en la sección anterior.

La inmutabilidad puede resultar útil si necesita que un tipo centrado en datos sea
seguro para subprocesos o si depende de que un código hash quede igual en una tabla
hash. Sin embargo, la inmutabilidad no es adecuada para todos los escenarios de datos.
Por ejemplo, Entity Framework Core no admite la actualización con tipos de entidad
inmutables.

Las propiedades de solo inicialización, tanto si se crean a partir de parámetros

posicionales ( record class y readonly record struct ) como al especificar descriptores
de acceso init , tienen una inmutabilidad superficial. Después de la inicialización, no se
puede cambiar el valor de las propiedades de tipo de valor ni la referencia de las
propiedades de tipo de referencia. Sin embargo, se pueden cambiar los datos a los que
hace referencia una propiedad de tipo de referencia. En el ejemplo siguiente se muestra
que el contenido de una propiedad inmutable de tipo de referencia (una matriz en este
caso) es mutable:

C#
 public record Person(string FirstName, string LastName, string[]
PhoneNumbers);

public static void Main()

Person person = new("Nancy", "Davolio", new string[1] { "555-1234" });

Console.WriteLine(person.PhoneNumbers[0]); // output: 555-1234

person.PhoneNumbers[0] = "555-6789";

Console.WriteLine(person.PhoneNumbers[0]); // output: 555-6789

Las características exclusivas de los tipos de registro se implementan mediante métodos

sintetizados por el compilador, y ninguno de estos métodos pone en peligro la
inmutabilidad mediante la modificación del estado del objeto. A menos que se
especifique, se generan métodos sintetizados para las declaraciones de record , record
struct y readonly record struct .

Igualdad de valores
Si no invalida o reemplaza métodos de igualdad, el tipo que declara rige cómo se define
la igualdad:

Para los tipos class , dos objetos son iguales si hacen referencia al mismo objeto
en memoria.
Para los tipos struct , dos objetos son iguales si son del mismo tipo y almacenan
los mismos valores.
Para los tipos record , incluidos record struct y readonly record struct , dos
objetos son iguales si son del mismo tipo y almacenan los mismos valores.

La definición de igualdad para record struct es la misma que para struct . La

diferencia es que para struct , la implementación está en ValueType.Equals(Object) y se
basa en la reflexión. Para los registros, la implementación se sintetiza en el compilador y
usa los miembros de datos declarados.

Se requiere la igualdad de referencia en algunos modelos de datos. Por ejemplo, Entity

Framework Core depende de la igualdad de referencia para garantizar que solo usa una
instancia de un tipo de entidad para lo que es conceptualmente una entidad. Por esta
razón, los registros y las estructuras de registro no son adecuados para su uso como
tipos de entidad en Entity Framework Core.

En el ejemplo siguiente se muestra la igualdad de valores de tipos de registro:

 C#

public record Person(string FirstName, string LastName, string[]

PhoneNumbers);

public static void Main()

var phoneNumbers = new string[2];

Person person1 = new("Nancy", "Davolio", phoneNumbers);

Person person2 = new("Nancy", "Davolio", phoneNumbers);

Console.WriteLine(person1 == person2); // output: True

person1.PhoneNumbers[0] = "555-1234";

Console.WriteLine(person1 == person2); // output: True

Console.WriteLine(ReferenceEquals(person1, person2)); // output: False

Para implementar la igualdad de valores, el compilador sintetiza los métodos siguientes:

Una invalidación de Object.Equals(Object). Se trata de un error si la invalidación se

declara explícitamente.

Este método se utiliza como base para el método estático Object.Equals(Object,

Object) cuando ambos parámetros no son NULL.

Un virtual , o sealed , Equals(R? other) donde R es el tipo de registro. Este

método implementa IEquatable<T>. Este método se puede declarar
explícitamente.

Si el tipo de registro se deriva de un tipo de registro base Base , Equals(Base?

other) . Se trata de un error si la invalidación se declara explícitamente. Si
proporciona su propia implementación de Equals(R? other) en un tipo de
registro, proporcione también una implementación de GetHashCode .

Una invalidación de Object.GetHashCode(). Este método se puede declarar

explícitamente.

Invalidaciones de los operadores == y != . Es un error si los operadores se declaran

explícitamente.

Si el tipo de registro se deriva de un tipo de registro base, protected override

Type EqualityContract { get; }; . Esta propiedad se puede declarar

explícitamente. Para obtener más información, consulte Igualdad en jerarquías de

herencia.
Si un tipo de registro tiene un método que coincide con la firma de un método
sintetizado que se puede declarar explícitamente, el compilador no sintetiza ese
método.

Mutación no destructiva
Si necesita copiar una instancia de registro con algunas modificaciones, puede usar una
expresión with para lograr una mutación no destructiva. Una expresión with crea una
instancia de registro que es una copia de una instancia de registro existente, con las
propiedades y los campos especificados modificados. Use la sintaxis del inicializador de
objeto para especificar los valores que se van a cambiar, como se muestra en el ejemplo
siguiente:

C#

public record Person(string FirstName, string LastName)

public string[] PhoneNumbers { get; init; }

public static void Main()

Person person1 = new("Nancy", "Davolio") { PhoneNumbers = new string[1]

};

Console.WriteLine(person1);

// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers

= System.String[] }

Person person2 = person1 with { FirstName = "John" };

Console.WriteLine(person2);

// output: Person { FirstName = John, LastName = Davolio, PhoneNumbers =

System.String[] }

Console.WriteLine(person1 == person2); // output: False

person2 = person1 with { PhoneNumbers = new string[1] };

Console.WriteLine(person2);

// output: Person { FirstName = Nancy, LastName = Davolio, PhoneNumbers

= System.String[] }

Console.WriteLine(person1 == person2); // output: False

person2 = person1 with { };

Console.WriteLine(person1 == person2); // output: True

La expresión with puede establecer propiedades posicionales o propiedades creadas

con la sintaxis de propiedades estándar. Las propiedades no posicionales deben tener
un descriptor de acceso init o set para cambiar en una expresión with .
El resultado de una expresión with es una copia superficial, lo que significa que, para
una propiedad de referencia, solo se copia la referencia a una instancia. Tanto el registro
original como la copia terminan con una referencia a la misma instancia.

A fin de implementar esta característica para los tipos record class , el compilador
sintetiza un método de clonación y un constructor de copia. El método de clonación
virtual devuelve un nuevo registro inicializado por el constructor de copia. Cuando se
usa una expresión with , el compilador crea código que llama al método de clonación y,
después, establece las propiedades que se especifican en la expresión with .

Si necesita otro comportamiento de copia, puede escribir un constructor de copia

propio en una instancia de record class . Si lo hace, el compilador no sintetizará un
método. Cree su constructor private si el registro es sealed ; de lo contrario,
conviértalo en protected . El compilador no sintetiza un constructor de copia para los
tipos record struct . Puede escribir uno, pero el compilador no generará llamadas a él
para las expresiones with . Los valores de record struct se copian en la asignación.

No puede invalidar el método de clonación y no puede crear un miembro denominado

Clone en ningún tipo de registro. El nombre real del método de clon lo genera el

compilador.

Formato integrado para la presentación

Los tipos de registros tienen un método ToString generado por el compilador que
muestra los nombres y los valores de las propiedades y los campos públicos. El método
ToString devuelve una cadena con el formato siguiente:

<nombre del tipo de registro> {<nombre de la propiedad> = <valor>, <nombre de

la propiedad> = <valor>, ...}

La cadena impresa para <value> es la cadena devuelta por ToString() para el tipo de la
propiedad. En el ejemplo siguiente, ChildNames es System.Array, donde ToString
devuelve System.String[] :

Person { FirstName = Nancy, LastName = Davolio, ChildNames = System.String[]

}

Para implementar esta característica, en los tipos record class el compilador sintetiza
un método PrintMembers virtual y una invalidación de ToString. En los tipos record
struct , este miembro es private .
La invalidación ToString crea un objeto StringBuilder

con el nombre de tipo seguido de un corchete de apertura. Llama a PrintMembers para

agregar nombres y valores de propiedad y, a continuación, agrega el corchete de cierre.
En el ejemplo siguiente se muestra código similar al que contiene la invalidación
sintetizada:

C#

public override string ToString()

StringBuilder stringBuilder = new StringBuilder();

stringBuilder.Append("Teacher"); // type name

stringBuilder.Append(" { ");

if (PrintMembers(stringBuilder))

stringBuilder.Append(" ");

stringBuilder.Append("}");

return stringBuilder.ToString();

Puede proporcionar su propia implementación de PrintMembers o la invalidación

ToString . En la sección Formato PrintMembers en registros derivados que se encuentra

más adelante en este artículo se proporcionan ejemplos. En C# 10 y versiones

posteriores, la implementación de ToString puede incluir el modificador sealed , lo que
impide que el compilador sintetice una implementación de ToString para los registros
derivados. Puede hacerlo para crear una representación de cadena coherente en una
jerarquía de tipos record . (Los registros derivados seguirán teniendo un método
PrintMembers generado para todas las propiedades derivadas).

Herencia
Esta sección solo se aplica a los tipos record class .

Un registro puede heredar de otro registro. Sin embargo, un registro no puede heredar
de una clase, y una clase no puede heredar de un registro.

Parámetros posicionales en tipos de registro derivados

El registro derivado declara parámetros para todos los parámetros del constructor
primario del registro base. El registro base declara e inicializa esas propiedades. El
registro derivado no las oculta, sino que solo crea e inicializa propiedades para los
parámetros que no se han declarado en su registro base.
En el ejemplo siguiente se muestra la herencia con la sintaxis de la propiedad posicional:

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

Console.WriteLine(teacher);

// output: Teacher { FirstName = Nancy, LastName = Davolio, Grade = 3 }

Igualdad en las jerarquías de herencia

Esta sección se aplica a los tipos record class , pero no a los tipos record struct . Para
que dos variables de registro sean iguales, el tipo en tiempo de ejecución debe ser el
mismo. Los tipos de las variables contenedoras podrían ser diferentes. La comparación
de igualdad heredada se muestra en el ejemplo de código siguiente:

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public record Student(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

Person student = new Student("Nancy", "Davolio", 3);

Console.WriteLine(teacher == student); // output: False

Student student2 = new Student("Nancy", "Davolio", 3);

Console.WriteLine(student2 == student); // output: True

En el ejemplo, todas las variables se declaran como Person , incluso cuando la instancia
es un tipo derivado de Student o Teacher . Las instancias tienen las mismas propiedades
y los mismos valores de propiedad. Pero student == teacher devuelve False , aunque
ambas son variables de tipo Person , y student == student2 devuelve True , aunque una
es una variable Person y otra es una variable Student . La prueba de igualdad depende
del tipo en tiempo de ejecución del objeto real, no del tipo declarado de la variable.
Para implementar este comportamiento, el compilador sintetiza una propiedad
EqualityContract que devuelve un objeto Type que coincide con el tipo del registro.
EqualityContract permite a los métodos de igualdad comparar el tipo en tiempo de

ejecución de los objetos cuando comprueban la igualdad. Si el tipo base de un registro

es object , esta propiedad es virtual . Si el tipo base es otro tipo de registro, la
propiedad es una invalidación. Si el tipo de registro es sealed , esta propiedad tiene un
estado sealed eficaz porque el tipo es sealed .

Al comparar dos instancias de un tipo derivado, los métodos de igualdad sintetizados

comprueban la igualdad de todas las propiedades de los tipos base y derivados. El
método GetHashCode sintetizado usa el método GetHashCode de todas las propiedades y
los campos declarados en el tipo base y el tipo de registro derivado.

Expresiones with en registros derivados

El resultado de una expresión with tiene el mismo tipo de entorno de ejecución que el
operando de la expresión. Se copian todas las propiedades del tipo en tiempo de
ejecución, pero solo se pueden establecer las propiedades del tipo en tiempo de
compilación, como se muestra en el ejemplo siguiente:

C#

public record Point(int X, int Y)

public int Zbase { get; set; }

};

public record NamedPoint(string Name, int X, int Y) : Point(X, Y)

public int Zderived { get; set; }

};

public static void Main()

Point p1 = new NamedPoint("A", 1, 2) { Zbase = 3, Zderived = 4 };

Point p2 = p1 with { X = 5, Y = 6, Zbase = 7 }; // Can't set Name or

Zderived

Console.WriteLine(p2 is NamedPoint); // output: True

Console.WriteLine(p2);

// output: NamedPoint { X = 5, Y = 6, Zbase = 7, Name = A, Zderived = 4

}

Point p3 = (NamedPoint)p1 with { Name = "B", X = 5, Y = 6, Zbase = 7,

Zderived = 8 };

Console.WriteLine(p3);

// output: NamedPoint { X = 5, Y = 6, Zbase = 7, Name = B, Zderived = 8

 }

Formato PrintMembers en registros derivados

El método sintetizado PrintMembers de un tipo de registro derivado llama a la
implementación base. El resultado es que todas las propiedades y los campos públicos
de los tipos derivados y base se incluyen en la salida ToString , como se muestra en el
ejemplo siguiente:

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public record Student(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

Console.WriteLine(teacher);

// output: Teacher { FirstName = Nancy, LastName = Davolio, Grade = 3 }

Puede proporcionar su propia implementación del método PrintMembers . Si lo hace, use

la siguiente firma:

Para un registro sealed que deriva de object (no declara un registro base):
private bool PrintMembers(StringBuilder builder) .

Para un registro sealed que se deriva de otro registro (tenga en cuenta que el tipo
envolvente es sealed , por lo que el método tiene un estado sealed eficaz):
protected override bool PrintMembers(StringBuilder builder) .

Para un registro que no es sealed y que deriva del objeto: protected virtual bool
PrintMembers(StringBuilder builder); .

Para un registro que no es sealed y que deriva de otro registro: protected

override bool PrintMembers(StringBuilder builder); .

Este es un ejemplo de código que reemplaza los métodos sintetizados PrintMembers ,

uno para un tipo de registro que se deriva de un objeto y otro para un tipo de registro
que se deriva de otro registro:

C#
 public abstract record Person(string FirstName, string LastName, string[]
PhoneNumbers)

protected virtual bool PrintMembers(StringBuilder stringBuilder)

stringBuilder.Append($"FirstName = {FirstName}, LastName =

{LastName}, ");

stringBuilder.Append($"PhoneNumber1 = {PhoneNumbers[0]},
PhoneNumber2 = {PhoneNumbers[1]}");

return true;

public record Teacher(string FirstName, string LastName, string[]

PhoneNumbers, int Grade)

: Person(FirstName, LastName, PhoneNumbers)

protected override bool PrintMembers(StringBuilder stringBuilder)

if (base.PrintMembers(stringBuilder))

stringBuilder.Append(", ");

};

stringBuilder.Append($"Grade = {Grade}");

return true;

};

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", new string[2] { "555-

1234", "555-6789" }, 3);

Console.WriteLine(teacher);

// output: Teacher { FirstName = Nancy, LastName = Davolio, PhoneNumber1

= 555-1234, PhoneNumber2 = 555-6789, Grade = 3 }

７ Nota

En C# 10 y versiones posteriores, el compilador sintetizará PrintMembers en

registros derivados cuando un registro base haya sellado el método ToString .
También puede crear una implementación de PrintMembers propia.

Comportamiento del deconstructor en registros

derivados
El método Deconstruct de un registro derivado devuelve los valores de todas las
propiedades posicionales del tipo en tiempo de compilación. Si el tipo de variable es un
registro base, solo se deconstruyen las propiedades del registro base a menos que el
objeto se convierta en el tipo derivado. En el ejemplo siguiente se muestra cómo llamar
a un deconstructor en un registro derivado.

C#

public abstract record Person(string FirstName, string LastName);

public record Teacher(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public record Student(string FirstName, string LastName, int Grade)

: Person(FirstName, LastName);

public static void Main()

Person teacher = new Teacher("Nancy", "Davolio", 3);

var (firstName, lastName) = teacher; // Doesn't deconstruct Grade

Console.WriteLine($"{firstName}, {lastName}");// output: Nancy, Davolio

var (fName, lName, grade) = (Teacher)teacher;

Console.WriteLine($"{fName}, {lName}, {grade}");// output: Nancy,

Davolio, 3

Restricciones genéricas
No hay ninguna restricción genérica en la que sea necesario que un tipo sea un registro.
Los registros satisfacen la restricción class o struct . Para realizar una restricción en
una jerarquía específica de tipos de registro, coloque la restricción en el registro base
como lo haría con una clase base. Para obtener más información, vea Restricciones de
tipos de parámetros.

especificación del lenguaje C#

Para más información, vea la sección Clases de la especificación del lenguaje C#.

Para obtener más información sobre de las características presentadas en C# 9 y

versiones posteriores, vea las siguientes notas de propuesta de características:

Registros
Establecedores de solo inicialización
Valores devueltos de covariante
Vea también
Referencia de C#
Instrucciones de diseño: elección entre clase y estructura
Instrucciones de diseño: diseño de estructuras
El sistema de tipos de C#
Expresión with
class (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las clases se declaran mediante la palabra clave class , como se muestra en el siguiente
ejemplo:

C#

class TestClass

// Methods, properties, fields, events, delegates

// and nested classes go here.

Comentarios
Solo la herencia simple se permite en C#. En otras palabras, una clase puede heredar la
implementación solo de una clase base. En cambio, una clase puede implementar más
de una interfaz. En la tabla siguiente se muestran ejemplos de herencia de clases e
implementación de interfaces:

Herencia Ejemplo

None class ClassA { }

Single class DerivedClass : BaseClass { }

Ninguna, implementa dos interfaces class ImplClass : IFace1, IFace2 { }

Única, implementa una interfaz class ImplDerivedClass : BaseClass, IFace1 { }

Las clases que se declaran directamente dentro de un espacio de nombres, que no están
anidadas dentro de otras clases, pueden ser de tipo public o internal. De forma
predeterminada, las clases son internal .

Los miembros de clase, incluidas las clases anidadas, pueden ser public, protected
internal, protected, internal, private o private protected. De forma predeterminada, los
miembros son private .

Para obtener más información, consulte Modificadores de acceso.

Puede declarar clases genéricas que tengan parámetros de tipo. Para obtener más
información, consulte Clases genéricas.
Una clase puede contener declaraciones de los miembros siguientes:

Constructores

Constantes

Fields

Finalizadores

Métodos

Propiedades

Indizadores

Operadores

Eventos

Delegados

Clases

Interfaces

Tipos de estructura

Tipos de enumeración

Ejemplo
En el ejemplo siguiente se muestra cómo declarar campos de clase, constructores y
métodos. También se muestra la creación de instancias de objeto y la impresión de
datos de instancias. En este ejemplo, se declaran dos clases. La primera clase, Child ,
contiene dos campos privados ( name y age ), dos constructores públicos y un método
público. La segunda clase, StringTest , se usa para contener Main .

C#

class Child

private int age;

private string name;

// Default constructor:

public Child()

 name = "N/A";

// Constructor:

public Child(string name, int age)

this.name = name;

this.age = age;

// Printing method:

public void PrintChild()

Console.WriteLine("{0}, {1} years old.", name, age);

class StringTest

static void Main()

// Create objects by using the new operator:

Child child1 = new Child("Craig", 11);

Child child2 = new Child("Sally", 10);

// Create an object using the default constructor:

Child child3 = new Child();

// Display results:

Console.Write("Child #1: ");

child1.PrintChild();

Console.Write("Child #2: ");

child2.PrintChild();

Console.Write("Child #3: ");

child3.PrintChild();

/* Output:

Child #1: Craig, 11 years old.

Child #2: Sally, 10 years old.

Child #3: N/A, 0 years old.

*/

Comentarios
Observe que en el ejemplo anterior solo se puede acceder a los campos privados ( name
y age ) a través del método público de la clase Child . Por ejemplo, no puede imprimir el
nombre de la clase child, desde el método Main , mediante una instrucción como esta:

C#
 Console.Write(child1.name); // Error

El acceso a miembros privados de Child desde Main solo sería posible si Main fuera un
miembro de la clase.

Los tipos declarados dentro de una clase sin un modificador de acceso adoptan el valor
predeterminado de private , por lo que los miembros de datos de este ejemplo
seguirían siendo private si se quitara la palabra clave.

Por último, tenga en cuenta que, para el objeto creado mediante el constructor sin
parámetros ( child3 ), el campo age se ha inicializado en cero de forma predeterminada.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Tipos de referencia
interface (Referencia de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 5 minutos

Una interfaz define un contrato. Cualquier class o struct que implemente ese contrato
debe proporcionar una implementación de los miembros definidos en la interfaz. Una
interfaz puede definir una implementación predeterminada de miembros. También
puede definir miembros static para proporcionar una única implementación de
funcionalidad común. A partir de C# 11, una interfaz puede definir miembros static
abstract o static virtual para declarar que un tipo de implementación debe
proporcionar los miembros declarados. Normalmente, los métodos static virtual
declaran que una implementación debe definir un conjunto de operadores
sobrecargados.

En el ejemplo siguiente, la clase ImplementationClass debe implementar un método

denominado SampleMethod que no tiene ningún parámetro y devuelve void .

Para obtener más información y ejemplos, vea Interfaces.

Interfaz de ejemplo
C#

interface ISampleInterface

void SampleMethod();

class ImplementationClass : ISampleInterface

// Explicit interface member implementation:

void ISampleInterface.SampleMethod()

// Method implementation.
}

static void Main()

// Declare an interface instance.

ISampleInterface obj = new ImplementationClass();

// Call the member.

obj.SampleMethod();

Una interfaz puede ser un miembro de un espacio de nombres o una clase. Una
declaración de interfaz puede contener declaraciones (firmas sin ninguna
implementación) de los miembros siguientes:

Métodos
Propiedades
Indizadores
Eventos

Miembros de interfaz predeterminados

Normalmente, estas declaraciones de miembros anteriores no contienen ningún cuerpo.
Un miembro de interfaz puede declarar un cuerpo. Los cuerpos miembros de una
interfaz son la implementación predeterminada. Los miembros con cuerpos permiten
que la interfaz proporcione una implementación "predeterminada" de las clases y las
estructuras que no proporcionan una implementación de invalidación. Una interfaz
puede incluir:

Constantes
Operadores
Constructor estático.
Tipos anidados
Campos, métodos, propiedades, indizadores y eventos estáticos.
Declaraciones de miembros con la sintaxis de implementación de interfaz explícita.
Modificadores de acceso explícitos (el acceso predeterminado es public).

Miembros abstractos y virtuales estáticos

A partir de C# 11, una interfaz puede declarar miembros static abstract y static
virtual para todos los tipos de miembros excepto los campos. Las interfaces pueden

declarar que los tipos de implementación deben definir operadores u otros miembros
estáticos. Esta característica permite a los algoritmos genéricos especificar el
comportamiento como un número. Puede ver ejemplos de los tipos numéricos en el
entorno de ejecución de .NET, como System.Numerics.INumber<TSelf>. Estas interfaces
definen operadores matemáticos comunes implementados por muchos tipos numéricos.
El compilador debe resolver las llamadas a los métodos static virtual y static
abstract en tiempo de compilación. Los métodos static virtual y static abstract
declarados en interfaces no tienen un mecanismo de distribución en tiempo de
ejecución análogo a los métodos virtual o abstract declarados en clases. En su lugar,
el compilador usa la información de tipos disponible en tiempo de compilación. Por lo
tanto, los métodos static virtual se declaran casi exclusivamente en interfaces
genéricas. Además, la mayoría de las interfaces que declaran métodos static virtual o
static abstract declaran que uno de los parámetros de tipo debe implementar la

interfaz declarada. Por ejemplo, la interfaz INumber<T> declara que T debe implementar
INumber<T> . El compilador usa el argumento de tipo para resolver llamadas a los

métodos y operadores declarados en la declaración de interfaz. Por ejemplo, el tipo int

implementa INumber<int> . Cuando el parámetro de tipo T denota el argumento de tipo
int , se invocan los miembros static declarados en int . Como alternativa, cuando

double es el argumento type, se invocan los miembros static declarados en el tipo

double .

） Importante

La distribución de métodos para los métodos static abstract y static virtual

declarados en interfaces se resuelve mediante el tipo de tiempo de compilación de
una expresión. Si el tipo en tiempo de ejecución de una expresión se deriva de un
tipo de tiempo de compilación diferente, se llamará a los métodos estáticos en el
tipo base (tiempo de compilación).

Puede probar esta característica trabajando con el tutorial sobre miembros abstractos
estáticos en interfaces.

Herencia de interfaz
Es posible que las interfaces no contengan estado de instancia. Aunque los campos
estáticos ahora están permitidos, los campos de instancia no se permiten en las
interfaces. Las propiedades automáticas de instancia no se admiten en las interfaces, ya
que declararían de forma implícita un campo oculto. Esta regla tiene un efecto sutil en
las declaraciones de propiedad. En una declaración de interfaz, el código siguiente no
declara una propiedad implementada automáticamente como hace en un objeto class
o struct . En su lugar, declara una propiedad que no tiene una implementación
predeterminada pero que se debe implementar en cualquier tipo que implemente la
interfaz:

C#

public interface INamed

public string Name {get; set;}

Una interfaz puede heredar de una o varias interfaces base. Cuando una interfaz invalida
un método implementado en una interfaz base, debe usar la sintaxis de implementación
de interfaz explícita.

Cuando una lista de tipos base contiene una clase e interfaces base, la clase base debe
aparecer primero en la lista.

Una clase que implementa una interfaz puede implementar explícitamente miembros de
esa interfaz. A un miembro implementado explícitamente solo se puede tener acceso
mediante una instancia de la interfaz, y no mediante una instancia de la clase. Además,
solo se puede acceder a los miembros de interfaz predeterminados a través de una
instancia de la interfaz.

Para obtener más información sobre la implementación de interfaz explícita, vea

Implementación de interfaz explícita.

Implementación de interfaz de ejemplo

En el ejemplo siguiente se muestra la implementación de una interfaz. En este ejemplo,
la interfaz contiene la declaración de propiedad y la clase contiene la implementación.
Cualquier instancia de una clase que implemente IPoint tiene las propiedades de
entero x e y .

C#

interface IPoint

// Property signatures:

int X { get; set; }

int Y { get; set; }

double Distance { get; }

class Point : IPoint

// Constructor:

public Point(int x, int y)

X = x;

Y = y;

// Property implementation:

public int X { get; set; }

public int Y { get; set; }

 // Property implementation

public double Distance =>

Math.Sqrt(X * X + Y * Y);

class MainClass

static void PrintPoint(IPoint p)

Console.WriteLine("x={0}, y={1}", p.X, p.Y);

static void Main()

IPoint p = new Point(2, 3);

Console.Write("My Point: ");

PrintPoint(p);

// Output: My Point: x=2, y=3

Especificación del lenguaje C#

Para más información, consulte la sección Interfaces de la especificación del lenguaje
C#, la especificación de características para C# 8: miembros de interfaz predeterminados
y la especificación de características para C# 11: miembros abstractos estáticos en
interfaces.

Vea también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Tipos de referencia
Interfaces
Utilizar propiedades
Utilizar indizadores
Tipos de referencia que aceptan valores
NULL (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 7 minutos

７ Nota

En este artículo se tratan los tipos de referencia que aceptan valores NULL. También
puede declarar tipos de valor que aceptan valores NULL.

Los tipos de referencia que admiten valores NULL están disponibles en un código que
ha participado en un contexto compatible con los valores NULL. Los tipos de referencia
que aceptan valores NULL, las advertencias de análisis estático NULL y el operador null-
forgiving son características de lenguaje opcionales. Todas están desactivadas de forma
predeterminada. Un contexto que admite valores NULL se controla en el nivel de
proyecto mediante la configuración de compilación o en el código que usa pragmas.

） Importante

Todas las plantillas de proyecto a partir de .NET 6 (C# 10) habilitan el contexto que
admite valores NULL para el proyecto. Los proyectos creados con plantillas
anteriores no incluyen este elemento y estas características están desactivadas a
menos que las habilite en el archivo del proyecto o use pragmas.

En un contexto compatible con valores NULL:

Una variable de un tipo de referencia T se debe inicializar con un valor distinto de

NULL y nunca puede tener asignado un valor que sea  null .
Una variable de un tipo de referencia T? se puede inicializar con null o
asignarle  null , pero debe comprobarse con null antes de desreferenciarla.
Una variable  m de tipo  T? se considera que no es NULL cuando se aplica el
operador null-forgiving, como en  m! .

Las distinciones entre un tipo de referencia que no acepta valores NULL T y un tipo de
referencia que acepta valores NULL T? se aplican mediante la interpretación del
compilador de las reglas anteriores. Una variable de tipo  T y una variable de tipo  T? se
representan mediante el mismo tipo .NET. En el ejemplo siguiente se declara una
cadena que no acepta valores NULL y una cadena que acepta valores NULL y luego se
usa el operador null-forgiving para asignar un valor a una cadena que no acepta valores
NULL:

C#

string notNull = "Hello";

string? nullable = default;

notNull = nullable!; // null forgiveness

Las variables  notNull y  nullable se ambas representan con el tipo String. Dado que los
tipos que no aceptan valores NULL y que aceptan valores NULL se almacenan como el
mismo tipo, hay varias ubicaciones en las que no se permite el uso de un tipo de
referencia que acepte valores NULL. En general, un tipo de referencia que acepta valores
NULL no se puede usar como clase base o interfaz implementada. No se puede usar un
tipo de referencia que acepte valores NULL en ninguna expresión de creación de
objetos o de expresión de prueba de tipos. Un tipo de referencia que acepta valores
NULL no puede ser el tipo de una expresión de acceso a miembros. En los siguientes
ejemplos se muestran estas construcciones:

C#

public MyClass : System.Object? // not allowed

var nullEmpty = System.String?.Empty; // Not allowed

var maybeObject = new object?(); // Not allowed

try

if (thing is string? nullableString) // not allowed

Console.WriteLine(nullableString);

} catch (Exception? e) // Not Allowed

Console.WriteLine("error");

Referencias que aceptan valores NULL y análisis

estático
Los ejemplos de la sección anterior muestran la naturaleza de los tipos de referencia
que aceptan valores NULL. Los tipos de referencia que aceptan valores NULL no son
nuevos tipos de clase, sino anotaciones en tipos de referencia existentes. El compilador
utiliza esas anotaciones para ayudarle a encontrar posibles errores de referencia nula en
el código. No hay ninguna diferencia en tiempo de ejecución entre un tipo de referencia
que no acepta valores NULL y un tipo de referencia que acepta valores NULL. El
compilador no agrega ninguna comprobación de tiempo de ejecución para los tipos de
referencia que no aceptan valores NULL. Las ventajas radican en el análisis en tiempo de
compilación. El compilador genera advertencias que le ayudan a encontrar y corregir
posibles errores nulos en el código. Declare su intención y el compilador le advierte
cuando el código infringe dicha intención.

En un contexto habilitado para valores NULL, el compilador realiza un análisis estático

de las variables de cualquier tipo de referencia, tanto si admiten valores NULL como si
no aceptan valores NULL. El compilador realiza un seguimiento del estado null-state de
cada variable de referencia como not-null o maybe-null. El estado predeterminado de
una referencia que no acepta valores NULL es not-null. El estado predeterminado de
una referencia que acepta valores NULL es maybe-null.

Los tipos de referencia que no aceptan valores NULL siempre deben ser seguros para
desreferenciar porque su estado null-state es not-null. Para aplicar esa regla, el
compilador emite advertencias si un tipo de referencia que no acepta valores NULL no
se inicializa en un valor no NULL. Las variables locales deben asignarse allí donde se
declaran. A cada campo se le debe asignar un valor not-null en un inicializador de
campo o en cada constructor. El compilador emite advertencias cuando una referencia
que no acepta valores NULL se asigna a una referencia cuyo estado es maybe-null. Por
lo general, una referencia que no acepta valores NULL es not-null y no se emite ninguna
advertencia cuando se desreferencian esas variables.

７ Nota

Si asigna una expresión maybe-null a un tipo de referencia que no admita valores

NULL, el compilador genera una advertencia. A continuación, el compilador genera
advertencias para esa variable hasta que se asigna a una expresión not-null.

Los tipos de referencia que aceptan valores NULL se pueden inicializar o asignar a  null .
Por lo tanto, el análisis estático debe determinar que una variable es not-null antes de
desreferenciarla. Si se determina que una referencia que acepta valores NULL es maybe-
null, la asignación a una variable de referencia que no acepta valores NULL genera una
advertencia del compilador. La consulta siguiente muestra ejemplos de estas
advertencias:

C#

public class ProductDescription

private string shortDescription;

 private string? detailedDescription;

public ProductDescription() // Warning! shortDescription not

initialized.

public ProductDescription(string productDescription) =>

this.shortDescription = productDescription;

public void SetDescriptions(string productDescription, string?

details=null)

shortDescription = productDescription;

detailedDescription = details;

public string GetDescription()

if (detailedDescription.Length == 0) // Warning! dereference

possible null

return shortDescription;

else

return $"{shortDescription}\n{detailedDescription}";

public string FullDescription()

if (detailedDescription == null)

return shortDescription;

else if (detailedDescription.Length > 0) // OK, detailedDescription

can't be null.

return $"{shortDescription}\n{detailedDescription}";

return shortDescription;

En el fragmento de código siguiente se muestra dónde el compilador emite

advertencias al utilizar esta clase:

C#

string shortDescription = default; // Warning! non-nullable set to null;

var product = new ProductDescription(shortDescription); // Warning! static

analysis knows shortDescription maybe null.

 string description = "widget";

var item = new ProductDescription(description);

item.SetDescriptions(description, "These widgets will do everything.");

En los ejemplos anteriores se muestra cómo el análisis estático del compilador

determina el estado null-state de las variables de referencia. El compilador aplica las
reglas de lenguaje a las asignaciones y comprobaciones de valores NULL para informar
de su análisis. El compilador no puede hacer suposiciones sobre la semántica de
métodos o propiedades. Si llama a métodos que realizan comprobaciones de valores
NULL, el compilador no puede saber que estos métodos afectan al estado null-state de
una variable. Hay atributos que puede agregar a las API para informar al compilador
sobre la semántica de los argumentos y los valores devueltos. Estos atributos se han
aplicado a muchas API comunes de las bibliotecas de .NET Core. Por ejemplo,
IsNullOrEmpty se ha actualizado y el compilador interpreta correctamente ese método
como una comprobación de valores NULL. Para obtener más información sobre los
atributos que se aplican al análisis estático de estado null-state, consulte el artículo
sobre Atributos que aceptan valores NULL.

Establecimiento del contexto que acepta

valores NULL
Hay dos formas de controlar el contexto que acepta valores NULL. En el nivel de
proyecto, puede agregar la configuración del proyecto  <Nullable>enable</Nullable> . En
un archivo C# de código fuente único, puede agregar el pragma  #nullable enable para
habilitar el contexto que acepta valores NULL. Consulte el artículo sobre cómo
establecer una estrategia que acepte valores NULL. Antes de .NET 6, los nuevos
proyectos usan el elemento predeterminado <Nullable>disable</Nullable> . A partir de
.NET 6, los proyectos nuevos incluyen el elemento <Nullable>enable</Nullable> en el
archivo del proyecto.

Especificación del lenguaje C#

Para más información, consulte las propuestas siguientes de la especificación del
lenguaje C#:

Tipos de referencia que aceptan valores null

Borrador de especificación de tipos de referencia que aceptan valores NULL
Vea también
Referencia de C#
Tipos de valores que aceptan valores NULL
void (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Use void como el tipo de valor devuelto de un método (o una función local) para
especificar que el método no devuelve un valor.

C#

public static void Display(IEnumerable<int> numbers)

if (numbers is null)

return;

Console.WriteLine(string.Join(" ", numbers));

También puede usar void como un tipo de referente para declarar un puntero a un tipo
desconocido. Para obtener más información, vea Tipos de puntero.

No se puede usar void como el tipo de una variable.

Vea también
Referencia de C#
System.Void
Instrucciones de declaración
Artículo • 18/02/2023 • Tiempo de lectura: 8 minutos

Una instrucción de declaración declara una nueva variable y, opcionalmente, la inicializa.

Todas las variables tienen un tipo declarado. Puede obtener más información sobre los
tipos en el artículo sobre el sistema de tipos de .NET. Normalmente, una declaración
incluye un tipo y un nombre de variable. También puede incluir una inicialización: el
operador = seguido de una expresión. El tipo se puede reemplazar por var . La
declaración o la expresión pueden incluir el modificador ref para declarar que la nueva
variable hace referencia a una ubicación de almacenamiento existente.

Variables locales con tipo implícito

Las variables que se declaran en el ámbito de método pueden tener un "tipo" var
implícito. Una variable local con un tipo implícito está fuertemente tipada, igual que si
usted hubiera declarado el tipo, pero es el compilador el que lo determina. Las dos
declaraciones siguientes de a y b tienen una funcionalidad equivalente:

C#

var a = 10; // Implicitly typed.

int b = 10; // Explicitly typed.

） Importante

Cuando var se usa con tipos de referencia que aceptan valores NULL, siempre
implica un tipo de referencia que acepta valores NULL, aunque el tipo de expresión
no los acepte. El análisis de null-state del compilador protege frente a la
desreferenciación de un posible valor null . Si la variable nunca se asigna a una
expresión que pueda ser NULL, el compilador no emitirá ninguna advertencia. Si
asigna la variable a una expresión que podría ser NULL, debe probar que no sea
NULL antes de desreferenciarla para evitar advertencias.

Un uso común de la palabra clave var es con las expresiones de invocación del
constructor. El uso de var permite no repetir un nombre de tipo en una declaración de
variable y una creación de instancias de objeto, como se muestra en el ejemplo
siguiente:

C#
 var xs = new List<int>();

A partir de C# 9.0, se puede usar una expresión new de con tipo de destino como
alternativa:

C#

List<int> xs = new();

List<int>? ys = new();

En la coincidencia de patrones, la palabra clave var se usa en un patrón var.

En el siguiente ejemplo se muestran dos expresiones de consulta. En la primera

expresión, se permite el uso de var pero no es necesario, ya que el tipo del resultado
de la consulta se puede indicar explícitamente como IEnumerable<string> . En cambio,
en la segunda expresión, var permite que el resultado sea una colección de tipos
anónimos y solo el compilador puede tener acceso al nombre de ese tipo. El uso de var
elimina la necesidad de crear una nueva clase para el resultado. En el segundo ejemplo,
la variable item de la iteración foreach también debe tener un tipo implícito.

C#

// Example #1: var is optional when

// the select clause specifies a string

string[] words = { "apple", "strawberry", "grape", "peach", "banana" };

var wordQuery = from word in words

where word[0] == 'g'

select word;

// Because each element in the sequence is a string,

// not an anonymous type, var is optional here also.

foreach (string s in wordQuery)

Console.WriteLine(s);

// Example #2: var is required because

// the select clause specifies an anonymous type

var custQuery = from cust in customers

where cust.City == "Phoenix"

select new { cust.Name, cust.Phone };

// var must be used because each item

// in the sequence is an anonymous type

foreach (var item in custQuery)

Console.WriteLine("Name={0}, Phone={1}", item.Name, item.Phone);

Variables locales de tipo ref

Agregue la palabra clave ref antes del tipo de una variable para declarar una variable
local ref . Una variable local ref es una variable que hace referencia a otro
almacenamiento. Suponga que el método GetContactInformation se declara como un
valor devuelto por referencia:

C#

public ref Person GetContactInformation(string fname, string lname)

Vamos a contrastar estas dos asignaciones:

C#

Person p = contacts.GetContactInformation("Brandie", "Best");

ref Person p2 = ref contacts.GetContactInformation("Brandie", "Best");

La variable p contiene una copia del valor devuelto de GetContactInformation . Es una

ubicación de almacenamiento independiente de la variante ref devuelta desde
GetContactInformation . Si cambia cualquier propiedad de p , cambiará una copia de
Person .

La variable p2 hace referencia a la ubicación de almacenamiento para la variable ref

devuelta desde GetContactInformation . Es el mismo almacenamiento que la variante
ref devuelta desde GetContactInformation . Si cambia cualquier propiedad de p2 ,

cambiará esa instancia única de Person .

Puede acceder a un valor por referencia de la misma manera. En algunos casos, acceder
a un valor por referencia aumenta el rendimiento, ya que evita una operación de copia
potencialmente cara. Por ejemplo, en la instrucción siguiente se muestra cómo es
posible definir un valor local de referencia que se usa para hacer referencia a un valor.

C#

ref VeryLargeStruct reflocal = ref veryLargeStruct;

La palabra clave ref se usa antes de la declaración de variable local y antes del valor en
el segundo ejemplo. Si no se incluyen ambas palabras clave ref en la asignación y
declaración de la variable en ambos ejemplos, se produce el error del
compilador CS8172, "No se puede inicializar una variable por referencia con un valor".

C#

ref VeryLargeStruct reflocal = ref veryLargeStruct; // initialization

refLocal = ref anotherVeryLargeStruct; // reassigned, refLocal refers to

different storage.

Las variables locales ref todavía deben inicializarse cuando se declaran.

En el ejemplo siguiente, se define una clase NumberStore que almacena una matriz de
valores enteros. El método FindNumber devuelve por referencia el primer número que es
mayor o igual que el número que se pasa como argumento. Si ningún número es mayor
o igual que el argumento, el método devuelve el número en el índice 0.

C#

using System;

class NumberStore

int[] numbers = { 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023 };

public ref int FindNumber(int target)

for (int ctr = 0; ctr < numbers.Length; ctr++)

if (numbers[ctr] >= target)

return ref numbers[ctr];

return ref numbers[0];

public override string ToString() => string.Join(" ", numbers);

En el ejemplo siguiente, se llama al método NumberStore.FindNumber para recuperar el

primer valor que es mayor o igual que 16. Después, el autor de la llamada duplica el
valor devuelto por el método. En el resultado del ejemplo se muestra el cambio
reflejado en el valor de los elementos de matriz de la instancia NumberStore .

C#

var store = new NumberStore();

Console.WriteLine($"Original sequence: {store.ToString()}");

int number = 16;

ref var value = ref store.FindNumber(number);

 value *= 2;

Console.WriteLine($"New sequence: {store.ToString()}");

// The example displays the following output:

// Original sequence: 1 3 7 15 31 63 127 255 511 1023

// New sequence: 1 3 7 15 62 63 127 255 511 1023

Sin que se admitan los valores devueltos de referencia, este tipo de operación se realiza
al devolver el índice del elemento de matriz junto con su valor. Después, el autor de la
llamada puede usar este índice para modificar el valor en una llamada al método
independiente. En cambio, el autor de la llamada también puede modificar el índice
para tener acceso a otros valores de matriz y, posiblemente, modificarlos.

El siguiente ejemplo muestra cómo se podría reescribir el método FindNumber para usar
la reasignación de variable local ref:

C#

using System;

class NumberStore

int[] numbers = { 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023 };

public ref int FindNumber(int target)

ref int returnVal = ref numbers[0];

var ctr = numbers.Length - 1;

while ((ctr >= 0) && (numbers[ctr] >= target))

returnVal = ref numbers[ctr];

ctr--;

return ref returnVal;

public override string ToString() => string.Join(" ", numbers);

Esta segunda versión es más eficaz con secuencias más largas en escenarios donde el
número buscado está más cerca del final de la matriz, ya que en la matriz se itera desde
el final hacia el principio, lo que hace que se examinen menos elementos.

El compilador aplica reglas de ámbito en variables ref : variables locales ref ,

parámetros ref y campos ref en tipos ref struct . Las reglas garantizan que una
referencia no sobreviva al objeto al que hace referencia. Consulte la sección sobre las
reglas de ámbito del artículo sobre los parámetros de método.
ref y readonly
El modificador readonly se puede aplicar a variables locales ref y campos ref . El
modificador readonly afecta a la expresión de la derecha. Vea las siguientes
declaraciones de ejemplo:

C#

ref readonly int aConstant; // aConstant can't be value-reassigned.

readonly ref int Storage; // Storage can't be ref-reassigned.

readonly ref readonly int CantChange; // CantChange can't be value-

reassigned or ref-reassigned.

Reasignación de valor significa que se reasigna el valor de la variable.

Asignación de referencia significa que la variable ahora hace referencia a un objeto
diferente.

Las declaraciones readonly ref y readonly ref readonly solo son válidas en campos
ref de ref struct .

Referencia con ámbito

La palabra clave contextual scoped restringe la duración de un valor. El modificador
scoped restringe la duración ref-safe-to-escape o safe-to-escape, respectivamente, al
método actual. De hecho, al agregar el modificador scoped se afirma que el código no
extenderá la duración de la variable.

Puede aplicar scoped a un parámetro o variable local. El modificador scoped se puede

aplicar a parámetros y variables locales cuando el tipo es ref struct. De lo contrario, el
modificador scoped solo se puede aplicar a las variables locales que son de tipos ref.
Esto incluye las variables locales declaradas con el modificador ref y los parámetros
declarados con los modificadores in , ref o out .

El modificador scoped se agrega implícitamente a this en los métodos declarados en

struct y en parámetros out y ref cuando el tipo es ref struct .

Vea también
ref (palabra clave)
Cómo evitar asignaciones
Preferencias "var" (reglas de estilo IDE0007 e IDE0008)
Referencia de C#
Relaciones entre tipos en las operaciones de consulta LINQ
C# 11: modificador con ámbito
Tipos integrados (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En la siguiente tabla se muestran los tipos de valor de C#:

Palabra clave de tipo de C# Tipo de .NET

bool System.Boolean

byte System.Byte

sbyte System.SByte

char System.Char

decimal System.Decimal

double System.Double

float System.Single

int System.Int32

uint System.UInt32

nint System.IntPtr

nuint System.UIntPtr

long System.Int64

ulong System.UInt64

short System.Int16

ushort System.UInt16

En la siguiente tabla se muestran los tipos de referencia integrados de C#:

Palabra clave de tipo de C# Tipo de .NET

object System.Object

string System.String

dynamic System.Object

En las tablas anteriores, cada palabra clave de tipo de C# de la columna izquierda

(excepto dynamic) es un alias del tipo de .NET correspondiente. Son intercambiables.
Por ejemplo, en las declaraciones siguientes se declaran variables del mismo tipo:

C#

int a = 123;

System.Int32 b = 123;

La palabra clave void representa la ausencia de un tipo. Se usa como el tipo de valor
devuelto de un método que no devuelve un valor.

Vea también
Uso de palabras clave de lenguaje en lugar de nombres de tipo de marco (regla de
estilo IDE0049)
Referencia de C#
Valores predeterminados de los tipos de C#
Tipos no administrados (referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Un tipo es un tipo no administrado si es cualquiera de los siguientes tipos:

sbyte , byte , short , ushort , int , uint , long , ulong , char , float , double , decimal

o bool
Cualquier tipo enum.
Cualquier tipo pointer.
Cualquier tipo struct definido por el usuario que solo contenga campos de tipos
no administrados.

Puede usar unmanagedconstraint para especificar que un parámetro de tipo es un tipo

no administrado que no acepta valores NULL y que no es de puntero.

Un tipo de struct construido que solo contenga campos de tipos no administrados

también es no administrado, como se muestra en el ejemplo siguiente:

C#

using System;

public struct Coords<T>

{

public T X;

public T Y;

public class UnmanagedTypes

public static void Main()

DisplaySize<Coords<int>>();

DisplaySize<Coords<double>>();

private unsafe static void DisplaySize<T>() where T : unmanaged

Console.WriteLine($"{typeof(T)} is unmanaged and its size is

{sizeof(T)} bytes");

// Output:

// Coords`1[System.Int32] is unmanaged and its size is 8 bytes

// Coords`1[System.Double] is unmanaged and its size is 16 bytes

Un struct genérico puede ser el origen de los tipos no administrados y de los tipos
construidos administrados. En el ejemplo anterior se define un struct Coords<T>
genérico y se presentan los ejemplos de tipos construidos no administrados. El ejemplo
de un tipo administrado es Coords<object> . Es administrado porque tiene los campos
del tipo object , que está administrado. Si desea que todos los tipos construidos sean
tipos no administrados, use la restricción unmanaged en la definición de un struct
genérico:

C#

public struct Coords<T> where T : unmanaged

public T X;

public T Y;

Especificación del lenguaje C#

Para obtener más información, vea la sección Tipos de puntero de Especificación del
lenguaje C#.

Vea también
Referencia de C#
Tipos de puntero
Tipos relacionados con el intervalo y la memoria
sizeof (operador)
stackalloc
Valores predeterminados de los tipos de
C# (referencia de C#)
Artículo • 22/02/2023 • Tiempo de lectura: 2 minutos

En la tabla siguiente se muestran los valores predeterminados de los tipos de C#:

Tipo Valor predeterminado

Cualquier tipo de null

referencia

Cualquier tipo 0 (cero)

numérico entero
integrado

Cualquier tipo 0 (cero)

numérico de
punto flotante
integrado

bool false

char '\0' (U+0000)

enum Valor generado por la expresión (E)0 , donde E es el identificador de

enumeración.

struct El valor generado al establecer todos los campos de tipo de valor en sus
valores predeterminados y todos los campos de tipo de referencia en null .

Cualquier tipo de Instancia para la que la propiedad HasValue es false y la propiedad Value
valor que acepta no está definida. Este valor predeterminado también se conoce con el valor
valores NULL null de un tipo de valor que acepta valores NULL.

Expresiones de valor predeterminado

Use el operador default para producir el valor predeterminado de un tipo, como se
muestra en el ejemplo siguiente:

C#

int a = default(int);

Puede usar el literaldefault para inicializar una variable con el valor predeterminado de
su tipo:

C#

int a = default;

Constructor sin parámetros de un tipo de valor

Para un tipo de valor, el constructor sin parámetros implícito también genera el valor
predeterminado del tipo, como se muestra en el ejemplo siguiente:

C#

var n = new System.Numerics.Complex();

Console.WriteLine(n); // output: (0, 0)

En tiempo de ejecución, si la instancia de System.Type representa un tipo de valor,

puede usar el método Activator.CreateInstance(Type) para invocar el constructor sin
parámetros y obtener el valor predeterminado del tipo.

７ Nota

En C# 10 y versiones posteriores, un tipo de estructura (que es un tipo de valor)

puede tener un constructor sin parámetros explícito que puede generar un valor
no predeterminado del tipo. Por tanto, se recomienda usar el operador default o
el literal default para generar el valor predeterminado de un tipo.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Valores predeterminados
Constructores predeterminados
C# 10: constructores de structs sin parámetros
C# 11: structs predeterminados automáticos

Vea también
Referencia de C#
Constructores
Palabras clave de C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las palabras clave son identificadores reservados predefinidos que tienen un significado
especial para el compilador. No podrá utilizarlos como identificadores en el programa a
no ser que incluyan @ como prefijo. Por ejemplo, @if es un identificador válido, pero
if no lo es, porque if es una palabra clave.

En la primera tabla de este tema se muestran las palabras clave que son identificadores
reservados en cualquier parte de un programa en C#. En la segunda tabla de este tema
se enumeran las palabras clave contextuales en C#. Las palabras clave contextuales
tienen un significado especial solo en un contexto de programa limitado y pueden
utilizarse como identificadores fuera de ese contexto. Por lo general, cuando se agregan
nuevas palabras clave al lenguaje C#, se agregan como palabras clave contextuales para
evitar la interrupción de los programas escritos en versiones anteriores.

abstract

as

base

bool

break

byte

case

catch

char

checked

class

const

continue

decimal

default

delegate

do

double

else

enum

event

explicit

extern

false

finally

fixed

float

for

foreach

goto

if

implicit

in

int

interface

internal

is

lock

long

namespace

new

null

object

operator

out

override

params

private

protected

public
readonly

ref

return

sbyte

sealed

short

sizeof

stackalloc

static

string

struct

switch

this

throw

true

try

typeof

uint

ulong

unchecked

unsafe

ushort

using

virtual

void

volatile

while

Palabras clave contextuales

Las palabras clave contextuales se usan para proporcionar un significado específico en el
código, pero no son una palabra reservada en C#. Algunas palabras clave contextuales,
como partial y where , tienen significados especiales en dos o más contextos.

add

and

alias

ascending

args

async

await

by

descending

dynamic

equals

from

get

global

group

init

into

join

let

managed (convención de llamada de puntero de función)

nameof

nint

not

notnull

nuint

on

or

orderby

partial (tipo)

partial (método)

record

remove

select

set

unmanaged (convención de llamada de puntero de función)

unmanaged (restricción de tipo genérico)

value

var

when (condición de filtro)

where (restricción de tipo genérico)

where (cláusula de consulta)

con

yield

Vea también
Referencia de C#
Modificadores de acceso (Referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los modificadores de acceso son palabras clave que se usan para especificar la
accesibilidad declarada de un miembro o un tipo. En esta sección se presentan los cinco
modificadores de acceso:

public
protected

internal
private

file

Pueden especificarse los siguientes siete niveles de accesibilidad con los modificadores
de acceso:

public: el acceso no está restringido.

protected: el acceso está limitado a la clase contenedora o a los tipos derivados de
la clase contenedora.
internal: el acceso está limitado al ensamblado actual.
protected internal: El acceso está limitado al ensamblado actual o a los tipos
derivados de la clase contenedora.
private: el acceso está limitado al tipo contenedor.
private protected: El acceso está limitado a la clase contenedora o a los tipos
derivados de la clase contenedora que hay en el ensamblado actual.
file: el tipo declarado solo es visible en el archivo de origen actual. Los tipos con
ámbito de archivo se usan generalmente para los generadores de origen.

En esta sección también se presentan los conceptos siguientes:

Niveles de accesibilidad: usar los cuatro modificadores de acceso para declarar seis
niveles de accesibilidad.
Dominio de accesibilidad: especifica en qué secciones del programa se puede
hacer referencia a dicho miembro.
Restricciones en el uso de niveles de accesibilidad: un resumen de las restricciones
sobre usar niveles de accesibilidad declarados.

Vea también
Adición de modificadores de accesibilidad (regla de estilo IDE0040)
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Palabras clave de acceso
Modificadores
Niveles de accesibilidad (Referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Use los modificadores de acceso public , protected , internal o private para

especificar uno de los siguientes niveles de accesibilidad declarada para miembros.

Accesibilidad Significado
declarada

public El acceso no está restringido.

protected El acceso está limitado a la clase contenedora o a los tipos derivados de la clase
contenedora.

internal El acceso está limitado al ensamblado actual.

protected El acceso está limitado al ensamblado actual o a los tipos derivados de la clase
internal contenedora.

private El acceso está limitado al tipo contenedor.

private El acceso está limitado a la clase contenedora o a los tipos derivados de la clase
protected contenedora que hay en el ensamblado actual.

Solo se permite un modificador de acceso para un miembro o tipo, excepto cuando se

usan las combinaciones protected internal o private protected .

No se permiten modificadores de acceso en espacios de nombres. Los espacios de

nombres no tienen restricciones de acceso.

En función del contexto en el que se produce una declaración de miembro, solo se

permiten ciertas accesibilidades declaradas. Si no se especifica ningún modificador de
acceso en una declaración de miembro, se usa una accesibilidad predeterminada.

Los tipos de nivel superior, que no están anidados en otros tipos, solo pueden tener una
accesibilidad internal o public . La accesibilidad predeterminada para estos tipos es
internal .

Los tipos anidados, que son miembros de otros tipos, pueden tener accesibilidades
declaradas como se indica en la tabla siguiente.

Miembros Accesibilidad de miembro Accesibilidad declarada permitida del

de predeterminada miembro
 Miembros Accesibilidad de miembro Accesibilidad declarada permitida del
de predeterminada miembro

enum public Ninguna

class private public

protected

internal

private

protected internal

private protected

interface public public

protected

internal

private *

protected internal

private protected

struct private public

internal

private

* Un miembro interface con accesibilidad private debe tener una implementación

predeterminada.

La accesibilidad de un tipo anidado depende de su dominio de accesibilidad, que viene

determinado por la accesibilidad declarada del miembro y el dominio de accesibilidad
del tipo contenedor inmediato. Sin embargo, el dominio de accesibilidad de un tipo
anidado no puede superar al del tipo contenedor.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Dominio de accesibilidad
Restricciones en el uso de los niveles de accesibilidad
Modificadores de acceso
public
private
protected
internal
Dominio de accesibilidad (Referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El dominio de accesibilidad de un miembro especifica en qué secciones del programa se

puede hacer referencia a dicho miembro. Si el miembro está anidado dentro de otro
tipo, su dominio de accesibilidad viene determinado por el nivel de accesibilidad del
miembro y por el dominio de accesibilidad del tipo contenedor inmediato.

El dominio de accesibilidad de un tipo de nivel superior es por lo menos el texto del

programa del proyecto en el que se declara. Es decir, el dominio incluye todos los
archivos de origen de este proyecto. El dominio de accesibilidad de un tipo anidado es,
al menos, el texto del programa del tipo en el que se declara. Es decir, el dominio es el
cuerpo del tipo, que incluye todos los tipos anidados. El dominio de accesibilidad de un
tipo anidado no puede superar nunca al del tipo contenedor. Estos conceptos se
muestran en el siguiente ejemplo.

Ejemplo
Este ejemplo contiene un tipo de nivel superior, T1 , y dos clases anidadas, M1 y M2 . Las
clases contienen campos que tienen diferentes accesibilidades declaradas. En el método
Main , a cada instrucción le sigue un comentario que indica el dominio de accesibilidad

de cada miembro. Observe que las instrucciones que intentan hacer referencia a los
miembros inaccesibles están marcadas con comentarios. Si quiere ver los errores
generados por el compilador cuando se intenta hacer referencia a un miembro
inaccesible, quite los comentarios de uno en uno.

C#

public class T1

public static int publicInt;

internal static int internalInt;

private static int privateInt = 0;

static T1()

// T1 can access public or internal members

// in a public or private (or internal) nested class.

M1.publicInt = 1;

M1.internalInt = 2;

M2.publicInt = 3;

M2.internalInt = 4;

 // Cannot access the private member privateInt

// in either class:

// M1.privateInt = 2; //CS0122

public class M1

public static int publicInt;

internal static int internalInt;

private static int privateInt = 0;

private class M2

public static int publicInt = 0;

internal static int internalInt = 0;

private static int privateInt = 0;

class MainClass

static void Main()

// Access is unlimited.

T1.publicInt = 1;

// Accessible only in current assembly.

T1.internalInt = 2;

// Error CS0122: inaccessible outside T1.

// T1.privateInt = 3;

// Access is unlimited.

T1.M1.publicInt = 1;

// Accessible only in current assembly.

T1.M1.internalInt = 2;

// Error CS0122: inaccessible outside M1.

// T1.M1.privateInt = 3;

// Error CS0122: inaccessible outside T1.

// T1.M2.publicInt = 1;

// Error CS0122: inaccessible outside T1.

// T1.M2.internalInt = 2;

// Error CS0122: inaccessible outside M2.

// T1.M2.privateInt = 3;

// Keep the console open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
 }

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Restricciones en el uso de los niveles de accesibilidad
Modificadores de acceso
public
private
protected
internal
Restricciones en el uso de los niveles de
accesibilidad (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Cuando especifique un tipo en una declaración, compruebe si el nivel de accesibilidad

de este depende del nivel de accesibilidad de un miembro o de otro tipo. Por ejemplo,
la clase base directa debe ser al menos igual de accesible que la clase derivada. Las
siguientes declaraciones producen un error del compilador porque la clase base
BaseClass es menos accesible que MyClass :

C#

class BaseClass {...}

public class MyClass: BaseClass {...} // Error

En la tabla siguiente se resumen las restricciones en los niveles de accesibilidad

declarados.

Context Comentarios

Clases La clase base directa de un tipo de clase debe ser al menos igual de accesible que
el propio tipo de clase.

Interfaces Las interfaces base explícitas de un tipo de interfaz deben ser al menos igual de
accesibles que el propio tipo de interfaz.

Delegados El tipo de valor devuelto y los tipos de parámetros de un tipo de delegado deben
ser al menos igual de accesibles que el propio tipo de delegado.

Constantes El tipo de una constante debe ser al menos igual de accesible que la propia
constante.

Fields El tipo de un campo debe ser al menos igual de accesible que el propio campo.

Métodos El tipo de valor devuelto y los tipos de parámetros de un método deben ser al
menos igual de accesibles que el propio método.

Propiedades El tipo de una propiedad debe ser al menos igual de accesible que la misma
propiedad.

Eventos El tipo de un evento debe ser al menos igual de accesible que el propio evento.

Indizadores Los tipos de parámetro y el tipo de un indexador deben ser al menos igual de
accesibles que el propio indexador.
 Context Comentarios

Operadores El tipo de valor devuelto y los tipos de parámetro de un operador deben ser al
menos igual de accesibles que el propio operador.

Constructores Los tipos de parámetro de un constructor deben ser al menos igual de accesibles
que el propio constructor.

Ejemplo
El siguiente ejemplo contiene declaraciones erróneas de diferentes tipos. El comentario
que sigue a cada declaración indica el error del compilador previsto.

C#

// Restrictions on Using Accessibility Levels

// CS0052 expected as well as CS0053, CS0056, and CS0057

// To make the program work, change access level of both class B

// and MyPrivateMethod() to public.

using System;

// A delegate:

delegate int MyDelegate();

class B

// A private method:

static int MyPrivateMethod()

return 0;

public class A

// Error: The type B is less accessible than the field A.myField.

public B myField = new B();

// Error: The type B is less accessible

// than the constant A.myConst.

public readonly B myConst = new B();

public B MyMethod()

// Error: The type B is less accessible

// than the method A.MyMethod.

return new B();

}

// Error: The type B is less accessible than the property A.MyProp

 public B MyProp

set

MyDelegate d = new MyDelegate(B.MyPrivateMethod);

// Even when B is declared public, you still get the error:

// "The parameter B.MyPrivateMethod is not accessible due to

// protection level."

public static B operator +(A m1, B m2)

// Error: The type B is less accessible

// than the operator A.operator +(A,B)

return new B();

}

static void Main()

Console.Write("Compiled successfully");

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Dominio de accesibilidad
Niveles de accesibilidad
Modificadores de acceso
public
private
protected
internal
internal (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave internal es un modificador de acceso para tipos y miembros de tipo.

Esta página trata sobre el modificador de acceso internal . La palabra clave

internal también forma parte del modificador de acceso protected internal.

Solo se puede tener acceso a los tipos internos o los miembros desde los archivos del
mismo ensamblado, como en este ejemplo:

C#

public class BaseClass

// Only accessible within the same assembly.

internal static int x = 0;

Para obtener una comparación de internal con los demás modificadores de acceso,
vea Niveles de accesibilidad y Modificadores de acceso.

Para más información sobre los ensamblados, consulte Ensamblados en .NET.

Un uso común del acceso interno se da en el desarrollo basado en componentes

porque permite que un grupo de componentes cooperen de manera privada sin estar
expuesto al resto del código de la aplicación. Por ejemplo, un marco para crear
interfaces gráficas de usuario podría proporcionar las clases Control y Form que
cooperan mediante miembros con acceso interno. Como estos miembros son internos,
no se exponen al código que usa el marco de trabajo.

Es un error hacer referencia a un tipo o miembro con acceso interno fuera del
ensamblado en el que se definió.

Ejemplo 1
Este ejemplo contiene dos archivos, Assembly1.cs y Assembly1_a.cs . El primer archivo
contiene una clase base interna, BaseClass . En el segundo archivo, un intento de crear
una instancia de BaseClass producirá un error.

C#
 // Assembly1.cs

// Compile with: /target:library

internal class BaseClass

public static int intM = 0;

C#

// Assembly1_a.cs

// Compile with: /reference:Assembly1.dll

class TestAccess

static void Main()

var myBase = new BaseClass(); // CS0122

Ejemplo 2
En este ejemplo, use los mismos archivos usados en el ejemplo 1 y cambie el nivel de
accesibilidad de BaseClass a public . Cambie también el nivel de accesibilidad del
miembro intM a internal . En este caso, se puede crear una instancia de la clase, pero
no se puede tener acceso al miembro interno.

C#

// Assembly2.cs

// Compile with: /target:library

public class BaseClass

internal static int intM = 0;

C#

// Assembly2_a.cs

// Compile with: /reference:Assembly2.dll

public class TestAccess

{

static void Main()

var myBase = new BaseClass(); // Ok.

BaseClass.intM = 444; // CS0117

Especificación del lenguaje C#

Para obtener más información, vea la sección Accesibilidad declarada de la
Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la
sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Modificadores
public
private
protected
private (Referencia de C#)
Artículo • 10/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave private es un modificador de acceso de miembro.

Esta página trata sobre el modificador de acceso private . La palabra clave private
también forma parte del modificador de acceso private protected.

El acceso privado es el nivel de acceso menos permisivo. Los miembros privados solo
son accesibles dentro del cuerpo de la clase o el struct en el que se declaran, como en
este ejemplo:

C#

class Employee

private int _i;

double _d; // private access by default

Los tipos anidados en el mismo cuerpo también pueden tener acceso a los miembros
privados.

Hacer referencia a un miembro privado fuera de la clase o el struct en el que se declara

es un error en tiempo de compilación.

Para obtener una comparación de private con los demás modificadores de acceso, vea
Niveles de accesibilidad y Modificadores de acceso.

Ejemplo
En este ejemplo, la clase Employee contiene dos miembros de datos privados, _name y
_salary . Como miembros privados, solo pueden tener acceso a ellos los métodos de

miembro. Los métodos públicos denominados GetName y Salary se agregan para

permitir un acceso controlado a los miembros privados. Se tiene acceso al miembro
_name a través de un método público, mientras que se tiene acceso al miembro _salary
a través de una propiedad pública de solo lectura. (Para obtener más información, vea
Propiedades).

C#
 class Employee2

private readonly string _name = "FirstName, LastName";

private readonly double _salary = 100.0;

public string GetName()

return _name;

public double Salary

get { return _salary; }

class PrivateTest

static void Main()

var e = new Employee2();

// The data members are inaccessible (private), so

// they can't be accessed like this:

// string n = e._name;
// double s = e._salary;

// '_name' is indirectly accessed via method:

string n = e.GetName();

// '_salary' is indirectly accessed via property

double s = e.Salary;

Especificación del lenguaje C#

Para obtener más información, vea la sección Accesibilidad declarada de la
Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la
sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Modificadores
public
protected
internal
protected (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave protected es un modificador de acceso de miembro.

７ Nota

Esta página trata sobre el modificador de acceso protected . La palabra clave

protected también forma parte de los modificadores de acceso protected internal

y private protected.

Un miembro protegido es accesible dentro de su clase y por parte de instancias de clase

derivadas.

Para obtener una comparación de protected con los demás modificadores de acceso,
vea Niveles de accesibilidad.

Ejemplo 1
Un miembro protegido de una clase base es accesible en una clase derivada únicamente
si el acceso se produce a través del tipo de clase derivada. Por ejemplo, vea el siguiente
segmento de código:

C#

class A

protected int x = 123;

class B : A

static void Main()

var a = new A();

var b = new B();

// Error CS1540, because x can only be accessed by

// classes derived from A.

// a.x = 10;

// OK, because this class derives from A.

b.x = 10;

La instrucción a.x = 10 genera un error porque se ha creado en el método estático

Main y no en una instancia de clase B.

Los miembros de estructura no se pueden proteger porque la estructura no puede

heredarse.

Ejemplo 2
En este ejemplo, la clase DerivedPoint se deriva de Point . Por lo tanto, puede acceder a
los miembros protegidos de la clase base directamente desde la clase derivada.

C#

class Point

protected int x;

protected int y;

class DerivedPoint: Point

static void Main()

var dpoint = new DerivedPoint();

// Direct access to protected members.

dpoint.x = 10;

dpoint.y = 15;

Console.WriteLine($"x = {dpoint.x}, y = {dpoint.y}");

// Output: x = 10, y = 15

Si cambia los niveles de acceso de x y y a private, el compilador genera los mensajes

de error:

'Point.y' is inaccessible due to its protection level.

'Point.x' is inaccessible due to its protection level.

Especificación del lenguaje C#

Para obtener más información, vea la sección Accesibilidad declarada de la
Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la
sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Modificadores
public
private
internal
Security concerns for internal virtual keywords (Problemas de seguridad de
palabras clave virtuales internas)
public (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave public es un modificador de acceso para tipos y miembros de tipo. El

acceso público es el nivel de acceso más permisivo. No hay ninguna restricción para el
acceso a miembros públicos, como en este ejemplo:

C#

class SampleClass

public int x; // No access restrictions.

Vea Modificadores de acceso y Niveles de accesibilidad para obtener más información.

Ejemplo
En el ejemplo siguiente, se declaran dos clases, PointTest y Program . Se obtiene acceso
a los miembros públicos x e y de PointTest directamente desde Program .

C#

class PointTest

public int x;

public int y;

class Program

static void Main()

var p = new PointTest();

// Direct access to public members.

p.x = 10;

p.y = 15;

Console.WriteLine($"x = {p.x}, y = {p.y}");

// Output: x = 10, y = 15

Si cambia el nivel de acceso public a private o protected, obtendrá el siguiente mensaje

de error:
'PointTest.y' no es accesible debido a su nivel de protección.

Especificación del lenguaje C#

Para obtener más información, vea la sección Accesibilidad declarada de la
Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la
sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Modificadores de acceso
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Modificadores
private
protected
internal
protected internal (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La combinación de palabras claves protected internal es un modificador de acceso de

miembro. Se puede obtener acceso a un miembro protected internal desde el
ensamblado actual o desde tipos que se deriven de la clase contenedora. Para obtener
una comparación de protected internal con los demás modificadores de acceso, vea
Niveles de accesibilidad.

Ejemplo
Se puede obtener acceso a un miembro protected internal de una clase base desde
cualquier tipo de ensamblado que lo contenga. También estará accesible en una clase
derivada ubicada en otro ensamblado, pero solo si el acceso se produce a través de una
variable del tipo de clase derivada. Por ejemplo, vea el siguiente segmento de código:

C#

// Assembly1.cs

// Compile with: /target:library

public class BaseClass

protected internal int myValue = 0;

class TestAccess

void Access()

var baseObject = new BaseClass();

baseObject.myValue = 5;

C#

// Assembly2.cs

// Compile with: /reference:Assembly1.dll

class DerivedClass : BaseClass

static void Main()

var baseObject = new BaseClass();

var derivedObject = new DerivedClass();

// Error CS1540, because myValue can only be accessed by

 // classes derived from BaseClass.

// baseObject.myValue = 10;

// OK, because this class derives from BaseClass.

derivedObject.myValue = 10;

Este ejemplo contiene dos archivos, Assembly1.cs y Assembly2.cs .

El primer archivo
contiene una clase base interna, BaseClass , y otra clase, TestAccess . BaseClass posee
un miembro protected internal ( myValue ), al que se obtiene acceso por medio del tipo
TestAccess .
En el segundo archivo, un intento de tener acceso a myValue a través de
una instancia de BaseClass generará un error, mientras que un acceso a este miembro a
través de una instancia de una clase derivada ( DerivedClass ) se realizará correctamente.

Los miembros de struct no pueden ser protected internal , porque los structs no se
heredan.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Modificadores
public
private
internal
Security concerns for internal virtual keywords (Problemas de seguridad de
palabras clave virtuales internas)
private protected (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La combinación de palabras claves private protected es un modificador de acceso de

miembro. Los miembros private protected están accesibles para los tipos que se deriven
de la clase contenedora, pero solo desde dentro del ensamblado correspondiente que
lo contenga. Para obtener una comparación de private protected con los demás
modificadores de acceso, vea Niveles de accesibilidad.

７ Nota

El modificador de acceso private protected es válido en C# versión 7.2 y versiones

posteriores.

Ejemplo
Se puede tener acceso a un miembro private protected de una clase base desde tipos
derivados en el ensamblado que lo contiene solo si el tipo estático de la variable es el
tipo de clase derivada. Por ejemplo, vea el siguiente segmento de código:

C#

public class BaseClass

private protected int myValue = 0;

public class DerivedClass1 : BaseClass

void Access()

var baseObject = new BaseClass();

// Error CS1540, because myValue can only be accessed by

// classes derived from BaseClass.

// baseObject.myValue = 5;

// OK, accessed through the current derived class instance

myValue = 5;

C#
 // Assembly2.cs

// Compile with: /reference:Assembly1.dll

class DerivedClass2 : BaseClass

void Access()

// Error CS0122, because myValue can only be

// accessed by types in Assembly1

// myValue = 10;

Este ejemplo contiene dos archivos, Assembly1.cs y Assembly2.cs .

El primer archivo
contiene una clase base pública, BaseClass , y un tipo derivado de ella, DerivedClass1 .
BaseClass posee un miembro private protected, myValue , al que DerivedClass1 intenta

tener acceso de dos maneras. El primer intento de acceso a myValue a través de una
instancia de BaseClass generará un error. En cambio, el intento de usarlo como un
miembro heredado en DerivedClass1 se realizará correctamente.

En el segundo archivo, un intento de tener acceso a myValue como un miembro

heredado de DerivedClass2 generará un error, ya que solo está accesible para los tipos
derivados en Assembly1.

Si Assembly1.cs contiene un elemento InternalsVisibleToAttribute que asigna un

nombre a Assembly2 , la clase derivada DerivedClass2 tendrá acceso a los miembros
private protected declarados en BaseClass . InternalsVisibleTo hace que los
miembros private protected sean visibles para las clases derivadas en otros
ensamblados.

Los miembros de struct no pueden ser private protected , porque los structs no se
heredan.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores de acceso
Niveles de accesibilidad
Modificadores
public
private
internal
Security concerns for internal virtual keywords (Problemas de seguridad de
palabras clave virtuales internas)
abstract (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

El modificador abstract indica que lo que se modifica carece de implementación o

tiene una implementación incompleta. El modificador abstract puede usarse con clases,
métodos, propiedades, indexadores y eventos. Use el modificador abstract en una
declaración de clase para indicar que una clase está diseñada como clase base de otras
clases, no para crear instancias por sí misma. Los miembros marcados como abstractos
deben implementarse con clases no abstractas derivadas de la clase abstracta.

Ejemplo 1
En este ejemplo, la clase Square debe proporcionar una implementación de GetArea
porque se deriva de Shape :

C#

abstract class Shape

public abstract int GetArea();

class Square : Shape

private int _side;

public Square(int n) => _side = n;

// GetArea method is required to avoid a compile-time error.

public override int GetArea() => _side * _side;

static void Main()

var sq = new Square(12);

Console.WriteLine($"Area of the square = {sq.GetArea()}");

// Output: Area of the square = 144

Las clases abstractas tienen las siguientes características:

No se pueden crear instancias de una clase abstracta.

Una clase abstracta puede contener descriptores de acceso y métodos abstractos.

 No es posible modificar una clase abstracta con el modificador sealed porque los
dos modificadores tienen significados opuestos. El modificador sealed impide que
una clase se herede y el modificador abstract requiere que una clase se herede.

Una clase no abstracta que derive de una clase abstracta debe incluir
implementaciones reales de todos los descriptores de acceso y métodos
abstractos heredados.

Use el modificador abstract en una declaración de método o de propiedad para indicar

que el método o la propiedad no contienen implementación.

Los métodos abstractos tienen las siguientes características:

Un método abstracto es, implícitamente, un método virtual.

Solo se permiten declaraciones de métodos abstractos en clases abstractas.

Dado que una declaración de método abstracto no proporciona una

implementación real, no hay ningún cuerpo de método; la declaración de método
finaliza simplemente con un punto y coma y no hay llaves ({ }) después de la firma.
Por ejemplo:

C#

public abstract void MyMethod();

La implementación la proporciona un método, override, que es miembro de una

clase no abstracta.

Es un error usar los modificadores static o virtual en una declaración de método

abstracto.

Las propiedades abstractas se comportan como métodos abstractos, salvo por las
diferencias en la sintaxis de declaración e invocación.

Es un error usar el modificador abstract en una propiedad estática.

Una propiedad abstracta heredada se puede invalidar en una clase derivada

incluyendo una declaración de propiedad que use el modificador override.

Para obtener más información sobre las clases abstractas, vea Clases y miembros de
clase abstractos y sellados (Guía de programación de C#).

Una clase abstracta debe proporcionar implementación para todos los miembros de
interfaz.
Una clase abstracta que implemente una interfaz podría asignar los métodos de interfaz
a métodos abstractos. Por ejemplo:

C#

interface I

void M();
}

abstract class C : I

public abstract void M();

Ejemplo 2
En este ejemplo, la clase DerivedClass se deriva de una clase abstracta BaseClass . La
clase abstracta contiene un método abstracto, AbstractMethod , y dos propiedades
abstractas, X y Y .

C#

// Abstract class

abstract class BaseClass

protected int _x = 100;

protected int _y = 150;

// Abstract method

public abstract void AbstractMethod();

// Abstract properties

public abstract int X { get; }

public abstract int Y { get; }

class DerivedClass : BaseClass

public override void AbstractMethod()

_x++;

_y++;

public override int X // overriding property

get

 return _x + 10;

public override int Y // overriding property

get

return _y + 10;

static void Main()

var o = new DerivedClass();

o.AbstractMethod();

Console.WriteLine($"x = {o.X}, y = {o.Y}");

// Output: x = 111, y = 161

En el ejemplo anterior, si intenta crear una instancia de la clase abstracta mediante una
instrucción como esta:

C#

BaseClass bc = new BaseClass(); // Error

Se mostrará un mensaje de error en el que se indica que el compilador no puede crear

una instancia de la clase abstracta "BaseClass".

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Modificadores
virtual
override
Palabras clave de C#
async (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

Use el modificador async para especificar que un método, una expresión lambda o un
método anónimo es asincrónico. Si usa este modificador en un método o una expresión,
se hace referencia al mismo como un método asincrónico. En el ejemplo siguiente se
define un método asincrónico denominado ExampleMethodAsync :

C#

public async Task<int> ExampleMethodAsync()

//...

Si no está familiarizado con la programación asincrónica o no entiende cómo un

método asincrónico usa el operador await para hacer el trabajo de larga duración sin
bloquear el subproceso del autor de la llamada, lea la introducción de Programación
asincrónica con async y await. El siguiente código se encuentra dentro de un método
asincrónico y llama al método HttpClient.GetStringAsync:

C#

string contents = await httpClient.GetStringAsync(requestUrl);

Un método asincrónico se ejecuta sincrónicamente hasta alcanzar la primera expresión

await , en la que se suspende el método hasta que se complete la tarea en espera.
Mientras tanto, el control vuelve al llamador del método, como se muestra en el
ejemplo de la sección siguiente.

Si el método que la palabra clave async modifica no contiene una expresión o

instrucción await , el método se ejecuta de forma sincrónica. Una advertencia del
compilador alerta de cualquier método asincrónico que no contenga instrucciones de
await , porque esa situación podría indicar un error. Vea Advertencia del compilador

(nivel 1) CS4014.

La palabra clave async es contextual en el sentido de que es una palabra clave cuando
modifica un método, una expresión lambda o un método anónimo. En todos los demás
contextos, se interpreta como identificador.

Ejemplo
En el ejemplo siguiente se muestra la estructura y el flujo de control entre un
controlador de eventos asincrónicos, StartButton_Click , y un método asincrónico,
ExampleMethodAsync . El resultado del método asincrónico es el número de caracteres de

una página web. El código es adecuado para una aplicación Windows Presentation
Foundation (WPF) o de la Tienda Windows creada en Visual Studio; vea los comentarios
del código para configurar la aplicación.

Puede ejecutar este código en Visual Studio como una aplicación Windows Presentation
Foundation (WPF) o una aplicación de la Tienda Windows. Necesita un control de botón
denominado StartButton y un control de cuadro de texto denominado ResultsTextBox .
Recuerde establecer los nombres y el controlador de manera que tenga algo similar a
esto:

XAML

<Button Content="Button" HorizontalAlignment="Left" Margin="88,77,0,0"

VerticalAlignment="Top" Width="75"

Click="StartButton_Click" Name="StartButton"/>

<TextBox HorizontalAlignment="Left" Height="137" Margin="88,140,0,0"

TextWrapping="Wrap"

Text="&lt;Enter a URL&gt;" VerticalAlignment="Top" Width="310"

Name="ResultsTextBox"/>

Para ejecutar el código como una aplicación WPF:

Pegue este código en la clase MainWindow en MainWindow.xaml.cs.

Agregue una referencia a System.Net.Http.
Agregue una directiva using a System.Net.Http.

Para ejecutar el código como una aplicación de la Tienda Windows:

Pegue este código en la clase MainPage en MainPage.xaml.cs.

Agregue directivas using para System.Net.Http y System.Threading.Tasks.

C#

private async void StartButton_Click(object sender, RoutedEventArgs e)

// ExampleMethodAsync returns a Task<int>, which means that the method

// eventually produces an int result. However, ExampleMethodAsync

returns

// the Task<int> value as soon as it reaches an await.

ResultsTextBox.Text += "\n";

try

int length = await ExampleMethodAsync();

 // Note that you could put "await ExampleMethodAsync()" in the next

line where

// "length" is, but due to when '+=' fetches the value of

ResultsTextBox, you

// would not see the global side effect of ExampleMethodAsync

setting the text.

ResultsTextBox.Text += String.Format("Length: {0:N0}\n", length);

catch (Exception)

// Process the exception if one occurs.

public async Task<int> ExampleMethodAsync()

var httpClient = new HttpClient();

int exampleInt = (await

httpClient.GetStringAsync("http://msdn.microsoft.com")).Length;

ResultsTextBox.Text += "Preparing to finish ExampleMethodAsync.\n";

// After the following return statement, any method that's awaiting

// ExampleMethodAsync (in this case, StartButton_Click) can get the

// integer result.

return exampleInt;

// The example displays the following output:

// Preparing to finish ExampleMethodAsync.

// Length: 53292

） Importante

Para obtener más información sobre las tareas y el código que se ejecuta mientras
se espera la finalización de una tarea, vea Programación asincrónica con async y
await. Para ver un ejemplo completo de la consola que usa elementos similares,
consulte el artículo Iniciar varias tareas asincrónicas y procesarlas a medida que se
completan (C#).

Tipos de valor devueltos

Un método asincrónico puede tener los siguientes tipos de valor devuelto:

Task
Task<TResult>
void. Los métodos async void no suelen ser recomendables para código que no
sea controladores de eventos dado que los autores de la llamada no pueden usar
 await con esos métodos y deben implementar otro mecanismo para informar

sobre la finalización correcta o condiciones de error.

Cualquier tipo que tenga un método GetAwaiter accesible. El tipo
System.Threading.Tasks.ValueTask<TResult> es una implementación de ese tipo.
Está disponible agregando el paquete NuGet System.Threading.Tasks.Extensions .

El método asincrónico no puede declarar ningún parámetro in, ref o out, ni puede tener
un valor devuelto de referencia, pero puede llamar a los métodos que tienen estos
parámetros.

Se puede especificar Task<TResult> como el tipo de valor devuelto de un método

asincrónico si la instrucción return del método especifica un operando de tipo TResult .
Utilice Task si no se devuelve ningún valor significativo al completarse el método. Es
decir, una llamada al método devuelve Task , pero cuando se completa Task , las
expresiones await que esperan a que Task finalice se evalúan como void .

El tipo devuelto void se utiliza principalmente para definir controladores de eventos,

que requieren ese tipo devuelto. El llamador de un método asincrónico que devuelva
void no puede esperar a que finalice y no puede detectar las excepciones que el

método inicia.

Devuelve otro tipo, normalmente un tipo de valor, que tiene un método GetAwaiter
para minimizar las asignaciones de memoria en secciones críticas de rendimiento del
código.

Para más información y ejemplos, vea Tipos de valor devueltos asincrónicos.

Vea también
AsyncStateMachineAttribute
await
Programación asincrónica con async y await
Procesamiento de tareas asincrónicas a medida que se completan
const (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave const se usa para declarar un campo constante o una local constante.
Los campos y locales constantes no son variables y no se pueden modificar. Las
constantes pueden ser números, valores booleanos, cadenas o una referencia nula. No
cree una constante para representar información que esperas que cambie en algún
momento. Por ejemplo, no use un campo constante para almacenar el precio de un
servicio, un número de versión de producto o el nombre comercial de una compañía.
Estos valores pueden cambiar con el tiempo y, como los compiladores propagan las
constantes, otro código compilado con sus bibliotecas tendrán que volver a compilarse
para ver los cambios. Vea también la palabra clave readonly. Por ejemplo:

C#

const int X = 0;

public const double GravitationalConstant = 6.673e-11;

private const string ProductName = "Visual C#";

A partir de C# 10, las cadenas interpoladas pueden ser constantes, si todas las
expresiones utilizadas también son cadenas constantes. Esta característica puede
mejorar el código que compila cadenas constantes:

C#

const string Language = "C#";

const string Platform = ".NET";

const string Version = "10.0";

const string FullProductName = $"{Platform} - Language: {Language} Version:

{Version}";

Observaciones
El tipo de una declaración constante especifica el tipo de los miembros que la
declaración presenta. El inicializador de una local constante o de un campo constante
debe ser una expresión constante que se pueda convertir implícitamente al tipo de
destino.

Una expresión constante es una expresión que se puede evaluar por completo en
tiempo de compilación. Por lo tanto, los únicos valores posibles para las constantes de
tipos de referencia son string y una referencia nula.
La declaración de constante puede declarar varias constantes, tales como:

C#

public const double X = 1.0, Y = 2.0, Z = 3.0;

El modificador static no se permite en una declaración de constante.

Una constante puede participar en una expresión constante, de la siguiente manera:

C#

public const int C1 = 5;

public const int C2 = C1 + 100;

７ Nota

La palabra clave readonly difiere de la palabra clave const . Un campo const solo
se puede inicializar en la declaración del campo. Un campo readonly se puede
inicializar en la declaración o en un constructor. Por lo tanto, los campos readonly
pueden tener diferentes valores en función del constructor que se use. Además,
aunque un campo const es una constante en tiempo de compilación, el campo
readonly se puede usar para constantes en tiempo de ejecución, como en esta

línea: public static readonly uint l1 = (uint)DateTime.Now.Ticks;

Ejemplos
C#

public class ConstTest

class SampleClass

public int x;

public int y;

public const int C1 = 5;

public const int C2 = C1 + 5;

public SampleClass(int p1, int p2)

x = p1;

y = p2;

 static void Main()

var mC = new SampleClass(11, 22);

Console.WriteLine($"x = {mC.x}, y = {mC.y}");

Console.WriteLine($"C1 = {SampleClass.C1}, C2 = {SampleClass.C2}");

/* Output

x = 11, y = 22

C1 = 5, C2 = 10

*/

Este ejemplo demuestra cómo usar las constantes como variables locales.

C#

public class SealedTest

{

static void Main()

const int C = 707;

Console.WriteLine($"My local constant = {C}");

// Output: My local constant = 707

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores
readonly
event (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave event se usa para declarar un evento en una clase de publicador.

Ejemplo
En el ejemplo siguiente se muestra cómo declarar y generar un evento que usa
EventHandler como el tipo de delegado subyacente. Para obtener el código de ejemplo
completo que también muestra cómo usar el tipo delegado EventHandler<TEventArgs>
genérico y cómo suscribirse a un evento y crear un método de controlador de evento,
vea Procedimiento para publicar eventos que cumplan las directrices de .NET.

C#

public class SampleEventArgs

public SampleEventArgs(string text) { Text = text; }

public string Text { get; } // readonly

public class Publisher

// Declare the delegate (if using non-generic pattern).

public delegate void SampleEventHandler(object sender, SampleEventArgs

e);

// Declare the event.

public event SampleEventHandler SampleEvent;

// Wrap the event in a protected virtual method

// to enable derived classes to raise the event.

protected virtual void RaiseSampleEvent()

// Raise the event in a thread-safe manner using the ?. operator.

SampleEvent?.Invoke(this, new SampleEventArgs("Hello"));

Los eventos son un tipo especial de delegado de multidifusión que solo se pueden
invocar desde la clase (o clases derivadas) o el struct en el que se declaran (la clase de
publicador). Si otras clases o structs se suscriben al evento, se llamará a sus métodos de
controlador de eventos cuando la clase de publicador genera el evento. Para más
información y ejemplos de código, vea Eventos y Delegados.
Las constantes pueden marcarse como public, private, protected, internal, protected
internal o private protected. Estos modificadores de acceso definen cómo los usuarios
de la clase pueden obtener acceso al evento. Para obtener más información, consulte
Modificadores de acceso.

Palabras clave y eventos

Las palabras clave siguientes se aplican a eventos.

Palabra Descripción Para

clave obtener más
información

static Hace que el evento esté disponible para los llamadores en cualquier Clases
momento, aunque no exista ninguna instancia de la clase. estáticas y
sus
miembros

virtual Permite que las clases derivadas invaliden el comportamiento de Herencia

eventos mediante la palabra clave override.

sealed Especifica que ya no es virtual para las clases derivadas.

abstract El compilador no generará los bloques de descriptor de acceso de

eventos add y remove , y por tanto, las clases deben proporcionar su
propia implementación.

Un evento puede declararse como evento estático mediante la palabra clave static. Esto
hace que el evento esté disponible para los llamadores en cualquier momento, aunque
no exista ninguna instancia de la clase. Para más información, vea Clases estáticas y sus
miembros.

Un evento puede marcarse como virtual mediante la palabra clave virtual. Esto permite
que las clases derivadas invaliden el comportamiento de eventos mediante la palabra
clave override. Para obtener más información, vea Herencia. Un evento que reemplaza
un evento virtual también puede ser sealed, que especifica que ya no es virtual para las
clases derivadas. Por último, se puede declarar un evento como abstract, lo que significa
que el compilador no generará los bloques de descriptor de acceso de eventos add y
remove . Por tanto, las clases derivadas deben proporcionar una implementación propia.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
add
remove
Modificadores
Procedimiento para combinar delegados (delegados de multidifusión)
extern (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

El modificador extern se usa para declarar un método que se implementa

externamente. Un uso común del modificador extern es con el atributo DllImport al
usar servicios de interoperabilidad para llamar a código no administrado. En este caso,
el método se debe declarar también como static , como se muestra en el ejemplo
siguiente:

C#

[DllImport("avifil32.dll")]

private static extern void AVIFileInit();

La palabra clave extern también puede definir un alias del ensamblado externo, lo que
permite hacer referencia a diferentes versiones del mismo componente desde un único
ensamblado. Para obtener más información, vea alias externo.

Es un error usar los modificadores abstract y extern juntos para modificar el mismo
miembro. El uso del modificador extern significa que el método se implementa fuera
del código de C#, mientras que el uso del modificador abstract significa que la
implementación del método no se proporciona en la clase.

La palabra clave extern tiene usos más limitados en C# que en C++. Para comparar la
palabra clave de C# con la de C++, consulte el tema sobre el uso de extern para
especificar vinculación en la referencia del lenguaje C++.

Ejemplo 1
En este ejemplo, el programa recibe una cadena del usuario y la muestra en un cuadro
de mensaje. El programa usa el método MessageBox importado de la biblioteca
User32.dll.

C#

//using System.Runtime.InteropServices;

class ExternTest

[DllImport("User32.dll", CharSet=CharSet.Unicode)]

public static extern int MessageBox(IntPtr h, string m, string c, int

type);

 static int Main()

string myString;

Console.Write("Enter your message: ");

myString = Console.ReadLine();

return MessageBox((IntPtr)0, myString, "My Message Box", 0);

Ejemplo 2
En este ejemplo se muestra un programa de C# que llama a una biblioteca de C (una
DLL nativa).

1. Cree el archivo de C siguiente y denomínelo cmdll.c :

// cmdll.c

// Compile with: -LD

int __declspec(dllexport) SampleMethod(int i)

return i*10;

2. Abra una ventana del símbolo del sistema de las herramientas nativas de Visual
Studio x64 (o x32) desde el directorio de instalación de Visual Studio y compile el
archivo cmdll.c escribiendo cl -LD cmdll.c en el símbolo del sistema.

3. En el mismo directorio, cree el siguiente archivo de C# y denomínelo cm.cs :

C#

// cm.cs

using System;

using System.Runtime.InteropServices;

public class MainClass

[DllImport("Cmdll.dll")]

public static extern int SampleMethod(int x);

static void Main()

Console.WriteLine("SampleMethod() returns {0}.",

SampleMethod(5));

 4. Abra una ventana del símbolo del sistema de las herramientas nativas de Visual
Studio x64 (o x32) del directorio de instalación de Visual Studio y compile el
archivo cm.cs escribiendo:

csc cm.cs (para el símbolo del sistema x64), o bien csc -platform:x86 cm.cs
(para el símbolo del sistema x32)

De esta forma, se creará el archivo ejecutable cm.exe .

5. Ejecute cm.exe . El método SampleMethod pasa el valor 5 al archivo DLL, que

devuelve el valor multiplicado por 10. El programa produce el siguiente resultado:

Resultados

SampleMethod() returns 50.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
System.Runtime.InteropServices.DllImportAttribute
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores
in (Modificador genérico) (Referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Para los parámetros de tipo genérico, la palabra clave in especifica que el parámetro de
tipo es contravariante. Puede usar la palabra clave in en las interfaces y delegados
genéricos.

La contravarianza permite usar un tipo menos derivado que el que se especifica en el

parámetro genérico. Esto permite la conversión implícita de las clases que implementan
interfaces contravariantes y la conversión implícita de los tipos de delegado. La
covarianza y la contravarianza de los parámetros de tipo genérico son compatibles con
los tipos de referencia, pero no lo son con los tipos de valor.

Un tipo se puede declarar contravariante en una interfaz o un delgado genéricos solo si

define el tipo de parámetros de un método y no el tipo de valor devuelto de un
método. Los parámetros In , ref y out deben ser invariables, es decir, ni covariantes ni
contravariantes.

Una interfaz que tiene un parámetro de tipo contravariante permite que sus métodos
acepten argumentos de tipos menos derivados que los que se especifican en el
parámetro de tipo de interfaz. Por ejemplo, en la interfaz IComparer<T>, el tipo T es
contravariante, puede asignar un objeto de tipo IComparer<Person> a un objeto de tipo
IComparer<Employee> sin tener que usar ningún método de conversión especial si

Employee hereda Person .

A un delegado contravariante se le puede asignar otro delegado del mismo tipo, pero
con un parámetro de tipo genérico menos derivado.

Para obtener más información, vea Covarianza y contravarianza.

Interfaz genérica contravariante

En el ejemplo siguiente se muestra cómo declarar, extender e implementar una interfaz
genérica contravariante. También se muestra cómo puede usar la conversión implícita
para las clases que implementan esta interfaz.

C#

// Contravariant interface.

interface IContravariant<in A> { }

 // Extending contravariant interface.

interface IExtContravariant<in A> : IContravariant<A> { }

// Implementing contravariant interface.

class Sample<A> : IContravariant<A> { }

class Program

static void Test()

IContravariant<Object> iobj = new Sample<Object>();

IContravariant<String> istr = new Sample<String>();

// You can assign iobj to istr because

// the IContravariant interface is contravariant.

istr = iobj;

Delegado genérico contravariante

En el ejemplo siguiente se muestra cómo declarar e invocar un delegado genérico
contravariante, y crear instancias de este. También se muestra cómo puede convertir
implícitamente un tipo de delegado.

C#

// Contravariant delegate.

public delegate void DContravariant<in A>(A argument);

// Methods that match the delegate signature.

public static void SampleControl(Control control)

{ }

public static void SampleButton(Button button)

{ }

public void Test()

// Instantiating the delegates with the methods.

DContravariant<Control> dControl = SampleControl;

DContravariant<Button> dButton = SampleButton;

// You can assign dControl to dButton

// because the DContravariant delegate is contravariant.

dButton = dControl;

// Invoke the delegate.

dButton(new Button());

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
out
Covarianza y contravarianza
Modificadores
new (Modificador, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Cuando se utiliza como modificador de una declaración, la palabra clave new oculta
explícitamente un miembro heredado de una clase base. Cuando se oculta un miembro
heredado, la versión derivada del miembro reemplaza a la versión de la clase base. Esto
supone que la versión de clase base del miembro es visible, ya que ya estaría oculta si se
hubiera marcado como private o, en algunos casos, como internal . Aunque los
miembros public o protected se pueden ocultar sin utilizar el modificador new , se
generará una advertencia del compilador. Si utiliza new explícitamente para ocultar un
miembro, se suprime esta advertencia.

También puede usar la palabra clave new para crear una instancia de un tipo o como
una restricción de tipo genérico.

Para ocultar un miembro heredado, declárelo en la clase derivada con el mismo nombre
de miembro y modifíquelo con la palabra clave new . Por ejemplo:

C#

public class BaseC

public int x;

public void Invoke() { }

public class DerivedC : BaseC

new public void Invoke() { }

En este ejemplo, BaseC.Invoke oculta DerivedC.Invoke . El campo x no se ve afectado

porque no lo oculta un nombre similar.

La ocultación de nombres por medio de la herencia toma una de las siguientes formas:

Normalmente, una constante, un campo, una propiedad o un tipo que se muestran

en una clase o struct ocultan a todos los miembros de la clase base que comparten
su nombre. Hay casos especiales. Por ejemplo, si declara un nuevo campo con el
nombre N para tener un tipo que no es invocable y un tipo base declara N como
método, el nuevo campo no oculta la declaración base en la sintaxis de invocación.
Para obtener más información, vea la sección Búsqueda de miembros de la
Especificación del lenguaje C#.
 Un método introducido en una clase o struct oculta las propiedades, los campos y
los tipos que comparten el nombre en la clase base. También oculta todos los
métodos de la clase base que tienen la misma signatura.

Un indizador introducido en una clase o struct oculta todos los indizadores de la

clase base que tienen la misma signatura.

Es un error usar new y override en el mismo miembro, porque los dos modificadores
tienen significados mutuamente excluyentes. El modificador new crea un nuevo
miembro con el mismo nombre y oculta el miembro original. El modificador override
amplía la implementación de un miembro heredado.

Si se utiliza el modificador new en una declaración que no oculta un miembro heredado,

se genera una advertencia.

Ejemplos
En este ejemplo, una clase base, BaseC , y una clase derivada, DerivedC , utilizan el mismo
nombre de campo x , lo que oculta el valor del campo heredado. El ejemplo muestra el
uso del modificador new . También muestra cómo obtener acceso a los miembros
ocultos de la clase base mediante sus nombres completos.

C#

public class BaseC

public static int x = 55;

public static int y = 22;

public class DerivedC : BaseC

// Hide field 'x'.

new public static int x = 100;

static void Main()

// Display the new value of x:

Console.WriteLine(x);

// Display the hidden value of x:

Console.WriteLine(BaseC.x);

// Display the unhidden member y:

Console.WriteLine(y);

 /*

Output:

100

55

22

*/

En este ejemplo, una clase anidada oculta una clase que tiene el mismo nombre en la
clase base. El ejemplo muestra cómo utilizar el modificador new para eliminar el
mensaje de advertencia y cómo obtener acceso a los miembros de la clase oculta
mediante sus nombres completos.

C#

public class BaseC

public class NestedC

public int x = 200;

public int y;

public class DerivedC : BaseC

// Nested type hiding the base type members.

new public class NestedC

public int x = 100;

public int y;

public int z;

static void Main()

// Creating an object from the overlapping class:

NestedC c1 = new NestedC();

// Creating an object from the hidden class:

BaseC.NestedC c2 = new BaseC.NestedC();

Console.WriteLine(c1.x);

Console.WriteLine(c2.x);

/*

Output:

100

200

*/

Si quita el modificador new , el programa seguirá compilándose y ejecutándose, pero

aparecerá la siguiente advertencia:

text

The keyword new is required on 'MyDerivedC.x' because it hides inherited

member 'MyBaseC.x'.

Especificación del lenguaje C#

Para obtener más información, vea la sección El modificador new de la Especificación del
lenguaje C#.

Vea también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores
Control de versiones con las palabras clave Override y New
Saber cuándo utilizar las palabras clave Override y New
out (Modificador genérico) (Referencia
de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Para los parámetros de tipo genérico, la palabra clave out especifica que el parámetro
de tipo es covariante. Puede usar la palabra clave out en las interfaces y delegados
genéricos.

La covarianza le permite usar un tipo más derivado que el que se especifica en el

parámetro genérico. Esto permite la conversión implícita de las clases que implementan
interfaces covariantes y la conversión implícita de los tipos de delegado. La covarianza y
la contravarianza son compatibles con los tipos de referencia, pero no lo son con los
tipos de valor.

Una interfaz con un parámetro de tipo covariante permite que sus métodos devuelvan
tipos más derivados que los especificados por el parámetro de tipo. Por ejemplo, dado
que en .NET Framework 4, en IEnumerable<T>, el tipo T es covariante, puede asignar un
objeto del tipo IEnumerable(Of String) a otro objeto del tipo IEnumerable(Of Object)
sin usar ningún método de conversión especial.

A un delegado covariante se le puede asignar otro delegado del mismo tipo, pero con
un parámetro de tipo genérico más derivado.

Para obtener más información, vea Covarianza y contravarianza.

Ejemplo: interfaz genérica covariante

En el ejemplo siguiente se muestra cómo declarar, extender e implementar una interfaz
genérica covariante. También se muestra cómo usar la conversión implícita para las
clases que implementan una interfaz covariante.

C#

// Covariant interface.

interface ICovariant<out R> { }

// Extending covariant interface.

interface IExtCovariant<out R> : ICovariant<R> { }

// Implementing covariant interface.

class Sample<R> : ICovariant<R> { }

class Program

static void Test()

ICovariant<Object> iobj = new Sample<Object>();

ICovariant<String> istr = new Sample<String>();

// You can assign istr to iobj because

// the ICovariant interface is covariant.

iobj = istr;

En una interfaz genérica, un parámetro de tipo se puede declarar como covariante si

cumple las siguientes condiciones:

El parámetro de tipo se usa solamente como tipo de valor devuelto de los

métodos de interfaz y no como tipo de los argumentos de método.

７ Nota

Hay una excepción para esta regla. Si en una interfaz covariante tiene un
delegado genérico contravariante como parámetro de método, puede usar el
tipo covariante como parámetro de tipo genérico para este delegado. Para
obtener más información sobre los delegados genéricos covariantes y
contravariantes, vea Varianza en delegados y Usar la varianza para los
delegados genéricos Func y Action.

El parámetro de tipo no se usa como restricción genérica para los métodos de

interfaz.

Ejemplo: delegado genérico covariante

En el ejemplo siguiente se muestra cómo declarar, invocar y crear instancias de un
delegado genérico covariante. También se muestra cómo convertir implícitamente los
tipos de delegado.

C#

// Covariant delegate.

public delegate R DCovariant<out R>();

// Methods that match the delegate signature.

public static Control SampleControl()

{ return new Control(); }

 public static Button SampleButton()

{ return new Button(); }

public void Test()

// Instantiate the delegates with the methods.

DCovariant<Control> dControl = SampleControl;

DCovariant<Button> dButton = SampleButton;

// You can assign dButton to dControl

// because the DCovariant delegate is covariant.

dControl = dButton;

// Invoke the delegate.

dControl();

En un delegado genérico, un tipo se puede declarar como covariante si se usa

solamente como tipo de valor devuelto por un método y no se usa para los argumentos
de método.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Varianza en interfaces genéricas
in
Modificadores
override (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

El modificador override es necesario para ampliar o modificar la implementación

abstracta o virtual de un método, propiedad, indexador o evento heredado.

En el siguiente ejemplo, la clase Square debe proporcionar una implementación

invalidada de GetArea , ya que GetArea se hereda de la clase abstracta Shape :

C#

abstract class Shape

public abstract int GetArea();

class Square : Shape

private int _side;

public Square(int n) => _side = n;

// GetArea method is required to avoid a compile-time error.

public override int GetArea() => _side * _side;

static void Main()

var sq = new Square(12);

Console.WriteLine($"Area of the square = {sq.GetArea()}");

// Output: Area of the square = 144

Un método override proporciona una nueva implementación de un método heredado

de una clase base. El método invalidado por una declaración override se conoce como
método base invalidado. Un método override debe tener la misma signatura que el
método base invalidado. Los métodos override admiten tipos de valor devuelto
covariantes. En concreto, el tipo de valor devuelto de un método override puede
derivar del tipo de valor devuelto del método base correspondiente.

No se puede invalidar un método estático o no virtual. El método base invalidado debe

ser virtual , abstract o override .

Una declaración override no puede cambiar la accesibilidad del método virtual . El

método override y el método virtual deben tener el mismo modificador de nivel de
acceso.

No se pueden usar los modificadores new , static o virtual para modificar un método
override .

Una declaración de propiedad de invalidación debe especificar exactamente el mismo

modificador de acceso, tipo y nombre que la propiedad heredada,. A partir de C# 9.0,
las propiedades de invalidación de solo lectura admiten tipos de valor devuelto
covariantes. La propiedad invalidada debe ser virtual , abstract u override .

Para obtener más información sobre cómo usar la palabra clave override , vea Control
de versiones con las palabras clave Override y New y Saber cuándo usar las palabras
clave Override y New (Guía de programación de C#). Para obtener información sobre la
herencia, vea Herencia.

Ejemplo
En este ejemplo se define una clase base denominada Employee y una clase derivada
denominada SalesEmployee . La clase SalesEmployee incluye un campo adicional,
salesbonus , e invalida el método CalculatePay para tenerlo en cuenta.

C#

class TestOverride

public class Employee

public string Name { get; }

// Basepay is defined as protected, so that it may be

// accessed only by this class and derived classes.

protected decimal _basepay;

// Constructor to set the name and basepay values.

public Employee(string name, decimal basepay)

Name = name;

_basepay = basepay;

// Declared virtual so it can be overridden.

public virtual decimal CalculatePay()

return _basepay;

// Derive a new class from Employee.

 public class SalesEmployee : Employee

// New field that will affect the base pay.

private decimal _salesbonus;

// The constructor calls the base-class version, and

// initializes the salesbonus field.

public SalesEmployee(string name, decimal basepay, decimal

salesbonus)

: base(name, basepay)

_salesbonus = salesbonus;

// Override the CalculatePay method

// to take bonus into account.

public override decimal CalculatePay()

{

return _basepay + _salesbonus;

static void Main()

// Create some new employees.

var employee1 = new SalesEmployee("Alice", 1000, 500);

var employee2 = new Employee("Bob", 1200);

Console.WriteLine($"Employee1 {employee1.Name} earned:

{employee1.CalculatePay()}");

Console.WriteLine($"Employee2 {employee2.Name} earned:

{employee2.CalculatePay()}");

/*

Output:

Employee1 Alice earned: 1500

Employee2 Bob earned: 1200

*/

Especificación del lenguaje C#

Para obtener más información, vea la sección Métodos de invalidación de Especificación
del lenguaje C#.

Para obtener más información sobre tipos de valor devuelto covariantes, vea la nota de
propuesta de características.

Vea también
Referencia de C#
Herencia
Palabras clave de C#
Modificadores
abstract
virtual
new (modificador)
Polimorfismo
readonly (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

La palabra clave readonly es un modificador que se puede usar en cuatro contextos:

En una declaración de campo, readonly indica que la asignación a un campo solo

se puede producir como parte de la declaración o en un constructor de la misma
clase. Se puede asignar y reasignar varias veces un campo de solo lectura dentro
de la declaración de campo y el constructor.

No se puede asignar un campo readonly después de que el constructor salga. Esta

regla tiene diferentes implicaciones para los tipos de valor y tipos de referencia:
Debido a que los tipos de valor contienen directamente sus datos, un campo
que es un tipo de valor readonly es inmutable.
Dado que los tipos de referencia contienen una referencia a sus datos, un
campo que es un tipo de referencia readonly debe referirse siempre al mismo
objeto. Ese objeto no es inmutable. El modificador readonly evita que el campo
se reemplace por una instancia diferente del tipo de referencia. Sin embargo, el
modificador no impide que los datos de instancia del campo se modifiquen a
través del campo de solo lectura.

２ Advertencia

Un tipo visible externamente que contenga un campo de solo lectura visible

externamente que sea un tipo de referencia mutable puede ser una
vulnerabilidad de seguridad y puede desencadenar la advertencia CA2104:
"No declarar tipos de referencias mutables de solo lectura".

En una definición de tipo de readonly struct , readonly indica que el tipo de

estructura es inmutable. Para obtener más información, vea la sección struct
readonly del artículo tipos de estructura.

En una declaración de miembro de instancia dentro de un tipo de estructura,

readonly indica que un miembro de instancia no modifica el estado de la

estructura. Para obtener más información, vea la sección Miembros de instancia

readonly del artículo Tipos de estructura.

En una devolución del método ref readonly, el modificador readonly indica que el
método devuelve una referencia y las operaciones de escritura no se permiten en
esa referencia.
Ejemplo de campo readonly
En este ejemplo, el valor del campo year no se puede cambiar en el método
ChangeYear , aunque se asigne un valor en el constructor de clase:

C#

class Age

private readonly int _year;

Age(int year)

_year = year;

void ChangeYear()

//_year = 1967; // Compile error if uncommented.

Solo se puede asignar un valor a un campo readonly en los siguientes contextos:

Cuando la variable se inicializa en la declaración, por ejemplo:

C#

public readonly int y = 5;

En un constructor de instancia de la clase que contiene la declaración de campo de

instancia.

En el constructor estático de la clase que contiene la declaración de campo

estático.

Estos contextos de constructor son también los únicos en los que es válido pasar un
campo readonly como parámetro out o ref.

７ Nota

La palabra clave readonly es diferente de la palabra clave const. Un campo const

solo se puede inicializar en la declaración del campo. Un campo readonly se puede
asignar varias veces en la declaración de campo y en cualquier constructor. Por lo
tanto, los campos readonly pueden tener diferentes valores en función del
constructor que se use. Además, mientras que un campo const es una constante
 en tiempo de compilación, el campo readonly puede usarse para constantes en
tiempo de ejecución, como muestra el siguiente ejemplo:

C#

public static readonly uint timeStamp = (uint)DateTime.Now.Ticks;

C#

public class SamplePoint

public int x;

// Initialize a readonly field

public readonly int y = 25;

public readonly int z;

public SamplePoint()

// Initialize a readonly instance field

z = 24;

public SamplePoint(int p1, int p2, int p3)

x = p1;

y = p2;

z = p3;

public static void Main()

SamplePoint p1 = new SamplePoint(11, 21, 32); // OK

Console.WriteLine($"p1: x={p1.x}, y={p1.y}, z={p1.z}");

SamplePoint p2 = new SamplePoint();

p2.x = 55; // OK

Console.WriteLine($"p2: x={p2.x}, y={p2.y}, z={p2.z}");

/*

Output:

p1: x=11, y=21, z=32

p2: x=55, y=25, z=24

*/

En el ejemplo anterior, si se usa una instrucción como el ejemplo siguiente:

C#

p2.y = 66; // Error

se obtendrá el siguiente mensaje de error del compilador:

No se puede asignar un campo de solo lectura (excepto en un constructor o

inicializador de variable) .

Ejemplo de devolución de Ref readonly

El modificador readonly en un elemento ref return indica que la referencia devuelta
no se puede modificar. En el ejemplo siguiente se devuelve una referencia al origen. Usa
el modificador readonly para indicar que los autores de la llamada no pueden modificar
el origen:

C#

private static readonly SamplePoint s_origin = new SamplePoint(0, 0, 0);

public static ref readonly SamplePoint Origin => ref s_origin;

No es necesario que el tipo devuelto sea una readonly struct . Cualquier tipo que
pueda devolver ref también puede devolver ref readonly .

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

También puede ver las propuestas de especificación del lenguaje:

referencia de solo lectura y estructura de solo lectura

miembros de estructura de solo lectura

Vea también
Agregar modificador readonly (regla de estilo IDE0044)
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores
const
Campos
sealed (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Cuando se aplica a una clase, el modificador sealed impide que otras clases hereden de
ella. En el ejemplo siguiente, la clase B hereda de la clase A , pero ninguna clase puede
heredar de la clase B .

C#

class A {}

sealed class B : A {}

También puede usar el modificador sealed en un método o propiedad que invalida un

método o propiedad virtual en una clase base. De este modo, puede permitir que las
clases deriven de su clase e impedir que invaliden determinados métodos o
propiedades virtuales.

Ejemplo
En el ejemplo siguiente, Z hereda de Y pero Z no puede invalidar la función virtual F
que se declara en X y se sella en Y .

C#

class X

protected virtual void F() { Console.WriteLine("X.F"); }

protected virtual void F2() { Console.WriteLine("X.F2"); }

class Y : X

sealed protected override void F() { Console.WriteLine("Y.F"); }

protected override void F2() { Console.WriteLine("Y.F2"); }

class Z : Y

// Attempting to override F causes compiler error CS0239.

// protected override void F() { Console.WriteLine("Z.F"); }

// Overriding F2 is allowed.

protected override void F2() { Console.WriteLine("Z.F2"); }

Al definir nuevos métodos o propiedades en una clase, puede impedir que las clases
derivadas los invaliden. Para ello, no los declare como virtuales.

Es un error usar el modificador abstract con una clase sellada, porque una clase
abstracta debe heredarla una clase que proporcione una implementación de los
métodos o propiedades abstractos.

Cuando se aplica a un método o propiedad, el modificador sealed siempre se debe

usar con override.

Dado que los structs están sellados implícitamente, no puede heredarse.

Para obtener más información, vea Herencia.

Para obtener más ejemplos, vea Clases y miembros de clase abstractos y sellados.

C#

sealed class SealedClass

public int x;

public int y;

class SealedTest2

static void Main()

var sc = new SealedClass();

sc.x = 110;

sc.y = 150;

Console.WriteLine($"x = {sc.x}, y = {sc.y}");

// Output: x = 110, y = 150

En el ejemplo anterior, podría intentar heredar de la clase sellada mediante la

instrucción siguiente:

class MyDerivedC: SealedClass {} // Error

El resultado es un mensaje de error:

'MyDerivedC': cannot derive from sealed type 'SealedClass'

Comentarios
Para determinar si se debe sellar una clase, un método o una propiedad, por lo general
debe tener en cuenta los dos puntos siguientes:

Las posibles ventajas que podrían obtener las clases derivadas con la capacidad de
personalizar la clase.

La posibilidad de que las clases derivadas modifiquen las clases de tal manera que
no funcionen correctamente o del modo esperado.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Clases estáticas y sus miembros
Clases y miembros de clase abstractos y sellados
Modificadores de acceso
Modificadores
override
virtual
static (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

En esta página se trata la palabra clave del modificador static . La palabra clave static
también forma parte de la directiva using static.

Use el modificador static para declarar un miembro estático, que pertenece al propio
tipo en lugar de a un objeto específico. El modificador static se puede usar para
declarar clases static . En las clases, las interfaces y las estructuras, puede agregar el
modificador static a los campos, los métodos, las propiedades, los operadores, los
eventos y los constructores. El modificador static no se puede usar con indizadores ni
finalizadores. Para más información, vea Clases estáticas y sus miembros.

Puede agregar el modificador static a una función local. Una función local estática no
puede capturar variables locales o el estado de la instancia.

A partir de C# 9.0, puede agregar el modificador static a una expresión lambda o un

método anónimo. Una expresión lambda o un método anónimo estático no pueden
capturar variables locales o el estado de la instancia.

Ejemplo: clase estática

La siguiente clase se declara como static y contiene solo métodos static :

C#

static class CompanyEmployee

public static void DoSomething() { /*...*/ }

public static void DoSomethingElse() { /*...*/ }

Una declaración de constantes o tipos es implícitamente un miembro static . No se

puede hacer referencia a un miembro static mediante una instancia, sino que se hace
a través del nombre de tipo. Por ejemplo, considere la siguiente clase:

C#

public class MyBaseC

public struct MyStruct

public static int x = 100;

Para hacer referencia al miembro static x , use el nombre completo,

MyBaseC.MyStruct.x , a menos que el miembro sea accesible desde el mismo ámbito:

C#

Console.WriteLine(MyBaseC.MyStruct.x);

Mientras que una instancia de una clase contiene una copia independiente de todos los
campos de instancia de la clase, solo hay una copia de cada campo static .

No se puede usar this para hacer referencia a métodos static o descriptores de acceso
de propiedades.

Si la palabra clave static se aplica a una clase, todos los miembros de esta deben ser
static .

Las clases, las interfaces y las clases static pueden tener constructores static . Se llama
a un constructor static en algún momento entre el inicio del programa y la creación de
una instancia de la clase.

７ Nota

La palabra clave static tiene usos más limitados que en C++. Para ver una
comparación con la palabra clave de C++, vea Clases de almacenamiento (C++).

Para mostrar miembros static , es recomendable una clase que represente al empleado
de una empresa. Supongamos que la clase contiene un método de recuento de
empleados y un campo para almacenar el número de empleados. El método y el campo
no pertenecen a ninguna instancia de ningún empleado, sino que pertenecen a la clase
de empleados en su conjunto. Se deben declarar como miembros static de la clase.

Ejemplo: campo estático y método

En este ejemplo se lee el nombre y el identificador de un nuevo empleado, se
incrementa en uno el recuento de empleados y se muestra la información del nuevo
empleado, así como el nuevo número de empleados. Este programa lee el número
actual de empleados desde el teclado.
C#

public class Employee4

public string id;

public string name;

public Employee4()

public Employee4(string name, string id)

this.name = name;

this.id = id;

public static int employeeCounter;

public static int AddEmployee()

return ++employeeCounter;

class MainClass : Employee4

static void Main()

Console.Write("Enter the employee's name: ");

string name = Console.ReadLine();

Console.Write("Enter the employee's ID: ");

string id = Console.ReadLine();

// Create and configure the employee object.

Employee4 e = new Employee4(name, id);

Console.Write("Enter the current number of employees: ");

string n = Console.ReadLine();

Employee4.employeeCounter = Int32.Parse(n);

Employee4.AddEmployee();

// Display the new information.

Console.WriteLine($"Name: {e.name}");

Console.WriteLine($"ID: {e.id}");

Console.WriteLine($"New Number of Employees:

{Employee4.employeeCounter}");

/*

Input:

Matthias Berndt

AF643G

15

 Sample Output:

Enter the employee's name: Matthias Berndt

Enter the employee's ID: AF643G

Enter the current number of employees: 15

Name: Matthias Berndt

ID: AF643G

New Number of Employees: 16

*/

Ejemplo: inicialización estática

En este ejemplo se muestra que se puede inicializar un campo static mediante otro
campo static que aún no se ha declarado. Los resultados están sin definir hasta que se
asigna explícitamente un valor al campo static .

C#

class Test

static int x = y;

static int y = 5;

static void Main()

Console.WriteLine(Test.x);

Console.WriteLine(Test.y);

Test.x = 99;

Console.WriteLine(Test.x);

/*

Output:

99

*/

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores
using static (directiva)
Clases estáticas y sus miembros
unsafe (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave unsafe denota un contexto no seguro, que es necesario para realizar
cualquier operación que implique punteros. Para obtener más información, vea Código
no seguro y punteros (Guía de programación de C#).

Puede usar el codificador unsafe en la declaración de un tipo o miembro. Por

consiguiente, toda la extensión textual del tipo o miembro se considera un contexto no
seguro. Por ejemplo, el siguiente método se declara con el modificador unsafe :

C#

unsafe static void FastCopy(byte[] src, byte[] dst, int count)

// Unsafe context: can use pointers here.

El ámbito del contexto no seguro se extiende desde la lista de parámetros hasta el final
del método, por lo que también pueden usarse punteros en la lista de parámetros:

C#

unsafe static void FastCopy ( byte* ps, byte* pd, int count ) {...}

También puede usarse un bloque no seguro para habilitar el uso de código no seguro
en el bloque. Por ejemplo:

C#

unsafe

// Unsafe context: can use pointers here.

Para compilar código no seguro, debe especificar la opción del compilador

AllowUnsafeBlocks. Common Language Runtime no puede comprobar el código no
seguro.

Ejemplo
C#
 // compile with: -unsafe

class UnsafeTest

// Unsafe method: takes pointer to int.

unsafe static void SquarePtrParam(int* p)

*p *= *p;

unsafe static void Main()

int i = 5;

// Unsafe method: uses address-of operator (&).

SquarePtrParam(&i);

Console.WriteLine(i);

// Output: 25

Especificación del lenguaje C#

Para más información, vea la sección sobre código no seguro de la Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.

Vea también
Referencia de C#
Palabras clave de C#
Instrucción fixed
Código no seguro, tipos de puntero y punteros de función
Operadores relacionados con el puntero
virtual (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

La palabra clave virtual se usa para modificar una declaración de método, propiedad,
indizador o evento y permitir que se invalide en una clase derivada. Por ejemplo,
cualquier clase que herede este método puede reemplazarlo:

C#

public virtual double Area()

return x * y;

Un miembro de reemplazo de una clase derivada puede modificar la implementación de

un miembro virtual. Para obtener más información sobre cómo usar la palabra clave
virtual , vea Control de versiones con las palabras clave Override y New y Saber cuándo
usar las palabras clave Override y New (Guía de programación de C#).

Observaciones
Cuando se invoca a un método virtual, se busca un miembro de reemplazo en el tipo en
tiempo de ejecución del objeto. Se llama al miembro de reemplazo en la clase más
derivada, que podría ser el miembro original si ninguna clase derivada ha invalidado al
miembro.

De forma predeterminada, los métodos son no virtuales. No se puede invalidar un

método no virtual.

El modificador virtual no se puede usar con los modificadores static , abstract ,

private o override . En el siguiente ejemplo se muestra una propiedad virtual:

C#

class MyBaseClass

// virtual auto-implemented property. Overrides can only

// provide specialized behavior if they implement get and set accessors.

public virtual string Name { get; set; }

// ordinary virtual property with backing field

private int _num;

public virtual int Number

 get { return _num; }

set { _num = value; }

class MyDerivedClass : MyBaseClass

private string _name;

// Override auto-implemented property with ordinary property

// to provide specialized accessor behavior.

public override string Name

get

return _name;

set

if (!string.IsNullOrEmpty(value))

_name = value;

else

_name = "Unknown";

Las propiedades virtuales se comportan como métodos virtuales, salvo por las
diferencias en la sintaxis de declaración e invocación.

Es un error usar el modificador virtual en una propiedad estática.

Una propiedad virtual heredada se puede invalidar en una clase derivada al incluir
una declaración de propiedad que use el modificador override .

Ejemplo
En este ejemplo, la clase Shape contiene las dos coordenadas x , y y el método virtual
Area() . Las distintas clases de formas como Circle , Cylinder y Sphere heredan la clase
Shape y se calcula el área de cada figura. Cada clase derivada tiene su propia

implementación de invalidación de Area() .

Observe que las clases heredadas Circle , Sphere y Cylinder usan constructores que
inicializan la clase base, como se muestra en la siguiente declaración.
 C#

public Cylinder(double r, double h): base(r, h) {}

El programa siguiente calcula y muestra el área apropiada de cada figura al invocar a la

implementación adecuada del método Area() , según el objeto asociado al método.

C#

class TestClass

public class Shape

public const double PI = Math.PI;

protected double _x, _y;

public Shape()

public Shape(double x, double y)

_x = x;

_y = y;

public virtual double Area()

return _x * _y;

public class Circle : Shape

public Circle(double r) : base(r, 0)

public override double Area()

return PI * _x * _x;

public class Sphere : Shape

public Sphere(double r) : base(r, 0)

public override double Area()

 return 4 * PI * _x * _x;

public class Cylinder : Shape

public Cylinder(double r, double h) : base(r, h)

public override double Area()

return 2 * PI * _x * _x + 2 * PI * _x * _y;

static void Main()

double r = 3.0, h = 5.0;

Shape c = new Circle(r);

Shape s = new Sphere(r);

Shape l = new Cylinder(r, h);

// Display results.

Console.WriteLine("Area of Circle = {0:F2}", c.Area());

Console.WriteLine("Area of Sphere = {0:F2}", s.Area());

Console.WriteLine("Area of Cylinder = {0:F2}", l.Area());

/*

Output:

Area of Circle = 28.27

Area of Sphere = 113.10

Area of Cylinder = 150.80

*/

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Polimorfismo
abstract
override
new (modificador)
volatile (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

La palabra clave volatile indica que un campo puede ser modificado por varios
subprocesos que se ejecutan al mismo tiempo. El compilador, el sistema de runtime e
incluso el hardware pueden reorganizar las lecturas y escrituras en las ubicaciones de
memoria por motivos de rendimiento. Los campos declarados como volatile se
excluyen de determinados tipos de optimizaciones. No hay ninguna garantía de una
única ordenación total de las operaciones de escritura volátiles como se muestra en
todos los subprocesos de ejecución. Para obtener más información, vea la clase Volatile.

７ Nota

En un sistema de varios procesadores, una operación de lectura volátil no garantiza

que ningún procesador obtenga el valor más reciente escrito en esa ubicación de
memoria. De forma similar, una operación de escritura volátil no garantiza que el
valor escrito sea inmediatamente visible para otros procesadores.

La palabra clave volatile se puede aplicar a campos de estos tipos:

Tipos de referencia.
Tipos de puntero (en un contexto no seguro). Observe que aunque el propio
puntero puede ser volatile, no el objeto al que apunta. Es decir, no puede declarar
un "puntero a volatile".
Tipos simples como sbyte , byte , short , ushort , int , uint , char , float y bool .
Un tipo enum con uno de los siguientes tipos base: byte , sbyte , short , ushort ,
int o uint .

Parámetros de tipo genérico que se sabe que son tipos de referencia.

IntPtr y UIntPtr.

Otros tipos, incluidos double y long , no pueden marcarse como volatile porque no se
puede garantizar que las lecturas y escrituras los campos de esos tipos sean atómicas.
Para proteger el acceso multiproceso a esos tipos de campos, use los miembros de clase
Interlocked o proteja el acceso mediante la instrucción lock.

La palabra clave volatile solo se puede aplicar a campos de class o struct . Las
variables locales no se pueden declarar como volatile .

Ejemplo
En el ejemplo siguiente se muestra cómo declarar una variable de campo pública como
volatile .

C#

class VolatileTest

public volatile int sharedStorage;

public void Test(int i)

sharedStorage = i;

En el ejemplo siguiente se muestra cómo crear un subproceso auxiliar o de trabajo y

usarlo para realizar el procesamiento en paralelo con el del subproceso principal. Para
más información sobre el multithreading, vea Subprocesamiento administrado.

C#

public class Worker

// This method is called when the thread is started.

public void DoWork()

bool work = false;

while (!_shouldStop)

work = !work; // simulate some work

Console.WriteLine("Worker thread: terminating gracefully.");

public void RequestStop()

_shouldStop = true;

// Keyword volatile is used as a hint to the compiler that this data

// member is accessed by multiple threads.

private volatile bool _shouldStop;

public class WorkerThreadExample

public static void Main()

// Create the worker thread object. This does not start the thread.

Worker workerObject = new Worker();

Thread workerThread = new Thread(workerObject.DoWork);

// Start the worker thread.

 workerThread.Start();

Console.WriteLine("Main thread: starting worker thread...");

// Loop until the worker thread activates.

while (!workerThread.IsAlive)

// Put the main thread to sleep for 500 milliseconds to

// allow the worker thread to do some work.

Thread.Sleep(500);

// Request that the worker thread stop itself.

workerObject.RequestStop();

// Use the Thread.Join method to block the current thread

// until the object's thread terminates.

workerThread.Join();

Console.WriteLine("Main thread: worker thread has terminated.");

// Sample output:

// Main thread: starting worker thread...

// Worker thread: terminating gracefully.

// Main thread: worker thread has terminated.

Con el modificador volatile que se agrega a la declaración de _shouldStop en su lugar,

siempre obtendrá los mismos resultados (similar al fragmento que se muestra en el
código anterior). Sin embargo, sin ese modificador en el miembro _shouldStop , el
comportamiento es imprevisible. El método DoWork puede optimizar el acceso a los
miembros, lo que provoca la lectura de datos obsoletos. Dada la naturaleza de la
programación multiproceso, el número de lecturas obsoletas es imprevisible. Distintas
ejecuciones del programa generarán resultados ligeramente diferentes.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Especificación del lenguaje C#: palabra clave volatile
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificadores
lock (Instrucción)
Interlocked
Palabras clave de instrucciones
(Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las instrucciones son instrucciones de programa. A excepción de como se describe en

los temas a los que se hace referencia en la tabla siguiente, las instrucciones se ejecutan
en secuencia. En la tabla siguiente, se enumeran las palabras claves de instrucción de
C#. Para obtener más información sobre las instrucciones que no se expresan con
ninguna palabra clave, consulte Instrucciones.

Categoría Palabras clave de C#

Instrucciones de selección if , switch

Instrucciones de iteración do , for , foreach , while

Instrucciones de salto break , continue , goto , return

Instrucciones para el control de excepciones throw, try-catch, try-finally, try-catch-finally

Instrucciones checked y unchecked checked , unchecked

Instrucción fixed fixed

lock (Instrucción) lock

Instrucción yield yield

Consulte también
Referencia de C#
Instrucciones
Palabras clave de C#
throw (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Indica la aparición de una excepción durante la ejecución del programa.

Observaciones
La sintaxis de throw es la siguiente:

C#

throw [e];

donde e es una instancia de una clase derivada de System.Exception. En el ejemplo

siguiente se usa la instrucción throw para producir una excepción
IndexOutOfRangeException si el argumento pasado a un método denominado
GetNumber no se corresponde con un índice válido de una matriz interna.

C#

using System;

namespace Throw2

public class NumberGenerator

int[] numbers = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };

public int GetNumber(int index)

if (index < 0 || index >= numbers.Length)

throw new IndexOutOfRangeException();

return numbers[index];

Después, los autores de llamadas a método usan un bloque try-catch o try-catch-

finally para controlar la excepción generada. En el ejemplo siguiente se controla la

excepción producida por el método GetNumber .

C#
 using System;

public class Example

public static void Main()

var gen = new NumberGenerator();

int index = 10;

try

int value = gen.GetNumber(index);

Console.WriteLine($"Retrieved {value}");

catch (IndexOutOfRangeException e)

Console.WriteLine($"{e.GetType().Name}: {index} is outside the

bounds of the array");

// The example displays the following output:

// IndexOutOfRangeException: 10 is outside the bounds of the array

Inicio repetido de una excepción

throw también se puede usar en un bloque catch para volver a iniciar una excepción

controlada en un bloque catch . En este caso, throw no toma un operando de

excepción. Resulta más útil cuando un método pasa un argumento de un autor de
llamada a otro método de biblioteca y el método de biblioteca produce una excepción
que se debe pasar al autor de llamada. Por ejemplo, en el ejemplo siguiente se vuelve a
iniciar una excepción NullReferenceException que se produce al intentar recuperar el
primer carácter de una cadena sin inicializar.

C#

using System;

namespace Throw

public class Sentence

public Sentence(string s)

Value = s;

public string Value { get; set; }

 public char GetFirstCharacter()

try

return Value[0];

catch (NullReferenceException e)

throw;

public class Example

public static void Main()

var s = new Sentence(null);

Console.WriteLine($"The first character is {s.GetFirstCharacter()}");

// The example displays the following output:

// Unhandled Exception: System.NullReferenceException: Object reference

not set to an instance of an object.

// at Sentence.GetFirstCharacter()

// at Example.Main()

） Importante

También puede usar la sintaxis throw e en un bloque catch para crear instancias
de una nueva excepción que se pase al autor de llamada. En este caso, no se
conserva el seguimiento de la pila de la excepción original, que está disponible en
la propiedad StackTrace.

La expresión throw
Se puede usar throw como una expresión y como una instrucción. Esto permite iniciar
una excepción en contextos que antes no se admitían. Entre ellas se incluyen las
siguientes:

El operador condicional. En el ejemplo siguiente se usa una expresión throw para

iniciar una excepción ArgumentException si se pasa a un método una matriz de
cadena vacía.

C#
 private static void DisplayFirstNumber(string[] args)

string arg = args.Length >= 1 ? args[0] :

throw new ArgumentException("You must

supply an argument");

if (Int64.TryParse(arg, out var number))

Console.WriteLine($"You entered {number:F0}");

else

Console.WriteLine($"{arg} is not a number.");

El operador de uso combinado de NULL. En el ejemplo siguiente, se usa una

expresión throw con un operador de uso combinado de NULL para producir una
excepción si la cadena asignada a una propiedad Name es null .

C#

public string Name

get => name;

set => name = value ??

throw new ArgumentNullException(paramName: nameof(value),

message: "Name cannot be null");

Un método o lambda con forma de expresión. En el ejemplo siguiente se muestra

un método con forma de expresión que produce una excepción
InvalidCastException porque no se admite una conversión a un valor DateTime.

C#

DateTime ToDateTime(IFormatProvider provider) =>

throw new InvalidCastException("Conversion to a DateTime is

not supported.");

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Preferencias de "throw" (regla de estilo IDE0016)
Referencia de C#
Guía de programación de C#
try-catch
Palabras clave de C#
Cómo: Iniciar excepciones explícitamente
try-catch (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

La instrucción try-catch consta de un bloque try seguido de una o más cláusulas catch
que especifican controladores para diferentes excepciones.

Cuando se produce una excepción, Common Language Runtime (CLR) busca la

instrucción catch que controla esta excepción. Si el método que se ejecuta actualmente
no contiene un bloque catch , CLR busca el método que llamó el método actual, y así
sucesivamente hasta la pila de llamadas. Si no existe ningún bloque catch , CLR muestra
al usuario un mensaje de excepción no controlada y detiene la ejecución del programa.

El bloque try contiene el código protegido que puede producir la excepción. El bloque
se ejecuta hasta que se produce una excepción o hasta que se completa correctamente.
Por ejemplo, el intento siguiente de convertir un objeto null produce la excepción
NullReferenceException:

C#

object o2 = null;

try

int i2 = (int)o2; // Error

Aunque la cláusula catch puede utilizarse sin argumentos para detectar cualquier tipo
de excepción, no se recomienda este uso. En general, solo debe convertir las
excepciones que sabe cómo recuperar. Por lo tanto, debe especificar siempre un
argumento de objeto derivado de System.Exception. El tipo de excepción debe ser lo
más específico posible para evitar que se acepten incorrectamente excepciones que el
controlador de excepciones no pueda resolver realmente. Por lo tanto, se prefieren
excepciones concretas sobre el tipo Exception base. Por ejemplo:

C#

catch (InvalidCastException e)

// recover from exception

Es posible utilizar más de una cláusula catch específica en la misma instrucción try-
catch. En este caso, el orden de las cláusulas catch es importante, puesto que las
cláusulas catch se examinan por orden. Detectar las excepciones más específicas antes
que las menos específicas. El compilador genera un error si ordena los bloques de
detección para que un bloque posterior nunca pueda alcanzarse.

La utilización de los argumentos catch es una manera de filtrar las excepciones que
desea controlar. También se puede usar una expresión de filtro que examine aún más la
excepción para decidir si controlarla. Si la expresión de filtro devuelve false, prosigue la
búsqueda de un controlador.

C#

catch (ArgumentException e) when (e.ParamName == "…")

// recover from exception

Los filtros de excepción son preferibles para detectar y volver a producir (se explica a
continuación) porque los filtros dejan la pila intacta. Si un controlador posterior vuelca
la pila, puede ver la procedencia original de la excepción, más que solo la ubicación en
la que se volvió a producir. Un uso común de las expresiones de filtro de excepciones es
el registro. Puede crear una función de filtro que siempre devuelva false y que también
resulte en un registro, o bien puede registrar excepciones a medida que se produzcan
sin tener que controlarlas y volver a generarlas.

Se puede usar una instrucción throw en un bloque catch para volver a iniciar la
excepción detectada por la instrucción catch . En el ejemplo siguiente se extrae
información de origen de una excepción IOException y, a continuación, se produce la
excepción al método principal.

C#

catch (FileNotFoundException e)

// FileNotFoundExceptions are handled here.

catch (IOException e)

    // Extract some information from this exception, and then

    // throw it to the parent method.

    if (e.Source != null)

        Console.WriteLine("IOException source: {0}", e.Source);

    throw;

Puede capturar una excepción y producir una excepción diferente. Al hacerlo,

especifique la excepción que detectó como excepción interna, tal como se muestra en el
ejemplo siguiente.

C#

catch (InvalidCastException e)

// Perform some action here, and then throw a new exception.

throw new YourCustomException("Put your error message here.", e);

También se puede volver a producir una excepción sin una condición específica es true,
tal y como se muestra en el ejemplo siguiente.

C#

catch (InvalidCastException e)

if (e.Data == null)
{

throw;

else

// Take some action.

７ Nota

También es posible usar un filtro de excepción para obtener un resultado similar de

una forma generalmente más limpia (además de no modificar la pila, tal y como se
explicó anteriormente en este documento). El ejemplo siguiente tiene un
comportamiento similar para los autores de llamada que el ejemplo anterior. La
función inicia la excepción InvalidCastException de vuelta al autor de la llamada
cuando e.Data es null .

C#

catch (InvalidCastException e) when (e.Data != null)

// Take some action.

Desde dentro de un bloque try , solo deben inicializarse las variables que se declaran en
el mismo. De lo contrario, puede ocurrir una excepción antes de que se complete la
ejecución del bloque. Por ejemplo, en el siguiente ejemplo de código, la variable n se
inicializa dentro del bloque try . Un intento de utilizar esta variable fuera del bloque
try en la instrucción Write(n) generará un error del compilador.

C#

static void Main()

int n;

try

// Do not initialize this variable here.

n = 123;

catch

// Error: Use of unassigned local variable 'n'.

Console.Write(n);

Para obtener más información sobre la captura,vea try-catch-finally (try-catch-finally

[Referencia de C#]).

Excepciones en métodos asincrónicos

Un método asincrónico está marcado por un modificador async y normalmente
contiene una o más instrucciones o expresiones “await” (de espera). Una expresión await
aplica el operador await a Task o Task<TResult>.

Cuando el control alcanza un await en el método asincrónico, el progreso del método

se suspende hasta que la tarea esperada se completa. Cuando se completa la tarea, la
ejecución puede reanudarse en el método. Para obtener más información, consulte
Programación asincrónica con Async y Await.

La tarea completada a la que se aplica await puede encontrarse en un estado de error

debido a una excepción no controlada en el método que devuelve la tarea. La espera de
la tarea produce una excepción. Una tarea también puede terminar en un estado
cancelado si se cancela el proceso asincrónico que devuelve. La espera de una tarea
cancelada devuelve una excepción OperationCanceledException .
Para detectar la excepción, espere la tarea en un bloque try y detéctela en el bloque
asociado catch . Para obtener un ejemplo, vea la sección Ejemplo de método async.

Una tarea puede encontrarse en un estado de error debido a que ocurrieron varias
excepciones en el método asincrónico esperado. Por ejemplo, la tarea podría ser el
resultado de una llamada a Task.WhenAll. Cuando espera una tarea de este tipo, solo se
captura una de las excepciones y no puede predecir qué excepción se capturará. Para
obtener un ejemplo, vea la sección Ejemplo de Task.WhenAll.

Ejemplo
En el ejemplo siguiente, el bloque try contiene una llamada al método ProcessString
que puede causar una excepción. La cláusula catch contiene el controlador de
excepciones que muestra un mensaje en la pantalla. Cuando la instrucción throw se
llama desde dentro ProcessString , el sistema busca la instrucción catch y muestra el
mensaje Exception caught .

C#

class TryFinallyTest

static void ProcessString(string s)

if (s == null)

throw new ArgumentNullException(paramName: nameof(s), message:

"parameter can't be null.");

public static void Main()

string s = null; // For demonstration purposes.

try

ProcessString(s);

catch (Exception e)

Console.WriteLine("{0} Exception caught.", e);

/*

Output:

System.ArgumentNullException: Value cannot be null.

 at TryFinallyTest.Main() Exception caught.

* */

Ejemplo de dos bloques catch

En el ejemplo siguiente, se utilizan dos bloques de detección y la excepción más
específica, que es la que aparece primero, es la que se captura.

Para capturar la excepción menos específica, puede sustituir la instrucción throw en

ProcessString por la siguiente instrucción: throw new Exception() .

Si coloca primero en el ejemplo el bloque catch menos específico, aparece el siguiente

mensaje de error: A previous catch clause already catches all exceptions of this or
a super type ('System.Exception') .

C#

class ThrowTest3

static void ProcessString(string s)

if (s == null)

throw new ArgumentNullException(paramName: nameof(s), message:

"Parameter can't be null");

public static void Main()

try

string s = null;

ProcessString(s);

// Most specific:

catch (ArgumentNullException e)

Console.WriteLine("{0} First exception caught.", e);

// Least specific:

catch (Exception e)

Console.WriteLine("{0} Second exception caught.", e);

/*

Output:

 System.ArgumentNullException: Value cannot be null.

at Test.ThrowTest3.ProcessString(String s) ... First exception caught.

*/

Ejemplo de método async

En el ejemplo siguiente se muestra el control de excepciones de los métodos
asincrónicos. Para capturar una excepción que produce una tarea asincrónica, coloque la
expresión await en un bloque try y capture la excepción en un bloque catch .

Quite la marca de comentario de la línea throw new Exception en el ejemplo para

demostrar el control de excepciones. La propiedad de la tarea IsFaulted se establece
en True , la propiedad de la tarea Exception.InnerException se establece en la
excepción, y la excepción se captura en el bloque catch .

Quite la marca de comentario de la línea throw new OperationCanceledException para

ver lo que pasa cuando se cancela un proceso asincrónico. La propiedad de la tarea
IsCanceled se establece en true , y la excepción se captura en el bloque catch . En
algunas condiciones que no son aplicables a este ejemplo, la propiedad de la tarea
IsFaulted se establece en true y IsCanceled se establece en false .

C#

public async Task DoSomethingAsync()

Task<string> theTask = DelayAsync();

try

string result = await theTask;

Debug.WriteLine("Result: " + result);

catch (Exception ex)

Debug.WriteLine("Exception Message: " + ex.Message);

Debug.WriteLine("Task IsCanceled: " + theTask.IsCanceled);

Debug.WriteLine("Task IsFaulted: " + theTask.IsFaulted);

if (theTask.Exception != null)

Debug.WriteLine("Task Exception Message: "

+ theTask.Exception.Message);

Debug.WriteLine("Task Inner Exception Message: "

+ theTask.Exception.InnerException.Message);

 private async Task<string> DelayAsync()

await Task.Delay(100);

// Uncomment each of the following lines to

// demonstrate exception handling.

//throw new OperationCanceledException("canceled");

//throw new Exception("Something happened.");

return "Done";

// Output when no exception is thrown in the awaited method:

// Result: Done

// Task IsCanceled: False

// Task IsFaulted: False

// Output when an Exception is thrown in the awaited method:

// Exception Message: Something happened.

// Task IsCanceled: False

// Task IsFaulted: True

// Task Exception Message: One or more errors occurred.

// Task Inner Exception Message: Something happened.

// Output when a OperationCanceledException or TaskCanceledException

// is thrown in the awaited method:

// Exception Message: canceled

// Task IsCanceled: True

// Task IsFaulted: False

Ejemplo de Task.WhenAll
En el ejemplo siguiente se muestra el control de excepciones en el que varias tareas
pueden producir varias excepciones. El bloque try espera la tarea devuelta por una
llamada a Task.WhenAll. La tarea se completa cuando se hayan completado las tres
tareas a las que se aplica el método WhenAll.

Cada una de las tres tareas produce una excepción. El bloque catch se itera a través de
las excepciones, que se encuentran en la propiedad Exception.InnerExceptions de la
tarea devuelta por Task.WhenAll.

C#

public async Task DoMultipleAsync()

Task theTask1 = ExcAsync(info: "First Task");

Task theTask2 = ExcAsync(info: "Second Task");

Task theTask3 = ExcAsync(info: "Third Task");

 Task allTasks = Task.WhenAll(theTask1, theTask2, theTask3);

try

await allTasks;

catch (Exception ex)

Debug.WriteLine("Exception: " + ex.Message);

Debug.WriteLine("Task IsFaulted: " + allTasks.IsFaulted);

foreach (var inEx in allTasks.Exception.InnerExceptions)

Debug.WriteLine("Task Inner Exception: " + inEx.Message);

private async Task ExcAsync(string info)

await Task.Delay(100);

throw new Exception("Error-" + info);

// Output:

// Exception: Error-First Task

// Task IsFaulted: True

// Task Inner Exception: Error-First Task

// Task Inner Exception: Error-Second Task

// Task Inner Exception: Error-Third Task

especificación del lenguaje C#

Para obtener más información, vea la sección sobre la instrucción try de la Especificación
del lenguaje C#.

Vea también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Instrucciones try, throw y catch (C++)
throw
try-finally
Cómo: Iniciar excepciones explícitamente
FirstChanceException
UnhandledException
try-finally (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Mediante el uso de un bloque finally , puede limpiar todos los recursos asignados en
un bloque try y ejecutar código incluso si se produce una excepción en el bloque try .
Normalmente, las instrucciones de un bloque finally se ejecutan cuando el control
abandona una instrucción try . La transferencia de control se puede producir como
resultado de la ejecución normal, de la ejecución de una instrucción break , continue ,
goto o return , o de la propagación de una excepción fuera de la instrucción try .

Dentro de una excepción controlada, se garantiza la ejecución del bloque finally

asociado. Pero en el caso de una excepción no controlada, la ejecución del bloque
finally depende de la manera en que se desencadene la operación de desenredo de la

excepción. Esto, a su vez, depende de cómo esté configurado el equipo. Los únicos
casos en los que no se ejecutan las cláusulas finally implican que un programa se
detenga inmediatamente. Un ejemplo de esto sería cuando se produce
InvalidProgramException debido a que las instrucciones IL están dañadas. En la mayoría
de los sistemas operativos, la limpieza de recursos razonable tendrá lugar como parte
de la detención y descarga del proceso.

Normalmente, cuando una excepción no controlada finaliza una aplicación, no es

importante si el bloque finally se ejecuta o no. Pero si tiene instrucciones en un
bloque finally que debe ejecutarse incluso en esa situación, una solución es agregar
un bloque catch a la instrucción try - finally . Como alternativa, puede capturar la
excepción que se podría producir en el bloque try de una instrucción try - finally más
arriba en la pila de llamadas. Es decir, puede capturar la excepción en el método que
llama al método que contiene la instrucción try - finally , en el método que llama a ese
método o en cualquier método en la pila de llamadas. Si no se captura la excepción, la
ejecución del bloque finally depende de si el sistema operativo decide desencadenar
una operación de desenredo de la excepción.

Ejemplo
En el ejemplo siguiente, una instrucción de conversión no válida provoca una excepción
System.InvalidCastException . Se trata de una excepción no controlada.

C#

public class ThrowTestA

{

 public static void Main()

int i = 123;

string s = "Some string";

object obj = s;

try

// Invalid conversion; obj contains a string, not a numeric

type.

i = (int)obj;

// The following statement is not run.

Console.WriteLine("WriteLine at the end of the try block.");

finally

// To run the program in Visual Studio, type CTRL+F5. Then

// click Cancel in the error dialog.

Console.WriteLine("\nExecution of the finally block after an

unhandled\n" +

"error depends on how the exception unwind operation is

triggered.");

Console.WriteLine("i = {0}", i);

// Output:

// Unhandled Exception: System.InvalidCastException: Specified cast is

not valid.

//

// Execution of the finally block after an unhandled

// error depends on how the exception unwind operation is triggered.

// i = 123

En el ejemplo siguiente, se captura una excepción del método TryCast en un método

más arriba en la pila de llamadas.

C#

public class ThrowTestB

{

public static void Main()

try

// TryCast produces an unhandled exception.

TryCast();

catch (Exception ex)

// Catch the exception that is unhandled in TryCast.

Console.WriteLine

 ("Catching the {0} exception triggers the finally block.",

ex.GetType());

// Restore the original unhandled exception. You might not

// know what exception to expect, or how to handle it, so pass

// it on.

throw;

static void TryCast()

int i = 123;

string s = "Some string";

object obj = s;

try

// Invalid conversion; obj contains a string, not a numeric

type.

i = (int)obj;

// The following statement is not run.

Console.WriteLine("WriteLine at the end of the try block.");

finally

// Report that the finally block is run, and show that the value
of

// i has not been changed.

Console.WriteLine("\nIn the finally block in TryCast, i =

{0}.\n", i);

// Output:

// In the finally block in TryCast, i = 123.

// Catching the System.InvalidCastException exception triggers the

finally block.

// Unhandled Exception: System.InvalidCastException: Specified cast is

not valid.

Para obtener más información sobre finally , vea try-catch-finally.

C# también contiene la instrucción using, que proporciona una función similar para
objetos IDisposable en una sintaxis adecuada.

especificación del lenguaje C#

Para obtener más información, vea la sección sobre la instrucción try de la Especificación
del lenguaje C#.

Vea también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Instrucciones try, throw y catch (C++)
throw
try-catch
Cómo: Iniciar excepciones explícitamente
try-catch-finally (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Un uso habitual de catch y finally juntos es obtener y usar recursos de un bloque

try , lidiar con circunstancias excepcionales de un bloque catch y liberar los recursos

del bloque finally .

Para más información y ejemplos sobre cómo volver a iniciar excepciones, vea try-catch
y Generación de excepciones. Para más información sobre el bloque finally , vea try-
finally.

Ejemplo
C#

public class EHClass

void ReadFile(int index)

// To run this code, substitute a valid path from your local machine

string path = @"c:\users\public\test.txt";

System.IO.StreamReader file = new System.IO.StreamReader(path);

char[] buffer = new char[10];

try

file.ReadBlock(buffer, index, buffer.Length);

catch (System.IO.IOException e)

Console.WriteLine("Error reading from {0}. Message = {1}", path,

e.Message);

finally

if (file != null)

file.Close();

// Do something with buffer...

especificación del lenguaje C#

Para obtener más información, vea la sección sobre la instrucción try de la Especificación
del lenguaje C#.

Vea también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Instrucciones try, throw y catch (C++)
throw
Cómo: Iniciar excepciones explícitamente
using (instrucción)
instrucciones activadas y desactivadas
(referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las checked instrucciones y unchecked especifican el contexto de comprobación de

desbordamiento para las operaciones y conversiones aritméticas de tipo entero. Cuando
se produce un desbordamiento aritmético entero, el contexto de comprobación de
desbordamiento define lo que sucede. En un contexto comprobado, se produce una
System.OverflowException excepción ; si el desbordamiento se produce en una
expresión constante, se produce un error en tiempo de compilación. En un contexto no
comprobado, el resultado de la operación se trunca descartando los bits de orden alto
que no caben en el tipo de destino. Por ejemplo, en el caso de agregarlo, se ajusta del
valor máximo al valor mínimo. En el ejemplo siguiente se muestra la misma operación
en un checked contexto y unchecked :

C#

uint a = uint.MaxValue;

unchecked

Console.WriteLine(a + 1); // output: 0

try

checked

Console.WriteLine(a + 1);

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

７ Nota

El comportamiento de los operadores y conversiones definidos por el usuario en el

caso del desbordamiento del tipo de resultado correspondiente puede diferir del
descrito en el párrafo anterior. En concreto, es posible que los operadores
 comprobados definidos por el usuario no inicien una excepción en un contexto
comprobado.

Para obtener más información, consulte las secciones Sobre desbordamiento y división
aritméticos por cero y Operadores comprobados definidos por el usuario del artículo
Operadores aritméticos .

Para especificar el contexto de comprobación de desbordamiento para una expresión,

también puede usar los checked operadores y unchecked , como se muestra en el
ejemplo siguiente:

C#

double a = double.MaxValue;

int b = unchecked((int)a);

Console.WriteLine(b); // output: -2147483648

try

b = checked((int)a);

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

Las checked instrucciones y operadores y unchecked solo afectan al contexto de

comprobación de desbordamiento para aquellas operaciones que están textualmente
dentro del bloque de instrucciones o los paréntesis del operador, como se muestra en el
ejemplo siguiente:

C#

int Multiply(int a, int b) => a * b;

int factor = 2;

try

checked

Console.WriteLine(Multiply(factor, int.MaxValue)); // output: -2

catch (OverflowException e)

 Console.WriteLine(e.Message);
}

try

checked

Console.WriteLine(Multiply(factor, factor * int.MaxValue));

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

En el ejemplo anterior, la primera invocación de la Multiply función local muestra que

la checked instrucción no afecta al contexto de comprobación de desbordamiento
dentro de la Multiply función, ya que no se produce ninguna excepción. En la segunda
invocación de la Multiply función, la expresión que calcula el segundo argumento de la
función se evalúa en un contexto comprobado y da como resultado una excepción, ya
que está textualmente dentro del bloque de la checked instrucción.

Operaciones afectadas por el contexto de

comprobación de desbordamiento
El contexto de comprobación de desbordamiento afecta a las siguientes operaciones:

Los operadores aritméticos integrados siguientes: operadores unarios ++ , -- , - y

binarios + , - , , * y / , cuando sus operandos son de tipo entero (es decir, tipo
numérico entero o char ) o tipo de enumeración .

Conversiones numéricas explícitas entre tipos enteros o de float o double a un tipo

entero.

７ Nota

Cuando se convierte un valor en un decimal tipo entero y el resultado está

fuera del intervalo del tipo de destino, siempre se inicia , OverflowException
independientemente del contexto de comprobación de desbordamiento.

A partir de C# 11, los operadores y conversiones comprobados definidos por el

usuario. Para obtener más información, consulte la sección Operadores
 comprobados definidos por el usuario del artículo Operadores aritméticos.

Contexto de comprobación de desbordamiento

predeterminado
Si no especifica el contexto de comprobación de desbordamiento, el valor de la opción
del compilador CheckForOverflowUnderflow define el contexto predeterminado para
las expresiones no constantes. De forma predeterminada, el valor de esa opción es
operaciones aritméticas de tipo entero y sin establecer y las conversiones se ejecutan en
un contexto no comprobado .

Las expresiones constantes se evalúan de forma predeterminada en un contexto

comprobado y se produce un error en tiempo de compilación en caso de
desbordamiento. Puede especificar explícitamente un contexto no activado para una
expresión constante con la unchecked instrucción o el operador .

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Instrucciones checked y unchecked

Operadores checked y unchecked
Operadores activados y desactivados definidos por el usuario: C# 11

Vea también
Referencia de C#
Opción del compilador CheckForOverflowUnderflow
instrucciones activadas y desactivadas
(referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las checked instrucciones y unchecked especifican el contexto de comprobación de

desbordamiento para las operaciones y conversiones aritméticas de tipo entero. Cuando
se produce un desbordamiento aritmético entero, el contexto de comprobación de
desbordamiento define lo que sucede. En un contexto comprobado, se produce una
System.OverflowException excepción ; si el desbordamiento se produce en una
expresión constante, se produce un error en tiempo de compilación. En un contexto no
comprobado, el resultado de la operación se trunca descartando los bits de orden alto
que no caben en el tipo de destino. Por ejemplo, en el caso de agregarlo, se ajusta del
valor máximo al valor mínimo. En el ejemplo siguiente se muestra la misma operación
en un checked contexto y unchecked :

C#

uint a = uint.MaxValue;

unchecked

Console.WriteLine(a + 1); // output: 0

try

checked

Console.WriteLine(a + 1);

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

７ Nota

El comportamiento de los operadores y conversiones definidos por el usuario en el

caso del desbordamiento del tipo de resultado correspondiente puede diferir del
descrito en el párrafo anterior. En concreto, es posible que los operadores
 comprobados definidos por el usuario no inicien una excepción en un contexto
comprobado.

Para obtener más información, consulte las secciones Sobre desbordamiento y división
aritméticos por cero y Operadores comprobados definidos por el usuario del artículo
Operadores aritméticos .

Para especificar el contexto de comprobación de desbordamiento para una expresión,

también puede usar los checked operadores y unchecked , como se muestra en el
ejemplo siguiente:

C#

double a = double.MaxValue;

int b = unchecked((int)a);

Console.WriteLine(b); // output: -2147483648

try

b = checked((int)a);

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

Las checked instrucciones y operadores y unchecked solo afectan al contexto de

comprobación de desbordamiento para aquellas operaciones que están textualmente
dentro del bloque de instrucciones o los paréntesis del operador, como se muestra en el
ejemplo siguiente:

C#

int Multiply(int a, int b) => a * b;

int factor = 2;

try

checked

Console.WriteLine(Multiply(factor, int.MaxValue)); // output: -2

catch (OverflowException e)

 Console.WriteLine(e.Message);
}

try

checked

Console.WriteLine(Multiply(factor, factor * int.MaxValue));

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

En el ejemplo anterior, la primera invocación de la Multiply función local muestra que

la checked instrucción no afecta al contexto de comprobación de desbordamiento
dentro de la Multiply función, ya que no se produce ninguna excepción. En la segunda
invocación de la Multiply función, la expresión que calcula el segundo argumento de la
función se evalúa en un contexto comprobado y da como resultado una excepción, ya
que está textualmente dentro del bloque de la checked instrucción.

Operaciones afectadas por el contexto de

comprobación de desbordamiento
El contexto de comprobación de desbordamiento afecta a las siguientes operaciones:

Los operadores aritméticos integrados siguientes: operadores unarios ++ , -- , - y

binarios + , - , , * y / , cuando sus operandos son de tipo entero (es decir, tipo
numérico entero o char ) o tipo de enumeración .

Conversiones numéricas explícitas entre tipos enteros o de float o double a un tipo

entero.

７ Nota

Cuando se convierte un valor en un decimal tipo entero y el resultado está

fuera del intervalo del tipo de destino, siempre se inicia , OverflowException
independientemente del contexto de comprobación de desbordamiento.

A partir de C# 11, los operadores y conversiones comprobados definidos por el

usuario. Para obtener más información, consulte la sección Operadores
 comprobados definidos por el usuario del artículo Operadores aritméticos.

Contexto de comprobación de desbordamiento

predeterminado
Si no especifica el contexto de comprobación de desbordamiento, el valor de la opción
del compilador CheckForOverflowUnderflow define el contexto predeterminado para
las expresiones no constantes. De forma predeterminada, el valor de esa opción es
operaciones aritméticas de tipo entero y sin establecer y las conversiones se ejecutan en
un contexto no comprobado .

Las expresiones constantes se evalúan de forma predeterminada en un contexto

comprobado y se produce un error en tiempo de compilación en caso de
desbordamiento. Puede especificar explícitamente un contexto no activado para una
expresión constante con la unchecked instrucción o el operador .

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Instrucciones checked y unchecked

Operadores checked y unchecked
Operadores activados y desactivados definidos por el usuario: C# 11

Vea también
Referencia de C#
Opción del compilador CheckForOverflowUnderflow
instrucciones activadas y desactivadas
(referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

Las checked instrucciones y unchecked especifican el contexto de comprobación de

desbordamiento para las operaciones y conversiones aritméticas de tipo entero. Cuando
se produce un desbordamiento aritmético entero, el contexto de comprobación de
desbordamiento define lo que sucede. En un contexto comprobado, se produce una
System.OverflowException excepción ; si el desbordamiento se produce en una
expresión constante, se produce un error en tiempo de compilación. En un contexto no
comprobado, el resultado de la operación se trunca descartando los bits de orden alto
que no caben en el tipo de destino. Por ejemplo, en el caso de agregarlo, se ajusta del
valor máximo al valor mínimo. En el ejemplo siguiente se muestra la misma operación
en un checked contexto y unchecked :

C#

uint a = uint.MaxValue;

unchecked

Console.WriteLine(a + 1); // output: 0

try

checked

Console.WriteLine(a + 1);

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

７ Nota

El comportamiento de los operadores y conversiones definidos por el usuario en el

caso del desbordamiento del tipo de resultado correspondiente puede diferir del
descrito en el párrafo anterior. En concreto, es posible que los operadores
 comprobados definidos por el usuario no inicien una excepción en un contexto
comprobado.

Para obtener más información, consulte las secciones Sobre desbordamiento y división
aritméticos por cero y Operadores comprobados definidos por el usuario del artículo
Operadores aritméticos .

Para especificar el contexto de comprobación de desbordamiento para una expresión,

también puede usar los checked operadores y unchecked , como se muestra en el
ejemplo siguiente:

C#

double a = double.MaxValue;

int b = unchecked((int)a);

Console.WriteLine(b); // output: -2147483648

try

b = checked((int)a);

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

Las checked instrucciones y operadores y unchecked solo afectan al contexto de

comprobación de desbordamiento para aquellas operaciones que están textualmente
dentro del bloque de instrucciones o los paréntesis del operador, como se muestra en el
ejemplo siguiente:

C#

int Multiply(int a, int b) => a * b;

int factor = 2;

try

checked

Console.WriteLine(Multiply(factor, int.MaxValue)); // output: -2

catch (OverflowException e)

 Console.WriteLine(e.Message);
}

try

checked

Console.WriteLine(Multiply(factor, factor * int.MaxValue));

catch (OverflowException e)

Console.WriteLine(e.Message); // output: Arithmetic operation resulted

in an overflow.

En el ejemplo anterior, la primera invocación de la Multiply función local muestra que

la checked instrucción no afecta al contexto de comprobación de desbordamiento
dentro de la Multiply función, ya que no se produce ninguna excepción. En la segunda
invocación de la Multiply función, la expresión que calcula el segundo argumento de la
función se evalúa en un contexto comprobado y da como resultado una excepción, ya
que está textualmente dentro del bloque de la checked instrucción.

Operaciones afectadas por el contexto de

comprobación de desbordamiento
El contexto de comprobación de desbordamiento afecta a las siguientes operaciones:

Los operadores aritméticos integrados siguientes: operadores unarios ++ , -- , - y

binarios + , - , , * y / , cuando sus operandos son de tipo entero (es decir, tipo
numérico entero o char ) o tipo de enumeración .

Conversiones numéricas explícitas entre tipos enteros o de float o double a un tipo

entero.

７ Nota

Cuando se convierte un valor en un decimal tipo entero y el resultado está

fuera del intervalo del tipo de destino, siempre se inicia , OverflowException
independientemente del contexto de comprobación de desbordamiento.

A partir de C# 11, los operadores y conversiones comprobados definidos por el

usuario. Para obtener más información, consulte la sección Operadores
 comprobados definidos por el usuario del artículo Operadores aritméticos.

Contexto de comprobación de desbordamiento

predeterminado
Si no especifica el contexto de comprobación de desbordamiento, el valor de la opción
del compilador CheckForOverflowUnderflow define el contexto predeterminado para
las expresiones no constantes. De forma predeterminada, el valor de esa opción es
operaciones aritméticas de tipo entero y sin establecer y las conversiones se ejecutan en
un contexto no comprobado .

Las expresiones constantes se evalúan de forma predeterminada en un contexto

comprobado y se produce un error en tiempo de compilación en caso de
desbordamiento. Puede especificar explícitamente un contexto no activado para una
expresión constante con la unchecked instrucción o el operador .

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Instrucciones checked y unchecked

Operadores checked y unchecked
Operadores activados y desactivados definidos por el usuario: C# 11

Vea también
Referencia de C#
Opción del compilador CheckForOverflowUnderflow
instrucción fija: acceso seguro a la
memoria subyacente a una variable
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La fixed instrucción impide que el recolector de elementos no utilizados reubique una

variable desplazable y declare un puntero a esa variable. La dirección de una variable fija
o anclada no cambia durante la ejecución de la instrucción . Puede usar el puntero
declarado solo dentro de la instrucción correspondiente fixed . El puntero declarado es
de solo lectura y no se puede modificar:

C#

unsafe

byte[] bytes = { 1, 2, 3 };

fixed (byte* pointerToFirst = bytes)

Console.WriteLine($"The address of the first array element:

{(long)pointerToFirst:X}.");

Console.WriteLine($"The value of the first array element:

{*pointerToFirst}.");

// Output is similar to:

// The address of the first array element: 2173F80B5C8.

// The value of the first array element: 1.

７ Nota

Puede usar la fixed instrucción solo en un contexto no seguro . El código que

contenga bloques no seguros se tendrá que compilar con la opción del compilador
AllowUnsafeBlocks.

Puede inicializar el puntero declarado de la siguiente manera:

Con una matriz, como se muestra en el ejemplo al principio de este artículo. El

puntero inicializado contiene la dirección del primer elemento de matriz.

Con una dirección de una variable. Use el operador address-of&, como se muestra
en el ejemplo siguiente:

C#
 unsafe

int[] numbers = { 10, 20, 30 };

fixed (int* toFirst = &numbers[0], toLast = &numbers[^1])

Console.WriteLine(toLast - toFirst); // output: 2

Los campos de objeto son otro ejemplo de variables que se pueden anclar.

Cuando el puntero inicializado contiene la dirección de un campo de objeto o un

elemento de matriz, la fixed instrucción garantiza que el recolector de elementos
no utilizados no reubica ni elimina la instancia de objeto contenedora durante la
ejecución del cuerpo de la instrucción.

Con la instancia del tipo que implementa un método denominado

GetPinnableReference . Ese método debe devolver una ref variable de un tipo no

administrado. Los tipos System.Span<T> de .NET y System.ReadOnlySpan<T>

usan este patrón. Puede anclar instancias de intervalo, como se muestra en el
ejemplo siguiente:

C#

unsafe

int[] numbers = { 10, 20, 30, 40, 50 };

Span<int> interior = numbers.AsSpan()[1..^1];

fixed (int* p = interior)

for (int i = 0; i < interior.Length; i++)

Console.Write(p[i]);

// output: 203040

Para más información, vea la referencia de API Span<T>.GetPinnableReference().

Con una cadena, como se muestra en el ejemplo siguiente:

C#

unsafe

var message = "Hello!";

 fixed (char* p = message)

Console.WriteLine(*p); // output: H

Con un búfer de tamaño fijo.

Puede asignar memoria en la pila, donde no está sujeta a la recolección de elementos

no utilizados y, por tanto, no es necesario anclarla. Para ello, use una expresión
stackalloc.

También puede usar la fixed palabra clave para declarar un búfer de tamaño fijo.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

fixed (instrucción)
Variables fijas y móviles

Para obtener información sobre la instrucción basada en patrones, vea la nota de

propuesta de característica de declaración basada en fixed fixed patrones.

Vea también
Referencia de C#
Código no seguro, tipos de puntero y punteros de función
Operadores relacionados con el puntero
unsafe
Parámetros de métodos (Referencia de
C#)
Artículo • 18/02/2023 • Tiempo de lectura: 10 minutos

En C#, los argumentos se pueden pasar a parámetros por valor o por referencia.
Recuerde que los tipos de C# pueden ser tipos de referencia ( class ) o tipos de valor
( struct ):

Pasar por valor significa pasar una copia de la variable al método.

Pasar por referencia significa pasar el acceso a la variable al método.
Una variable de un tipo de referencia contiene una referencia a sus datos.
Una variable de un tipo de valor contiene sus datos directamente.

Como un struct es un tipo de valor, cuando pasa un struct mediante valor a un método,
el método recibe y funciona en una copia del argumento struct. El método no tiene
acceso al struct original en el método de llamada y, por lo tanto, no puede cambiarlo de
ninguna manera. El método solo puede cambiar la copia.

Una instancia de clase es un tipo de referencia, no un tipo de valor. Cuando un tipo de

referencia se pasa mediante valor a un método, el método recibe una copia de la
referencia a la instancia de clase. Es decir, el método al que se llama recibe una copia de
la dirección de la instancia y el método de llamada conserva la dirección original de la
instancia. La instancia de clase en el método de llamada tiene una dirección, el
parámetro en el método que se ha llamado tiene una copia de la dirección, y ambas
direcciones hacen referencia al mismo objeto. Como el parámetro solo contiene una
copia de la dirección, el método al que se ha llamado no puede cambiar la dirección de
la instancia de clase en el método de llamada. En cambio, el método al que se ha
llamado puede usar la copia de la dirección para acceder a los miembros de clase a los
que hacen referencia la dirección original y la copia de la dirección. Si el método al que
se ha llamado cambia un miembro de clase, la instancia de clase original en el método
de llamada también cambia.

En el resultado del ejemplo siguiente se ilustra la diferencia. El valor del campo

willIChange de la instancia de clase se cambia mediante la llamada al método
ClassTaker porque el método usa la dirección en el parámetro para buscar el campo

especificado de la instancia de clase. El campo willIChange del struct en el método de

llamada no se cambia mediante la llamada al método StructTaker porque el valor del
argumento es una copia del propio struct, no una copia de su dirección. StructTaker
cambia la copia, y la copia se pierde cuando se completa la llamada a StructTaker .
 C#

class TheClass

public string? willIChange;

struct TheStruct

public string willIChange;

class TestClassAndStruct

static void ClassTaker(TheClass c)

c.willIChange = "Changed";

static void StructTaker(TheStruct s)

s.willIChange = "Changed";

public static void Main()

TheClass testClass = new TheClass();

TheStruct testStruct = new TheStruct();

testClass.willIChange = "Not Changed";

testStruct.willIChange = "Not Changed";

ClassTaker(testClass);

StructTaker(testStruct);

Console.WriteLine("Class field = {0}", testClass.willIChange);

Console.WriteLine("Struct field = {0}", testStruct.willIChange);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Class field = Changed

Struct field = Not Changed

*/

Cómo se pasa un argumento y si es un tipo de referencia o un tipo de valor controla

qué modificaciones realizadas en el argumento son visibles desde el autor de la llamada.
Pasar un tipo de valor por valor
Cuando se pasa un tipo de valorpor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios no son visibles desde el autor de la llamada.

En el ejemplo siguiente se muestra cómo pasar los parámetros de tipo de valor en

función del valor. La variable n se pasa en función del valor al método SquareIt . Los
cambios que tienen lugar dentro del método no tienen ningún efecto en el valor
original de la variable.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(n); // Passing the variable by value.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(int x)

// The parameter x is passed by value.

// Changes to x will not affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 5

*/

La variable n es un tipo de valor. Contiene sus datos, el valor 5 . Cuando se invoca

SquareIt , el contenido de n se copia en el parámetro x , que se multiplica dentro del

método. En Main , sin embargo, el valor de n es el mismo después de llamar al

método SquareIt que el que era antes. El cambio que tiene lugar dentro del método
solo afecta a la variable local x .

Pasar un tipo de valor por referencia

Cuando se pasa un tipo de valorpor referencia:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que el argumento se pasa como
un parámetro ref . El valor del argumento subyacente, n , se cambia cuando se modifica
x en el método.

C#

int n = 5;

System.Console.WriteLine("The value before calling the method: {0}", n);

SquareIt(ref n); // Passing the variable by reference.

System.Console.WriteLine("The value after calling the method: {0}", n);

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

static void SquareIt(ref int x)

// The parameter x is passed by reference.

// Changes to x will affect the original value of x.

x *= x;

System.Console.WriteLine("The value inside the method: {0}", x);

/* Output:

The value before calling the method: 5

The value inside the method: 25

The value after calling the method: 25

*/

En este ejemplo, no es el valor de n el que se pasa, sino una referencia a n . El

parámetro x no es un entero; se trata de una referencia a int , en este caso, una
referencia a n . Por tanto, cuando x se multiplica dentro del método, lo que realmente
se multiplica es a lo que x hace referencia, n .

Pasar un tipo de referencia por valor

Cuando se pasa un tipo de referenciapor valor:

Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
no son visibles desde el autor de la llamada.
 Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

En el ejemplo siguiente, se muestra cómo pasar un parámetro de tipo de referencia,

arr , en función del valor a un método, Change . Dado que el parámetro es una
referencia a arr , es posible cambiar los valores de los elementos de matriz. En cambio,
el intento de volver a asignar el parámetro a otra ubicación de memoria solo funciona
dentro del método y no afecta a la variable original, arr .

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(int[] pArray)

pArray[0] = 888; // This change affects the original element.

pArray = new int[5] { -3, -1, -2, -3, -4 }; // This change is local.

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: 888

*/

En el ejemplo anterior, la matriz, arr , que es un tipo de referencia, se pasa al método

sin el parámetro ref . En tal caso, se pasa al método una copia de la referencia, que
apunta a arr . El resultado muestra que es posible que el método cambie el contenido
de un elemento de matriz, en este caso de 1 a 888 . En cambio, si se asigna una nueva
porción de memoria al usar el operador new dentro del método Change , la variable
pArray hace referencia a una nueva matriz. Por tanto, cualquier cambio que hubiese
después no afectará a la matriz original, arr , que se ha creado dentro de Main . De
hecho, se crean dos matrices en este ejemplo, una dentro de Main y otra dentro del
método Change .

Pasar un tipo de referencia por referencia

Cuando se pasa un tipo de referenciapor referencia:
 Si el método asigna el parámetro para hacer referencia a otro objeto, esos cambios
son visibles desde el autor de la llamada.
Si el método modifica el estado del objeto al que hace referencia el parámetro,
esos cambios son visibles desde el autor de la llamada.

El ejemplo siguiente es el mismo que el anterior, salvo que la palabra clave ref se
agrega a la llamada y al encabezado de método. Los cambios que tengan lugar en el
método afectan a la variable original en el programa que realiza la llamada.

C#

int[] arr = { 1, 4, 5 };

System.Console.WriteLine("Inside Main, before calling the method, the first

element is: {0}", arr[0]);

Change(ref arr);

System.Console.WriteLine("Inside Main, after calling the method, the first

element is: {0}", arr[0]);

static void Change(ref int[] pArray)

// Both of the following changes will affect the original variables:

pArray[0] = 888;

pArray = new int[5] { -3, -1, -2, -3, -4 };

System.Console.WriteLine("Inside the method, the first element is: {0}",

pArray[0]);

/* Output:

Inside Main, before calling the method, the first element is: 1

Inside the method, the first element is: -3

Inside Main, after calling the method, the first element is: -3

*/

Todos los cambios que tienen lugar dentro del método afectan a la matriz original en
Main . De hecho, la matriz original se reasigna mediante el operador new . Por tanto,

después de llamar al método Change , cualquier referencia a arr apunta a la matriz de

cinco elementos, que se crea en el método Change .

Ámbito de las referencias y los valores

Los métodos pueden almacenar los valores de los parámetros en campos. Cuando los
parámetros se pasan por valor, siempre es seguro. Los valores se copian y se puede
acceder a los tipos de referencia cuando se almacenan en un campo. Pasar parámetros
por referencia de forma segura requiere que el compilador defina cuándo es seguro
asignar una referencia a una nueva variable. Para cada expresión, el compilador define
un ámbito que enlaza el acceso a una expresión o una variable. El compilador usa dos
ámbitos: safe_to_escape y ref_safe_to_escape.

El ámbito safe_to_escape define el ámbito en el que se puede acceder de forma

segura a cualquier expresión.
El ámbito ref_safe_to_escape define el ámbito en el que se puede acceder o
modificar de forma segura una referencia a cualquier expresión.

Informalmente, puede considerar estos ámbitos como un mecanismo para asegurarse

de que el código nunca accede o modifica una referencia que ya no es válida. Una
referencia es válida siempre que haga referencia a un objeto o estructura válidos. El
ámbito safe_to_escape define cuándo se puede asignar o reasignar una variable. El
ámbito ref_safe_to_escape define cuándo una variable se puede asignar ref o reasignar
ref. La asignación asigna una variable a un nuevo valor; la asignación por referencia
asigna la variable para hacer referencia a otra ubicación de almacenamiento.

Modificadores
Los parámetros declarados para un método sin in, ref o out se pasan al método llamado
por valor. Los modificadores ref , in y out difieren en las reglas de asignación:

El argumento de un parámetro ref se debe asignar definitivamente. El método

llamado puede reasignar ese parámetro.
El argumento de un parámetro in se debe asignar definitivamente. El método
llamado no puede reasignar ese parámetro.
No es necesario asignar definitivamente el argumento de un parámetro out . El
método llamado debe asignar el parámetro.

Esta sección describe las palabras clave que puede usar para declarar parámetros de
métodos:

params especifica que este parámetro puede tomar un número variable de

argumentos.
in especifica que este parámetro se pasa por referencia, pero solo se lee mediante
el método llamado.
ref especifica que este parámetro se pasa por referencia y puede ser leído o escrito
por el método llamado.
out especifica que este parámetro se pasa por referencia y se escribe mediante el
método llamado.

Vea también
Referencia de C#
Palabras clave de C#
Listas de argumentos en la especificación del lenguaje C#. La especificación del
lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
params (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Mediante el uso de la palabra clave params , puede especificar un parámetro de método

que toma un número variable de argumentos. El tipo de parámetro debe ser una matriz
unidimensional.

No se permiten parámetros adicionales después de la palabra clave params en una

declaración de método, y solo se permite una palabra clave params en una declaración
de método.

Si el tipo declarado del parámetro params no es una matriz unidimensional, se produce

el error CS0225 del compilador.

Cuando se llama a un método con un parámetro params , se puede pasar:

Una lista separada por comas de argumentos del tipo de los elementos de la
matriz.
Una matriz de argumentos del tipo especificado.
Sin argumentos. Si no envía ningún argumento, la longitud de la lista params es
cero.

Ejemplo
En el ejemplo siguiente se muestran varias maneras de enviar argumentos a un
parámetro params .

C#

public class MyClass

public static void UseParams(params int[] list)

for (int i = 0; i < list.Length; i++)

Console.Write(list[i] + " ");

Console.WriteLine();

public static void UseParams2(params object[] list)

for (int i = 0; i < list.Length; i++)

Console.Write(list[i] + " ");

Console.WriteLine();

static void Main()

// You can send a comma-separated list of arguments of the

// specified type.

UseParams(1, 2, 3, 4);

UseParams2(1, 'a', "test");

// A params parameter accepts zero or more arguments.

// The following calling statement displays only a blank line.

UseParams2();

// An array argument can be passed, as long as the array

// type matches the parameter type of the method being called.

int[] myIntArray = { 5, 6, 7, 8, 9 };

UseParams(myIntArray);

object[] myObjArray = { 2, 'b', "test", "again" };

UseParams2(myObjArray);

// The following call causes a compiler error because the object

// array cannot be converted into an integer array.

//UseParams(myObjArray);

// The following call does not cause an error, but the entire

// integer array becomes the first element of the params array.

UseParams2(myIntArray);

/*

Output:

1 2 3 4

1 a test

5 6 7 8 9

2 b test again

System.Int32[]

*/

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Parámetros de métodos
Modificador del parámetro in
(referencia de C#)
Artículo • 05/10/2022 • Tiempo de lectura: 5 minutos

La palabra clave in hace que los argumentos se pasen por referencia pero garantiza
que el argumento no se modifica. Hace que el parámetro formal sea un alias para el
argumento, que debe ser una variable. En otras palabras, cualquier operación en el
parámetro se realiza en el argumento. Es como las palabras clave ref o out, salvo que el
método al que se llama no puede modificar los argumentos in . Mientras que los
argumentos ref se pueden modificar, el método llamado debe modificar los
argumentos out y esas modificaciones se pueden observar en el contexto de la llamada.

C#

int readonlyArgument = 44;

InArgExample(readonlyArgument);

Console.WriteLine(readonlyArgument); // value is still 44

void InArgExample(in int number)

// Uncomment the following line to see error CS8331

//number = 19;

En el ejemplo anterior se muestra que el modificador in no suele ser necesario en el

sitio de llamada, sino que solo lo es en la declaración del método.

７ Nota

Además, la palabra clave in puede usarse con un parámetro de tipo genérico para
especificar que el parámetro de tipo es contravariante, parte de una instrucción
foreach o de una cláusula join de una consulta de LINQ. Para más información
sobre el uso de la palabra clave in en esos contextos, vea in, que además incluye
vínculos a todos estos usos.

Las variables que se han pasado como argumentos in deben inicializarse antes de
pasarse en una llamada de método. Sin embargo, es posible que el método llamado no
asigne ningún valor o modifique el argumento.

Aunque los modificadores de parámetro in , out y ref se consideran parte de una

firma, los miembros declarados en un único tipo no pueden diferir en la firma
únicamente por in , ref y out . Por lo tanto, los métodos no pueden sobrecargarse si la
única diferencia es que un método toma un argumento ref o out y el otro toma un
argumento in . Por ejemplo, el código siguiente, no se compilará:

C#

class CS0663_Example

// Compiler error CS0663: "Cannot define overloaded

// methods that differ only on in, ref and out".

public void SampleMethod(in int i) { }

public void SampleMethod(ref int i) { }

Está permitida la sobrecarga en función de la presencia de in :

C#

class InOverloads

public void SampleMethod(in int i) { }

public void SampleMethod(int i) { }

Reglas de resolución de sobrecarga

Puede comprender las reglas de resolución de sobrecarga de métodos por valor frente
a argumentos in mediante la comprensión de la motivación de argumentos in . Definir
métodos usando parámetros in es una optimización del rendimiento potencial.
Algunos argumentos de tipo struct pueden tener un gran tamaño y, cuando se llama a
métodos en bucles de pequeñas dimensiones o rutas de acceso de código crítico, el
costo de copiar esas estructuras resulta crucial. Los métodos declaran parámetros in
para especificar qué argumentos pueden pasarse por referencia sin ningún riesgo
porque el método llamado no modifica el estado de ese argumento. Al pasar esos
argumentos por referencia se evita la copia (potencialmente) costosa.

Especificar in en argumentos en el sitio de llamada suele ser opcional. No hay ninguna

diferencia semántica entre pasar argumentos por valor y pasarlos por referencia
mediante el modificador in . El modificador in en el sitio de llamada es opcional
porque no es necesario indicar que podría cambiarse el valor del argumento. Se agrega
explícitamente el modificador in en el sitio de llamada para garantizar que el
argumento se pasa por referencia, y no por valor. Usar explícitamente in tiene los dos
efectos siguientes:
El primero es que, al especificar in en el sitio de llamada, se fuerza al compilador a
seleccionar un método definido con un parámetro in coincidente. En caso contrario,
cuando dos métodos se diferencian solo en presencia de in , la sobrecarga por valor es
una coincidencia mejor.

El segundo es que, al especificar in declara su intención para pasar un argumento por

referencia. Los argumentos usados con in deben representar una ubicación a la que se
pueda hacer referencia directamente. Se aplican las mismas reglas generales para los
argumentos out y ref : no se pueden usar constantes, propiedades normales u otras
expresiones que produzcan valores. En caso contrario, si se omite in en el sitio de
llamada, se informa al compilador de que le permitirá crear una variable temporal para
pasar por referencia de solo lectura para el método. El compilador crea una variable
temporal para superar varias restricciones con argumentos in :

Una variable temporal permite constantes en tiempo de compilación como

parámetros in .
Una variable temporal permite propiedades u otras expresiones para parámetros
in .

Una variable temporal permite argumentos en los que hay una conversión
implícita desde el tipo de argumento hacia el tipo de parámetro.

En todas las instancias anteriores, el compilador crea una variable temporal que
almacena el valor de la constante, la propiedad u otra expresión.

Estas reglas se muestran en este código:

C#

static void Method(in int argument)

// implementation removed

Method(5); // OK, temporary variable created.

Method(5L); // CS1503: no implicit conversion from long to int

short s = 0;

Method(s); // OK, temporary int created with the value 0

Method(in s); // CS1503: cannot convert from in short to in int

int i = 42;

Method(i); // passed by readonly reference

Method(in i); // passed by readonly reference, explicitly using `in`

Supongamos ahora que hay disponible otro método que usa argumentos por valor. Los
resultados cambian como se muestra en este código:
 C#

static void Method(int argument)

// implementation removed

static void Method(in int argument)

// implementation removed

Method(5); // Calls overload passed by value

Method(5L); // CS1503: no implicit conversion from long to int

short s = 0;

Method(s); // Calls overload passed by value.

Method(in s); // CS1503: cannot convert from in short to in int

int i = 42;

Method(i); // Calls overload passed by value

Method(in i); // passed by readonly reference, explicitly using `in`

La única llamada de método donde se pasa el argumento por referencia es la última.

７ Nota

El código anterior usa int como el tipo de argumento para simplificar el trabajo.
Como int no es más grande que una referencia en la mayoría de máquinas
modernas, no supone ninguna ventaja pasar un único int como una referencia de
solo lectura.

Limitaciones de los parámetros in

Las palabras clave in , ref y out no pueden usarse para estos tipos de métodos:

Métodos asincrónicos, que se definen mediante el uso del modificador async.

Métodos de iterador, que incluyen una instrucción yield return o yield break .
El primer argumento de un método de extensión no puede tener el modificador
in a menos que ese argumento sea una estructura.

El primer argumento de un método de extensión donde el argumento es un tipo

genérico (incluso si el tipo está restringido para ser una estructura).

Puede obtener más información sobre el modificador in y sobre cómo difiere de ref y
out en el artículo sobre Escritura de código eficaz y seguro.
Especificación del lenguaje C#
Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
ref (Referencia de C#)
Artículo • 18/02/2023 • Tiempo de lectura: 10 minutos

La palabra clave ref indica que una variable es una referencia o un alias de otro
proyecto. Se usa en cinco contextos diferentes:

En una firma del método y en una llamada al método, para pasar un argumento a
un método mediante referencia. Para más información, vea Pasar un argumento
mediante referencia.
En una firma del método, para devolver un valor al autor de la llamada mediante
referencia. Para obtener más información, consulte Valores devueltos de referencia.
En un cuerpo de miembro, para indicar que un valor devuelto de referencia se
almacena localmente como una referencia que el autor de la llamada pretende
modificar. O para indicar que una variable local tiene acceso a otro valor por
referencia. Para más información, vea Variables locales de tipo ref.
En una declaración struct , para declarar ref struct o readonly ref struct . Para
obtener más información, vea el artículo ref struct.
En una declaración ref struct , para declarar que un campo es una referencia.
Consulte el artículo sobre el ref campo.

Pasar un argumento mediante referencia

Cuando se usa en una lista de parámetros del método, la palabra clave ref indica que
un argumento se ha pasado mediante referencia, no por valor. La palabra clave ref
hace que el parámetro formal sea un alias para el argumento, que debe ser una variable.
En otras palabras, cualquier operación en el parámetro se realiza en el argumento.

Por ejemplo, supongamos que el autor de la llamada pasa una expresión de variable
local o una expresión de acceso a un elemento de matriz. El método al que se llama
puede reemplazar el objeto al que hace referencia el parámetro ref. En ese caso, la
variable local del autor de la llamada o el elemento de matriz hace referencia al nuevo
objeto en la devolución del método.

７ Nota

No confunda el concepto de pasar por referencia con el concepto de tipos de

referencia. Estos dos conceptos no son lo mismo. Un parámetro de método puede
ser modificado por ref independientemente de si se trata de un tipo de valor o de
un tipo de referencia. No hay ninguna conversión boxing de un tipo de valor
cuando se pasa por referencia.
Para usar un parámetro ref , la definición de método y el método de llamada deben
utilizar explícitamente la palabra clave ref , como se muestra en el ejemplo siguiente.
(Salvo que el método de llamada puede omitir ref al realizar una llamada COM).

C#

void Method(ref int refArgument)

refArgument = refArgument + 44;

int number = 1;

Method(ref number);

Console.WriteLine(number);

// Output: 45

Un argumento que se pasa a un parámetro ref o in debe inicializarse antes de pasarse.

Este requisito es diferente a los parámetros out, cuyos argumentos no tienen que
inicializarse explícitamente antes de pasarse.

Los miembros de una clase no pueden tener signaturas que se diferencien solo por ref ,
in o out . Si la única diferencia entre dos miembros de un tipo es que uno de ellos tiene

un parámetro ref y el otro tiene un parámetro out o in , se produce un error de

compilador. El código siguiente, por ejemplo, no se compila.

C#

class CS0663_Example

// Compiler error CS0663: "Cannot define overloaded

// methods that differ only on ref and out".

public void SampleMethod(out int i) { }

public void SampleMethod(ref int i) { }

En cambio, los métodos pueden sobrecargarse cuando un método tiene un parámetro

ref , in o out y el otro tiene un parámetro que se pasa por valor, como se muestra en

el ejemplo siguiente.

C#

class RefOverloadExample

public void SampleMethod(int i) { }

 public void SampleMethod(ref int i) { }

En otras situaciones que requieran firma coincidente, como ocultar o reemplazar, in ,

ref y out forman parte de la signatura y no coinciden entre sí.

Las propiedades no son variables. Son métodos y no se pueden pasar a parámetros ref .

Las palabras clave ref , in y out no pueden usarse para estos tipos de métodos:

Métodos asincrónicos, que se definen mediante el uso del modificador async.

Métodos de iterador, que incluyen una instrucción yield return o yield break .

Los métodos de extensión también tienen restricciones en el uso de estas palabras

clave:

No se puede usar la palabra clave out en el primer argumento de un método de

extensión.
No se puede usar la palabra clave ref en el primer argumento de un método de
extensión cuando el argumento no es un struct ni un tipo genérico no restringido
para ser un struct.
No se puede usar la palabra clave in a menos que el primer argumento sea un
struct. No se puede usar la palabra clave in en ningún tipo genérico, incluso
cuando está restringido para ser un struct.

Paso de un argumento mediante referencia: Un

ejemplo
En los ejemplos anteriores se pasan tipos de valor mediante referencia. También se
puede usar la palabra clave ref para pasar tipos de referencia mediante referencia.
Pasar un tipo de referencia por referencia permite que el método llamado pueda
reemplazar el objeto al que hace referencia el parámetro de referencia en el autor de la
llamada. La ubicación de almacenamiento del objeto se pasa al método como el valor
del parámetro de referencia. Si cambia el valor de la ubicación de almacenamiento del
parámetro (para que apunte a un nuevo objeto), también debe cambiar la ubicación de
almacenamiento a la que se refiere el autor de la llamada. En el ejemplo siguiente se
pasa una instancia de un tipo de referencia como un parámetro ref .

C#

class Product

 public Product(string name, int newID)

ItemName = name;

ItemID = newID;

public string ItemName { get; set; }

public int ItemID { get; set; }

private static void ChangeByReference(ref Product itemRef)

// Change the address that is stored in the itemRef parameter.

itemRef = new Product("Stapler", 99999);

// You can change the value of one of the properties of

// itemRef. The change happens to item in Main as well.

itemRef.ItemID = 12345;

private static void ModifyProductsByReference()

// Declare an instance of Product and display its initial values.

Product item = new Product("Fasteners", 54321);

System.Console.WriteLine("Original values in Main. Name: {0}, ID:

{1}\n",

item.ItemName, item.ItemID);

// Pass the product instance to ChangeByReference.

ChangeByReference(ref item);

System.Console.WriteLine("Back in Main. Name: {0}, ID: {1}\n",

item.ItemName, item.ItemID);

// This method displays the following output:

// Original values in Main. Name: Fasteners, ID: 54321

// Back in Main. Name: Stapler, ID: 12345

Para obtener más información sobre cómo pasar tipos de referencia por valor y por
referencia, vea Pasar parámetros Reference-Type .

Valores devueltos de referencia

Los valores devueltos de referencia (o valores devueltos de tipo ref) son valores que
devuelve un método mediante referencia al autor de la llamada. Es decir, el autor de la
llamada puede modificar el valor devuelto por un método, y ese cambio se refleja en el
estado del objeto del método al que se ha llamado.

Un valor devuelto de referencia se define mediante la palabra clave ref :

 En la firma del método. Por ejemplo, en la firma de método siguiente se indica que
el método GetCurrentPrice devuelve un valor Decimal por referencia.

C#

public ref decimal GetCurrentPrice()

Entre el token return y la variable devuelta en una instrucción return en el

método. Por ejemplo:

C#

return ref DecimalArray[0];

Para que el autor de la llamada modifique el estado del objeto, el valor devuelto de
referencia debe almacenarse en una variable que se defina explícitamente como una
variable local de tipo ref.

Este es un ejemplo de valor devuelto de referencia más completo que muestra la firma y
el cuerpo del método.

C#

public static ref int Find(int[,] matrix, Func<int, bool> predicate)

for (int i = 0; i < matrix.GetLength(0); i++)

for (int j = 0; j < matrix.GetLength(1); j++)

if (predicate(matrix[i, j]))

return ref matrix[i, j];

throw new InvalidOperationException("Not found");

El método llamado también puede declarar el valor devuelto como ref readonly para
devolver el valor por referencia y exigir que el código de llamada no pueda modificar el
valor devuelto. El método de llamada puede evitar copiar el valor devuelto si lo
almacena en una variable de tipo ref readonly.

Para obtener un ejemplo, vea Un ejemplo de valores devueltos y variables locales de

tipo ref.

Variables locales de tipo ref

Una variable local de tipo ref se usa para hacer referencia a valores devueltos con
return ref . Una variable local ref no se puede inicializar en un valor devuelto que no
sea ref. Es decir, el lado derecho de la inicialización debe ser una referencia. Cualquier
modificación en el valor de la variable local de tipo ref se refleja en el estado del objeto
cuyo método ha devuelto el valor mediante referencia.

Puede definir un valor ref local mediante la palabra clave ref en dos lugares:

Antes de la declaración de variable.

Inmediatamente antes de la llamada al método que devuelve el valor por
referencia.

Por ejemplo, en la siguiente instrucción se define un valor de variable local de tipo ref
que se devuelve mediante un método denominado GetEstimatedValue :

C#

ref decimal estValue = ref Building.GetEstimatedValue();

Puede acceder a un valor por referencia de la misma manera. En algunos casos, acceder
a un valor por referencia aumenta el rendimiento, ya que evita una operación de copia
potencialmente cara. Por ejemplo, en la instrucción siguiente se muestra cómo definir
una variable local de referencia que se usa para hacer referencia a un valor.

C#

ref VeryLargeStruct reflocal = ref veryLargeStruct;

En los dos ejemplos la palabra clave ref debe usarse en ambos lugares. De lo contrario,
el compilador genera el error CS8172: «No se puede inicializar una variable por
referencia con un valor».

La variable de iteración de la instrucción foreach puede ser una variable local ref o una
variable local ref readonly. Para más información, vea el artículo sobre la instrucción
foreach. Puede reasignar una variable local de tipo ref readonly o local de tipo ref con el
operador de asignación ref.

Variables locales de tipo ref readonly

Una variable local de tipo ref readonly se usa para hacer referencia a los valores
devueltos por el método o la propiedad que tiene ref readonly en su firma y utiliza
return ref . Una variable ref readonly combina las propiedades de una variable local
ref con una variable readonly : es un alias para el almacenamiento al que se asigna y no

se puede modificar.
Un ejemplo de valores devueltos y variables
locales de tipo ref
En el ejemplo siguiente se define una clase Book que tiene dos campos String, Title y
Author . También define una clase BookCollection que incluye una matriz privada de
objetos Book . Los objetos book individuales se devuelven mediante referencia llamando
a su método GetBookByTitle .

C#

public class Book

public string Author;

public string Title;

public class BookCollection

private Book[] books = { new Book { Title = "Call of the Wild, The",
Author = "Jack London" },

new Book { Title = "Tale of Two Cities, A", Author =

"Charles Dickens" }

};

private Book nobook = null;

public ref Book GetBookByTitle(string title)

for (int ctr = 0; ctr < books.Length; ctr++)

if (title == books[ctr].Title)

return ref books[ctr];

return ref nobook;

public void ListBooks()

foreach (var book in books)

Console.WriteLine($"{book.Title}, by {book.Author}");

Console.WriteLine();

Cuando el autor de la llamada almacena el valor devuelto mediante el método

GetBookByTitle como una variable local de tipo ref, los cambios que el autor de la
llamada realiza en el valor devuelto se reflejan en el objeto BookCollection , como se
muestra en el ejemplo siguiente.

C#

var bc = new BookCollection();

bc.ListBooks();

ref var book = ref bc.GetBookByTitle("Call of the Wild, The");

if (book != null)

book = new Book { Title = "Republic, The", Author = "Plato" };

bc.ListBooks();

// The example displays the following output:

// Call of the Wild, The, by Jack London

// Tale of Two Cities, A, by Charles Dickens

//

// Republic, The, by Plato

// Tale of Two Cities, A, by Charles Dickens

campos ref
En tipos ref struct puede declarar campos que son campos ref . Los campos ref solo
son válidos en tipos ref struct para garantizar que la referencia no sobrevive al objeto
al que se refiere. Esta característica habilita tipos como System.Span<T>:

C#

public readonly ref struct Span<T>

internal readonly ref T _reference;

private readonly int _length;

// Omitted for brevity...

El tipo Span<T> almacena una referencia a través de la cual accede a los elementos
consecutivos. Una referencia habilita al objeto Span<T> para evitar realizar copias del
almacenamiento al que hace referencia.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Vea también
Cómo evitar asignaciones
Variables locales de tipo ref
Expresión condicional ref
Parámetros de métodos
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Modificador del parámetro out
(Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

La palabra clave out hace que los argumentos se pasen por referencia. Hace que el
parámetro formal sea un alias para el argumento, que debe ser una variable. En otras
palabras, cualquier operación en el parámetro se realiza en el argumento. Esto es como
la palabra clave ref, salvo que ref requiere que se inicialice la variable antes de pasarla.
También es como la palabra clave in, salvo que in no permite que el método llamado
modifique el valor del argumento. Para usar un parámetro out , tanto la definición de
método como el método de llamada deben utilizar explícitamente la palabra clave out .
Por ejemplo:

C#

int initializeInMethod;

OutArgExample(out initializeInMethod);

Console.WriteLine(initializeInMethod); // value is now 44

void OutArgExample(out int number)

number = 44;

７ Nota

La palabra clave out también puede usarse con un parámetro de tipo genérico
para especificar que el parámetro de tipo es covariante. Para obtener más
información sobre el uso de la palabra clave out en este contexto, vea Out
(Modificador genérico).

Las variables que se han pasado como argumentos out no tienen que inicializarse antes
de pasarse en una llamada al método. En cambio, se necesita el método que se ha
llamado para asignar un valor antes de que el método se devuelva.

Las palabras clave in , ref y out no se consideran parte de la firma del método con el
fin de resolver la sobrecarga. Por lo tanto, los métodos no pueden sobrecargarse si la
única diferencia es que un método toma un argumento ref o in y el otro toma un
argumento out . Por ejemplo, el código siguiente, no se compilará:
 C#

class CS0663_Example

// Compiler error CS0663: "Cannot define overloaded

// methods that differ only on ref and out".

public void SampleMethod(out int i) { }

public void SampleMethod(ref int i) { }

En cambio, la sobrecarga es legal si un método toma un argumento ref , in o out y el

otro no tiene ninguno de estos modificadores, como se muestra aquí:

C#

class OutOverloadExample

public void SampleMethod(int i) { }

public void SampleMethod(out int i) => i = 5;

El compilador elige la mejor sobrecarga haciendo coincidir los modificadores de

parámetro del sitio de llamada con los usados en la llamada de método.

Las propiedades no son variables y, por tanto, no pueden pasarse como parámetros
out .

Las palabras clave in , ref y out no pueden usarse para estos tipos de métodos:

Métodos asincrónicos, que se definen mediante el uso del modificador async.

Métodos de iterador, que incluyen una instrucción yield return o yield break .

Además, los métodos de extensión tienen las restricciones siguientes:

No se puede usar la palabra clave out en el primer argumento de un método de

extensión.
No se puede usar la palabra clave ref en el primer argumento de un método de
extensión cuando el argumento no es un struct ni un tipo genérico no restringido
a ser un struct.
No se puede usar la palabra clave in a menos que el primer argumento sea un
struct. No se puede usar la palabra clave in en ningún tipo genérico, incluso
cuando está restringido a ser un struct.

Declaración de parámetros out

Declarar un método con el argumento out es una solución alternativa clásica para
devolver varios valores. Considere la posibilidad de usar tuplas de valores en escenarios
similares. En el ejemplo siguiente, se utiliza out para devolver tres variables con una
única llamada al método. El tercer argumento se asigna a NULL. Esto permite que los
métodos devuelvan valores opcionalmente.

C#

void Method(out int answer, out string message, out string stillNull)

answer = 44;

message = "I've been returned";

stillNull = null;

int argNumber;

string argMessage, argDefault;

Method(out argNumber, out argMessage, out argDefault);

Console.WriteLine(argNumber);

Console.WriteLine(argMessage);

Console.WriteLine(argDefault == null);

// The example displays the following output:

// 44

// I've been returned

// True

Llamar a un método con un argumento out

Puede declarar una variable en una instrucción independiente antes de pasarla como un
argumento out . En el ejemplo siguiente se declara una variable denominada number
antes de que se pase al método Int32.TryParse, que intenta convertir una cadena en un
número.

C#

string numberAsString = "1640";

int number;

if (Int32.TryParse(numberAsString, out number))

Console.WriteLine($"Converted '{numberAsString}' to {number}");

else

Console.WriteLine($"Unable to convert '{numberAsString}'");

// The example displays the following output:

// Converted '1640' to 1640

También puede declarar la variable out en la lista de argumentos de la llamada de
método, en lugar de en una declaración de variable independiente. Esto genera un
código legible más compacto y, además, evita que asigne un valor a la variable antes de
la llamada al método de manera involuntaria. El ejemplo siguiente es como el ejemplo
anterior, excepto que define la variable number en la llamada al método Int32.TryParse.

C#

string numberAsString = "1640";

if (Int32.TryParse(numberAsString, out int number))

Console.WriteLine($"Converted '{numberAsString}' to {number}");

else

Console.WriteLine($"Unable to convert '{numberAsString}'");

// The example displays the following output:

// Converted '1640' to 1640

En el ejemplo anterior, la variable number está fuertemente tipada como int . También
puede declarar una variable local con tipo implícito como se muestra en el siguiente
ejemplo.

C#

string numberAsString = "1640";

if (Int32.TryParse(numberAsString, out var number))

Console.WriteLine($"Converted '{numberAsString}' to {number}");

else

Console.WriteLine($"Unable to convert '{numberAsString}'");

// The example displays the following output:

// Converted '1640' to 1640

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Declaración de variables insertadas (regla de estilo IDE0018)
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Parámetros de métodos
namespace
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave namespace se usa para declarar un ámbito que contiene un conjunto de
objetos relacionados. Puede usar un espacio de nombres para organizar los elementos
de código y crear tipos únicos globales.

C#

namespace SampleNamespace

class SampleClass { }

interface ISampleInterface { }

struct SampleStruct { }

enum SampleEnum { a, b }

delegate void SampleDelegate(int i);

namespace Nested

class SampleClass2 { }

Las declaraciones de espacio de nombres con ámbito de archivo permiten declarar que
todos los tipos de un archivo están en un único espacio de nombres. Las declaraciones
de espacio de nombres con ámbito de archivo están disponibles con C# 10. El ejemplo
siguiente es similar al anterior, pero usa una declaración de espacio de nombres con
ámbito de archivo:

C#

using System;

namespace SampleFileScopedNamespace;

class SampleClass { }

interface ISampleInterface { }

struct SampleStruct { }

enum SampleEnum { a, b }

delegate void SampleDelegate(int i);

En el ejemplo anterior no se incluye ningún espacio de nombres anidado. Los espacios

de nombres con ámbito de archivo no pueden incluir declaraciones de espacio de
nombres adicionales. No se puede declarar un espacio de nombres anidado ni un
segundo espacio de nombres con ámbito de archivo:

C#

namespace SampleNamespace;

class AnotherSampleClass

public void AnotherSampleMethod()

System.Console.WriteLine(
"SampleMethod inside SampleNamespace");

namespace AnotherNamespace; // Not allowed!

namespace ANestedNamespace // Not allowed!

// declarations...

En un espacio de nombres, se pueden declarar cero o más de los siguientes tipos:

class
interface
struct
enum
delegate
los espacios de nombres anidados se pueden declarar excepto en declaraciones de
espacio de nombres con ámbito de archivo

El compilador agrega un espacio de nombres predeterminado. Este espacio de nombres

sin nombre, que a veces se denomina espacio de nombres global, está presente en
todos los archivos. Contiene declaraciones no incluidas en un espacio de nombres
declarado. Todos los identificadores del espacio de nombres global están disponibles
para su uso en un espacio de nombres con nombre.

Los espacios de nombres tienen acceso público implícitamente. Para ver una descripción
de los modificadores de acceso que se pueden asignar a los elementos de un espacio
de nombres, vea Modificadores de acceso.
Es posible definir un espacio de nombres en dos o más declaraciones. Por ejemplo, en el
ejemplo siguiente se definen dos clases como parte del espacio de nombres MyCompany :

C#

namespace MyCompany.Proj1

class MyClass

namespace MyCompany.Proj1

class MyClass1

En el ejemplo siguiente se muestra cómo llamar a un método estático en un espacio de

nombres anidado.

C#

namespace SomeNameSpace

public class MyClass

static void Main()

Nested.NestedNameSpaceClass.SayHello();

// a nested namespace

namespace Nested

public class NestedNameSpaceClass

public static void SayHello()

Console.WriteLine("Hello");

// Output: Hello

Especificación del lenguaje C#

Para más información, vea la sección Espacio de nombres de la Especificación del
lenguaje C#.
Para obtener más información sobre las declaraciones de espacio de
nombres con ámbito de archivo, consulte la especificación de características.

Vea también
Preferencias de declaración de espacio de nombres (IDE0160 e IDE0161)
Referencia de C#
Palabras clave de C#
using
using static
Calificadores de alias de espacio de nombres::
Espacios de nombres
using (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave using tiene dos usos principales:

La instrucción using define un ámbito al final del cual se eliminará un objeto.

La directiva using crea un alias para un espacio de nombres o importa tipos
definidos en otros espacios de nombres.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Espacios de nombres
extern
using (directiva)
Artículo • 15/02/2023 • Tiempo de lectura: 10 minutos

La directiva using permite usar tipos definidos en un espacio de nombres sin especificar
el espacio de nombres completo de ese tipo. En su forma básica, la directiva using
importa todos los tipos de un único espacio de nombres, como se muestra en el
ejemplo siguiente:

C#

using System.Text;

Puede aplicar dos modificadores a una directiva using :

El modificador global tiene el mismo efecto que agregar la misma directiva using
a todos los archivos de código fuente del proyecto. Este modificador se presentó
en C# 10.
El modificador static importa los miembros static y los tipos anidados de un
solo tipo en lugar de importar todos los tipos de un espacio de nombres.

Puede combinar los dos modificadores para importar los miembros estáticos de un tipo
en todos los archivos de código fuente del proyecto.

También puede crear un alias para un espacio de nombres o un tipo con una directiva de
alias using.

C#

using Project = PC.MyCompany.Project;

Puede usar el modificador global en una directiva de alias using.

７ Nota

La palabra clave using también se usa para crear instrucciones using, que ayudan a
garantizar que los objetos IDisposable, como archivos y fuentes, se tratan
correctamente. Para obtener más información sobre la instrucción using, consulte
Instrucción using.

El ámbito de una directiva using sin el modificador global es el archivo en el que

aparece.
La directiva using puede aparecer:

Al principio de un archivo de código fuente, antes de las declaraciones de espacio

de nombres o de tipo.
En cualquier espacio de nombres, pero antes de los espacios de nombres o los
tipos declarados en ese espacio de nombres, a menos que se use el modificador
global , en cuyo caso la directiva debe aparecer antes de todas las declaraciones

de tipos y espacios de nombres.

De lo contrario, se generará el error de compilador CS1529.

Cree una directiva using para usar los tipos de un espacio de nombres sin tener que
especificarlo. Una directiva using no proporciona acceso a los espacios de nombres que
están anidados en el espacio de nombres especificado. Los espacios de nombres se
dividen en dos categorías: definidos por el sistema y definidos por el usuario. Los
espacios de nombres definidos por el usuario son espacios de nombres definidos en el
código. Para obtener una lista de los espacios de nombres definidos por el sistema, vea
Explorador de API de .NET.

modificador global
Agregar el modificador global a una directiva using hará que using se aplique a todos
los archivos de la compilación (normalmente un proyecto). La directiva global using se
agregó en C# 10. La sintaxis es:

C#

global using <fully-qualified-namespace>;

donde el espacio de nombres completo es el nombre completo del espacio de nombres

cuyos tipos se pueden hacer referencia sin especificar el espacio de nombres.

Una directiva global using puede aparecer al principio de cualquier archivo de código
fuente. Todas las directivas global using de un solo archivo deben aparecer antes de:

Todas las directivas using sin el modificador global .

Todas las declaraciones de espacio de nombres y de tipo del archivo.

Puede agregar directivas global using a cualquier archivo de código fuente.

Normalmente, querrá mantenerlas en una sola ubicación. El orden de las directivas
global using no importa, ya sea en un solo archivo o entre archivos.
El modificador global se puede combinar con el modificador static . El modificador
global se puede aplicar a una directiva de alias using. En ambos casos, el ámbito de la
directiva son todos los archivos de la compilación actual. En el ejemplo siguiente se
habilita el uso de todos los métodos declarados en System.Math en todos los archivos
del proyecto:

C#

global using static System.Math;

También puede incluir globalmente un espacio de nombres agregando un elemento

<Using> al archivo del proyecto, por ejemplo, <Using Include="My.Awesome.Namespace"
/> . Para más información, consulte el elemento <Using>.

） Importante

Las plantillas de C# para .NET 6 usan instrucciones de nivel superior. Es posible que
la aplicación no coincida con el código de este artículo si ya ha actualizado a
.NET 6. Para obtener más información, consulte el artículo Las nuevas plantillas de
C# generan instrucciones de nivel superior.

El SDK de .NET 6 también agrega un conjunto de directivas implícitas global using

para proyectos que usan los SDK siguientes:

Microsoft.NET.Sdk
Microsoft.NET.Sdk.Web
Microsoft.NET.Sdk.Worker

Estas directivas de global using implícitas incluyen los espacios de nombres más
comunes para el tipo de proyecto.

static (modificador)
La directiva using static designa un tipo a cuyos miembros estáticos y tipos anidados
se puede acceder sin especificar un nombre de tipo. La sintaxis es:

C#

using static <fully-qualified-type-name>;

<fully-qualified-type-name> es el nombre del tipo a cuyos miembros estáticos y tipos

anidados se puede hacer referencia sin especificar un nombre de tipo. Si no proporciona

un nombre de tipo completo (el nombre del espacio de nombres completo junto con el
nombre del tipo), C# genera el error del compilador CS0246: "El nombre del tipo o del
espacio de nombres "tipo/espacio de nombres" no se encontró (¿falta una directiva
using o una referencia de ensamblado?)".

La directiva using static se aplica a cualquier tipo que tenga miembros estáticos (o
tipos anidados), aunque también tenga miembros de instancia. Pero los miembros de
instancia solo pueden invocarse a través de la instancia del tipo.

Puede acceder a los miembros estáticos de un tipo sin tener que calificar el acceso con
el nombre del tipo:

C#

using static System.Console;

using static System.Math;

class Program

static void Main()

WriteLine(Sqrt(3*3 + 4*4));

Normalmente, cuando se llama a un miembro estático, se especifica el nombre de tipo

junto con el nombre de miembro. Especificar varias veces el mismo nombre de tipo para
invocar los miembros del tipo puede traducirse en código detallado y poco claro. Por
ejemplo, en la definición siguiente de una clase Circle se hace referencia a numerosos
miembros de la clase Math.

C#

using System;

public class Circle

public Circle(double radius)

Radius = radius;

public double Radius { get; set; }

public double Diameter

get { return 2 * Radius; }

public double Circumference

get { return 2 * Radius * Math.PI; }

public double Area

get { return Math.PI * Math.Pow(Radius, 2); }

Al eliminar la necesidad de hacer referencia explícitamente a la clase Math cada vez que
se hace referencia a un miembro, la directiva using static genera un código más
limpio:

C#

using System;

using static System.Math;

public class Circle

public Circle(double radius)

Radius = radius;

public double Radius { get; set; }

public double Diameter

get { return 2 * Radius; }

public double Circumference

get { return 2 * Radius * PI; }

public double Area

get { return PI * Pow(Radius, 2); }

using static importa solo los miembros estáticos accesibles y los tipos anidados

declarados en el tipo especificado. Los miembros heredados no se importan. Puede

realizar la importación desde cualquier tipo con nombre con una directiva using static ,
como los módulos de Visual Basic. Las funciones de nivel superior F# pueden importarse
si aparecen en los metadatos como miembros estáticos de un tipo con nombre cuyo
nombre es un identificador de C# válido.

using static habilita los métodos de extensión declarados en el tipo especificado estén
para la búsqueda de métodos de extensión. Sin embargo, los nombres de los métodos
de extensión no se importan en el ámbito de referencia sin calificar del código.

Los métodos con el mismo nombre que se importen desde tipos distintos con distintas
directivas using static en la misma unidad de compilación o espacio de nombres
forman un grupo de métodos. La resolución de sobrecarga dentro de estos grupos de
método sigue reglas normales de C#.

En el ejemplo siguiente se usa la directiva using static para que los miembros
estáticos de las clases Console, Math y String estén disponibles sin tener que especificar
su nombre de tipo.

C#

using System;

using static System.Console;

using static System.Math;

using static System.String;

class Program

static void Main()

Write("Enter a circle's radius: ");

var input = ReadLine();

if (!IsNullOrEmpty(input) && double.TryParse(input, out var radius)) {

var c = new Circle(radius);

string s = "\nInformation about the circle:\n";

s = s + Format(" Radius: {0:N2}\n", c.Radius);

s = s + Format(" Diameter: {0:N2}\n", c.Diameter);

s = s + Format(" Circumference: {0:N2}\n", c.Circumference);

s = s + Format(" Area: {0:N2}\n", c.Area);

WriteLine(s);

else {

WriteLine("Invalid input...");

public class Circle

public Circle(double radius)

 Radius = radius;

public double Radius { get; set; }

public double Diameter

get { return 2 * Radius; }

public double Circumference

get { return 2 * Radius * PI; }

public double Area

get { return PI * Pow(Radius, 2); }

// The example displays the following output:

// Enter a circle's radius: 12.45

//

// Information about the circle:

// Radius: 12.45

// Diameter: 24.90

// Circumference: 78.23

// Area: 486.95

En el ejemplo, también podría haberse aplicado la directiva using static al tipo Double.
Agregar esa directiva habría permitido llamar al método TryParse(String, Double) sin
especificar un nombre de tipo. Sin embargo, el uso de TryParse sin un nombre de tipo
crea un código menos legible, ya que es necesario comprobar las directivas using
static para determinar el método TryParse del tipo numérico al que se llama.

using static también se aplica a los tipos enum . Al agregar using static con la
enumeración, el tipo ya no es necesario para usar los miembros de la enumeración.

C#

using static Color;

enum Color

Red,

Green,

Blue

class Program

 public static void Main()

Color color = Green;

alias using
Cree una directiva de alias using para facilitar la calificación de un identificador como
espacio de nombres o tipo. En cualquier directiva using , hay que usar el espacio de
nombres o el tipo con cualificación completa, independientemente de las directivas
using que los precedan. No se puede usar ningún alias using en la declaración de una

directiva using . Por ejemplo, en el ejemplo siguiente se genera un error del compilador:

C#

using s = System.Text;

using s.RegularExpressions; // Generates a compiler error.

En el ejemplo siguiente se muestra cómo definir y usar un alias using para un espacio
de nombres:

C#

namespace PC

// Define an alias for the nested namespace.

using Project = PC.MyCompany.Project;

class A

void M()

// Use the alias

var mc = new Project.MyClass();

namespace MyCompany
{

namespace Project

public class MyClass { }

Una directiva de alias using no puede tener un tipo genérico abierto en el lado derecho.
Por ejemplo, no puede crear un alias using para un elemento List<T> , pero puede crear
uno para un elemento List<int> .

En el ejemplo siguiente se muestra cómo definir una directiva using y un alias using
para una clase:

C#

using System;

// Using alias directive for a class.

using AliasToMyClass = NameSpace1.MyClass;

// Using alias directive for a generic class.

using UsingAlias = NameSpace2.MyClass<int>;

namespace NameSpace1

public class MyClass

public override string ToString()

return "You are in NameSpace1.MyClass.";

namespace NameSpace2

class MyClass<T>

public override string ToString()

return "You are in NameSpace2.MyClass.";

namespace NameSpace3

class MainClass

static void Main()

var instance1 = new AliasToMyClass();

Console.WriteLine(instance1);

var instance2 = new UsingAlias();

Console.WriteLine(instance2);

// Output:

// You are in NameSpace1.MyClass.

// You are in NameSpace2.MyClass.

Uso del espacio de nombres My de Visual Basic

El espacio de nombres Microsoft.VisualBasic.MyServices ( My en Visual Basic)
proporciona acceso fácil e intuitivo a una serie de clases de .NET, lo que le permite
escribir código que interactúe con el equipo, la aplicación, la configuración, los recursos,
etc. Aunque se diseñó originalmente para usarse con Visual Basic, el espacio de
nombres MyServices puede usarse en aplicaciones de C#.

Para obtener más información sobre el uso del espacio de nombres MyServices de
Visual Basic, consulte Desarrollo con My.

Debe agregar una referencia al ensamblado Microsoft.VisualBasic.dll en el proyecto. No

se puede llamar a todas las clases en el espacio de nombres MyServices desde una
aplicación de C#: por ejemplo, la clase FileSystemProxy no es compatible. En este caso
concreto, los métodos estáticos que forman parte de FileSystem, que también se
incluyen en el archivo VisualBasic.dll, pueden usarse en su lugar. Por ejemplo, aquí se
muestra cómo usar uno de estos métodos para duplicar un directorio:

C#

// Duplicate a directory

Microsoft.VisualBasic.FileIO.FileSystem.CopyDirectory(

@"C:\original_directory",

@"C:\copy_of_original_directory");

Especificación del lenguaje C#

Para obtener más información, vea la sección Directivas using de la Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.

Para obtener más información sobre el modificador global using, consulte la

especificación de la característica global using: C# 10.

Vea también
Regla de estilo IDE0005: Eliminación de directivas "using" innecesarias
Regla de estilo IDE0065: Colocación de directivas "using"
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Espacios de nombres
using (instrucción)
using (Instrucción, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 4 minutos

La instrucción using ofrece una sintaxis adecuada que garantiza el uso correcto de
objetos IDisposable. La instrucción await using garantiza el uso correcto de los objetos
IAsyncDisposable. El lenguaje admite tipos descartables asincrónicos que implementan
la interfaz System.IAsyncDisposable.

Ejemplo
En el ejemplo siguiente se muestra cómo usar la instrucción using .

C#

string manyLines = @"This is line one

This is line two

Here is line three

The penultimate line is line four

This is the final, fifth line.";

using (var reader = new StringReader(manyLines))

string? item;

do

item = reader.ReadLine();
Console.WriteLine(item);

} while (item != null);

La declaración using no requiere el uso de llaves:

C#

string manyLines = @"This is line one

This is line two

Here is line three

The penultimate line is line four

This is the final, fifth line.";

using var reader = new StringReader(manyLines);

string? item;

do

item = reader.ReadLine();

Console.WriteLine(item);

} while (item != null);

Comentarios
File y Font son ejemplos de tipos administrados que acceden a recursos no
administrados (en este caso, identificadores de archivo y contextos de dispositivo). Hay
muchos otros tipos de recursos no administrados y tipos de la biblioteca de clases que
los encapsulan. Todos estos tipos deben implementar la interfaz IDisposable o la
interfaz IAsyncDisposable.

Cuando la duración de un objeto IDisposable se limita a un único método, debe

declarar y crear instancias de él en la instrucción using o en la declaración using . La
declaración using llama al método Dispose en el objeto de la manera correcta cuando
sale del ámbito. La instrucción using hace que el propio objeto salga del ámbito en
cuando se llama a Dispose. Dentro del bloque  using , el objeto es de solo lectura y no se
puede modificar ni reasignar. Una variable declarada con una declaración using es de
solo lectura. Si el objeto implementa IAsyncDisposable en lugar de IDisposable , una de
las formas using llama a DisposeAsync y usa awaits con el valor de ValueTask devuelto.
Para obtener más información sobre IAsyncDisposable, vea Implementación de un
método DisposeAsync.

Ambas formas using garantizan que se llama a Dispose (o DisposeAsync) aunque se

produzca una excepción en el bloque using . Puede obtener el mismo resultado si
coloca el objeto dentro de un bloque try y llama a Dispose (o DisposeAsync) en un
bloque finally ; de hecho, es así como el compilador traduce la instrucción using y la
declaración using . El ejemplo de código anterior se extiende al siguiente código en
tiempo de compilación (tenga en cuenta las llaves adicionales para crear el ámbito
limitado del objeto):

C#

string manyLines = @"This is line one

This is line two

Here is line three

The penultimate line is line four

This is the final, fifth line.";

var reader = new StringReader(manyLines);

try

string? item;

do

item = reader.ReadLine();

 Console.WriteLine(item);

} while (item != null);

finally

reader?.Dispose();

La nueva sintaxis de la instrucción  using se traduce en un código similar. Se abre el

bloque try en el que se declara la variable. El bloque finally se agrega al cierre del
bloque de inclusión, normalmente, al final de un método.

Consulte el artículo sobre try-finally para obtener más información sobre la

instrucción  try - finally .

Se pueden declarar varias instancias de un tipo en una sola instrucción  using , tal y
como se muestra en el ejemplo siguiente. Tenga en cuenta que no se pueden usar
variables con tipo implícito ( var ) cuando se declaran varias variables en una sola
instrucción:

C#

string numbers = @"One

Two

Three

Four.";

string letters = @"A

D.";

using (StringReader left = new StringReader(numbers),

right = new StringReader(letters))

string? item;

do

item = left.ReadLine();

Console.Write(item);

Console.Write(" ");

item = right.ReadLine();

Console.WriteLine(item);

} while (item != null);

También puede combinar varias declaraciones del mismo tipo con la nueva sintaxis de
declaración, tal y como se muestra en el siguiente ejemplo:
 C#

string numbers = @"One

Two

Three

Four.";

string letters = @"A

D.";

using StringReader left = new StringReader(numbers),

right = new StringReader(letters);

string? item;

do

item = left.ReadLine();

Console.Write(item);

Console.Write(" ");

item = right.ReadLine();

Console.WriteLine(item);

} while (item != null);

Puede crear una instancia del objeto de recurso y luego pasar la variable a la
instrucción  using , pero esto no es un procedimiento recomendado. En este caso,
después de que el control abandone el bloque using el objeto permanece en el ámbito,
pero probablemente ya no tenga acceso a sus recursos no administrados. En otras
palabras, ya no se inicializa totalmente. Si intenta usar el objeto fuera del bloque using ,
corre el riesgo de iniciar una excepción. Por este motivo, es mejor crear una instancia del
objeto en la instrucción  using y limitar su ámbito al bloque  using .

C#

string manyLines = @"This is line one

This is line two

Here is line three

The penultimate line is line four

This is the final, fifth line.";

var reader = new StringReader(manyLines);

using (reader)

string? item;

do

item = reader.ReadLine();
Console.WriteLine(item);

} while (item != null);

// reader is in scope here, but has been disposed

Para obtener más información sobre cómo eliminar objetos IDisposable , vea Uso de
objetos que implementan IDisposable.

Especificación del lenguaje C#

Para obtener más información, vea el apartado Instrucción using en la Especificación del
lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso
de C#.

Vea también
Uso de la instrucción "using" simple (regla de estilo IDE0063)
Referencia de C#
Guía de programación de C#
Palabras clave de C#
using (directiva)
Recolección de elementos no utilizados
Uso de objetos que implementan IDisposable
IDisposable interface (Interfaz IDisposable)
Instrucción using en C# 8.0
Artículo Implementación de un método DisposeAsync
alias externo (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Es posible que deba hacer referencia a dos versiones de ensamblados que tienen los
mismos nombres de tipo completos. Por ejemplo, es posible que tenga que usar dos o
más versiones de un ensamblado en la misma aplicación. Mediante el uso de un alias de
ensamblado externo, los espacios de nombres de cada ensamblado pueden ajustarse en
espacios de nombres de nivel de raíz denominados por el alias, lo que permite que se
usen en el mismo archivo.

７ Nota

La palabra clave extern también se usa como un modificador de método, y declara

un método escrito en código no administrado.

Para hacer referencia a dos ensamblados con los mismos nombres de tipo completos,
debe especificarse un alias en un símbolo del sistema, como sigue:

/r:GridV1=grid.dll

/r:GridV2=grid20.dll

Esto crea los alias externos GridV1 y GridV2 . Para usar estos alias desde dentro de un
programa, se hace referencia a ellos mediante la palabra clave extern . Por ejemplo:

extern alias GridV1;

extern alias GridV2;

Cada declaración de alias externo introduce un espacio de nombres de nivel de raíz

adicional que es semejante al espacio de nombres global (pero que no se encuentra en
su interior). Por tanto, se puede hacer referencia a los tipos de cada ensamblado sin
ambigüedad mediante su nombre completo, con raíz en el alias de espacio de nombres
adecuado.

En el ejemplo anterior, GridV1::Grid sería el control de cuadrícula de grid.dll , y

GridV2::Grid sería el control de cuadrícula de grid20.dll .

Uso de Visual Studio

Si usa Visual Studio, los alias se pueden proporcionar de manera similar.
Agregue una referencia de grid.dll y grid20.dll al proyecto en Visual Studio. Abra una
pestaña de propiedades y cambie los alias de global a GridV1 y GridV2,
respectivamente.

Use estos alias igual que antes.

C#

extern alias GridV1;

extern alias GridV2;

Ahora puede crear un alias para un espacio de nombres o un tipo mediante la directiva
de alias. Para más información, consulte la directiva using.

C#

using Class1V1 = GridV1::Namespace.Class1;

using Class1V2 = GridV2::Namespace.Class1;

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
:: !
References (opciones del compilador de C#)
Restricción new (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La restricción new especifica que un tipo de argumento en una declaración de clase o de

método genéricas debe tener un constructor público sin parámetros. Para usar la
restricción new , el tipo no puede ser abstracto.

Aplique la restricción new a un tipo de parámetro cuando una clase genérica cree otras
instancias del tipo, tal y como se muestra en el ejemplo siguiente:

C#

class ItemFactory<T> where T : new()

{

public T GetNewItem()

return new T();

}

Cuando use la restricción new() con otras restricciones, se debe especificar en último
lugar:

C#

public class ItemFactory2<T>

where T : IComparable, new()

{ }

Para obtener más información, vea Restricciones de tipos de parámetros.

También puede usar la palabra clave new para crear una instancia de un tipo o como un
modificador de declaración de miembro.

Especificación del lenguaje C#

Para más información, vea la sección Restricciones de parámetros de tipo de la
Especificación del lenguaje C#.

Vea también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Genéricos
where (restricción de tipo genérico)
(Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

La cláusula where en una definición genérica especifica restricciones en los tipos que se
usan como argumentos para los parámetros de tipo en un tipo genérico, método,
delegado o función local. Las restricciones pueden especificar interfaces o clases base, o
bien requerir que un tipo genérico sea una referencia, un valor o un tipo no
administrado. Declaran las funcionalidades que debe tener el argumento de tipo, y
deben colocarse después de cualquier clase base declarada o interfaces implementadas.

Por ejemplo, se puede declarar una clase genérica, AGenericClass , de modo que el
parámetro de tipo T implemente la interfaz IComparable<T>:

C#

public class AGenericClass<T> where T : IComparable<T> { }

７ Nota

Para obtener más información sobre la cláusula where en una expresión de

consulta, vea where (Cláusula).

La cláusula where también puede incluir una restricción de clase base. La restricción de
clase base indica que un tipo que se va a usar como argumento de tipo para ese tipo
genérico tiene la clase especificada como clase base, o bien es la clase base. Si se usa la
restricción de clase base, debe aparecer antes que cualquier otra restricción de ese
parámetro de tipo. Algunos tipos no están permitidos como restricción de clase base:
Object, Array y ValueType. En el ejemplo siguiente se muestran los tipos que ahora se
pueden especificar como clase base:

C#

public class UsingEnum<T> where T : System.Enum { }

public class UsingDelegate<T> where T : System.Delegate { }

public class Multicaster<T> where T : System.MulticastDelegate { }

En un contexto que admite un valor NULL, se aplica la nulabilidad del tipo de clase base.
Si la clase base no acepta valores NULL (por ejemplo, Base ), el argumento de tipo no
debe aceptar valores NULL. Si la clase base admite un valor NULL (por ejemplo, Base? ),
el argumento de tipo puede ser un tipo de referencia que acepte o no valores NULL. El
compilador emite una advertencia si el argumento de tipo es un tipo de referencia que
admite un valor NULL cuando la clase base no acepta valores NULL.

La cláusula where puede especificar que el tipo es class o struct . La restricción struct
elimina la necesidad de especificar una restricción de clase base de System.ValueType . El
tipo System.ValueType no se puede usar como restricción de clase base. En el ejemplo
siguiente se muestran las restricciones class y struct :

C#

class MyClass<T, U>

where T : class

where U : struct

{ }

En un contexto que admite un valor NULL, la restricción class requiere que un tipo sea
un tipo de referencia que no acepta valores NULL. Para permitir tipos de referencia que
admitan un valor NULL, use la restricción class? , que permite tipos de referencia que
aceptan y que no aceptan valores NULL.

La cláusula where puede incluir la restricción notnull . La restricción notnull limita el

parámetro de tipo a tipos que no aceptan valores NULL. El tipo puede ser un tipo de
valor o un tipo de referencia que no acepta valores NULL. La restricción notnull está
disponible para el código compilado en un contexto nullable enable. A diferencia de
otras restricciones, si un argumento de tipo infringe la restricción notnull , el
compilador genera una advertencia en lugar de un error. Las advertencias solo se
generan en un contexto nullable enable .

La incorporación de tipos de referencia que aceptan valores NULL introduce una

ambigüedad potencial en el significado de T? en los métodos genéricos. Si T es un
elemento struct , T? es igual que System.Nullable<T>. Sin embargo, si T es un tipo de
referencia, T? significa que null es un valor válido. La ambigüedad surge porque
invalidar métodos no puede incluir restricciones. La restricción default nueva resuelve
esta ambigüedad. Se agregará cuando una clase base o interfaz declare dos sobrecargas
de un método; una que especifica la restricción struct , y otra que no tiene aplicada la
restricción struct ni la class :

C#
 public abstract class B

public void M<T>(T? item) where T : struct { }

public abstract void M<T>(T? item);

La restricción default se usa para especificar que la clase derivada invalida el método
sin la restricción en la clase derivada o la implementación de interfaz explícita. Solo es
válido en métodos que invalidan métodos base o implementaciones de interfaz
explícitas:

C#

public class D : B

// Without the "default" constraint, the compiler tries to override the

first method in B

public override void M<T>(T? item) where T : default { }

） Importante

Las declaraciones genéricas que incluyen la restricción notnull se pueden usar en

un contexto donde se desconoce que se aceptan valores NULL, pero el compilador
no aplica la restricción.

C#

#nullable enable

class NotNullContainer<T>

where T : notnull

#nullable restore

La cláusula where también podría incluir una restricción unmanaged . La restricción

unmanaged limita el parámetro de tipo a los tipos conocidos como tipos no

administrados. La restricción unmanaged hace que sea más fácil escribir código de
interoperabilidad de bajo nivel en C#. Esta restricción habilita las rutinas reutilizables en
todos los tipos no administrados. La restricción unmanaged no se puede combinar con
las restricciones class o struct . La restricción unmanaged exige que el tipo sea struct :
 C#

class UnManagedWrapper<T>

where T : unmanaged

{ }

La cláusula where también podría incluir una restricción de constructor, new() . Esta
restricción hace posible crear una instancia de un parámetro de tipo con el operador
new . La restricción new() permite que el compilador sepa que cualquier argumento de
tipo especificado debe tener accesible un constructor sin parámetros. Por ejemplo:

C#

public class MyGenericClass<T> where T : IComparable<T>, new()

// The following line is not possible without new() constraint:

T item = new T();

La restricción new() aparece en último lugar en la cláusula where . La restricción new()

no se puede combinar con las restricciones struct o unmanaged . Todos los tipos que
cumplan esas restricciones deben tener un constructor sin parámetros accesible, lo que
hace que la restricción new() sea redundante.

Con varios parámetros de tipo, use una cláusula where para cada parámetro de tipo, por
ejemplo:

C#

public interface IMyInterface { }

namespace CodeExample

class Dictionary<TKey, TVal>

where TKey : IComparable<TKey>

where TVal : IMyInterface

public void Add(TKey key, TVal val) { }

También puede asociar restricciones a parámetros de tipo de métodos genéricos, como

se muestra en el ejemplo siguiente:

C#
 public void MyMethod<T>(T t) where T : IMyInterface { }

Observe que la sintaxis para describir las restricciones de parámetro de tipo en

delegados es igual que la de métodos:

C#

delegate T MyDelegate<T>() where T : new();

Para obtener información sobre los delegados genéricos, vea Delegados genéricos.

Para obtener más información sobre la sintaxis y el uso de restricciones, vea

Restricciones de tipos de parámetros.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Introducción a los genéricos
new (restricción)
Restricciones de tipos de parámetros
base (Referencia de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave base se usa para acceder a los miembros de la clase base desde una
clase derivada. Úselo si desea:

Llamar a un método en la clase base que haya sido reemplazado por otro método.

Especificar a qué constructor de clase base se debe llamar cuando se crean

instancias de la clase derivada.

Solo se permite el acceso a la clase base en un constructor, en un método de instancia y

en un descriptor de acceso de propiedad de instancia.

El uso de la base palabra clave desde dentro de un método estático dará un error.

La clase base a la que se obtiene acceso es la especificada en la declaración de clase. Por

ejemplo, si especifica class ClassB : ClassA , se obtiene acceso a los miembros de
ClassA desde ClassB, independientemente de la clase base de ClassA.

Ejemplo 1
En este ejemplo, la clase base Person y la clase derivada Employee tienen un método
denominado Getinfo . Mediante el uso de la palabra clave base , es posible llamar al
método Getinfo de la clase base desde la clase derivada.

C#

public class Person

protected string ssn = "444-55-6666";

protected string name = "John L. Malgraine";

public virtual void GetInfo()

Console.WriteLine("Name: {0}", name);

Console.WriteLine("SSN: {0}", ssn);

class Employee : Person

{

public string id = "ABC567EFG";

public override void GetInfo()

// Calling the base class GetInfo method:

base.GetInfo();

 Console.WriteLine("Employee ID: {0}", id);

class TestClass

static void Main()

Employee E = new Employee();

E.GetInfo();

/*

Output

Name: John L. Malgraine

SSN: 444-55-6666

Employee ID: ABC567EFG

*/

Para ver más ejemplos, consulte new, virtual y override.

Ejemplo 2
En este ejemplo se muestra cómo especificar el constructor de clase base al que se
llama al crear instancias de una clase derivada.

C#

public class BaseClass

int num;

public BaseClass()

Console.WriteLine("in BaseClass()");

public BaseClass(int i)

num = i;

Console.WriteLine("in BaseClass(int i)");

public int GetNum()

return num;

public class DerivedClass : BaseClass

// This constructor will call BaseClass.BaseClass()

public DerivedClass() : base()

// This constructor will call BaseClass.BaseClass(int i)

public DerivedClass(int i) : base(i)

static void Main()

DerivedClass md = new DerivedClass();

DerivedClass md1 = new DerivedClass(1);

/*

Output:

in BaseClass()

in BaseClass(int i)

*/

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
this
this (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave this hace referencia a la instancia actual de la clase y también se usa
como modificador del primer parámetro de un método de extensión.

７ Nota

En este artículo se describe el uso de this con instancias de clase. Para obtener
más información sobre su uso en métodos de extensión, vea Métodos de
extensión.

A continuación se indican usos habituales de this :

Para calificar a miembros ocultos por nombres similares, por ejemplo:

C#

public class Employee

private string alias;

private string name;

public Employee(string name, string alias)

// Use this to qualify the members of the class

// instead of the constructor parameters.

this.name = name;

this.alias = alias;

Para pasar un objeto como parámetro a otros métodos, por ejemplo:

C#

CalcTax(this);

Para declarar indizadores, por ejemplo:

C#

public int this[int param]

get { return array[param]; }

 set { array[param] = value; }

Las funciones miembro estáticas no tienen un puntero this , debido a que existen en el
nivel de clase y no como parte de un objeto. Es un error hacer referencia a this en un
método estático.

Ejemplo
En este ejemplo, se usa this para calificar los miembros de la clase Employee , name y
alias , que están ocultos por nombres similares. También se usa para pasar un objeto al
método CalcTax , que pertenece a otra clase.

C#

class Employee

private string name;

private string alias;

private decimal salary = 3000.00m;

// Constructor:

public Employee(string name, string alias)

// Use this to qualify the fields, name and alias:

this.name = name;

this.alias = alias;

// Printing method:

public void printEmployee()

Console.WriteLine("Name: {0}\nAlias: {1}", name, alias);

// Passing the object to the CalcTax method by using this:

Console.WriteLine("Taxes: {0:C}", Tax.CalcTax(this));

public decimal Salary

get { return salary; }

class Tax

public static decimal CalcTax(Employee E)

return 0.08m * E.Salary;

class MainClass

static void Main()

// Create objects:

Employee E1 = new Employee("Mingda Pan", "mpan");

// Display results:

E1.printEmployee();

/*

Output:

Name: Mingda Pan

Alias: mpan

Taxes: $240.00

*/

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
this Preferencias de estilo de código (IDE0003 e IDE0009)
Referencia de C#
Guía de programación de C#
Palabras clave de C#
base
Métodos
null (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave null es un literal que representa una referencia nula que no hace
referencia a ningún objeto. null es el valor predeterminado de las variables de tipo de
referencia. Los tipos de valor normales no pueden ser NULL, excepto los tipos de valor
que admiten un valor NULL.

En el ejemplo siguiente se muestran algunos comportamientos de la palabra clave null :

C#

class Program

class MyClass

public void MyMethod() { }

static void Main(string[] args)

// Set a breakpoint here to see that mc = null.

// However, the compiler considers it "unassigned."

// and generates a compiler error if you try to

// use the variable.

MyClass mc;

// Now the variable can be used, but...

mc = null;

// ... a method call on a null object raises

// a run-time NullReferenceException.

// Uncomment the following line to see for yourself.

// mc.MyMethod();

// Now mc has a value.

mc = new MyClass();

// You can call its method.

mc.MyMethod();

// Set mc to null again. The object it referenced

// is no longer accessible and can now be garbage-collected.

mc = null;

// A null string is not the same as an empty string.

string s = null;

string t = String.Empty; // Logically the same as ""

 // Equals applied to any null object returns false.

bool b = (t.Equals(s));

Console.WriteLine(b);

// Equality operator also returns false when one

// operand is null.

Console.WriteLine("Empty string {0} null string", s == t ? "equals":

"does not equal");

// Returns true.

Console.WriteLine("null == null is {0}", null == null);

// A value type cannot be null

// int i = null; // Compiler error!

// Use a nullable value type instead:

int? i = null;

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();
}

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también
Referencia de C#
Palabras clave de C#
Valores predeterminados de los tipos de C#
Nothing (Visual Basic)
bool (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave de tipo bool es un alias para el tipo de estructura de .NET

System.Boolean que representa un valor booleano que puede ser true o false .

Para realizar operaciones lógicas con valores del tipo bool , use operadores lógicos
booleanos. El tipo bool es el tipo de resultado de los operadores de comparación e
igualdad. Una expresión bool puede ser una expresión condicional de control en las
instrucciones if, do, while y for, así como en el operador condicional ?:.

El valor predeterminado del tipo bool es false .

Literales
Puede usar los literales true y false para inicializar una variable bool o para pasar un
valor bool :

C#

bool check = true;

Console.WriteLine(check ? "Checked" : "Not checked"); // output: Checked

Console.WriteLine(false ? "Checked" : "Not checked"); // output: Not

checked

Lógica booleana de tres valores

Use el tipo bool? que acepta valores NULL si tiene que admitir la lógica de tres valores
(por ejemplo, si trabaja con bases de datos que admiten un tipo booleano de tres
valores). En el caso de los operandos bool? , los operadores predefinidos & y | admiten
la lógica de tres valores. Para más información, consulte la sección Operadores lógicos
booleanos que aceptan valores NULL del artículo Operadores lógicos booleanos.

Para más información sobre los tipos de valor que admiten un valor NULL, consulte
Tipos de valor que admiten un valor NULL.

Conversiones
C# solo proporciona dos conversiones que implican al tipo bool . Son una conversión
implícita al tipo bool? que acepta valores NULL correspondiente y una conversión
explícita del tipo bool? . Sin embargo, .NET proporciona métodos adicionales que se
pueden usar para realizar una conversión al tipo bool , o bien revertirla. Para obtener
más información, vea la sección Convertir a y desde valores booleanos de la página de
referencia de la API System.Boolean.

Especificación del lenguaje C#

Para obtener más información, vea la sección Tipo bool de la especificación del lenguaje
C#.

Vea también
Referencia de C#
Tipos de valor
operadores true y false
default (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Puede usar la palabra clave default en los contextos siguientes:

Para especificar el caso predeterminado en la instrucción switch.

Como el operador predeterminado o literal para generar el valor predeterminado
de un tipo.
Como restricción de tipo default en una invalidación de método genérico o una
implementación de interfaz explícita.

Vea también
Referencia de C#
Palabras clave de C#
add (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual add se usa para definir un descriptor de acceso de eventos
personalizado que se invoca cuando el código de cliente se suscribe a su evento. Si
proporciona un descriptor de acceso add personalizado, también debe proporcionar un
descriptor de acceso remove.

Ejemplo
En el ejemplo siguiente se muestra un evento que tiene descriptores de acceso add y
remove personalizados. Para obtener el ejemplo completo, consulte Procedimiento
Implementar eventos de interfaz.

C#

class Events : IDrawingObject

event EventHandler PreDrawEvent;

event EventHandler IDrawingObject.OnDraw

add => PreDrawEvent += value;

remove => PreDrawEvent -= value;

Normalmente, no necesita proporcionar sus propios descriptores de acceso de eventos

personalizados. Los descriptores de acceso que se generan automáticamente mediante
el compilador cuando declara un evento son suficientes para la mayoría de escenarios.

Vea también
Eventos
get (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave get define un método de descriptor de acceso en una propiedad o un

indizador que devuelve el valor de la propiedad o el elemento del indizador. Para
obtener más información, consulte Propiedades, Propiedades autoimplementadas e
Indexers Indizadores.

En el ejemplo siguiente se definen unos descriptores de acceso get y set para una
propiedad denominada Seconds . Usa un campo privado denominado _seconds para
respaldar el valor de la propiedad.

C#

class TimePeriod

private double _seconds;

public double Seconds

get { return _seconds; }

set { _seconds = value; }

A menudo, el descriptor de acceso get consta de una única instrucción que devuelve un
valor, como en el ejemplo anterior. Puede implementar el descriptor de acceso get
como un miembro con forma de expresión. En el ejemplo siguiente se implementan los
descriptores de acceso get y set como miembros con forma de expresión.

C#

class TimePeriod

private double _seconds;

public double Seconds

get => _seconds;

set => _seconds = value;

En los casos sencillos en los que los descriptores de acceso get y set de una propiedad
no realizan ninguna operación aparte de establecer o recuperar un valor en un campo
de respaldo privado, puede aprovechar la compatibilidad del compilador de C# con las
propiedades implementadas automáticamente. En el ejemplo siguiente se implementa
Hours como una propiedad implementada automáticamente.

C#

class TimePeriod2

public double Hours { get; set; }

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Propiedades
init (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En C# 9 y versiones posteriores, la palabra clave init define un método de descriptor de

acceso en una propiedad o un indizador. Un establecedor de solo inicio asigna un valor
a la propiedad o al elemento indexador únicamente durante la construcción de objetos.
Esta situación exige inmutabilidad, de modo que, una vez inicializado el objeto, no se
puede volver a cambiar.

Para obtener más información y ejemplos, vea Propiedades, Propiedades

autoimplementadas e Indexadores.

En el ejemplo siguiente se definen los descriptores de acceso get y init para una
propiedad denominada YearOfBirth . Usa un campo privado denominado _yearOfBirth
para respaldar el valor de la propiedad.

C#

class Person_InitExample

private int _yearOfBirth;

public int YearOfBirth

get { return _yearOfBirth; }

init { _yearOfBirth = value; }

A menudo, el descriptor de acceso init consta de una única instrucción que asigna un
valor, como en el ejemplo anterior. Tenga en cuenta que, debido a init , lo siguiente no
funcionará:

C#

var john = new Person_InitExample

YearOfBirth = 1984

};

john.YearOfBirth = 1926; //Not allowed, as its value can only be set once in
the constructor

El descriptor de acceso init se puede usar como miembro con forma de expresión.
Ejemplo:

C#

class Person_InitExampleExpressionBodied

private int _yearOfBirth;

public int YearOfBirth

get => _yearOfBirth;

init => _yearOfBirth = value;

El descriptor de acceso init también se puede usar en propiedades implementadas

automáticamente, como se muestra en el código de ejemplo siguiente:

C#

class Person_InitExampleAutoProperty

public int YearOfBirth { get; init; }

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Propiedades
Tipo parcial (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las definiciones de tipo parcial permiten dividir la definición de una clase, estructura,
interfaz o registro en varios archivos.

En File1.cs:

C#

namespace PC

partial class A

int num = 0;

void MethodA() { }

partial void MethodC();

La declaración en File2.cs:

C#

namespace PC

partial class A

void MethodB() { }

partial void MethodC() { }

Observaciones
Dividir un tipo de clase, estructura o interfaz en varios archivos puede resultar útil
cuando trabaja con proyectos de gran tamaño o con código generado
automáticamente, como el proporcionado por el Diseñador de Windows Forms. Un tipo
parcial puede contener un método parcial. Para más información, vea Clases y métodos
parciales.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Modificadores
Introducción a los genéricos
partial (Método) (Referencia de C#)
Artículo • 10/03/2023 • Tiempo de lectura: 2 minutos

Un método parcial tiene su signatura definida en una parte de un tipo parcial y su

implementación definida en otra parte del tipo. Los métodos parciales permiten a los
diseñadores de clases proporcionar enlaces de método, similares a los controladores de
eventos, que los desarrolladores pueden decidir implementar o no. Si el desarrollador
no proporciona una implementación, el compilador quita la signatura en tiempo de
compilación. Se aplican las siguientes condiciones a los métodos parciales:

Las declaraciones deben comenzar con la palabra clave contextual partial.

Las signaturas de ambas partes del tipo parcial deben coincidir.

No se permite la palabra clave partial en constructores, finalizadores, operadores

sobrecargados, declaraciones de propiedad o declaraciones de eventos.

No es necesario que un método parcial tenga una implementación en los casos

siguientes:

No tiene ningún modificador de accesibilidad (incluido el predeterminado private).

Devuelve void.

No tiene parámetros out.

No tiene ninguno de los modificadores virtual, override, sealed, new o extern.

Cualquier método que no cumpla todas estas restricciones (por ejemplo, public virtual
partial void ) debe proporcionar una implementación.

En el ejemplo siguiente se muestra un método parcial definido en dos partes de una

clase parcial:

C#

namespace PM

partial class A

partial void OnSomethingHappened(string s);

// This part can be in a separate file.

partial class A

 // Comment out this method and the program

// will still compile.

partial void OnSomethingHappened(String s)

Console.WriteLine("Something happened: {0}", s);

Los métodos parciales también pueden ser útiles en combinación con los generadores
de código fuente. Por ejemplo, se podría definir una expresión regular con el siguiente
patrón:

C#

[GeneratedRegex("(dog|cat|fish)")]

partial bool IsPetMatch(string input);

Para más información, vea Clases y métodos parciales.

Vea también
Referencia de C#
partial (tipo)
remove (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual remove se usa para definir un descriptor de acceso de

eventos personalizado que se invoca cuando el código de cliente cancela la suscripción
a su evento. Si proporciona un descriptor de acceso remove personalizado, también
debe proporcionar un descriptor de acceso add.

Ejemplo
En el ejemplo siguiente, se muestra un evento con descriptores de acceso add y remove
personalizados. Para obtener el ejemplo completo, consulte Procedimiento Implementar
eventos de interfaz.

C#

class Events : IDrawingObject

event EventHandler PreDrawEvent;

event EventHandler IDrawingObject.OnDraw

add => PreDrawEvent += value;

remove => PreDrawEvent -= value;

Normalmente, no necesita proporcionar sus propios descriptores de acceso de eventos

personalizados. Los descriptores de acceso que se generan automáticamente mediante
el compilador cuando declara un evento son suficientes para la mayoría de escenarios.

Vea también
Eventos
set (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave set define un método de descriptor de acceso en una propiedad o

indexador que asigna el valor de la propiedad o del elemento del indexador. Para
obtener más información y ejemplos, vea Propiedades, Propiedades autoimplementadas
e Indexadores.

En el ejemplo siguiente se definen unos descriptores de acceso get y set para una
propiedad denominada Seconds . Usa un campo privado denominado _seconds para
respaldar el valor de la propiedad.

C#

class TimePeriod

private double _seconds;

public double Seconds

get { return _seconds; }

set { _seconds = value; }

A menudo, el descriptor de acceso set consta de una única instrucción que asigna un
valor, como en el ejemplo anterior. Puede implementar el descriptor de acceso set
como un miembro con forma de expresión. En el ejemplo siguiente se implementan los
descriptores de acceso get y set como miembros con forma de expresión.

C#

class TimePeriod

private double _seconds;

public double Seconds

get => _seconds;

set => _seconds = value;

En los casos sencillos en los que los descriptores de acceso get y set de una propiedad
no realizan ninguna operación aparte de establecer o recuperar un valor en un campo
de respaldo privado, puede aprovechar la compatibilidad del compilador de C# con las
propiedades implementadas automáticamente. En el ejemplo siguiente se implementa
Hours como una propiedad implementada automáticamente.

C#

class TimePeriod2

public double Hours { get; set; }

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
Propiedades
when (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual when se usa para especificar una condición de filtro en los
siguientes contextos:

En la instrucción catch de un bloque try/catch o try/catch/finally.

Como restricción de caso en la instrucción switch.
Como restricción de caso en la expresión switch.

when en una instrucción catch

La palabra clave when puede usarse en una instrucción catch para especificar una
condición que debe cumplirse para que el controlador de una excepción específica se
ejecute. Su sintaxis es:

C#

catch (ExceptionType [e]) when (expr)

donde expr es una expresión que se evalúa como un valor booleano. Si devuelve true ,
el controlador de excepciones se ejecuta; si devuelve false , no se ejecuta.

En el ejemplo siguiente se usa la palabra clave when para ejecutar condicionalmente

controladores para una HttpRequestException según el texto del mensaje de excepción.

C#

using System;

using System.Net.Http;

using System.Threading.Tasks;

class Program

static void Main()

Console.WriteLine(MakeRequest().Result);

public static async Task<string> MakeRequest()

var client = new HttpClient();

var streamTask = client.GetStringAsync("https://localHost:10000");

try

 var responseText = await streamTask;

return responseText;

catch (HttpRequestException e) when (e.Message.Contains("301"))

return "Site Moved";

catch (HttpRequestException e) when (e.Message.Contains("404"))

return "Page Not Found";

catch (HttpRequestException e)

return e.Message;

Vea también
try/catch (Instrucción)
try/catch/finally (Instrucción)
value (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual value se usa en el descriptor de acceso set de las

declaraciones propiedad y indizador. Es parecido a un parámetro de entrada de un
método. El término value hace referencia al valor que el código de cliente intenta
asignar a la propiedad o indizador. En el ejemplo siguiente, MyDerivedClass tiene una
propiedad denominada Name que usa el parámetro value para asignar una nueva
cadena al campo de respaldo name . Desde el punto de vista del código de cliente, la
operación se escribe como una simple asignación.

C#

class MyBaseClass

// virtual auto-implemented property. Overrides can only

// provide specialized behavior if they implement get and set accessors.

public virtual string Name { get; set; }

// ordinary virtual property with backing field

private int _num;

public virtual int Number

get { return _num; }

set { _num = value; }

class MyDerivedClass : MyBaseClass

private string _name;

// Override auto-implemented property with ordinary property

// to provide specialized accessor behavior.

public override string Name

get

return _name;

set

if (!string.IsNullOrEmpty(value))

_name = value;

else

_name = "Unknown";

Para obtener más información, vea los artículos Propiedades e Indizadores.

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La
especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Consulte también
Referencia de C#
Guía de programación de C#
Palabras clave de C#
instrucción yield: proporcione el
siguiente elemento.
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

La instrucción se usa yield en un iterador para proporcionar el siguiente valor de una

secuencia al iterar la secuencia. La yield instrucción tiene las dos formas siguientes:

yield return : para proporcionar el siguiente valor en iteración, como se muestra

en el ejemplo siguiente:

C#

foreach (int i in ProduceEvenNumbers(9))

Console.Write(i);

Console.Write(" ");

// Output: 0 2 4 6 8

IEnumerable<int> ProduceEvenNumbers(int upto)

for (int i = 0; i <= upto; i += 2)

yield return i;
}

yield break : para indicar explícitamente el final de la iteración, como se muestra

en el ejemplo siguiente:

C#

Console.WriteLine(string.Join(" ", TakeWhilePositive(new[] { 2, 3, 4,

5, -1, 3, 4})));

// Output: 2 3 4 5

Console.WriteLine(string.Join(" ", TakeWhilePositive(new[] { 9, 8, 7

})));

// Output: 9 8 7

IEnumerable<int> TakeWhilePositive(IEnumerable<int> numbers)

foreach (int n in numbers)

if (n > 0)

yield return n;

else

yield break;

La iteración también finaliza cuando el control llega al final de un iterador.

En los ejemplos anteriores, el tipo de valor devuelto de iteradores es IEnumerable<T>

(en casos no genéricos, se usa IEnumerable como tipo de valor devuelto de un iterador).
También puede usar IAsyncEnumerable<T> como tipo de valor devuelto de un iterador.
Esto hace que un iterador asincrónico. Use la await foreach instrucción para iterar el
resultado del iterador, como se muestra en el ejemplo siguiente:

C#

await foreach (int n in GenerateNumbersAsync(5))

Console.Write(n);

Console.Write(" ");

// Output: 0 2 4 6 8

async IAsyncEnumerable<int> GenerateNumbersAsync(int count)

for (int i = 0; i < count; i++)

yield return await ProduceNumberAsync(i);

async Task<int> ProduceNumberAsync(int seed)

await Task.Delay(1000);

return 2 * seed;

IEnumerator<T> o IEnumerator también puede ser el tipo de valor devuelto de un

iterador. Esto resulta útil al implementar el GetEnumerator método en los escenarios
siguientes:

Diseñe el tipo que implementa IEnumerable<T> o IEnumerable interfaz.

Agregue una instancia o un método de extensión GetEnumerator para habilitar la

iteración en la instancia del tipo con la foreach instrucción , como se muestra en el
ejemplo siguiente:
 C#

public static void Example()

var point = new Point(1, 2, 3);

foreach (int coordinate in point)

Console.Write(coordinate);

Console.Write(" ");

// Output: 1 2 3

public readonly record struct Point(int X, int Y, int Z)

public IEnumerator<int> GetEnumerator()

yield return X;
yield return Y;
yield return Z;
}

No se pueden usar las yield instrucciones en:

métodos con parámetros in, ref o out

expresiones lambda y métodos anónimos
métodos que contienen bloques no seguros

Ejecución de un iterador
La llamada de un iterador no la ejecuta inmediatamente, como se muestra en el ejemplo
siguiente:

C#

var numbers = ProduceEvenNumbers(5);

Console.WriteLine("Caller: about to iterate.");

foreach (int i in numbers)

Console.WriteLine($"Caller: {i}");

IEnumerable<int> ProduceEvenNumbers(int upto)

Console.WriteLine("Iterator: start.");

for (int i = 0; i <= upto; i += 2)

Console.WriteLine($"Iterator: about to yield {i}");

yield return i;
 Console.WriteLine($"Iterator: yielded {i}");

Console.WriteLine("Iterator: end.");

// Output:

// Caller: about to iterate.

// Iterator: start.

// Iterator: about to yield 0

// Caller: 0

// Iterator: yielded 0

// Iterator: about to yield 2

// Caller: 2

// Iterator: yielded 2

// Iterator: about to yield 4

// Caller: 4

// Iterator: yielded 4

// Iterator: end.

Como se muestra en el ejemplo anterior, cuando se empieza a iterar sobre el resultado

de un iterador, se ejecuta un iterador hasta que se alcanza la primera yield return
instrucción. A continuación, se suspende la ejecución de un iterador y el autor de la
llamada obtiene el primer valor de iteración y lo procesa. En cada iteración posterior, la
ejecución de un iterador se reanuda después de la yield return instrucción que
provocó la suspensión anterior y continúa hasta que se alcanza la siguiente yield
return instrucción. La iteración se completa cuando el control llega al final de un

iterador o una yield break instrucción .

Especificación del lenguaje C#

Para obtener más información, consulte la sección Instrucción yield de la especificación
del lenguaje C#.

Vea también
Referencia de C#
Iteradores
Procesar una iteración mediante colecciones en C#
foreach
await foreach
Palabras clave de consulta (Referencia
de C#)
Artículo • 22/09/2022 • Tiempo de lectura: 2 minutos

En esta sección, se incluyen las palabras clave contextuales que se usan en expresiones
de consulta.

En esta sección
Cláusula Descripción

from Especifica un origen de datos y una variable de rango (similar a una variable de
iteración).

where Filtra los elementos de origen en función de una o varias expresiones booleanas
separadas por operadores lógicos AND y OR ( && o || ).

select Especifica el tipo y la forma que tendrán los elementos de la secuencia devuelta
cuando se ejecute la consulta.

group Agrupa los resultados de la consulta según un valor clave especificado.

into Proporciona un identificador que puede actuar como una referencia a los
resultados de una combinación, un grupo o una cláusula select.

orderby Ordena los resultados de las consultas en orden ascendente o descendente según
el comparador predeterminado del tipo de elemento.

join Combina dos orígenes de datos en función de una comparación de igualdad entre
dos criterios de coincidencia especificados.

let Presenta una variable de rango para almacenar los resultados de la subexpresión en
una expresión de consulta.

in Palabra clave contextual en una cláusula join.

on Palabra clave contextual en una cláusula join.

equals Palabra clave contextual en una cláusula join.

by Palabra clave contextual en una cláusula group.

ascending Palabra clave contextual en una cláusula orderby.

descending Palabra clave contextual en una cláusula orderby.

Vea también
Palabras clave de C#
LINQ (Language Integrated Query)
LINQ en C#
from (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

Una expresión de consulta debe comenzar con una cláusula from , Además, una
expresión de consulta puede contener subconsultas, que también comienzan con una
cláusula from . La cláusula from especifica lo siguiente:

El origen de datos en el que se ejecutará la consulta o subconsulta.

Una variable de rango local que representa cada elemento de la secuencia de

origen.

Tanto la variable de rango como el origen de datos están fuertemente tipados. El origen
de datos al que se hace referencia en la cláusula from debe tener un tipo de
IEnumerable, IEnumerable<T> o un tipo derivado como IQueryable<T>.

En el ejemplo siguiente, numbers es el origen de datos y num es la variable de rango.

Tenga en cuenta que ambas variables están fuertemente tipadas a pesar de que se usa
la palabra clave var.

C#

class LowNums

static void Main()

// A simple data source.

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

// Create the query.

// lowNums is an IEnumerable<int>

var lowNums = from num in numbers

where num < 5

select num;

// Execute the query.

foreach (int i in lowNums)

Console.Write(i + " ");

// Output: 4 1 3 2 0

Variable de rango
El compilador deduce el tipo de la variable de rango cuando el origen de datos
implementa IEnumerable<T>. Por ejemplo, si el origen tiene un tipo de
IEnumerable<Customer> , entonces se deduce que la variable de rango es Customer . La

única vez en que debe especificar el tipo explícitamente es cuando el origen es un tipo
IEnumerable no genérico como ArrayList. Para obtener más información, vea

Procedimiento para consultar un objeto ArrayList con LINQ (C#).

En el ejemplo anterior, num se deduce que es de tipo int . Como la variable de rango
está fuertemente tipada, puede llamar a los métodos en ella o usarla en otras
operaciones. Por ejemplo, en lugar de escribir select num , podría escribir select
num.ToString() para hacer que la expresión de consulta devuelva una secuencia de

cadenas en lugar de enteros. O podría escribir select num + 10 para hacer que la
expresión devuelva la secuencia 14, 11, 13, 12, 10. Para obtener más información, vea
Cláusula select.

La variable de rango es como una variable de iteración en una instrucción foreach

excepto por una diferencia muy importante: una variable de rango realmente nunca
almacena datos del origen. Es solo una comodidad sintáctica que permite a la consulta
describir lo que ocurrirá cuando se ejecute la consulta. Para obtener más información,
vea Introducción a las consultas LINQ (C#).

Cláusulas From compuestas

En algunos casos, cada elemento de la secuencia de origen puede ser por sí mismo una
secuencia o contener una. Por ejemplo, su origen de datos puede ser un
IEnumerable<Student> donde cada objeto de estudiante en la secuencia contiene una

lista de resultados de las pruebas. Para tener acceso a la lista interna dentro de cada
elemento Student , puede usar las cláusulas from compuestas. La técnica es como usar
instrucciones foreach anidadas. Puede agregar cláusulas where u orderby a cualquier
cláusula from para filtrar los resultados. En el ejemplo siguiente se muestra una
secuencia de objetos Student , cada uno de los cuales contiene un List interno de
enteros que representa los resultados de las pruebas. Para tener acceso a la lista interna,
use una cláusula from compuesta. Puede insertar cláusulas entre las dos cláusulas from
si es necesario.

C#

class CompoundFrom

// The element type of the data source.

public class Student

 public string LastName { get; set; }

public List<int> Scores {get; set;}

static void Main()

// Use a collection initializer to create the data source. Note that

// each element in the list contains an inner sequence of scores.

List<Student> students = new List<Student>

new Student {LastName="Omelchenko", Scores= new List<int> {97,

72, 81, 60}},

new Student {LastName="O'Donnell", Scores= new List<int> {75, 84,

91, 39}},

new Student {LastName="Mortensen", Scores= new List<int> {88, 94,

65, 85}},

new Student {LastName="Garcia", Scores= new List<int> {97, 89,

85, 82}},

new Student {LastName="Beebe", Scores= new List<int> {35, 72, 91,

70}}

};

// Use a compound from to access the inner sequence within each

element.

// Note the similarity to a nested foreach statement.

var scoreQuery = from student in students

from score in student.Scores

where score > 90

select new { Last = student.LastName, score };

// Execute the queries.

Console.WriteLine("scoreQuery:");

// Rest the mouse pointer on scoreQuery in the following line to

// see its type. The type is IEnumerable<'a>, where 'a is an

// anonymous type defined as new {string Last, int score}. That is,

// each instance of this anonymous type has two members, a string

// (Last) and an int (score).

foreach (var student in scoreQuery)

Console.WriteLine("{0} Score: {1}", student.Last,

student.score);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/*

scoreQuery:

Omelchenko Score: 97

O'Donnell Score: 91

Mortensen Score: 94

Garcia Score: 97

 Beebe Score: 91

*/

Usar cláusulas From múltiples para realizar

combinaciones
Una cláusula from compuesta se usa para tener acceso a las colecciones internas en un
origen de datos único. En cambio, una consulta también puede contener varias cláusulas
from que generan consultas adicionales de orígenes de datos independientes. Esta

técnica le permite realizar determinados tipos de operaciones de combinación que no

son posibles mediante la cláusula join.

En el siguiente ejemplo se muestra cómo pueden usarse dos cláusulas from para formar
una combinación cruzada completa de dos orígenes de datos.

C#

class CompoundFrom2

static void Main()

char[] upperCase = { 'A', 'B', 'C' };

char[] lowerCase = { 'x', 'y', 'z' };

// The type of joinQuery1 is IEnumerable<'a>, where 'a

// indicates an anonymous type. This anonymous type has two

// members, upper and lower, both of type char.

var joinQuery1 =

from upper in upperCase

from lower in lowerCase

select new { upper, lower };

// The type of joinQuery2 is IEnumerable<'a>, where 'a

// indicates an anonymous type. This anonymous type has two

// members, upper and lower, both of type char.

var joinQuery2 =

from lower in lowerCase

where lower != 'x'

from upper in upperCase

select new { lower, upper };

// Execute the queries.

Console.WriteLine("Cross join:");

// Rest the mouse pointer on joinQuery1 to verify its type.

foreach (var pair in joinQuery1)

Console.WriteLine("{0} is matched to {1}", pair.upper,

pair.lower);

Console.WriteLine("Filtered non-equijoin:");

// Rest the mouse pointer over joinQuery2 to verify its type.

foreach (var pair in joinQuery2)

Console.WriteLine("{0} is matched to {1}", pair.lower,

pair.upper);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Cross join:

A is matched to x

A is matched to y

A is matched to z

B is matched to x

B is matched to y

B is matched to z

C is matched to x

C is matched to y

C is matched to z

Filtered non-equijoin:

y is matched to A

y is matched to B

y is matched to C

z is matched to A

z is matched to B

z is matched to C

*/

Para obtener más información sobre las operaciones de combinación que usan varias
cláusulas from , vea Realizar operaciones de combinación externa izquierda.

Vea también
Palabras clave para consultas (LINQ)
Language-Integrated Query (LINQ)
where (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 3 minutos

La cláusula where se usa en una expresión de consulta para especificar los elementos
del origen de datos que se devuelven en dicha expresión. Aplica una condición
booleana (predicate) a cada elemento de origen (al que hace referencia la variable de
rango) y devuelve aquellos en los que la condición especificada se cumple. Puede que
una sola expresión de consulta contenga varias cláusulas where y que una sola cláusula
contenga varias subexpresiones de predicado.

Ejemplo 1
En el ejemplo siguiente, la cláusula where filtra todos los números excepto los que son
inferiores a cinco. Si la cláusula where se quita, se devolverán todos los números del
origen de datos. La expresión num < 5 es el predicado que se aplica a cada elemento.

C#

class WhereSample

static void Main()

// Simple data source. Arrays support IEnumerable<T>.

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

// Simple query with one predicate in where clause.

var queryLowNums =

from num in numbers

where num < 5

select num;

// Execute the query.

foreach (var s in queryLowNums)

Console.Write(s.ToString() + " ");

//Output: 4 1 3 2 0

Ejemplo 2
En una sola cláusula where , se pueden especificar todos los predicados que sean
necesarios mediante los operadores && y ||. En el ejemplo siguiente, la consulta
especifica dos predicados para seleccionar únicamente los números pares que sean
inferiores a cinco.

C#

class WhereSample2

static void Main()

// Data source.

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

// Create the query with two predicates in where clause.

var queryLowNums2 =

from num in numbers

where num < 5 && num % 2 == 0

select num;

// Execute the query

foreach (var s in queryLowNums2)

Console.Write(s.ToString() + " ");

Console.WriteLine();

// Create the query with two where clause.

var queryLowNums3 =

from num in numbers

where num < 5

where num % 2 == 0

select num;

// Execute the query

foreach (var s in queryLowNums3)

Console.Write(s.ToString() + " ");

// Output:

// 4 2 0

// 4 2 0

Ejemplo 3
Puede que una cláusula where contenga uno o más métodos que devuelvan valores
booleanos. En el ejemplo siguiente, la cláusula where usa un método para determinar si
el valor actual de la variable de rango es par o impar.

C#
 class WhereSample3

static void Main()

// Data source

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

// Create the query with a method call in the where clause.

// Note: This won't work in LINQ to SQL unless you have a

// stored procedure that is mapped to a method by this name.

var queryEvenNums =

from num in numbers

where IsEven(num)

select num;

// Execute the query.

foreach (var s in queryEvenNums)

Console.Write(s.ToString() + " ");

// Method may be instance method or static method.

static bool IsEven(int i)

return i % 2 == 0;

//Output: 4 8 6 2 0

Observaciones
La cláusula where es un mecanismo de filtrado. Se puede colocar prácticamente en
cualquier parte en una expresión de consulta, pero no puede ser la primera ni la última
cláusula. Puede que una cláusula where aparezca antes o después de una cláusula
group, en función de que haya que filtrar los elementos de origen antes o después de
agruparlos.

Si un predicado especificado no es válido para los elementos del origen de datos, se

producirá un error en tiempo de compilación. Esta es una de las ventajas de la
comprobación fuertemente tipada que ofrece LINQ.

En tiempo de compilación, la palabra clave where se convierte en una llamada al

método de operador de consulta estándar Where.

Vea también
Palabras clave para consultas (LINQ)
from (cláusula)
select (cláusula)
Filtrado de datos
LINQ en C#
Language-Integrated Query (LINQ)
select (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 6 minutos

En una expresión de consulta, la cláusula select especifica el tipo de valores que se

producirán cuando se ejecute la consulta. El resultado se basa en la evaluación de todas
las cláusulas anteriores y en cualquier expresión de la propia cláusula select . Una
expresión de consulta debe finalizar con una cláusula select o con una cláusula group.

En el ejemplo siguiente, se muestra una cláusula select simple en una expresión de

consulta.

C#

class SelectSample1

static void Main()

//Create the data source

List<int> Scores = new List<int>() { 97, 92, 81, 60 };

// Create the query.

IEnumerable<int> queryHighScores =

from score in Scores

where score > 80

select score;

// Execute the query.

foreach (int i in queryHighScores)

Console.Write(i + " ");

//Output: 97 92 81

El tipo de la secuencia generada por la cláusula select determina el tipo de la variable

de consulta queryHighScores . En el caso más simple, la cláusula select simplemente
especifica la variable de rango. Esto hace que la secuencia devuelta contenga elementos
del mismo tipo que el origen de datos. Para obtener más información, vea Relaciones
entre tipos en operaciones de consulta LINQ. En cambio, la cláusula select también
proporciona un mecanismo eficaz para transformar (o proyectar) el origen de datos en
nuevos tipos. Para obtener más información, vea Transformaciones de datos con LINQ
(C#).
Ejemplo
En el ejemplo siguiente, se muestran las distintas formas que puede tener una cláusula
select . En cada consulta, tenga en cuenta la relación entre la cláusula select y el tipo

de la variable de consulta ( studentQuery1 , studentQuery2 , etc.).

C#

class SelectSample2

// Define some classes

public class Student

public string First { get; set; }

public string Last { get; set; }

public int ID { get; set; }

public List<int> Scores;

public ContactInfo GetContactInfo(SelectSample2 app, int id)

ContactInfo cInfo =

(from ci in app.contactList

where ci.ID == id

select ci)

.FirstOrDefault();

return cInfo;

public override string ToString()

return First + " " + Last + ":" + ID;

public class ContactInfo

public int ID { get; set; }

public string Email { get; set; }

public string Phone { get; set; }

public override string ToString() { return Email + "," + Phone;

}

public class ScoreInfo

public double Average { get; set; }

public int ID { get; set; }

// The primary data source

List<Student> students = new List<Student>()

 new Student {First="Svetlana", Last="Omelchenko", ID=111,

Scores= new List<int>() {97, 92, 81, 60}},

new Student {First="Claire", Last="O'Donnell", ID=112, Scores=

new List<int>() {75, 84, 91, 39}},

new Student {First="Sven", Last="Mortensen", ID=113, Scores=

new List<int>() {88, 94, 65, 91}},

new Student {First="Cesar", Last="Garcia", ID=114, Scores= new

List<int>() {97, 89, 85, 82}},

};

// Separate data source for contact info.

List<ContactInfo> contactList = new List<ContactInfo>()

new ContactInfo {ID=111, Email="[email protected]",

Phone="206-555-0108"},

new ContactInfo {ID=112, Email="[email protected]",

Phone="206-555-0298"},

new ContactInfo {ID=113, Email="[email protected]",

Phone="206-555-1130"},

new ContactInfo {ID=114, Email="[email protected]",

Phone="206-555-0521"}

};

static void Main(string[] args)

SelectSample2 app = new SelectSample2();

// Produce a filtered sequence of unmodified Students.

IEnumerable<Student> studentQuery1 =

from student in app.students

where student.ID > 111

select student;

Console.WriteLine("Query1: select range_variable");

foreach (Student s in studentQuery1)

Console.WriteLine(s.ToString());

// Produce a filtered sequence of elements that contain

// only one property of each Student.

IEnumerable<String> studentQuery2 =

from student in app.students

where student.ID > 111

select student.Last;

Console.WriteLine("\r\n studentQuery2: select

range_variable.Property");

foreach (string s in studentQuery2)

Console.WriteLine(s);

// Produce a filtered sequence of objects created by

// a method call on each Student.

 IEnumerable<ContactInfo> studentQuery3 =

from student in app.students

where student.ID > 111

select student.GetContactInfo(app, student.ID);

Console.WriteLine("\r\n studentQuery3: select

range_variable.Method");

foreach (ContactInfo ci in studentQuery3)

Console.WriteLine(ci.ToString());

// Produce a filtered sequence of ints from

// the internal array inside each Student.

IEnumerable<int> studentQuery4 =

from student in app.students

where student.ID > 111

select student.Scores[0];

Console.WriteLine("\r\n studentQuery4: select

range_variable[index]");

foreach (int i in studentQuery4)

Console.WriteLine("First score = {0}", i);

// Produce a filtered sequence of doubles

// that are the result of an expression.

IEnumerable<double> studentQuery5 =

from student in app.students

where student.ID > 111

select student.Scores[0] * 1.1;

Console.WriteLine("\r\n studentQuery5: select expression");

foreach (double d in studentQuery5)

Console.WriteLine("Adjusted first score = {0}", d);

// Produce a filtered sequence of doubles that are

// the result of a method call.

IEnumerable<double> studentQuery6 =

from student in app.students

where student.ID > 111

select student.Scores.Average();

Console.WriteLine("\r\n studentQuery6: select expression2");

foreach (double d in studentQuery6)

Console.WriteLine("Average = {0}", d);

// Produce a filtered sequence of anonymous types

// that contain only two properties from each Student.

var studentQuery7 =

 from student in app.students

where student.ID > 111

select new { student.First, student.Last };

Console.WriteLine("\r\n studentQuery7: select new anonymous

type");

foreach (var item in studentQuery7)

Console.WriteLine("{0}, {1}", item.Last, item.First);

// Produce a filtered sequence of named objects that contain

// a method return value and a property from each Student.

// Use named types if you need to pass the query variable

// across a method boundary.

IEnumerable<ScoreInfo> studentQuery8 =

from student in app.students

where student.ID > 111

select new ScoreInfo

Average = student.Scores.Average(),

ID = student.ID

};

Console.WriteLine("\r\n studentQuery8: select new named type");

foreach (ScoreInfo si in studentQuery8)

Console.WriteLine("ID = {0}, Average = {1}", si.ID,

si.Average);

// Produce a filtered sequence of students who appear on a

contact list

// and whose average is greater than 85.

IEnumerable<ContactInfo> studentQuery9 =

from student in app.students

where student.Scores.Average() > 85

join ci in app.contactList on student.ID equals ci.ID

select ci;

Console.WriteLine("\r\n studentQuery9: select result of join

clause");

foreach (ContactInfo ci in studentQuery9)

Console.WriteLine("ID = {0}, Email = {1}", ci.ID, ci.Email);

// Keep the console window open in debug mode

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output

Query1: select range_variable

Claire O'Donnell:112

 Sven Mortensen:113

Cesar Garcia:114

studentQuery2: select range_variable.Property

O'Donnell

Mortensen

Garcia

studentQuery3: select range_variable.Method

[email protected],206-555-0298

[email protected],206-555-1130

[email protected],206-555-0521

studentQuery4: select range_variable[index]

First score = 75

First score = 88

First score = 97

studentQuery5: select expression

Adjusted first score = 82.5

Adjusted first score = 96.8

Adjusted first score = 106.7

studentQuery6: select expression2

Average = 72.25

Average = 84.5

Average = 88.25

studentQuery7: select new anonymous type

O'Donnell, Claire

Mortensen, Sven

Garcia, Cesar

studentQuery8: select new named type

ID = 112, Average = 72.25

ID = 113, Average = 84.5

ID = 114, Average = 88.25

studentQuery9: select result of join clause

ID = 114, Email = [email protected]

*/

Como se muestra en studentQuery8 en el ejemplo anterior, a veces es posible que

quiera que los elementos de la secuencia devuelta contengan solo un subconjunto de
las propiedades de los elementos de origen. Al mantener la secuencia devuelta lo más
pequeña posible, puede reducir los requisitos de memoria y aumentar la velocidad de
ejecución de la consulta. Puede hacerlo al crear un tipo anónimo en la cláusula select y
usar un inicializador de objeto para inicializarlo con las propiedades adecuadas del
elemento de origen. Para obtener un ejemplo de cómo hacerlo, consulte Inicializadores
de objeto y de colección.
Observaciones
En tiempo de compilación, la cláusula select se convierte en una llamada de método al
operador de consulta estándar Select.

Vea también
Referencia de C#
Palabras clave para consultas (LINQ)
from (cláusula)
partial (Método) (Referencia de C#)
Tipos anónimos
LINQ en C#
Language-Integrated Query (LINQ)
group (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

La cláusula group devuelve una secuencia de objetos IGrouping<TKey,TElement> que

contienen cero o más elementos que coinciden con el valor de clave del grupo. Por
ejemplo, puede agrupar una secuencia de cadenas según la primera letra de cada
cadena. En este caso, la primera letra es la clave, es de tipo char y se almacena en la
propiedad Key de cada objeto IGrouping<TKey,TElement>. El compilador deduce el
tipo de la clave.

Puede finalizar una expresión de consulta con una cláusula group , como se muestra en
el ejemplo siguiente:

C#

// Query variable is an IEnumerable<IGrouping<char, Student>>

var studentQuery1 =

from student in students

group student by student.Last[0];

Si quiere realizar operaciones de consulta adicionales en cada grupo, puede especificar

un identificador temporal mediante la palabra clave contextual into. Cuando se usa
into , es necesario continuar con la consulta y finalmente terminarla con una instrucción
select u otra cláusula group , como se muestra en el extracto siguiente:

C#

// Group students by the first letter of their last name

// Query variable is an IEnumerable<IGrouping<char, Student>>

var studentQuery2 =

from student in students

group student by student.Last[0] into g

orderby g.Key

select g;

En la sección Ejemplo de este artículo se proporcionan ejemplos más completos sobre el

uso de group con y sin into .

Enumeración de los resultados de una consulta

de grupo
Dado que los objetos IGrouping<TKey,TElement> generados por una consulta group
son esencialmente una lista de listas, debe usar un bucle foreach anidado para tener
acceso a los elementos de cada grupo. El bucle exterior recorre en iteración las claves de
grupo y el bucle interno recorre en iteración cada elemento del propio grupo. Un grupo
puede tener una clave pero ningún elemento. A continuación se muestra el bucle
foreach que ejecuta la consulta en los ejemplos de código anteriores:

C#

// Iterate group items with a nested foreach. This IGrouping encapsulates

// a sequence of Student objects, and a Key of type char.

// For convenience, var can also be used in the foreach statement.

foreach (IGrouping<char, Student> studentGroup in studentQuery2)

Console.WriteLine(studentGroup.Key);

// Explicit type for student could also be used here.

foreach (var student in studentGroup)

Console.WriteLine(" {0}, {1}", student.Last, student.First);

Tipos de clave
Las claves de grupo pueden ser de cualquier tipo, como una cadena, un tipo numérico
integrado, un tipo con nombre definido por el usuario o un tipo anónimo.

Agrupar por cadena

En los ejemplos de código anteriores se ha usado el tipo char . En su lugar, podría
haberse especificado una clave de cadena, por ejemplo, los apellidos completos:

C#

// Same as previous example except we use the entire last name as a key.

// Query variable is an IEnumerable<IGrouping<string, Student>>

var studentQuery3 =

from student in students

group student by student.Last;

Agrupar por valor booleano

En el ejemplo siguiente se muestra el uso de un valor booleano para una clave con el fin
de dividir los resultados en dos grupos. Observe que el valor se genera a partir de una
subexpresión en la cláusula group .

C#

class GroupSample1

// The element type of the data source.

public class Student

public string First { get; set; }

public string Last { get; set; }

public int ID { get; set; }

public List<int> Scores;

public static List<Student> GetStudents()

// Use a collection initializer to create the data source. Note that

each element

// in the list contains an inner sequence of scores.

List<Student> students = new List<Student>

new Student {First="Svetlana", Last="Omelchenko", ID=111, Scores=

new List<int> {97, 72, 81, 60}},

new Student {First="Claire", Last="O'Donnell", ID=112, Scores=

new List<int> {75, 84, 91, 39}},

new Student {First="Sven", Last="Mortensen", ID=113, Scores= new

List<int> {99, 89, 91, 95}},

new Student {First="Cesar", Last="Garcia", ID=114, Scores= new

List<int> {72, 81, 65, 84}},

new Student {First="Debra", Last="Garcia", ID=115, Scores= new

List<int> {97, 89, 85, 82}}

};

return students;

static void Main()

// Obtain the data source.

List<Student> students = GetStudents();

// Group by true or false.

// Query variable is an IEnumerable<IGrouping<bool, Student>>

var booleanGroupQuery =

from student in students

group student by student.Scores.Average() >= 80; //pass or fail!

// Execute the query and access items in each group

foreach (var studentGroup in booleanGroupQuery)

Console.WriteLine(studentGroup.Key == true ? "High averages" :

"Low averages");

foreach (var student in studentGroup)

Console.WriteLine(" {0}, {1}:{2}", student.Last,

student.First, student.Scores.Average());

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Low averages

Omelchenko, Svetlana:77.5

O'Donnell, Claire:72.25

Garcia, Cesar:75.5

High averages

Mortensen, Sven:93.5

Garcia, Debra:88.25

*/

Agrupar por intervalo numérico

En el ejemplo siguiente se usa una expresión para crear claves de grupo numéricas que
representan un intervalo de percentil. Observe el uso de let como ubicación adecuada
para almacenar el resultado de una llamada de método, para no tener que llamar al
método dos veces en la cláusula group . Para más información sobre cómo usar métodos
en expresiones de consulta de manera segura, consulte Controlar excepciones en
expresiones de consulta.

C#

class GroupSample2

// The element type of the data source.

public class Student

public string First { get; set; }

public string Last { get; set; }

public int ID { get; set; }

public List<int> Scores;

public static List<Student> GetStudents()

// Use a collection initializer to create the data source. Note that

each element

// in the list contains an inner sequence of scores.

List<Student> students = new List<Student>

 new Student {First="Svetlana", Last="Omelchenko", ID=111, Scores=

new List<int> {97, 72, 81, 60}},

new Student {First="Claire", Last="O'Donnell", ID=112, Scores=

new List<int> {75, 84, 91, 39}},

new Student {First="Sven", Last="Mortensen", ID=113, Scores= new

List<int> {99, 89, 91, 95}},

new Student {First="Cesar", Last="Garcia", ID=114, Scores= new

List<int> {72, 81, 65, 84}},

new Student {First="Debra", Last="Garcia", ID=115, Scores= new

List<int> {97, 89, 85, 82}}

};

return students;

// This method groups students into percentile ranges based on their

// grade average. The Average method returns a double, so to produce a

whole

// number it is necessary to cast to int before dividing by 10.

static void Main()

// Obtain the data source.

List<Student> students = GetStudents();

// Write the query.

var studentQuery =

from student in students

let avg = (int)student.Scores.Average()

group student by (avg / 10) into g

orderby g.Key

select g;

// Execute the query.

foreach (var studentGroup in studentQuery)

int temp = studentGroup.Key * 10;

Console.WriteLine("Students with an average between {0} and

{1}", temp, temp + 10);

foreach (var student in studentGroup)

Console.WriteLine(" {0}, {1}:{2}", student.Last,

student.First, student.Scores.Average());

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Students with an average between 70 and 80

Omelchenko, Svetlana:77.5

O'Donnell, Claire:72.25

Garcia, Cesar:75.5

 Students with an average between 80 and 90

Garcia, Debra:88.25

Students with an average between 90 and 100

Mortensen, Sven:93.5

*/

Agrupación por claves compuestas

Use una clave compuesta cuando quiera agrupar los elementos según más de una clave.
Para crear una clave compuesta se usa un tipo anónimo o un tipo con nombre para
contener el elemento de clave. En el ejemplo siguiente, supongamos que una clase
Person se ha declarado con los miembros denominados surname y city . La cláusula
group hace que se cree un grupo independiente para cada conjunto de personas con el

mismo apellido y la misma ciudad.

C#

group person by new {name = person.surname, city = person.city};

Use un tipo con nombre si debe pasar la variable de consulta a otro método. Cree una
clase especial usando las propiedades autoimplementadas para las claves y, luego,
invalide los métodos Equals y GetHashCode. También puede usar un struct, en cuyo
caso no es estrictamente necesario invalidar esos métodos. Para más información,
consulte Procedimiento Implementar una clase ligera con propiedades
autoimplementadas y Procedimiento para buscar archivos duplicados en un árbol de
directorios. El último artículo contiene un ejemplo de código en el que se muestra cómo
usar una clave compuesta con un tipo con nombre.

Ejemplo 1
En el ejemplo siguiente se muestra el patrón estándar para ordenar los datos de origen
en grupos cuando no se aplica ninguna lógica de consulta adicional a los grupos. Esto
se denomina agrupación sin continuación. Los elementos de una matriz de cadenas se
agrupan por la primera letra. El resultado de la consulta es un tipo
IGrouping<TKey,TElement> que contiene una propiedad Key pública de tipo char y
una colección IEnumerable<T> que contiene cada elemento de la agrupación.

El resultado de una cláusula group es una secuencia de secuencias. Por consiguiente,

para tener acceso a los elementos individuales de cada grupo devuelto, use un bucle
foreach anidado dentro del bucle que recorre en iteración las claves de grupo, como se

muestra en el ejemplo siguiente.

 C#

class GroupExample1

static void Main()

// Create a data source.

string[] words = { "blueberry", "chimpanzee", "abacus", "banana",

"apple", "cheese" };

// Create the query.

var wordGroups =

from w in words

group w by w[0];

// Execute the query.

foreach (var wordGroup in wordGroups)

Console.WriteLine("Words that start with the letter '{0}':",

wordGroup.Key);

foreach (var word in wordGroup)

Console.WriteLine(word);

// Keep the console window open in debug mode

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Words that start with the letter 'b':

blueberry

banana

Words that start with the letter 'c':

chimpanzee

cheese

Words that start with the letter 'a':

abacus

apple

*/

Ejemplo 2
En este ejemplo se muestra cómo aplicar lógica adicional a los grupos después de
haberlos creado, mediante el uso de una continuación con into . Para obtener más
información, vea into. En el ejemplo siguiente se consulta cada grupo para seleccionar
solo aquellos cuyo valor de clave sea una vocal.
 C#

class GroupClauseExample2

static void Main()

// Create the data source.

string[] words2 = { "blueberry", "chimpanzee", "abacus", "banana",

"apple", "cheese", "elephant", "umbrella", "anteater" };

// Create the query.

var wordGroups2 =

from w in words2

group w by w[0] into grps

where (grps.Key == 'a' || grps.Key == 'e' || grps.Key == 'i'

|| grps.Key == 'o' || grps.Key == 'u')

select grps;

// Execute the query.

foreach (var wordGroup in wordGroups2)

Console.WriteLine("Groups that start with a vowel: {0}",

wordGroup.Key);

foreach (var word in wordGroup)

Console.WriteLine(" {0}", word);

// Keep the console window open in debug mode

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Groups that start with a vowel: a

abacus

apple

anteater

Groups that start with a vowel: e

elephant

Groups that start with a vowel: u

umbrella

*/

Comentarios
En tiempo de compilación, las cláusulas group se convierten en llamadas al método
GroupBy.
Consulte también
IGrouping<TKey,TElement>
GroupBy
ThenBy
ThenByDescending
Palabras clave para consultas
Language-Integrated Query (LINQ)
Crear grupos anidados
Agrupar los resultados de consultas
Realizar una subconsulta en una operación de agrupación
into (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual into puede usarse para crear un identificador temporal para
almacenar los resultados de una cláusula group, join o select en un nuevo identificador.
Este identificador puede ser un generador de comandos de consulta adicionales.
Cuando se usa en una cláusula group o select , el uso del nuevo identificador se
denomina a veces una continuación.

Ejemplo
En el ejemplo siguiente, se muestra el uso de la palabra clave into para habilitar un
identificador temporal fruitGroup que tiene un tipo deducido de IGrouping . Mediante
el identificador, puede invocar el método Count en cada grupo y seleccionar solo los
grupos que contienen dos o más palabras.

C#

class IntoSample1

static void Main()

// Create a data source.

string[] words = { "apples", "blueberries", "oranges", "bananas",

"apricots"};

// Create the query.

var wordGroups1 =

from w in words

group w by w[0] into fruitGroup

where fruitGroup.Count() >= 2

select new { FirstLetter = fruitGroup.Key, Words =

fruitGroup.Count() };

// Execute the query. Note that we only iterate over the groups,

// not the items in each group

foreach (var item in wordGroups1)

Console.WriteLine(" {0} has {1} elements.", item.FirstLetter,

item.Words);

// Keep the console window open in debug mode

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

a has 2 elements.

b has 2 elements.

*/

El uso de into en una cláusula group solo es necesario cuando quiere realizar
operaciones de consulta adicionales en cada grupo. Para obtener más información, vea
group (Cláusula).

Para obtener un ejemplo del uso de into en una cláusula join , vea join (Cláusula).

Vea también
Palabras clave para consultas (LINQ)
LINQ en C#
group (cláusula)
orderby (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En una expresión de consulta, la cláusula orderby hace que la secuencia o subsecuencia

(grupo) devuelta se ordene de forma ascendente o descendente. Se pueden especificar
varias claves para llevar a cabo una o varias operaciones de ordenación secundaria. La
ordenación se realiza mediante el comparador predeterminado del tipo de elemento. El
criterio de ordenación predeterminado es el ascendente. También puede especificar un
comparador personalizado. En cambio, solo está disponible mediante la sintaxis basada
en métodos. Para obtener más información, consulte Sorting Data (Ordenación de
datos).

Ejemplo 1
En el ejemplo siguiente, la primera consulta ordena las palabras en orden alfabético a
partir de la A y la segunda consulta ordena las mismas palabras en orden descendente.
(La palabra clave ascending es el valor de ordenación predeterminado y puede
omitirse).

C#

class OrderbySample1

static void Main()

// Create a delicious data source.

string[] fruits = { "cherry", "apple", "blueberry" };

// Query for ascending sort.

IEnumerable<string> sortAscendingQuery =

from fruit in fruits

orderby fruit //"ascending" is default

select fruit;

// Query for descending sort.

IEnumerable<string> sortDescendingQuery =

from w in fruits

orderby w descending

select w;

// Execute the query.

Console.WriteLine("Ascending:");

foreach (string s in sortAscendingQuery)

Console.WriteLine(s);
}

 // Execute the query.

Console.WriteLine(Environment.NewLine + "Descending:");

foreach (string s in sortDescendingQuery)

Console.WriteLine(s);
}

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

Ascending:

apple

blueberry

cherry

Descending:

cherry

blueberry

apple

*/

Ejemplo 2
En el ejemplo siguiente, se realiza una ordenación primaria por apellidos de los alumnos
y, después, una ordenación secundaria por sus nombres.

C#

class OrderbySample2

// The element type of the data source.

public class Student

public string First { get; set; }

public string Last { get; set; }

public int ID { get; set; }

public static List<Student> GetStudents()

// Use a collection initializer to create the data source. Note that

each element

// in the list contains an inner sequence of scores.

List<Student> students = new List<Student>

new Student {First="Svetlana", Last="Omelchenko", ID=111},

new Student {First="Claire", Last="O'Donnell", ID=112},

 new Student {First="Sven", Last="Mortensen", ID=113},

new Student {First="Cesar", Last="Garcia", ID=114},

new Student {First="Debra", Last="Garcia", ID=115}

};

return students;

static void Main(string[] args)

// Create the data source.

List<Student> students = GetStudents();

// Create the query.

IEnumerable<Student> sortedStudents =

from student in students

orderby student.Last ascending, student.First ascending

select student;

// Execute the query.

Console.WriteLine("sortedStudents:");

foreach (Student student in sortedStudents)

Console.WriteLine(student.Last + " " + student.First);

// Now create groups and sort the groups. The query first sorts the
names

// of all students so that they will be in alphabetical order after

they are

// grouped. The second orderby sorts the group keys in alpha order.

var sortedGroups =

from student in students

orderby student.Last, student.First

group student by student.Last[0] into newGroup

orderby newGroup.Key

select newGroup;

// Execute the query.

Console.WriteLine(Environment.NewLine + "sortedGroups:");

foreach (var studentGroup in sortedGroups)

Console.WriteLine(studentGroup.Key);

foreach (var student in studentGroup)

Console.WriteLine(" {0}, {1}", student.Last,

student.First);

// Keep the console window open in debug mode

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

sortedStudents:

Garcia Cesar

 Garcia Debra

Mortensen Sven

O'Donnell Claire

Omelchenko Svetlana

sortedGroups:

Garcia, Cesar

Garcia, Debra

Mortensen, Sven

O'Donnell, Claire

Omelchenko, Svetlana

*/

Comentarios
En tiempo de compilación, la cláusula orderby se convierte en una llamada al método
OrderBy. Varias claves en la cláusula orderby se convierten en llamadas al método
ThenBy.

Vea también
Referencia de C#
Palabras clave para consultas (LINQ)
LINQ en C#
group (cláusula)
Language-Integrated Query (LINQ)
join (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 10 minutos

La cláusula join es útil para asociar elementos de secuencias de origen diferentes que
no tienen ninguna relación directa en el modelo de objetos. El único requisito es que los
elementos de cada origen compartan algún valor del que se pueda comparar la
igualdad. Por ejemplo, imagínese que un distribuidor de comida tiene una lista de
proveedores de un determinado producto y una lista de compradores. Se puede usar
una cláusula join , por ejemplo, para crear una lista de los proveedores y compradores
de dicho producto que se encuentran en la misma región especificada.

La cláusula join toma dos secuencias de origen como entrada. Los elementos de cada
secuencia deben ser o deben contener una propiedad que se pueda comparar con una
propiedad correspondiente en la otra secuencia. La cláusula join compara la igualdad
de las claves especificadas mediante la palabra clave especial equals . Todas las
combinaciones efectuadas por la cláusula join son combinaciones de igualdad. La
forma de la salida de una cláusula join depende del tipo específico de combinación
que se va a efectuar. Estos son los tres tipos de combinación más comunes:

Combinación interna

Combinación agrupada

Combinación externa izquierda

Combinación interna
En el ejemplo siguiente se muestra una combinación de igualdad interna simple. Esta
consulta genera una secuencia plana de pares de "nombre de producto y categoría". La
misma cadena de categoría aparecerá en varios elementos. Si un elemento de
categories no tiene ningún products que coincida, dicha categoría no aparecerá en los

resultados.

C#

var innerJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID

select new { ProductName = prod.Name, Category = category.Name };

//produces flat sequence

Para obtener más información, vea Realizar combinaciones internas.

Combinación agrupada
Una cláusula join con una expresión into se denomina "combinación agrupada".

C#

var innerGroupJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

select new { CategoryName = category.Name, Products = prodGroup };

Las combinaciones agrupadas generan una secuencia de resultados jerárquicos que

asocia los elementos de la secuencia de origen izquierda con uno o más elementos
coincidentes de la secuencia de origen derecha. Las combinaciones agrupadas no tienen
ningún equivalente en términos relacionales; son básicamente una secuencia de
matrices de objetos.

Si no se encuentra ningún elemento de la secuencia de origen derecha para que

coincida con un elemento del origen izquierdo, la cláusula join generará una matriz
vacía para ese elemento. Por lo tanto, la combinación agrupada es básicamente una
combinación de igualdad interna, salvo que la secuencia del resultado se organiza en
grupos.

Si solo selecciona los resultados de una combinación agrupada, puede tener acceso a
los elementos, pero no podrá identificar la clave en la que coinciden. Por lo tanto, suele
resultar más útil seleccionar los resultados de la combinación agrupada en un nuevo
tipo que también tenga el nombre de la clave, como se muestra en el ejemplo anterior.

Por supuesto, también puede usar el resultado de una combinación agrupada como
generador de otra subconsulta:

C#

var innerGroupJoinQuery2 =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

from prod2 in prodGroup

where prod2.UnitPrice > 2.50M

select prod2;

Para obtener más información, vea Realizar combinaciones agrupadas.

Combinación externa izquierda

En una combinación externa izquierda se devuelven todos los elementos de la secuencia
de origen izquierda, incluso si no hay elementos coincidentes en la secuencia derecha.
Para efectuar una combinación externa izquierda en LINQ, use el método
DefaultIfEmpty junto con una combinación agrupada para especificar un elemento
derecho predeterminado para que se genere si un elemento izquierdo no tiene
coincidencias. Puede usar null como valor predeterminado para cualquier tipo de
referencia, aunque también puede especificar un tipo predeterminado definido por el
usuario. En el ejemplo siguiente se muestra un tipo predeterminado definido por el
usuario:

C#

var leftOuterJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

from item in prodGroup.DefaultIfEmpty(new Product { Name = String.Empty,

CategoryID = 0 })

select new { CatName = category.Name, ProdName = item.Name };

Para obtener más información, vea Realizar operaciones de combinación externa

izquierda.

El operador de igualdad
La cláusula join efectúa una combinación de igualdad. En otras palabras, solo puede
basar las coincidencias en la igualdad de dos claves. No se admiten otros tipos de
comparaciones, como "mayor que" o "no es igual a". Para aclarar que todas las
combinaciones son combinaciones de igualdad, la cláusula join usa la palabra clave
equals en lugar del operador == . La palabra clave equals solo se puede usar en una

cláusula join y difiere del operador == en aspectos importantes. Al comparar cadenas,

equals tiene una sobrecarga para comparar por valor y el operador == usa la igualdad
de referencia. Cuando ambos lados de la comparación tengan variables de cadena
idénticas, equals y == alcanzarán el mismo resultado: true. Esto se debe a que, cuando
un programa declara dos o más variables de cadena equivalentes, el compilador las
almacena todas en la misma ubicación; vea Igualdad de referencia e internamiento de
cadena para obtener más información. Otra diferencia importante es la comparación
NULL: null equals null se evalúa como false con el operador equals , en lugar del
operador == , que lo evalúa como true. Por último, el comportamiento del ámbito es
distinto: con equals , la clave izquierda usa la secuencia de origen externa, mientras que
la clave derecha usa el origen interno. El origen externo solo está en el ámbito del lado
izquierdo de equals , mientras que la secuencia de origen interna solo está en el ámbito
del lado derecho.

Combinaciones de desigualdad
Puede efectuar combinaciones de desigualdad, combinaciones cruzadas y otras
operaciones de combinación personalizadas usando varias cláusulas from para
introducir nuevas secuencias en una consulta de manera independiente. Para obtener
más información, vea Realizar operaciones de combinación personalizadas.

Uniones en las colecciones de objetos frente a

las tablas relacionales
En una expresión de consulta LINQ, las operaciones de combinación se efectúan en las
colecciones de objetos. Las colecciones de objetos no se pueden "combinar"
exactamente igual que dos tablas relacionales. En LINQ, las cláusulas join explícitas
solo son necesarias cuando dos secuencias de origen no están unidas por ninguna
relación. Cuando se trabaja con LINQ to SQL, las tablas de claves externas se
representan en el modelo de objetos como propiedades de la tabla principal. Por
ejemplo, en la base de datos Northwind, la tabla Customer (Cliente) tiene una relación
de clave externa con la tabla Orders (Pedidos). Al asignar las tablas al modelo de
objetos, la clase Customer tiene una propiedad Orders que contiene la colección Orders
asociada a ese cliente. De hecho, la combinación ya se ha llevado a cabo
automáticamente.

Para más información sobre las consultas en tablas relacionadas en el contexto de LINQ
to SQL, consulte Cómo asignar relaciones de bases de datos.

Claves compuestas
Puede probar la igualdad de varios valores mediante una clave compuesta. Para obtener
más información, vea Realizar una unión usando claves compuestas. Las claves
compuestas también se pueden usar en una cláusula group .
Ejemplo
En el ejemplo siguiente se comparan los resultados de una combinación interna, una
combinación agrupada y una combinación externa izquierda en los mismos orígenes de
datos mediante las mismas claves coincidentes. Se ha agregado algún código adicional
a estos ejemplos para aclarar los resultados en la pantalla de la consola.

C#

class JoinDemonstration

#region Data

class Product

public string Name { get; set; }

public int CategoryID { get; set; }

class Category

public string Name { get; set; }

public int ID { get; set; }

// Specify the first data source.

List<Category> categories = new List<Category>()

new Category {Name="Beverages", ID=001},

new Category {Name="Condiments", ID=002},

new Category {Name="Vegetables", ID=003},

new Category {Name="Grains", ID=004},

new Category {Name="Fruit", ID=005}

};

// Specify the second data source.

List<Product> products = new List<Product>()

new Product {Name="Cola", CategoryID=001},

new Product {Name="Tea", CategoryID=001},

new Product {Name="Mustard", CategoryID=002},

new Product {Name="Pickles", CategoryID=002},

new Product {Name="Carrots", CategoryID=003},

new Product {Name="Bok Choy", CategoryID=003},

new Product {Name="Peaches", CategoryID=005},

new Product {Name="Melons", CategoryID=005},

};

#endregion

static void Main(string[] args)

JoinDemonstration app = new JoinDemonstration();

 app.InnerJoin();

app.GroupJoin();

app.GroupInnerJoin();

app.GroupJoin3();

app.LeftOuterJoin();

app.LeftOuterJoin2();

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

void InnerJoin()

// Create the query that selects

// a property from each element.

var innerJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID

select new { Category = category.ID, Product = prod.Name };

Console.WriteLine("InnerJoin:");

// Execute the query. Access results

// with a simple foreach statement.

foreach (var item in innerJoinQuery)

Console.WriteLine("{0,-10}{1}", item.Product, item.Category);

Console.WriteLine("InnerJoin: {0} items in 1 group.",

innerJoinQuery.Count());

Console.WriteLine(System.Environment.NewLine);

void GroupJoin()

// This is a demonstration query to show the output

// of a "raw" group join. A more typical group join

// is shown in the GroupInnerJoin method.

var groupJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

select prodGroup;

// Store the count of total items (for demonstration only).

int totalItems = 0;

Console.WriteLine("Simple GroupJoin:");

// A nested foreach statement is required to access group items.

foreach (var prodGrouping in groupJoinQuery)

Console.WriteLine("Group:");

foreach (var item in prodGrouping)

totalItems++;

Console.WriteLine(" {0,-10}{1}", item.Name,

item.CategoryID);

Console.WriteLine("Unshaped GroupJoin: {0} items in {1} unnamed

groups", totalItems, groupJoinQuery.Count());

Console.WriteLine(System.Environment.NewLine);

void GroupInnerJoin()

var groupJoinQuery2 =

from category in categories

orderby category.ID

join prod in products on category.ID equals prod.CategoryID into

prodGroup

select new

Category = category.Name,

Products = from prod2 in prodGroup

orderby prod2.Name

select prod2

};

//Console.WriteLine("GroupInnerJoin:");

int totalItems = 0;

Console.WriteLine("GroupInnerJoin:");

foreach (var productGroup in groupJoinQuery2)

Console.WriteLine(productGroup.Category);

foreach (var prodItem in productGroup.Products)

totalItems++;

Console.WriteLine(" {0,-10} {1}", prodItem.Name,

prodItem.CategoryID);

Console.WriteLine("GroupInnerJoin: {0} items in {1} named groups",

totalItems, groupJoinQuery2.Count());

Console.WriteLine(System.Environment.NewLine);

void GroupJoin3()

var groupJoinQuery3 =

from category in categories

join product in products on category.ID equals

product.CategoryID into prodGroup

from prod in prodGroup

orderby prod.CategoryID

select new { Category = prod.CategoryID, ProductName = prod.Name

};

//Console.WriteLine("GroupInnerJoin:");

int totalItems = 0;

Console.WriteLine("GroupJoin3:");

foreach (var item in groupJoinQuery3)

totalItems++;

Console.WriteLine(" {0}:{1}", item.ProductName,

item.Category);

Console.WriteLine("GroupJoin3: {0} items in 1 group", totalItems);

Console.WriteLine(System.Environment.NewLine);

void LeftOuterJoin()

// Create the query.

var leftOuterQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

select prodGroup.DefaultIfEmpty(new Product() { Name =

"Nothing!", CategoryID = category.ID });

// Store the count of total items (for demonstration only).

int totalItems = 0;

Console.WriteLine("Left Outer Join:");

// A nested foreach statement is required to access group items

foreach (var prodGrouping in leftOuterQuery)

Console.WriteLine("Group:");

foreach (var item in prodGrouping)

totalItems++;

Console.WriteLine(" {0,-10}{1}", item.Name,

item.CategoryID);

Console.WriteLine("LeftOuterJoin: {0} items in {1} groups",

totalItems, leftOuterQuery.Count());

Console.WriteLine(System.Environment.NewLine);

void LeftOuterJoin2()

// Create the query.

var leftOuterQuery2 =

from category in categories

join prod in products on category.ID equals prod.CategoryID into

prodGroup

 from item in prodGroup.DefaultIfEmpty()

select new { Name = item == null ? "Nothing!" : item.Name,

CategoryID = category.ID };

Console.WriteLine("LeftOuterJoin2: {0} items in 1 group",

leftOuterQuery2.Count());

// Store the count of total items

int totalItems = 0;

Console.WriteLine("Left Outer Join 2:");

// Groups have been flattened.

foreach (var item in leftOuterQuery2)

totalItems++;

Console.WriteLine("{0,-10}{1}", item.Name, item.CategoryID);

Console.WriteLine("LeftOuterJoin2: {0} items in 1 group",

totalItems);

/*Output:

InnerJoin:

Cola 1

Tea 1

Mustard 2

Pickles 2

Carrots 3

Bok Choy 3

Peaches 5

Melons 5

InnerJoin: 8 items in 1 group.

Unshaped GroupJoin:

Group:

Cola 1

Tea 1

Group:

Mustard 2

Pickles 2

Group:

Carrots 3

Bok Choy 3

Group:

Group:

Peaches 5

Melons 5

Unshaped GroupJoin: 8 items in 5 unnamed groups

GroupInnerJoin:

Beverages

Cola 1

 Tea 1

Condiments

Mustard 2

Pickles 2

Vegetables

Bok Choy 3

Carrots 3

Grains

Fruit

Melons 5

Peaches 5

GroupInnerJoin: 8 items in 5 named groups

GroupJoin3:

Cola:1

Tea:1

Mustard:2

Pickles:2

Carrots:3

Bok Choy:3

Peaches:5

Melons:5

GroupJoin3: 8 items in 1 group

Left Outer Join:

Group:

Cola 1

Tea 1

Group:

Mustard 2

Pickles 2

Group:

Carrots 3

Bok Choy 3

Group:

Nothing! 4

Group:

Peaches 5

Melons 5

LeftOuterJoin: 9 items in 5 groups

LeftOuterJoin2: 9 items in 1 group

Left Outer Join 2:

Cola 1

Tea 1

Mustard 2

Pickles 2

Carrots 3

Bok Choy 3

Nothing! 4

Peaches 5

Melons 5

 LeftOuterJoin2: 9 items in 1 group

Press any key to exit.

*/

Comentarios
Una cláusula join que no va seguida de into se convierte en una llamada al método
Join. Una cláusula join que va seguida de into se convierte en una llamada al método
GroupJoin.

Vea también
Palabras clave para consultas (LINQ)
Language-Integrated Query (LINQ)
Operaciones de combinación
group (cláusula)
Realizar operaciones de combinación externa izquierda
Realizar combinaciones internas
Realizar combinaciones agrupadas
Ordenar los resultados de una cláusula join
Realizar una unión usando claves compuestas
Sistemas de base de datos compatible para Visual Studio
let (Cláusula, Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En una expresión de consulta, a veces resulta útil almacenar el resultado de una

subexpresión para usarlo en las cláusulas siguientes. Puede hacer esto con la palabra
clave let , que crea una variable de rango y la inicializa con el resultado de la expresión
que proporcione. Una vez inicializada con un valor, la variable de rango no se puede
usar para almacenar otro valor. En cambio, si la variable de rango contiene un tipo
consultable, se puede consultar.

Ejemplo
En el siguiente ejemplo, se usa let de dos maneras:

1. Para crear un tipo enumerable que se puede consultar.

2. Para habilitar la consulta para que llame a ToLower solo una vez en la variable de
rango word . Sin usar let , tendría que llamar a ToLower en cada predicado de la
cláusula where .

C#

class LetSample1

static void Main()

string[] strings =

"A penny saved is a penny earned.",

"The early bird catches the worm.",

"The pen is mightier than the sword."

};

// Split the sentence into an array of words

// and select those whose first letter is a vowel.

var earlyBirdQuery =

from sentence in strings

let words = sentence.Split(' ')

from word in words

let w = word.ToLower()

where w[0] == 'a' || w[0] == 'e'

|| w[0] == 'i' || w[0] == 'o'

|| w[0] == 'u'

select word;

// Execute the query.

 foreach (var v in earlyBirdQuery)

Console.WriteLine("\"{0}\" starts with a vowel", v);

// Keep the console window open in debug mode.

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

/* Output:

"A" starts with a vowel

"is" starts with a vowel

"a" starts with a vowel

"earned." starts with a vowel

"early" starts with a vowel

"is" starts with a vowel

*/

Vea también
Referencia de C#
Palabras clave para consultas (LINQ)
LINQ en C#
Language-Integrated Query (LINQ)
Controlar excepciones en expresiones de consulta
ascending (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual ascending se usa en la cláusula orderby en expresiones de

consulta para especificar que el criterio de ordenación es de menor a mayor. Como
ascending es el criterio de ordenación predeterminado, no tiene que especificarlo.

Ejemplo
En el ejemplo siguiente se muestra el uso de ascending en una cláusula orderby.

C#

IEnumerable<string> sortAscendingQuery =

from vegetable in vegetables

orderby vegetable ascending

select vegetable;

Vea también
Referencia de C#
LINQ en C#
descending
descending (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual descending se usa en la cláusula orderby en expresiones de

consulta para especificar que el criterio de ordenación es de mayor a menor.

Ejemplo
En el ejemplo siguiente se muestra el uso de descending en una cláusula orderby.

C#

IEnumerable<string> sortDescendingQuery =

from vegetable in vegetables

orderby vegetable descending

select vegetable;

Vea también
Referencia de C#
LINQ en C#
ascending
on (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual on se usa en la cláusula join de una expresión de consulta

para especificar la condición de combinación.

Ejemplo
En el ejemplo siguiente se muestra el uso de on en una cláusula join .

C#

var innerJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID

select new { ProductName = prod.Name, Category = category.Name };

Vea también
Referencia de C#
Language-Integrated Query (LINQ)
equals (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual equals se usa en una cláusula join en una expresión de
consulta para comparar los elementos de dos secuencias. Para obtener más información,
vea join (Cláusula, Referencia de C#).

Ejemplo
En el ejemplo siguiente se muestra el uso de la palabra clave equals en una cláusula
join .

C#

var innerJoinQuery =

from category in categories

join prod in products on category.ID equals prod.CategoryID

select new { ProductName = prod.Name, Category = category.Name };

Vea también
Language-Integrated Query (LINQ)
by (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave contextual by se usa en la cláusula group en una expresión de consulta

para especificar cómo deben agruparse los elementos devueltos. Para obtener más
información, vea group (Cláusula).

Ejemplo
En el ejemplo siguiente se muestra el uso de la palabra clave contextual by en una
cláusula group para especificar que los estudiantes deben agruparse según la primera
letra del apellido de cada estudiante.

C#

var query = from student in students

group student by student.LastName[0];

Consulte también
LINQ en C#
in (Referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La palabra clave in se usa en los contextos siguientes:

parámetros de tipo genérico en interfaces y delegados genéricos.

Como un modificador de parámetro, que le permite pasar un argumento a un
método mediante una referencia en lugar de mediante un valor.
Instrucciones foreach
Cláusulas from en expresiones de consulta de LINQ.
Cláusulas join en expresiones de consulta de LINQ

Vea también
Palabras clave de C#
Referencia de C#
Operadores y expresiones de C#
(referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

C# proporciona una serie de operadores. Muchos de ellos son compatibles con los tipos
integrados y permiten realizar operaciones básicas con valores de esos tipos. Entre estos
operadores se incluyen los siguientes grupos:

Operadores aritméticos, que realizan operaciones aritméticas con operandos

numéricos.
Operadores de comparación, que comparan operandos numéricos.
Operadores lógicos booleanos, que realizan operaciones lógicas con operandos
bool.
Operadores bit a bit y de desplazamiento, que realizan operaciones bit a bit o de
desplazamiento con operandos de tipos enteros.
Operadores de igualdad, que comprueban si sus operandos son iguales o no.

Normalmente, puede sobrecargar esos operadores, es decir, puede especificar el

comportamiento del operador para los operandos de un tipo definido por el usuario.

Las expresiones más simples de C# son literales (por ejemplo, números enteros y reales)
y nombres de variables. Puede combinarlas para crear expresiones complejas mediante
el uso de operadores. La precedencia y la asociatividad de los operadores determinan el
orden en el que se realizan las operaciones en una expresión. Puede usar los paréntesis
para cambiar el orden de evaluación impuesto por la prioridad y la asociatividad de
operadores.

En el código siguiente, se muestran ejemplos de expresiones en el lado derecho de las

asignaciones:

C#

int a, b, c;

a = 7;

b = a;

c = b++;

b = a + b * c;

c = a >= 100 ? b : c / 10;

a = (int)Math.Sqrt(b * b + c * c);

string s = "String literal";

char l = s[s.Length - 1];

 var numbers = new List<int>(new[] { 1, 2, 3 });

b = numbers.FindLast(n => n > 1);

Normalmente, una expresión genera un resultado que se puede incluir en otra

expresión. Un método de llamada void es un ejemplo de expresión que no genera un
resultado. Solo se puede usar como instrucción, tal como se muestra en el ejemplo
siguiente:

C#

Console.WriteLine("Hello, world!");

A continuación se indican otros tipos de expresiones que ofrece C#:

Expresiones de cadenas interpoladas, que proporcionan una sintaxis práctica para

crear cadenas con formato:

C#

var r = 2.3;

var message = $"The area of a circle with radius {r} is {Math.PI * r *

r:F3}.";

Console.WriteLine(message);

// Output:

// The area of a circle with radius 2.3 is 16.619.

Expresiones lambda, que permiten crear funciones anónimas.

C#

int[] numbers = { 2, 3, 4, 5 };

var maximumSquare = numbers.Max(x => x * x);

Console.WriteLine(maximumSquare);
// Output:

// 25

Expresiones de consulta, que permiten usar capacidades de consulta directamente

en C# :

C#

var scores = new[] { 90, 97, 78, 68, 85 };

IEnumerable<int> highScoresQuery =

from score in scores

where score > 80

orderby score descending

select score;

 Console.WriteLine(string.Join(" ", highScoresQuery));

// Output:

// 97 90 85

Puede usar una definición de cuerpo de expresiones para proporcionar una definición
concisa para un método, un constructor, una propiedad, un indexador o un finalizador.

Prioridad de operadores
En una expresión con varios operadores, los operadores con mayor prioridad se evalúan
antes que los operadores con menor prioridad. En el ejemplo siguiente, la multiplicación
se realiza primero porque tiene mayor prioridad que la suma:

C#

var a = 2 + 2 * 2;

Console.WriteLine(a); // output: 6

Use paréntesis para cambiar el orden de evaluación impuesto por la prioridad de los
operadores:

C#

var a = (2 + 2) * 2;

Console.WriteLine(a); // output: 8

En la tabla siguiente se muestran los operadores de C# desde la precedencia más alta a

la más baja. Los operadores de cada fila comparten la prioridad.

Operadores Categoría o nombre

x.y, f(x), a[i], x?.y, x?[y], x++, x--, x!, new, typeof, checked, Principal
unchecked, default, nameof, delegate, sizeof, stackalloc, x->y

+x, -x, !x, ~x, ++x, --x, ^x, (T)x, await, &x, *x, true and false Unario

x..y Intervalo

switch, with Expresiones switch y with

x * y, x / y, x % y Multiplicativo

x + y, x – y Aditivo

x << y, x >> y Mayús

 Operadores Categoría o nombre

x < y, x > y, x <= y, x >= y, is, as Comprobación de tipos y

relacional

x == y, x != y Igualdad

x & y Operador lógico booleano AND

u operador lógico bit a bit AND

x ^ y Operador lógico booleano XOR u

operador lógico bit a bit XOR

x | y Operador lógico booleano OR u

operador lógico bit a bit OR

x && y AND condicional

x || y OR condicional

x ?? y Operador de uso combinado de

null

c?t:f Operador condicional

x = y, x += y, x -= y, x *= y, x /= y, x %= y, x &= y, x |= y, x ^= Asignación y declaración lambda

y, x <<= y, x >>= y, x ??= y, =>

Asociatividad de los operadores

Cuando los operadores tienen la misma prioridad, su asociatividad determina el orden
en el que se realizan las operaciones:

Los operadores asociativos a la izquierda se evalúan, por orden, de izquierda a

derecha. A excepción de los operadores de asignación y el operador de
integración nula , todos los operadores binarios son asociativos a la izquierda. Por
ejemplo, a + b - c se evalúa como (a + b) - c .
Los operadores asociativos a la derecha se evalúan, por orden, de derecha a
izquierda. Los operadores de asignación, los operadores de fusión de NULL, las
expresiones lambda y el operador condicional ?: son asociativos a la derecha. Por
ejemplo, x = y = z se evalúa como x = (y = z) .

Use paréntesis, para cambiar el orden de evaluación impuesto por la asociatividad de

los operadores:

C#
 int a = 13 / 5 / 2;

int b = 13 / (5 / 2);

Console.WriteLine($"a = {a}, b = {b}"); // output: a = 1, b = 6

Evaluación de operandos
Independientemente de la prioridad y la asociatividad de los operadores, los operandos
de una expresión se evalúan de izquierda a derecha. En los siguientes ejemplos, se
muestra el orden en el que se evalúan los operadores y los operandos:

Expresión Orden de evaluación

a + b a, b, +

a + b * c a, b, c, *, +

a / b + c * d a, b, /, c, d, *, +

a / (b + c) * d a, b, c, +, /, d, *

Normalmente, se evalúan todos los operandos de un operador. Sin embargo, algunos

operadores evalúan los operandos de forma condicional. Esto significa que el valor del
operando situado más a la izquierda de este tipo de operador define si se deben evaluar
otros operandos, o bien qué operandos deben evaluarse. Estos operadores son los
operadores lógicos condicionales AND (&&) y OR (||), los operadores de integración
nula ?? y ??=, los operadores condicionales nulos ?. y ?[], así como el operador
condicional ?:. Para más información, consulte la descripción de cada operador.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Expresiones
Operadores

Vea también
Referencia de C#
Sobrecarga de operadores
Árboles de expresión
Operadores aritméticos (referencia de
C#)
Artículo • 15/02/2023 • Tiempo de lectura: 12 minutos

Los operadores siguientes realizan operaciones aritméticas con operandos de tipos

numéricos:

Operadores unarios ++ (incremento), -- (decremento), + (más) y - (menos).

Operadores binarios * (multiplicación), / (división), % (resto), + (suma) y - (resta).

Estos operadores se admiten en todos los tipos numéricos enteros y de punto flotante.

En el caso de tipos enteros, dichos operadores (excepto los operadores ++ y -- ) se

definen para los tipos int , uint , long y ulong . Cuando los operandos son de otro tipo
entero ( sbyte , byte , short , ushort o char ), sus valores se convierten en el tipo int ,
que también es el tipo de resultado de una operación. Cuando los operandos son de
distintos tipos enteros o de punto flotante, sus valores se convierten al tipo contenedor
más cercano, si ese tipo existe. Para obtener más información, vea la sección
Promociones numéricas de Especificación del lenguaje C#. Los operadores ++ y -- se
definen para todos los tipos numéricos enteros y de punto flotante y el tipo char. El tipo
de resultado de una expresión de asignación compuesta es el tipo del operando
izquierdo.

Operador de incremento ++
El operador de incremento unario ++ incrementa su operando en 1. El operando debe
ser una variable, un acceso de propiedad o un acceso de indexador.

El operador de incremento se admite en dos formas: el operador de incremento posfijo

( x++ ) y el operador de incremento prefijo ( ++x ).

Operador de incremento de postfijo

El resultado de x++ es el valor de x antes de la operación, tal y como se muestra en el
ejemplo siguiente:

C#

int i = 3;

Console.WriteLine(i); // output: 3

 Console.WriteLine(i++); // output: 3

Console.WriteLine(i); // output: 4

Operador de incremento prefijo

El resultado de ++x es el valor de x después de la operación, tal y como se muestra en el
ejemplo siguiente:

C#

double a = 1.5;

Console.WriteLine(a); // output: 1.5

Console.WriteLine(++a); // output: 2.5

Console.WriteLine(a); // output: 2.5

Operador de decremento --
El operador de decremento unario -- disminuye su operando en 1. El operando debe
ser una variable, un acceso de propiedad o un acceso de indexador.

El operador de decremento se admite en dos formas: el operador de decremento

posfijo ( x-- ) y el operador de decremento prefijo ( --x ).

Operador de decremento de postfijo

El resultado de x-- es el valor de x antes de la operación, como se muestra en el
ejemplo siguiente:

C#

int i = 3;

Console.WriteLine(i); // output: 3

Console.WriteLine(i--); // output: 3

Console.WriteLine(i); // output: 2

Operador de decremento de prefijo

El resultado de --x es el valor de x después de la operación, tal y como se muestra en el
ejemplo siguiente:

C#
 double a = 1.5;

Console.WriteLine(a); // output: 1.5

Console.WriteLine(--a); // output: 0.5

Console.WriteLine(a); // output: 0.5

Operadores unarios más y menos

El operador + unario devuelve el valor de su operando. El operador unario - calcula la
negación numérica del operando.

C#

Console.WriteLine(+4); // output: 4

Console.WriteLine(-4); // output: -4

Console.WriteLine(-(-4)); // output: 4

uint a = 5;

var b = -a;

Console.WriteLine(b); // output: -5

Console.WriteLine(b.GetType()); // output: System.Int64

Console.WriteLine(-double.NaN); // output: NaN

El operador unario - no es compatible con el tipo ulong.

Operador de multiplicación *
El operador de multiplicación * calcula el producto de sus operandos:

C#

Console.WriteLine(5 * 2); // output: 10

Console.WriteLine(0.5 * 2.5); // output: 1.25

Console.WriteLine(0.1m * 23.4m); // output: 2.34

El operador unario * es el operador de direccionamiento indirecto del puntero.

Operador de división /
El operador de división / divide el operando izquierdo entre el derecho.
División de enteros
Para los operandos de tipos enteros, el resultado del operador / es de un tipo entero y
equivale al cociente de los dos operandos redondeados hacia cero:

C#

Console.WriteLine(13 / 5); // output: 2

Console.WriteLine(-13 / 5); // output: -2

Console.WriteLine(13 / -5); // output: -2

Console.WriteLine(-13 / -5); // output: 2

Para obtener el cociente de los dos operandos como número de punto flotante, use el
tipo float , double o decimal :

C#

Console.WriteLine(13 / 5.0); // output: 2.6

int a = 13;

int b = 5;

Console.WriteLine((double)a / b); // output: 2.6

División de punto flotante

Para los tipos float , double y decimal , el resultado del operador / es el cociente de los
dos operandos:

C#

Console.WriteLine(16.8f / 4.1f); // output: 4.097561

Console.WriteLine(16.8d / 4.1d); // output: 4.09756097560976

Console.WriteLine(16.8m / 4.1m); // output: 4.0975609756097560975609756098

Si uno de los operandos es decimal , otro operando no puede ser float ni double , ya
que ni float ni double se convierte de forma implícita a decimal . Debe convertir
explícitamente el operando float o double al tipo decimal . Para obtener más
información sobre las conversiones entre tipos numéricos, consulte Conversiones
numéricas integradas.

Operador de resto %
El operador de resto % calcula el resto después de dividir el operando izquierdo entre el
derecho.

Resto entero
En el caso de los operandos de tipos enteros, el resultado de a % b es el valor
producido por a - (a / b) * b . El signo de resto distinto de cero es el mismo que el
del operando izquierdo, como se muestra en el ejemplo siguiente:

C#

Console.WriteLine(5 % 4); // output: 1

Console.WriteLine(5 % -4); // output: 1

Console.WriteLine(-5 % 4); // output: -1

Console.WriteLine(-5 % -4); // output: -1

Use el método Math.DivRem para calcular los resultados de la división de enteros y del
resto.

Resto de punto flotante

En el caso de los operandos float y double , el resultado de x % y para x e y finitos es
el valor z , de modo que

el signo de z , si no es cero, es el mismo que el signo de x ;

el valor absoluto de z es el valor producido por |x| - n * |y| , donde n es el
entero más grande posible que sea menor o igual que |x| / |y| , y |x| e |y| son
los valores absolutos de x e y , respectivamente.

７ Nota

Este método de cálculo del resto es análogo al que se usa para los operandos
enteros, pero difiere de la especificación IEEE 754. Si necesita la operación de resto
conforme con la especificación IEEE 754, use el método Math.IEEERemainder.

Para información sobre el comportamiento del operador % con operandos no finitos,

vea la sección Operador de resto de la Especificación del lenguaje C#.

En el caso de los operandos decimal , el operador de resto % es equivalente al operador

de resto del tipo System.Decimal.
En el ejemplo siguiente se muestra el comportamiento del operador de resto con
operandos de punto flotante:

C#

Console.WriteLine(-5.2f % 2.0f); // output: -1.2

Console.WriteLine(5.9 % 3.1); // output: 2.8

Console.WriteLine(5.9m % 3.1m); // output: 2.8

Operador de suma +
El operador de suma + calcula la suma de sus operandos:

C#

Console.WriteLine(5 + 4); // output: 9

Console.WriteLine(5 + 4.3); // output: 9.3

Console.WriteLine(5.1m + 4.2m); // output: 9.3

También puede usar el operador + para la concatenación de cadenas y la combinación

de delegados. Para obtener más información, consulte Operadores + y +=.

Operador de resta -
El operador de resta - resta el operando derecho del izquierdo:

C#

Console.WriteLine(47 - 3); // output: 44

Console.WriteLine(5 - 4.3); // output: 0.7

Console.WriteLine(7.5m - 2.3m); // output: 5.2

También puede usar el operador - para la eliminación de delegados. Para obtener más
información, consulte Operadores - y -=.

Asignación compuesta
Para un operador binario op , una expresión de asignación compuesta con el formato

C#

x op= y

es equivalente a

C#

x = x op y

salvo que x solo se evalúa una vez.

En el ejemplo siguiente se muestra el uso de la asignación compuesta con operadores

aritméticos:

C#

int a = 5;

a += 9;

Console.WriteLine(a); // output: 14

a -= 4;

Console.WriteLine(a); // output: 10

a *= 2;

Console.WriteLine(a); // output: 20

a /= 4;

Console.WriteLine(a); // output: 5

a %= 3;

Console.WriteLine(a); // output: 2

A causa de las promociones numéricas, el resultado de la operación op podría no ser

convertible de forma implícita en el tipo T de x . En tal caso, si op es un operador
predefinido y el resultado de la operación es convertible de forma explícita en el tipo T
de x , una expresión de asignación compuesta con el formato x op= y es equivalente a
x = (T)(x op y) , excepto que x solo se evalúa una vez. En el ejemplo siguiente se

muestra ese comportamiento:

C#

byte a = 200;

byte b = 100;

var c = a + b;

Console.WriteLine(c.GetType()); // output: System.Int32

Console.WriteLine(c); // output: 300

a += b;

Console.WriteLine(a); // output: 44

Los operadores += y -= también se usan para suscribirse y cancelar la suscripción a un

evento, respectivamente. Para obtener más información, vea Procedimiento para
suscribir y cancelar la suscripción a eventos.

Prioridad y asociatividad de los operadores

En la lista siguiente se ordenan los operadores aritméticos de la prioridad más alta a la
más baja:

Operadores de incremento x++ y decremento x-- posfijos

Operadores de incremento ++x y decremento --x prefijos, y operadores unarios
+ y -.
Operadores de multiplicación * , / y % .
Operadores de suma adición + y - .

Los operadores aritméticos binarios son asociativos a la izquierda. Es decir, los

operadores con el mismo nivel de prioridad se evalúan de izquierda a derecha.

Use los paréntesis, () , para cambiar el orden de evaluación impuesto por la prioridad y
la asociatividad de operadores.

C#

Console.WriteLine(2 + 2 * 2); // output: 6

Console.WriteLine((2 + 2) * 2); // output: 8

Console.WriteLine(9 / 5 / 2); // output: 0

Console.WriteLine(9 / (5 / 2)); // output: 4

Para obtener la lista completa de los operadores de C# ordenados por nivel de

prioridad, vea la sección Prioridad de operadores del artículo Operadores de C#.

Desbordamiento aritmético y división por cero

Si el resultado de una operación aritmética está fuera del intervalo de valores finitos
posibles del tipo numérico implicado, el comportamiento de un operador aritmético
depende del tipo de sus operandos.

Desbordamiento aritmético de enteros

La división de enteros por cero siempre produce una DivideByZeroException.
En el caso de desbordamiento aritmético de enteros, el comportamiento resultante lo
controla el contexto de comprobación de desbordamiento, que puede ser comprobado
o no comprobado:

En un contexto comprobado, si el desbordamiento se produce en una expresión

constante, se produce un error de compilación. De lo contrario, si la operación se
realiza en tiempo de ejecución, se inicia una excepción OverflowException.
En un contexto no comprobado, el resultado se trunca mediante el descarte de los
bits de orden superior que no caben en el tipo de destino.

Junto con las instrucciones comprobadas y no comprobadas, puede usar los operadores
checked y unchecked para controlar el contexto de comprobación de desbordamiento,

en el que se evalúa una expresión:

C#

int a = int.MaxValue;

int b = 3;

Console.WriteLine(unchecked(a + b)); // output: -2147483646

try

int d = checked(a + b);

catch(OverflowException)

Console.WriteLine($"Overflow occurred when adding {a} to {b}.");

De forma predeterminada, las operaciones aritméticas se producen en un contexto no

comprobado.

Desbordamiento aritmético de punto flotante

Las operaciones aritméticas con los tipos float y double nunca inician una excepción. El
resultado de las operaciones aritméticas con esos tipos puede ser uno de varios valores
especiales que representan infinito y no un número:

C#

double a = 1.0 / 0.0;

Console.WriteLine(a); // output: Infinity

Console.WriteLine(double.IsInfinity(a)); // output: True

Console.WriteLine(double.MaxValue + double.MaxValue); // output: Infinity

 double b = 0.0 / 0.0;

Console.WriteLine(b); // output: NaN

Console.WriteLine(double.IsNaN(b)); // output: True

Para los operandos del tipo decimal , el desbordamiento aritmético siempre inicia una
excepción OverflowException. La división decimal por cero siempre produce una
excepción DivideByZeroException.

Errores de redondeo
Debido a las limitaciones generales de la representación de punto flotante de los
números reales y la aritmética de punto flotante, es posible que se produzcan errores de
redondeo en los cálculos con tipos de punto flotante. Es decir, es posible que el
resultado de una expresión difiera del resultado matemático esperado. En el ejemplo
siguiente se muestran varios de estos casos:

C#

Console.WriteLine(.41f % .2f); // output: 0.00999999

double a = 0.1;

double b = 3 * a;

Console.WriteLine(b == 0.3); // output: False

Console.WriteLine(b - 0.3); // output: 5.55111512312578E-17

decimal c = 1 / 3.0m;

decimal d = 3 * c;

Console.WriteLine(d == 1.0m); // output: False

Console.WriteLine(d); // output: 0.9999999999999999999999999999

Para más información, vea los comentarios en las páginas de referencia de

System.Double, System.Single o System.Decimal.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar los operadores unarios ( ++ , -- , + y
- ), los operadores binarios ( * , / , % , + y - ) y los operadores aritméticos. Cuando se

sobrecarga un operador binario, también se sobrecarga de forma implícita el operador

de asignación compuesta correspondiente. Un tipo definido por el usuario no puede
sobrecargar de forma explícita un operador de asignación compuesta.

Operadores comprobados definidos por el usuario

A partir de C# 11, al sobrecargar un operador aritmético, puede usar la palabra clave
checked para definir la versión comprobada de ese operador. En el siguiente ejemplo se
muestra cómo hacerlo:

C#

public record struct Point(int X, int Y)

public static Point operator checked +(Point left, Point right)

checked

return new Point(left.X + right.X, left.Y + right.Y);

public static Point operator +(Point left, Point right)

return new Point(left.X + right.X, left.Y + right.Y);

Al definir un operador comprobado, también debe definir el operador correspondiente

sin el modificador checked . Se llama al operador comprobado en un contexto
comprobado; el operador sin el modificador checked se llama en un contexto no
comprobado. Si solo proporciona el operador sin la palabra clave checked , se llama en
un contexto checked y en un contexto unchecked .

Cuando se definen ambas versiones de un operador, se espera que su comportamiento

sea diferente solo cuando el resultado de una operación sea demasiado grande para
representar en el tipo de resultado como se indica a continuación:

Un operador comprobado produce un OverflowException.

Un operador sin el modificador checked devuelve una instancia que representa un
resultado truncado.

Para obtener información sobre la diferencia en el comportamiento de los operadores

aritméticos integrados, consulte la sección Desbordamiento aritmético y división por
cero.

Puede usar el modificador checked solo cuando sobrecarga cualquiera de los

operadores siguientes:

Operadores ++ unarios, -- y -
Operadores binarios * , / , + y -
Operadores de conversión explícitos
 ７ Nota

Un contexto de comprobación de desbordamiento dentro del cuerpo de un

operador comprobado no se ve afectado por la presencia del modificador checked .
El contexto predeterminado se define mediante el valor de la opción del
compilador CheckForOverflowUnderflow . Use las instrucciones checked y
unchecked para especificar explícitamente el contexto de comprobación de
desbordamiento, como se muestra en el ejemplo al principio de esta sección.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Operadores de incremento y decremento posfijos

Operadores de incremento y decremento prefijos
Operador unario más
Operador unario menos
Operador de multiplicación
Operador de división
Operador de resto
Operador de suma
Operador de resta
Asignación compuesta
Operadores checked y unchecked
Promociones numéricas

Vea también
Referencia de C#
Operadores y expresiones de C#
System.Math
System.MathF
Valores numéricos en .NET
Operadores lógicos booleanos: AND,
OR, NOT, XOR
Artículo • 18/02/2023 • Tiempo de lectura: 8 minutos

Los operadores booleanos lógicos realizan operaciones lógicas con operandos bool. Los
operadores incluyen la negación lógica unaria ( ! ), AND lógico binario ( & ), OR ( | ) y OR
exclusivo ( ^ ) y los AND ( && ) y OR ( || ) lógicos condicionales binarios.

Operador unario ! (negación lógica).

Operadores binarios & (AND lógico), | (OR lógico) y ^ (OR exclusivo lógico). Esos
operadores siempre evalúan ambos operandos.
Operadores binarios && (AND lógico condicional) y || (OR lógico condicional). Esos
operadores evalúan el operando derecho solo si es necesario.

En el caso de los operandos de los tipos numéricos enteros, los operadores & , | y ^
realizan operaciones lógicas bit a bit. Para obtener más información, vea Operadores de
desplazamiento y bit a bit.

Operador de negación lógico !

El operador ! de prefijo unario calcula la negación lógica de su operando. Es decir,
genera true , si el operando se evalúa como false , y false , si el operando se evalúa
como true :

C#

bool passed = false;

Console.WriteLine(!passed); // output: True

Console.WriteLine(!true); // output: False

El operador ! de postfijo unario es un operador que permite un valor NULL.

Operador AND lógico &

El operador & calcula el operador AND lógico de sus operandos. El resultado de x & y
es true si x y y se evalúan como true . De lo contrario, el resultado es false .

El operador & evalúa ambos operandos, incluso aunque el izquierdo se evalúe como
false , para que el resultado de la operación sea false con independencia del valor del
operando derecho.

En el ejemplo siguiente, el operando derecho del operador & es una llamada de

método, que se realiza independientemente del valor del operando izquierdo:

C#

bool SecondOperand()

Console.WriteLine("Second operand is evaluated.");

return true;

bool a = false & SecondOperand();

Console.WriteLine(a);

// Output:

// Second operand is evaluated.

// False

bool b = true & SecondOperand();

Console.WriteLine(b);

// Output:

// Second operand is evaluated.

// True

El operador AND lógico condicional && también calcula el operador AND lógico de sus
operandos, pero no evalúa el operando derecho si el izquierdo se evalúa como false .

En el caso de los operandos de los tipos numéricos enteros, el operador & calcula el
AND lógico bit a bit de sus operandos. El operador & unario es el operador address-of.

Operador IR exclusivo lógico ^

El operador ^ calcula el operador OR exclusivo lógica, también conocido como el
operador XOR lógico, de sus operandos. El resultado de x ^ y es true si x se evalúa
como true y y se evalúa como false o x se evalúa como false y y se evalúa como
true . De lo contrario, el resultado es false . Es decir, para los operandos bool , el

operador ^ calcula el mismo resultado como el operador de desigualdad != .

C#

Console.WriteLine(true ^ true); // output: False

Console.WriteLine(true ^ false); // output: True

Console.WriteLine(false ^ true); // output: True

Console.WriteLine(false ^ false); // output: False

En el caso de los operandos de los tipos numéricos enteros, el operador ^ calcula el

AND lógico bit a bit de sus operandos.

Operador lógico OR |
El operador | calcula el operador OR lógico de sus operandos. El resultado de x | y es
true si x o y se evalúan como true . De lo contrario, el resultado es false .

El operador | evalúa ambos operandos, incluso aunque el izquierdo se evalúe como

true , para que el resultado de la operación sea true con independencia del valor del

operando derecho.

En el ejemplo siguiente, el operando derecho del operador | es una llamada de

método, que se realiza independientemente del valor del operando izquierdo:

C#

bool SecondOperand()

Console.WriteLine("Second operand is evaluated.");

return true;

bool a = true | SecondOperand();

Console.WriteLine(a);

// Output:

// Second operand is evaluated.

// True

bool b = false | SecondOperand();

Console.WriteLine(b);

// Output:

// Second operand is evaluated.

// True

El operador OR lógico condicional || también calcula el operador OR lógico de sus

operandos, pero no evalúa el operando derecho si el izquierdo se evalúa como true .

En el caso de los operandos de los tipos numéricos enteros, el operador | calcula el OR

lógico bit a bit de sus operandos.

Operador AND lógico condicional &&

El operador AND lógico condicional && , también denominado operador AND lógico "de
cortocircuito", calcula el operador AND lógico de sus operandos. El resultado de x && y
es true si x y y se evalúan como true . De lo contrario, el resultado es false . Si x se
evalúa como false , y no se evalúa.

En el ejemplo siguiente, el operando derecho del operador && es una llamada de

método, que no se realiza si el operando izquierdo se evalúa como false :

C#

bool SecondOperand()

Console.WriteLine("Second operand is evaluated.");

return true;

bool a = false && SecondOperand();

Console.WriteLine(a);

// Output:

// False

bool b = true && SecondOperand();

Console.WriteLine(b);

// Output:

// Second operand is evaluated.

// True

El operador AND lógico & también calcula el operador AND lógico de sus operandos,
pero siempre evalúa ambos operandos.

Operador OR lógico condicional ||

El operador OR lógico condicional || , también denominado operador OR lógico "de
cortocircuito", calcula el operador OR lógico de sus operandos. El resultado de x || y
es true si x o y se evalúan como true . De lo contrario, el resultado es false . Si x se
evalúa como true , y no se evalúa.

En el ejemplo siguiente, el operando derecho del operador || es una llamada de

método, que no se realiza si el operando izquierdo se evalúa como true :

C#

bool SecondOperand()

Console.WriteLine("Second operand is evaluated.");

return true;

bool a = true || SecondOperand();

 Console.WriteLine(a);

// Output:

// True

bool b = false || SecondOperand();

Console.WriteLine(b);

// Output:

// Second operand is evaluated.

// True

El operador OR lógico | también calcula el operador OR lógico de sus operandos, pero

siempre evalúa ambos operandos.

Operadores lógicos booleanos que aceptan

valores NULL
En el caso de los operandos bool? , los operadores & (AND lógico) y | (OR lógico)
admiten la lógica de tres valores tal como se indica a continuación:

El operador & produce true solo si sus dos operandos se evalúan como true . Si
x o y se evalúan como false , x & y produce false (aunque otro operando se
evalúe como null ). De lo contrario, el resultado de x & y es null .

El operador | produce false solo si sus dos operandos se evalúan como false . Si
x o y se evalúan como true , x | y produce true (aunque otro operando se
evalúe como null ). De lo contrario, el resultado de x | y es null .

En la tabla siguiente se presenta esta semántica:

x y x&y x|y

true true true true

true false false true

true null null true

false true false true

false false false false

False null False null

null true null true

null false False null

 x y x&y x|y

null null null null

El comportamiento de esos operadores difiere del comportamiento típico del operador

con tipos de valor que aceptan valores NULL. Por lo general, un operador que se define
para los operandos de un tipo de valor también se puede usar con los operandos del
tipo de valor correspondiente que acepta valores NULL. Este tipo de operador genera
null si alguno de sus operandos se evalúa como null . Sin embargo, los operadores &
y | pueden generar un valor no NULL incluso si uno de los operandos es null . Para
más información sobre el comportamiento de los operadores con tipos de valor que
aceptan valores NULL, consulte la sección Operadores de elevación del artículo Tipos de
valor que aceptan valores NULL.

También puede usar los operadores ! y ^ con los operandos bool? , como se muestra
en el ejemplo siguiente:

C#

bool? test = null;

Display(!test); // output: null

Display(test ^ false); // output: null

Display(test ^ null); // output: null

Display(true ^ null); // output: null

void Display(bool? b) => Console.WriteLine(b is null ? "null" :

b.Value.ToString());

Los operadores lógicos condicionales && y || no admiten los operandos bool? .

Asignación compuesta
Para un operador binario op , una expresión de asignación compuesta con el formato

C#

x op= y

es equivalente a

C#

x = x op y

salvo que x solo se evalúa una vez.

Los operadores & , | y ^ admiten la asignación compuesta, como se muestra en el

ejemplo siguiente:

C#

bool test = true;

test &= false;

Console.WriteLine(test); // output: False

test |= true;

Console.WriteLine(test); // output: True

test ^= false;

Console.WriteLine(test); // output: True

７ Nota

Los operadores lógicos condicionales && y || no admiten la asignación

compuesta.

Prioridad de operadores
En la lista siguiente se ordenan los operadores lógicos desde la prioridad más alta a la
más baja:

Operador de negación lógico !

Operador AND lógico &
Operador OR exclusivo lógico ^
Operador OR lógico |
Operador AND lógico condicional &&
Operador OR lógico condicional ||

Use los paréntesis, () , para cambiar el orden de evaluación impuesto por la prioridad
de los operadores:

C#

Console.WriteLine(true | true & false); // output: True

Console.WriteLine((true | true) & false); // output: False

bool Operand(string name, bool value)

 Console.WriteLine($"Operand {name} is evaluated.");

return value;

var byDefaultPrecedence = Operand("A", true) || Operand("B", true) &&

Operand("C", false);

Console.WriteLine(byDefaultPrecedence);

// Output:

// Operand A is evaluated.

// True

var changedOrder = (Operand("A", true) || Operand("B", true)) &&

Operand("C", false);

Console.WriteLine(changedOrder);

// Output:

// Operand A is evaluated.

// Operand C is evaluated.

// False

Para obtener la lista completa de los operadores de C# ordenados por nivel de

prioridad, vea la sección Prioridad de operadores del artículo Operadores de C#.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar los operadores ! , & , | y ^ . Cuando
se sobrecarga un operador binario, también se sobrecarga de forma implícita el
operador de asignación compuesta correspondiente. Un tipo definido por el usuario no
puede sobrecargar de forma explícita un operador de asignación compuesta.

Un tipo definido por el usuario no puede sobrecargar los operadores lógicos

condicionales && y || . Sin embargo, si un tipo definido por el usuario sobrecarga los
operadores true y false y el operador & o | de cierta manera, la operación && o || ,
respectivamente, se puede evaluar para los operandos de ese tipo. Para obtener más
información, vea la sección Operadores lógicos condicionales definidos por el usuario
de la Especificación del lenguaje C#.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Operador de negación lógico

Operadores lógicos
Operadores lógicos condicionales
Asignación compuesta
Vea también
Referencia de C#
Operadores y expresiones de C#
Operadores de desplazamiento y bit a bit
Operadores de desplazamiento y bit a
bit (referencia de C#)
Artículo • 15/02/2023 • Tiempo de lectura: 10 minutos

Los operadores bit a bit y shift incluyen complemento unario bit a bit, desplazamiento
binario a la izquierda y derecha, desplazamiento a la derecha sin signo, y los operadores
OR lógicos binarios AND, OR y OR exclusivos. Estos operandos toman operandos de los
tipos numéricos enteros o del tipo char .

Operador unario ~ (complemento bit a bit)

Operadores binarios << (desplazamiento a la izquierda),, >> (desplazamiento a la
derecha) y >>> (desplazamiento a la derecha sin signo)
Operadores binarios & (AND lógico), | (OR lógico) y ^ (OR exclusivo lógico)

Estos operadores se definen para los tipos int , uint , long y ulong . Cuando ambos
operandos son de otro tipo entero ( sbyte , byte , short , ushort o char ), sus valores se
convierten en el tipo int , que también es el tipo de resultado de una operación.
Cuando los operandos son de tipo entero diferente, sus valores se convierten en el tipo
entero más cercano que contenga. Para obtener más información, vea la sección
Promociones numéricas de Especificación del lenguaje C#. Los operadores compuestos
(como >>= ) no convierten sus argumentos en int o tienen el tipo de resultado como
int .

Los operadores & , | y ^ también se definen para los operandos de tipo bool . Para
obtener más información, vea Operadores lógicos booleanos.

Las operaciones de desplazamiento y bit a bit nunca producen desbordamiento y

generan los mismos resultados en contextos Checked y Unchecked.

Operador de complemento bit a bit ~

El operador ~ genera un complemento bit a bit de su operando al invertir cada bit:

C#

uint a = 0b_0000_1111_0000_1111_0000_1111_0000_1100;

uint b = ~a;

Console.WriteLine(Convert.ToString(b, toBase: 2));

// Output:

// 11110000111100001111000011110011

También se puede usar el símbolo ~ para declarar finalizadores. Para obtener más
información, vea Finalizadores.

Operador de desplazamiento izquierdo <<

El operador << desplaza el operando izquierdo a la izquierda el número de bits definido
por el operando derecho. Para obtener información sobre cómo el operando derecho
define el recuento de desplazamiento, vea la sección Recuento de desplazamiento de
los operadores de desplazamiento.

La operación de desplazamiento izquierdo descarta los bits de orden superior que están
fuera del rango del tipo de resultado y establece las posiciones de bits vacías de orden
inferior en cero, como se muestra en el ejemplo siguiente:

C#

uint x = 0b_1100_1001_0000_0000_0000_0000_0001_0001;

Console.WriteLine($"Before: {Convert.ToString(x, toBase: 2)}");

uint y = x << 4;

Console.WriteLine($"After: {Convert.ToString(y, toBase: 2)}");

// Output:

// Before: 11001001000000000000000000010001

// After: 10010000000000000000000100010000

Dado que los operadores de desplazamiento solo se definen para los tipos int , uint ,
long y ulong , el resultado de una operación siempre contiene al menos 32 bits. Si el

operando izquierdo es de otro tipo entero ( sbyte , byte , short , ushort o char ), su valor
se convierte al tipo int , como se muestra en el ejemplo siguiente:

C#

byte a = 0b_1111_0001;

var b = a << 8;

Console.WriteLine(b.GetType());

Console.WriteLine($"Shifted byte: {Convert.ToString(b, toBase: 2)}");

// Output:

// System.Int32

// Shifted byte: 1111000100000000

Operador de desplazamiento a la derecha >>

El operador >> desplaza el operando izquierdo a la derecha el número de bits definido
por el operando derecho. Para obtener información sobre cómo el operando derecho
define el recuento de desplazamiento, vea la sección Recuento de desplazamiento de
los operadores de desplazamiento.

La operación de desplazamiento derecho descarta los bits de orden inferior, como se

muestra en el ejemplo siguiente:

C#

uint x = 0b_1001;

Console.WriteLine($"Before: {Convert.ToString(x, toBase: 2), 4}");

uint y = x >> 2;

Console.WriteLine($"After: {Convert.ToString(y, toBase: 2).PadLeft(4, '0'),

4}");

// Output:

// Before: 1001

// After: 0010

Las posiciones de bits vacíos de orden superior se establecen basándose en el tipo del
operando izquierdo, tal como se indica a continuación:

Si el operando izquierdo es de tipo int o long , el operador de desplazamiento a

la derecha realiza un desplazamiento aritmético: el valor del bit más significativo (el
bit de signo) del operando izquierdo se propaga a las posiciones de bits vacíos de
orden superior. Es decir, las posiciones de bits vacíos de orden superior se
establecen en cero si el operando izquierdo no es negativo y, en caso de serlo, se
establecen en uno.

C#

int a = int.MinValue;

Console.WriteLine($"Before: {Convert.ToString(a, toBase: 2)}");

int b = a >> 3;

Console.WriteLine($"After: {Convert.ToString(b, toBase: 2)}");

// Output:

// Before: 10000000000000000000000000000000

// After: 11110000000000000000000000000000

Si el operando izquierdo es de tipo uint o ulong , el operador de desplazamiento

a la derecha realiza un desplazamiento lógico: las posiciones de bits vacíos de
orden superior se establecen siempre en cero.

C#
 uint c = 0b_1000_0000_0000_0000_0000_0000_0000_0000;

Console.WriteLine($"Before: {Convert.ToString(c, toBase: 2), 32}");

uint d = c >> 3;

Console.WriteLine($"After: {Convert.ToString(d, toBase: 2).PadLeft(32,

'0'), 32}");

// Output:

// Before: 10000000000000000000000000000000

// After: 00010000000000000000000000000000

７ Nota

Use el operador de desplazamiento a la derecha sin signo para realizar un

desplazamiento lógico en operandos de tipos enteros con signo. Esto es preferible
a convertir un operando izquierdo en un tipo sin signo y, a continuación, devolver
el resultado de una operación de desplazamiento a un tipo con signo.

Operador de desplazamiento a la derecha sin

signo >>>
Disponible en C# 11 y posteriores, el >>> operador desplaza el operando izquierdo a la
derecha el número de bits definido por su operando derecho. Para obtener información
sobre cómo el operando derecho define el recuento de desplazamiento, vea la sección
Recuento de desplazamiento de los operadores de desplazamiento.

El >>> operador siempre realiza un desplazamiento lógico. Es decir, las posiciones de

bits vacías de orden alto siempre se establecen en cero, independientemente del tipo
del operando izquierdo. El >> operador realiza un desplazamiento aritmético (es decir,
el valor del bit más significativo se propaga a las posiciones de bits vacías de orden alto)
si el operando izquierdo es de un tipo con signo. En el ejemplo siguiente se muestra la
diferencia entre los operadores de >> y >>> para un operando izquierdo negativo:

C#

int x = -8;

Console.WriteLine($"Before: {x,11}, hex: {x,8:x}, binary:

{Convert.ToString(x, toBase: 2), 32}");

int y = x >> 2;

Console.WriteLine($"After >>: {y,11}, hex: {y,8:x}, binary:

{Convert.ToString(y, toBase: 2), 32}");

int z = x >>> 2;

Console.WriteLine($"After >>>: {z,11}, hex: {z,8:x}, binary:

 {Convert.ToString(z, toBase: 2).PadLeft(32, '0'), 32}");

// Output:

// Before: -8, hex: fffffff8, binary:

11111111111111111111111111111000

// After >>: -2, hex: fffffffe, binary:

11111111111111111111111111111110

// After >>>: 1073741822, hex: 3ffffffe, binary:

00111111111111111111111111111110

Operador AND lógico &

El operador & calcula el AND lógico bit a bit de sus operandos enteros:

C#

uint a = 0b_1111_1000;

uint b = 0b_1001_1101;

uint c = a & b;

Console.WriteLine(Convert.ToString(c, toBase: 2));

// Output:

// 10011000

Para los operandos bool , el operador & calcula el AND lógico de sus operandos. El
operador & unario es el operador address-of.

Operador IR exclusivo lógico ^

El operador ^ calcula el OR exclusivo lógico bit a bit, también conocido como XOR
lógico bit a bit, de sus operandos enteros:

C#

uint a = 0b_1111_1000;

uint b = 0b_0001_1100;

uint c = a ^ b;

Console.WriteLine(Convert.ToString(c, toBase: 2));

// Output:

// 11100100

Para los operandos bool , el operador ^ calcula el OR exclusivo lógico de sus

operandos.

Operador lógico OR |
El operador | calcula el OR lógico bit a bit de sus operandos enteros:

C#

uint a = 0b_1010_0000;

uint b = 0b_1001_0001;

uint c = a | b;

Console.WriteLine(Convert.ToString(c, toBase: 2));

// Output:

// 10110001

Para los operandos bool , el operador | calcula el OR lógico de sus operandos.

Asignación compuesta
Para un operador binario op , una expresión de asignación compuesta con el formato

C#

x op= y

es equivalente a

C#

x = x op y

salvo que x solo se evalúa una vez.

En el ejemplo siguiente se muestra el uso de la asignación compuesta con operadores

de desplazamiento y bit a bit:

C#

uint INITIAL_VALUE = 0b_1111_1000;

uint a = INITIAL_VALUE;

a &= 0b_1001_1101;

Display(a); // output: 10011000

a = INITIAL_VALUE;

a |= 0b_0011_0001;

Display(a); // output: 11111001

a = INITIAL_VALUE;

a ^= 0b_1000_0000;

 Display(a); // output: 01111000

a = INITIAL_VALUE;

a <<= 2;

Display(a); // output: 1111100000

a = INITIAL_VALUE;

a >>= 4;

Display(a); // output: 00001111

a = INITIAL_VALUE;

a >>>= 4;

Display(a); // output: 00001111

void Display(uint x) => Console.WriteLine($"{Convert.ToString(x, toBase:

2).PadLeft(8, '0'), 8}");

A causa de las promociones numéricas, el resultado de la operación op podría no ser

convertible de forma implícita en el tipo T de x . En tal caso, si op es un operador
predefinido y el resultado de la operación es convertible de forma explícita en el tipo T
de x , una expresión de asignación compuesta con el formato x op= y es equivalente a
x = (T)(x op y) , excepto que x solo se evalúa una vez. En el ejemplo siguiente se

muestra ese comportamiento:

C#

byte x = 0b_1111_0001;

int b = x << 8;

Console.WriteLine($"{Convert.ToString(b, toBase: 2)}"); // output:

1111000100000000

x <<= 8;

Console.WriteLine(x); // output: 0

Prioridad de operadores
En la lista siguiente se ordenan los operadores de desplazamiento y bit a bit desde la
prioridad más alta a la más baja:

Operador de complemento bit a bit ~

Operadores de desplazamiento << , >> y >>>
Operador AND lógico &
Operador OR exclusivo lógico ^
Operador OR lógico |
Use los paréntesis, () , para cambiar el orden de evaluación impuesto por la prioridad
de los operadores:

C#

uint a = 0b_1101;

uint b = 0b_1001;

uint c = 0b_1010;

uint d1 = a | b & c;

Display(d1); // output: 1101

uint d2 = (a | b) & c;

Display(d2); // output: 1000

void Display(uint x) => Console.WriteLine($"{Convert.ToString(x, toBase: 2),

4}");

Para obtener la lista completa de los operadores de C# ordenados por nivel de

prioridad, vea la sección Prioridad de operadores del artículo Operadores de C#.

Recuento de desplazamiento de los operadores

de desplazamiento
Para los operadores de desplazamiento integrados << , >> y >>> , el tipo del operando
derecho debe ser int o un tipo que tenga una conversión numérica implícita
predefinida en int .

Para las expresiones de x << count , x >> count y x >>> count , el recuento de
desplazamientos real depende del tipo de x de la siguiente manera:

Si el tipo de x es int o uint , el recuento de desplazamiento viene definido por

los cinco bits de orden inferior del operando derecho. Es decir, el valor de
desplazamiento se calcula a partir de count & 0x1F (o count & 0b_1_1111 ).

Si el tipo de x es long o ulong , el recuento de desplazamiento viene definido por

los seis bits de orden inferior del operando derecho. Es decir, el valor de
desplazamiento se calcula a partir de count & 0x3F (o count & 0b_11_1111 ).

En el ejemplo siguiente se muestra ese comportamiento:

C#

int count1 = 0b_0000_0001;

int count2 = 0b_1110_0001;

 int a = 0b_0001;

Console.WriteLine($"{a} << {count1} is {a << count1}; {a} << {count2} is {a

<< count2}");

// Output:

// 1 << 1 is 2; 1 << 225 is 2

int b = 0b_0100;

Console.WriteLine($"{b} >> {count1} is {b >> count1}; {b} >> {count2} is {b

>> count2}");

// Output:

// 4 >> 1 is 2; 4 >> 225 is 2

７ Nota

Tal y como se muestra en el ejemplo anterior, el resultado de una operación de

desplazamiento puede ser distinto de cero incluso si el valor del operando derecho
es mayor que el número de bits del operando izquierdo.

Operadores lógicos de enumeración

Los operadores ~ , & , | y ^ también se admiten en cualquier tipo de enumeración. En
el caso de los operandos del mismo tipo de enumeración, se realiza una operación
lógica en los valores correspondientes del tipo entero subyacente. Por ejemplo, para
cualquier x e y de un tipo de enumeración T con un tipo subyacente U , la expresión x
& y produce el mismo resultado que la expresión (T)((U)x & (U)y) .

Normalmente, los operadores lógicos bit a bit se usan con un tipo de enumeración
definido con el atributo Flags. Para obtener más información, vea la sección Tipos de
enumeración como marcas de bits del artículo Tipos de enumeración.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar los operadores ~ , << , >> , >>> , & , | y
^ . Cuando se sobrecarga un operador binario, también se sobrecarga de forma
implícita el operador de asignación compuesta correspondiente. Un tipo definido por el
usuario no puede sobrecargar de forma explícita un operador de asignación compuesta.

Si un tipo definido por el usuario T sobrecarga el operador << , >> o >>> , el tipo del
operando izquierdo debe ser T . En C# 10 y versiones anteriores, el tipo del operando
derecho debe ser int ; a partir de C# 11, el tipo del operando derecho de un operador
de desplazamiento sobrecargado puede ser cualquiera.
especificación del lenguaje C#
Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Operador de complemento bit a bit

Operadores de desplazamiento
Operadores lógicos
Asignación compuesta
Promociones numéricas
C# 11: requisitos de desplazamiento relajados
C# 11: operador lógico de desplazamiento a la derecha

Vea también
Referencia de C#
Operadores y expresiones de C#
Operadores lógicos booleanos
Operadores de igualdad: prueban si dos
objetos son iguales o no
Artículo • 17/02/2023 • Tiempo de lectura: 5 minutos

Los operadores == (igualdad) y != (desigualdad) comprueban si los operandos son

iguales. Los tipos de valor son iguales cuando su contenido es igual. Los tipos de
referencia son iguales cuando las dos variables hacen referencia al mismo
almacenamiento.

Operador de igualdad ==
El operador de igualdad == devuelve true si sus operandos son iguales; en caso
contrario, devuelve false .

Igualdad entre tipos de valor

Los operandos de los tipos de valor integrados son iguales si sus valores son iguales:

C#

int a = 1 + 2 + 3;

int b = 6;

Console.WriteLine(a == b); // output: True

char c1 = 'a';

char c2 = 'A';

Console.WriteLine(c1 == c2); // output: False

Console.WriteLine(c1 == char.ToLower(c2)); // output: True

７ Nota

Para los operadores == , <, >, <= y >=, si cualquier operando no es un número
(Double.NaN o Single.NaN), el resultado del operador será false . Esto significa
que el valor NaN no es mayor, inferior ni igual que cualquier otro valor double o
float , incluido NaN . Para obtener más información y ejemplos, vea el artículo de
referencia Double.NaN o Single.NaN.

Dos operandos del mismo tipo enum son iguales si los valores correspondientes del
tipo entero subyacente son iguales.
Los tipos struct definidos por el usuario no son compatibles con el operador == de
forma predeterminada. Para admitir el operador == , un elemento struct definido por el
usuario debe sobrecargarlo.

Los operadores == y != son compatibles con las tuplas de C#. Si desea más
información, consulte la sección Igualdad de tupla del artículo Tipos de tupla.

Igualdad entre tipos de referencia

De forma predeterminada, dos operandos de tipo de referencia que no son registros
son iguales si hacen referencia al mismo objeto:

C#

public class ReferenceTypesEquality

public class MyClass

private int id;

public MyClass(int id) => this.id = id;

public static void Main()

var a = new MyClass(1);

var b = new MyClass(1);

var c = a;

Console.WriteLine(a == b); // output: False

Console.WriteLine(a == c); // output: True

Como se muestra en el ejemplo, el operador == es compatible de forma

predeterminada con los tipos de referencia definidos por el usuario. Sin embargo, un
tipo de referencia puede sobrecargar el operador == . Si un tipo de referencia
sobrecarga el operador == , use el método Object.ReferenceEquals para comprobar si
dos referencias de ese tipo hacen referencia al mismo objeto.

Igualdad entre tipos de registro

Disponibles en C# 9.0 y versiones posteriores, los tipos de registro admiten los
operadores == y != que, de forma predeterminada, proporcionan semántica de
igualdad de valores. Es decir, dos operandos de registro son iguales cuando ambos son
null o los valores correspondientes de todos los campos y las propiedades

implementadas de forma automática son iguales.

C#

public class RecordTypesEquality

public record Point(int X, int Y, string Name);

public record TaggedNumber(int Number, List<string> Tags);

public static void Main()

var p1 = new Point(2, 3, "A");

var p2 = new Point(1, 3, "B");

var p3 = new Point(2, 3, "A");

Console.WriteLine(p1 == p2); // output: False

Console.WriteLine(p1 == p3); // output: True

var n1 = new TaggedNumber(2, new List<string>() { "A" });

var n2 = new TaggedNumber(2, new List<string>() { "A" });

Console.WriteLine(n1 == n2); // output: False

Como se muestra en el ejemplo anterior, para miembros de tipo de referencia que no

son de registro, se comparan sus valores de referencia, no las instancias a las que se
hace referencia.

Igualdad entre cadenas

Dos operandos string son iguales si ambos son null , o bien si las instancias de ambas
cadenas tienen la misma longitud y los mismos caracteres en cada posición de
caracteres:

C#

string s1 = "hello!";

string s2 = "HeLLo!";

Console.WriteLine(s1 == s2.ToLower()); // output: True

string s3 = "Hello!";

Console.WriteLine(s1 == s3); // output: False

Las comparaciones de igualdad de cadenas son comparaciones ordinales que

distinguen mayúsculas de minúsculas. Para obtener más información sobre la
comparación de cadenas, vea Cómo comparar cadenas en C# .
Igualdad entre delegados
Dos operandos de delegado con el mismo tipo de entorno de ejecución son iguales
cuando ambos son null , o bien cuando sus listas de invocación tienen la misma
longitud y las mismas entradas en cada posición:

C#

Action a = () => Console.WriteLine("a");

Action b = a + a;

Action c = a + a;

Console.WriteLine(object.ReferenceEquals(b, c)); // output: False

Console.WriteLine(b == c); // output: True

Para obtener más información, vea la sección sobre los operadores de igualdad entre
delegados de la Especificación del lenguaje C#.

Los delegados que se producen mediante la evaluación de expresiones lambda

semánticamente idénticas no son iguales, como se muestra en el ejemplo siguiente:

C#

Action a = () => Console.WriteLine("a");

Action b = () => Console.WriteLine("a");

Console.WriteLine(a == b); // output: False

Console.WriteLine(a + b == a + b); // output: True

Console.WriteLine(b + a == a + b); // output: False

Operador de desigualdad !=
El operador de desigualdad ( != ) devuelve true si sus operandos no son iguales; en
caso contrario, devuelve false . Para los operandos de los tipos integrados, la expresión
x != y genera el mismo resultado que la expresión !(x == y) . Para obtener más
información sobre la igualdad de tipos, vea la sección Operador de igualdad.

En el siguiente ejemplo se muestra el uso del operador != :

C#

int a = 1 + 1 + 2 + 3;

int b = 6;

Console.WriteLine(a != b); // output: True

 string s1 = "Hello";

string s2 = "Hello";

Console.WriteLine(s1 != s2); // output: False

object o1 = 1;

object o2 = 1;

Console.WriteLine(o1 != o2); // output: True

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar los operadores == y != . Si un tipo
sobrecarga uno de los dos operadores, también debe sobrecargar el otro.

Un tipo de registro no puede sobrecargar de forma explícita los operadores == y != . Si

tiene que cambiar el comportamiento de los operadores == y != para el tipo de
registro T , implemente el método IEquatable<T>.Equals con la signatura siguiente:

C#

public virtual bool Equals(T? other);

Especificación del lenguaje C#

Para obtener más información, vea la sección Operadores de comprobación de tipos y
relacionales de la Especificación del lenguaje de C#.

Para obtener más información sobre la igualdad de los tipos de registro, vea la sección
Miembros de igualdad de la nota de propuesta de características de registros.

Vea también
Referencia de C#
Operadores y expresiones de C#
System.IEquatable<T>
Object.Equals
Object.ReferenceEquals
Comparaciones de igualdad
Operadores de comparación
Operadores de comparación (referencia
de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

Los operadores de la comparación < (menor que), > (mayor que), <= (menor o igual
que) y >= (mayor o igual que), también conocidos como relacionales, comparan sus
operandos. Estos operadores se admiten en todos los tipos numéricos enteros y de
punto flotante.

７ Nota

Para los operadores == , < , > , <= y >= , si cualquier operando no es un número
(Double.NaN o Single.NaN), el resultado del operador será false . Esto significa
que el valor NaN no es mayor, inferior ni igual que cualquier otro valor double o
float , incluido NaN . Para obtener más información y ejemplos, vea el artículo de
referencia Double.NaN o Single.NaN.

El tipo char también admite operadores de comparación. En el caso de los operandos

char , se comparan los códigos de caracteres correspondientes.

Los tipos de enumeración también admiten operadores de comparación. Para los

operandos del mismo tipo enum, se comparan los valores correspondientes del tipo
entero subyacente.

Los operadores == y != comprueban si los operandos son iguales.

Operador menor que <

El operador < devuelve true si el operando izquierdo es menor que el derecho; en caso
contrario, devuelve false .

C#

Console.WriteLine(7.0 < 5.1); // output: False

Console.WriteLine(5.1 < 5.1); // output: False

Console.WriteLine(0.0 < 5.1); // output: True

Console.WriteLine(double.NaN < 5.1); // output: False

Console.WriteLine(double.NaN >= 5.1); // output: False

Operador mayor que >

El operador > devuelve true si el operando izquierdo es mayor que el derecho; en caso
contrario, devuelve false .

C#

Console.WriteLine(7.0 > 5.1); // output: True

Console.WriteLine(5.1 > 5.1); // output: False

Console.WriteLine(0.0 > 5.1); // output: False

Console.WriteLine(double.NaN > 5.1); // output: False

Console.WriteLine(double.NaN <= 5.1); // output: False

Operador menor o igual que <=

El operador <= devuelve true si el operando izquierdo es menor o igual que el
derecho; en caso contrario, devuelve false .

C#

Console.WriteLine(7.0 <= 5.1); // output: False

Console.WriteLine(5.1 <= 5.1); // output: True

Console.WriteLine(0.0 <= 5.1); // output: True

Console.WriteLine(double.NaN > 5.1); // output: False

Console.WriteLine(double.NaN <= 5.1); // output: False

Operador mayor o igual que >=

El operador >= devuelve true si el operando izquierdo es mayor o igual que el derecho;
en caso contrario, devuelve false .

C#

Console.WriteLine(7.0 >= 5.1); // output: True

Console.WriteLine(5.1 >= 5.1); // output: True

Console.WriteLine(0.0 >= 5.1); // output: False

Console.WriteLine(double.NaN < 5.1); // output: False

Console.WriteLine(double.NaN >= 5.1); // output: False

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar los operadores < , > , <= y >= .

Si un tipo sobrecarga uno de los operadores < o > , también debe sobrecargar < y > . Si
un tipo sobrecarga uno de los operadores <= o >= , también debe sobrecargar <= y >= .

Especificación del lenguaje C#

Para obtener más información, vea la sección Operadores de comprobación de tipos y
relacionales de la Especificación del lenguaje de C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
System.IComparable<T>
Operadores de igualdad
Operadores y expresiones de acceso a
miembros: los operadores de punto,
indexador e invocación.
Artículo • 15/02/2023 • Tiempo de lectura: 11 minutos

Use varios operadores y expresiones para tener acceso a un miembro de tipo. Estos
operadores incluyen el acceso a miembros ( . ), el elemento de matriz o el acceso al
indizador ( [] ), el índice desde el extremo (), el intervalo ( .. ^ ), los operadores
condicionales NULL ( ?. y ) y ?[] la invocación del método ( () ). Entre ellas se incluyen
los operadores de acceso a miembros condicionales NULL ( .? ) e acceso de indexador ( ?
[] ).

. (acceso a miembros): para acceder a un miembro de un espacio de nombres o un

tipo
[] (elemento de matriz o acceso a indizador): para acceder a un elemento de matriz
o un indizador de tipo
?. y ?[] (operadores condicionales NULL): para realizar una operación de acceso a
elementos o miembros solo si un operando es distinto de NULL
() (invocación): para llamar a un método de acceso o invocar un delegado
^ (índice desde el final) : para indicar que la posición del elemento se encuentra a
partir del final de una secuencia
.. (intervalo): para especificar un intervalo de índices que puede utilizar para
obtener un intervalo de elementos de secuencia

Expresión de acceso a miembros .

Use el token . para acceder a un miembro de un espacio de nombres o un tipo, como
se muestran en los ejemplos siguientes:

Use . para acceder a un espacio de nombres anidado dentro de un espacio de

nombres, como se muestra en el siguiente ejemplo de una directiva using:

C#

using System.Collections.Generic;

Use . para formar un nombre completo para tener acceso a un tipo dentro de un
espacio de nombres, como se muestra en el código siguiente:
 C#

System.Collections.Generic.IEnumerable<int> numbers = new int[] { 1, 2, 3 };

Utilice una directiva using para hacer que el uso de nombres completos sea opcional.

Use . para tener acceso a los miembros de tipo, que no son estáticos y, como se
muestra en el código siguiente:

C#

var constants = new List<double>();

constants.Add(Math.PI);

constants.Add(Math.E);

Console.WriteLine($"{constants.Count} values to show:");

Console.WriteLine(string.Join(", ", constants));

// Output:

// 2 values to show:

// 3.14159265358979, 2.71828182845905

También puede usar . para acceder a un método de extensión.

Operador del indizador []

Los corchetes, [] , se suelen usar para el acceso a matriz, indizador o elemento de
puntero.

Acceso a matriz
En el ejemplo siguiente se muestra cómo se obtiene acceso a los elementos de matriz:

C#

int[] fib = new int[10];

fib[0] = fib[1] = 1;

for (int i = 2; i < fib.Length; i++)

fib[i] = fib[i - 1] + fib[i - 2];

Console.WriteLine(fib[fib.Length - 1]); // output: 55

double[,] matrix = new double[2,2];

matrix[0,0] = 1.0;

matrix[0,1] = 2.0;

matrix[1,0] = matrix[1,1] = 3.0;

var determinant = matrix[0,0] * matrix[1,1] - matrix[1,0] * matrix[0,1];

Console.WriteLine(determinant); // output: -3

Si un índice de matriz se encuentra fuera de los límites de la dimensión correspondiente

de una matriz, se produce una excepción IndexOutOfRangeException.

Tal como se muestra en el ejemplo anterior, también usa corchetes al declarar un tipo
de matriz o crear instancias de matriz.

Para obtener más información sobre las matrices, consulte Matrices.

Acceso a indizador
En el ejemplo siguiente se usa el tipo Dictionary<TKey,TValue> de .NET para mostrar el
acceso al indizador:

C#

var dict = new Dictionary<string, double>();

dict["one"] = 1;

dict["pi"] = Math.PI;

Console.WriteLine(dict["one"] + dict["pi"]); // output: 4.14159265358979

Los indizadores le permiten indizar las instancias de un tipo definido por el usuario de
un modo similar a la indización de matrices. A diferencia de los índices de matriz, que
deben ser enteros, los parámetros de indizador se pueden declarar para ser de cualquier
tipo.

Para más información sobre los indizadores, consulte Indizadores.

Otros usos de []
Para información sobre el acceso de los elementos de puntero, consulte la sección
Operador de acceso de elemento de puntero del artículo Operadores relacionados con
el puntero.

También usa los corchetes para especificar atributos:

C#

[System.Diagnostics.Conditional("DEBUG")]

void TraceMethod() {}

Operadores condicionales ?. NULL y ?[]

Un operador condicional NULL aplica un acceso a miembros, ?. , o el acceso a
elementos, ?[] , operación a su operando solo si ese operando se evalúa como no
NULL; de lo contrario, devuelve null . Es decir:

Si a se evalúa como null , el resultado de a?.x o a?[x] es null .

Si a se evalúa como no NULL, el resultado de a?.x o a?[x] es el mismo que el

resultado de a.x o a[x] , respectivamente.

７ Nota

Si a.x o a[x] producen una excepción, a?.x o a?[x] produciría la misma

excepción para a no NULL. Por ejemplo, si a es una instancia de matriz que
no es NULL y x está fuera de los límites de a , a?[x] produciría una
excepción IndexOutOfRangeException.

Los operadores de condición NULL se cortocircuitan. Es decir, si una operación en una

cadena de la operación de acceso a elementos o miembros condicional devuelve null ,
no se ejecuta el resto de la cadena. En el ejemplo siguiente, B no se evalúa si se evalúa
como A null y C no se evalúa si A o B se evalúa como null :

C#

A?.B?.Do(C);

A?.B?[C];

Si A podría ser NULL pero B y C no sería NULL si A no es NULL, solo tiene que aplicar el
operador condicional null a A :

C#

A?.B.C();

En el ejemplo anterior, B no se evalúa y C() no se llama a si A es NULL. Sin embargo, si

se interrumpe el acceso a miembros encadenados, por ejemplo, entre paréntesis como
en (A?.B).C() , no se produciría un cortocircuito.

En los ejemplos siguientes se muestra el uso de los operadores ?. y ?[] :

C#
double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)

return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;

var sum1 = SumNumbers(null, 0);

Console.WriteLine(sum1); // output: NaN

var numberSets = new List<double[]>

new[] { 1.0, 2.0, 3.0 },

null

};

var sum2 = SumNumbers(numberSets, 0);

Console.WriteLine(sum2); // output: 6

var sum3 = SumNumbers(numberSets, 1);

Console.WriteLine(sum3); // output: NaN

C#

namespace MemberAccessOperators2;

public static class NullConditionalShortCircuiting

public static void Main()

Person person = null;

person?.Name.Write(); // no output: Write() is not called due to

short-circuit.

try

(person?.Name).Write();

catch (NullReferenceException)

Console.WriteLine("NullReferenceException");

}; // output: NullReferenceException

public class Person

public FullName Name { get; set; }

public class FullName

public string FirstName { get; set; }

public string LastName { get; set; }

public void Write()

Console.WriteLine($"{FirstName} {LastName}");

En el primero de los dos ejemplos anteriores también se usa el operador de fusión de

NULL ?? para especificar una expresión alternativa que se evaluará en caso de que el
resultado de la operación condicional NULL sea null .

Si a.x o a[x] es de un tipo de valor que no admite un valores NULL, T , a?.x o a?[x]
es del tipo de valor que admite un valor NULL T? correspondiente. Si necesita una
expresión de tipo T , aplique el operador de fusión de NULL ?? a una expresión
condicional NULL, tal como se muestra en el ejemplo siguiente:

C#

int GetSumOfFirstTwoOrDefault(int[] numbers)

if ((numbers?.Length ?? 0) < 2)

return 0;

return numbers[0] + numbers[1];

Console.WriteLine(GetSumOfFirstTwoOrDefault(null)); // output: 0

Console.WriteLine(GetSumOfFirstTwoOrDefault(new int[0])); // output: 0

Console.WriteLine(GetSumOfFirstTwoOrDefault(new[] { 3, 4, 5 })); // output:

7

En el ejemplo anterior, si no utiliza el operador ?? , numbers?.Length < 2 da como

resultado false cuando numbers es null .

７ Nota

El operador ?. evalúa el operando de la izquierda no más de una vez, lo que

garantiza que no se pueda cambiar a null después de verificarse como no NULL.

El operador de acceso de miembro condicional NULL ?. también se conoce con el

nombre de operador Elvis.

Invocación de delegado seguro para subprocesos

Use el operador ?. para comprobar si un delegado es distinto de NULL y se invoca de
forma segura para subprocesos (por ejemplo, cuando se genera un evento), tal como se
muestra en el código siguiente:

C#

PropertyChanged?.Invoke(…)

El código es equivalente al siguiente:

C#

var handler = this.PropertyChanged;

if (handler != null)

handler(…);

El ejemplo anterior es una manera segura para subprocesos para asegurarse de que
solo se invoca un valor distinto de NULL handler . Dado que las instancias de delegado
son inmutables, ningún subproceso puede cambiar el valor al que hace referencia la
variable local handler . En concreto, si el código que ha ejecutado otro subproceso
cancela la suscripción del evento PropertyChanged y PropertyChanged se convierte en
null antes de que se invoque handler , el objeto al que hace referencia handler queda

intacto.

Expresión de invocación ()
Utilice paréntesis, () , para llamar a un método o invocar un delegado.

En el ejemplo siguiente se muestra cómo llamar a un método, con o sin argumentos, y

cómo invocar un delegado:

C#

Action<int> display = s => Console.WriteLine(s);

var numbers = new List<int>();

numbers.Add(10);

numbers.Add(17);

display(numbers.Count); // output: 2

numbers.Clear();

display(numbers.Count); // output: 0

También usa paréntesis al invocar un constructor con el operador new.

Otros usos de ()
También usa los paréntesis para ajustar el orden en el que se van a evaluar operaciones
en una expresión. Para obtener más información, vea Operadores de C# (referencia de
C#).

Expresiones de conversión, que realizan conversiones de tipo explícitas, también utilizan

paréntesis.

Indexación desde el operador final ^

El operador ^ indica la posición del elemento a partir del final de una secuencia. En el
caso de una secuencia de longitud  length , ^n apunta al elemento con desplazamiento
length - n desde el inicio de una secuencia. Por ejemplo, ^1 apunta al último elemento

de una secuencia y ^length apunta al primer elemento de una secuencia.

C#

int[] xs = new[] { 0, 10, 20, 30, 40 };

int last = xs[^1];

Console.WriteLine(last); // output: 40

var lines = new List<string> { "one", "two", "three", "four" };

string prelast = lines[^2];

Console.WriteLine(prelast); // output: three

string word = "Twenty";

Index toFirst = ^word.Length;

char first = word[toFirst];

Console.WriteLine(first); // output: T

Como se muestra en el ejemplo anterior, la expresión ^e es del tipo System.Index. En la

expresión ^e , el resultado de e debe poderse convertir implícitamente a  int .

También puede usar el operador ^ con el operador de intervalo para crear un intervalo
de índices. Para más información, consulte Índices y rangos.

Operador Range ..
El operador .. especifica el inicio y el final de un intervalo de índices como sus
operandos. El operando izquierdo es un inicio inclusivo de un intervalo. El operando
derecho es un inicio exclusivo de un intervalo. Cualquiera de los operandos puede ser un
índice desde el inicio o desde el final de una secuencia, tal y como muestra el ejemplo
siguiente:

C#

int[] numbers = new[] { 0, 10, 20, 30, 40, 50 };

int start = 1;

int amountToTake = 3;

int[] subset = numbers[start..(start + amountToTake)];

Display(subset); // output: 10 20 30

int margin = 1;

int[] inner = numbers[margin..^margin];

Display(inner); // output: 10 20 30 40

string line = "one two three";

int amountToTakeFromEnd = 5;

Range endIndices = ^amountToTakeFromEnd..^0;

string end = line[endIndices];

Console.WriteLine(end); // output: three

void Display<T>(IEnumerable<T> xs) => Console.WriteLine(string.Join(" ",

xs));

Como se muestra en el ejemplo anterior, la expresión a..b es del tipo System.Range. En

la expresión a..b , los resultados de a y b deben poderse convertir implícitamente
a Int32 o Index.

） Importante

Las conversiones implícitas de int a Index producen una excepción

ArgumentOutOfRangeException cuando el valor es negativo.

Puede omitir cualquiera de los operandos del operador .. para obtener un intervalo
abierto:

a.. es equivalente a a..^0

..b es equivalente a 0..b

.. es equivalente a 0..^0

C#

int[] numbers = new[] { 0, 10, 20, 30, 40, 50 };

int amountToDrop = numbers.Length / 2;

 int[] rightHalf = numbers[amountToDrop..];

Display(rightHalf); // output: 30 40 50

int[] leftHalf = numbers[..^amountToDrop];

Display(leftHalf); // output: 0 10 20

int[] all = numbers[..];

Display(all); // output: 0 10 20 30 40 50

void Display<T>(IEnumerable<T> xs) => Console.WriteLine(string.Join(" ",

xs));

En la tabla siguiente se muestran varias maneras de expresar los intervalos de colección:

Expresión del operador de Descripción

intervalo

.. Todos los valores de la colección.

..end Valores desde el principio hasta end exclusivamente.

start.. Valores desde start inclusivamente hasta el final.

start..end Valores desde start inclusivamente hasta end exclusivamente.

^start.. Valores desde start inclusivamente hasta el final contando desde

el final.

..^end Valores desde el inicio hasta end exclusivamente contando desde

el final.

start..^end Valores de start inclusivamente a end exclusivamente contando

desde el final.

^start..^end Valores de start inclusivamente a end exclusivamente contando

ambos desde el final.

En el ejemplo siguiente se muestra el efecto de usar todos los intervalos presentados en

la tabla anterior:

C#

int[] oneThroughTen =

1, 2, 3, 4, 5, 6, 7, 8, 9, 10

};

Write(oneThroughTen, ..);

Write(oneThroughTen, ..3);

Write(oneThroughTen, 2..);

Write(oneThroughTen, 3..5);

 Write(oneThroughTen, ^2..);

Write(oneThroughTen, ..^3);

Write(oneThroughTen, 3..^4);

Write(oneThroughTen, ^4..^2);

static void Write(int[] values, Range range) =>

Console.WriteLine($"{range}:\t{string.Join(", ", values[range])}");

// Sample output:

// 0..^0: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

// 0..3: 1, 2, 3

// 2..^0: 3, 4, 5, 6, 7, 8, 9, 10

// 3..5: 4, 5

// ^2..^0: 9, 10

// 0..^3: 1, 2, 3, 4, 5, 6, 7

// 3..^4: 4, 5, 6

// ^4..^2: 7, 8

Para más información, consulte Índices y rangos.

Posibilidad de sobrecarga del operador

Los . operadores , ^ () , y .. no se pueden sobrecargar. El operador [] también se
considera un operador que no se puede sobrecargar. Use indizadores para admitir la
indización con tipos definidos por el usuario.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Acceso a miembros
Acceso a elementos
El operador "null conditional member access"
Expresiones de invocación

Para más información sobre índices y rangos, vea la nota de propuesta de

características.

Vea también
Uso del operador "index" (regla de estilo IDE0056)
Uso del operador "range" (regla de estilo IDE0057)
Uso de la llamada de delegado condicional (regla de estilo IDE1005)
Referencia de C#
Operadores y expresiones de C#
?? (operador de fusión de NULL)
Operador ::
Operadores de prueba de tipos y
expresión de conversión: is , as , typeof
y conversiones
Artículo • 17/02/2023 • Tiempo de lectura: 7 minutos

Estos operadores y expresiones realizan la comprobación de tipos o la conversión de

tipos. El is operador comprueba si el tipo en tiempo de ejecución de una expresión es
compatible con un tipo determinado. El as operador convierte explícitamente una
expresión a un tipo determinado si su tipo en tiempo de ejecución es compatible con
ese tipo. Las expresiones de conversión realizan una conversión explícita a un tipo de
destino. El typeof operador obtiene la instancia System.Type para un tipo.

Operador is
El operador is comprueba si el tipo en tiempo de ejecución del resultado de una
expresión es compatible con un tipo determinado. El operador is también prueba el
resultado de una expresión en relación con un patrón.

La expresión con el operador is de prueba de tipos tiene el formato siguiente:

C#

E is T

donde E es una expresión que devuelve un valor y T es el nombre de un tipo o un

parámetro de tipo. E no puede ser un método anónimo ni una expresión lambda.

El operador is devuelve true cuando el resultado de una expresión es distinto de

NULL y se cumple cualquiera de las condiciones siguientes:

El tipo en tiempo de ejecución del resultado de una expresión es T .

El tipo en tiempo de ejecución del resultado de una expresión deriva del tipo T ,
implementa una interfaz T , o bien otra conversión de referencia implícita existe en
T.

El tipo en tiempo de ejecución del resultado de una expresión es un tipo de valor

que admite un valor NULL con el tipo subyacente T y Nullable<T>.HasValue es
true .
 Existe una conversión boxing o unboxing del tipo en tiempo de ejecución del
resultado de una expresión al tipo T .

El operador is no toma en consideración las conversiones definidas por el usuario.

En el ejemplo siguiente se muestra que el operador is devuelve true si el tipo en

tiempo de ejecución del resultado de una expresión se deriva de un tipo determinado,
es decir, existe una conversión de referencia entre tipos:

C#

public class Base { }

public class Derived : Base { }

public static class IsOperatorExample

public static void Main()

object b = new Base();

Console.WriteLine(b is Base); // output: True

Console.WriteLine(b is Derived); // output: False

object d = new Derived();

Console.WriteLine(d is Base); // output: True

Console.WriteLine(d is Derived); // output: True

En el ejemplo siguiente se muestra que el operador is tiene en cuenta las conversiones

boxing y unboxing pero no considera las conversiones numéricas:

C#

int i = 27;

Console.WriteLine(i is System.IFormattable); // output: True

object iBoxed = i;

Console.WriteLine(iBoxed is int); // output: True

Console.WriteLine(iBoxed is long); // output: False

Para obtener información acerca de las conversiones de C#, vea el capítulo Conversiones
de la especificación del lenguaje C#.

Prueba de tipos con coincidencia de patrones

El operador is también prueba el resultado de una expresión en relación con un
patrón. En el ejemplo siguiente se muestra cómo usar un patrón de declaración para
comprobar el tipo en tiempo de ejecución de una expresión:

C#

int i = 23;

object iBoxed = i;

int? jNullable = 7;

if (iBoxed is int a && jNullable is int b)

Console.WriteLine(a + b); // output 30

Para obtener información sobre los patrones admitidos, consulte Patrones.

Operador as
El operador as convierte explícitamente el resultado de una expresión en una referencia
determinada o un tipo de valor que acepta valores NULL. Si la conversión no es posible,
el operador as devuelve null . A diferencia de la expresión Cast, el operador as no
genera nunca una excepción.

La expresión con el formato

C#

E as T

donde E es una expresión que devuelve un valor y T es el nombre de un tipo o un

parámetro de tipo produce el mismo resultado que

C#

E is T ? (T)(E) : (T)null

salvo que E solo se evalúa una vez.

El operador as solo considera las conversiones de referencia, las que aceptan valores
NULL, boxing y unboxing. No puede usar el operador as para realizar una conversión
definida por el usuario. Para ello, use una expresión Cast.

En el siguiente ejemplo se muestra el uso del operador as :

 C#

IEnumerable<int> numbers = new[] { 10, 20, 30 };

IList<int> indexable = numbers as IList<int>;

if (indexable != null)

Console.WriteLine(indexable[0] + indexable[indexable.Count - 1]); //

output: 40

７ Nota

Como se muestra en el ejemplo anterior, se necesita comparar el resultado de la

expresión as con null para comprobar si una conversión es correcta. Puede usar
el operador is para probar si la conversión es correcta y, si es así, asignar su
resultado a una nueva variable.

Expresión Cast
Una expresión de conversión con el formato (T)E realiza una conversión explícita del
resultado de la expresión E al tipo T . Si no existe ninguna conversión explícita del tipo
de E al tipo T , se producirá un error en tiempo de compilación. En el tiempo de
ejecución, una conversión explícita podría no completarse correctamente y una
expresión de conversión podría generar una excepción.

El ejemplo siguiente muestra las conversiones explícitas numérica y de referencia:

C#

double x = 1234.7;

int a = (int)x;

Console.WriteLine(a); // output: 1234

IEnumerable<int> numbers = new int[] { 10, 20, 30 };

IList<int> list = (IList<int>)numbers;

Console.WriteLine(list.Count); // output: 3

Console.WriteLine(list[1]); // output: 20

Para obtener más información sobre las conversiones explícitas, vea la sección
Conversiones explícitas de la especificación del lenguaje C#. Para obtener información
sobre cómo definir una conversión personalizada de tipo explícito o implícito, vea
Operadores de conversión definidos por el usuario.
Otros usos de ()
También puede utilizar paréntesis para llamar a un método o invocar un delegado.

Sirven además para ajustar el orden en el que se van a evaluar operaciones en una
expresión. Para obtener más información, vea Operadores de C# (referencia de C#).

typeof (operador)
El operador typeof obtiene la instancia System.Type para un tipo. El argumento del
operador typeof debe ser el nombre de un tipo o un parámetro de tipo, como se
muestra en el ejemplo siguiente:

C#

void PrintType<T>() => Console.WriteLine(typeof(T));

Console.WriteLine(typeof(List<string>));

PrintType<int>();

PrintType<System.Int32>();

PrintType<Dictionary<int, char>>();

// Output:

// System.Collections.Generic.List`1[System.String]

// System.Int32

// System.Int32

// System.Collections.Generic.Dictionary`2[System.Int32,System.Char]

El argumento no debe ser un tipo que requiera anotaciones de metadatos. Algunos

tipos de ejemplo son:

dynamic

string? (o cualquier tipo de referencia que acepte valores NULL)

Estos tipos no se representan directamente en los metadatos. Los tipos incluyen

atributos que describen el tipo subyacente. En ambos casos se puede usar el tipo
subyacente. En lugar de dynamic , se puede usar object . En lugar de string? , se puede
usar string .

También se puede usar el operador typeof con tipos genéricos sin enlazar. El nombre
de un tipo genérico sin enlazar debe contener el número apropiado de comas, que es
inferior en una unidad al número de parámetros de tipo. En el siguiente ejemplo se
muestra el uso del operador typeof con un tipo genérico sin enlazar:

C#
 Console.WriteLine(typeof(Dictionary<,>));

// Output:

// System.Collections.Generic.Dictionary`2[TKey,TValue]

Una expresión no puede ser un argumento del operador typeof . Para obtener la
instancia de System.Type para el tipo en tiempo de ejecución del resultado de una
expresión, use el método Object.GetType.

Prueba de tipos con el operador typeof

Use el operador typeof para comprobar si el tipo en tiempo de ejecución del resultado
de la expresión coincide exactamente con un tipo determinado. En el ejemplo siguiente
se muestra la diferencia entre la comprobación de tipos realizada con el operador
typeof y el operador is:

C#

public class Animal { }

public class Giraffe : Animal { }

public static class TypeOfExample

public static void Main()

object b = new Giraffe();

Console.WriteLine(b is Animal); // output: True

Console.WriteLine(b.GetType() == typeof(Animal)); // output: False

Console.WriteLine(b is Giraffe); // output: True

Console.WriteLine(b.GetType() == typeof(Giraffe)); // output: True

Posibilidad de sobrecarga del operador

Los operadores is , as y typeof no se pueden sobrecargar.

Un tipo definido por el usuario no se puede sobrecargar el operador () , pero puede

definir conversiones de tipos personalizadas que pueden realizarse mediante una
expresión de conversión. Para obtener más información, vea Operadores de conversión
definidos por el usuario.
Especificación del lenguaje C#
Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

El operador is
El operador as
Expresiones de conversión
El operador typeof

Vea también
Referencia de C#
Operadores y expresiones de C#
Procedimiento para convertir de forma segura mediante la coincidencia de
patrones y los operadores is y as
Elementos genéricos en .NET
Operadores de conversión explícitos e
implícitos definidos por el usuario
Artículo • 18/02/2023 • Tiempo de lectura: 2 minutos

Un tipo definido por el usuario puede definir una conversión implícita o explícita
personalizada desde o a otro tipo. Las conversiones implícitas no requieren que se
invoque una sintaxis especial y pueden producirse en diversas situaciones, por ejemplo,
en las invocaciones de métodos y asignaciones. Las conversiones implícitas predefinidas
en C# siempre se realizan correctamente y nunca inician una excepción. Las
conversiones implícitas definidas por el usuario deben comportarse de esta manera. Si
una conversión personalizada puede producir una excepción o perder información, se
define como una conversión explícita.

Los operadores is y as no tienen en cuenta las conversiones definidas por el usuario. Use
una expresión Cast para invocar una conversión explícita definida por el usuario.

Use las palabras clave operator y implicit o explicit para definir una conversión
implícita o explícita, respectivamente. El tipo que define una conversión debe ser un tipo
de origen o un tipo de destino de dicha conversión. Una conversión entre dos tipos
definidos por el usuario se puede definir en cualquiera de los dos tipos.

En el ejemplo siguiente se muestra cómo se define una conversión implícita y explícita:

C#

using System;

public readonly struct Digit

private readonly byte digit;

public Digit(byte digit)

if (digit > 9)

throw new ArgumentOutOfRangeException(nameof(digit), "Digit

cannot be greater than nine.");

this.digit = digit;

public static implicit operator byte(Digit d) => d.digit;

public static explicit operator Digit(byte b) => new Digit(b);

public override string ToString() => $"{digit}";

 public static class UserDefinedConversions

public static void Main()

var d = new Digit(7);

byte number = d;

Console.WriteLine(number); // output: 7

Digit digit = (Digit)number;

Console.WriteLine(digit); // output: 7

A partir de C# 11, puede definir operadores de conversión explícitos comprobados. Para

obtener más información, consulte la sección Operadores comprobados definidos por el
usuario del artículo Operadores aritméticos.

Use también la palabra clave operator para sobrecargar un operador predefinido en C#.
Para obtener más información, vea Sobrecarga de operadores.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Operadores de conversión
Conversiones definidas por el usuario
Conversiones implícitas
Conversiones explícitas

Vea también
Referencia de C#
Operadores y expresiones de C#
Sobrecarga de operadores
Operadores de conversión y prueba de tipos
Conversiones de tipos
Directrices de diseño: operadores de conversión
Chained user-defined explicit conversions in C# (Conversiones explícitas
encadenadas definidas por el usuario en C#)
Operadores relacionados con el
puntero: tome la dirección de las
variables, las ubicaciones de
almacenamiento de desreferencia y las
ubicaciones de memoria de acceso
Artículo • 17/02/2023 • Tiempo de lectura: 8 minutos

Los operadores de puntero permiten tomar la dirección de una variable ( & ),

desreferenciar un puntero ( * ), comparar valores de puntero y agregar o restar punteros
e enteros.

Puede usar los siguientes operadores para trabajar con punteros:

Operador unario & (address-of): para obtener la dirección de una variable

Operador unario * (direccionamiento indirecto del puntero): para obtener la
variable a la que apunta un puntero
Operadores -> (acceso a miembros) y [] (acceso de elemento)
Operadores aritméticos +, -, ++ y --
Operadores de comparación ==, !=, <, >, <= y >=

Para obtener información sobre los tipos de punteros, vea Tipos de puntero.

７ Nota

Cualquier operación con punteros requiere un contexto unsafe. El código que

contenga bloques no seguros se tendrá que compilar con la opción del compilador
AllowUnsafeBlocks.

Operador address-of &

El operador unario & devuelve la dirección de su operando:

C#

unsafe

int number = 27;

int* pointerToNumber = &number;

 Console.WriteLine($"Value of the variable: {number}");

Console.WriteLine($"Address of the variable:

{(long)pointerToNumber:X}");

// Output is similar to:

// Value of the variable: 27

// Address of the variable: 6C1457DBD4

El operando del operador & debe ser una variable fija. Las variables fijas son las que
residen en ubicaciones de almacenamiento que no se ven afectadas por el
funcionamiento del recolector de elementos no utilizados. En el ejemplo anterior, la
variable local number es una variable fija, ya que reside en la pila. Las variables que
residen en ubicaciones de almacenamiento que pueden verse afectadas por el
recolector de elementos no utilizados (por ejemplo, reubicadas) se denominan variables
móviles. Los campos de objeto y los elementos de matriz son ejemplos de variables
móviles. Puede obtener la dirección de una variable móvil si la "fija" o "ancla" con una
instrucción fixed. La dirección obtenida solo es válida dentro del bloque de una
instrucción fixed . En el ejemplo siguiente se muestra cómo usar una instrucción fixed
y el operador & :

C#

unsafe

byte[] bytes = { 1, 2, 3 };

fixed (byte* pointerToFirst = &bytes[0])

// The address stored in pointerToFirst

// is valid only inside this fixed statement block.

No se puede obtener la dirección de una constante o un valor.

Para obtener más información sobre las variables fijas y móviles, vea la sección Variables
fijas y móviles de Especificación del lenguaje C#.

El operador binario & calcula el AND lógico de sus operandos booleanos o el AND
lógico bit a bit de sus operandos enteros.

Operador de direccionamiento indirecto del

puntero *
El operador unario de direccionamiento indirecto del puntero * obtiene la variable a la
que apunta su operando. También se conoce como operador de desreferencia. El
operando del operador * debe ser un tipo de puntero.

C#

unsafe

char letter = 'A';

char* pointerToLetter = &letter;

Console.WriteLine($"Value of the `letter` variable: {letter}");

Console.WriteLine($"Address of the `letter` variable:

{(long)pointerToLetter:X}");

*pointerToLetter = 'Z';

Console.WriteLine($"Value of the `letter` variable after update:

{letter}");

// Output is similar to:

// Value of the `letter` variable: A

// Address of the `letter` variable: DCB977DDF4

// Value of the `letter` variable after update: Z

No se puede aplicar el operador * a una expresión de tipo void* .

El operador binario * calcula la multiplicación de sus operandos numéricos.

Operador de acceso a miembros de puntero ->

El operador -> combina el direccionamiento indirecto del puntero y el acceso a
miembros. Es decir, si x es un puntero de tipo T* y y es un miembro accesible de tipo
T , una expresión con el formato

C#

x->y

es equivalente a

C#

(*x).y

En el siguiente ejemplo se muestra el uso del operador -> :

 C#

public struct Coords

public int X;

public int Y;

public override string ToString() => $"({X}, {Y})";

public class PointerMemberAccessExample

public static unsafe void Main()

Coords coords;

Coords* p = &coords;

p->X = 3;

p->Y = 4;

Console.WriteLine(p->ToString()); // output: (3, 4)

No se puede aplicar el operador -> a una expresión de tipo void* .

Operador de acceso de elemento de puntero []

En el caso de una expresión p de un tipo de puntero, un acceso de elemento de
puntero con el formato p[n] se evalúa como *(p + n) , donde n debe ser de un tipo
convertible de forma implícita en int , uint , long o ulong . Para obtener información
sobre el comportamiento del operador + con punteros, vea la sección Suma o resta de
un valor entero en un puntero.

En el ejemplo siguiente se muestra cómo acceder a los elementos de matriz con un

puntero y el operador [] :

C#

unsafe

char* pointerToChars = stackalloc char[123];

for (int i = 65; i < 123; i++)

pointerToChars[i] = (char)i;

Console.Write("Uppercase letters: ");

for (int i = 65; i < 91; i++)

 Console.Write(pointerToChars[i]);

// Output:

// Uppercase letters: ABCDEFGHIJKLMNOPQRSTUVWXYZ

En el ejemplo anterior, una expresión stackalloc asigna un bloque de memoria en la pila.

７ Nota

El operador de acceso de elemento de puntero no busca errores fuera de límites.

No puede usar [] para el acceso de elemento de puntero con una expresión de tipo
void* .

También puede usar el operador [] para acceso de elemento de matriz o indizador.

Operadores aritméticos de puntero

Puede realizar las siguientes operaciones aritméticas con punteros:

Agregar o restar un valor entero en un puntero

Restar dos punteros
Incrementar o reducir un puntero

No es posible realizar esas operaciones con punteros de tipo void* .

Para obtener información sobre las operaciones aritméticas admitidas con tipos
numéricos, vea Operadores aritméticos.

Suma o resta de un valor entero en un puntero

En el caso de un puntero p de tipo T* y una expresión n de un tipo convertible de
forma implícita en int , uint , long o ulong , la suma y la resta se definen de este modo:

Ambas expresiones p + n y n + p generan un puntero de tipo T* que resulta de

agregar n * sizeof(T) a la dirección proporcionada por p .
La expresión p - n genera un puntero de tipo T* que resulta de restar n *
sizeof(T) a la dirección proporcionada por p .

El operador sizeof obtiene el tamaño de un tipo en bytes.

En el siguiente ejemplo se muestra el uso del operador + con un puntero:

 C#

unsafe

const int Count = 3;

int[] numbers = new int[Count] { 10, 20, 30 };

fixed (int* pointerToFirst = &numbers[0])

int* pointerToLast = pointerToFirst + (Count - 1);

Console.WriteLine($"Value {*pointerToFirst} at address

{(long)pointerToFirst}");

Console.WriteLine($"Value {*pointerToLast} at address

{(long)pointerToLast}");

// Output is similar to:

// Value 10 at address 1818345918136

// Value 30 at address 1818345918144

Resta de puntero
En el caso de dos punteros p1 y p2 de tipo T* , la expresión p1 - p2 genera la
diferencia entre las direcciones proporcionadas por p1 y p2 dividida por sizeof(T) . El
tipo del resultado es long . Es decir, p1 - p2 se calcula como ((long)(p1) - (long)(p2))
/ sizeof(T) .

El ejemplo siguiente muestra la resta de puntero:

C#

unsafe

int* numbers = stackalloc int[] { 0, 1, 2, 3, 4, 5 };

int* p1 = &numbers[1];

int* p2 = &numbers[5];

Console.WriteLine(p2 - p1); // output: 4

Incremento y decremento de puntero

El operador de incremento ++ agrega 1 a su operando de puntero. El operador de
decremento -- resta 1 a su operando de puntero.

Ambos operadores se admiten con dos formatos: postfijo ( p++ y p-- ) y prefijo ( ++p y -
-p ). El resultado de p++ y p-- es el valor de p antes de la operación. El resultado de ++p
y --p es el valor de p después de la operación.

El ejemplo siguiente muestra el comportamiento de los operadores de incremento

postfijo y prefijo:

C#

unsafe

int* numbers = stackalloc int[] { 0, 1, 2 };

int* p1 = &numbers[0];

int* p2 = p1;

Console.WriteLine($"Before operation: p1 - {(long)p1}, p2 -

{(long)p2}");

Console.WriteLine($"Postfix increment of p1: {(long)(p1++)}");

Console.WriteLine($"Prefix increment of p2: {(long)(++p2)}");

Console.WriteLine($"After operation: p1 - {(long)p1}, p2 - {(long)p2}");

// Output is similar to

// Before operation: p1 - 816489946512, p2 - 816489946512

// Postfix increment of p1: 816489946512

// Prefix increment of p2: 816489946516

// After operation: p1 - 816489946516, p2 - 816489946516

Operadores de comparación de puntero

Puede usar los operadores == , != , < , > , <= y >= para comparar los operandos de
cualquier tipo de puntero, incluido void* . Esos operadores comparan las direcciones
proporcionadas por los dos operandos como si fueran enteros sin signo.

Para obtener información sobre el comportamiento de esos operadores para operandos

de otros tipos, vea los artículos Operadores de igualdad y Operadores de comparación.

Prioridad de operadores
En la lista siguiente se ordenan los operadores relacionados con el puntero desde la
prioridad más alta a la más baja:

Operadores de incremento x++ y decremento x-- postfijos y operadores -> y []

Operadores de incremento ++x y decremento --x prefijos y operadores & y *
Operadores + y - de suma
Operadores de comparación < , > , <= y >=
Operadores de igualdad == y !=
Use paréntesis, () , para cambiar el orden de evaluación impuesto por la prioridad de
los operadores.

Para obtener la lista completa de los operadores de C# ordenados por nivel de

prioridad, vea la sección Prioridad de operadores del artículo Operadores de C#.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario no puede sobrecargar los operadores relacionados con
el puntero & , * , -> y [] .

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Variables fijas y móviles

El operador address-of
Direccionamiento indirecto del puntero
Acceso a miembros de puntero
Acceso de elemento de puntero
Aritmética de puntero
Incremento y decremento de puntero
Comparación de punteros

Vea también
Referencia de C#
Operadores y expresiones de C#
Código no seguro, tipos de puntero y punteros de función
unsafe (palabra clave)
Instrucción fixed
Expresión stackalloc
sizeof (operador)
Operadores de asignación (referencia de
C#)
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

El operador de asignación = asigna el valor de su operando de la derecha a una

variable, una propiedad o un elemento de indexador que proporciona el operando de la
izquierda. El resultado de una expresión de asignación es el valor asignado al operando
izquierdo. El tipo del operando de la derecha debe ser el mismo que el del operando de
la izquierda o debe poder convertirse implícitamente en él.

El operador de asignación = es asociativo a la derecha, es decir, una expresión con el

formato

C#

a = b = c

se evalúa como

C#

a = (b = c)

En el ejemplo siguiente se muestra el uso del operador de asignación con una variable
local, una propiedad y un elemento indexador como su operando izquierdo:

C#

var numbers = new List<double>() { 1.0, 2.0, 3.0 };

Console.WriteLine(numbers.Capacity);

numbers.Capacity = 100;
Console.WriteLine(numbers.Capacity);

// Output:

// 4

// 100

int newFirstElement;

double originalFirstElement = numbers[0];

newFirstElement = 5;

numbers[0] = newFirstElement;

Console.WriteLine(originalFirstElement);

Console.WriteLine(numbers[0]);

// Output:

 // 1

// 5

El operando de la izquierda de una asignación recibe el valor del operando de la

derecha. Cuando los operandos son de tipos de valor, la asignación copia el contenido
del operando de la derecha. Cuando los operandos son de tipos de referencia, la
asignación copia la referencia al objeto.

Esto se denomina asignación de valores: el valor se asigna.

asignación de referencia
La asignación de referencia = ref convierte su operando de la izquierda en un alias en el
operando de la derecha. El operando de la izquierda debe ser un valor ref local, ref
readonly local o un ref campo de ref struct . Los operandos deben ser del mismo tipo.

En el siguiente ejemplo se muestra el uso del operador de asignación ref:

C#

void Display(double[] s) => Console.WriteLine(string.Join(" ", s));

double[] arr = { 0.0, 0.0, 0.0 };

Display(arr);

ref double arrayElement = ref arr[0];

arrayElement = 3.0;

Display(arr);

arrayElement = ref arr[arr.Length - 1];

arrayElement = 5.0;

Display(arr);

// Output:

// 0 0 0

// 3 0 0

// 3 0 5

En el ejemplo anterior, la variable ref local arrayElement se inicializa como un alias para
el primer elemento de la matriz. A continuación, se reasigna para convertirse en un alias
para el último elemento de la matriz. Como es un alias, al actualizar su valor con un
operador = de asignación normal, también se actualiza el elemento de la matriz
correspondiente.

Asignación compuesta
Para un operador binario op , una expresión de asignación compuesta con el formato

C#

x op= y

es equivalente a

C#

x = x op y

salvo que x solo se evalúa una vez.

La asignación compuesta es compatible con operadores aritméticos, lógicos booleanos

y de desplazamiento y lógicos bit a bit.

Asignación de uso combinado de NULL

Puede usar el operador de asignación de uso combinado de NULL ??= para asignar el
valor de su operando de la derecha al operando de la izquierda solo si el operando de la
izquierda se evalúa como null . Para obtener más información, consulte Operadores ?? y
??.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario no puede sobrecargar el operador de asignación. Sin
embargo, un tipo definido por el usuario puede definir una conversión implícita a otro
tipo. De este modo, el valor de un tipo definido por el usuario puede asignarse a una
variable, una propiedad o un elemento de indizador de otro tipo. Para obtener más
información, vea Operadores de conversión definidos por el usuario.

Un tipo definido por el usuario no puede sobrecargar de forma explícita un operador de

asignación compuesta. Pero si un tipo definido por el usuario sobrecarga un operador
binario op , el operador op= , si existe, también se sobrecarga de forma implícita.

especificación del lenguaje C#

Para más información, consulte la sección sobre operadores de asignación de la
Especificación del lenguaje C#.
Para más información sobre el operador de asignación de referencias = ref , vea la nota
de propuesta de características.

Vea también
Referencia de C#
Operadores y expresiones de C#
ref (palabra clave)
Uso de la asignación compuesta (reglas de estilo IDE0054 e IDE0074)
Expresiones lambda y funciones
anónimas
Artículo • 09/03/2023 • Tiempo de lectura: 16 minutos

Use una expresión lambda para crear una función anónima. Use el operador de
declaración lambda => para separar la lista de parámetros de la lamba de su cuerpo.
Una expresión lambda puede tener cualquiera de las dos formas siguientes:

Una lambda de expresión que tiene una expresión como cuerpo:

C#

(input-parameters) => expression

Una lambda de instrucción que tiene un bloque de instrucciones como cuerpo:

C#

(input-parameters) => { <sequence-of-statements> }

Para crear una expresión lambda, especifique los parámetros de entrada (si existen) a la
izquierda del operador lambda y una expresión o bloque de instrucciones en el otro
lado.

Toda expresión lambda se puede convertir en un tipo delegado. El tipo delegado al que
se puede convertir una expresión lambda se define según los tipos de sus parámetros y
el valor devuelto. Si una expresión lambda no devuelve un valor, se puede convertir en
uno de los tipos delegados Action ; de lo contrario, se puede convertir en uno de los
tipos delegados Func . Por ejemplo, una expresión lambda que tiene dos parámetros y
no devuelve ningún valor corresponde a un delegado Action<T1,T2>. Una expresión
lambda que tiene un parámetro y devuelve un valor se puede convertir en un delegado
Func<T,TResult>. En el ejemplo siguiente, la expresión lambda x => x * x , que
especifica un parámetro denominado x y devuelve el valor de x al cuadrado, se asigna
a una variable de un tipo delegado:

C#

Func<int, int> square = x => x * x;

Console.WriteLine(square(5));

// Output:

// 25

Las expresiones lambda también se pueden convertir en los tipos de árbol de expresión,
como se muestra en los ejemplos siguientes:

C#

System.Linq.Expressions.Expression<Func<int, int>> e = x => x * x;

Console.WriteLine(e);

// Output:

// x => (x * x)

Puede usar expresiones lambda en cualquier código que requiera instancias de tipos
delegados o de árboles de expresión, por ejemplo, como un argumento del método
Task.Run(Action) para pasar el código que se debe ejecutar en segundo plano. También
puede usar expresiones lambda al escribir LINQ en C#, como se muestra en el ejemplo
siguiente:

C#

int[] numbers = { 2, 3, 4, 5 };

var squaredNumbers = numbers.Select(x => x * x);

Console.WriteLine(string.Join(" ", squaredNumbers));

// Output:

// 4 9 16 25

Cuando se usa la sintaxis de método para llamar al método Enumerable.Select en la

clase System.Linq.Enumerable, por ejemplo en LINQ to Objects y en LINQ to XML, el
parámetro es un tipo delegado System.Func<T,TResult>. Cuando se llama al método
Queryable.Select en la clase System.Linq.Queryable, por ejemplo en LINQ to SQL, el tipo
de parámetro es un tipo de árbol de expresión Expression<Func<TSource,TResult>>. En
ambos casos, se puede usar la misma expresión lambda para especificar el valor del
parámetro. Esto hace que las dos llamadas Select tengan un aspecto similar aunque, de
hecho, el tipo de objetos creados a partir las lambdas es distinto.

Lambdas de expresión
Una expresión lambda con una expresión en el lado derecho del operador => se
denomina lambda de expresión. Una expresión lambda devuelve el resultado de evaluar
la condición y tiene la siguiente forma:

C#

(input-parameters) => expression

El cuerpo de una expresión lambda puede constar de una llamada al método. Pero si
crea árboles de expresión que se evalúan fuera del contexto de Common Language
Runtime (CLR) de .NET, como en SQL Server, no debe usar llamadas de métodos en
expresiones lambda. Los métodos no tendrán ningún significado fuera del contexto de
Common Language Runtime (CLR) de .NET.

Lambdas de instrucción
Una lambda de instrucción es similar a un lambda de expresión, salvo que las
instrucciones se encierran entre llaves:

C#

(input-parameters) => { <sequence-of-statements> }

El cuerpo de una lambda de instrucción puede estar compuesto de cualquier número de

instrucciones; sin embargo, en la práctica, generalmente no hay más de dos o tres.

C#

Action<string> greet = name =>

string greeting = $"Hello {name}!";

Console.WriteLine(greeting);

};

greet("World");

// Output:

// Hello World!

No se pueden usar expresiones lambdas para crear árboles de expresión.

Parámetros de entrada de una expresión

lambda
Los parámetros de entrada de una expresión lambda se encierran entre paréntesis. Para
especificar cero parámetros de entrada, utilice paréntesis vacíos:

C#

Action line = () => Console.WriteLine();

Si una expresión lambda solo tiene un parámetro de entrada, los paréntesis son
opcionales:

C#

Func<double, double> cube = x => x * x * x;

Dos o más parámetros de entrada se separan mediante comas:

C#

Func<int, int, bool> testForEquality = (x, y) => x == y;

A veces, el compilador no puede deducir los tipos de parámetros de entrada. Puede

especificar los tipos de manera explícita, tal como se muestra en el ejemplo siguiente:

C#

Func<int, string, bool> isTooLong = (int x, string s) => s.Length > x;

Los tipos de parámetro de entrada deben ser todos explícitos o todos implícitos; de lo
contrario, se produce un error del compilador CS0748.

A partir de C# 9.0, puede usar descartes para especificar dos o más parámetros de
entrada de una expresión lambda que no se usan en la expresión:

C#

Func<int, int, int> constant = (_, _) => 42;

Los parámetros de descarte lambda pueden ser útiles cuando se usa una expresión
lambda para proporcionar un controlador de eventos.

７ Nota

Por compatibilidad con versiones anteriores, si solo un parámetro de entrada se

denomina _ , dentro de una expresión lambda, _ se trata como el nombre de ese
parámetro.

Lambdas asincrónicas
Puede crear fácilmente expresiones e instrucciones lambda que incorporen el
procesamiento asincrónico mediante las palabras clave async y await . Por ejemplo, en el
siguiente ejemplo de formularios Windows Forms se incluye un controlador de eventos
que llama y espera un método asincrónico, ExampleMethodAsync .

C#

public partial class Form1 : Form

public Form1()

InitializeComponent();

button1.Click += button1_Click;

private async void button1_Click(object sender, EventArgs e)

await ExampleMethodAsync();

textBox1.Text += "\r\nControl returned to Click event handler.\n";

private async Task ExampleMethodAsync()

// The following line simulates a task-returning asynchronous

process.

await Task.Delay(1000);

Puede agregar el mismo controlador de eventos utilizando una lambda asincrónica. Para
agregar este controlador, agregue un modificador async antes de la lista de parámetros
lambda, como se muestra en el ejemplo siguiente:

C#

public partial class Form1 : Form

public Form1()

InitializeComponent();

button1.Click += async (sender, e) =>

await ExampleMethodAsync();

textBox1.Text += "\r\nControl returned to Click event

handler.\n";

};

private async Task ExampleMethodAsync()

 // The following line simulates a task-returning asynchronous

process.

await Task.Delay(1000);

Para obtener más información sobre cómo crear y usar métodos asincrónicos, vea
Programación asincrónica con async y await.

Expresiones lambda y tuplas

El lenguaje C# proporciona compatibilidad integrada para las tuplas. Puede
proporcionar una tupla como argumento a una expresión lambda, mientras que la
expresión lambda también puede devolver una tupla. En algunos casos, el compilador
de C# usa la inferencia de tipos para determinar los tipos de componentes de la tupla.

Para definir una tupla, incluya entre paréntesis una lista delimitada por comas de los
componentes. En el ejemplo siguiente se usa la tupla con tres componentes para pasar
una secuencia de números a una expresión lambda, que duplica cada valor y devuelve
una tupla con tres componentes que contiene el resultado de las multiplicaciones.

C#

Func<(int, int, int), (int, int, int)> doubleThem = ns => (2 * ns.Item1, 2 *

ns.Item2, 2 * ns.Item3);

var numbers = (2, 3, 4);

var doubledNumbers = doubleThem(numbers);

Console.WriteLine($"The set {numbers} doubled: {doubledNumbers}");

// Output:

// The set (2, 3, 4) doubled: (4, 6, 8)

Normalmente, los campos de una tupla se denominan Item1 , Item2 , etc. aunque puede
definir una tupla con componentes con nombre, como en el ejemplo siguiente.

C#

Func<(int n1, int n2, int n3), (int, int, int)> doubleThem = ns => (2 *
ns.n1, 2 * ns.n2, 2 * ns.n3);

var numbers = (2, 3, 4);

var doubledNumbers = doubleThem(numbers);

Console.WriteLine($"The set {numbers} doubled: {doubledNumbers}");

Para más información sobre las tuplas de C#, consulte el artículo sobre los tipos de
tuplas.
Lambdas con los operadores de consulta
estándar
LINQ to Objects, entre otras implementaciones, tiene un parámetro de entrada cuyo
tipo es uno de la familia Func<TResult> de delegados genéricos. Estos delegados usan
parámetros de tipo para definir el número y el tipo de los parámetros de entrada, así
como el tipo de valor devuelto del delegado. Los delegados Func son útiles para
encapsular expresiones definidas por el usuario que se aplican a cada elemento en un
conjunto de datos de origen. Por ejemplo, considere el tipo delegado Func<T,TResult>:

C#

public delegate TResult Func<in T, out TResult>(T arg)

Se pueden crear instancias del delegado como una instancia Func<int, bool> , donde
int es un parámetro de entrada y bool es el valor devuelto. El valor devuelto siempre

se especifica en el último parámetro de tipo. Por ejemplo, Func<int, string, bool>

define un delegado con dos parámetros de entrada, int y string , y un tipo de valor
devuelto de bool . El delegado Func siguiente, cuando se invoca, devuelve un valor
booleano que indica si el parámetro de entrada es igual a cinco:

C#

Func<int, bool> equalsFive = x => x == 5;

bool result = equalsFive(4);

Console.WriteLine(result); // False

También puede proporcionar una expresión lambda cuando el tipo de argumento es

Expression<TDelegate>, (por ejemplo, en los operadores de consulta estándar que se
definen en el tipo Queryable). Al especificar un argumento Expression<TDelegate>, la
lambda se compila en un árbol de expresión.

En el ejemplo siguiente se usa el operador de consulta estándar Count:

C#

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };
int oddNumbers = numbers.Count(n => n % 2 == 1);

Console.WriteLine($"There are {oddNumbers} odd numbers in {string.Join(" ",

numbers)}");

El compilador puede deducir el tipo del parámetro de entrada o también se puede

especificar explícitamente. Esta expresión lambda particular cuenta aquellos enteros ( n )
que divididos por dos dan como resto 1.

El siguiente ejemplo genera una secuencia que contiene todos los elementos de la
matriz numbers que preceden al 9, ya que ese es el primer número de la secuencia que
no cumple la condición:

C#

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };
var firstNumbersLessThanSix = numbers.TakeWhile(n => n < 6);

Console.WriteLine(string.Join(" ", firstNumbersLessThanSix));

// Output:

// 5 4 1 3

En el siguiente ejemplo se especifican varios parámetros de entrada encerrándolos entre

paréntesis. El método devuelve todos los elementos de la matriz numbers hasta que
encuentra un número cuyo valor es menor que la posición ordinal en la matriz:

C#

int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };
var firstSmallNumbers = numbers.TakeWhile((n, index) => n >= index);

Console.WriteLine(string.Join(" ", firstSmallNumbers));

// Output:

// 5 4

No se usan expresiones lambda directamente en las expresiones de consulta, pero se

pueden usar en las llamadas de método dentro de expresiones de consulta, como se
muestra en el ejemplo siguiente:

C#

var numberSets = new List<int[]>

new[] { 1, 2, 3, 4, 5 },

new[] { 0, 0, 0 },

new[] { 9, 8 },

new[] { 1, 0, 1, 0, 1, 0, 1, 0 }

};

var setsWithManyPositives =

from numberSet in numberSets

where numberSet.Count(n => n > 0) > 3

select numberSet;

foreach (var numberSet in setsWithManyPositives)

Console.WriteLine(string.Join(" ", numberSet));

// Output:

// 1 2 3 4 5

// 1 0 1 0 1 0 1 0

Inferencia de tipos en expresiones lambda

Al escribir lambdas, no tiene por qué especificar un tipo para los parámetros de entrada,
ya que el compilador puede deducir el tipo según el cuerpo de lambda, los tipos de
parámetros y otros factores, tal como se describe en la especificación del lenguaje C#.
Para la mayoría de los operadores de consulta estándar, la primera entrada es el tipo de
los elementos en la secuencia de origen. Si está realizando una consulta sobre
IEnumerable<Customer> , se deducirá que la variable de entrada será un objeto Customer ,

lo cual significa que se podrá tener acceso a sus métodos y propiedades:

C#

customers.Where(c => c.City == "London");

Las reglas generales para la inferencia de tipos de las lambdas son las siguientes:

La lambda debe contener el mismo número de parámetros que el tipo delegado.

Cada parámetro de entrada de la lambda debe poder convertirse implícitamente a
su parámetro de delegado correspondiente.
El valor devuelto de la lambda (si existe) debe poder convertirse implícitamente al
tipo de valor devuelto del delegado.

Tipo natural de una expresión lambda

Una expresión lambda en sí misma no tiene un tipo porque el sistema de tipos común
no tiene ningún concepto intrínseco de "expresión lambda". Sin embargo, a veces es
conveniente hablar informalmente del "tipo" de una expresión lambda. Este "tipo"
informal hace referencia al tipo del delegado o el tipo de Expression en el que se
convierte la expresión lambda.

A partir de C# 10, una expresión lambda puede tener un tipo natural. En lugar de
forzarle a declarar un tipo de delegado, como Func<...> o Action<...> para una
expresión lambda, el compilador puede deducir el tipo de delegado de la expresión
lambda. Por ejemplo, consideremos la siguiente declaración:
 C#

var parse = (string s) => int.Parse(s);

El compilador puede deducir que parse sea un elemento Func<string, int> . El

compilador elige un delegado Func o Action disponible, si existe uno adecuado. De lo
contrario, sintetiza un tipo de delegado. Por ejemplo, el tipo de delegado se sintetiza si
la expresión lambda tiene parámetros ref . Cuando una expresión lambda tiene un tipo
natural, se puede asignar a un tipo menos explícito, como System.Object o
System.Delegate:

C#

object parse = (string s) => int.Parse(s); // Func<string, int>

Delegate parse = (string s) => int.Parse(s); // Func<string, int>

Los grupos de métodos (es decir, los nombres de método sin listas de parámetros) con
exactamente una sobrecarga tienen un tipo natural:

C#

var read = Console.Read; // Just one overload; Func<int> inferred

var write = Console.Write; // ERROR: Multiple overloads, can't choose

Si asigna una expresión lambda a System.Linq.Expressions.LambdaExpression o

System.Linq.Expressions.Expression, y esta tiene un tipo de delegado natural, la
expresión tiene un tipo natural de System.Linq.Expressions.Expression<TDelegate>, con
el tipo de delegado natural utilizado como argumento para el parámetro de tipo:

C#

LambdaExpression parseExpr = (string s) => int.Parse(s); //

Expression<Func<string, int>>

Expression parseExpr = (string s) => int.Parse(s); //

Expression<Func<string, int>>

No todas las expresiones lambda tienen un tipo natural. Considere la declaración

siguiente:

C#

var parse = s => int.Parse(s); // ERROR: Not enough type info in the lambda

El compilador no puede inferir un tipo de parámetro para s . Cuando el compilador no

puede inferir un tipo natural, debe declarar el tipo siguiente:

C#

Func<string, int> parse = s => int.Parse(s);

Tipo de valor devuelto explícito

Normalmente, el tipo de valor devuelto de una expresión lambda es obvio e inferido.
Para algunas expresiones eso no funciona:

C#

var choose = (bool b) => b ? 1 : "two"; // ERROR: Can't infer return type

A partir de C# 10, puede especificar el tipo de valor devuelto de una expresión lambda
antes de los parámetros de entrada. Al especificar un tipo de valor devuelto explícito,
debe encuadrar entre paréntesis los parámetros de entrada:

C#

var choose = object (bool b) => b ? 1 : "two"; // Func<bool, object>

Atributos
A partir de C# 10, puede agregar atributos a una expresión lambda y sus parámetros. En
el ejemplo siguiente se muestra cómo agregar atributos a una expresión lambda:

C#

Func<string?, int?> parse = [ProvidesNullCheck] (s) => (s is not null) ?

int.Parse(s) : null;

También puede agregar atributos a los parámetros de entrada o al valor devuelto, como
se muestra en el ejemplo siguiente:

C#

var concat = ([DisallowNull] string a, [DisallowNull] string b) => a + b;

var inc = [return: NotNullifNotNull(nameof(s))] (int? s) => s.HasValue ? s++

: null;

Como se muestra en los ejemplos anteriores, debe encuadrar entre paréntesis los
parámetros de entrada al agregar atributos a una expresión lambda o a sus parámetros.

） Importante

Las expresiones lambda se invocan mediante el tipo de delegado subyacente. Esto

es diferente de los métodos y las funciones locales. El método Invoke del delegado
no comprueba los atributos de la expresión lambda. Los atributos no tienen ningún
efecto cuando se invoca la expresión lambda. Los atributos de las expresiones
lambda son útiles para el análisis de código y se pueden descubrir mediante la
reflexión. Una consecuencia de esta decisión es que
System.Diagnostics.ConditionalAttribute no se puede aplicar a una expresión
lambda.

Captura de variables externas y el ámbito de las

variables en las expresiones lambda
Las operaciones lambda pueden hacer referencia a variables externas. Estas variables
externas son las variables que están en el ámbito del método que define la expresión
lambda o en el ámbito del tipo que contiene la expresión lambda. Las variables que se
capturan de esta manera se almacenan para su uso en la expresión lambda, cuando de
otro modo quedarían fuera de ámbito y serían eliminadas por la recolección de
elementos no utilizados. Para poder utilizar una variable externa en una expresión
lambda, debe estar previamente asignada. En el ejemplo siguiente se muestran estas
reglas:

C#

public static class VariableScopeWithLambdas

public class VariableCaptureGame

internal Action<int>? updateCapturedLocalVariable;

internal Func<int, bool>? isEqualToCapturedLocalVariable;

public void Run(int input)

int j = 0;

updateCapturedLocalVariable = x =>

j = x;

bool result = j > input;

 Console.WriteLine($"{j} is greater than {input}: {result}");

};

isEqualToCapturedLocalVariable = x => x == j;

Console.WriteLine($"Local variable before lambda invocation:

{j}");

updateCapturedLocalVariable(10);

Console.WriteLine($"Local variable after lambda invocation:

{j}");

public static void Main()

var game = new VariableCaptureGame();

int gameInput = 5;

game.Run(gameInput);

int jTry = 10;

bool result = game.isEqualToCapturedLocalVariable!(jTry);

Console.WriteLine($"Captured local variable is equal to {jTry}:

{result}");

int anotherJ = 3;

game.updateCapturedLocalVariable!(anotherJ);

bool equalToAnother = game.isEqualToCapturedLocalVariable(anotherJ);

Console.WriteLine($"Another lambda observes a new value of captured

variable: {equalToAnother}");

// Output:

// Local variable before lambda invocation: 0

// 10 is greater than 5: True

// Local variable after lambda invocation: 10

// Captured local variable is equal to 10: True

// 3 is greater than 5: False

// Another lambda observes a new value of captured variable: True

Las reglas siguientes se aplican al ámbito de las variables en las expresiones lambda:

Una variable capturada no se recolectará como elemento no utilizado hasta que el

delegado que hace referencia a ella sea apto para la recolección de elementos no
utilizados.
Las variables introducidas en una expresión lambda no son visibles en el método
envolvente.
Una expresión lambda no puede capturar directamente un parámetro in, ref ni out
desde el método envolvente.
 Una instrucción return en una expresión lambda no hace que el método
envolvente devuelva un valor.
Una expresión lambda no puede contener una instrucción goto, break ni continue
si el destino de esa instrucción de salto está fuera del bloque de la misma. También
es un error utilizar una instrucción de salto fuera del bloque de la expresión
lambda si el destino está dentro del bloque.

A partir de C# 9.0, puede aplicar el modificador static a una expresión lambda para
evitar la captura involuntaria de variables locales o el estado de la instancia por parte de
la expresión lambda:

C#

Func<double, double> square = static x => x * x;

Una expresión lambda estática no puede capturar variables locales o el estado de la

instancia desde ámbitos de inclusión, pero puede hacer referencia a miembros estáticos
y definiciones de constantes.

Especificación del lenguaje C#

Para obtener más información, vea la sección Expresiones de función anónima de la
Especificación del lenguaje C#.

Para obtener más información sobre de las características agregadas en C# 9.0 y

versiones posteriores, vea las siguientes notas de propuesta de características:

Parámetros de descarte lambda (C# 9.0)

Funciones anónimas estáticas (C# 9.0)
Mejoras de lambda (C# 10)

Vea también
Uso de la función local en lugar de lambda (regla de estilo IDE0039)
Referencia de C#
Operadores y expresiones de C#
LINQ (Language Integrated Query)
Árboles de expresión
Funciones locales frente a expresiones lambda
Consultas de ejemplo de LINQ
Ejemplo de XQuery
101 ejemplos de LINQ
Coincidencia de patrones: las is
expresiones y switch , y los operadores
and , or y not en patrones
Artículo • 15/02/2023 • Tiempo de lectura: 19 minutos

La expresión se usais, la instrucción switch y la expresión switch para que coincida con
una expresión de entrada con cualquier número de características. C# admite varios
patrones, como declaración, tipo, constante, relacional, propiedad, lista, var y descarte.
Los patrones se pueden combinar mediante palabras clave lógica booleanas and , or y
not .

Las siguientes expresiones e instrucciones de C# admiten la coincidencia de patrones:

Expresión is
switch (Instrucción)
Expresión switch

En esas construcciones, puede hacer coincidir una expresión de entrada con cualquiera
de los siguientes patrones:

Patrón de declaración: para comprobar el tipo en tiempo de ejecución de una

expresión y, si una coincidencia se realiza correctamente, asignar el resultado de
una expresión a una variable declarada.
Patrón de tipo: para comprobar el tipo en tiempo de ejecución de una expresión.
Introducido en C# 9.0.
Patrón de constante: para probar si el resultado de una expresión es igual a una
constante especificada.
Patrones relacionales: para comparar el resultado de una expresión con una
constante especificada. Introducido en C# 9.0.
Patrones lógicos: para probar si una expresión coincide con una combinación
lógica de patrones. Introducido en C# 9.0.
Patrón de propiedad: para probar si las propiedades o los campos de una
expresión coinciden con los patrones anidados.
Patrón posicional: para deconstruir el resultado de una expresión y probar si los
valores resultantes coinciden con los patrones anidados.
Patrón var: para buscar coincidencias con cualquier expresión y asignar su
resultado a una variable declarada.
Patrón de descarte: para buscar coincidencias con cualquier expresión.
 Patrones de lista: para probar si los elementos de la secuencia coinciden con los
patrones anidados correspondientes. Presentado en C# 11.

Los patrones lógicos, de propiedad, posicionales y de lista son patrones recursivos. Es

decir, pueden contener patrones anidados.

Para obtener el ejemplo de cómo usar esos patrones para compilar un algoritmo basado
en datos, vea Tutorial: Uso de la coincidencia de patrones para compilar algoritmos
basados en tipos y basados en datos.

Patrones de declaración y de tipo

Los patrones de declaración y de tipo se usan para comprobar si el tipo en tiempo de
ejecución de una expresión es compatible con un tipo determinado. Con un patrón de
declaración, también puede declarar una nueva variable local. Cuando un patrón de
declaración coincide con una expresión, a esa variable se le asigna el resultado de una
expresión convertida, como se muestra en el ejemplo siguiente:

C#

object greeting = "Hello, World!";

if (greeting is string message)

Console.WriteLine(message.ToLower()); // output: hello, world!

Un patrón de declaración con el tipo T coincide con una expresión cuando el resultado
de una expresión no es NULL y se cumple cualquiera de las condiciones siguientes:

El tipo en tiempo de ejecución del resultado de una expresión es T .

El tipo en tiempo de ejecución del resultado de una expresión deriva del tipo T ,
implementa una interfaz T , o bien otra conversión de referencia implícita existe en
T . En el ejemplo siguiente se muestran dos casos en los que esta condición es
verdadera:

C#

var numbers = new int[] { 10, 20, 30 };

Console.WriteLine(GetSourceLabel(numbers)); // output: 1

var letters = new List<char> { 'a', 'b', 'c', 'd' };

Console.WriteLine(GetSourceLabel(letters)); // output: 2

static int GetSourceLabel<T>(IEnumerable<T> source) => source switch

Array array => 1,

ICollection<T> collection => 2,

_ => 3,

};

En el ejemplo anterior, en la primera llamada al método GetSourceLabel , el primer

patrón coincide con un valor de argumento porque el tipo en tiempo de ejecución
int[] del argumento deriva del tipo Array. En la segunda llamada al método

GetSourceLabel , el tipo en tiempo de ejecución List<T> del argumento no deriva

del tipo Array, pero implementa la interfaz ICollection<T>.

El tipo en tiempo de ejecución del resultado de una expresión es un tipo de valor

que admite valores NULL con el tipo subyacente T .

Existe una conversión boxing o unboxing del tipo en tiempo de ejecución del
resultado de una expresión al tipo T .

En el ejemplo siguiente se muestran las dos últimas condiciones:

C#

int? xNullable = 7;

int y = 23;

object yBoxed = y;

if (xNullable is int a && yBoxed is int b)

Console.WriteLine(a + b); // output: 30

Si solo desea comprobar el tipo de una expresión, puede usar un patrón de descarte _
en lugar del nombre de una variable, como se muestra en el ejemplo siguiente:

C#

public abstract class Vehicle {}

public class Car : Vehicle {}

public class Truck : Vehicle {}

public static class TollCalculator

public static decimal CalculateToll(this Vehicle vehicle) => vehicle

switch

Car _ => 2.00m,

Truck _ => 7.50m,

null => throw new ArgumentNullException(nameof(vehicle)),

_ => throw new ArgumentException("Unknown type of a vehicle",

 nameof(vehicle)),

};

A partir de C# 9.0, para ese propósito se puede usar un patrón de tipo, como se muestra
en el ejemplo siguiente:

C#

public static decimal CalculateToll(this Vehicle vehicle) => vehicle switch

Car => 2.00m,

Truck => 7.50m,

null => throw new ArgumentNullException(nameof(vehicle)),

_ => throw new ArgumentException("Unknown type of a vehicle",

nameof(vehicle)),

};

Al igual que un patrón de declaración, un patrón de tipo coincide con una expresión
cuando el resultado de una expresión no es NULL y su tipo en tiempo de ejecución
cumple cualquiera de las condiciones mencionadas anteriormente.

Para comprobar si no es NULL, puede usar un patrón de constante null negada, como
se muestra en el ejemplo siguiente:

C#

if (input is not null)

// ...

Para obtener más información, vea las secciones Patrón de declaración y Patrón de tipo
de las notas de propuesta de características.

Patrón de constante
Utilice un patrón de constante para probar si el resultado de una expresión es igual a
una constante especificada, como se muestra en el ejemplo siguiente:

C#

public static decimal GetGroupTicketPrice(int visitorCount) => visitorCount

switch

1 => 12.0m,

 2 => 20.0m,

3 => 27.0m,

4 => 32.0m,

0 => 0.0m,

_ => throw new ArgumentException($"Not supported number of visitors:

{visitorCount}", nameof(visitorCount)),

};

En un patrón de constante, se puede usar cualquier expresión constante, como:

un literal numérico entero o de punto flotante

un char
un literal de cadena.
un valor booleano true o false
un valor de enumeración
el nombre de un campo const declarado o local
null

La expresión debe ser un tipo que se puede convertir al tipo constante, con una
excepción: una expresión cuyo tipo es Span<char> o ReadOnlySpan<char> se puede
comparar con cadenas constantes en C# 11 y versiones posteriores.

Use un patrón de constante para comprobar null , como se muestra en el ejemplo

siguiente:

C#

if (input is null)

return;

El compilador garantiza que no se invoca ningún operador de igualdad sobrecargado

por el usuario == cuando se evalúa la expresión x is null .

A partir de C# 9.0, se puede usar un patrón de constante negado null para comprobar
las que no son null, como se muestra en el ejemplo siguiente:

C#

if (input is not null)

// ...

Para obtener más información, vea la sección Patrón de constante de la nota de

propuesta de características.

Patrones relacionales
A partir de C# 9.0, se usa un patrón relacional para comparar el resultado de una
expresión con una constante, como se muestra en el ejemplo siguiente:

C#

Console.WriteLine(Classify(13)); // output: Too high

Console.WriteLine(Classify(double.NaN)); // output: Unknown

Console.WriteLine(Classify(2.4)); // output: Acceptable

static string Classify(double measurement) => measurement switch

< -4.0 => "Too low",

> 10.0 => "Too high",

double.NaN => "Unknown",

_ => "Acceptable",

};

En un patrón relacional, se puede usar cualquiera de los operadores relacionales < , > ,
<= o >= . La parte derecha de un patrón relacional debe ser una expresión constante. La

expresión constante puede ser de tipo entero, de punto flotante, de carácter o de

enumeración.

Para comprobar si el resultado de una expresión está en un intervalo determinado,

busque coincidencias con un patrón conjuntivo and, como se muestra en el ejemplo
siguiente:

C#

Console.WriteLine(GetCalendarSeason(new DateTime(2021, 3, 14))); // output:

spring

Console.WriteLine(GetCalendarSeason(new DateTime(2021, 7, 19))); // output:

summer

Console.WriteLine(GetCalendarSeason(new DateTime(2021, 2, 17))); // output:

winter

static string GetCalendarSeason(DateTime date) => date.Month switch

>= 3 and < 6 => "spring",

>= 6 and < 9 => "summer",

>= 9 and < 12 => "autumn",

12 or (>= 1 and < 3) => "winter",

_ => throw new ArgumentOutOfRangeException(nameof(date), $"Date with

 unexpected month: {date.Month}."),

};

Si el resultado de una expresión es null o no se puede convertir al tipo de una

constante mediante una conversión que acepta valores NULL o unboxing, un patrón
relacional no coincide con una expresión.

Para obtener más información, vea la sección Patrones relacionales de la nota de

propuesta de características.

Patrones lógicos
A partir de C# 9.0, se usan los combinadores de patrones not , and y or para crear los
siguientes patrones lógicos:

Patrón de negación not que coincide con una expresión cuando el patrón negado
no coincide con ella. En el ejemplo siguiente se muestra cómo se puede negar un
patrón constante null para comprobar si una expresión no es null:

C#

if (input is not null)

// ...

Patrón conjuntivo and que coincide con una expresión cuando ambos patrones
coinciden con ella. En el ejemplo siguiente se muestra cómo se pueden combinar
patrones relacionales para comprobar si un valor se encuentra en un intervalo
determinado:

C#

Console.WriteLine(Classify(13)); // output: High

Console.WriteLine(Classify(-100)); // output: Too low

Console.WriteLine(Classify(5.7)); // output: Acceptable

static string Classify(double measurement) => measurement switch

< -40.0 => "Too low",

>= -40.0 and < 0 => "Low",

>= 0 and < 10.0 => "Acceptable",

>= 10.0 and < 20.0 => "High",

>= 20.0 => "Too high",

double.NaN => "Unknown",

};

 Patrón disyuntivo or que coincide con una expresión cuando uno de los patrones
coincide con ella, como se muestra en el ejemplo siguiente:

C#

Console.WriteLine(GetCalendarSeason(new DateTime(2021, 1, 19))); //

output: winter

Console.WriteLine(GetCalendarSeason(new DateTime(2021, 10, 9))); //

output: autumn

Console.WriteLine(GetCalendarSeason(new DateTime(2021, 5, 11))); //

output: spring

static string GetCalendarSeason(DateTime date) => date.Month switch

3 or 4 or 5 => "spring",

6 or 7 or 8 => "summer",

9 or 10 or 11 => "autumn",

12 or 1 or 2 => "winter",

_ => throw new ArgumentOutOfRangeException(nameof(date), $"Date

with unexpected month: {date.Month}."),

};

Como se muestra en el ejemplo anterior, se puede usar repetidamente los

combinadores de patrones en un patrón.

Precedencia y orden de comprobación

En la lista siguiente se ordenan los combinadores de patrones desde la prioridad más
alta hasta la más baja:

not
and

or

Para especificar explícitamente la prioridad, use paréntesis, como se muestra en el

ejemplo siguiente:

C#

static bool IsLetter(char c) => c is (>= 'a' and <= 'z') or (>= 'A' and <=
'Z');

７ Nota
 El orden en el que se comprueban los patrones es indefinido. En tiempo de
ejecución, se pueden comprobar primero los patrones anidados del lado derecho
de los patrones or y and .

Para obtener más información, vea la sección Combinadores de patrones de la nota de

propuesta de características.

Patrón de propiedad
Utilice un patrón de propiedad para hacer coincidir las propiedades o los campos de una
expresión con los patrones anidados, como se muestra en el ejemplo siguiente:

C#

static bool IsConferenceDay(DateTime date) => date is { Year: 2020, Month:

5, Day: 19 or 20 or 21 };

Un patrón de propiedad coincide con una expresión cuando el resultado de una

expresión no es NULL y cada patrón anidado coincide con la propiedad o el campo
correspondiente del resultado de la expresión.

También puede agregar una comprobación de tipo en tiempo de ejecución y una

declaración de variable a un patrón de propiedad, como se muestra en el ejemplo
siguiente:

C#

Console.WriteLine(TakeFive("Hello, world!")); // output: Hello

Console.WriteLine(TakeFive("Hi!")); // output: Hi!

Console.WriteLine(TakeFive(new[] { '1', '2', '3', '4', '5', '6', '7' }));

// output: 12345

Console.WriteLine(TakeFive(new[] { 'a', 'b', 'c' })); // output: abc

static string TakeFive(object input) => input switch

string { Length: >= 5 } s => s.Substring(0, 5),

string s => s,

ICollection<char> { Count: >= 5 } symbols => new

string(symbols.Take(5).ToArray()),

ICollection<char> symbols => new string(symbols.ToArray()),

null => throw new ArgumentNullException(nameof(input)),

_ => throw new ArgumentException("Not supported input type."),

};

Un patrón de propiedad es un patrón recursivo. Es decir, se puede usar cualquier patrón

como patrón anidado. Use un patrón de propiedad para hacer coincidir partes de los
datos con patrones anidados, como se muestra en el ejemplo siguiente:

C#

public record Point(int X, int Y);

public record Segment(Point Start, Point End);

static bool IsAnyEndOnXAxis(Segment segment) =>

segment is { Start: { Y: 0 } } or { End: { Y: 0 } };

En el ejemplo anterior se usan dos características disponibles en C# 9.0 y versiones

posteriores: or combinador de patrones y tipos de registro.

A partir de C# 10, puede hacer referencia a propiedades o campos anidados en un

patrón de propiedad. Esta funcionalidad se conoce como patrón de propiedad
extendida. Por ejemplo, puede refactorizar el método del ejemplo anterior en el código
equivalente siguiente:

C#

static bool IsAnyEndOnXAxis(Segment segment) =>

segment is { Start.Y: 0 } or { End.Y: 0 };

Para obtener más información, consulte la sección Patrón de propiedad de la nota de

propuesta de características y la nota de propuesta de características Patrones de
propiedades extendidos.

 Sugerencia

Puede usar la regla de estilo Simplificar patrón de propiedades (IDE0170) para

mejorar la legibilidad del código mediante la sugerencia de lugares para usar
patrones de propiedades extendidos.

Patrón posicional
Utilice un patrón posicional para deconstruir el resultado de una expresión y hacer
coincidir los valores resultantes con los patrones anidados correspondientes, como se
muestra en el ejemplo siguiente:

C#
 public readonly struct Point

public int X { get; }

public int Y { get; }

public Point(int x, int y) => (X, Y) = (x, y);

public void Deconstruct(out int x, out int y) => (x, y) = (X, Y);

static string Classify(Point point) => point switch

(0, 0) => "Origin",

(1, 0) => "positive X basis end",

(0, 1) => "positive Y basis end",

_ => "Just a point",

};

En el ejemplo anterior, el tipo de una expresión contiene el método Deconstruct, que se

usa para deconstruir el resultado de una expresión. También puede hacer coincidir
expresiones de tipos de tupla con patrones posicionales. De este modo, puede hacer
coincidir varias entradas con distintos patrones, como se muestra en el ejemplo
siguiente:

C#

static decimal GetGroupTicketPriceDiscount(int groupSize, DateTime

visitDate)

=> (groupSize, visitDate.DayOfWeek) switch

(<= 0, _) => throw new ArgumentException("Group size must be

positive."),

(_, DayOfWeek.Saturday or DayOfWeek.Sunday) => 0.0m,

(>= 5 and < 10, DayOfWeek.Monday) => 20.0m,

(>= 10, DayOfWeek.Monday) => 30.0m,

(>= 5 and < 10, _) => 12.0m,

(>= 10, _) => 15.0m,

_ => 0.0m,

};

En el ejemplo anterior se usan patrones relacionales y lógicos, que están disponibles en

C# 9.0 y versiones posteriores.

Puede usar los nombres de elementos de tupla y parámetros Deconstruct en un patrón

posicional, como se muestra en el ejemplo siguiente:

C#
 var numbers = new List<int> { 1, 2, 3 };

if (SumAndCount(numbers) is (Sum: var sum, Count: > 0))

Console.WriteLine($"Sum of [{string.Join(" ", numbers)}] is {sum}"); //

output: Sum of [1 2 3] is 6

static (double Sum, int Count) SumAndCount(IEnumerable<int> numbers)

int sum = 0;

int count = 0;

foreach (int number in numbers)

sum += number;

count++;

return (sum, count);

También puede extender un patrón posicional de cualquiera de las siguientes maneras:

Agregue una comprobación de tipo en tiempo de ejecución y una declaración de

variable, como se muestra en el ejemplo siguiente:

C#

public record Point2D(int X, int Y);

public record Point3D(int X, int Y, int Z);

static string PrintIfAllCoordinatesArePositive(object point) => point

switch

Point2D (> 0, > 0) p => p.ToString(),

Point3D (> 0, > 0, > 0) p => p.ToString(),

_ => string.Empty,

};

En el ejemplo anterior se usan registros posicionales que proporcionan

implícitamente el método Deconstruct .

Use un patrón de propiedad dentro de un patrón posicional, como se muestra en

el ejemplo siguiente:

C#

public record WeightedPoint(int X, int Y)

public double Weight { get; set; }

 static bool IsInDomain(WeightedPoint point) => point is (>= 0, >= 0) {

Weight: >= 0.0 };

Combine dos usos anteriores, como se muestra en el ejemplo siguiente:

C#

if (input is WeightedPoint (> 0, > 0) { Weight: > 0.0 } p)

// ..

Un patrón posicional es un patrón recursivo. Es decir, se puede usar cualquier patrón

como patrón anidado.

Para obtener más información, vea la sección Patrón posicional de la nota de propuesta
de características.

Patrón var
Utilice un patrón var para buscar coincidencias con cualquier expresión, incluida null , y
asignar el resultado a una nueva variable local, como se muestra en el ejemplo
siguiente:

C#

static bool IsAcceptable(int id, int absLimit) =>

SimulateDataFetch(id) is var results

&& results.Min() >= -absLimit

&& results.Max() <= absLimit;

static int[] SimulateDataFetch(int id)

var rand = new Random();

return Enumerable

.Range(start: 0, count: 5)

.Select(s => rand.Next(minValue: -10, maxValue: 11))

.ToArray();

Un patrón var es útil cuando se necesita una variable temporal dentro de una expresión
booleana para contener el resultado de los cálculos intermedios. También puede usar un
var patrón cuando necesite realizar más comprobaciones en when caso de que se

proteja una expresión o instrucción switch , como se muestra en el ejemplo siguiente:

 C#

public record Point(int X, int Y);

static Point Transform(Point point) => point switch

var (x, y) when x < y => new Point(-x, y),

var (x, y) when x > y => new Point(x, -y),

var (x, y) => new Point(x, y),

};

static void TestTransform()

Console.WriteLine(Transform(new Point(1, 2))); // output: Point { X =

-1, Y = 2 }

Console.WriteLine(Transform(new Point(5, 2))); // output: Point { X =

5, Y = -2 }

En el ejemplo anterior, el patrón var (x, y) es equivalente a un patrón posicional (var

x, var y) .

En un patrón var , el tipo de una variable declarada es el tipo en tiempo de compilación

de la expresión que coincide con el patrón.

Para obtener más información, vea la sección Patrón Var de la nota de propuesta de
características.

Patrón de descarte
Utilice un patrón de descarte _ para buscar coincidencias con cualquier expresión,
incluida null , como se muestra en el ejemplo siguiente:

C#

Console.WriteLine(GetDiscountInPercent(DayOfWeek.Friday)); // output: 5.0

Console.WriteLine(GetDiscountInPercent(null)); // output: 0.0

Console.WriteLine(GetDiscountInPercent((DayOfWeek)10)); // output: 0.0

static decimal GetDiscountInPercent(DayOfWeek? dayOfWeek) => dayOfWeek

switch

DayOfWeek.Monday => 0.5m,

DayOfWeek.Tuesday => 12.5m,

DayOfWeek.Wednesday => 7.5m,

DayOfWeek.Thursday => 12.5m,

DayOfWeek.Friday => 5.0m,

DayOfWeek.Saturday => 2.5m,

DayOfWeek.Sunday => 2.0m,

 _ => 0.0m,

};

En el ejemplo anterior, se usa un patrón de descarte para controlar null y cualquier

valor entero que no tenga el miembro correspondiente de la enumeración DayOfWeek.
Esto garantiza que una expresión switch en el ejemplo controle todos los valores de
entrada posibles. Si no se usa un patrón de descarte en una expresión switch y ninguno
de los patrones de la expresión coincide con una entrada, el tiempo de ejecución
produce una excepción. El compilador genera una advertencia si una expresión switch
no controla todos los valores de entrada posibles.

Un patrón de descarte no puede ser un patrón en una expresión is ni una instrucción

switch . En esos casos, para buscar coincidencias con cualquier expresión, use un patrón
var con un patrón de descarte: var _ .

Para obtener más información, vea la sección Patrón de descarte de la nota de

propuesta de características.

Patrón entre paréntesis

A partir de C# 9.0, se puede incluir un paréntesis alrededor de cualquier patrón.
Normalmente, esto se hace para resaltar o cambiar la prioridad en patrones lógicos,
como se muestra en el ejemplo siguiente:

C#

if (input is not (float or double))

return;

Patrones de lista
A partir de C# 11, puede buscar coincidencias de una matriz o una lista con una
secuencia de patrones, como se muestra en el ejemplo siguiente:

C#

int[] numbers = { 1, 2, 3 };

Console.WriteLine(numbers is [1, 2, 3]); // True

Console.WriteLine(numbers is [1, 2, 4]); // False

 Console.WriteLine(numbers is [1, 2, 3, 4]); // False

Console.WriteLine(numbers is [0 or 1, <= 2, >= 3]); // True

Como se muestra en el ejemplo anterior, un patrón de lista coincide cuando cada patrón
anidado coincide con el elemento correspondiente de una secuencia de entrada. Puede
usar cualquier patrón dentro de un patrón de lista. Para buscar coincidencias con
cualquier elemento, use el patrón de descarte o, si también desea capturar el elemento,
el patrón var, como se muestra en el ejemplo siguiente:

C#

List<int> numbers = new() { 1, 2, 3 };

if (numbers is [var first, _, _])

Console.WriteLine($"The first element of a three-item list is

{first}.");

// Output:

// The first element of a three-item list is 1.

Los ejemplos anteriores buscan coincidencias de una secuencia de entrada completa

con un patrón de lista. Para hacer coincidir los elementos solo al principio o al final de
una secuencia de entrada, use el patrón .. de segmento, como se muestra en el
ejemplo siguiente:

C#

Console.WriteLine(new[] { 1, 2, 3, 4, 5 } is [> 0, > 0, ..]); // True

Console.WriteLine(new[] { 1, 1 } is [_, _, ..]); // True

Console.WriteLine(new[] { 0, 1, 2, 3, 4 } is [> 0, > 0, ..]); // False

Console.WriteLine(new[] { 1 } is [1, 2, ..]); // False

Console.WriteLine(new[] { 1, 2, 3, 4 } is [.., > 0, > 0]); // True

Console.WriteLine(new[] { 2, 4 } is [.., > 0, 2, 4]); // False

Console.WriteLine(new[] { 2, 4 } is [.., 2, 4]); // True

Console.WriteLine(new[] { 1, 2, 3, 4 } is [>= 0, .., 2 or 4]); // True

Console.WriteLine(new[] { 1, 0, 0, 1 } is [1, 0, .., 0, 1]); // True

Console.WriteLine(new[] { 1, 0, 1 } is [1, 0, .., 0, 1]); // False

Un patrón de segmento busca coincidencias con cero o más elementos. Puede usar
como máximo un patrón de segmento en un patrón de lista. El patrón de segmento solo
puede aparecer en un patrón de lista.

También puede anidar un subpatrón dentro de un patrón de segmento, como se

muestra en el ejemplo siguiente:
 C#

void MatchMessage(string message)

var result = message is ['a' or 'A', .. var s, 'a' or 'A']

? $"Message {message} matches; inner part is {s}."

: $"Message {message} doesn't match.";

Console.WriteLine(result);

MatchMessage("aBBA"); // output: Message aBBA matches; inner part is BB.

MatchMessage("apron"); // output: Message apron doesn't match.

void Validate(int[] numbers)

var result = numbers is [< 0, .. { Length: 2 or 4 }, > 0] ? "valid" :

"not valid";

Console.WriteLine(result);

Validate(new[] { -1, 0, 1 }); // output: not valid

Validate(new[] { -1, 0, 0, 1 }); // output: valid

Para más información, consulte la nota de propuesta de características para patrones de

lista.

Especificación del lenguaje C#

Para obtener más información, consulte las siguientes notas de propuestas de
características:

Coincidencia de patrones para C# 7

C# 8: Coincidencia de patrones recursivos
Cambios en la coincidencia de patrones para C# 9.0
C# 10: Patrones de propiedades extendidos
C# 11: Patrones de lista
C# 11: Coincidencia de patrones Span<char> en una cadena constante

Vea también
Referencia de C#
Operadores y expresiones de C#
Información general sobre la coincidencia de patrones
Tutorial: Uso de la coincidencia de patrones para compilar algoritmos basados en
tipos y basados en datos
Operadores de suma: + y +=
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

Los operadores + y += son compatibles con los tipos numéricos enteros y de punto
flotante, el tipo string y los tipos delegados.

Para obtener información acerca del operador aritmético + , consulte las secciones
correspondientes a los operadores unarios más y menos y al operador de suma + del
artículo Operadores aritméticos.

Concatenación de cadenas
Cuando uno o ambos operandos son de tipo string, el operador + concatena las
representaciones de cadena de sus operandos (la representación de cadena de null es
una cadena vacía):

C#

Console.WriteLine("Forgot" + "white space");

Console.WriteLine("Probably the oldest constant: " + Math.PI);

Console.WriteLine(null + "Nothing to add.");

// Output:

// Forgotwhite space

// Probably the oldest constant: 3.14159265358979

// Nothing to add.

La interpolación de cadenas proporciona una manera más práctica de dar formato a las
cadenas:

C#

Console.WriteLine($"Probably the oldest constant: {Math.PI:F2}");

// Output:

// Probably the oldest constant: 3.14

A partir de C# 10, se puede utilizar la interpolación de cadenas para inicializar una

cadena constante cuando todas las expresiones utilizadas para los marcadores de
posición son también cadenas constantes.

A partir de C# 11, el operador + realiza la concatenación de cadenas para cadenas

literales UTF-8. Este operador concatena dos objetos ReadOnlySpan<byte> .
Combinación de delegados
Para los operandos del mismo tipo de delegado, el operador + devuelve una nueva
instancia de delegado que, cuando se invoca, invoca el operando de la izquierda y luego
invoca el operando de la derecha. Si alguno de los operandos es null , el operador +
devuelve el valor del otro operando (que también podría ser null ). El ejemplo siguiente
muestra cómo los delegados se pueden combinar con el operador + :

C#

Action a = () => Console.Write("a");

Action b = () => Console.Write("b");

Action ab = a + b;

ab(); // output: ab

Para llevar a cabo la eliminación de delegados, utilice el operador -.

Para más información sobre los tipos de delegado, vea Delegados.

Operador de asignación y suma +=

Una expresión que usa el operador += , como

C#

x += y

es equivalente a

C#

x = x + y

salvo que x solo se evalúa una vez.

En el siguiente ejemplo se muestra el uso del operador += :

C#

int i = 5;

i += 9;

Console.WriteLine(i);

// Output: 14

 string story = "Start. ";

story += "End.";

Console.WriteLine(story);

// Output: Start. End.

Action printer = () => Console.Write("a");

printer(); // output: a

Console.WriteLine();

printer += () => Console.Write("b");

printer(); // output: ab

También usa el operador += para especificar un método de controlador de eventos

cuando se suscribe a un evento. Para obtener más información, vea Procedimientos para
suscribir y cancelar la suscripción a eventos.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar el operador + . Cuando se sobrecarga
un operador + binario, el operador += también se sobrecarga de modo implícito. Un
tipo definido por el usuario no puede sobrecargar de forma explícita el operador += .

Especificación del lenguaje C#

Para más información, consulte las secciones Operador unario más y Operador de suma
de la especificación del lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
Concatenación de varias cadenas
Eventos
Operadores aritméticos
Operadores - y -=
- y -= operadores - resta (menos)
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

Los operadores - y -= son compatibles con los tipos numéricos enteros y de punto
flotante, y los tipos delegados.

Para obtener información sobre el operador aritmético - , consulte las secciones

correspondientes a los operadores unarios más y menos y al operador de resta (-) del
artículo Operadores aritméticos.

Eliminación de delegados
Para los operandos del mismo tipo delegado, el operador - devuelve una instancia de
delegado que se calcula de la siguiente manera:

Si ambos operandos no son nulos y la lista de invocación del operando derecho es

una sublista apropiada contigua de la lista de invocación del operando izquierdo,
el resultado de la operación es una nueva lista de invocación que se obtiene
mediante la eliminación de las entradas del operando derecho de la lista de
invocación del operando izquierdo. Si la lista del operando derecho coincide con
varias sublistas contiguas en la lista del operando izquierdo, se quita solo la
sublista coincidente más a la derecha. Si la eliminación da como resultado una lista
vacía, el resultado es null .

C#

Action a = () => Console.Write("a");

Action b = () => Console.Write("b");

var abbaab = a + b + b + a + a + b;

abbaab(); // output: abbaab

Console.WriteLine();

var ab = a + b;

var abba = abbaab - ab;

abba(); // output: abba

Console.WriteLine();

var nihil = abbaab - abbaab;

Console.WriteLine(nihil is null); // output: True

Si la lista de invocación del operando derecho no es una sublista apropiada

contigua de la lista de invocación del operando izquierdo, el resultado de la
operación es el operando izquierdo. Por ejemplo, la eliminación de un delegado
que no forma parte del delegado de multidifusión no surte ningún efecto y da
como resultado que el delegado de multidifusión no cambie.

C#

Action a = () => Console.Write("a");

Action b = () => Console.Write("b");

var abbaab = a + b + b + a + a + b;

var aba = a + b + a;

var first = abbaab - aba;

first(); // output: abbaab

Console.WriteLine();

Console.WriteLine(object.ReferenceEquals(abbaab, first)); // output:

True

Action a2 = () => Console.Write("a");

var changed = aba - a;

changed(); // output: ab

Console.WriteLine();

var unchanged = aba - a2;

unchanged(); // output: aba

Console.WriteLine();

Console.WriteLine(object.ReferenceEquals(aba, unchanged)); // output:

True

El ejemplo anterior también demuestra que, durante la eliminación de delegados,

se comparan las instancias de delegados. Por ejemplo, los delegados que se
producen de la evaluación de expresiones lambda idénticas no son iguales. Para
obtener más información acerca de la igualdad de delegados, consulte la sección
Operadores de igualdad de delegado de la especificación del lenguaje C#.

Si el operando izquierdo es null , el resultado de la operación es null . Si el

operando derecho es null , el resultado de la operación es el operando izquierdo.

C#

Action a = () => Console.Write("a");

var nothing = null - a;

Console.WriteLine(nothing is null); // output: True

var first = a - null;

a(); // output: a

Console.WriteLine();

Console.WriteLine(object.ReferenceEquals(first, a)); // output: True

Para combinar delegados, utilice el operador +.

Para más información sobre los tipos de delegado, vea Delegados.

Operador de resta y asignación (-=)

Una expresión que usa el operador -= , como

C#

x -= y

es equivalente a

C#

x = x - y

salvo que x solo se evalúa una vez.

En el siguiente ejemplo se muestra el uso del operador -= :

C#

int i = 5;

i -= 9;

Console.WriteLine(i);

// Output: -4

Action a = () => Console.Write("a");

Action b = () => Console.Write("b");

var printer = a + b + a;

printer(); // output: aba

Console.WriteLine();

printer -= a;

printer(); // output: ab

También se usa el operador -= con el fin de especificar un método de controlador de

eventos para eliminar cuando se finaliza la suscripción a un evento. Para obtener más
información, vea Procedimiento para suscribir y cancelar la suscripción a eventos.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario puede sobrecargar el operador - . Cuando se sobrecarga
un operador - binario, el operador -= también se sobrecarga de modo implícito. Un
tipo definido por el usuario no puede sobrecargar de forma explícita el operador -= .

Especificación del lenguaje C#

Para más información, consulte las secciones correspondientes al operador unario
menos y al operador de resta de Especificación del lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
Eventos
Operadores aritméticos
Operadores + y +=
Operador ?: operador: operador
condicional ternario
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

El operador condicional ?: , también conocido como operador condicional ternario,

evalúa una expresión booleana y devuelve el resultado de una de las dos expresiones,
en función de que la expresión booleana se evalúe como true o false , tal y como se
muestra en el siguiente ejemplo:

C#

string GetWeatherDisplay(double tempInCelsius) => tempInCelsius < 20.0 ?

"Cold." : "Perfect!";

Console.WriteLine(GetWeatherDisplay(15)); // output: Cold.

Console.WriteLine(GetWeatherDisplay(27)); // output: Perfect!

Como se muestra en el ejemplo anterior, la sintaxis del operador condicional es la

siguiente:

C#

condition ? consequent : alternative

La expresión condition debe evaluarse como true o false . Si condition se evalúa

como true , se evalúa la expresión consequent y su resultado se convierte en el
resultado de la operación. Si condition se evalúa como false , se evalúa la expresión
alternative y su resultado se convierte en el resultado de la operación. Solo se evalúan

consequent o alternative .

A partir de C# 9.0, las expresiones condicionales tienen tipo de destino. Es decir, si se

conoce el tipo de destino de una expresión condicional, los tipos de consequent y
alternative se deben poder convertir implícitamente al tipo de destino, como se

muestra en el ejemplo siguiente:

C#

var rand = new Random();

var condition = rand.NextDouble() > 0.5;

int? x = condition ? 12 : null;

 IEnumerable<int> xs = x is null ? new List<int>() { 0, 1 } : new int[] { 2,

3 };

Si se desconoce el tipo de destino de una expresión condicional (por ejemplo, al usar la

palabra clave var) o el tipo de consequent , y alternative debe ser el mismo, o bien,
debe haber una conversión implícita de un tipo a otro:

C#

var rand = new Random();

var condition = rand.NextDouble() > 0.5;

var x = condition ? 12 : (int?)null;

El operador condicional es asociativo a la derecha, es decir, una expresión de la forma

C#

a ? b : c ? d : e

se evalúa como

C#

a ? b : (c ? d : e)

 Sugerencia

Puede utilizar el siguiente recurso mnemotécnico para recordar cómo se evalúa el

operador condicional:

text

is this condition true ? yes : no

Expresión condicional ref

Las variables locales de tipo ref local o ref readonly local se pueden asignar
condicionalmente con una expresión condicional ref. También puede usar una expresión
condicional ref como un valor devuelto de referencia o como un método de argumento
de ref.
La sintaxis de una expresión condicional ref es la siguiente:

C#

condition ? ref consequent : ref alternative

Como sucede con el operador condicional original, una expresión condicional ref evalúa
solo una de las dos expresiones, ya sea consequent o alternative .

En una expresión condicional ref, los tipos de consequent y alternative deben coincidir.
Las expresiones condicionales ref no tienen tipo de destino.

En el ejemplo siguiente se muestra el uso de una expresión condicional ref:

C#

var smallArray = new int[] { 1, 2, 3, 4, 5 };

var largeArray = new int[] { 10, 20, 30, 40, 50 };

int index = 7;

ref int refValue = ref ((index < 5) ? ref smallArray[index] : ref

largeArray[index - 5]);
refValue = 0;

index = 2;

((index < 5) ? ref smallArray[index] : ref largeArray[index - 5]) = 100;

Console.WriteLine(string.Join(" ", smallArray));

Console.WriteLine(string.Join(" ", largeArray));

// Output:

// 1 2 100 4 5

// 10 20 0 40 50

Operador condicional y una instrucción if

Es posible que el uso del operador condicional en lugar de una instrucción if genere
código más conciso en aquellos casos en los que tenga que calcular un valor
condicionalmente. El ejemplo siguiente muestra dos maneras de clasificar un entero
como negativo o no negativo:

C#

int input = new Random().Next(-5, 5);

string classify;

if (input >= 0)

 classify = "nonnegative";

else

classify = "negative";

classify = (input >= 0) ? "nonnegative" : "negative";

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario no puede sobrecargar el operador condicional.

Especificación del lenguaje C#

Para más información, vea la sección sobre operadores condicionales de la
Especificación del lenguaje C#.

Las especificaciones de las características más recientes son:

Expresiones condicionales ref (C# 7.2)

Expresión condicional con tipo de destino (C# 9.0)

Vea también
Simplificación de la expresión condicional (regla de estilo IDE0075)
Referencia de C#
Operadores y expresiones de C#
if (Instrucción)
?. Operadores and ?[]
?? Operadores and ??=
ref (palabra clave)
! (permite valores NULL) (referencia de
C#)
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

El operador ! de postfijo unario es el operador que permite los valores NULL o la

supresión de valores NULL. En un contexto de anotación que acepta valores NULL
habilitado, se usa el operador null-forgiving para suprimir todas las advertencias que
aceptan valores NULL para la expresión anterior. El operador ! de prefijo unario es el
operador lógico de negación. El operador que permite un valor NULL no tiene ningún
efecto en tiempo de ejecución. Solo afecta al análisis de flujo estático del compilador al
cambiar el estado NULL de la expresión. En tiempo de ejecución, la expresión x! se
evalúa en el resultado de la expresión subyacente x .

Para obtener más información sobre la característica de tipos de referencia que admiten
un valor NULL, consulte Tipos de referencia que admiten un valor NULL.

Ejemplos
Uno de los casos de uso del operador que permite un valor NULL es probar la lógica de
validación de argumentos. Por ejemplo, considere la siguiente clase:

C#

#nullable enable

public class Person

public Person(string name) => Name = name ?? throw new

ArgumentNullException(nameof(name));

public string Name { get; }

Con el marco de pruebas MSTest puede crear la prueba siguiente para la lógica de
validación en el constructor:

C#

[TestMethod, ExpectedException(typeof(ArgumentNullException))]

public void NullNameShouldThrowTest()

var person = new Person(null!);

Sin el operador que permite un valor NULL, el compilador genera la advertencia

siguiente para el código anterior: Warning CS8625: Cannot convert null literal to non-
nullable reference type . Al usar el operador que permite un valor NULL, se notifica al

compilador que lo esperado es que se pase null y no se debe advertir al respecto.

También puede usar el operador que permite valores NULL cuando sepa a ciencia cierta
que una expresión no puede ser null , pero el compilador no consigue reconocerlo. En
el ejemplo siguiente, si el método IsValid devuelve true , su argumento no es null y
puede desreferenciarlo de forma segura:

C#

public static void Main()

Person? p = Find("John");

if (IsValid(p))

Console.WriteLine($"Found {p!.Name}");

public static bool IsValid(Person? person)

=> person is not null && person.Name is not null;

Sin el operador que permite un valor NULL, el compilador genera la advertencia

siguiente para el código p.Name : Warning CS8602: Dereference of a possibly null
reference .

Si puede modificar el método IsValid , puede usar el atributo NotNullWhen para

notificar al compilador que un argumento del método IsValid no puede ser null
cuando el método devuelve true :

C#

public static void Main()

Person? p = Find("John");

if (IsValid(p))

Console.WriteLine($"Found {p.Name}");

public static bool IsValid([NotNullWhen(true)] Person? person)

=> person is not null && person.Name is not null;

En el ejemplo anterior, no es necesario usar el operador que permite un valor NULL

porque el compilador tiene suficiente información para averiguar que p no puede ser
null en la instrucción if . Para más información sobre los atributos que permiten

proporcionar información adicional sobre el estado NULL de una variable, vea

Actualización de las API con atributos para definir las expectativas NULL.

Especificación del lenguaje C#

Para obtener más información, consulte la sección The null-forgiving operator (El
operador que admite valores NULL) del borrador de la especificación de tipos de
referencia que aceptan valores NULL.

Vea también
Eliminación del operador de supresión innecesario (regla de estilo IDE0080)
Referencia de C#
Operadores y expresiones de C#
Tutorial: Diseño con tipos de referencia que admiten un valor NULL
?? Operadores ?? y ??=: los operadores
de fusión de NULL
Artículo • 18/02/2023 • Tiempo de lectura: 3 minutos

El operador de uso combinado de NULL ?? devuelve el valor del operando izquierdo si

no es null ; en caso contrario, evalúa el operando derecho y devuelve su resultado. El
operador ?? no evalúa su operando derecho si el operando izquierdo se evalúa como
no NULL. El operador de asignación de fusión de NULL ??= asigna el valor del operando
de la derecha a su operando de la izquierda solo si este último se evalúa como null . El
operador ??= no evalúa su operando derecho si el operando izquierdo se evalúa como
no NULL.

C#

List<int> numbers = null;

int? a = null;

Console.WriteLine((numbers is null)); // expected: true

// if numbers is null, initialize it. Then, add 5 to numbers

(numbers ??= new List<int>()).Add(5);

Console.WriteLine(string.Join(" ", numbers)); // output: 5

Console.WriteLine((numbers is null)); // expected: false

Console.WriteLine((a is null)); // expected: true

Console.WriteLine((a ?? 3)); // expected: 3 since a is still null

// if a is null then assign 0 to a and add a to the list

numbers.Add(a ??= 0);

Console.WriteLine((a is null)); // expected: false

Console.WriteLine(string.Join(" ", numbers)); // output: 5 0

Console.WriteLine(a); // output: 0

El operando izquierdo del operador ??= debe ser una variable, una propiedad o un
elemento de indizador.

El tipo del operando izquierdo de los operadores ?? y ??= no puede ser un tipo de
valor que no acepta valores NULL. En concreto, puede usar los operadores de fusión de
NULL con parámetros de tipo sin restricciones:

C#

private static void Display<T>(T a, T backup)

Console.WriteLine(a ?? backup);

Los operadores de uso combinado de NULL son asociativos a la derecha. Es decir, las
expresiones del formulario

C#

a ?? b ?? c

d ??= e ??= f

se evalúan como

C#

a ?? (b ?? c)

d ??= (e ??= f)

Ejemplos
Los operadores ?? y ??= puede resultar útiles en los siguientes escenarios:

En expresiones con los Operadores condicionales null ?. y ?[], puede usar el

operador ?? para proporcionar una expresión alternativa para evaluar en caso de
que el resultado de la expresión con la operación condicional NULL sea null :

C#

double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)

return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;

var sum = SumNumbers(null, 0);

Console.WriteLine(sum); // output: NaN

Cuando trabaja con tipos de valor que aceptan valores NULL y necesita
proporcionar un valor de un tipo de valor subyacente, use el operador ?? para
especificar el valor para proporcionar en caso de que un valor de tipo que acepta
valores NULL sea null :

C#

int? a = null;

int b = a ?? -1;

Console.WriteLine(b); // output: -1

 Use el método Nullable<T>.GetValueOrDefault() si el valor que se va usar cuando

un valor de tipo que acepta valores NULL es null debe ser el valor
predeterminado del tipo de valor subyacente.

Puede usar una expresión throw como el operando derecho del operador ?? para
hacer el código de comprobación de argumentos más conciso:

C#

public string Name

get => name;

set => name = value ?? throw new

ArgumentNullException(nameof(value), "Name cannot be null");

El ejemplo anterior también muestra cómo usar miembros con forma de expresión
para definir una propiedad.

Puede usar el operador ??= para reemplazar el código del formulario

C#

if (variable is null)

variable = expression;

por el siguiente código:

C#

variable ??= expression;

Posibilidad de sobrecarga del operador

Los operadores ?? y ??= no se pueden sobrecargar.

especificación del lenguaje C#

Para obtener más información sobre el operador ?? , vea la sección El operador de uso
combinado de NULL de la especificación del lenguaje C#.
Para más información sobre el operador ??= , consulte la nota de propuesta de
características.

Vea también
Uso de expresiones de fusión (reglas de estilo IDE0029 e IDE0030)
Referencia de C#
Operadores y expresiones de C#
?. y ?[]
Operador ?:
" se usa para definir una expresión lambda en C# | Microsoft Learn" />

El operador de expresión lambda ( => )

define una expresión lambda
Artículo • 18/02/2023 • Tiempo de lectura: 2 minutos

El token => se admite de dos formas: como el operador lambda y como un separador
de un nombre de miembro y la implementación del miembro en una definición de
cuerpo de expresión.

Operador{1}{2}lambda
En las expresiones lambda, el operador => {4}lambda {5} separa los parámetros de
entrada del lado izquierdo y el cuerpo lambda del lado derecho.

En el ejemplo siguiente se usa la característica LINQ con sintaxis de método para

demostrar el uso de las expresiones lambda:

C#

string[] words = { "bot", "apple", "apricot" };

int minimalLength = words

.Where(w => w.StartsWith("a"))

.Min(w => w.Length);

Console.WriteLine(minimalLength); // output: 5

int[] numbers = { 4, 7, 10 };

int product = numbers.Aggregate(1, (interim, next) => interim * next);

Console.WriteLine(product); // output: 280

Los parámetros de entrada de una expresión lambda están fuertemente tipados en

tiempo de compilación. Cuando el compilador puede deducir los tipos de los
parámetros de entrada, como en el ejemplo anterior, se pueden omitir las declaraciones
de tipos. Si tiene que especificar el tipo de los parámetros de entrada, debe hacerlo para
cada uno de ellos, como se muestra en el ejemplo siguiente:

C#

int[] numbers = { 4, 7, 10 };

int product = numbers.Aggregate(1, (int interim, int next) => interim *

next);

Console.WriteLine(product); // output: 280

En el ejemplo siguiente se muestra cómo definir una expresión lambda sin parámetros
de entrada:

C#

Func<string> greet = () => "Hello, World!";

Console.WriteLine(greet());

Para obtener más información, vea Expresiones lambda.

Definición de cuerpo de expresiones

Una definición de cuerpo de expresión tiene la siguiente sintaxis general:

C#

member => expression;

donde expression es una expresión válida. El tipo de valor devuelto de expression se

debe poder convertir implícitamente al tipo de valor devuelto del miembro. Si el
miembro:

Tiene un tipo de valor devuelto void o

Es un:
Constructor
Finalizador
Descriptor de acceso set de propiedad o indizador

expression debe ser una expresión de instrucción. Dado que el resultado de la expresión
se descarta, el tipo de valor devuelto de esa expresión puede ser cualquiera.

En el ejemplo siguiente se muestra una definición de cuerpo de expresión para un

método Person.ToString :

C#

public override string ToString() => $"{fname} {lname}".Trim();

Es una versión abreviada de la definición de método siguiente:

C#
 public override string ToString()

return $"{fname} {lname}".Trim();

Puede crear definiciones de cuerpo de expresiones para métodos, operadores,

propiedades de solo lectura, constructores, finalizadores y descriptores de acceso de
propiedades e indizadores. Para obtener más información, vea Miembros con forma de
expresión.

Posibilidad de sobrecarga del operador

El operador => no se puede sobrecargar.

Especificación del lenguaje C#

Para más información sobre el operador lambda, vea la sección Expresiones de función
anónima de la Especificación del lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
:: operador : el operador de alias del
espacio de nombres
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

Use el calificador de alias de espacio de nombres :: para acceder a un miembro del

espacio de nombres con alias. Solo puede usar el calificador :: entre dos
identificadores. El identificador izquierdo puede ser uno de un alias de espacio de
nombres, un alias extern o el global alias. Por ejemplo:

Un alias de espacio de nombres creado con una directiva de alias using:

C#

using forwinforms = System.Drawing;

using forwpf = System.Windows;

public class Converters

{

public static forwpf::Point Convert(forwinforms::Point point) =>

new forwpf::Point(point.X, point.Y);

Un alias externo.

El alias global , que es el alias del espacio de nombres global. El espacio de

nombres global es el espacio de nombres que contiene los espacios de nombres y
los tipos que no se declaran dentro de un espacio de nombres con nombre.
Cuando se usa con el calificador :: , el alias global siempre hace referencia al
espacio de nombres global, incluso si está el alias del espacio de nombres global
definido por el usuario.

En el ejemplo siguiente se usa el alias global para tener acceso al espacio de

nombres System de .NET, que es miembro del espacio de nombres global. Sin el
alias global , se tendría acceso al espacio de nombres System definido por el
usuario, que es miembro del espacio de nombres MyCompany.MyProduct :

C#

namespace MyCompany.MyProduct.System

class Program

static void Main() => global::System.Console.WriteLine("Using

 global alias");

class Console

string Suggestion => "Consider renaming this class";

７ Nota

La palabra clave global es el alias de espacio de nombres global solo cuando

es el identificador izquierdo del calificador :: .

También puede usar el token . para acceder a un miembro de un espacio de nombres

con alias. Sin embargo, el operador . también se usa para acceder a un miembro del
tipo. El calificador :: garantiza que el identificador de la izquierda siempre hace
referencia a un alias de espacio de nombres, aunque exista un tipo o un espacio de
nombres con el mismo nombre.

Especificación del lenguaje C#

Para más información, consulte la sección sobre calificadores de alias de espacio de
nombres de la Especificación del lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
Operador await: espera
asincrónicamente para que se complete
una tarea
Artículo • 18/02/2023 • Tiempo de lectura: 3 minutos

El operador await suspende la evaluación del método async envolvente hasta que se
completa la operación asincrónica representada por su operando. Cuando se completa
la operación asincrónica, el operador await devuelve el resultado de la operación, si
existe. Cuando el operador await se aplica al operando que representa una operación
ya completada, devuelve el resultado de la operación inmediatamente sin suspender el
método envolvente. El operador await no bloquea el subproceso que evalúa el método
async. Cuando el operador await suspende el método async envolvente, el control
vuelve al autor de la llamada del método.

En el ejemplo siguiente, el método HttpClient.GetByteArrayAsync devuelve la instancia

Task<byte[]> , que representa una operación asincrónica que genera una matriz de

bytes cuando se completa. Hasta que se complete la operación, el operador await

suspende el método DownloadDocsMainPageAsync . Cuando se suspende
DownloadDocsMainPageAsync , se devuelve el control Main al método, que es el autor de la

llamada a DownloadDocsMainPageAsync . El método Main se ejecuta hasta que necesita el

resultado de la operación asincrónica realizada por el método
DownloadDocsMainPageAsync . Cuando GetByteArrayAsync obtiene todos los bytes, se
evalúa el resto del método DownloadDocsMainPageAsync . Después, se evalúa el resto del
método Main .

C#

using System;

using System.Net.Http;

using System.Threading.Tasks;

public class AwaitOperator

public static async Task Main()

Task<int> downloading = DownloadDocsMainPageAsync();

Console.WriteLine($"{nameof(Main)}: Launched downloading.");

int bytesLoaded = await downloading;

Console.WriteLine($"{nameof(Main)}: Downloaded {bytesLoaded}

bytes.");

 private static async Task<int> DownloadDocsMainPageAsync()

Console.WriteLine($"{nameof(DownloadDocsMainPageAsync)}: About to
start downloading.");

var client = new HttpClient();

byte[] content = await

client.GetByteArrayAsync("https://docs.microsoft.com/en-us/");

Console.WriteLine($"{nameof(DownloadDocsMainPageAsync)}: Finished
downloading.");

return content.Length;

// Output similar to:

// DownloadDocsMainPageAsync: About to start downloading.

// Main: Launched downloading.

// DownloadDocsMainPageAsync: Finished downloading.

// Main: Downloaded 27700 bytes.

En el ejemplo anterior se usa el método Main asincrónico. Para obtener más

información, vea la sección Operador await en el método Main.

７ Nota

Para obtener una introducción a la programación asincrónica, vea Programación

asincrónica con async y await. La programación asincrónica con async y await
sigue el modelo asincrónico basado en tareas.

El operador await se puede usar solamente en un método, una expresión lambda o un

método anónimo modificado por la palabra clave async. Dentro de un método async, no
se puede usar el operador await en el cuerpo de una función sincrónica, dentro del
bloque de una instrucción lock y en un contexto no seguro.

El operando del operador await suele ser de uno de los siguientes tipos de .NET: Task,
Task<TResult>, ValueTask o ValueTask<TResult>. Aunque cualquier expresión con await
puede ser el operando del operador await . Para obtener más información, vea la
sección Expresiones con await de la especificación del lenguaje C#.

El tipo de expresión await t es TResult si el tipo de expresión t es Task<TResult> o

ValueTask<TResult>. Si el tipo de t es Task o ValueTask, el tipo de await t es void . En
ambos casos, si t produce una excepción, await t vuelve a producir la excepción. Para
obtener más información sobre cómo controlar las excepciones, vea la sección
Excepciones en métodos async del artículo Instrucción try-catch.
Flujos asincrónicos y descartables
Se usa la instrucción await foreach para consumir un flujo de datos asincrónico. Para
obtener más información, consulte la sección instrucciones foreach del artículo
Instrucciones de iteración.

Se usa la instrucción await using para trabajar con un objeto descartable de forma
asincrónica, es decir, un objeto de un tipo que implementa una interfaz
IAsyncDisposable. Para obtener más información, vea la sección Uso de la eliminación
asincrónica del artículo Implementación de un método DisposeAsync.

Operador await en el método Main

El método Main, que es el punto de entrada de la aplicación, puede devolver Task o
Task<int> , lo que le permite ser asincrónico para poder usar el operador await en su
cuerpo. En versiones anteriores de C#, para tener la certeza de que el método Main
espera a que finalice una operación asincrónica, puede recuperar el valor de la
propiedad Task<TResult>.Result de la instancia Task<TResult> devuelta por el método
async correspondiente. Para las operaciones asincrónicas que no generan un valor,
puede llamar al método Task.Wait. Para obtener información sobre cómo seleccionar la
versión del lenguaje, vea Control de versiones del lenguaje C#.

Especificación del lenguaje C#

Para obtener más información, vea la sección Expresiones await de la especificación del
lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
async
Modelo de programación asincrónica de tareas
Programación asincrónica
Tutorial: Acceso a la web con async y await
Tutorial: generación y consumo de secuencias asincrónicas
expresiones de valor predeterminado:
genera el valor predeterminado
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

Una expresión de valor predeterminado genera el valor predeterminado de un tipo. Hay

dos tipos de expresiones de valor predeterminado: la llamada al operador
predeterminado y un literal predeterminado.

También se usa la palabra clave default como etiqueta de mayúsculas y minúsculas

predeterminada dentro de una instrucción switch.

operador default
El argumento del operador default debe ser el nombre de un tipo o un parámetro de
tipo, como se muestra en el ejemplo siguiente:

C#

Console.WriteLine(default(int)); // output: 0

Console.WriteLine(default(object) is null); // output: True

void DisplayDefaultOf<T>()

var val = default(T);

Console.WriteLine($"Default value of {typeof(T)} is {(val == null ?

"null" : val.ToString())}.");

DisplayDefaultOf<int?>();

DisplayDefaultOf<System.Numerics.Complex>();

DisplayDefaultOf<System.Collections.Generic.List<int>>();

// Output:

// Default value of System.Nullable`1[System.Int32] is null.

// Default value of System.Numerics.Complex is (0, 0).

// Default value of System.Collections.Generic.List`1[System.Int32] is null.

Literal default
Puede usar el literal default para generar el valor predeterminado de un tipo cuando el
compilador puede deducir el tipo de expresión. La expresión literal default genera el
mismo valor que la expresión default(T) cuando se deduce el tipo T . Puede usar el
literal default en cualquiera de los casos siguientes:
 En la asignación o inicialización de una variable.
En la declaración del valor predeterminado de un parámetro de método opcional.
En una llamada al método para proporcionar un valor de argumento.
En una instrucción return o como una expresión de un miembro con cuerpo de
expresión.

En el ejemplo siguiente se muestra el uso del literal default :

C#

T[] InitializeArray<T>(int length, T initialValue = default)

if (length < 0)

throw new ArgumentOutOfRangeException(nameof(length), "Array length

must be nonnegative.");

var array = new T[length];

for (var i = 0; i < length; i++)

array[i] = initialValue;

return array;

void Display<T>(T[] values) => Console.WriteLine($"[ {string.Join(", ",

values)} ]");

Display(InitializeArray<int>(3)); // output: [ 0, 0, 0 ]

Display(InitializeArray<bool>(4, default)); // output: [ False, False,

False, False ]

System.Numerics.Complex fillValue = default;

Display(InitializeArray(3, fillValue)); // output: [ (0, 0), (0, 0), (0, 0)

]

 Sugerencia

Use la regla de estilo de .NET IDE0034 para especificar una preferencia sobre el uso
del literal default en el código base.

Especificación del lenguaje C#

Para más información, consulte la sección Expresiones de valor predeterminado de la
especificación del lenguaje C#.
Vea también
Referencia de C#
Operadores y expresiones de C#
Valores predeterminados de los tipos de C#
Elementos genéricos en .NET
operador delegate
Artículo • 18/02/2023 • Tiempo de lectura: 2 minutos

El operador delegate crea un método anónimo que se puede convertir en un tipo

delegado. Un método anónimo se puede convertir en tipos como System.Action y
System.Func<TResult> que se usan como argumentos en muchos métodos.

C#

Func<int, int, int> sum = delegate (int a, int b) { return a + b; };

Console.WriteLine(sum(3, 4)); // output: 7

７ Nota

Las expresiones lambda proporcionan una manera más concisa y expresiva de crear
una función anónima. Use el operador=> para construir una expresión lambda:

C#

Func<int, int, int> sum = (a, b) => a + b;

Console.WriteLine(sum(3, 4)); // output: 7

Para más información sobre las características de las expresiones lambda, como
capturar las variables externas, consulte Expresiones lambda.

Al usar el operador delegate , puede omitir la lista de parámetros. Si lo hace, el método

anónimo creado se puede convertir en un tipo delegado con cualquier lista de
parámetros, tal como se muestra en el ejemplo siguiente:

C#

Action greet = delegate { Console.WriteLine("Hello!"); };

greet();

Action<int, double> introduce = delegate { Console.WriteLine("This is

world!"); };

introduce(42, 2.7);

// Output:

// Hello!

// This is world!

Esta es la única funcionalidad de los métodos anónimos que las expresiones lambda no
admiten. En todos los demás casos, una expresión lambda es una de las maneras
preferidas de escribir código alineado.

A partir de C# 9.0, puede usar descartes para especificar dos o más parámetros de
entrada de un método anónimo que no usa el método:

C#

Func<int, int, int> constant = delegate (int _, int _) { return 42; };

Console.WriteLine(constant(3, 4)); // output: 42

Por compatibilidad con versiones anteriores, si solo un parámetro se denomina _ , _ se

trata como el nombre de ese parámetro dentro de un método anónimo.

También a partir de C# 9.0, puede usar el modificador static en la declaración de un

método anónimo:

C#

Func<int, int, int> sum = static delegate (int a, int b) { return a + b; };

Console.WriteLine(sum(10, 4)); // output: 14

Un método anónimo estático no puede capturar variables locales ni el estado de la

instancia desde el ámbito de inclusión.

También puede usar la palabra clave delegate para declarar un tipo delegado.

A partir de C# 11, el compilador puede almacenar en caché el objeto delegado creado a

partir de un grupo de métodos. Observe el método siguiente:

C#

static void StaticFunction() { }

Al asignar el grupo de métodos a un delegado, el compilador almacenará en caché el

delegado:

C#

Action a = StaticFunction;

Antes de C# 11, se tenía que usar una expresión lambda para reutilizar un solo objeto
delegado:
 C#

Action a = () => StaticFunction();

Especificación del lenguaje C#

Para obtener más información, vea la sección Expresiones de función anónima de la
Especificación del lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
Operador=>
Operador is (Referencia de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

El operador is comprueba si el resultado de una expresión es compatible con un tipo

determinado. Para obtener información sobre el operador de prueba de tipos is , vea la
sección operador is del artículo Operadores de conversión y prueba de tipos. También
puede usar el operador is para comparar una expresión con un patrón, tal como se
muestra en el ejemplo siguiente:

C#

static bool IsFirstFridayOfOctober(DateTime date) =>

date is { Month: 10, Day: <=7, DayOfWeek: DayOfWeek.Friday };

En el ejemplo anterior, el operador is compara una expresión con un patrón de

propiedad con patrones constantes y relacionales (disponibles en C# 9.0 y versiones
posteriores) anidados.

El operador is puede resultar útil en los siguientes escenarios:

Para comprobar el tipo en tiempo de ejecución de una expresión, como se muestra

en el ejemplo siguiente:

C#

int i = 34;

object iBoxed = i;

int? jNullable = 42;

if (iBoxed is int a && jNullable is int b)

Console.WriteLine(a + b); // output 76

En el ejemplo anterior se muestra el uso de un patrón de declaración.

Para comprobar null , como se muestra en el ejemplo siguiente:

C#

if (input is null)

return;

 Al comparar una expresión con null , el compilador garantiza que no se invoca

ningún operador == o != sobrecargado por el usuario.

A partir de C# 9.0, puede usar un patrón de negación para realizar una

comprobación de valores distintos de NULL, como se muestra en el ejemplo
siguiente:

C#

if (result is not null)

Console.WriteLine(result.ToString());

A partir de C# 11, puede usar patrones de lista para buscar coincidencias con
elementos de una lista o matriz. El código siguiente comprueba las matrices de
valores enteros en las posiciones esperadas:

C#

int[] empty = { };

int[] one = { 1 };

int[] odd = { 1, 3, 5 };

int[] even = { 2, 4, 6 };

int[] fib = { 1, 1, 2, 3, 5 };

Console.WriteLine(odd is [1, _, 2, ..]); // false

Console.WriteLine(fib is [1, _, 2, ..]); // true

Console.WriteLine(fib is [_, 1, 2, 3, ..]); // true

Console.WriteLine(fib is [.., 1, 2, 3, _ ]); // true

Console.WriteLine(even is [2, _, 6]); // true

Console.WriteLine(even is [2, .., 6]); // true

Console.WriteLine(odd is [.., 3, 5]); // true

Console.WriteLine(even is [.., 3, 5]); // false

Console.WriteLine(fib is [.., 3, 5]); // true

７ Nota

Para obtener la lista completa de patrones admitidos por el operador is , vea

Patrones.

Especificación del lenguaje C#

Para más información, consulte la sección del operador is de la Especificación del
lenguaje C# y las siguientes propuestas del lenguaje C#:
 Coincidencia de patrones
Coincidencia de patrones con genéricos

Vea también
Referencia de C#
Operadores y expresiones de C#
Patrones
Tutorial: Uso de la coincidencia de patrones para compilar algoritmos basados en
tipos y basados en datos
Operadores de conversión y prueba de tipos
Expresión nameof (referencia de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

Una expresión nameof genera el nombre de una variable, un tipo o un miembro como
constante de cadena. La expresión nameof se evalúa en tiempo de compilación y no
tiene efecto en tiempo de ejecución. Cuando el operando es un tipo o un espacio de
nombres, el nombre generado no está completo. En el ejemplo siguiente se muestra el
uso de una expresión nameof :

C#

Console.WriteLine(nameof(System.Collections.Generic)); // output: Generic

Console.WriteLine(nameof(List<int>)); // output: List

Console.WriteLine(nameof(List<int>.Count)); // output: Count

Console.WriteLine(nameof(List<int>.Add)); // output: Add

var numbers = new List<int> { 1, 2, 3 };

Console.WriteLine(nameof(numbers)); // output: numbers

Console.WriteLine(nameof(numbers.Count)); // output: Count

Console.WriteLine(nameof(numbers.Add)); // output: Add

Cuando el operando es un identificador textual, el @ carácter no es la parte de un

nombre, como se muestra en el ejemplo siguiente:

C#

var @new = 5;
Console.WriteLine(nameof(@new)); // output: new

Puede usar una expresión nameof para facilitar el mantenimiento del código de
comprobación de argumentos:

C#

public string Name

get => name;

set => name = value ?? throw new ArgumentNullException(nameof(value), $"

{nameof(Name)} cannot be null");

A partir de C# 11, puede usar una expresión nameof con un parámetro de método
dentro de un atributo en un método o su parámetro. En el código siguiente se muestra
cómo hacerlo para un atributo en un método, una función local y el parámetro de una
expresión lambda:

C#

[ParameterString(nameof(msg))]

public static void Method(string msg)

[ParameterString(nameof(T))]

void LocalFunction<T>(T param) { }

var lambdaExpression = ([ParameterString(nameof(aNumber))] int aNumber)

=> aNumber.ToString();

Una expresión nameof con un parámetro es útil cuando se usan los atributos de análisis
que admiten valores NULL o el atributo CallerArgumentExpression.

Especificación del lenguaje C#

Para más información, consulte la sección Expresiones nameof de la especificación del
lenguaje C# y la especificación de las características de ámbito extendido nameof de
C#11.

Vea también
Referencia de C#
Operadores y expresiones de C#
Conversión de typeof en nameof (regla de estilo IDE0082)
operador new: el operador new crea una
nueva instancia de un tipo
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

El operador new crea una nueva instancia de un tipo. También puede usar la palabra
clave new como un modificador de declaración de miembro o una restricción de tipo
genérico.

Invocación del constructor

Para crear una nueva instancia de un tipo, normalmente se invoca uno de los
constructores de ese tipo mediante el operador new :

C#

var dict = new Dictionary<string, int>();

dict["first"] = 10;

dict["second"] = 20;

dict["third"] = 30;

Console.WriteLine(string.Join("; ", dict.Select(entry => $"{entry.Key}:

{entry.Value}")));

// Output:

// first: 10; second: 20; third: 30

Puede usar un inicializador de colección u objeto con el operador new para crear una
instancia e inicializar un objeto en una sola instrucción, como se muestra en el ejemplo
siguiente:

C#

var dict = new Dictionary<string, int>

["first"] = 10,

["second"] = 20,

["third"] = 30

};

Console.WriteLine(string.Join("; ", dict.Select(entry => $"{entry.Key}:

{entry.Value}")));

// Output:

// first: 10; second: 20; third: 30

A partir de C# 9.0, las expresiones de invocación del constructor tienen tipo de destino.
Es decir, si se conoce el tipo de destino de una expresión, puede omitir un nombre de
tipo, como se muestra en el ejemplo siguiente:

C#

List<int> xs = new();

List<int> ys = new(capacity: 10_000);

List<int> zs = new() { Capacity = 20_000 };

Dictionary<int, List<int>> lookup = new()

[1] = new() { 1, 2, 3 },

[2] = new() { 5, 8, 3 },

[5] = new() { 1, 0, 4 }

};

Como se muestra en el ejemplo anterior, siempre se usan paréntesis en una expresión

new con tipo de destino.

Si se desconoce el tipo de destino de una expresión new (por ejemplo, cuando se usa la
palabra clave var), se debe especificar un nombre de tipo.

creación de matriz
También se usa el operador new para crear una instancia de matriz, como se muestra en
el ejemplo siguiente:

C#

var numbers = new int[3];

numbers[0] = 10;

numbers[1] = 20;

numbers[2] = 30;

Console.WriteLine(string.Join(", ", numbers));

// Output:

// 10, 20, 30

Utilice la sintaxis de inicialización de matriz para crear una instancia de matriz y

rellenarla con los elementos en una sola instrucción. En el ejemplo siguiente se
muestran varias maneras de hacerlo:

C#
 var a = new int[3] { 10, 20, 30 };

var b = new int[] { 10, 20, 30 };

var c = new[] { 10, 20, 30 };

Console.WriteLine(c.GetType()); // output: System.Int32[]

Para obtener más información sobre las matrices, consulte Matrices.

Creación de instancias de tipos anónimos

Para crear una instancia de un tipo anónimo, utilice el operador new y la sintaxis de
inicializador de objeto:

C#

var example = new { Greeting = "Hello", Name = "World" };

Console.WriteLine($"{example.Greeting}, {example.Name}!");

// Output:

// Hello, World!

Destrucción de instancias de tipo

No tiene que destruir instancias de tipo creadas anteriormente. Las instancias de tipos
de valor y referencia se destruyen automáticamente. Las instancias de tipos de valor se
destruyen en cuanto se destruye el contexto que los contiene. Las instancias de tipos de
referencia los destruye el recolector de elementos no utilizados en un momento no
especificado después de eliminarse la última referencia a ellos.

Para los tipos de instancia que contienen recursos no administrados, como un

identificador de archivo, se recomienda realizar una limpieza determinista para
asegurarse de que los recursos que contienen se liberan tan pronto como sea posible.
Para más información, vea la referencia de la API System.IDisposable y el artículo sobre
la instrucción using.

Posibilidad de sobrecarga del operador

Un tipo definido por el usuario no puede sobrecargar el operador new .

Especificación del lenguaje C#

Para más información, vea la sección El operador new de la Especificación del lenguaje
C#.

Para más información sobre la expresión new con tipo de destino, consulte la nota de
propuesta de características.

Vea también
Referencia de C#
Operadores y expresiones de C#
Inicializadores de objeto y colección
operador sizeof: determine las
necesidades de memoria de un tipo
determinado
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

El operador sizeof devuelve el número de bytes ocupados por una variable de un tipo
determinado. El argumento del operador sizeof debe ser el nombre de un tipo
administrado o un parámetro de tipo que está restringido para ser un tipo no
administrado.

El operador sizeof requiere un contexto de unsafe. Sin embargo, las expresiones

presentadas en la tabla siguiente se evalúan en tiempo de compilación según los valores
de constantes correspondientes y no necesitan un contexto de unsafe:

Expresión Valor constante

sizeof(sbyte) 1

sizeof(byte) 1

sizeof(short) 2

sizeof(ushort) 2

sizeof(int) 4

sizeof(uint) 4

sizeof(long) 8

sizeof(ulong) 8

sizeof(char) 2

sizeof(float) 4

sizeof(double) 8

sizeof(decimal) 16

sizeof(bool) 1

Tampoco es necesario usar un contexto de unsafe cuando el operando del operador

sizeof es el nombre de un tipo enum.
En el siguiente ejemplo se muestra el uso del operador sizeof :

C#

public struct Point

public Point(byte tag, double x, double y) => (Tag, X, Y) = (tag, x, y);

public byte Tag { get; }

public double X { get; }

public double Y { get; }

public class SizeOfOperator

public static void Main()

Console.WriteLine(sizeof(byte)); // output: 1

Console.WriteLine(sizeof(double)); // output: 8

DisplaySizeOf<Point>(); // output: Size of Point is 24

DisplaySizeOf<decimal>(); // output: Size of System.Decimal is 16

unsafe

Console.WriteLine(sizeof(Point*)); // output: 8

static unsafe void DisplaySizeOf<T>() where T : unmanaged

Console.WriteLine($"Size of {typeof(T)} is {sizeof(T)}");

El operador sizeof devuelve un número de bytes que asignará Common Language

Runtime en la memoria administrada. Para los tipos struct, el valor incluye el relleno, tal
y como se muestra en el ejemplo anterior. El resultado del operador sizeof puede ser
distinto del resultado del método Marshal.SizeOf, que devuelve el tamaño de un tipo en
la memoria no administrada.

especificación del lenguaje C#

Para obtener más información, vea la sección Operador sizeof de la Especificación del
lenguaje C#.

Vea también
Referencia de C#
Operadores y expresiones de C#
Operadores relacionados con el puntero
Tipos de puntero
Tipos relacionados con el intervalo y la memoria
Elementos genéricos en .NET
Expresión stackalloc (referencia de C#)
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

La expresión stackalloc asigna un bloque de memoria en la pila. Un bloque de

memoria asignado a la pila creado durante la ejecución del método se descarta
automáticamente cuando se devuelva dicho método. No puede liberar explícitamente
memoria asignada con stackalloc . Un bloque de memoria asignada a la pila no está
sujeto a la recolección de elementos no utilizados y no tiene que fijarse con una
instrucción fixed.

Puede asignar el resultado de una expresión stackalloc a una variable de uno de los
siguientes tipos:

System.Span<T> o System.ReadOnlySpan<T>, tal como se muestra en el ejemplo

siguiente:

C#

int length = 3;

Span<int> numbers = stackalloc int[length];

for (var i = 0; i < length; i++)

numbers[i] = i;

No tiene que usar un contexto unsafe al asignar un bloque de memoria asignado a

la pila para una variable Span<T> o ReadOnlySpan<T>.

Cuando se trabaja con esos tipos, puede usar una expresión stackalloc en
expresiones condicionales o de asignación, como se muestra en el ejemplo
siguiente:

C#

int length = 1000;

Span<byte> buffer = length <= 1024 ? stackalloc byte[length] : new

byte[length];

Se puede usar una expresión stackalloc dentro de otras expresiones siempre que
se permita una variable Span<T> o ReadOnlySpan<T>, tal como se muestra en
este ejemplo:

C#
 Span<int> numbers = stackalloc[] { 1, 2, 3, 4, 5, 6 };

var ind = numbers.IndexOfAny(stackalloc[] { 2, 4, 6, 8 });

Console.WriteLine(ind); // output: 1

７ Nota

Se recomienda usar los tipos Span<T> o ReadOnlySpan<T> para trabajar

con memoria asignada a la pila siempre que sea posible.

Un tipo de puntero, como se muestra en el ejemplo siguiente:

C#

unsafe

int length = 3;

int* numbers = stackalloc int[length];

for (var i = 0; i < length; i++)

numbers[i] = i;

Como se muestra en el ejemplo anterior, se debe utilizar un contexto unsafe

cuando se trabaja con tipos de puntero.

En el caso de los tipos de puntero, solo se puede usar una expresión stackalloc
en una declaración de variable local para inicializar la variable.

La cantidad de memoria disponible en la pila es limitada. Si asigna demasiada memoria

en la pila, se produce una excepción StackOverflowException. Para evitarlo, siga estas
reglas:

Limite la cantidad de memoria asignada con stackalloc . Por ejemplo, si el tamaño

de búfer previsto está por debajo de un límite determinado, asigne la memoria en
la pila; de lo contrario, use una matriz de la longitud necesaria, como se muestra
en el código siguiente:

C#

const int MaxStackLimit = 1024;

Span<byte> buffer = inputLength <= MaxStackLimit ? stackalloc

byte[MaxStackLimit] : new byte[inputLength];

 ７ Nota

Como la cantidad de memoria disponible en la pila depende del entorno en el

que se ejecuta el código, debe ser conservador al definir el valor límite real.

Evite el uso de stackalloc dentro de bucles. Asigne el bloque de memoria fuera

de un bucle y vuelva a usarlo dentro del bucle.

El contenido de la memoria recién asignada está sin definir. Debe inicializarlo antes del
uso. Por ejemplo, puede usar el método Span<T>.Clear que establece todos los
elementos en el valor predeterminado de tipo T .

Se puede usar la sintaxis de inicializador de matriz para definir el contenido de la

memoria recientemente asignada. En el ejemplo siguiente se muestran diversas formas
de hacerlo:

C#

Span<int> first = stackalloc int[3] { 1, 2, 3 };

Span<int> second = stackalloc int[] { 1, 2, 3 };

ReadOnlySpan<int> third = stackalloc[] { 1, 2, 3 };

En la expresión stackalloc T[E] , T debe ser un tipo no administrado y E debe

evaluarse como un valor int no negativo.

Seguridad
El uso de stackalloc habilita automáticamente las características de detección de
saturación del búfer en el entorno Common Language Runtime (CLR). Si se detecta
saturación del búfer, se finaliza el proceso lo antes posible para minimizar el riesgo de
que se ejecute código malintencionado.

Especificación del lenguaje C#

Para más información, consulte la sección sobre asignación de pila de la especificación
del lenguaje C# y la nota de la característica Permitir stackalloc en contextos anidados.

Vea también
Referencia de C#
Operadores y expresiones de C#
Operadores relacionados con el puntero
Tipos de puntero
Tipos relacionados con el intervalo y la memoria
Qué hacer y qué no hacer de stackalloc
expresión switch: expresiones de
coincidencia de patrones mediante la
switch palabra clave
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

Se usa la expresión switch para evaluar una expresión única a partir de una lista de
expresiones candidatas basadas en una coincidencia de patrón con una expresión de
entrada. Para obtener información sobre la instrucción switch que admite la semántica
switch en un contexto de instrucción, consulte la sección instrucción switch del artículo

Instrucciones de selección.

En el ejemplo siguiente se muestra una expresión switch , que traslada los valores de un
objeto enum que representa las direcciones visuales de un mapa en línea hasta la
dirección cardinal correspondiente:

C#

public static class SwitchExample

public enum Direction

Up,

Down,

Right,

Left

public enum Orientation

North,

South,

East,

West

public static Orientation ToOrientation(Direction direction) =>

direction switch

Direction.Up => Orientation.North,

Direction.Right => Orientation.East,

Direction.Down => Orientation.South,

Direction.Left => Orientation.West,

_ => throw new ArgumentOutOfRangeException(nameof(direction), $"Not

expected direction value: {direction}"),

};

 public static void Main()

var direction = Direction.Right;

Console.WriteLine($"Map view direction is {direction}");

Console.WriteLine($"Cardinal orientation is
{ToOrientation(direction)}");

// Output:

// Map view direction is Right

// Cardinal orientation is East

En el ejemplo anterior se muestran los elementos básicos de una expresión switch :

Expresión seguida de la palabra clave switch . En el ejemplo anterior, es el

parámetro del método direction .
Los brazos de la expresión switch , separados por comas. Cada brazo de la
expresión switch contiene un patrón, una restricción de mayúsculas y minúsculas
opcional, el token => y una expresión.

En el ejemplo anterior, una expresión switch usa los siguientes patrones:

Un patrón constante para controlar los valores definidos de la enumeración

Direction .
Un patrón de descarte para controlar cualquier valor entero que no tenga el
miembro correspondiente de la enumeración Direction (como, (Direction)10 ).
Esto hace que la expresión switch sea exhaustiva.

） Importante

Para obtener información sobre los patrones admitidos por una expresión switch y
más ejemplos, consulte Patrones.

El resultado de la expresión switch es el valor de la expresión del primer brazo de la

expresión switch cuyo patrón coincide con la expresión de intervalo y cuya restricción
de mayúsculas y minúsculas, en caso de estar presente, se evalúa como true . Los
brazos de la expresión switch se evalúan en orden de texto.

El compilador emite un error cuando no se puede elegir un brazo de la expresión

switch inferior porque un brazo de la expresión switch superior coincide con todos sus
valores.
Restricciones de mayúsculas y minúsculas
Un patrón puede no ser lo suficientemente expresivo como para especificar la condición
para la evaluación de la expresión de un brazo. En tal caso, puede usar una restricción de
caso. Una restricción de caso es una condición adicional que debe cumplirse junto con
un patrón coincidente. Una restricción de caso debe ser una expresión booleana.
Especifique una restricción de mayúsculas y minúsculas después de la palabra clave
when que sigue un patrón, como se muestra en el ejemplo siguiente:

C#

public readonly struct Point

public Point(int x, int y) => (X, Y) = (x, y);

public int X { get; }

public int Y { get; }

static Point Transform(Point point) => point switch

{ X: 0, Y: 0 } => new Point(0, 0),

{ X: var x, Y: var y } when x < y => new Point(x + y, y),

{ X: var x, Y: var y } when x > y => new Point(x - y, y),

{ X: var x, Y: var y } => new Point(2 * x, 2 * y),

};

En el ejemplo anterior se usan patrones de propiedad con patrones var anidados.

Expresiones switch no exhaustivas

Si ninguno de los patrones de una expresión switch coincide con un valor de entrada,
el entorno de ejecución produce una excepción. En .NET Core 3.0 y versiones
posteriores, la excepción es
System.Runtime.CompilerServices.SwitchExpressionException. En .NET Framework, la
excepción es InvalidOperationException. En la mayoría de los casos, el compilador
genera una advertencia si una expresión switch no controla todos los valores de
entrada posibles. Los patrones de lista no generan una advertencia cuando no se
controlan todas las entradas posibles.

 Sugerencia

Para garantizar que una expresión switch controle todos los valores de entrada
posibles, proporcione un brazo de expresión switch con un patrón de descarte.
Especificación del lenguaje C#
Para obtener más información, vea la sección sobre la expresión de switch de la nota de
propuesta de características.

Vea también
Uso de la expresión "switch" (regla de estilo IDE0066)
Adición de casos que faltan a la expresión "switch" (regla de estilo IDE0072)
Referencia de C#
Operadores y expresiones de C#
Patrones
Tutorial: Uso de la coincidencia de patrones para compilar algoritmos basados en
tipos y basados en datos
Instrucción switch
Operadores true y false: trate los
objetos como un valor booleano
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

El operador true devuelve el valor bool true para indicar que su operando es
definitivamente true. El operador false devuelve el valor bool true para indicar que su
operando es definitivamente false. Los operadores true y false no garantizan que se
complementen entre sí. Es decir, tanto el operador true como false podrían devolver
el valor bool false del mismo operando. Si un tipo define uno de los dos operadores,
también debe definir otro operador.

 Sugerencia

Use el tipo bool? , si tiene que admitir la lógica de tres valores (por ejemplo,
cuando trabaja con bases de datos que admiten un tipo booleano de tres valores).
C# proporciona los operadores & y | que admiten la lógica de tres valores con los
operandos bool? . Para más información, consulte la sección Operadores lógicos
booleanos que aceptan valores NULL del artículo Operadores lógicos booleanos.

Expresiones booleanas
Un tipo con el operador true definido puede ser el tipo de un resultado de una
expresión condicional de control en las instruciones if, do, while y for y en el operador
condicional ?:. Para más información, vea la sección Expresiones booleanas de la
Especificación del lenguaje C#.

Operadores lógicos condicionales definidos por

el usuario
Si un tipo con los operadores true y false definidos sobrecarga el operador lógico
OR | o el operador lógico AND & de una manera determinada, el operador lógico
condicional OR || o el operador lógico condicional AND && , respectivamente, se puede
evaluar para los operandos de ese tipo. Para obtener más información, vea la sección
Operadores lógicos condicionales definidos por el usuario de la Especificación del
lenguaje C#.
Ejemplo
El ejemplo siguiente muestra el tipo que define los operadores true y false . Además,
el tipo sobrecarga el operador lógico AND & de manera que el operador && también se
puede evaluar para los operandos de ese tipo.

C#

public struct LaunchStatus

public static readonly LaunchStatus Green = new LaunchStatus(0);

public static readonly LaunchStatus Yellow = new LaunchStatus(1);

public static readonly LaunchStatus Red = new LaunchStatus(2);

private int status;

private LaunchStatus(int status)

this.status = status;

public static bool operator true(LaunchStatus x) => x == Green || x ==

Yellow;

public static bool operator false(LaunchStatus x) => x == Red;

public static LaunchStatus operator &(LaunchStatus x, LaunchStatus y)

if (x == Red || y == Red || (x == Yellow && y == Yellow))

return Red;

if (x == Yellow || y == Yellow)

return Yellow;

return Green;

public static bool operator ==(LaunchStatus x, LaunchStatus y) =>

x.status == y.status;

public static bool operator !=(LaunchStatus x, LaunchStatus y) => !(x ==

y);

public override bool Equals(object obj) => obj is LaunchStatus other &&
this == other;

public override int GetHashCode() => status;

public class LaunchStatusTest

 public static void Main()

LaunchStatus okToLaunch = GetFuelLaunchStatus() &&

GetNavigationLaunchStatus();

Console.WriteLine(okToLaunch ? "Ready to go!" : "Wait!");

static LaunchStatus GetFuelLaunchStatus()

Console.WriteLine("Getting fuel launch status...");

return LaunchStatus.Red;

static LaunchStatus GetNavigationLaunchStatus()

Console.WriteLine("Getting navigation launch status...");

return LaunchStatus.Yellow;

Tenga en cuenta el comportamiento de cortocircuito del operador && . Cuando el

método GetFuelLaunchStatus devuelve LaunchStatus.Red , el operando derecho del
operador && no se evalúa. Eso es porque LaunchStatus.Red es definitivamente false. A
continuación, el resultado de AND lógico no depende del valor del operando derecho.
El resultado del ejemplo es el siguiente:

Consola

Getting fuel launch status...

Wait!

Vea también
Referencia de C#
Operadores y expresiones de C#
Expresión with: la mutación no
destructiva crea un objeto nuevo con
propiedades modificadas
Artículo • 18/02/2023 • Tiempo de lectura: 3 minutos

Disponible en C# 9.0 y versiones posteriores, se trata de una expresión with que genera
una copia de su operando con las propiedades y los campos especificados modificados.
se usa la sintaxis del inicializador de objeto para especificar qué miembros se van a
modificar y sus nuevos valores:

C#

using System;

public class WithExpressionBasicExample

public record NamedPoint(string Name, int X, int Y);

public static void Main()

var p1 = new NamedPoint("A", 0, 0);

Console.WriteLine($"{nameof(p1)}: {p1}"); // output: p1: NamedPoint

{ Name = A, X = 0, Y = 0 }

var p2 = p1 with { Name = "B", X = 5 };

Console.WriteLine($"{nameof(p2)}: {p2}"); // output: p2: NamedPoint

{ Name = B, X = 5, Y = 0 }

var p3 = p1 with

Name = "C",

Y = 4

};

Console.WriteLine($"{nameof(p3)}: {p3}"); // output: p3: NamedPoint

{ Name = C, X = 0, Y = 4 }

Console.WriteLine($"{nameof(p1)}: {p1}"); // output: p1: NamedPoint

{ Name = A, X = 0, Y = 0 }

var apples = new { Item = "Apples", Price = 1.19m };

Console.WriteLine($"Original: {apples}"); // output: Original: {

Item = Apples, Price = 1.19 }

var saleApples = apples with { Price = 0.79m };

Console.WriteLine($"Sale: {saleApples}"); // output: Sale: { Item =

Apples, Price = 0.79 }

En C# 9.0, un operando izquierdo de una expresión with debe ser de un tipo de

registro. A partir de C# 10, un operando izquierdo de una expresión with también
puede ser de un tipo de estructura o un tipo anónimo.

El resultado de una expresión with tiene el mismo tipo de entorno de ejecución que el
operando de la expresión, como se muestra en el ejemplo siguiente:

C#

using System;

public class InheritanceExample

public record Point(int X, int Y);

public record NamedPoint(string Name, int X, int Y) : Point(X, Y);

public static void Main()

Point p1 = new NamedPoint("A", 0, 0);

Point p2 = p1 with { X = 5, Y = 3 };

Console.WriteLine(p2 is NamedPoint); // output: True

Console.WriteLine(p2); // output: NamedPoint { X = 5, Y = 3, Name =

A }

En el caso de un miembro de tipo referencia, solo se copia la referencia a una instancia

del miembro cuando se copia un operando. Tanto la copia como el operando original
tienen acceso a la misma instancia de tipo de referencia. En el ejemplo siguiente se
muestra ese comportamiento:

C#

using System;

using System.Collections.Generic;

public class ExampleWithReferenceType

public record TaggedNumber(int Number, List<string> Tags)

public string PrintTags() => string.Join(", ", Tags);

public static void Main()

var original = new TaggedNumber(1, new List<string> { "A", "B" });

var copy = original with { Number = 2 };

Console.WriteLine($"Tags of {nameof(copy)}: {copy.PrintTags()}");

// output: Tags of copy: A, B

 original.Tags.Add("C");

Console.WriteLine($"Tags of {nameof(copy)}: {copy.PrintTags()}");

// output: Tags of copy: A, B, C

Semántica de copia personalizada

Cualquier tipo de clase registro tiene el constructor de copia. Un constructor de copia es
un constructor con un único parámetro del tipo de registro contenedor. Copia el estado
de su argumento en una nueva instancia de registro. Al evaluar una expresión with , se
llama al constructor de copia para crear instancias de una nueva instancia de registro en
función de un registro original. Después, la nueva instancia se actualiza según las
modificaciones especificadas. De forma predeterminada, el constructor de copia es
implícito, es decir, lo genera el compilador. Si tiene que personalizar la semántica de la
copia de registros, declare explícitamente un constructor de copia con el
comportamiento deseado. En el ejemplo siguiente se actualiza el anterior con un
constructor de copia explícito. El nuevo comportamiento de copia consiste en copiar los
elementos de lista en lugar de una referencia de lista cuando se copia un registro:

C#

using System;

using System.Collections.Generic;

public class UserDefinedCopyConstructorExample

public record TaggedNumber(int Number, List<string> Tags)

protected TaggedNumber(TaggedNumber original)

Number = original.Number;

Tags = new List<string>(original.Tags);

public string PrintTags() => string.Join(", ", Tags);

public static void Main()

var original = new TaggedNumber(1, new List<string> { "A", "B" });

var copy = original with { Number = 2 };

Console.WriteLine($"Tags of {nameof(copy)}: {copy.PrintTags()}");

// output: Tags of copy: A, B

original.Tags.Add("C");

 Console.WriteLine($"Tags of {nameof(copy)}: {copy.PrintTags()}");

// output: Tags of copy: A, B

No se puede personalizar la semántica de copia para los tipos de estructura.

Especificación del lenguaje C#

Para obtener más información, vea las secciones siguientes de la nota de propuestas de
características de registros:

Expresión with
Copiar y clonar miembros

Vea también
Referencia de C#
Operadores y expresiones de C#
Registros
Tipos de estructura
Sobrecarga de operadores: operadores
unarios, aritméticos, de igualdad y de
comparación predefinidos
Artículo • 18/02/2023 • Tiempo de lectura: 3 minutos

Un tipo definido por el usuario puede sobrecargar un operador de C# predefinido. Es

decir, un tipo puede proporcionar la implementación personalizada de una operación
cuando uno o los dos operandos son de ese tipo. En la sección Operadores
sobrecargables se muestra qué operadores de C# pueden sobrecargarse.

Use la palabra clave operator para declarar un operador. Una declaración de operador
debe cumplir las reglas siguientes:

Incluye los modificadores public y static .

Un operador unario tiene un parámetro de entrada. Un operador binario tiene dos
parámetros de entrada. En cada caso, al menos un parámetro debe ser de tipo T o
T? donde T es el tipo que contiene la declaración del operador.

En el ejemplo siguiente se muestra una estructura simplificada para representar un

número racional. La estructura sobrecarga algunos de los operadores aritméticos:

C#

public readonly struct Fraction

private readonly int num;

private readonly int den;

public Fraction(int numerator, int denominator)

if (denominator == 0)

throw new ArgumentException("Denominator cannot be zero.",

nameof(denominator));

num = numerator;

den = denominator;

public static Fraction operator +(Fraction a) => a;

public static Fraction operator -(Fraction a) => new Fraction(-a.num,

a.den);

public static Fraction operator +(Fraction a, Fraction b)

=> new Fraction(a.num * b.den + b.num * a.den, a.den * b.den);

 public static Fraction operator -(Fraction a, Fraction b)

=> a + (-b);

public static Fraction operator *(Fraction a, Fraction b)

=> new Fraction(a.num * b.num, a.den * b.den);

public static Fraction operator /(Fraction a, Fraction b)

if (b.num == 0)
{

throw new DivideByZeroException();

return new Fraction(a.num * b.den, a.den * b.num);

public override string ToString() => $"{num} / {den}";

public static class OperatorOverloading

public static void Main()

var a = new Fraction(5, 4);

var b = new Fraction(1, 2);

Console.WriteLine(-a); // output: -5 / 4

Console.WriteLine(a + b); // output: 14 / 8

Console.WriteLine(a - b); // output: 6 / 8

Console.WriteLine(a * b); // output: 5 / 8

Console.WriteLine(a / b); // output: 10 / 4

Puede ampliar el ejemplo anterior mediante la definición de una conversión implícita de

int a Fraction . A continuación, los operadores sobrecargados admiten argumentos de

esos dos tipos. Es decir, sería posible agregar un valor entero a una fracción y obtener
como resultado una fracción.

También usa la palabra clave operator para definir una conversión de tipos
personalizada. Para obtener más información, vea Operadores de conversión definidos
por el usuario.

Operadores sobrecargables
En la tabla siguiente se muestran los operadores que se pueden sobrecargar:

Operadores Notas

+x, -x, !x, ~x, ++, --, true, false Los operadores true y false deben sobrecargarse juntos.
 Operadores Notas

x + y, x - y, x * y, x / y, x % y,

x & y, x | y, x ^ y,

x << y, x >> y, x >>> y

x == y, x != y, x < y, x > y, x <= Deben sobrecargarse en parejas de la siguiente manera: == y

y, x >= y != , < y > , <= y >= .

Operadores no sobrecargables
En la tabla siguiente se muestran los operadores que no se pueden sobrecargar:

Operadores Alternativas

x && y, x || y Sobrecargue los operadores true y false, así como los operadores &
o |. Para obtener más información, vea Operadores lógicos
condicionales definidos por el usuario.

a[i], a?[i] Defina un indizador.

(T)x Defina conversiones de tipos personalizadas que pueden realizarse

mediante una expresión de conversión. Para obtener más
información, vea Operadores de conversión definidos por el
usuario.

+=, -=, *=, /=, %=, &=, |=, Sobrecargue el operador binario correspondiente. Por ejemplo,
^=, <<=, >>=, >>>= cuando sobrecarga el operador + binario, += se sobrecarga
implícitamente.

^x, x = y, x.y, x?.y, c ? t : f, x Ninguno.

?? y, ??= y,

x..y, x->y, =>, f(x), as, await,

checked, unchecked,
default, delegate, is,
nameof, new,

sizeof, stackalloc, switch,

typeof, with

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

Sobrecarga de operadores
Operadores
Vea también
Referencia de C#
Operadores y expresiones de C#
Operadores de conversión definidos por el usuario
Directrices de diseño: sobrecargas de operador
Directrices de diseño: operadores de igualdad
Why are overloaded operators always static in C#? (¿Por qué los operadores
sobrecargados son siempre estáticos en C#?)
Instrucciones de iteración: for , foreach ,
do y while
Artículo • 19/02/2023 • Tiempo de lectura: 7 minutos

Las instrucciones de iteración ejecutan repetidamente una instrucción o un bloque de

instrucciones. La instrucción for: ejecuta su cuerpo mientras una expresión booleana
especificada se evalúe como true . La instrucción foreach: enumera los elementos de
una colección y ejecuta su cuerpo para cada elemento de la colección. La instrucción do:
ejecuta condicionalmente su cuerpo una o varias veces. La instrucción while: ejecuta
condicionalmente su cuerpo cero o varias veces.

En cualquier punto del cuerpo de una instrucción de iteración, se puede salir del bucle
mediante la instrucción break. Puede avanzar a la próxima iteración en el bucle
mediante la instrucción continue.

Instrucción for
La instrucción for ejecuta una instrucción o un bloque de instrucciones mientras una
expresión booleana especificada se evalúa como true . En el ejemplo siguiente se
muestra la instrucción for , que ejecuta su cuerpo mientras que un contador entero sea
menor que tres:

C#

for (int i = 0; i < 3; i++)

Console.Write(i);

// Output:

// 012

En el ejemplo anterior se muestran los elementos de la instrucción for :

La sección inicializador, que se ejecuta solo una vez, antes de entrar en el bucle.
Normalmente, se declara e inicializa una variable de bucle local en esa sección. No
se puede acceder a la variable declarada desde fuera de la instrucción for .

La sección inicializador del ejemplo anterior declara e inicializa una variable de

contador entero:

C#
 int i = 0

La sección condición que determina si se debe ejecutar la siguiente iteración del

bucle. Si se evalúa como true o no está presente, se ejecuta la siguiente iteración;
de lo contrario, se sale del bucle. La sección condición debe ser una expresión
booleana.

La sección condición del ejemplo anterior comprueba si un valor de contador es

menor que tres:

C#

i < 3

La sección iterador, que define lo que sucede después de cada iteración del cuerpo
del bucle.

La sección iterador del ejemplo anterior incrementa el contador:

C#

i++

El cuerpo del bucle, que es una instrucción o un bloque de instrucciones.

La sección iterador puede contener cero o más de las siguientes expresiones de

instrucción, separadas por comas:

expresión de incremento de prefijo o sufijo, como ++i o i++

expresión de decremento de prefijo o sufijo, como --i o i--
asignación
invocación de un método
expresión await
creación de un objeto mediante el operador new

Si no declara una variable de bucle en la sección inicializador, también puede usar cero
o varias de las expresiones de la lista anterior de dicha sección. En el ejemplo siguiente
se muestran varios usos menos comunes de las secciones inicializador e iterador:
asignar un valor a una variable externa en la sección inicializador, invocar un método en
las secciones inicializador e iterador, y cambiar los valores de dos variables en la sección
iterador:

C#
 int i;

int j = 3;

for (i = 0, Console.WriteLine($"Start: i={i}, j={j}"); i < j; i++, j--,

Console.WriteLine($"Step: i={i}, j={j}"))

//...

// Output:

// Start: i=0, j=3

// Step: i=1, j=2

// Step: i=2, j=1

Todas las secciones de la instrucción for son opcionales. En el ejemplo, el siguiente

código define el bucle for infinito:

C#

for ( ; ; )

//...

Instrucción foreach
La instrucción foreach ejecuta una instrucción o un bloque de instrucciones para cada
elemento de una instancia del tipo que implementa la interfaz
System.Collections.IEnumerable o System.Collections.Generic.IEnumerable<T>, como se
muestra en el siguiente ejemplo:

C#

var fibNumbers = new List<int> { 0, 1, 1, 2, 3, 5, 8, 13 };

foreach (int element in fibNumbers)

Console.Write($"{element} ");

// Output:

// 0 1 1 2 3 5 8 13

La instrucción foreach no está limitada a esos tipos. Puede usarla con una instancia de
cualquier tipo que cumpla las condiciones siguientes:

Un tipo tiene el método público GetEnumerator sin parámetros. A partir de C# 9.0,

el método GetEnumerator puede ser el método de extensión de un tipo.
 El tipo de valor devuelto del método GetEnumerator tiene la propiedad pública
Current y el método público MoveNext sin parámetros, cuyo tipo de valor devuelto
es bool .

En el siguiente ejemplo se usa la instrucción foreach con una instancia del tipo
System.Span<T>, que no implementa ninguna interfaz:

C#

Span<int> numbers = new int[] { 3, 14, 15, 92, 6 };

foreach (int number in numbers)

Console.Write($"{number} ");

// Output:

// 3 14 15 92 6

Si la propiedad Current del enumerador devuelve un valor devuelto de referencia ( ref

T donde T es el tipo de un elemento de colección), puede declarar una variable de

iteración con el modificador ref o ref readonly , como se muestra en el ejemplo

siguiente:

C#

Span<int> storage = stackalloc int[10];

int num = 0;

foreach (ref int item in storage)

item = num++;

foreach (ref readonly var item in storage)

Console.Write($"{item} ");

// Output:

// 0 1 2 3 4 5 6 7 8 9

Si la instrucción foreach se aplica a null , se produce NullReferenceException. Si la

colección de origen de la instrucción foreach está vacía, el cuerpo de la instrucción
foreach no se ejecuta y se omite.

await foreach
Puede usar la instrucción await foreach para consumir un flujo asincrónico de datos, es
decir, el tipo de colección que implementa la interfaz IAsyncEnumerable<T>. Cada
iteración del bucle se puede suspender mientras el siguiente elemento se recupera de
forma asincrónica. En el ejemplo siguiente se muestra cómo usar la instrucción await
foreach :

C#

await foreach (var item in GenerateSequenceAsync())

Console.WriteLine(item);

También puede usar la instrucción await foreach con una instancia de cualquier tipo
que cumpla las condiciones siguientes:

Un tipo tiene el método público GetAsyncEnumerator sin parámetros. Ese método

puede ser el método de extensión del tipo.
El tipo de valor devuelto del método GetAsyncEnumerator tiene la propiedad
pública Current y el método público MoveNextAsync sin parámetros cuyo tipo de
valor devuelto es Task<bool>, ValueTask<bool>, o cualquier otro tipo que se
puede esperar cuyo método GetResult de awaiter devuelve un valor bool .

Los elementos de secuencia se procesan de forma predeterminada en el contexto

capturado. Si quiere deshabilitar la captura del contexto, use el método de extensión
TaskAsyncEnumerableExtensions.ConfigureAwait. Para obtener más información sobre
los contextos de sincronización y la captura del contexto actual, vea Utilizar el modelo
asincrónico basado en tareas. Para obtener más información sobre las secuencias
asincrónicas, consulte Tutorial de secuencias asincrónicas.

Tipo de una variable de iteración

Puede usar la palabra clave var para permitir que el compilador infiera el tipo de una
variable de iteración de la instrucción foreach , como se muestra en el código siguiente:

C#

foreach (var item in collection) { }

También puede especificar de forma explícita el tipo de una variable de iteración, como
se muestra en el código siguiente:

C#
 IEnumerable<T> collection = new T[5];

foreach (V item in collection) { }

En el formulario anterior, el tipo T de un elemento de colección se debe poder convertir

de forma implícita o explícita en el tipo V de una variable de iteración. Si se produce un
error en una conversión explícita de T en V en tiempo de ejecución, la instrucción
foreach produce InvalidCastException. Por ejemplo, si T es un tipo de clase no sellada,
V puede ser cualquier tipo de interfaz, incluso uno que T no implemente. En tiempo de

ejecución, el tipo de un elemento de colección puede ser el que deriva de T y realmente

implementa V . Si ese no es el caso, se produce InvalidCastException.

Instrucción do
La instrucción do ejecuta una instrucción o un bloque de instrucciones mientras que
una expresión booleana especificada se evalúa como true . Como esa expresión se
evalúa después de cada ejecución del bucle, un bucle do se ejecuta una o varias veces.
La instrucción do es diferente de un bucle while, que se ejecuta cero o varias veces.

En el ejemplo siguiente se muestra el uso de la instrucción do :

C#

int n = 0;

do

Console.Write(n);

n++;

} while (n < 5);

// Output:

// 01234

Instrucción while
La instrucción while ejecuta una instrucción o un bloque de instrucciones mientras que
una expresión booleana especificada se evalúa como true . Como esa expresión se
evalúa antes de cada ejecución del bucle, un bucle while se ejecuta cero o varias veces.
La instrucción while es diferente de un bucle do, que se ejecuta una o varias veces.

En el ejemplo siguiente se muestra el uso de la instrucción while :

C#
 int n = 0;

while (n < 5)

Console.Write(n);

n++;

// Output:

// 01234

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

La instrucción for
La instrucción foreach
La instrucción do
La instrucción while

Para obtener más información sobre de las características agregadas en C# 8.0 y

versiones posteriores, vea las siguientes notas de propuesta de características:

Flujos asincrónicos (C# 8.0)

Compatibilidad con extensiones GetEnumerator para bucles foreach (C# 9.0)

Vea también
Referencia de C#
Utilizar foreach con matrices
Iteradores
Instrucciones de selección if , else y
switch
Artículo • 17/02/2023 • Tiempo de lectura: 5 minutos

Las instrucciones if , else y switch seleccionan las instrucciones que se ejecutarán a

partir de muchos trazados posibles en función del valor de una expresión. La
if instrucción selecciona una instrucción para ejecutarla en función del valor de una
expresión booleana. Una if instrucción se puede combinar con else para elegir dos
rutas de acceso distintas en función de la expresión booleana. La switch instrucción
selecciona una lista de instrucciones para ejecutarla en función de la coincidencia de un
patrón con una expresión.

Instrucción if
Una instrucción if puede tener cualquiera de las dos formas siguientes:

Una instrucción if con una parte else selecciona una de las dos instrucciones
que se ejecutarán en función del valor de una expresión booleana, como se
muestra en el ejemplo siguiente:

C#

DisplayWeatherReport(15.0); // Output: Cold.

DisplayWeatherReport(24.0); // Output: Perfect!

void DisplayWeatherReport(double tempInCelsius)

if (tempInCelsius < 20.0)

Console.WriteLine("Cold.");

else

Console.WriteLine("Perfect!");

Una instrucción if sin una parte else ejecuta el cuerpo solo si una expresión
booleana se evalúa como true , como se muestra en el ejemplo siguiente:

C#
 DisplayMeasurement(45); // Output: The measurement value is 45

DisplayMeasurement(-3); // Output: Warning: not acceptable value! The

measurement value is -3

void DisplayMeasurement(double value)

if (value < 0 || value > 100)

Console.Write("Warning: not acceptable value! ");

Console.WriteLine($"The measurement value is {value}");

Puede anidar instrucciones if para comprobar varias condiciones, como se muestra en

el ejemplo siguiente:

C#

DisplayCharacter('f'); // Output: A lowercase letter: f

DisplayCharacter('R'); // Output: An uppercase letter: R

DisplayCharacter('8'); // Output: A digit: 8

DisplayCharacter(','); // Output: Not alphanumeric character: ,

void DisplayCharacter(char ch)

if (char.IsUpper(ch))

Console.WriteLine($"An uppercase letter: {ch}");

else if (char.IsLower(ch))

Console.WriteLine($"A lowercase letter: {ch}");

else if (char.IsDigit(ch))

Console.WriteLine($"A digit: {ch}");

else

Console.WriteLine($"Not alphanumeric character: {ch}");

En un contexto de expresión, puede usar el operador condicional ?: para evaluar una de

las dos expresiones en función del valor de una expresión booleana.

Instrucción switch
La instrucción switch selecciona una lista de instrucciones para ejecutarla en función de
la coincidencia de un patrón con una expresión de coincidencia, como se muestra en el
ejemplo siguiente:

C#

DisplayMeasurement(-4); // Output: Measured value is -4; too low.

DisplayMeasurement(5); // Output: Measured value is 5.

DisplayMeasurement(30); // Output: Measured value is 30; too high.

DisplayMeasurement(double.NaN); // Output: Failed measurement.

void DisplayMeasurement(double measurement)

switch (measurement)

case < 0.0:

Console.WriteLine($"Measured value is {measurement}; too low.");

break;

case > 15.0:

Console.WriteLine($"Measured value is {measurement}; too

high.");

break;

case double.NaN:

Console.WriteLine("Failed measurement.");

break;

default:

Console.WriteLine($"Measured value is {measurement}.");

break;

En el ejemplo anterior, una instrucción switch usa los siguientes patrones:

Un patrón relacional (disponible en C# 9.0 y versiones posteriores), para comparar

el resultado de una expresión con una constante.
Una patrón de constante: para probar si el resultado de una expresión es igual a
una constante.

） Importante

Para obtener información sobre los patrones admitidos por la instrucción switch ,
consulte Patrones.
En el ejemplo anterior también se muestra el caso default . El caso default especifica
las instrucciones que se ejecutarán cuando una expresión de coincidencia no coincida
con ningún otro patrón de caso. Si una expresión de coincidencia no coincide con
ningún patrón de caso y no hay ningún caso default , el control pasa por una
instrucción switch .

Una instrucción switch ejecuta la lista de instrucciones en la primera sección de switch

cuyo patrón de caso coincida con una expresión de coincidencia y cuya restricción de
caso, de haberla, se evalúe como true . Una instrucción switch evalúa los patrones de
casos en el orden de texto de arriba a abajo. El compilador genera un error cuando una
instrucción switch contiene un caso inaccesible. Ese es un caso que ya se controla
mediante un caso superior o cuyo patrón es imposible de hacer coincidir.

７ Nota

El caso default puede aparecer en cualquier lugar de una instrucción switch .

Independientemente de su posición, el caso default siempre se evalúa en último
lugar y solo si no se realiza la coincidencia con ninguno de los demás patrones de
caso, excepto si se encuentra goto default .

Puede especificar varios patrones de casos para una sección de una instrucción switch ,
como se muestra en el ejemplo siguiente:

C#

DisplayMeasurement(-4); // Output: Measured value is -4; out of an

acceptable range.

DisplayMeasurement(50); // Output: Measured value is 50.

DisplayMeasurement(132); // Output: Measured value is 132; out of an

acceptable range.

void DisplayMeasurement(int measurement)

switch (measurement)

case < 0:

case > 100:

Console.WriteLine($"Measured value is {measurement}; out of an

acceptable range.");

break;

default:

Console.WriteLine($"Measured value is {measurement}.");

break;

Dentro de una instrucción switch , el control no puede pasar desde una sección switch a
la siguiente. Como se muestra en los ejemplos de esta sección, normalmente se usa la
instrucción break al final de cada sección switch para pasar el control desde una
instrucción switch . También puede usar las instrucciones return y throw para pasar el
control desde una instrucción switch . Para imitar el comportamiento de pasaje explícito
y pasar el control a otra sección switch, puede usar la instrucción goto.

En el contexto de una expresión, puede usar la expresión switch para evaluar una
expresión única a partir de una lista de expresiones candidatas basada en una
coincidencia de patrón con una expresión.

Restricciones de mayúsculas y minúsculas

Un patrón de caso puede no ser lo suficientemente expresivo como para especificar la
condición para la ejecución de la sección switch. En tal caso, puede usar una restricción
de caso. Se trata de una condición adicional que debe cumplirse junto con un patrón
coincidente. Una restricción de caso debe ser una expresión booleana. Especifique una
restricción de mayúsculas y minúsculas después de la palabra clave when que sigue un
patrón, como se muestra en el ejemplo siguiente:

C#

DisplayMeasurements(3, 4); // Output: First measurement is 3, second

measurement is 4.

DisplayMeasurements(5, 5); // Output: Both measurements are valid and equal

to 5.

void DisplayMeasurements(int a, int b)

switch ((a, b))

case (> 0, > 0) when a == b:

Console.WriteLine($"Both measurements are valid and equal to

{a}.");

break;

case (> 0, > 0):

Console.WriteLine($"First measurement is {a}, second measurement

is {b}.");

break;

default:

Console.WriteLine("One or both measurements are not valid.");

break;

En el ejemplo anterior se usan patrones posicionales con patrones relacionales

anidados.

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

La instrucción if
La instrucción switch

Para más información sobre la instrucción switch de la coincidencia de patrones,

consulte las siguientes notas de propuestas de características:

Instrucción switch (Coincidencia de patrones)

Vea también
Referencia de C#
Operador condicional ?:
Operadores lógicos
Patrones
Expresión switch
Agregar casos que faltan a la instrucción "switch" (regla de estilo IDE0010)
Instrucciones de salto: break , continue ,
return y goto
Artículo • 17/02/2023 • Tiempo de lectura: 9 minutos

Cuatro instrucciones de C# transfieren incondicionalmente el control. La

break instrucción : termina la instrucción de iteración contenedora más próxima o la

switch instrucción . La continue instrucción : inicia una nueva iteración de la instrucción

de iteración contenedora más próxima. La return instrucción : termina la ejecución de la
función en la que aparece y devuelve el control al llamador. El modificador ref de una
instrucción return indica que la expresión devuelta se devuelve por referencia, no por
valor. La goto instrucción : transfiere el control a una instrucción marcada por una
etiqueta.

Para obtener información sobre la instrucción throw que genera una excepción y
también transfiere el control sin condiciones, consulte throw.

Instrucción break
La instrucción break termina la instrucción de iteración contenedora más próxima (es
decir, los bucles for , foreach , while o do ) o la instrucción switch. La instrucción break
transfiere el control a la instrucción que hay a continuación de la instrucción finalizada,
si existe.

C#

int[] numbers = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
foreach (int number in numbers)

if (number == 3)

break;

Console.Write($"{number} ");

Console.WriteLine();

Console.WriteLine("End of the example.");

// Output:

// 0 1 2

// End of the example.

En los bucles anidados, la instrucción break termina solo el bucle más interno que la
contiene, como se muestra en el ejemplo siguiente:

C#

for (int outer = 0; outer < 5; outer++)

for (int inner = 0; inner < 5; inner++)

if (inner > outer)

break;

Console.Write($"{inner} ");

Console.WriteLine();

// Output:

// 0

// 0 1

// 0 1 2

// 0 1 2 3

// 0 1 2 3 4

Cuando usa la instrucción switch dentro de un bucle, una instrucción break al final de
una sección switch transfiere el control solo fuera de la instrucción switch . El bucle que
contiene la instrucción switch no se ve afectado, como se muestra en el ejemplo
siguiente:

C#

double[] measurements = { -4, 5, 30, double.NaN };

foreach (double measurement in measurements)

switch (measurement)

case < 0.0:

Console.WriteLine($"Measured value is {measurement}; too low.");

break;

case > 15.0:

Console.WriteLine($"Measured value is {measurement}; too

high.");

break;

case double.NaN:

Console.WriteLine("Failed measurement.");

break;

default:

 Console.WriteLine($"Measured value is {measurement}.");

break;

// Output:

// Measured value is -4; too low.

// Measured value is 5.

// Measured value is 30; too high.

// Failed measurement.

Instrucción continue
La instrucción continue inicia una nueva iteración de la instrucción de iteración
contenedora más próxima (es decir, los bucles for , foreach , while o do ), como se
muestra en el ejemplo siguiente:

C#

for (int i = 0; i < 5; i++)

Console.Write($"Iteration {i}: ");

if (i < 3)

Console.WriteLine("skip");

continue;

Console.WriteLine("done");

// Output:

// Iteration 0: skip

// Iteration 1: skip

// Iteration 2: skip

// Iteration 3: done

// Iteration 4: done

Instrucción return
La instrucción return termina la ejecución de la función en la que aparece y devuelve el
control y el resultado de la función, si existe, al llamador.

Si un miembro de función no calcula un valor, se usa la instrucción return sin expresión,

como se muestra en el ejemplo siguiente:

C#
 Console.WriteLine("First call:");
DisplayIfNecessary(6);

Console.WriteLine("Second call:");

DisplayIfNecessary(5);

void DisplayIfNecessary(int number)

if (number % 2 == 0)

return;

Console.WriteLine(number);

// Output:

// First call:

// Second call:

// 5

Como se muestra en el ejemplo anterior, normalmente se usa la instrucción return sin

expresión para terminar un miembro de función al principio. Si un miembro de función
no contiene la instrucción return , termina después de ejecutarse su última instrucción.

Si un miembro de función calcula un valor, se usa la instrucción return con una

expresión, como se muestra en el ejemplo siguiente:

C#

double surfaceArea = CalculateCylinderSurfaceArea(1, 1);

Console.WriteLine($"{surfaceArea:F2}"); // output: 12.57

double CalculateCylinderSurfaceArea(double baseRadius, double height)

double baseArea = Math.PI * baseRadius * baseRadius;

double sideArea = 2 * Math.PI * baseRadius * height;

return 2 * baseArea + sideArea;

Cuando la instrucción return tiene una expresión, esa expresión debe poderse convertir
implícitamente al tipo de valor devuelto de un miembro de función a menos que sea
async. La expresión devuelta de una función async debe poderse convertir
implícitamente al argumento de tipo de Task<TResult> o ValueTask<TResult>, el que
sea el tipo de valor devuelto de la función. Si el tipo de valor devuelto de una función
async es Task o ValueTask, se usa la instrucción return sin expresión.
De forma predeterminada, la instrucción return devuelve el valor de una expresión.
Puede devolver una referencia a una variable. Para ello, use la instrucción return con la
palabra clave ref, como se muestra en el ejemplo siguiente:

C#

var xs = new int[] { 10, 20, 30, 40 };

ref int found = ref FindFirst(xs, s => s == 30);

found = 0;

Console.WriteLine(string.Join(" ", xs)); // output: 10 20 0 40

ref int FindFirst(int[] numbers, Func<int, bool> predicate)

{

for (int i = 0; i < numbers.Length; i++)

if (predicate(numbers[i]))

return ref numbers[i];

throw new InvalidOperationException("No element satisfies the given

condition.");

Devoluciones de referencias
Los valores devueltos se pueden devolver por referencia (devuelve ref ). Un valor
devuelto de referencia permite que un método devuelva una referencia a una variable,
en lugar de un valor, al autor de una llamada. El autor de la llamada puede tratar la
variable devuelta como si se hubiera devuelto por valor o por referencia. El autor de la
llamada puede crear una variable que sea una referencia al valor devuelto, lo que se
conoce como una referencia local. Un valor devuelto de referencia significa que un
método devuelve una referencia (o un alias) a alguna variable. El ámbito de esa variable
debe incluir el método. La duración de la variable debe extenderse más allá de la
devolución del método. Las modificaciones en el valor del método devuelto por el autor
de la llamada se realizan en la variable devuelta por el método.

Declarar que un método devuelve un valor devuelto de referencia indica que el método
devuelve un alias a una variable. La intención del diseño suele ser que el código de
llamada acceda a esa variable a través del alias, incluso para modificarla. Por tanto, los
métodos devueltos por referencia no pueden tener el tipo de valor devuelto void .

El valor devuelto ref es un alias para otra variable en el ámbito del método llamado.
Puede interpretar cualquier uso del valor devuelto tipo ref como si se usara la variable a
la que se asigna el alias:
 Al asignar su valor, se asigna un valor a la variable a la que se asigna el alias.
Al leer su valor, se lee un valor a la variable a la que se asigna el alias.
Si la devolución se realiza por referencia, entonces devuelve un alias a esa misma
variable.
Si pasa el valor a otro método por referencia, pasará una referencia a la variable a
la que se asigna el alias.
Al asignar un alias local tipo ref, crea un alias para la misma variable.

Un valor devuelto ref debe ser ref_safe_to_escape respecto al método que realiza la
llamada. Esto significa lo siguiente:

El valor devuelto debe tener una duración que se extienda más allá de la ejecución
del método. En otras palabras, no puede tratarse de una variable local del método
que la devuelve. Puede ser una instancia o un campo estático de una clase, o
puede ser un argumento pasado al método. Al intentar devolver una variable local,
se genera el error del compilador CS8168, "No se puede devolver por referencia la
variable local 'obj' porque no es de tipo ref".
El valor devuelto no puede ser el literal null . Un método con un valor devuelto de
referencia puede devolver un alias a una variable cuyo valor es actualmente el
valor null (sin instancias) o un tipo de valor que admite un valor NULL para un
tipo de valor.
El valor devuelto no puede ser una constante, un miembro de enumeración, el
valor devuelto por valor desde una propiedad o un método de class o struct .

Además, los valores devueltos por referencia no se permiten en métodos asincrónicos.

Un método asincrónico puede volver antes de que haya terminado de ejecutarse,
mientras que su valor devuelto aún no se conoce.

Un método que devuelve un valor devuelto de referencia debe:

Incluir la palabra clave ref delante del tipo de valor devuelto.

Cada instrucción return del cuerpo del método incluye la palabra clave ref delante
del nombre de la instancia devuelta.

En el método siguiente se muestra un método que cumple estas condiciones y devuelve

una referencia a un objeto Person denominado p :

C#

public ref Person GetContactInformation(string fname, string lname)

// ...method implementation...

return ref p;

Instrucción goto
La instrucción goto transfiere el control a una instrucción marcada por una etiqueta,
como se muestra en el ejemplo siguiente:

C#

var matrices = new Dictionary<string, int[][]>

{

["A"] = new[]

new[] { 1, 2, 3, 4 },

new[] { 4, 3, 2, 1 }

},

["B"] = new[]

new[] { 5, 6, 7, 8 },

new[] { 8, 7, 6, 5 }

},

};

CheckMatrices(matrices, 4);

void CheckMatrices(Dictionary<string, int[][]> matrixLookup, int target)

foreach (var (key, matrix) in matrixLookup)

for (int row = 0; row < matrix.Length; row++)

for (int col = 0; col < matrix[row].Length; col++)

if (matrix[row][col] == target)

goto Found;

Console.WriteLine($"Not found {target} in matrix {key}.");

continue;

Found:

Console.WriteLine($"Found {target} in matrix {key}.");

// Output:

// Found 4 in matrix A.

// Not found 4 in matrix B.

Como se muestra en el ejemplo anterior, se puede usar la instrucción goto para salir de
un bucle anidado.

 Sugerencia

Cuando trabaje con bucles anidados, considere la posibilidad de refactorizar bucles

independientes en métodos independientes. Eso puede dar lugar a un código más
sencillo y legible sin la instrucción goto .

También puede usar la instrucción goto en la instrucción switch para transferir el control
a una sección switch con una etiqueta case constante, como se muestra en el ejemplo
siguiente:

C#

using System;

public enum CoffeeChoice

Plain,

WithMilk,

WithIceCream,

public class GotoInSwitchExample

public static void Main()

Console.WriteLine(CalculatePrice(CoffeeChoice.Plain)); // output:
10.0

Console.WriteLine(CalculatePrice(CoffeeChoice.WithMilk)); //
output: 15.0

Console.WriteLine(CalculatePrice(CoffeeChoice.WithIceCream)); //
output: 17.0

private static decimal CalculatePrice(CoffeeChoice choice)

decimal price = 0;

switch (choice)

case CoffeeChoice.Plain:

price += 10.0m;

break;

case CoffeeChoice.WithMilk:

price += 5.0m;

goto case CoffeeChoice.Plain;

case CoffeeChoice.WithIceCream:

 price += 7.0m;

goto case CoffeeChoice.Plain;

return price;

Dentro de la instrucción switch , también se puede usar la instrucción goto default;

para transferir el control a la sección switch con la etiqueta default .

Si una etiqueta con el nombre especificado no existe en el miembro de función actual o

si la instrucción goto no está dentro del ámbito de la etiqueta, se produce un error en
tiempo de compilación. Es decir, no se puede usar la instrucción goto para transferir el
control fuera del miembro de función actual o a cualquier ámbito anidado, por ejemplo,
un bloque try .

Especificación del lenguaje C#

Para más información, vea las secciones siguientes de la Especificación del lenguaje C#:

La instrucción break
La instrucción continue
La instrucción return
La instrucción goto

Vea también
Referencia de C#
Instrucción yield
instrucción lock: asegúrese del acceso
exclusivo a un recurso compartido.
Artículo • 17/02/2023 • Tiempo de lectura: 2 minutos

La instrucción lock adquiere el bloqueo de exclusión mutua de un objeto determinado,

ejecuta un bloque de instrucciones y luego libera el bloqueo. Mientras se mantiene un
bloqueo, el subproceso que lo mantiene puede volver a adquirir y liberar el bloqueo.
Ningún otro subproceso puede adquirir el bloqueo y espera hasta que se libera. La lock
instrucción garantiza que un único subproceso tenga acceso exclusivo a ese objeto.

La instrucción lock tiene el formato

C#

lock (x)

// Your code...

donde x es una expresión de un tipo de referencia. Es exactamente equivalente a

C#

object __lockObj = x;

bool __lockWasTaken = false;

try

System.Threading.Monitor.Enter(__lockObj, ref __lockWasTaken);

// Your code...

finally

if (__lockWasTaken) System.Threading.Monitor.Exit(__lockObj);

Puesto que el código usa un bloque try... finally, el bloqueo se libera aunque se
produzca una excepción dentro del cuerpo de una instrucción lock .

No se puede usar el operador await en el cuerpo de una instrucción lock .

Instrucciones
Al sincronizar el acceso del subproceso al recurso compartido, bloquee una instancia
dedicada de objeto (por ejemplo, private readonly object balanceLock = new
object(); ) u otra instancia cuyo empleo como objeto de bloqueo sea poco probable

por parte de elementos no relacionados del código. Evite el uso de la misma instancia
de objeto de bloqueo para distintos recursos compartidos, ya que se podría producir un
interbloqueo o una contención de bloqueo. En particular, evite utilizar los siguientes
tipos como objetos de bloqueo:

this , porque los autores de llamadas podrían usarlo como un bloqueo.

Instancias Type, porque el operador o la reflexión typeof podrían obtener estos

objetos.
Instancias de cadena, incluidos literales de cadena, ya que los literales de cadena
podrían internarse.

Mantenga el bloqueo durante el menor tiempo posible para reducir la contención de

bloqueo.

Ejemplo
En el ejemplo siguiente se define una clase Account que sincroniza el acceso a su campo
privado balance mediante el bloqueo de una instancia dedicada balanceLock . El empleo
de la misma instancia para bloquear garantiza que el campo balance no sea actualizado
al mismo tiempo por dos subprocesos que intentan llamar a los métodos Debit o
Credit simultáneamente.

C#

using System;

using System.Threading.Tasks;

public class Account

private readonly object balanceLock = new object();

private decimal balance;

public Account(decimal initialBalance) => balance = initialBalance;

public decimal Debit(decimal amount)

if (amount < 0)
{

throw new ArgumentOutOfRangeException(nameof(amount), "The debit

amount cannot be negative.");

decimal appliedAmount = 0;

 lock (balanceLock)

if (balance >= amount)

balance -= amount;

appliedAmount = amount;

return appliedAmount;

public void Credit(decimal amount)

if (amount < 0)
{

throw new ArgumentOutOfRangeException(nameof(amount), "The

credit amount cannot be negative.");

lock (balanceLock)

balance += amount;

public decimal GetBalance()

lock (balanceLock)

return balance;

class AccountTest

static async Task Main()

var account = new Account(1000);

var tasks = new Task[100];

for (int i = 0; i < tasks.Length; i++)

tasks[i] = Task.Run(() => Update(account));

await Task.WhenAll(tasks);

Console.WriteLine($"Account's balance is {account.GetBalance()}");

// Output:

// Account's balance is 2000

static void Update(Account account)

decimal[] amounts = { 0, 2, -3, 6, -2, -1, 8, -5, 11, -6 };

foreach (var amount in amounts)

 if (amount >= 0)

account.Credit(amount);

else

account.Debit(Math.Abs(amount));

Especificación del lenguaje C#

Para más información, consulte la sección sobre la instrucción lock de la especificación
del lenguaje C#.

Vea también
Referencia de C#
System.Threading.Monitor
System.Threading.SpinLock
System.Threading.Interlocked
Información general sobre las primitivas de sincronización
Introducción a System.Threading.Channels
Caracteres especiales de C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Los caracteres especiales son caracteres contextuales predefinidos que modifican el

elemento de programa (una cadena literal, un identificador o un nombre de atributo)
para que se antepongan. C# admite los siguientes caracteres especiales:

@, el carácter de identificador textual.

$, el carácter de cadena interpolada.

Esta sección solo incluye los tokens que no son operadores. Consulte la sección de
operadores para ver todos los operadores.

Consulte también
Referencia de C#
Guía de programación de C#
Interpolación de cadenas mediante $
Artículo • 17/02/2023 • Tiempo de lectura: 8 minutos

El carácter especial $ identifica un literal de cadena como una cadena interpolada. Una
cadena interpolada es un literal de cadena que puede contener expresiones de
interpolación. Cuando una cadena interpolada se resuelve en una cadena de resultado,
los elementos con expresiones de interpolación se reemplazan por las representaciones
de cadena de los resultados de la expresión.

La interpolación de cadenas proporciona una sintaxis más legible y conveniente de dar

formato a las cadenas. Es más fácil de leer que el formato compuesto de cadenas.
Compare el ejemplo siguiente donde se usan ambas características para producir el
mismo resultado:

C#

string name = "Mark";

var date = DateTime.Now;

// Composite formatting:

Console.WriteLine("Hello, {0}! Today is {1}, it's {2:HH:mm} now.", name,

date.DayOfWeek, date);

// String interpolation:

Console.WriteLine($"Hello, {name}! Today is {date.DayOfWeek}, it's

{date:HH:mm} now.");

// Both calls produce the same output that is similar to:

// Hello, Mark! Today is Wednesday, it's 19:40 now.

Estructura de una cadena interpolada

Para distinguir un literal de cadena como una cadena interpolada, antepóngale el
símbolo $ . No puede haber ningún espacio en blanco entre el carácter $ y el carácter "
que inicia un literal de cadena. Para concatenar varias cadenas interpoladas, agregue el
carácter especial $ a cada literal de cadena.

La estructura de un elemento con una expresión de interpolación es como se muestra

aquí:

C#

{<interpolationExpression>[,<alignment>][:<formatString>]}

Los elementos entre corchetes son opcionales. En esta tabla se describe cada elemento:
 Elemento Descripción

interpolationExpression Expresión que genera un resultado al que se va a aplicar formato. La

representación de cadena de null es String.Empty.

alignment La expresión constante cuyo valor define el número mínimo de

caracteres en la representación de cadena del resultado de la
expresión. Si es positivo, la representación de cadena está alineada a
la derecha; si es negativo, está alineada a la izquierda. Para más
información, vea Alignment (Componente).

formatString Cadena de formato compatible con el tipo de resultado de la

expresión. Para más información, vea Format String (Componente).

En el ejemplo siguiente, se usan componentes opcionales de formato que se han

descrito anteriormente:

C#

Console.WriteLine($"|{"Left",-7}|{"Right",7}|");

const int FieldWidthRightAligned = 20;

Console.WriteLine($"{Math.PI,FieldWidthRightAligned} - default formatting of

the pi number");

Console.WriteLine($"{Math.PI,FieldWidthRightAligned:F3} - display only three

decimal digits of the pi number");

// Expected output is:

// |Left | Right|

// 3.14159265358979 - default formatting of the pi number

// 3.142 - display only three decimal digits of the pi number

A partir de C# 10, se puede utilizar la interpolación de cadenas para inicializar una

constante de cadena. Todas las expresiones usadas en los marcadores de posición
deben ser constantes de cadena. En otras palabras, cada expresión de interpolación debe
ser una cadena y debe ser una constante en tiempo de compilación.

A partir de C# 11, las expresiones interpoladas pueden incluir nuevas líneas. El texto
entre { y } debe ser válido en C#, por lo tanto, puede incluir nuevas líneas que mejoran
la legibilidad. En el ejemplo siguiente se muestra cómo las nuevas líneas pueden
mejorar la legibilidad de una expresión que implica la coincidencia de patrones:

C#

string message = $"The usage policy for {safetyScore} is {

safetyScore switch

> 90 => "Unlimited usage",

> 80 => "General usage, with daily safety check",

 > 70 => "Issues must be addressed within 1 week",

> 50 => "Issues must be addressed within 1 day",

_ => "Issues must be addressed before continued use",

}";

Además, a partir de C# 11, puede usar un literal de cadena sin formato para la cadena
de formato:

C#

int X = 2;

int Y = 3;

var pointMessage = $"""The point "{X}, {Y}" is {Math.Sqrt(X * X + Y * Y)}

from the origin""";

Console.WriteLine(pointMessage);

// output: The point "2, 3" is 3.605551275463989 from the origin.

Puede usar varios caracteres $ en un literal de cadena sin formato interpolada para
insertar caracteres { y } en la cadena de salida sin escaparlos:

C#

int X = 2;

int Y = 3;

var pointMessage = $$"""The point {{{X}}, {{Y}}} is {{Math.Sqrt(X * X + Y *

Y)}} from the origin""";

Console.WriteLine(pointMessage);

// output: The point {2, 3} is 3.605551275463989 from the origin.

Si la cadena de salida debe contener caracteres { o } repetidos, puede agregar más $

para designar la cadena interpolada. Cualquier secuencia de { o } más corta que el
número de $ se incrustará en la cadena de salida. Como se muestra en el ejemplo
anterior, las secuencias más largas que la secuencia de caracteres $ insertan los
caracteres { o } adicionales en la salida. El compilador emite un error si la secuencia de
caracteres de llave es igual o mayor que el doble de la longitud de la secuencia de
caracteres $ .

Puede probar estas características mediante el SDK de .NET 7. O bien, si tiene el SDK de
.NET 6.00.200 o posterior, puede establecer el elemento <LangVersion> del archivo
csproj en preview .
Caracteres especiales
Para incluir una llave ("{" o "}") en el texto generado por una cadena interpolada, use dos
llaves ("{{" o "}}"). Para más información, vea Llaves de escape.

Como los dos puntos (":") tienen un significado especial en un elemento de expresión
de interpolación, para poder usar un operador condicional en una expresión de
interpolación, incluya esa expresión entre paréntesis.

En el siguiente ejemplo se muestra cómo incluir una llave en una cadena de resultado.
También se muestra cómo usar un operador condicional:

C#

string name = "Horace";

int age = 34;

Console.WriteLine($"He asked, \"Is your name {name}?\", but didn't wait for
a reply :-{{");

Console.WriteLine($"{name} is {age} year{(age == 1 ? "" : "s")} old.");

// Expected output is:

// He asked, "Is your name Horace?", but didn't wait for a reply :-{

// Horace is 34 years old.

Las cadenas textuales interpoladas comienzan por el carácter $ , seguido del carácter @ .
Los tokens $ y @ se pueden usar en cualquier orden; tanto $@"..." como @$"..." son
cadenas textuales interpoladas válidas. Para más información sobre las cadenas
textuales, consulte los artículos sobre cadenas e Identificadores textuales.

Conversiones implícitas y cómo especificar la

implementación de IFormatProvider
Hay tres conversiones implícitas de una cadena interpolada:

1. Conversión de una cadena interpolada en una instancia de String. La cadena es el

resultado de la resolución de la cadena interpolada. Todos los elementos de la
expresión de interpolación se reemplazan por las representaciones de cadena con
el formato correcto de sus resultados. Esta conversión utiliza CurrentCulture para
dar formato a los resultados de la expresión.

2. Conversión de una cadena interpolada a una instancia FormattableString que

representa una cadena de formato compuesto junto con los resultados de
expresión a los que se va a aplicar formato. Esto permite crear varias cadenas de
 resultado con contenido específico de la referencia cultural de una sola instancia
de FormattableString. Para ello, llame a uno de estos métodos:

Una sobrecarga de ToString() que genera una cadena de resultado para

CurrentCulture.
Método Invariant que genera una cadena de resultado para InvariantCulture.
Un método ToString(IFormatProvider) que genera una cadena de resultado
para una referencia cultural especificada.

El método ToString(IFormatProvider) proporciona una implementación definida

por el usuario de la interfaz IFormatProvider que admite formato personalizado.
Para más información, consulte la sección Formato personalizado con
ICustomFormatter del artículo Aplicar formato a tipos en .NET.

3. Conversión de una cadena interpolada a una instancia IFormattable que también

permite crear varias cadenas de resultado con contenido específico de la referencia
cultural de una sola instancia IFormattable.

En el ejemplo siguiente, se usa la conversión implícita a FormattableString para crear

cadenas de resultado específicas de la referencia cultural:

C#

double speedOfLight = 299792.458;

FormattableString message = $"The speed of light is {speedOfLight:N3}

km/s.";

System.Globalization.CultureInfo.CurrentCulture =
System.Globalization.CultureInfo.GetCultureInfo("nl-NL");

string messageInCurrentCulture = message.ToString();

var specificCulture = System.Globalization.CultureInfo.GetCultureInfo("en-

IN");

string messageInSpecificCulture = message.ToString(specificCulture);

string messageInInvariantCulture = FormattableString.Invariant(message);

Console.WriteLine($"{System.Globalization.CultureInfo.CurrentCulture,-10}
{messageInCurrentCulture}");

Console.WriteLine($"{specificCulture,-10} {messageInSpecificCulture}");

Console.WriteLine($"{"Invariant",-10} {messageInInvariantCulture}");

// Expected output is:

// nl-NL The speed of light is 299.792,458 km/s.

// en-IN The speed of light is 2,99,792.458 km/s.

// Invariant The speed of light is 299,792.458 km/s.

Otros recursos
Si no está familiarizado con la interpolación de cadenas, consulte el tutorial interactivo
Interpolación de cadenas en C#. También puede consultar otro tutorial sobre la
interpolación de cadenas en C#. En ese tutorial se muestra el uso de cadenas
interpoladas para generar cadenas con formato.

Compilación de cadenas interpoladas

Si una cadena interpolada tiene el tipo string , normalmente se transforma en una
llamada de método String.Format. El compilador puede reemplazar String.Format por
String.Concat si el comportamiento analizado es equivalente a una concatenación.

Si una cadena interpolada tiene el tipo IFormattable o FormattableString, el compilador

genera una llamada al método FormattableStringFactory.Create.

A partir de C# 10, cuando se usa una cadena interpolada, el compilador comprueba si

esta está asignada a un tipo que satisface el patrón de controlador de cadenas
interpoladas. Un controlador de cadenas interpoladas es un tipo personalizado que
convierte la cadena interpolada en una cadena. Un controlador de cadenas interpoladas
es un escenario avanzado, que normalmente se usa por motivos de rendimiento. Puede
obtener información sobre los requisitos para crear un controlador de cadenas
interpoladas en la especificación del lenguaje para las mejoras de cadenas interpoladas.
Para crear uno, puede seguir el tutorial sobre el controlador de cadenas interpoladas en
la sección de Novedades de C#. En .NET 6, cuando se usa una cadena interpolada para
un argumento de tipo string ,
System.Runtime.CompilerServices.DefaultInterpolatedStringHandler procesa la cadena
interpolada.

７ Nota

Un efecto secundario de los controladores de cadenas interpoladas es que un

controlador personalizado, por ejemplo,
System.Runtime.CompilerServices.DefaultInterpolatedStringHandler, podría no
evaluar todas las expresiones usadas como marcadores de posición en la cadena
interpolada en todas las condiciones. Esto significa que es posible que no se
produzcan efectos secundarios en esas expresiones.

Especificación del lenguaje C#

Para obtener más información, vea la sección Cadenas interpoladas de la Especificación
del lenguaje C#, la especificación de la característica de literales de cadena sin procesar
de C# 11 y la especificación de la característica de nuevas líneas en interpolaciones de
cadenas de C# 11.

Vea también
Simplificación de la interpolación (regla de estilo IDE0071)
Referencia de C#
Caracteres especiales de C#
Cadenas
Cadenas con formato numérico estándar
Formatos compuestos
String.Format
Texto textual: @ en variables, atributos y
literales de cadena
Artículo • 17/02/2023 • Tiempo de lectura: 3 minutos

El carácter especial @ actúa como un identificador textual. Se puede usar de estas

formas:

1. Para habilitar el uso de palabras clave de C# como identificadores. El carácter @

actúa como prefijo de un elemento de código que el compilador debe interpretar
como un identificador en lugar de como una palabra clave de C#. En el ejemplo
siguiente se usa el carácter @ para definir un identificador denominado for que se
usa en un bucle for .

C#

string[] @for = { "John", "James", "Joan", "Jamie" };

for (int ctr = 0; ctr < @for.Length; ctr++)

Console.WriteLine($"Here is your gift, {@for[ctr]}!");

// The example displays the following output:

// Here is your gift, John!

// Here is your gift, James!

// Here is your gift, Joan!

// Here is your gift, Jamie!

2. Para indicar que un literal de cadena se debe interpretar literalmente. El carácter @

de esta instancia define un literal de cadena textual. Las secuencias de escape
sencillas (como "\\" , que es una barra diagonal inversa), las secuencias de escape
hexadecimales (como "\x0041" , que es una A mayúscula) y las secuencias de
escape Unicode (como "\u0041" que es una A mayúscula) se interpretan
literalmente. Solo las secuencias de escape de comillas ( "" ) no se interpretan
literalmente, sino que generan comillas dobles. De igual modo, en el caso de una
cadena interpolada literal, las secuencias de escape de llave ( {{ y }} ) no se
interpretan literalmente, sino que generan caracteres de llave simple. En el
siguiente ejemplo se definen dos rutas de archivo idénticas, una mediante un
literal de cadena normal y otra mediante el uso de un literal de cadena textual.
Este es uno de los usos más comunes de los literales de cadena textual.

C#
 string filename1 = @"c:\documents\files\u0066.txt";

string filename2 = "c:\\documents\\files\\u0066.txt";

Console.WriteLine(filename1);

Console.WriteLine(filename2);

// The example displays the following output:

// c:\documents\files\u0066.txt

// c:\documents\files\u0066.txt

En el ejemplo siguiente se muestra el efecto de definir un literal de cadena normal

y un literal de cadena textual que contienen secuencias de caracteres idénticos.

C#

string s1 = "He said, \"This is the last \u0063hance\x0021\"";

string s2 = @"He said, ""This is the last \u0063hance\x0021""";

Console.WriteLine(s1);

Console.WriteLine(s2);

// The example displays the following output:

// He said, "This is the last chance!"

// He said, "This is the last \u0063hance\x0021"

3. Para permitir que el compilador distinga entre los atributos en caso de conflicto de
nomenclatura. Un atributo es una clase que deriva de Attribute. Normalmente, su
nombre de tipo incluye el sufijo Attribute, aunque el compilador no exige el
cumplimiento de esta convención. Es posible hacer referencia al atributo en el
código mediante su nombre de tipo completo (por ejemplo, [InfoAttribute] ) o
mediante su nombre abreviado (por ejemplo, [Info] ). Pero se produce un
conflicto de nomenclatura si dos nombres abreviados de tipo de atributo son
idénticos, y un nombre de tipo incluye el sufijo Attribute y el otro no. Por ejemplo,
el código siguiente produce un error al compilarse porque el compilador no puede
determinar si el atributo Info o InfoAttribute se aplica a la clase Example . Para
obtener más información, vea CS1614.

C#

using System;

[AttributeUsage(AttributeTargets.Class)]

public class Info : Attribute

private string information;

public Info(string info)

information = info;

[AttributeUsage(AttributeTargets.Method)]

public class InfoAttribute : Attribute

private string information;

public InfoAttribute(string info)

information = info;

[Info("A simple executable.")] // Generates compiler error CS1614.

Ambiguous Info and InfoAttribute.
// Prepend '@' to select 'Info' ([@Info("A simple executable.")]).
Specify the full name 'InfoAttribute' to select it.

public class Example

[InfoAttribute("The entry point.")]

public static void Main()

Consulte también
Referencia de C#
Guía de programación de C#
Caracteres especiales de C#
Atributos de nivel de ensamblado
interpretados por el compilador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

La mayoría de los atributos se aplican a elementos específicos del lenguaje, como las
clases o los métodos, aunque algunos atributos son globales (se aplican a todo un
ensamblado o módulo). Por ejemplo, el atributo AssemblyVersionAttribute se puede
usar para insertar información de versión en un ensamblado, como en este ejemplo:

C#

[assembly: AssemblyVersion("1.0.0.0")]

Los atributos globales aparecen en el código fuente después de cualquier directiva

using de nivel superior y antes de cualquier declaración de tipo, módulo o espacio de
nombres. Los atributos globales pueden aparecer en varios archivos de código fuente,
pero estos archivos se deben compilar en un solo paso de compilación. Visual Studio
agrega atributos globales al archivo AssemblyInfo.cs en proyectos de .NET Framework.
Estos atributos no se agregan a los proyectos de .NET Core.

Los atributos de ensamblado son valores que proporcionan información sobre un

ensamblado. Se dividen en las siguientes categorías:

Atributos de identidad del ensamblado

Atributos informativos
Atributos de manifiesto del ensamblado

Atributos de identidad del ensamblado

Tres atributos, con un nombre seguro (si procede), determinan la identidad de un
ensamblado: nombre, versión y referencia cultural. Estos atributos forman el nombre
completo del ensamblado y son necesarios cuando se hace referencia a este en el
código. Puede establecer la versión y la referencia cultural de un ensamblado mediante
atributos, pero el valor de nombre lo establece el compilador, el IDE de Visual Studio en
el cuadro de diálogo de información de ensamblado o la herramienta Assembly Linker
(Al.exe) cuando se crea el ensamblado. El nombre del ensamblado se basa en el
manifiesto del ensamblado. El atributo AssemblyFlagsAttribute especifica si pueden
coexistir varias copias del ensamblado.

En la siguiente tabla se muestran los atributos de identidad.

 Atributo Propósito

AssemblyVersionAttribute Especifica la versión de un ensamblado.

AssemblyCultureAttribute Especifica la cultura que admite el ensamblado.

AssemblyFlagsAttribute Especifica si un ensamblado admite la ejecución en paralelo en el

mismo equipo, en el mismo proceso o en el mismo dominio de
aplicación.

Atributos informativos
Puede usar atributos informativos para proporcionar información adicional de la
empresa o el producto para un ensamblado. En la tabla siguiente se muestran los
atributos informativos definidos en el espacio de nombres System.Reflection.

Atributo Propósito

AssemblyProductAttribute Especifica un nombre de producto para un manifiesto

del ensamblado.

AssemblyTrademarkAttribute Especifica una marca comercial para un manifiesto del

ensamblado.

AssemblyInformationalVersionAttribute Especifica una versión informativa para un manifiesto

del ensamblado.

AssemblyCompanyAttribute Especifica un nombre de empresa para un manifiesto

del ensamblado.

AssemblyCopyrightAttribute Define un atributo personalizado que especifica un

copyright para un manifiesto del ensamblado.

AssemblyFileVersionAttribute Establece un número de versión específico para el

recurso de versión de archivo Win32.

CLSCompliantAttribute Indica si el ensamblado es compatible con Common

Language Specification (CLS).

Atributos de manifiesto del ensamblado

Puede usar los atributos de manifiesto del ensamblado para proporcionar información
en el manifiesto del ensamblado Los atributos incluyen el título, la descripción, el alias
predeterminado y la configuración. En la tabla siguiente se muestran los atributos de
manifiesto del ensamblado definidos en el espacio de nombres System.Reflection.
Atributo Propósito

AssemblyTitleAttribute Especifica un título de ensamblado para un manifiesto del

ensamblado.

AssemblyDescriptionAttribute Especifica una descripción de ensamblado para un manifiesto

del ensamblado.

AssemblyConfigurationAttribute Especifica una configuración de ensamblado (por ejemplo,

comercial o depuración) para un manifiesto del ensamblado.

AssemblyDefaultAliasAttribute Define un alias descriptivo predeterminado para un manifiesto

del ensamblado.
Determinación de la información del
autor de la llamada mediante atributos
interpretados por el compilador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Mediante los atributos de información, se obtiene información sobre el autor de la

llamada a un método. Se obtiene la ruta de acceso al código fuente, el número de línea
del código fuente y el nombre de miembro del autor de la llamada. Para obtener la
información del llamador del miembro, use los atributos que se aplican a los parámetros
opcionales. Cada parámetro opcional especifica un valor predeterminado. En la tabla
siguiente se enumeran los atributos de información del llamador que se definen en el
espacio de nombres System.Runtime.CompilerServices:

Atributo Descripción Tipo

CallerFilePathAttribute Ruta de acceso completa del archivo de código String

fuente que contiene el llamador. La ruta de
acceso completa es la ruta de acceso en tiempo
de compilación.

CallerLineNumberAttribute Número de línea del archivo de código fuente Integer

desde el que se llama al método.

CallerMemberNameAttribute Nombre de método o de propiedad del String

llamador.

CallerArgumentExpressionAttribute Representación de cadena de la expresión de String

argumento.

Esta información ayuda con el seguimiento y la depuración, y permite crear

herramientas de diagnóstico. En el ejemplo siguiente se muestra cómo usar atributos de
información del autor de la llamada. En cada llamada al método TraceMessage , la
información del autor de la llamada se inserta como argumentos para los parámetros
opcionales.

C#

public void DoProcessing()

TraceMessage("Something happened.");

public void TraceMessage(string message,

[CallerMemberName] string memberName = "",

 [CallerFilePath] string sourceFilePath = "",

[CallerLineNumber] int sourceLineNumber = 0)

Trace.WriteLine("message: " + message);

Trace.WriteLine("member name: " + memberName);

Trace.WriteLine("source file path: " + sourceFilePath);

Trace.WriteLine("source line number: " + sourceLineNumber);

// Sample Output:

// message: Something happened.

// member name: DoProcessing

// source file path: c:\Visual Studio

Projects\CallerInfoCS\CallerInfoCS\Form1.cs

// source line number: 31

Debe especificar un valor predeterminado explícito para cada parámetro opcional. No

puede aplicar atributos de información del autor de la llamada a los parámetros que no
se especifican como opcionales. Los atributos de información del autor de la llamada no
crean un parámetro opcional, sino que influyen en el valor predeterminado que se pasa
cuando se omite el argumento. Los valores de información del autor de la llamada se
emiten como literales en el lenguaje intermedio (IL) en tiempo de compilación. A
diferencia de los resultados de la propiedad StackTrace para las excepciones, los
resultados no se ven afectados por confusión. Puede proporcionar explícitamente los
argumentos opcionales para controlar la información del llamador u ocultarla.

Nombres de miembro
Se puede utilizar el atributo CallerMemberName para evitar especificar el nombre de
miembro como un argumento String para el método llamado. Mediante esta técnica,
se evita el problema de que la refactorización de cambio de nombre no cambie los
valores String . Esta ventaja es especialmente útil para las siguientes tareas:

Usar el seguimiento y las rutinas de diagnóstico.

Implementar la interfaz INotifyPropertyChanged al enlazar datos. Esta interfaz
permite que la propiedad de un objeto notifique a un control enlazado que esta
propiedad ha cambiado. El control puede mostrar la información actualizada. Sin el
atributo CallerMemberName , se debe especificar el nombre de propiedad como un
literal.

En el gráfico siguiente se muestran los nombres de miembro que se devuelven cuando

se utiliza el atributo CallerMemberName .
 Las llamadas se Resultado del nombre de miembro
producen en

Método, propiedad o Nombre del método, propiedad o evento en el que se originó la

evento llamada.

Constructor Cadena ".ctor"

Constructor estático Cadena ".cctor"

Finalizador Cadena "Finalize"

Conversiones u Nombre generado para el miembro, por ejemplo, "op_Addition".

operadores definidos
por el usuario

Constructor de atributo Nombre del método o la propiedad a la que se aplica el atributo. Si el

atributo es cualquier elemento dentro de un miembro (como un
parámetro, un valor devuelto o un parámetro de tipo genérico), el
resultado es el nombre del miembro asociado a este elemento.

Ningún miembro El valor predeterminado del parámetro opcional.

contenedor (por
ejemplo, nivel de
ensamblado o atributos
que se aplican a tipos)

Expresiones de argumento
Se debe usar System.Runtime.CompilerServices.CallerArgumentExpressionAttribute
cuando quiera que la expresión se pase como argumento. Es posible que las bibliotecas
de diagnóstico quieran proporcionar más detalles sobre las expresiones que se pasan a
los argumentos. Al proporcionar la expresión que desencadenó el diagnóstico, además
del nombre del parámetro, los desarrolladores tienen más detalles sobre la condición
que desencadenó el diagnóstico. Esa información adicional facilita la corrección.

En el ejemplo siguiente se muestra cómo puede proporcionar información detallada

sobre el argumento cuando no es válido:

C#

public static void ValidateArgument(string parameterName, bool condition,

[CallerArgumentExpression("condition")] string? message=null)

if (!condition)

throw new ArgumentException($"Argument failed validation:

<{message}>", parameterName);

Se invocaría tal como se muestra en el ejemplo siguiente:

C#

public void Operation(Action func)

Utilities.ValidateArgument(nameof(func), func is not null);

func();

El compilador inserta la expresión usada para condition en el argumento message .

Cuando un desarrollador llama a Operation con un argumento null , el mensaje
siguiente se almacena en ArgumentException :

CLI de .NET

Argument failed validation: <func is not null>

Este atributo permite escribir utilidades de diagnóstico que proporcionan más detalles.
Los desarrolladores pueden comprender más rápidamente qué cambios son necesarios.
También puede usar CallerArgumentExpressionAttribute a fin de determinar qué
expresión se usó como receptor para los métodos de extensión. El método siguiente
muestrea una secuencia a intervalos regulares. Si la secuencia tiene menos elementos
que la frecuencia, notifica un error:

C#

public static IEnumerable<T> Sample<T>(this IEnumerable<T> sequence, int

frequency,

[CallerArgumentExpression(nameof(sequence))] string? message = null)

if (sequence.Count() < frequency)

throw new ArgumentException($"Expression doesn't have enough

elements: {message}", nameof(sequence));

int i = 0;

foreach (T item in sequence)

if (i++ % frequency == 0)

yield return item;

En el ejemplo anterior se usa el operador nameof para el parámetro sequence . Esa

característica está disponible en C# 11. Antes de C# 11, deberá escribir el nombre del
parámetro como una cadena. Se puede llamar a este método de la siguiente manera:

C#

sample = Enumerable.Range(0, 10).Sample(100);

En el ejemplo anterior se produciría un elemento ArgumentException cuyo mensaje es

el texto siguiente:

CLI de .NET

Expression doesn't have enough elements: Enumerable.Range(0, 10) (Parameter

'sequence')

Vea también
Argumentos opcionales y con nombre
System.Reflection
Attribute
Atributos
Atributos para el análisis estático de
estado NULL interpretados por el
compilador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 17 minutos

En un contexto habilitado que admite un valor NULL, el compilador realiza un análisis

estático del código para determinar el estado NULL de todas las variables de tipo de
referencia:

not-null: el análisis estático determina que la variable tiene un valor distinto de

NULL.
maybe-null: el análisis estático no puede determinar que a la variable se le asigna
un valor distinto de NULL.

Estos estados permiten al compilador proporcionar advertencias cuando se puede

desreferenciar un valor NULL, iniciando un objeto System.NullReferenceException. Estos
atributos proporcionan al compilador información semántica sobre el estado NULL de
los argumentos, los valores devueltos y los miembros de objeto en función del estado
de los argumentos y los valores devueltos. El compilador proporciona advertencias más
precisas cuando las API se han anotado correctamente con esta información semántica.

En este artículo se proporciona una breve descripción de cada uno de los atributos de
tipo de referencia que acepta valores NULL y cómo usarlos.

Comencemos con un ejemplo. Imagine que la biblioteca tiene la siguiente API para
recuperar una cadena de recursos. Este método se compiló originalmente en un
contexto de tipo "oblivious" que admite un valor NULL:

C#

bool TryGetMessage(string key, out string message)

if (_messageMap.ContainsKey(key))

message = _messageMap[key];

else

message = null;

return message != null;

En el ejemplo anterior se sigue el conocido patrón de Try* en .NET. Hay dos parámetros
de referencia para esta API: key y message . Esta API tiene las siguientes reglas
relacionadas con el estado NULL de estos parámetros:
 Los autores de la llamada no deben pasar null como argumento para key .
Los autores de la llamada pueden pasar una variable cuyo valor sea null como
argumento de message .
Si el método TryGetMessage devuelve true , el valor de message no es NULL. Si el
valor devuelto es false, , el valor de message es NULL.

La regla para key se puede expresar de forma sucinta: key debe ser un tipo de
referencia que no acepta valores NULL. El parámetro message es más complejo. Permite
una variable que sea null como argumento, pero garantiza que, si se ejecuta
correctamente, el argumento out no sea null . En estos escenarios, necesita un
vocabulario más completo para describir las expectativas. El atributo NotNullWhen , que
se describe a continuación, describe el estado NULL del argumento utilizado para el
parámetro message .

７ Nota

Al agregar estos atributos, se proporciona más información al compilador sobre las

reglas de la API. Cuando el código que realiza la llamada se compila en un contexto
habilitado para aceptar valores NULL, el compilador advertirá a los autores de la
llamada cuando infrinjan esas reglas. Estos atributos no habilitan más
comprobaciones en la implementación.

Atributo Category Significado

AllowNull Condición previa Un parámetro, campo o propiedad que no

acepta valores NULL puede ser NULL.

DisallowNull Condición previa Un parámetro, campo o propiedad que acepta

valores NULL nunca debe ser NULL.

MaybeNull Condición posterior Un parámetro, campo, propiedad o valor

devuelto que no acepta valores NULL puede ser
NULL.

NotNull Condición posterior Un parámetro, campo, propiedad o valor

devuelto que acepta valores NULL nunca será
NULL.

MaybeNullWhen Condición posterior Un argumento que no acepta valores NULL

condicional puede ser NULL cuando el método devuelve el
valor bool especificado.
 Atributo Category Significado

NotNullWhen Condición posterior Un argumento que admite un valor NULL nunca

condicional será NULL cuando el método devuelva el valor
bool especificado.

NotNullIfNotNull Condición posterior Un valor devuelto, propiedad o argumento no es

condicional NULL si el argumento del parámetro especificado
no es NULL.

MemberNotNull Métodos del el miembro de la lista no será NULL cuando el

asistente para método devuelva un valor.
propiedades y
métodos

MemberNotNullWhen Métodos del el miembro de la lista no será NULL cuando el

asistente para método devuelva el valor bool especificado.
propiedades y
métodos

DoesNotReturn Código inaccesible Un método o propiedad nunca devuelve valores.

Es decir, siempre inicia una excepción.

DoesNotReturnIf Código inaccesible Este método o propiedad nunca devuelve un

valor si el parámetro bool asociado tiene el valor
especificado.

Las descripciones anteriores son una referencia rápida a lo que hace cada atributo. En
las secciones siguientes se describe el comportamiento y el significado de estos
atributos de forma más exhaustiva.

Condiciones previas: AllowNull y DisallowNull

Considere una propiedad de lectura y escritura que nunca devuelve null porque tiene
un valor predeterminado razonable. Los autores de la llamada pasan null al descriptor
de acceso set cuando lo establecen en el valor predeterminado. Por ejemplo, imagine un
sistema de mensajería que solicita un nombre de pantalla en un salón de chat. Si no se
proporciona ninguno, el sistema genera uno aleatorio:

C#

public string ScreenName

get => _screenName;

set => _screenName = value ?? GenerateRandomScreenName();

private string _screenName;

Al compilar el código anterior en un contexto en el que se desconocen los valores NULL,

todo es correcto. Una vez que se habilitan los tipos de referencia que admiten un valor
NULL, la propiedad ScreenName se convierte en una referencia que no acepta valores
NULL. Eso es correcto para el descriptor de acceso get : nunca devuelve null . No es
necesario que los autores de la llamada comprueben null en la propiedad devuelta.
Pero ahora, al establecer la propiedad en null , se genera una advertencia. Para admitir
este tipo de código, agregue el atributo
System.Diagnostics.CodeAnalysis.AllowNullAttribute a la propiedad, como se muestra en
el código siguiente:

C#

[AllowNull]

public string ScreenName

get => _screenName;

set => _screenName = value ?? GenerateRandomScreenName();

private string _screenName = GenerateRandomScreenName();

Es posible que tenga que agregar una directiva using para

System.Diagnostics.CodeAnalysis a fin de usar este y otros atributos descritos en este
artículo. El atributo se aplica a la propiedad, no al descriptor de acceso set . El atributo
AllowNull especifica condiciones previas y solo se aplica a los argumentos. El descriptor

de acceso get tiene un valor devuelto, pero no parámetros. Por tanto, el atributo
AllowNull solo se aplica al descriptor de acceso set .

En el ejemplo anterior se muestra qué se debe buscar al agregar el atributo AllowNull

en un argumento:

1. El contrato general para esa variable es que no debe ser null , por lo que quiere
un tipo de referencia que no acepte valores NULL.
2. Existen escenarios para que un autor de llamada pase null como argumento,
aunque no son el uso más común.

En la mayoría de los casos necesitará este atributo para las propiedades, o bien para los
argumentos in , out y ref . El atributo AllowNull es la mejor opción cuando una
variable normalmente no es NULL, pero debe permitir null como condición previa.

Compare esto con los escenarios donde se usa DisallowNull : este atributo se usa para
especificar que un argumento de un tipo de referencia que admite un valor NULL no
deba ser null . Considere una propiedad donde null es el valor predeterminado, pero
los clientes solo pueden establecerla en un valor que no sea NULL. Observe el código
siguiente:

C#

public string ReviewComment

get => _comment;

set => _comment = value ?? throw new

ArgumentNullException(nameof(value), "Cannot set to null");

string _comment;

El código anterior es la mejor manera de expresar el diseño de que ReviewComment

pueda ser null , pero no se puede establecer en null . Una vez que este código admita
valores NULL, puede expresar este concepto con más claridad para los autores de la
llamada mediante System.Diagnostics.CodeAnalysis.DisallowNullAttribute:

C#

[DisallowNull]

public string? ReviewComment

get => _comment;

set => _comment = value ?? throw new

ArgumentNullException(nameof(value), "Cannot set to null");

string? _comment;

En un contexto que admite valores NULL, el descriptor de acceso get de ReviewComment

podría devolver el valor predeterminado de null . El compilador advierte que se debe
comprobar antes del acceso. Además, advierte a los autores de la llamada que, aunque
podría ser null , no deberían establecerlo de forma explícita en null . El atributo
DisallowNull también especifica una condición previa, no afecta al descriptor de acceso
get . Use el atributo DisallowNull cuando observe estas características:

1. La variable podría ser null en escenarios principales, a menudo cuando se crea su

primera instancia.
2. La variable no se debe establecer de forma explícita en null .

Estas situaciones son comunes en el código en el que originalmente se desconocían los

valores NULL. Es posible que las propiedades de objeto se establezcan en dos
operaciones de inicialización distintas. Es posible que algunas propiedades se
establezcan solo después de que se haya completado algún trabajo asincrónico.
Los atributos AllowNull y DisallowNull permiten especificar que las condiciones previas
de las variables puedan no coincidir con las anotaciones que admiten un valor NULL en
esas variables. Proporcionan más detalles sobre las características de la API. Esta
información adicional ayuda a los autores de la llamada a usar la API de manera
correcta. Recuerde que debe especificar las condiciones previas mediante los atributos
siguientes:

AllowNull: un argumento que no acepta valores NULL puede ser NULL.

DisallowNull: un argumento que admite un valor NULL nunca debe ser NULL.

Condiciones posteriores: MaybeNull y NotNull

Imagine que tiene un método con la siguiente firma:

C#

public Customer FindCustomer(string lastName, string firstName)

Probablemente haya escrito un método como este para devolver null cuando no se
encuentra el nombre que se busca. null indica claramente que no se ha encontrado el
registro. En este ejemplo, es probable que cambie el tipo de valor devuelto de Customer
a Customer? . Al declarar el valor devuelto como un tipo de referencia que admite un
valor NULL, se especifica claramente la intención de esta API:

C#

public Customer? FindCustomer(string lastName, string firstName)

Por motivos que se tratan en Tipos de referencia que aceptan valores NULL - Genéricos,
es posible que esa técnica no produzca el análisis estático que coincida con la API.
Puede tener un método genérico que siga un patrón similar:

C#

public T Find<T>(IEnumerable<T> sequence, Func<T, bool> predicate)

El método devuelve null cuando no se encuentra el elemento buscado. Puede aclarar

que el método devuelve null cuando no se encuentra un elemento agregando la
anotación MaybeNull a la devolución del método:

C#
 [return: MaybeNull]

public T Find<T>(IEnumerable<T> sequence, Func<T, bool> predicate)

El código anterior informa a los autores de la llamada de que el valor devuelto puede
realmente ser NULL. También informa al compilador de que el método puede devolver
una expresión null aunque el tipo no acepte valores NULL. Si tiene un método
genérico que devuelve una instancia de su parámetro de tipo, T , puede expresar que
nunca devuelve null mediante el atributo NotNull .

También puede especificar que un valor devuelto o un argumento no sean NULL aunque
el tipo sea un tipo de referencia que admite un valor NULL. El método siguiente es un
método auxiliar que se produce si su primer argumento es null :

C#

public static void ThrowWhenNull(object value, string valueExpression = "")

if (value is null) throw new ArgumentNullException(nameof(value),

valueExpression);

Puede llamar a esta rutina de esta forma:

C#

public static void LogMessage(string? message)

ThrowWhenNull(message, $"{nameof(message)} must not be null");

Console.WriteLine(message.Length);

Después de habilitar los tipos de referencia NULL, querrá asegurarse de que el código
anterior se compila sin advertencias. Cuando el método devuelve un valor, se garantiza
que el parámetro value no es NULL. Pero es aceptable llamar a ThrowWhenNull con una
referencia nula. Puede convertir a value en un tipo de referencia que acepte valores
NULL y agregar la condición posterior NotNull a la declaración del parámetro:

C#

public static void ThrowWhenNull([NotNull] object? value, string

valueExpression = "")

_ = value ?? throw new ArgumentNullException(nameof(value),

 valueExpression);

// other logic elided

En el código anterior se expresa con claridad el contrato existente: los autores de la

llamada pueden pasar una variable con el valor null , pero se garantiza que el valor
devuelto nunca será NULL.

Las condiciones posteriores condicionales se especifican mediante los atributos

siguientes:

MaybeNull: un valor devuelto que no acepta valores NULL puede ser NULL.
NotNull: un valor devuelto que admite un valor NULL nunca será NULL.

Condiciones posteriores condicionales:

NotNullWhen , MaybeNullWhen y NotNullIfNotNull
Es probable que esté familiarizado con el método string de
String.IsNullOrEmpty(String). Este método devuelve true cuando el argumento es NULL
o una cadena vacía. Es una forma de comprobación de valores NULL: No es necesario
que los autores de la llamada comprueben los valores NULL del argumento si el método
devuelve false . Para hacer que un método como este admita valores NULL, tendría que
establecer el argumento en un tipo de referencia que admite un valor NULL y agregar el
atributo NotNullWhen :

C#

bool IsNullOrEmpty([NotNullWhen(false)] string? value)

Esto informa al compilador de que no es necesario comprobar los valores NULL en el

código cuyo valor devuelto sea false . La adición del atributo informa al análisis estático
del compilador que IsNullOrEmpty realiza la comprobación de valores NULL necesaria:
cuando devuelve false , el argumento no es null .

C#

string? userInput = GetUserInput();

if (!string.IsNullOrEmpty(userInput))

int messageLength = userInput.Length; // no null check needed.

// null check needed on userInput here.

El método String.IsNullOrEmpty(String) se anotará como se ha mostrado antes para

.NET Core 3.0. Es posible que tenga métodos similares en el código base que
comprueben valores NULL en el estado de los objetos. El compilador no reconocerá los
métodos de comprobación de valores NULL personalizados y tendrá que agregar
personalmente las anotaciones. Al agregar el atributo, el análisis estático del compilador
sabe cuándo se han comprobado los valores NULL en la variable.

Otro uso de estos atributos es el patrón Try* . Las condiciones posteriores para los
argumentos ref y out se comunican a través del valor devuelto. Considere este
método mostrado anteriormente (en un contexto deshabilitado que admite un valor
NULL):

C#

bool TryGetMessage(string key, out string message)

if (_messageMap.ContainsKey(key))

message = _messageMap[key];

else

message = null;

return message != null;

El método anterior sigue una expresión de .NET típica: el valor devuelto indica si
message se ha establecido en el valor encontrado o, si no se ha encontrado ningún

mensaje, en el valor predeterminado. Si el método devuelve true , el valor de message

no es NULL; de lo contrario, el método establece message en NULL.

En un contexto habilitado que admite un valor NULL, puede comunicar esa expresión
mediante el atributo NotNullWhen . Al anotar parámetros para los tipos de referencia que
admiten un valor NULL, convierta message en string? y agregue un atributo:

C#

bool TryGetMessage(string key, [NotNullWhen(true)] out string? message)

if (_messageMap.ContainsKey(key))

message = _messageMap[key];

else

message = null;

return message is not null;

En el ejemplo anterior, se sabe que el valor de message no es NULL cuando

TryGetMessage devuelve true . Debe anotar de la misma forma los métodos similares en
el código base: los argumentos pueden ser iguales a null , y se sabe que no son NULL
cuando el método devuelve true .

Hay un atributo final que también puede necesitar. En ocasiones, el estado NULL de un
valor devuelto depende del estado NULL de uno o más argumentos. Estos métodos
devolverán un valor no NULL siempre que determinados argumentos no sean null .
Para anotar correctamente estos métodos, use el atributo NotNullIfNotNull . Observe el
método siguiente:

C#

string GetTopLevelDomainFromFullUrl(string url)

Si el argumento url no es NULL, el resultado no es null . Una vez habilitadas las

referencias que admiten un valor NULL, debe agregar más anotaciones si la API puede
aceptar un argumento NULL. Puede anotar el tipo de valor devuelto como se muestra
en el código siguiente:

C#

string? GetTopLevelDomainFromFullUrl(string? url)

Esto también funciona, pero a menudo obliga a los autores de la llamada a implementar
comprobaciones de null adicionales. El contrato es que el valor devuelto solo será
null cuando el argumento url sea null . Para expresar ese contrato, tendría que
anotar este método como se muestra en el código siguiente:

C#

[return: NotNullIfNotNull(nameof(url))]

string? GetTopLevelDomainFromFullUrl(string? url)

En el ejemplo anterior se usa el operador nameof para el parámetro url . Esa

característica está disponible en C# 11. Antes de C# 11, deberá escribir el nombre del
parámetro como una cadena. El valor devuelto y el argumento se han anotado con ? , lo
que indica que cualquiera podría ser null . El atributo aclara todavía más que el valor
devuelto no será NULL cuando el argumento url no sea null .

Las condiciones posteriores condicionales se especifican mediante estos atributos:

MaybeNullWhen: un argumento que no acepta valores NULL puede ser NULL

cuando el método devuelve el valor bool especificado.
 NotNullWhen: un argumento que admite un valor NULL nunca será NULL cuando
el método devuelva el valor bool especificado.
NotNullIfNotNull: un valor devuelto no es NULL si el argumento del parámetro
especificado no es NULL.

Métodos del asistente : MemberNotNull y

MemberNotNullWhen
Estos atributos especifican su intención cuando se ha refactorizado código común de
los constructores en métodos auxiliares. El compilador de C# analiza los constructores y
los inicializadores de campo para asegurarse de que todos los campos de referencia que
no aceptan valores NULL se han inicializado antes de que se devuelva cada constructor.
Sin embargo, el compilador de C# no realiza un seguimiento de las asignaciones de
campo a través de todos los métodos auxiliares. El compilador emite una advertencia
CS8618 cuando los campos no se inicializan directamente en el constructor, sino en un
método auxiliar. Agregue MemberNotNullAttribute a una declaración de método y
especifique los campos que se inicializan en un valor distinto de NULL en el método. Por
ejemplo, considere el siguiente ejemplo:

C#

public class Container

private string _uniqueIdentifier; // must be initialized.

private string? _optionalMessage;

public Container()

Helper();

public Container(string message)

Helper();

_optionalMessage = message;

[MemberNotNull(nameof(_uniqueIdentifier))]

private void Helper()

_uniqueIdentifier = DateTime.Now.Ticks.ToString();

Puede especificar varios nombres de campo como argumentos para el constructor de

atributo MemberNotNull .

MemberNotNullWhenAttribute tiene un argumento bool . Utiliza MemberNotNullWhen en

situaciones en las que el método auxiliar devuelve bool , lo cual indica si el método
auxiliar ha inicializado los campos.

Detención del análisis que admite un valor

NULL cuando un método al que se le llama
genera un valor
Algunos métodos, normalmente los asistentes de excepciones u otros métodos de
utilidad, siempre salen mediante el inicio de una excepción. O bien, un asistente puede
iniciar una excepción basada en el valor de un argumento booleano.

En el primer caso, puede agregar el atributo DoesNotReturnAttribute a la declaración

del método. El análisis del estado NULL del compilador no comprueba ningún código de
un método que siga una llamada a un método anotado con DoesNotReturn . Considere
este método:

C#

[DoesNotReturn]

private void FailFast()

throw new InvalidOperationException();

public void SetState(object containedField)

if (containedField is null)

FailFast();

// containedField can't be null:

_field = containedField;

El compilador no emite ninguna advertencia después de la llamada a FailFast .

En el segundo caso, se agrega el atributo

System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute a un parámetro booleano
del método. Puede modificar el ejemplo anterior de esta manera:
 C#

private void FailFastIf([DoesNotReturnIf(true)] bool isNull)

if (isNull)

throw new InvalidOperationException();

public void SetFieldState(object? containedField)

FailFastIf(containedField == null);

// No warning: containedField can't be null here:

_field = containedField;

Cuando el valor del argumento coincide con el valor del constructor DoesNotReturnIf , el
compilador no realiza ningún análisis de estado NULL después de ese método.

Resumen
Agregar tipos de referencia que aceptan valores NULL proporciona un vocabulario
inicial para describir las expectativas de las API para las variables que podrían ser null .
Los atributos proporcionan un vocabulario más completo para describir el estado NULL
de las variables como condiciones previas y posteriores. Estos atributos describen con
más claridad las expectativas y proporcionan una mejor experiencia para los
desarrolladores que usan las API.

A medida que actualice las bibliotecas para un contexto que admite un valor NULL,
agregue estos atributos para guiar a los usuarios de las API al uso correcto. Estos
atributos ayudan a describir de forma completa el estado NULL de los argumentos y los
valores devueltos.

AllowNull: un campo, parámetro o propiedad que no admite un valor NULL puede

ser NULL.
DisallowNull: un campo, parámetro o propiedad que admite un valor NULL nunca
debe ser NULL.
MaybeNull: un campo, parámetro, propiedad o valor devuelto que no acepta
valores NULL puede ser NULL.
NotNull: un campo, parámetro, propiedad o valor devuelto que admite un valor
NULL nunca será NULL.
MaybeNullWhen: un argumento que no acepta valores NULL puede ser NULL
cuando el método devuelve el valor bool especificado.
NotNullWhen: un argumento que admite un valor NULL nunca será NULL cuando
el método devuelva el valor bool especificado.
NotNullIfNotNull: un parámetro, propiedad o valor devuelto no es NULL si el
argumento del parámetro especificado no es NULL.
DoesNotReturn; un método o propiedad nunca devuelve valores. Es decir, siempre
inicia una excepción.
DoesNotReturnIf: este método nunca devuelve un valor si el parámetro bool
asociado tiene el valor especificado.
Varios atributos interpretados por el
compilador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 11 minutos

Los atributos Conditional , Obsolete , AttributeUsage , AsyncMethodBuilder ,

InterpolatedStringHandler y ModuleInitializer se pueden aplicar a los elementos del

código. Agregan significado semántico a esos elementos. El compilador usa esos

significados semánticos para modificar su salida e informar de los posibles errores por
parte de los desarrolladores que usan el código.

Atributo Conditional
El atributo Conditional hace que la ejecución de un método dependa de un
identificador de preprocesamiento. El atributo Conditional es un alias de
ConditionalAttribute y se puede aplicar a un método o a una clase de atributo.

En el ejemplo siguiente, Conditional se aplica a un método para habilitar o deshabilitar

la representación de información de diagnóstico específica del programa:

C#

#define TRACE_ON

using System.Diagnostics;

namespace AttributeExamples;

public class Trace

[Conditional("TRACE_ON")]

public static void Msg(string msg)

Console.WriteLine(msg);

public class TraceExample

public static void Main()

Trace.Msg("Now in Main...");

Console.WriteLine("Done.");

Si no se define el identificador TRACE_ON , no se muestra el resultado del seguimiento.

Explore por sí mismo en la ventana interactiva.

El atributo Conditional se suele usar con el identificador DEBUG para habilitar las
funciones de seguimiento y de registro para las compilaciones de depuración, pero no
en las compilaciones de versión, como se muestra en el ejemplo siguiente:

C#

[Conditional("DEBUG")]

static void DebugMethod()

Al llamar a un método marcado como condicional, la presencia o ausencia del símbolo

de preprocesamiento especificado determina si el compilador incluye u omite la llamada
al método. Si el símbolo está definido, se incluye la llamada; de lo contrario, se omite la
llamada. Un método condicional debe ser un método de una declaración de clase o
estructura, y no debe tener un tipo de valor devuelto void . El uso de Conditional
resulta más limpio y elegante, y menos propenso a generar errores que incluir los
métodos dentro de bloques #if…#endif .

Si un método tiene varios atributos Conditional , el compilador incluye llamadas al

método si se define uno o más símbolos condicionales (los símbolos se vinculan de
manera lógica entre sí mediante el operador OR). En el ejemplo siguiente, la presencia
de A o B da como resultado una llamada al método:

C#

[Conditional("A"), Conditional("B")]

static void DoIfAorB()

// ...

Uso de Conditional con clases de atributos

El atributo Conditional también se puede aplicar a una definición de clase de atributo.
En el ejemplo siguiente, el atributo personalizado Documentation solo agregará
información a los metadatos si se define DEBUG .

C#
 [Conditional("DEBUG")]

public class DocumentationAttribute : System.Attribute

string text;

public DocumentationAttribute(string text)

{

this.text = text;

class SampleClass

// This attribute will only be included if DEBUG is defined.

[Documentation("This method displays an integer.")]

static void DoWork(int i)

System.Console.WriteLine(i.ToString());

Atributo Obsolete
El atributo Obsolete marca un elemento de código como ya no recomendado para su
uso. El uso de una entidad marcada como obsoleta genera una advertencia o un error.
El atributo Obsolete es un atributo de uso único y se puede aplicar a cualquier entidad
que admita atributos. Obsolete es un alias de ObsoleteAttribute.

En el ejemplo siguiente, el atributo Obsolete se aplica a la clase A y al método

B.OldMethod . Dado que el segundo argumento del constructor de atributos aplicado a
B.OldMethod está establecido en true , este método producirá un error del compilador,

mientras que, si se usa la clase A , solo se generará una advertencia. En cambio, si se

llama a B.NewMethod , no se generará ninguna advertencia o error. Por ejemplo, al usarla
con las definiciones anteriores, el código siguiente genera dos advertencias y un error:

C#

namespace AttributeExamples

[Obsolete("use class B")]

public class A

public void Method() { }

public class B

[Obsolete("use NewMethod", true)]

public void OldMethod() { }

public void NewMethod() { }

public static class ObsoleteProgram

public static void Main()

// Generates 2 warnings:

A a = new A();

// Generate no errors or warnings:

B b = new B();

b.NewMethod();

// Generates an error, compilation fails.

// b.OldMethod();

La cadena proporcionada como primer argumento al constructor del atributo se

mostrará como parte de la advertencia o el error. Se generan dos advertencias para la
clase A : una para la declaración de la referencia de clase y otra para el constructor de
clases. El atributo Obsolete se puede usar sin argumentos, pero se recomienda incluir
una explicación de qué se debe usar en su lugar.

En C# 10, puede usar la interpolación de cadenas constantes y el operador nameof para

asegurarse de que los nombres coinciden:

C#

public class B

[Obsolete($"use {nameof(NewMethod)} instead", true)]

public void OldMethod() { }

public void NewMethod() { }

Atributo SetsRequiredMembers
El atributo SetsRequiredMembers informa al compilador de que un constructor establece
todos los miembros required de esa clase o estructura. El compilador supone que
cualquier constructor con el atributo
System.Diagnostics.CodeAnalysis.SetsRequiredMembersAttribute inicializa todos los
miembros required . Cualquier código que invoque este constructor no necesita
inicializadores de objeto para establecer los miembros necesarios. Esto es
principalmente útil para los registros posicionales y los constructores principales.

Atributo AttributeUsage
El atributo AttributeUsage determina cómo se puede usar una clase de atributo
personalizado. AttributeUsageAttribute es un atributo que se aplica a las definiciones de
atributo personalizado. El atributo AttributeUsage permite controlar lo siguiente:

Los atributos de elementos de programa que se pueden aplicar. A menos que el

uso esté restringido, un atributo se puede aplicar a cualquiera de los siguientes
elementos de programa:
Ensamblado
Módulo
Campo
Evento
Método
Parámetro
Propiedad
Valor devuelto
Tipo
Si un atributo se puede aplicar a un mismo elemento de programa varias veces.
Si las clases derivadas heredan atributos.

La configuración predeterminada se parece al siguiente ejemplo cuando se aplica

explícitamente:

C#

[AttributeUsage(AttributeTargets.All,

AllowMultiple = false,

Inherited = true)]

class NewAttribute : Attribute { }

En este ejemplo, la clase NewAttribute se puede aplicar a cualquier elemento de

programación compatible, pero solamente se puede aplicar una vez a cada entidad. Las
clases derivadas heredan el atributo cuando se aplica a una clase base.
Los argumentos AllowMultiple y Inherited son opcionales, por lo que el siguiente código
tiene el mismo efecto:

C#

[AttributeUsage(AttributeTargets.All)]

class NewAttribute : Attribute { }

El primer argumento AttributeUsageAttribute debe ser uno o varios elementos de la

enumeración AttributeTargets. Se pueden vincular diversos tipos de destino con el
operador OR, como se refleja en el siguiente ejemplo:

C#

[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]

class NewPropertyOrFieldAttribute : Attribute { }

Los atributos se pueden aplicar a la propiedad o el campo de respaldo de una

propiedad implementada automáticamente. El atributo se aplica a la propiedad, a
menos que se indique el especificador field en el atributo. Ambos se muestran en el
siguiente ejemplo:

C#

class MyClass

// Attribute attached to property:

[NewPropertyOrField]

public string Name { get; set; } = string.Empty;

// Attribute attached to backing field:

[field: NewPropertyOrField]

public string Description { get; set; } = string.Empty;

Si el argumento AllowMultiple es true , el atributo resultante se puede aplicar más de

una vez a cada una de las entidades, como se muestra en el siguiente ejemplo:

C#

[AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]

class MultiUse : Attribute { }

[MultiUse]

[MultiUse]

class Class1 { }

 [MultiUse, MultiUse]

class Class2 { }

En este caso, MultiUseAttribute se puede aplicar varias veces porque AllowMultiple

está establecido en true . Los dos formatos mostrados para aplicar varios atributos son
válidos.

Si Inherited se establece en false , las clases que se derivan de una clase con atributos
no heredan el atributo. Por ejemplo:

C#

[AttributeUsage(AttributeTargets.Class, Inherited = false)]

class NonInheritedAttribute : Attribute { }

[NonInherited]

class BClass { }

class DClass : BClass { }

En este caso, NonInheritedAttribute no se aplica a DClass a través de la herencia.

También puede usar estas palabras clave para especificar dónde se debe aplicar un
atributo. Por ejemplo, puede usar el especificador field: para agregar un atributo al
campo de respaldo de una propiedad implementada automáticamente. También puede
usar el especificador field: , property: o param: para aplicar un atributo a cualquiera
de los elementos generados a partir de un registro posicional. Para obtener un ejemplo,
vea Sintaxis posicional para la definición de propiedades.

Atributo AsyncMethodBuilder
El atributo System.Runtime.CompilerServices.AsyncMethodBuilderAttribute se agrega a
un tipo que puede ser un tipo de valor devuelto asincrónico. El atributo especifica el
tipo que compila la implementación del método asincrónico cuando se devuelve el tipo
especificado desde un método asincrónico. El atributo AsyncMethodBuilder se puede
aplicar a un tipo que:

Tiene un método GetAwaiter accesible.

El objeto devuelto por el método GetAwaiter implementa la interfaz
System.Runtime.CompilerServices.ICriticalNotifyCompletion.

El constructor del atributo AsyncMethodBuilder especifica el tipo del generador asociado.

El generador debe implementar los siguientes miembros accesibles:
 Un método Create() estático que devuelve el tipo del compilador.

Una propiedad Task legible que devuelve el tipo de valor devuelto asincrónico.

Un método void SetException(Exception) que establece la excepción cuando se

produce un error en una tarea.

Un método void SetResult() o void SetResult(T result) que marca la tarea

como completada y, opcionalmente, establece el resultado de la tarea.

Un método Start con la signatura de API siguiente:

C#

void Start<TStateMachine>(ref TStateMachine stateMachine)

where TStateMachine :
System.Runtime.CompilerServices.IAsyncStateMachine

un método AwaitOnCompleted con la signatura siguiente:

C#

public void AwaitOnCompleted<TAwaiter, TStateMachine>(ref TAwaiter

awaiter, ref TStateMachine stateMachine)

where TAwaiter : System.Runtime.CompilerServices.INotifyCompletion

where TStateMachine :
System.Runtime.CompilerServices.IAsyncStateMachine

un método AwaitUnsafeOnCompleted con la signatura siguiente:

C#

public void AwaitUnsafeOnCompleted<TAwaiter, TStateMachine>(ref

TAwaiter awaiter, ref TStateMachine stateMachine)

where TAwaiter :
System.Runtime.CompilerServices.ICriticalNotifyCompletion

where TStateMachine :
System.Runtime.CompilerServices.IAsyncStateMachine

Para obtener información sobre los generadores de métodos asincrónicos, lea sobre los
generadores siguientes proporcionados por .NET:

System.Runtime.CompilerServices.AsyncTaskMethodBuilder
System.Runtime.CompilerServices.AsyncTaskMethodBuilder<TResult>
System.Runtime.CompilerServices.AsyncValueTaskMethodBuilder
System.Runtime.CompilerServices.AsyncValueTaskMethodBuilder<TResult>
En C# 10 y versiones posteriores, el atributo AsyncMethodBuilder se puede aplicar a un
método asincrónico para invalidar el generador de ese tipo.

Atributos InterpolatedStringHandler y
InterpolatedStringHandlerArguments
A partir de C# 10, se usan estos atributos para especificar que un tipo es un controlador
de cadenas interpoladas. La biblioteca de .NET 6 ya incluye
System.Runtime.CompilerServices.DefaultInterpolatedStringHandler para escenarios en
los que se usa una cadena interpolada como argumento para un parámetro string . Es
posible que tenga otras instancias en las que quiera controlar cómo se procesan las
cadenas interpoladas. Aplique
System.Runtime.CompilerServices.InterpolatedStringHandlerAttribute al tipo que
implementa el controlador. Aplique
System.Runtime.CompilerServices.InterpolatedStringHandlerArgumentAttribute a los
parámetros del constructor de ese tipo.

Puede obtener más información sobre la creación de un controlador de cadenas

interpoladas en la especificación de características de C# 10 sobre las mejoras de
cadenas interpoladas.

Atributo ModuleInitializer
A partir de C# 9, el atributo ModuleInitializer marca un método al que el entorno de
ejecución llama cuando se carga el ensamblado. ModuleInitializer es un alias de
ModuleInitializerAttribute.

El atributo ModuleInitializer solo se puede aplicar a un método que:

Sea estático.
No tenga parámetros.
Devuelve void .
Sea accesible desde el módulo contenedor, es decir, internal o public .
No sea un método genérico.
No esté incluido en una clase genérica.
No sea una función local.

El atributo ModuleInitializer se puede aplicar a varios métodos. En ese caso, el orden

de llamada desde el entorno de ejecución es determinista pero no se especifica.
En el ejemplo siguiente se muestra el uso de varios métodos de inicializador de módulo.
Los métodos Init1 y Init2 se ejecutan antes que Main y cada uno agrega una cadena
a la propiedad Text . Por tanto, cuando se ejecuta Main , la propiedad Text ya tiene
cadenas de los dos métodos de inicializador.

C#

using System;

internal class ModuleInitializerExampleMain

public static void Main()

Console.WriteLine(ModuleInitializerExampleModule.Text);

//output: Hello from Init1! Hello from Init2!

C#

using System.Runtime.CompilerServices;

internal class ModuleInitializerExampleModule

public static string? Text { get; set; }

[ModuleInitializer]

public static void Init1()

Text += "Hello from Init1! ";

[ModuleInitializer]

public static void Init2()

Text += "Hello from Init2! ";

En ocasiones los generadores de código deben generar código de inicialización. Los

inicializadores de módulos proporcionan una ubicación estándar para ese código. En la
mayoría de los demás casos, debe escribir un constructor estático en lugar de un
inicializador de módulo.

Atributo SkipLocalsInit
A partir de C# 9, el atributo SkipLocalsInit impide que el compilador establezca la
marca .locals init cuando se realiza la emisión a metadatos. SkipLocalsInit es un
atributo de uso único y se puede aplicar a un método, una propiedad, una clase, una
estructura, una interfaz o un módulo, pero no a un ensamblado. SkipLocalsInit es un
alias de SkipLocalsInitAttribute.

La marca .locals init hace que el CLR inicialice todas las variables locales declaradas
en un método en sus valores predeterminados. Como el compilador también se asegura
de que nunca se use una variable antes de asignarle un valor, .locals init no suele ser
necesario. Pero la inicialización en cero adicional puede afectar al rendimiento en
algunos escenarios, como cuando se usa stackalloc para asignar una matriz en la pila. En
esos casos, puede agregar el atributo SkipLocalsInit . Si se aplica directamente a un
método, el atributo afecta a ese método y a todas sus funciones anidadas, incluidas las
expresiones lambda y las funciones locales. Si se aplica a un tipo o un módulo, afecta a
todos los métodos anidados. Este atributo no afecta a los métodos abstractos, pero sí al
código generado para la implementación.

Este atributo necesita la opción del compilador AllowUnsafeBlocks. Este requisito indica
que, en algunos casos, el código podría ver la memoria no asignada (por ejemplo, la
lectura de la memoria asignada a la pila no inicializada).

En el ejemplo siguiente se muestra el efecto del atributo SkipLocalsInit en un método

que usa stackalloc . El método muestra lo que hubiera en la memoria al asignar la
matriz de enteros.

C#

[SkipLocalsInit]

static void ReadUninitializedMemory()

Span<int> numbers = stackalloc int[120];

for (int i = 0; i < 120; i++)

Console.WriteLine(numbers[i]);

// output depends on initial contents of memory, for example:

//0

//0

//0

//168

//0

//-1271631451

//32767

//38

//0

//0

 //0

//38

// Remaining rows omitted for brevity.

Para probar este código, establezca la opción del compilador AllowUnsafeBlocks en el

archivo .csproj:

XML

<PropertyGroup>

...

<AllowUnsafeBlocks>true</AllowUnsafeBlocks>

</PropertyGroup>

Vea también
Attribute
System.Reflection
Atributos
Reflexión
Código no seguro, tipos de puntero y
punteros de función
Artículo • 15/02/2023 • Tiempo de lectura: 14 minutos

La mayor parte del código de C# que se escribe es "código seguro comprobable". El

código seguro comprobable significa que las herramientas de .NET pueden comprobar
que el código es seguro. En general, el código seguro no accede directamente a la
memoria mediante punteros. Tampoco asigna memoria sin procesar. En su lugar, crea
objetos administrados.

C# admite un contexto unsafe, en el que se puede escribir código no comprobable. En

un contexto unsafe , el código puede usar punteros, asignar y liberar bloques de
memoria y llamar a métodos mediante punteros de función. El código no seguro en C#
no es necesariamente peligroso; solo es código cuya seguridad no se puede comprobar.

El código no seguro tiene las propiedades siguientes:

Los métodos, tipos y bloques de código se pueden definir como no seguros.

En algunos casos, el código no seguro puede aumentar el rendimiento de la
aplicación al eliminar las comprobaciones de límites de matriz.
El código no seguro es necesario al llamar a funciones nativas que requieren
punteros.
El código no seguro presenta riesgos para la seguridad y la estabilidad.
El código que contenga bloques no seguros deberá compilarse con la opción del
compilador AllowUnsafeBlocks.

Tipos de puntero
En un contexto no seguro, un tipo puede ser un tipo de puntero, además de un tipo de
valor o un tipo de referencia. Una declaración de tipos de puntero toma una de las
siguientes formas:

C#

type* identifier;

void* identifier; //allowed but not recommended

El tipo especificado antes de * en un tipo de puntero se denomina tipo referente. Solo

un tipo no administrado puede ser un tipo de referente.
Los tipos de puntero no heredan de object y no existe ninguna conversión entre tipos
de puntero y object . Además, las conversiones boxing y unboxing no admiten
punteros. Sin embargo, puede realizar la conversión entre diferentes tipos de puntero y
entre tipos de puntero y tipos enteros.

Cuando declare varios punteros en la misma declaración, únicamente debe escribir el

asterisco ( * ) con el tipo subyacente. No se usa como prefijo en cada nombre de
puntero. Por ejemplo:

C#

int* p1, p2, p3; // Ok

int *p1, *p2, *p3; // Invalid in C#

Un puntero no puede señalar a una referencia ni a un struct que contenga referencias,

porque una referencia de objeto puede recolectarse como elemento no utilizado
aunque haya un puntero que la señale. El recolector de elementos no utilizados no
realiza un seguimiento de si algún tipo de puntero señala a un objeto.

El valor de la variable de puntero de tipo MyType* es la dirección de una variable de tipo

MyType . A continuación se muestran ejemplos de declaraciones de tipos de puntero:

int* p : p es un puntero a un entero.

int** p : p es un puntero a un puntero a un entero.

int*[] p : p es una matriz unidimensional de punteros a enteros.

char* p : p es un puntero a un valor char.

void* p : p es un puntero a un tipo desconocido.

El operador de direccionamiento indirecto del puntero * puede usarse para acceder al

contenido de la ubicación señalada por la variable de puntero. Por ejemplo,
consideremos la siguiente declaración:

C#

int* myVariable;

La expresión *myVariable denota la variable int que se encuentra en la dirección

contenida en myVariable .

Hay varios ejemplos de punteros en los artículos sobre la instrucción fixed. En el ejemplo
siguiente se usa la palabra clave unsafe y la instrucción fixed y se muestra cómo
incrementar un puntero interior. Puede pegar este código en la función Main de una
aplicación de consola para ejecutarla. Estos ejemplos se deben compilar con el conjunto
de opciones del compilador AllowUnsafeBlocks.

C#

// Normal pointer to an object.

int[] a = new int[5] { 10, 20, 30, 40, 50 };

// Must be in unsafe code to use interior pointers.

unsafe

// Must pin object on heap so that it doesn't move while using interior
pointers.

fixed (int* p = &a[0])

// p is pinned as well as object, so create another pointer to show

incrementing it.

int* p2 = p;

Console.WriteLine(*p2);

// Incrementing p2 bumps the pointer by four bytes due to its type

...

p2 += 1;

Console.WriteLine(*p2);

p2 += 1;

Console.WriteLine(*p2);

Console.WriteLine("--------");

Console.WriteLine(*p);

// Dereferencing p and incrementing changes the value of a[0] ...

*p += 1;

Console.WriteLine(*p);

*p += 1;

Console.WriteLine(*p);

Console.WriteLine("--------");

Console.WriteLine(a[0]);

/*

Output:

10

20

30

--------

10

11

12

--------

12

*/

No se puede aplicar el operador de direccionamiento indirecto a un puntero de tipo

void* . Sin embargo, es posible usar una conversión para convertir un puntero void en
cualquier otro tipo de puntero y viceversa.

Un puntero puede ser null . La aplicación del operador de direccionamiento indirecto a

un puntero NULL da como resultado un comportamiento definido por la
implementación.

Pasar punteros entre métodos puede provocar un comportamiento no definido. Valore

la posibilidad de usar un método que devuelva un puntero a una variable local
mediante un parámetro in , out o ref , o bien como resultado de la función. Si el
puntero se estableció en un bloque fijo, es posible que la variable a la que señala ya no
sea fija.

En la tabla siguiente se muestran los operadores e instrucciones que pueden funcionar

en punteros en un contexto no seguro:

Operador/Instrucción Usar

* Realiza el direccionamiento indirecto del puntero.

-> Obtiene acceso a un miembro de un struct a través de un puntero.

[] Indiza un puntero.

& Obtiene la dirección de una variable.

++ y -- Incrementa y disminuye los punteros.

+ y - Realiza aritmética con punteros.

== , != , < , > , <= y >= Compara los punteros.

stackalloc Asigna memoria en la pila.

Instrucción fixed Fija provisionalmente una variable para que pueda encontrarse su
dirección.

Para obtener más información sobre los operadores relacionados con el puntero, vea
Operadores relacionados con el puntero.

Cualquier tipo de puntero se puede convertir implícitamente en un tipo void* . Se

puede asignar el valor null a cualquier tipo de puntero. Cualquier tipo de puntero se
puede convertir explícitamente en cualquier otro tipo de puntero mediante una
expresión de conversión. También puede convertir cualquier tipo entero en un tipo de
puntero o cualquier tipo de puntero en un tipo entero. Estas conversiones requieren una
conversión explícita.
El siguiente ejemplo convierte un valor de tipo int* en byte* . Tenga en cuenta que el
puntero señala al byte dirigido más bajo de la variable. Cuando incrementa el resultado
sucesivamente, hasta el tamaño de int (4 bytes), puede mostrar los bytes restantes de
la variable.

C#

int number = 1024;

unsafe

// Convert to byte:

byte* p = (byte*)&number;

System.Console.Write("The 4 bytes of the integer:");

// Display the 4 bytes of the int variable:

for (int i = 0 ; i < sizeof(int) ; ++i)

System.Console.Write(" {0:X2}", *p);

// Increment the pointer:

p++;

System.Console.WriteLine();

System.Console.WriteLine("The value of the integer: {0}", number);

/* Output:

The 4 bytes of the integer: 00 04 00 00

The value of the integer: 1024

*/

Búferes de tamaño fijo

Puede usar la palabra clave fixed para crear un búfer con una matriz de tamaño fijo en
una estructura de datos. Los búferes de tamaño fijo resultan útiles al escribir métodos
que interoperan con orígenes de datos de otros lenguajes o plataformas. El búfer de
tamaño fijo puede tomar cualquiera de los atributos o modificadores permitidos para
los miembros de struct normales. La única restricción es que el tipo de matriz debe ser
bool , byte , char , short , int , long , sbyte , ushort , uint , ulong , float o double .

C#

private fixed char name[30];

En el código seguro, un struct de C# que contiene una matriz no contiene los elementos
de matriz. En su lugar, el struct contiene una referencia a los elementos. Puede insertar
una matriz de tamaño fijo en un struct cuando se usa en un bloque de código no
seguro.

El tamaño del siguiente struct no depende del número de elementos en la matriz, ya

que pathName es una referencia:

C#

public struct PathArray

{

public char[] pathName;

private int reserved;

Un struct puede contener una matriz insertada en el código no seguro. En el siguiente

ejemplo, la matriz fixedBuffer tiene un tamaño fijo. Se usa una instrucción fixed para
establecer un puntero al primer elemento. Se accede a los elementos de la matriz
mediante este puntero. La instrucción fixed ancla el campo de instancia fixedBuffer a
una ubicación concreta en la memoria.

C#

internal unsafe struct Buffer

public fixed char fixedBuffer[128];

internal unsafe class Example

public Buffer buffer = default;

private static void AccessEmbeddedArray()

var example = new Example();

unsafe

// Pin the buffer to a fixed location in memory.

fixed (char* charPtr = example.buffer.fixedBuffer)

*charPtr = 'A';

// Access safely through the index:

char c = example.buffer.fixedBuffer[0];

Console.WriteLine(c);

 // Modify through the index:

example.buffer.fixedBuffer[0] = 'B';

Console.WriteLine(example.buffer.fixedBuffer[0]);

El tamaño de la matriz char de 128 elementos es 256 bytes. Los búferes char de tamaño
fijo siempre admiten 2 bytes por carácter, independientemente de la codificación. Este
tamaño de matriz es el mismo, incluso cuando se calculan las referencias de los búferes
char a las estructuras o métodos de API con CharSet = CharSet.Auto o CharSet =
CharSet.Ansi . Para obtener más información, vea CharSet.

En el ejemplo anterior se muestra el acceso a campos fixed sin anclar. Otra matriz de
tamaño fijo común es la matriz bool. Los elementos de una matriz bool siempre tienen
1 byte de tamaño. Las matrices bool no son adecuadas para crear matrices de bits o
búferes.

Los búferes de tamaño fijo se compilan con el atributo

System.Runtime.CompilerServices.UnsafeValueTypeAttribute, que indica a Common
Language Runtime (CLR) que un tipo contiene una matriz no administrada que puede
provocar un desbordamiento. La memoria asignada mediante stackalloc también
habilita automáticamente las características de detección de saturación del búfer en
CLR. En el ejemplo anterior se muestra cómo podría existir un búfer de tamaño fijo en
un unsafe struct .

C#

internal unsafe struct Buffer

public fixed char fixedBuffer[128];

El código de C# generado por el compilador para Buffer se atribuye de la siguiente

forma:

C#

internal struct Buffer

[StructLayout(LayoutKind.Sequential, Size = 256)]

[CompilerGenerated]

[UnsafeValueType]

public struct <fixedBuffer>e__FixedBuffer

public char FixedElementField;

 [FixedBuffer(typeof(char), 128)]

public <fixedBuffer>e__FixedBuffer fixedBuffer;

Los búferes de tamaño fijo son diferentes de las matrices normales en los siguientes
puntos:

Solo se pueden usar en un contexto unsafe .

Solo pueden ser campos de instancia de structs.
Siempre son vectores o matrices unidimensionales.
La declaración debe incluir la longitud, como fixed char id[8] . No puede usar
fixed char id[] .

Procedimiento para usar punteros para copiar

una matriz de bytes
En el ejemplo siguiente se usan punteros para copiar bytes de una matriz a otra.

En este ejemplo se usa la palabra clave unsafe, que permite el uso de punteros en el
método Copy . La instrucción fixed se usa para declarar punteros a las matrices de origen
y destino. La instrucción fixed ancla la ubicación de las matrices de origen y destino en
memoria, para que no puedan ser desplazadas por la recolección de elementos no
utilizados. Estos bloques de memoria para las matrices se desanclan cuando finaliza el
bloque fixed . Como el método Copy de este ejemplo usa la palabra clave unsafe , se
debe compilar con la opción del compilador AllowUnsafeBlocks.

Este ejemplo accede a los elementos de ambas matrices con índices en lugar de con un
segundo puntero no administrado. La declaración de los punteros pSource y pTarget
ancla las matrices.

C#

static unsafe void Copy(byte[] source, int sourceOffset, byte[] target,

int targetOffset, int count)

// If either array is not instantiated, you cannot complete the copy.

if ((source == null) || (target == null))

throw new System.ArgumentException("source or target is null");

// If either offset, or the number of bytes to copy, is negative, you

// cannot complete the copy.

if ((sourceOffset < 0) || (targetOffset < 0) || (count < 0))

throw new System.ArgumentException("offset or bytes to copy is

negative");

// If the number of bytes from the offset to the end of the array is

// less than the number of bytes you want to copy, you cannot complete

// the copy.

if ((source.Length - sourceOffset < count) ||

(target.Length - targetOffset < count))

throw new System.ArgumentException("offset to end of array is less

than bytes to be copied");

// The following fixed statement pins the location of the source and

// target objects in memory so that they will not be moved by garbage

// collection.

fixed (byte* pSource = source, pTarget = target)

// Copy the specified number of bytes from source to target.

for (int i = 0; i < count; i++)

pTarget[targetOffset + i] = pSource[sourceOffset + i];

static void UnsafeCopyArrays()

// Create two arrays of the same length.

int length = 100;

byte[] byteArray1 = new byte[length];

byte[] byteArray2 = new byte[length];

// Fill byteArray1 with 0 - 99.

for (int i = 0; i < length; ++i)

byteArray1[i] = (byte)i;

// Display the first 10 elements in byteArray1.

System.Console.WriteLine("The first 10 elements of the original are:");

for (int i = 0; i < 10; ++i)

System.Console.Write(byteArray1[i] + " ");

System.Console.WriteLine("\n");

// Copy the contents of byteArray1 to byteArray2.

Copy(byteArray1, 0, byteArray2, 0, length);

// Display the first 10 elements in the copy, byteArray2.

System.Console.WriteLine("The first 10 elements of the copy are:");

for (int i = 0; i < 10; ++i)

System.Console.Write(byteArray2[i] + " ");

System.Console.WriteLine("\n");

// Copy the contents of the last 10 elements of byteArray1 to the

// beginning of byteArray2.

// The offset specifies where the copying begins in the source array.

int offset = length - 10;

Copy(byteArray1, offset, byteArray2, 0, length - offset);

// Display the first 10 elements in the copy, byteArray2.

System.Console.WriteLine("The first 10 elements of the copy are:");

for (int i = 0; i < 10; ++i)

System.Console.Write(byteArray2[i] + " ");

System.Console.WriteLine("\n");

/* Output:

The first 10 elements of the original are:

0 1 2 3 4 5 6 7 8 9

The first 10 elements of the copy are:

0 1 2 3 4 5 6 7 8 9

The first 10 elements of the copy are:

90 91 92 93 94 95 96 97 98 99

*/

Punteros de función
C# proporciona tipos delegate para definir objetos de puntero de función seguros. La
invocación de un delegado implica la creación de instancias de un tipo derivado de
System.Delegate y la realización de una llamada al método virtual a su método Invoke .
Esta llamada virtual utiliza la instrucción de IL callvirt . En las rutas de acceso de
código crítico para el rendimiento, el uso de la instrucción de IL calli es más eficaz.

Puede definir un puntero de función mediante la sintaxis delegate* . El compilador

llamará a la función mediante la instrucción calli en lugar de crear una instancia de un
objeto delegate y llamar a Invoke . En el código siguiente se declaran dos métodos que
usan delegate o delegate* para combinar dos objetos del mismo tipo. El primer
método usa un tipo de delegado System.Func<T1,T2,TResult>. El segundo método usa
una declaración delegate* con los mismos parámetros y el tipo de valor devuelto:

C#
 public static T Combine<T>(Func<T, T, T> combinator, T left, T right) =>

combinator(left, right);

public static T UnsafeCombine<T>(delegate*<T, T, T> combinator, T left, T

right) =>

combinator(left, right);

En el código siguiente se muestra cómo se declara una función local estática y se invoca
el método UnsafeCombine con un puntero a esa función local:

C#

static int localMultiply(int x, int y) => x * y;

int product = UnsafeCombine(&localMultiply, 3, 4);

En el código anterior se muestran algunas de las reglas de la función a la que se accede

como un puntero de función:

Los punteros de función solo se pueden declarar en un contexto unsafe .

Los métodos que toman un tipo de delegate* (o devuelven un tipo de delegate* )
solo se pueden llamar en un contexto unsafe .
Para obtener la dirección de una función, el operador & solo se permite en
funciones static . Esta regla se aplica a las funciones miembro y a las funciones
locales.

La sintaxis muestra paralelismos con la declaración de tipos de delegate y el uso de

punteros. El sufijo * de delegate indica que la declaración es un puntero de función. El
operador & , al asignar un grupo de métodos a un puntero de función, indica que la
operación toma la dirección del método.

Puede especificar la convención de llamada para un puntero delegate* mediante las

palabras clave managed y unmanaged . Además, en el caso de los punteros de función
unmanaged , puede especificar la convención de llamada. En las siguientes declaraciones,

se muestran ejemplos de cada una. La primera declaración usa la convención de llamada

managed , que es la predeterminada. Las cuatro siguientes usan una convención de
llamada unmanaged . Cada una especifica una de las convenciones de llamada de
ECMA 335: Cdecl , Stdcall , Fastcall o Thiscall . La última declaración usa la
convención de llamada unmanaged , que indica al CLR que elija la convención de llamada
predeterminada para la plataforma. CLR elegirá la convención de llamada en tiempo de
ejecución.

C#
 public static T ManagedCombine<T>(delegate* managed<T, T, T> combinator, T
left, T right) =>

combinator(left, right);

public static T CDeclCombine<T>(delegate* unmanaged[Cdecl]<T, T, T>

combinator, T left, T right) =>

combinator(left, right);

public static T StdcallCombine<T>(delegate* unmanaged[Stdcall]<T, T, T>

combinator, T left, T right) =>

combinator(left, right);

public static T FastcallCombine<T>(delegate* unmanaged[Fastcall]<T, T, T>

combinator, T left, T right) =>

combinator(left, right);

public static T ThiscallCombine<T>(delegate* unmanaged[Thiscall]<T, T, T>

combinator, T left, T right) =>

combinator(left, right);

public static T UnmanagedCombine<T>(delegate* unmanaged<T, T, T> combinator,

T left, T right) =>

combinator(left, right);

Puede obtener más información sobre los punteros de función en la propuesta de

Puntero de función para C# 9.0.

Especificación del lenguaje C#

Para obtener más información, vea el capítulo Código no seguro de la Especificación del
lenguaje C#.
Directivas de preprocesador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 16 minutos

Aunque el compilador no tiene un preprocesador independiente, las directivas descritas

en esta sección se procesan como si hubiera uno. Se usan para facilitar la compilación
condicional. A diferencia de las directivas de C y C++, estas no se pueden usar para
crear macros. Una directiva de preprocesador debe ser la única instrucción en una línea.

Contexto que admite un valor NULL

La directiva de preprocesador #nullable establece el contexto de anotación que admite
un valor NULL y el contexto de advertencia que admite un valor NULL. Esta directiva
controla si las anotaciones que admiten un valor NULL surten algún efecto y si se
proporcionan advertencias de nulabilidad. Cada contexto está deshabilitado o habilitado.

Ambos contextos se pueden especificar en el nivel de proyecto (fuera del código fuente
de C#). La directiva #nullable controla los contextos de anotación y advertencia y tiene
prioridad sobre la configuración de nivel de proyecto. Una directiva establece los
contextos que controla hasta que otra directiva la invalida o hasta el final del archivo de
código fuente.

El efecto de las directivas es el siguiente:

#nullable disable : establece los contextos de advertencia y anotación que

admiten un valor NULL en deshabilitado.
#nullable enable : establece los contextos de advertencia y anotación que admiten
un valor NULL en habilitado.
#nullable restore : restaura los contextos de advertencia y anotación que admiten
un valor NULL a la configuración del proyecto.
#nullable disable annotations : establece el contexto de anotación que admite un

valor NULL en deshabilitado.

#nullable enable annotations : establece el contexto de anotación que admite un

valor NULL en habilitado.

#nullable restore annotations : restaura el contexto de anotación que admite un

valor NULL a la configuración del proyecto.

#nullable disable warnings : establece el contexto de advertencia que admite un
valor NULL en deshabilitado.
#nullable enable warnings : establece el contexto de advertencia que admite un
valor NULL en habilitado.
 #nullable restore warnings : restaura el contexto de advertencia que admite un

valor NULL a la configuración del proyecto.

Compilación condicional
Para controlar la compilación condicional se usan cuatro directivas de preprocesador:

#if : abre una compilación condicional, donde el código solo se compila si se

define el símbolo especificado.

#elif : cierra la compilación condicional anterior y abre una nueva en función de si

se define el símbolo especificado.

#else : cierra la compilación condicional anterior y abre una nueva si no se ha
definido el símbolo especificado anterior.
#endif : cierra la compilación condicional anterior.

El compilador de C# compila el código entre la directiva #if y la directiva #endif solo si

se define el símbolo especificado o no se define cuando se usa el operador not ! . A
diferencia de C y C++, no se puede asignar un valor numérico a un símbolo. La
instrucción #if en C# es booleana y solo comprueba si el símbolo se ha definido o no.
Por ejemplo, el código siguiente se compila cuando DEBUG se define:

C#

#if DEBUG

Console.WriteLine("Debug version");

#endif

El código siguiente se compila cuando MYTEST no se define:

C#

#if !MYTEST

Console.WriteLine("MYTEST is not defined");

#endif

Puede usar los operadores == (igualdad) y != (desigualdad) para comprobar los valores
bool true o false . true significa que el símbolo está definido. La instrucción #if DEBUG
tiene el mismo significado que #if (DEBUG == true) . Puede usar los operadores && (y),
|| (o) y ! (no) para evaluar si se han definido varios símbolos. Es posible agrupar símbolos
y operadores mediante paréntesis.
#if , junto con las directivas #else , #elif , #endif , #define y #undef , permite incluir o

excluir código basado en la existencia de uno o varios símbolos. La compilación

condicional puede resultar útil al compilar código para una compilación de depuración
o para una configuración concreta.

Una directiva condicional que empieza con una directiva #if debe terminar de forma
explícita con una directiva #endif . #define permite definir un símbolo. Al usar el
símbolo como la expresión que se pasa a la directiva #if , la expresión se evalúa como
true . También se puede definir un símbolo con la opción del compilador

DefineConstants. La definición de un símbolo se puede anular mediante #undef . El

ámbito de un símbolo creado con #define es el archivo en que se ha definido. Un
símbolo definido con DefineConstants o #define no debe entrar en conflicto con una
variable del mismo nombre. Es decir, un nombre de variable no se debe pasar a una
directiva de preprocesador y un símbolo solo puede ser evaluado por una directiva de
preprocesador.

#elif permite crear una directiva condicional compuesta. La expresión #elif se

evaluará si ninguna de las expresiones de directiva #if o #elif (opcional) precedentes

se evalúan como true . Si una expresión #elif se evalúa como true , el compilador
evalúa todo el código comprendido entre #elif y la siguiente directiva condicional. Por
ejemplo:

C#

#define VC7

//...

#if DEBUG

Console.WriteLine("Debug build");

#elif VC7

Console.WriteLine("Visual Studio 7");

#endif

#else permite crear una directiva condicional compuesta, de modo que, si ninguna de

las expresiones de las directivas #if o #elif (opcional) anteriores se evalúan como
true , el compilador evaluará todo el código entre #else y la directiva #endif siguiente.

#endif (#endif) debe ser la siguiente directiva de preprocesador después de #else .

#endif especifica el final de una directiva condicional, que comienza con la directiva
#if .

El sistema de compilación también tiene en cuenta los símbolos de preprocesador

predefinidos que representan distintos marcos de destino en proyectos de estilo SDK.
Resultan útiles al crear aplicaciones que pueden tener como destino más de una versión
de .NET.

Versiones Símbolos Símbolos adicionales

Símbolos de
de .NET (disponible en SDK de .NET 5+) plataforma (solo
Framework disponibles

de destino cuando se
especifica un TFM
específico del
sistema operativo)

.NET NETFRAMEWORK , NET48 , NET48_OR_GREATER ,

Framework NET472 , NET471 , NET472_OR_GREATER ,
NET47 , NET462 , NET471_OR_GREATER ,
NET461 , NET46 , NET47_OR_GREATER ,
NET452 , NET451 , NET462_OR_GREATER ,
NET45 , NET40 , NET35 , NET461_OR_GREATER ,
NET20 NET46_OR_GREATER ,
NET452_OR_GREATER ,
NET451_OR_GREATER ,
NET45_OR_GREATER ,
NET40_OR_GREATER ,
NET35_OR_GREATER ,
NET20_OR_GREATER

.NET NETSTANDARD , NETSTANDARD2_1_OR_GREATER ,

Standard NETSTANDARD2_1 , NETSTANDARD2_0_OR_GREATER ,
NETSTANDARD2_0 , NETSTANDARD1_6_OR_GREATER ,
NETSTANDARD1_6 , NETSTANDARD1_5_OR_GREATER ,
NETSTANDARD1_5 , NETSTANDARD1_4_OR_GREATER ,
NETSTANDARD1_4 , NETSTANDARD1_3_OR_GREATER ,
NETSTANDARD1_3 , NETSTANDARD1_2_OR_GREATER ,
NETSTANDARD1_2 , NETSTANDARD1_1_OR_GREATER ,
NETSTANDARD1_1 , NETSTANDARD1_0_OR_GREATER
NETSTANDARD1_0

.NET 5+ (y NET , NET7_0 , NET6_0 , NET7_0_OR_GREATER , ANDROID , IOS ,

.NET Core) NET5_0 , NETCOREAPP , NET6_0_OR_GREATER , MACCATALYST , MACOS ,
NETCOREAPP3_1 , NET5_0_OR_GREATER , TVOS , WINDOWS ,

NETCOREAPP3_0 , NETCOREAPP3_1_OR_GREATER , [OS][version] (por

NETCOREAPP2_2 , NETCOREAPP3_0_OR_GREATER , ejemplo IOS15_1 , )

NETCOREAPP2_1 , NETCOREAPP2_2_OR_GREATER , [OS]

NETCOREAPP2_0 , NETCOREAPP2_1_OR_GREATER , [version]_OR_GREATER
NETCOREAPP1_1 , NETCOREAPP2_0_OR_GREATER , (por ejemplo
NETCOREAPP1_0 NETCOREAPP1_1_OR_GREATER , IOS15_1_OR_GREATER , )
NETCOREAPP1_0_OR_GREATER
 ７ Nota

Los símbolos sin versión se definen independientemente de la versión de

destino.
Los símbolos específicos de la versión solo se definen para la versión de
destino.
Los símbolos <framework>_OR_GREATER se definen para la versión de destino y
todas las versiones anteriores. Por ejemplo, si tiene como destino .NET
Framework 2.0, se definen los símbolos siguientes: NET20 , NET20_OR_GREATER ,
NET11_OR_GREATER y NET10_OR_GREATER .

Son diferentes de los monikers de la plataforma de destino (TFM) que usa la

propiedad MSBuildTargetFramework y NuGet.

７ Nota

En el caso de los proyectos que no son de estilo SDK, tendrá que configurar
manualmente los símbolos de compilación condicional para las diferentes
plataformas de destino en Visual Studio a través de las páginas de propiedades del
proyecto.

Otros símbolos predefinidos incluyen las constantes DEBUG y TRACE . Puede invalidar los
valores establecidos para el proyecto con #define . Por ejemplo, el símbolo DEBUG se
establece automáticamente según las propiedades de configuración de compilación
(modo de "depuración" o de "versión").

En el ejemplo siguiente se muestra cómo definir un símbolo MYTEST en un archivo y

luego probar los valores de los símbolos MYTEST y DEBUG . La salida de este ejemplo
depende de si el proyecto se ha compilado en modo de configuración Depuración o
Versión.

C#

#define MYTEST

using System;

public class MyClass

static void Main()

#if (DEBUG && !MYTEST)

Console.WriteLine("DEBUG is defined");

#elif (!DEBUG && MYTEST)

 Console.WriteLine("MYTEST is defined");

#elif (DEBUG && MYTEST)

Console.WriteLine("DEBUG and MYTEST are defined");

#else

Console.WriteLine("DEBUG and MYTEST are not defined");

#endif

En el ejemplo siguiente se muestra cómo probar distintos marcos de destino para que
se puedan usar las API más recientes cuando sea posible:

C#

public class MyClass

static void Main()

#if NET40

WebClient _client = new WebClient();

#else

HttpClient _client = new HttpClient();

#endif

//...

Definición de símbolos
Use las dos directivas de preprocesador siguientes para definir o anular la definición de
símbolos para la compilación condicional:

#define : se define un símbolo.

#undef : se anula la definición de un símbolo.

Usa #define para definir un símbolo. Si usa el símbolo como expresión que se pasa a la
directiva #if , la expresión se evaluará como true , como se muestra en el siguiente
ejemplo:

C#

#define VERBOSE

#if VERBOSE

Console.WriteLine("Verbose output version");

#endif

 ７ Nota

La directiva #define no puede usarse para declarar valores constantes como suele
hacerse en C y C++. En C#, las constantes se definen mejor como miembros
estáticos de una clase o struct. Si tiene varias constantes de este tipo, puede
considerar la posibilidad de crear una clase "Constants" independiente donde
incluirlas.

Los símbolos se pueden usar para especificar condiciones de compilación. Puede

comprobar el símbolo tanto con #if como con #elif . También se puede usar
ConditionalAttribute para realizar una compilación condicional. Puede definir un
símbolo, pero no asignar un valor a un símbolo. La directiva #define debe aparecer en
el archivo antes de que use cualquier instrucción que tampoco sea una directiva del
preprocesador. También se puede definir un símbolo con la opción del compilador
DefineConstants. La definición de un símbolo se puede anular mediante #undef .

Definición de regiones
Puede definir regiones de código que se pueden contraer en un esquema mediante las
dos directivas de preprocesador siguientes:

#region : se inicia una región.

#endregion : se finaliza una región.

#region permite especificar un bloque de código que se puede expandir o contraer

cuando se usa la característica de esquematización del editor de código. En archivos de

código más largos, es conveniente contraer u ocultar una o varias regiones para poder
centrarse en la parte del archivo en la que se trabaja actualmente. En el ejemplo
siguiente se muestra cómo definir una región:

C#

#region MyClass definition

public class MyClass

static void Main()

#endregion

Un bloque #region se debe terminar con una directiva #endregion . Un bloque #region
no se puede superponer con un bloque #if . Pero, un bloque #region se puede anidar
en un bloque #if y un bloque #if se puede anidar en un bloque #region .

Información de errores y advertencias

Indique al compilador que genere errores y advertencias del compilador definidos por el
usuario, y controle la información de línea mediante las directivas siguientes:

#error : se genera un error del compilador con un mensaje especificado.

#warning : se genera una advertencia del compilador con un mensaje especificado.

#line : se cambia el número de línea impreso con mensajes del compilador.

#error permite generar un error CS1029 definido por el usuario desde una ubicación

específica en el código. Por ejemplo:

C#

#error Deprecated code in this method.

７ Nota

El compilador trata #error version de forma especial e informa de un error del

compilador, CS8304, con un mensaje que contiene las versiones que se usan del
compilador y del lenguaje.

#warning permite generar una advertencia del compilador CS1030 de nivel uno desde
una ubicación específica en el código. Por ejemplo:

C#

#warning Deprecated code in this method.

#line le permite modificar el número de línea del compilador y (opcionalmente) la

salida del nombre de archivo de errores y advertencias.

En el siguiente ejemplo, se muestra cómo notificar dos advertencias asociadas con

números de línea. La directiva #line 200 fuerza el número de línea siguiente para que
sea 200 (aunque el valor predeterminado es 6) y hasta la siguiente directiva #line , el
nombre de archivo se notificará como "Especial". La directiva #line default devuelve la
numeración de líneas a su numeración predeterminada, que cuenta las líneas a las que
la directiva anterior ha cambiado el número.

C#

class MainClass

static void Main()

#line 200 "Special"

int i;

int j;

#line default

char c;

float f;

#line hidden // numbering not affected

string s;

double d;

La compilación genera el siguiente resultado:

Consola

Special(200,13): warning CS0168: The variable 'i' is declared but never used

Special(201,13): warning CS0168: The variable 'j' is declared but never used

MainClass.cs(9,14): warning CS0168: The variable 'c' is declared but never

used

MainClass.cs(10,15): warning CS0168: The variable 'f' is declared but never

used

MainClass.cs(12,16): warning CS0168: The variable 's' is declared but never

used

MainClass.cs(13,16): warning CS0168: The variable 'd' is declared but never

used

La directiva #line podría usarse en un paso intermedio automatizado en el proceso de

compilación. Por ejemplo, si se han eliminado las líneas del archivo de código fuente
original, pero aún quiere que el compilador genere unos resultados en función de la
numeración de líneas original en el archivo, puede quitar las líneas y, después, simular la
numeración de líneas original con #line .

La directiva #line hidden oculta las líneas sucesivas del depurador, de forma que,
cuando el desarrollador ejecuta paso a paso el código, cualquier línea entre #line
hidden y la siguiente directiva #line (siempre que no sea otra directiva #line hidden )
se depurará paso a paso por procedimientos. Esta opción también se puede usar para
permitir que ASP.NET diferencie entre el código generado por el equipo y el definido
por el usuario. Aunque ASP.NET es el consumidor principal de esta característica, es
probable que la usen más generadores de código fuente.

Una directiva #line hidden no afecta a los nombres de archivo ni a los números de línea
en el informe de errores. Es decir, si el compilador detecta un error en un bloque oculto,
notificará el nombre de archivo y número de línea actuales del error.

La directiva #line filename especifica el nombre de archivo que quiere que aparezca en
la salida del compilador. De forma predeterminada, se usa el nombre real del archivo de
código fuente. El nombre de archivo debe estar entre comillas dobles ("") y debe ir
precedido de un número de línea.

A partir de C# 10, se puede usar un formulario nuevo de la directiva #line :

C#

#line (1, 1) - (5, 60) 10 "partial-class.cs"

/*34567*/int b = 0;

Los componentes de este formulario son los siguientes:

(1, 1) : la línea de inicio y la columna del primer carácter de la línea que sigue a la
directiva. En este ejemplo, la línea siguiente se notifica como línea 1, columna 1.
(5, 60) : la línea final y la columna de la región marcada.
10 : desplazamiento de columna para que la directiva #line surta efecto. En este

ejemplo, la décima columna se notifica como columna 1. Aquí es donde comienza

la declaración int b = 0; . Este campo es opcional. Si se omite, la directiva surte
efecto en la primera columna.
"partial-class.cs" : el nombre del archivo de salida.

En el ejemplo anterior se generaría la advertencia siguiente:

CLI de .NET

partial-class.cs(1,5,1,6): warning CS0219: The variable 'b' is assigned but

its value is never used

Después de reasignar, la variable , b está en la primera línea, en el carácter seis, del

archivo partial-class.cs .

Los lenguajes específicos de dominio (DSL) suelen usar este formato para proporcionar
una mejor asignación desde el archivo de origen hasta la salida de C# generada. El uso
más común de esta directiva extendida #line es volver a asignar advertencias o errores
que aparecen en un archivo generado al origen original. Por ejemplo, considere esta
página de razor:

razor

@page "/"

Time: @DateTime.NowAndThen

La propiedad DateTime.Now se ha escrito incorrectamente como DateTime.NowAndThen . El

código de C# generado para este fragmento de código de razor es similar al siguiente,
en page.g.cs :

C#

_builder.Add("Time: ");

#line (2, 6) (2, 27) 15 "page.razor"

_builder.Add(DateTime.NowAndThen);

La salida del compilador para el fragmento de código anterior es:

CLI de .NET

page.razor(2, 2, 2, 27)error CS0117: 'DateTime' does not contain a

definition for 'NowAndThen'

La línea 2, columna 6 en page.razor es donde comienza el texto @DateTime.NowAndThen .

Esto se indica en (2, 6) la directiva . Ese intervalo de @DateTime.NowAndThen termina en
la línea 2, columna 27. Esto se indica en la (2, 27) directiva . El texto de
DateTime.NowAndThen comienza en la columna 15 de page.g.cs . Esto se indica en la 15

directiva . Al colocar todos los argumentos, y el compilador notifica el error en su

ubicación en page.razor . El desarrollador puede navegar directamente al error en su
código fuente, no al origen generado.

Para ver más ejemplos de este formato, vea la especificación de la característica en la

sección sobre ejemplos.

Pragmas
#pragma proporciona al compilador instrucciones especiales para la compilación del

archivo en el que aparece. Las instrucciones deben ser compatibles con el compilador.
Es decir, no puede usar #pragma para crear instrucciones de preprocesamiento
personalizadas.
 #pragma warning: se habilitan o deshabilitan las advertencias.
#pragma checksum: se genera una lista de comprobación.

C#

#pragma pragma-name pragma-arguments

Donde pragma-name es el nombre de una pragma reconocida y pragma-arguments es el

argumento específico de la pragma.

#pragma warning
#pragma warning puede habilitar o deshabilitar determinadas advertencias.

C#

#pragma warning disable warning-list

#pragma warning restore warning-list

Donde warning-list es una lista de números de advertencia separados por comas. El

prefijo "CS" es opcional. Cuando no se especifica ningún número de advertencia,
disable deshabilita todas las advertencias y restore habilita todas las advertencias.

７ Nota

Para buscar los números de advertencia en Visual Studio, compile el proyecto y

después busque los números de advertencia en la ventana Salida.

disable surte efecto a partir de la siguiente línea del archivo de código fuente. La

advertencia se restaura en la línea que sigue a restore . Si el archivo no incluye restore ,

las advertencias se restauran a su estado predeterminado en la primera línea de los
archivos posteriores de la misma compilación.

C#

// pragma_warning.cs

using System;

#pragma warning disable 414, CS3021

[CLSCompliant(false)]

public class C

int i = 1;

static void Main()

#pragma warning restore CS3021

[CLSCompliant(false)] // CS3021

public class D

int i = 1;

public static void F()

Suma de comprobación #pragma

Genera sumas de comprobación de archivos de código fuente para ayudar con la
depuración de páginas ASP.NET.

C#

#pragma checksum "filename" "{guid}" "checksum bytes"

Donde "filename" es el nombre del archivo en el que es necesario supervisar los

cambios o las actualizaciones, "{guid}" es el identificador único global (GUID) para el
algoritmo hash y "checksum_bytes" es la cadena de dígitos hexadecimales que
representa los bytes de la suma de comprobación. Debe ser un número par de dígitos
hexadecimales. Un número impar de dígitos genera una advertencia de tiempo de
compilación y la directiva se ignora.

El depurador de Visual Studio usa una suma de comprobación para asegurarse de que

siempre encuentra el código fuente correcto. El compilador calcula la suma de
comprobación para un archivo de origen y, después, emite el resultado en el archivo de
base de datos del programa (PDB). Después, el depurador usa el archivo PDB para
comparar la suma de comprobación que calcula para el archivo de origen.

Esta solución no funciona con proyectos de ASP.NET, ya que la suma de comprobación

calculada es para el archivo de código fuente generado, no para el archivo .aspx. Para
solucionar este problema, #pragma checksum proporciona compatibilidad de la suma de
comprobación con páginas ASP.NET.

Cuando se crea un proyecto de ASP.NET en Visual C#, el archivo de código fuente

generado contiene una suma de comprobación del archivo .aspx desde el que se genera
el código fuente. Después, el compilador escribe esta información en el archivo PDB.
Si el compilador no encuentra ninguna directiva #pragma checksum en el archivo, calcula
la suma de comprobación y escribe el valor en el archivo PDB.

C#

class TestClass

static int Main()

#pragma checksum "file.cs" "{406EA660-64CF-4C82-B6F0-42D48172A799}"

"ab007f1d23d9" // New checksum

Opciones del compilador de C#

Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

En esta sección se describen las opciones que interpreta el compilador de C#. Las
opciones se agrupan en artículos independientes en función de lo que controlan, por
ejemplo, las características del lenguaje, la generación de código y la salida. Use la tabla
de contenido para navegar por ellas.

Procedimiento para establecer las opciones

Hay dos formas de establecer las opciones del compilador en los proyectos de .NET:

En el archivo *.csproj

Puede agregar propiedades MSBuild a cualquier opción del compilador en el

archivo *.csproj en formato XML. El nombre de la propiedad es el mismo que el de
la opción del compilador. El valor de la propiedad establece el valor de la opción
del compilador. Por ejemplo, el siguiente fragmento de código de archivo de
proyecto establece la propiedad LangVersion .

XML

<PropertyGroup>

<LangVersion>preview</LangVersion>

</PropertyGroup>

Para obtener más información sobre el procedimiento para establecer las opciones
en los archivos de proyecto, consulte el artículo Referencia de MSBuild para
proyectos del SDK de .NET.

Uso de las páginas de propiedades de Visual Studio

Visual Studio cuenta con páginas de propiedades para editar las propiedades de

compilación. Para obtener más información al respecto, consulte Administrar
propiedades de soluciones y proyectos (Windows) y Administrar propiedades de
soluciones y proyectos (Mac).

Proyectos de .NET Framework

） Importante
 Esta sección solo se aplica a los proyectos de .NET Framework.

Además de los mecanismos descritos anteriormente, puede establecer las opciones del
compilador por medio de dos métodos más para los proyectos de .NET Framework:

Argumentos de la línea de comandos para proyectos de .NET Framework: los

proyectos de .NET Framework usan csc.exe en lugar de dotnet build para compilar
los proyectos. En el caso de los proyectos de .NET Framework, puede especificar
argumentos de la línea de comandos a csc.exe.
Páginas de ASP.NET compiladas: los proyectos de .NET Framework usan una
sección del archivo web.config para compilar páginas. Para el nuevo sistema de
compilación, así como los proyectos de ASP.NET Core, las opciones se toman del
archivo del proyecto.

En el caso de algunas opciones del compilador, la palabra ha cambiado de csc.exe al

nuevo sistema de MSBuild, y también para los proyectos de .NET Framework. En esta
sección se emplea la nueva sintaxis. Ambas versiones figuran al principio de cada
página. Para csc.exe, los argumentos figuran seguidos de la opción y dos puntos. Por
ejemplo, la opción -doc sería:

Consola

-doc:DocFile.xml

Puede invocar el compilador de C# escribiendo el nombre de su archivo ejecutable

(csc.exe) en un símbolo del sistema.

En el caso de los proyectos de .NET Framework, también puede ejecutar csc.exe

mediante la línea de comandos. Cada opción del compilador está disponible en dos
formatos: -option y /option. En los proyectos web de .NET Framework, debe especificar
las opciones para compilar el código subyacente en el archivo web.config. Para obtener
más información, consulte <compilador> Elemento.

Si usa la ventana Símbolo del sistema para desarrolladores de Visual Studio, todas las
variables de entorno necesarias se establecen automáticamente. Para obtener
información sobre cómo acceder a esta herramienta, vea Símbolo del sistema para
desarrolladores de Visual Studio.

El archivo ejecutable csc.exe normalmente se encuentra en la carpeta

Microsoft.NET\Framework\<Version>, en el directorio Windows. Su ubicación puede
variar, según la configuración exacta de un equipo concreto. Si se instala más de una
versión de .NET Framework en el equipo, encontrará varias versiones de este archivo.
Para obtener más información sobre estas instalaciones, vea Cómo: Determinar qué
versiones de .NET Framework están instaladas.
Opciones del compilador de C# para las
reglas de características del lenguaje
Artículo • 17/02/2023 • Tiempo de lectura: 8 minutos

Las opciones siguientes controlan cómo el compilador interpreta las características del
lenguaje. La nueva sintaxis de MSBuild se muestra en negrita. La sintaxis de csc.exe
anterior se muestra en code style .

CheckForOverflowUnderflow / -checked : se generan comprobaciones de

desbordamiento.
AllowUnsafeBlocks / -unsafe : se permite código "no seguro".
DefineConstants / -define : se definen símbolos de compilación condicional.
LangVersion / -langversion : se especifica la versión del lenguaje como default
(versión principal más reciente) o latest (versión más reciente, incluidas las
versiones secundarias).
Nullable / -nullable : se habilita el contexto que admite un valor NULL o
advertencias que admiten un valor NULL.

CheckForOverflowUnderflow
La opción CheckForOverflowUnderflow controla el contexto de comprobación de
desbordamiento predeterminado que define el comportamiento del programa si el
aritmético de enteros se desborda.

XML

<CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>

Cuando CheckForOverflowUnderflow es true , el contexto predeterminado es un

contexto comprobado y la comprobación de desbordamiento está habilitada; de lo
contrario, el contexto predeterminado es un contexto no comprobado. El valor
predeterminado para esta opción es false ; es decir, la comprobación de
desbordamiento está deshabilitada.

También puede controlar explícitamente el contexto de comprobación de

desbordamiento para las partes del código mediante las instrucciones checked y
unchecked .
Para obtener información sobre cómo afecta el contexto de comprobación de
desbordamiento a las operaciones y qué operaciones se ven afectadas, vea el artículo
acerca de las instrucciones checked y unchecked.

AllowUnsafeBlocks
La opción del compilador AllowUnsafeBlocks permite la compilación de código en el
que se usa la palabra clave unsafe. El valor predeterminado de esta opción es false , lo
que significa que no se permite el código no seguro.

XML

<AllowUnsafeBlocks>true</AllowUnsafeBlocks>

Para obtener más información sobre el código no seguro, vea Código no seguro y
punteros.

DefineConstants
La opción DefineConstants define símbolos en todos los archivos de código fuente del
programa.

XML

<DefineConstants>name;name2</DefineConstants>

Esta opción especifica los nombres de uno o más símbolos que quiera definir. La opción
DefineConstants tiene el mismo efecto que la directiva del preprocesador #define, salvo
que la opción del compilador está en vigor para todos los archivos del proyecto. Un
símbolo permanece definido en un archivo de origen hasta que una directiva #undef en
el archivo de origen quita la definición. Cuando usa la opción -define , una directiva
#undef en un archivo no tiene ningún efecto en otros archivos de código fuente del
proyecto. Los símbolos creados por esta opción se pueden usar con #if, #else, #elif y
#endif para compilar los archivos de origen condicionalmente. El propio compilador de
C# no define ningún símbolo o macro que puede usar en su código fuente; todas las
definiciones de símbolo deben definirse por el usuario.

７ Nota
 El valor de la directiva #define de C# no permite que se le proporcione un valor a
un símbolo, como sucede en lenguajes como C++. Por ejemplo, #define no puede
usarse para crear una macro o para definir una constante. Si necesita definir una
constante, use una variable enum . Si quiere crear una macro de estilo de C++,
considere alternativas como genéricos. Como las macros son notoriamente
propensas a errores, C# deshabilita su uso pero proporciona alternativas más
seguras.

LangVersion
Hace que el compilador acepte solo la sintaxis que se incluye en la especificación
elegida del lenguaje C#.

XML

<LangVersion>9.0</LangVersion>

Valores válidos son:

Valor Significado

preview El compilador acepta toda la sintaxis de lenguaje válida de la última versión

preliminar.

latest El compilador acepta la sintaxis de la última versión del compilador (incluida las
versión secundaria).

latestMajor
El compilador acepta la sintaxis de la versión principal más reciente del
o bien compilador.
default

11.0 El compilador solo acepta la sintaxis que se incluye en C# 11 o versiones

anteriores.

10.0 El compilador solo acepta la sintaxis que se incluye en C# 10 o versiones

anteriores.

9.0 El compilador solo acepta la sintaxis que se incluye en C# 9 o versiones anteriores.

8.0 El compilador acepta solo la sintaxis que se incluye en C# 8.0 o versiones

anteriores.

7.3 El compilador acepta solo la sintaxis que se incluye en C# 7.3 o versiones

anteriores.
 Valor Significado

7.2 El compilador acepta solo la sintaxis que se incluye en C# 7.2 o versiones

anteriores.

7.1 El compilador acepta solo la sintaxis que se incluye en C# 7.1 o versiones

anteriores.

7 El compilador acepta solo la sintaxis que se incluye en C# 7.0 o versiones

anteriores.

6 El compilador acepta solo la sintaxis que se incluye en C# 6.0 o versiones

anteriores.

5 El compilador acepta solo la sintaxis que se incluye en C# 5.0 o versiones

anteriores.

4 El compilador acepta solo la sintaxis que se incluye en C# 4.0 o versiones

anteriores.

3 El compilador acepta solo la sintaxis que se incluye en C# 3.0 o versiones

anteriores.

ISO-2
El compilador acepta solo la sintaxis que se incluye en ISO/IEC 23270:2006 C# (2.0).
o bien 2

ISO-1
El compilador acepta solo la sintaxis que se incluye en ISO/IEC 23270:2003 C#
o bien 1 (1.0/1.2).

La versión de idioma predeterminada depende de la plataforma de destino de la

aplicación y la versión del SDK o de Visual Studio instalada. Esas reglas se definen en el
control de versiones del lenguaje C#.

） Importante

Por lo general, no se recomienda el valor latest . Con él, el compilador habilita las
características más recientes, incluso si esas características dependen de las
actualizaciones no incluidas en la plataforma de destino configurada. Sin esta
configuración, el proyecto usa la versión del compilador recomendada para la
plataforma de destino. Puede actualizar la plataforma de destino para acceder a las
características de lenguaje más recientes.

Los metadatos a los que hace referencia la aplicación de C# no están sujetos a la opción
del compilador LangVersion.

Como cada versión del compilador de C# contiene extensiones para la especificación

del lenguaje, LangVersion no ofrece las funciones equivalentes de una versión anterior
del compilador.

Además, aunque las actualizaciones de versión de C# generalmente coinciden con las

versiones principales de .NET, la sintaxis y las características nuevas no están
necesariamente asociadas a esa versión de marco específica. Cada característica
específica tiene su propia API mínima de .NET o requisitos de Common Language
Runtime que pueden permitir que se ejecute en marcos de versiones anteriores
mediante la inclusión de paquetes NuGet u otras bibliotecas.

Independientemente de la configuración de LangVersion que utilice, use la versión

actual de Common Language Runtime para crear el archivo .exe o .dll. Una excepción
son los ensamblados de confianza y ModuleAssemblyName, que funcionan en -
langversion:ISO-1.

Para obtener otras formas de especificar la versión del lenguaje C#, vea Control de
versiones del lenguaje C#.

Para obtener información sobre cómo establecer esta opción del compilador mediante
programación, vea LanguageVersion.

Especificación del lenguaje C#

Versión Vínculo Descripción

C# 7.0 y vínculo Versión 7 de la especificación del lenguaje C#, borrador no oficial:

posterior .NET Foundation

C# 6.0 Descargar Norma ECMA-334 estándar, sexta edición

PDF

C# 5.0 Descargar Norma ECMA-334 estándar, quinta edición

PDF

C# 3.0 Decargar Especificación del lenguaje C#, versión 3.0: Microsoft Corporation
DOC

C# 2.0 Descargar Norma ECMA-334 estándar, cuarta edición

PDF

C# 1.2 Decargar Especificación del lenguaje C#, versión 1.2: Microsoft Corporation
DOC

C# 1.0 Decargar Especificación del lenguaje C#, versión 1.0: Microsoft Corporation
DOC
Versión del SDK mínima necesaria para admitir todas las
características del lenguaje
En la tabla siguiente se enumeran las versiones mínimas del SDK con el compilador de
C# que admite la versión del lenguaje correspondiente:

Versión de Versión mínima del SDK

C#

C# 11 Microsoft Visual Studio/Build Tools 2022, versión 17.4, o bien el SDK de .NET 7

C# 10 Microsoft Visual Studio/Build Tools 2022, o bien el SDK de .NET 6

C# 9.0 Microsoft Visual Studio/Build Tools 2019, versión 16.8, o bien SDK de .NET 5

C# 8.0 Microsoft Visual Studio/Build Tools 2019, versión 16.3 o SDK de .NET Core 3.0

C# 7.3 Microsoft Visual Studio/Build Tools 2017, versión 15.7

C# 7.2 Microsoft Visual Studio/Build Tools 2017, versión 15.5

C# 7.1 Microsoft Visual Studio/Build Tools 2017, versión 15.3

C# 7.0 Microsoft Visual Studio/Build Tools 2017

C# 6 Microsoft Visual Studio/Build Tools 2015

C# 5 Microsoft Visual Studio/Build Tools 2012 o compilador empaquetado de .NET

Framework 4.5

C# 4 Microsoft Visual Studio/Build Tools 2010 o compilador empaquetado de .NET

Framework 4.0

C# 3 Microsoft Visual Studio/Build Tools 2008 o compilador empaquetado de .NET

Framework 3.5

C# 2 Microsoft Visual Studio/Build Tools 2005 o compilador empaquetado de .NET

Framework 2.0

C# 1.0/1.2 Microsoft Visual Studio/Build Tools .NET 2002 o compilador empaquetado de .NET
Framework 1.0

Nullable
La opción Nullable le permite especificar el contexto que admite un valor NULL. Se
puede establecer en la configuración del proyecto mediante la etiqueta <Nullable> :

XML
 <Nullable>enable</Nullable>

El argumento debe ser uno de enable , disable , warnings o annotations . El argumento

enable habilita el contexto que admite un valor NULL. Si se especifica disable , se
deshabilitará el contexto que admite un valor NULL. Al especificar el argumento
warnings , se habilita el contexto de advertencia que admite un valor NULL. Al
especificar el argumento annotations , se habilita el contexto de anotación que admite
un valor NULL. Los valores se describen y se explican en el artículo sobre contextos que
aceptan valores NULL. Puede obtener más información sobre las tareas implicadas en la
habilitación de tipos de referencia que aceptan valores NULL en un código base
existente en nuestro artículo sobre estrategias de migración que aceptan valores NULL.

７ Nota

Cuando no hay ningún conjunto de valores, se aplica el valor predeterminado

disable , pero las plantillas de .NET 6 se proporcionan de forma predeterminada
con el valor Acepta valores NULL establecido en enable .

El análisis de flujo se utiliza para inferir la nulabilidad de las variables del código
ejecutable. La nulabilidad inferida de una variable es independiente de la nulabilidad
declarada de dicha variable. Las llamadas de método se analizan incluso cuando se
omiten de forma condicional. Es el caso de Debug.Assert en modo de versión.

La invocación de métodos anotados con los siguientes atributos también afectará al

análisis de flujo:

Condiciones previas simples: AllowNullAttribute y DisallowNullAttribute

Condiciones posteriores simples: MaybeNullAttribute y NotNullAttribute
Condiciones posteriores condicionales: MaybeNullWhenAttribute y
NotNullWhenAttribute
DoesNotReturnIfAttribute (por ejemplo, DoesNotReturnIf(false) para
Debug.Assert) y DoesNotReturnAttribute
NotNullIfNotNullAttribute
Condiciones posteriores de miembros: MemberNotNullAttribute(String) y
MemberNotNullAttribute(String[])

） Importante

El contexto global que admite un valor NULL no se aplica a los archivos de código
generado. Con independencia de este valor, el contexto que admite un valor NULL
está deshabilitado para cualquier archivo de código fuente marcado como
generado. Hay cuatro maneras de marcar un archivo como generado:

1. En el archivo .editorconfig, especifique generated_code = true en una sección

que se aplique a ese archivo.
2. Coloque <auto-generated> o <auto-generated/> en un comentario en la parte
superior del archivo. Puede estar en cualquier línea de ese comentario, pero el
bloque de comentario debe ser el primer elemento del archivo.
3. Inicie el nombre de archivo con TemporaryGeneratedFile_
4. Finalice el nombre de archivo con .designer.cs, .generated.cs, .g.cs o .g.i.cs.

Los generadores pueden optar por usar la directiva de preprocesador #nullable.

Opciones del compilador de C# que
controlan la salida del compilador
Artículo • 15/02/2023 • Tiempo de lectura: 9 minutos

Las opciones siguientes controlan la generación de salida del compilador.

MSBuild csc.exe Descripción

DocumentationFile -doc: Genera un archivo de documentación XML a partir de

comentarios /// .

OutputAssembly -out: Especifica el archivo de ensamblado de salida.

PlatformTarget - Especifica la CPU de la plataforma de destino.

platform:

ProduceReferenceAssembly -refout: Genera un ensamblado de referencia.

TargetType -target: Especifica el tipo del ensamblado de salida.

DocumentationFile
La opción DocumentationFile permite insertar comentarios de documentación en un
archivo XML. Para obtener más información sobre cómo documentar el código, vea
Etiquetas recomendadas para comentarios de documentación. El valor especifica la ruta
al archivo XML de salida. El archivo XML contiene los comentarios en los archivos de
código fuente de la compilación.

XML

<DocumentationFile>path/to/file.xml</DocumentationFile>

El archivo de código fuente que contiene instrucciones principales o de nivel superior se

genera primero en el XML. A menudo, querrá usar el archivo .xml generado con
IntelliSense. El nombre de archivo .xml debe ser el mismo que el nombre del
ensamblado. El archivo .xml debe estar en el mismo directorio que el ensamblado.
Cuando se hace referencia al ensamblado en un proyecto de Visual Studio, también se
encuentra el archivo .xml. Para obtener más información sobre la generación de
comentarios de código, vea Proporcionar comentarios de código. A menos que realice
la compilación con <TargetType:Module>, file contendrá etiquetas <assembly> y
</assembly> que especifican el nombre del archivo que incluye el manifiesto del
ensamblado para el archivo de salida. Para obtener ejemplos, vea Procedimiento para
usar las características de la documentación XML.

７ Nota

La opción DocumentationFile se aplica a todos los archivos del proyecto. Para

deshabilitar las advertencias relacionadas con los comentarios de documentación
para un archivo específico o una sección de código, use #pragma warning.

Esta opción se puede usar en cualquier proyecto de estilo SDK de .NET. Para más
información, consulte la propiedad DocumentationFile.

OutputAssembly
La opción OutputAssembly especifica el nombre del archivo de salida. En la ruta de
salida se especifica la carpeta donde se coloca la salida del compilador.

XML

<OutputAssembly>folder</OutputAssembly>

Hay que especificar el nombre completo y la extensión del archivo que se quiere crear.
Si no especifica el nombre del archivo de salida, MSBuild usa el nombre del proyecto
para especificar el nombre del ensamblado de salida. Los proyectos de estilo antiguo
usan las reglas siguientes:

Un archivo .exe toma el nombre del archivo de código fuente que contiene el
método Main o instrucciones de nivel superior.
Un archivo .dll o .netmodule toma el nombre del primer archivo de código fuente.

Todos los módulos que se produzcan como parte de una compilación se convierten en
archivos asociados a cualquier ensamblado que también se haya producido en la
compilación. Use ildasm.exe para ver el manifiesto del ensamblado y los archivos
asociados.

Es obligatorio usar la opción del compilador OutputAssembly para que un archivo exe
sea el destino de un ensamblado de confianza.

PlatformTarget
Especifica qué versión de CLR puede ejecutar el ensamblado.
 XML

<PlatformTarget>anycpu</PlatformTarget>

anycpu (valor predeterminado) compila el ensamblado de forma que se pueda

ejecutar en cualquier plataforma. La aplicación se ejecuta como un proceso de 64
bits siempre que sea posible y recurre a 32 bits solo cuando el modo está
disponible.
anycpu32bitpreferred compila el ensamblado de forma que se pueda ejecutar en
cualquier plataforma. La aplicación se ejecuta en modo de 32 bits en sistemas que
admiten aplicaciones de 64 y 32 bits. Solo puede especificar esta opción para los
proyectos que tienen como destino .NET Framework 4.5 o versiones posteriores.
ARM compila el ensamblado de forma que pueda ejecutarse en un equipo que
tenga un procesador Advanced RISC Machine (ARM).
ARM64 compila el ensamblado que se va a ejecutar mediante el CLR de 64 bits en
un equipo que tiene un procesador Advanced RISC Machine (ARM) que admite el
conjunto de instrucciones A64.
x64 compila el ensamblado de forma que el CLR de 64 bits pueda ejecutarlo en
equipos compatibles con el conjunto de instrucciones AMD64 o EM64T.
x86 compila el ensamblado de forma que el CLR de 32 bits compatible con x86
pueda ejecutarlo.
Itanium compila el ensamblado de forma que el CLR de 64 bits pueda ejecutarlo
en un equipo con un procesador Itanium.

En un sistema operativo de Windows de 64 bits:

Los ensamblados compilados con x86 se ejecutan en el CLR de 32 bits que se

ejecuta en WOW64.
Un archivo DLL compilado con anycpu se ejecuta en el mismo CLR que el proceso
en el que se ha cargado.
Los archivos ejecutables que se compilan con anycpu se ejecutan en el CLR de
64 bits.
Los archivos ejecutables compilados con anycpu32bitpreferred se ejecutan en el
CLR de 32 bits.

El valor anycpu32bitpreferred solo es válido para archivos ejecutables (.EXE) y requiere

.NET Framework 4.5 o una versión posterior. Para obtener más información sobre cómo
desarrollar una aplicación para que se ejecute en un sistema operativo Windows de 64
bits, consulte Aplicaciones de 64 bits.

La opción PlatformTarget se establece en la página de propiedades de compilación del

proyecto en Visual Studio.
El comportamiento de anycpu tiene algunos matices adicionales en .NET Core y .NET 5 y
versiones posteriores. Cuando establezca anycpu, publique la aplicación y ejecútela con
dotnet.exe de x86 o dotnet.exe de x64. En el caso de las aplicaciones independientes,

en el paso dotnet publish se empaqueta el archivo ejecutable para el RID de

configuración.

ProduceReferenceAssembly
La opción ProduceReferenceAssembly controla si el compilador genera ensamblados
de referencia.

XML

<ProduceReferenceAssembly>true</ProduceReferenceAssembly>

Los ensamblados de referencia son un tipo especial de ensamblado que contiene solo la
cantidad mínima de metadatos necesarios para representar la superficie de la API
pública de la biblioteca. Incluyen declaraciones para todos los miembros importantes al
hacer referencia a un ensamblado en las herramientas de compilación. Los ensamblados
de referencia excluyen todas las implementaciones de miembros y declaraciones de
miembros privados. Esos miembros no tienen ningún impacto observable en su
contrato de API. Para obtener más información, vea Ensamblados de referencia en la
Guía de .NET.

Las opciones ProduceReferenceAssembly y ProduceOnlyReferenceAssembly son

mutuamente excluyentes.

Por lo general, no es necesario trabajar directamente con archivos de ensamblado de

referencia. De forma predeterminada, los ensamblados de referencia se generan en una
subcarpeta ref de la ruta de acceso intermedia (es decir, obj/ref/ ). Para generarlos en
el directorio de salida (es decir, bin/ref/ ) establezca ProduceReferenceAssemblyInOutDir
en true en el proyecto.

El SDK de .NET 6.0.200 realizó un cambio que movió ensamblados de referencia del

directorio de salida al directorio intermedio de forma predeterminada.

TargetType
La opción del compilador TargetType se puede especificar en uno de los formatos
siguientes:
 library: para crear una biblioteca de código. library es el valor predeterminado.
exe: para crear un archivo .exe.
module para crear un módulo.
winexe para crear un programa de Windows.
winmdobj para crear un archivo .winmdobj intermedio.
appcontainerexe para crear un archivo .exe para aplicaciones Windows 8.x de
Microsoft Store.

７ Nota

Para los destinos de .NET Framework, a menos que especifique module, esta

opción hace que se coloque un manifiesto del ensamblado de .NET Framework en
un archivo de salida. Para obtener más información, vea Ensamblados en .NET y
Atributos comunes.

XML

<TargetType>library</TargetType>

El compilador crea solo un manifiesto de ensamblado por compilación. La información

sobre todos los archivos de una compilación se coloca en el manifiesto de ensamblado.
Cuando se generan varios archivos de salida en la línea de comandos, solo se puede
crear un manifiesto de ensamblado que debe ir en el primer archivo de salida
especificado en la línea de comandos.

Si crea un ensamblado, puede indicar que todo o parte del código es conforme a CLS
mediante el atributo CLSCompliantAttribute.

biblioteca
La opción library hace que el compilador cree una biblioteca de vínculos dinámicos
(DLL) en lugar de un archivo ejecutable (EXE). El archivo DLL se creará con la extensión
.dll. A menos que se especifique lo contrario con la opción OutputAssembly, el archivo
de salida adopta el nombre del primer archivo de entrada. Al compilar un archivo .dll, no
es necesario un método Main.

exe
La opción exe hace que el compilador cree una aplicación de consola ejecutable (EXE). El
archivo ejecutable se creará con la extensión .exe. Use winexe para crear un archivo
ejecutable de un programa de Windows. A menos que se especifique de otro modo con
la opción OutputAssembly, el nombre del archivo de salida toma el del archivo de
entrada que contiene el punto de entrada (el método Main o instrucciones de nivel
superior). Solo se necesita un punto de entrada en los archivos de código fuente que se
compilan en un archivo .exe. La opción del compilador StartupObject le permite
especificar qué clase contiene el método Main , en aquellos casos en los que el código
tenga más de una clase con un método Main .

module
Esta opción hace que el compilador no genere un manifiesto del ensamblado. De forma
predeterminada, el archivo de salida creado al realizar la compilación con esta opción
tendrá una extensión .netmodule. El entorno de ejecución de .NET no puede cargar un
archivo que no tiene un manifiesto del ensamblado. Pero este archivo se puede
incorporar en el manifiesto del ensamblado con AddModules. Si se crea más de un
módulo en una única compilación, los tipos internal que haya en un módulo estarán
disponibles para otros módulos de la compilación. Cuando el código de un módulo
hace referencia a tipos internal de otro, se deben incorporar los dos módulos en un
manifiesto del ensamblado, mediante AddModules. No se admite la creación de un
módulo en el entorno de desarrollo de Visual Studio.

winexe
La opción winexe hace que el compilador cree un programa de Windows ejecutable
(EXE). El archivo ejecutable se creará con la extensión .exe. Un programa de Windows es
el que ofrece una interfaz de usuario de la biblioteca de .NET o con las API Windows.
Use exe para crear una aplicación de consola. A menos que se especifique de otro
modo con la opción OutputAssembly, el nombre del archivo de salida toma el nombre
del archivo de entrada que contiene el método Main. Solo se necesita un método Main
en los archivos de código fuente que se compilan en un archivo .exe. La opción
StartupObject le permite especificar qué clase contiene el método Main , en aquellos
casos en los que el código tenga más de una clase con un método Main .

winmdobj
Si usa la opción winmdobj, el compilador crea un archivo .winmdobj intermedio que se
puede convertir en un archivo binario de Windows Runtime ( .winmd). Después, el
archivo .winmd se puede usar en programas de JavaScript y C++, además de programas
de lenguajes administrados.
El valor winmdobj indica al compilador que un módulo intermedio es obligatorio.
Después, el archivo .winmdobj se puede proporcionar por medio de la herramienta de
exportación WinMDExp para generar un archivo de metadatos de Windows ( .winmd). El
archivo .winmd contiene el código de la biblioteca original y los metadatos de WinMD
que usan JavaScript o C++, y Windows Runtime. La salida de un archivo compilado
mediante la opción del compilador winmdobj solo se usa como entrada de la
herramienta de exportación WimMDExp. No se hace referencia directamente al archivo
.winmdobj. A menos que use la opción OutputAssembly, el nombre del archivo de
salida tomar el del primer archivo de entrada. No se necesita un método Main.

appcontainerexe
Si usa la opción del compilador appcontainerexe, este crea un archivo ejecutable de
Windows ( .exe) que se debe ejecutar en un contenedor de la aplicación. Esta opción
equivale a -target:winexe, pero está diseñada para las aplicaciones de la Tienda
Windows 8.x.

Para exigir que la aplicación se ejecute en un contenedor de la aplicación, esta opción

establece un bit en el archivo portable ejecutable (PE). Cuando se establece ese bit, se
produce un error si el método CreateProcess intenta iniciar el archivo ejecutable fuera
de un contenedor de la aplicación. A menos que use la opción OutputAssembly, el
nombre del archivo de salida toma el del archivo de entrada que contiene el método
Main.
Opciones del compilador de C# que
especifican entradas
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Las opciones siguientes controlan las entradas del compilador. La nueva sintaxis de
MSBuild se muestra en negrita. La sintaxis de csc.exe anterior se muestra en code style .

References / -reference o -references : se hace referencia a los metadatos de los

archivos de ensamblado especificados.
AddModules / -addmodule : se agrega un módulo (creado con target:module para
este ensamblado).
EmbedInteropTypes / -link : se insertan metadatos de los archivos de
ensamblado de interoperabilidad especificados.

Referencias
La opción References hace que el compilador importe información de tipo public del
archivo especificado al proyecto actual, lo que permite hacer referencia a metadatos de
los archivos de ensamblado especificados.

XML

<Reference Include="filename" />

filename es el nombre de un archivo que contiene un manifiesto del ensamblado. Para

importar más de un archivo, incluya un elemento Reference diferente para cada archivo.
Puede definir un alias como un elemento secundario del elemento Reference:

XML

<Reference Include="filename.dll">

<Aliases>LS</Aliases>

</Reference>

En el ejemplo anterior, LS es el identificador de C# válido que representa un espacio de

nombres raíz que contendrá todos los espacios de nombres en el archivo filename.dll
del ensamblado. Los archivos que importe deben contener un manifiesto. Use
AdditionalLibPaths para especificar el directorio en el que se encuentran una o varias
de las referencias de ensamblado. En el tema AdditionalLibPaths también se describen
los directorios en los que el compilador busca ensamblados. Para que el compilador
reconozca un tipo de un ensamblado (y no de un módulo), debe obligársele a que
resuelva el tipo, lo que se puede conseguir si se define una instancia del tipo. Existen
otras formas de que el compilador resuelva nombres de tipos en un ensamblado; por
ejemplo, si se hereda de un tipo de un ensamblado, el compilador reconocerá el
nombre del tipo. A veces es necesario hacer referencia a dos versiones diferentes del
mismo componente desde un ensamblado. Para ello, use el elemento Aliases del
elemento References de cada archivo para distinguir entre los dos archivos. Este alias se
usará como calificador para el nombre del componente y se resolverá en el componente
de uno de los archivos.

７ Nota

En Visual Studio, use el comando Agregar referencia. Para obtener más

información, consulta Procedimiento para agregar o quitar referencias mediante
el Administrador de referencias.

AddModules
Esta opción agrega un módulo que se ha creado con el modificador
<TargetType>module</TargetType> para la compilación actual:

XML

<AddModule Include=file1 />

<AddModule Include=file2 />

Donde file , file2 son archivos de salida que contienen metadatos. El archivo no
puede contener un manifiesto del ensamblado. Para importar más de un archivo, hay
que separar los nombres de archivo con una coma o un punto y coma. Todos los
módulos agregados con AddModules deben encontrarse en el mismo directorio que el
archivo de salida en tiempo de ejecución. Es decir, puede especificar un módulo de
cualquier directorio en el momento de la compilación, pero el módulo debe encontrarse
en el directorio de la aplicación en tiempo de ejecución. Si el módulo no se encuentra
en el directorio de la aplicación en tiempo de ejecución, obtendrá TypeLoadException.
file no puede contener ningún ensamblado. Por ejemplo, si el archivo de salida se ha

creado con la opción TargetType de module, sus metadatos se pueden importar con
AddModules.

Si el archivo de salida se ha creado con una opción TargetType diferente de module, no

se podrán importar sus metadatos con AddModules, pero sí con References.
EmbedInteropTypes
Hace que el compilador facilite al proyecto que se está compilando información de tipos
COM en los ensamblados especificados.

XML

<References>

<EmbedInteropTypes>file1;file2;file3</EmbedInteropTypes>

</References>

Donde file1;file2;file3 es una lista de nombres de archivo de ensamblado

delimitados por signos de punto y coma. Si el nombre de archivo contiene un espacio,
escríbalo entre comillas. La opción EmbedInteropTypes permite implementar una
aplicación que tiene información de tipo insertada. La aplicación puede usar los tipos de
un ensamblado en tiempo de ejecución que implementan la información de tipo
incrustada sin necesidad de una referencia al ensamblado en tiempo de ejecución. Si
hay varias versiones del ensamblado en tiempo de ejecución publicadas, la aplicación
que contiene la información de tipo incrustada puede trabajar con las distintas versiones
sin tener que volver a compilar. Para obtener un ejemplo, vea Tutorial: Insertar los tipos
de los ensamblados administrados.

La opción EmbedInteropTypes resulta de especial utilidad cuando se trabaja con la

interoperabilidad COM. Puede incrustar tipos COM para que la aplicación ya no necesite
un ensamblado de interoperabilidad primario (PIA) en el equipo de destino. La opción
EmbedInteropTypes indica al compilador que inserte la información de tipo COM del
ensamblado de interoperabilidad al que se hace referencia en el código compilado
resultante. El tipo COM se identifica mediante el valor de CLSID (GUID). Como resultado,
la aplicación se puede ejecutar en un equipo de destino que tenga instalados los
mismos tipos COM con los mismos valores de CLSID. Las aplicaciones que automatizan
Microsoft Office son un buen ejemplo. Dado que las aplicaciones como Office suelen
mantener el mismo valor de CLSID en las distintas versiones, la aplicación puede usar los
tipos COM a los que se hace referencia siempre que .NET Framework 4 o posterior esté
instalado en el equipo de destino y la aplicación emplee métodos, propiedades o
eventos que estén incluidos en los tipos COM a los que se hace referencia. La opción
EmbedInteropTypes solo inserta interfaces, estructuras y delegados. No se admite la
inserción de clases COM.

７ Nota

Cuando se crea una instancia de un tipo COM incrustado en el código, hay que
crear la instancia mediante la interfaz adecuada. Si se intenta crear una instancia de
 un tipo COM incrustado mediante la coclase, se produce un error.

Como sucede con la opción del compilador References, la opción del compilador
EmbedInteropTypes usa el archivo de respuesta Csc.rsp, que hace referencia a
ensamblados de .NET usados con frecuencia. Use la opción del compilador NoConfig si
no quiere que el compilador utilice el archivo Csc.rsp.

C#

// The following code causes an error if ISampleInterface is an embedded

interop type.

ISampleInterface<SampleType> sample;

Los tipos que tienen un parámetro genérico cuyo tipo se ha incrustado desde un
ensamblado de interoperabilidad no se pueden usar si ese tipo pertenece a un
ensamblado externo. Esta restricción no se aplica a las interfaces. Por ejemplo, considere
la interfaz Range que se define en el ensamblado Microsoft.Office.Interop.Excel. Si una
biblioteca inserta tipos de interoperabilidad desde el ensamblado
Microsoft.Office.Interop.Excel y expone un método que devuelve un tipo genérico que
tiene un parámetro cuyo tipo es la interfaz Range, ese método debe devolver una
interfaz genérica, como se muestra en el ejemplo de código siguiente.

C#

using System;

using System.Collections.Generic;
using System.Linq;

using System.Text;

using Microsoft.Office.Interop.Excel;

public class Utility

// The following code causes an error when called by a client assembly.

public List<Range> GetRange1()

return null;

// The following code is valid for calls from a client assembly.

public IList<Range> GetRange2()

return null;

En el ejemplo siguiente, el código de cliente puede llamar al método que devuelve la

interfaz genérica IList sin errores.

C#

public class Client

public void Main()

Utility util = new Utility();

// The following code causes an error.

List<Range> rangeList1 = util.GetRange1();

// The following code is valid.

List<Range> rangeList2 = (List<Range>)util.GetRange2();

Opciones del compilador de C#:

notificación de errores y advertencias
Artículo • 28/11/2022 • Tiempo de lectura: 6 minutos

Las opciones siguientes controlan cómo el compilador notifica los errores y las
advertencias. La nueva sintaxis de MSBuild se muestra en negrita. La sintaxis de csc.exe
anterior se muestra en code style .

WarningLevel / -warn : se establece el nivel de advertencia.

AnalysisLevel: se establece el nivel de advertencia opcional.
TreatWarningsAsErrors / -warnaserror : todas las advertencias se tratan como
errores.
WarningsAsErrors / -warnaserror : una o varias advertencias se tratan como
errores
WarningsNotAsErrors / -warnnotaserror : una o varias advertencias no se tratan
como errores
NoWarn / -nowarn : establezca una lista de advertencias deshabilitadas.
CodeAnalysisRuleSet / -ruleset : se especifica un archivo de conjunto de reglas
que deshabilita diagnósticos específicos.
ErrorLog / -errorlog : se especifica un archivo para registrar todos los diagnósticos
del compilador y el analizador.
ReportAnalyzer / -reportanalyzer : se notifica información adicional del
analizador, como el tiempo de ejecución.

WarningLevel
La opción WarningLevel especifica el nivel de advertencia que debe mostrar el
compilador.

XML

<WarningLevel>3</WarningLevel>

El valor del elemento es el nivel de advertencia que quiere que se muestre para la
compilación: los números más bajos muestran solo advertencias de gravedad alta. Los
números más altos muestran más advertencias. El valor debe ser cero o un entero
positivo:
 Nivel de Significado
advertencia

0 Desactiva la emisión de todos los mensajes de advertencia.

1 Muestra mensajes de advertencia graves.

2 Muestra advertencias de nivel 1 además de determinadas advertencias menos

graves, como advertencias sobre ocultar miembros de clase.

3 Muestra advertencias de nivel 2 además de determinadas advertencias menos

graves, como advertencias sobre expresiones que siempre se evalúan como
true o false .

4 (el valor Muestra todas las advertencias de nivel 3 además de advertencias

predeterminado) informativas.

２ Advertencia

La línea de comandos del compilador acepta valores mayores que 4 para permitir
advertencias de ola de advertencias. Sin embargo, el SDK de .NET establece
WarningLevel para que coincida con AnalysisLevel en el archivo del proyecto.

Para información sobre un error o advertencia, puede buscar el código de error en el

Índice de la Ayuda. Para conocer otras maneras de obtener información sobre un error o
advertencia, vea Errores del compilador de C#. Use TreatWarningsAsErrors para tratar
todas las advertencias como errores. Use DisabledWarnings para deshabilitar
advertencias concretas.

Nivel de análisis
Nivel de análisis Significado

5 Muestra todas las advertencias opcionales de la ola 5 de advertencias.

6 Muestra todas las advertencias opcionales de la ola 6 de advertencias.

7 Muestra todas las advertencias opcionales de la ola 7 de advertencias.

más reciente (valor Muestra todas las advertencias informativas hasta la versión actual
predeterminado) (esta inclusive).

Vista previa Muestra todas las advertencias informativas hasta la versión

preliminar más reciente (esta inclusive).

None Desactiva todas las advertencias informativas.

Para más información sobre las advertencias opcionales, consulte Olas de advertencias.

Para obtener información sobre un error o advertencia, puede buscar el código de error
en el Índice de la Ayuda. Para conocer otras maneras de obtener información sobre un
error o advertencia, vea Errores del compilador de C#. Use TreatWarningsAsErrors para
tratar todas las advertencias como errores. Use NoWarn para deshabilitar ciertas
advertencias.

TreatWarningsAsErrors
La opción TreatWarningsAsErrors trata todas las advertencias como errores. También
puede usar TreatWarningsAsErrors para establecer solo algunas advertencias como
errores. Si activa TreatWarningsAsErrors, puede usar WarningsNotAsErrors para
enumerar las advertencias que no se deben tratar como errores.

XML

<TreatWarningsAsErrors>true</TreatWarningsAsErrors>

En su lugar, todos los mensajes de advertencia se notifican como errores. El proceso de

compilación se detiene (no se genera ningún archivo de salida). De forma
predeterminada, TreatWarningsAsErrors no está en efecto, lo que significa que las
advertencias no impedirán la generación de un archivo de salida. Opcionalmente, si solo
quiere que algunas advertencias específicas se traten como errores, puede especificar
una lista separada por comas de números de advertencia que se tratarán como errores.
Se puede especificar el conjunto de todas las advertencias de nulabilidad con la
abreviatura Nullable. Use WarningLevel para especificar el nivel de advertencias que
quiere que muestre el compilador. Use NoWarn para deshabilitar ciertas advertencias.

） Importante

Hay dos diferencias sutiles entre el uso del elemento <TreatWarningsAsErrors> en

el archivo csproj y el uso del modificador de línea de comandos de MSBuild
warnaserror . TreatWarningsAsErrors solo afecta al compilador de C#, no a ninguna
otra tarea de MSBuild del archivo csproj. El modificador de línea de comandos
warnaserror afecta a todas las tareas. En segundo lugar, el compilador no genera
ninguna salida en ninguna advertencia cuando se usa TreatWarningsAsErrors. El
compilador genera la salida cuando se usa el modificador de línea de comandos
warnaserror .
WarningsAsErrors y WarningsNotAsErrors
Las opciones WarningsAsErrors y WarningsNotAsErrors invalidan la opción
TreatWarningsAsErrors de una lista de advertencias. Esta opción se puede usar con
todas las advertencias de CS. El prefijo "CS" es opcional. Puede usar el número o "CS"
seguido del número de error o advertencia. Para ver otros elementos que afectan a las
advertencias, consulte las propiedades comunes de MSBuild.

Habilite las advertencias 0219 y 0168 como errores:

XML

<WarningsAsErrors>0219,CS0168</WarningsAsErrors>

Deshabilite las mismas advertencias como errores:

XML

<WarningsNotAsErrors>0219,CS0168</WarningsNotAsErrors>

Use WarningsAsErrors para configurar un conjunto de advertencias como errores. Use

WarningsNotAsErrors para configurar un conjunto de advertencias que no deben ser
errores cuando se han establecido todas las advertencias como errores.

NoWarn
La opción NoWarn permite suprimir el compilador para mostrar una o varias
advertencias. Separe varios números de advertencia con una coma.

XML

<NoWarn>number1, number2</NoWarn>

number1 , number2 Números de advertencia que quiere que el compilador suprima. Debe

especificar la parte numérica del identificador de advertencia. Por ejemplo, si quiere

suprimir CS0028, podría especificar <NoWarn>28</NoWarn> . El compilador omite
silenciosamente los números de advertencia pasados a NoWarn que eran válidos en
versiones anteriores, pero que se han quitado. Por ejemplo, CS0679 era válido en el
compilador de Visual Studio .NET 2002, pero se ha eliminado posteriormente.

La opción NoWarn no puede suprimir las siguientes advertencias:

 Advertencia del compilador (nivel 1) CS2002
Advertencia del compilador (nivel 1) CS2023
Advertencia del compilador (nivel 1) CS2029

CodeAnalysisRuleSet
Especifica un archivo de conjunto de reglas que configura diagnósticos específicos.

XML

<CodeAnalysisRuleSet>MyConfiguration.ruleset</CodeAnalysisRuleSet>

MyConfiguration.ruleset es la ruta del archivo de conjunto de reglas. Para obtener más

información sobre el uso de conjuntos de reglas, vea el artículo en la documentación de
Visual Studio sobre conjuntos de reglas.

ErrorLog
Especifique un archivo para registrar todos los diagnósticos del compilador y el
analizador.

XML

<ErrorLog>compiler-diagnostics.sarif</ErrorLog>

La opción ErrorLog hace que el compilador genere un registro de formato de

intercambio de resultados de análisis estático (SARIF) . Los registros SARIF suelen ser
leídos por herramientas que analizan los resultados de los diagnósticos del compilador
y el analizador.

Puede especificar el formato SARIF mediante el argumento version para el elemento

ErrorLog :

XML

<ErrorLog>logVersion21.json,version=2.1</ErrorLog>

El separador puede ser una coma ( , ) o un punto y coma ( ; ). Los valores válidos para la
versión son: "1", "2" y "2.1". El valor predeterminado es "1". "2" y "2.1" significan la
versión 2.1.0 de SARIF.
ReportAnalyzer
Notifica información adicional del analizador, como el tiempo de ejecución.

XML

<ReportAnalyzer>true</ReportAnalyzer>

La opción ReportAnalyzer hace que el compilador emita información de registro de

MSBuild adicional en la que se detallan las características de rendimiento de los
analizadores de la compilación. Los creadores del analizador la usan normalmente como
parte de la validación del analizador.

） Importante

La información de registro adicional generada por esta marca solo se genera

cuando se usa la opción de línea de comandos -verbosity:detailed . Consulte el
artículo modificadores de la documentación de MSBuild para obtener más
información.
Opciones del compilador de C# para
controlar la generación de código
Artículo • 13/03/2023 • Tiempo de lectura: 5 minutos

Las opciones siguientes controlan la generación de código mediante el compilador. La

nueva sintaxis de MSBuild se muestra en negrita. La sintaxis de csc.exe anterior se
muestra en code style .

DebugType / -debug : se emite (o no se emite) información de depuración.

Optimize / -optimize : se habilitan las optimizaciones.
Deterministic / -deterministic : se genera una salida equivalente byte a byte del
mismo origen de entrada.
ProduceOnlyReferenceAssembly / -refonly : se genera un ensamblado de
referencia, en lugar de un ensamblado completo, como resultado principal.

DebugType
La opción DebugType hace que el compilador genere información de depuración y la
incluya en el archivo o los archivos de salida. La información de depuración se ha
agregado de forma predeterminada.

XML

<DebugType>pdbonly</DebugType>

En todas las versiones del compilador a partir de C# 6.0, no hay ninguna diferencia entre
pdbonly y full. Elija pdbonly. Para cambiar la ubicación del archivo .pdb, vea PdbFile.

Valores válidos son:

Valor Significado

full Emita la información de depuración al archivo .pdb usando el formato

predeterminado para la plataforma actual:

Windows: un archivo .pdb de Windows.

Linux/macOS: un archivo .pdb portátil .

pdbonly Igual a full . Vea la nota siguiente para obtener más información.

portable Emita la información de depuración en el archivo .pdb mediante el formato PDB

portátil multiplataforma.
 Valor Significado

embedded Emita la información de depuración en el propio archivo .dll/.exe (no se genera el

archivo .pdb ) con el formato .pdb portátil .

） Importante

La información siguiente se aplica solo a los compiladores anteriores a C# 6.0.

El
valor de este elemento puede ser full o pdbonly . El argumento full, que es la
opción predeterminada si no se especifica pdbonly, permite adjuntar un depurador
al programa en ejecución. Al especificar pdbonly se permite depurar el código
fuente cuando se inicia el programa en el depurador, pero solo se mostrará el
ensamblador cuando el programa en ejecución se adjunta al depurador. Use esta
opción para crear versiones de depuración. Si usa Full, tenga en cuenta que se
producirá cierto impacto en la velocidad y el tamaño del código optimizado por JIT
y un pequeño impacto en la calidad del código con full. Se recomienda pdbonly o
ningún PDB para generar el código de la versión de lanzamiento. Una diferencia
entre pdbonly y full es que con full el compilador emite una instancia de
DebuggableAttribute, que se usa para indicar al compilador JIT que la información
de depuración está disponible. Por tanto, aparecerá un error si el código contiene
DebuggableAttribute establecido en false cuando se usa full. Para obtener más
información sobre cómo configurar el rendimiento de depuración de una
aplicación, vea Facilitar la depuración de una imagen.

Optimización
La opción Optimización habilita o deshabilita las optimizaciones realizadas por el
compilador para que el archivo de salida sea menor, más rápido y más eficaz. La opción
Optimización está habilitada de forma predeterminada para una configuración de
compilación de versión. Está desactivada de forma predeterminada para una
configuración de compilación de depuración.

XML

<Optimize>true</Optimize>

La opción Optimización se establece en la página de propiedades de compilación del

proyecto en Visual Studio.
Optimización también indica a Common Language Runtime que optimice el código en
tiempo de ejecución. De forma predeterminada, las optimizaciones están deshabilitadas.
Especifique Optimize+ para habilitar las optimizaciones. Al compilar un módulo para
que lo use un ensamblado, use la misma configuración de Optimización que la del
ensamblado. Se pueden combinar las opciones Optimización y Depuración.

Determinista
Hace que el compilador genere un ensamblado cuya salida byte a byte es idéntica en
todas las compilaciones para las entradas idénticas.

XML

<Deterministic>true</Deterministic>

De forma predeterminada, la salida del compilador de un conjunto determinado de

entradas es única, ya que el compilador agrega una marca de tiempo y un MVID (un
Module.ModuleVersionId, básicamente es un GUID que identifica de forma única el
módulo y la versión) que se genera a partir de números aleatorios. Use la opción
<Deterministic> para generar un ensamblado determinista, cuyo contenido binario es

idéntico en todas las compilaciones, siempre y cuando la entrada siga siendo la misma.
En este tipo de compilación, los campos timestamp y MVID se reemplazarán por los
valores derivados de un hash de todas las entradas de la compilación. El compilador
tiene en cuenta las siguientes entradas que afectan al determinismo:

La secuencia de parámetros de la línea de comandos.

El contenido del archivo de respuesta .rsp del compilador.
La versión exacta del compilador que se usa y los ensamblados a los que se hace
referencia.
La ruta de acceso del directorio actual.
El contenido binario de todos los archivos pasados explícitamente al compilador,
ya sea de manera directa o indirecta, incluidos los siguientes:
Archivos de código fuente
Ensamblados a los que se hace referencia
Módulos a los que se hace referencia
Recursos
Archivo de clave de nombre seguro
Archivos de respuesta @
Analizadores
Conjuntos de reglas
Otros archivos que pueden usar los analizadores
 La referencia cultural actual (para el idioma en el que se producen los diagnósticos
y los mensajes de excepción).
La codificación predeterminada (o página de códigos actual) si no se especifica la
codificación.
La existencia (o la inexistencia) de archivos y su contenido en las rutas de
búsqueda del compilador (especificada, por ejemplo, mediante -lib o -recurse ).
La plataforma de Common Language Runtime (CLR) en la que se ejecuta el
compilador.
El valor de %LIBPATH% , que pueden afectar a la carga de dependencias del
analizador.

Se puede usar la compilación determinista para establecer si un archivo binario se

compila a partir de un origen de confianza. La salida determinista puede ser útil cuando
el origen está disponible públicamente. También puede determinar si los pasos de
compilación dependen de los cambios en los binarios que se usan en el proceso de
compilación.

ProduceOnlyReferenceAssembly
La opción ProduceOnlyReferenceAssembly indica que un ensamblado de referencia se
debe mostrar en lugar de un ensamblado de implementación, como el resultado
principal. El parámetro ProduceOnlyReferenceAssembly deshabilita de forma
automática la generación de archivos PDB, ya que los ensamblados de referencia no se
pueden ejecutar.

XML

<ProduceOnlyReferenceAssembly>true</ProduceOnlyReferenceAssembly>

Los ensamblados de referencia son un tipo especial de ensamblado. Los ensamblados

de referencia solo contienen la cantidad mínima de metadatos necesarios para
representar la superficie de API públicas de la biblioteca. Incluyen declaraciones para
todos los miembros que son significativos al hacer referencia a un ensamblado en las
herramientas de compilación, pero excluyen todas las implementaciones de miembros y
las declaraciones de miembros privados que no tienen ningún impacto observable en su
contrato de API. Para obtener más información, vea Ensamblados de referencia.

Las opciones ProduceOnlyReferenceAssembly y ProduceReferenceAssembly son

mutuamente excluyentes.
Opciones del compilador de C# para la
seguridad
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Las opciones siguientes controlan las opciones de seguridad del compilador. La nueva
sintaxis de MSBuild se muestra en negrita. La sintaxis de csc.exe anterior se muestra en
code style .

PublicSign / -publicsign : se firma el ensamblado públicamente.

DelaySign / -delaysign : se retrasa la firma del ensamblado usando solo la parte
pública de la clave de nombre seguro.
KeyFile / -keyfile : se especifica un archivo de clave con nombre seguro.
KeyContainer / -keycontainer : se especifica un contenedor de claves con nombre
seguro.
HighEntropyVA / -highentropyva : se habilita la selección aleatoria del diseño del
espacio de direcciones (ASLR) de alta entropía.

PublicSign
Esta opción hace que el compilador aplique una clave pública pero no firma el
ensamblado. La opción PublicSign también establece un bit en el ensamblado que
indica al entorno de ejecución que el archivo está firmado.

XML

<PublicSign>true</PublicSign>

Para la opción PublicSign es necesario usar la opción KeyFile o KeyContainer. Las

opciones KeyFile y KeyContainer especifican la clave pública. Las opciones PublicSign y
DelaySign son mutuamente excluyentes. A veces llamada "firma falsa" o "firma OSS", la
firma pública incluye la clave pública en un ensamblado de salida y establece la marca
"signed". La firma pública no firma realmente el ensamblado con una clave privada. Los
desarrolladores usan el signo público para los proyectos de código abierto. Los usuarios
crean ensamblados que son compatibles con los ensamblados "totalmente firmados"
publicados cuando no tienen acceso a la clave privada utilizada para firmar los
ensamblados. Como prácticamente ningún consumidor necesita realmente comprobar
si el ensamblado está firmado de forma completa, estos ensamblados creados de forma
pública se pueden utilizar en casi todos los escenarios en los que se utilizaría el
ensamblado totalmente firmado.
DelaySign
Esta opción hace que el compilador reserve espacio en el archivo de salida de manera
que se pueda agregar una firma digital más adelante.

XML

<DelaySign>true</DelaySign>

Use DelaySign- si quiere un ensamblado completamente firmado. Use DelaySign si solo

quiere incluir la clave pública en el ensamblado. La opción DelaySign no tiene ningún
efecto a menos que se use con KeyFile o KeyContainer. Las opciones KeyContainer y
PublicSign son mutuamente excluyentes. Cuando se solicita un ensamblado totalmente
firmado, el compilador genera un valor hash para el archivo que contiene el manifiesto
(metadatos del ensamblado) y firma dicho valor mediante la clave privada. Esta
operación crea una firma digital que se almacena en el archivo que contiene el
manifiesto. Cuando se retrasa la firma de un ensamblado, el compilador no procesa ni
almacena la firma. En su lugar, reserva espacio en el archivo para que la firma se pueda
agregar después.

El uso de DelaySign permite a un evaluador colocar el ensamblado en la caché global.

Después de realizar las pruebas, coloque la clave privada en el ensamblado mediante la
utilidad Assembly Linker para firmar el ensamblado por completo. Para obtener más
información, vea Crear y usar ensamblados con nombre seguro y Retraso de la firma de
un ensamblado.

KeyFile
Especifica el nombre de archivo que contiene la clave criptográfica.

XML

<KeyFile>filename</KeyFile>

file es el nombre del archivo que contiene la clave de nombre seguro. Cuando se usa
esta opción, el compilador inserta la clave pública del archivo especificado en el
manifiesto del ensamblado y, después, firma el último ensamblado con la clave privada.
Para generar un archivo de claves, escriba sn -k file en la línea de comandos. Si se
compila con -target:module, el nombre del archivo de claves se mantiene en el módulo
y se incorpora en el ensamblado que se crea al compilarlo con AddModules. También
puede pasar la información de cifrado al compilador con KeyContainer. Use DelaySign
si quiere firmar el ensamblado de forma parcial. Si se especifica tanto KeyFile como
KeyContainer en la misma compilación, el compilador probará primero el contenedor
de claves. Si lo consigue, el ensamblado se firma con la información del contenedor de
claves. Si el compilador no encuentra el contenedor de claves, probará el archivo
especificado con KeyFile. Si la operación es correcta, el ensamblado se firma con la
información del archivo de clave y la información de la clave se instalará en el
contenedor de claves. En la siguiente compilación, el contenedor de claves será válido.
Es posible que un archivo de clave solo contenga la clave pública. Para obtener más
información, vea Crear y usar ensamblados con nombre seguro y Retraso de la firma de
un ensamblado.

KeyContainer
Especifica el nombre del contenedor de claves criptográficas.

XML

<KeyContainer>container</KeyContainer>

container es el nombre del contenedor de claves de nombre seguro. Cuando se usa la

opción KeyContainer, el compilador crea un componente que se puede compartir. El

compilador inserta una clave pública del contenedor especificado en el manifiesto del
ensamblado y firma el último ensamblado con la clave privada. Para generar un archivo
de claves, escriba sn -k file en la línea de comandos. sn -i instala el par de claves en
un contenedor. Esta opción no se admite cuando el compilador se ejecuta en CoreCLR.
Para firmar un ensamblado al compilar en CoreCLR, use la opción KeyFile. Si realiza la
compilación con TargetType, el nombre del archivo de claves se mantiene en el módulo
y se incorpora al ensamblado al compilar este módulo en un ensamblado con
AddModules. También se puede especificar esta opción como un atributo personalizado
(System.Reflection.AssemblyKeyNameAttribute) en el código fuente de cualquier
módulo del Lenguaje Intermedio de Microsoft (MSIL). También se puede pasar la
información de cifrado al compilador con KeyFile. Use DelaySign para agregar la clave
pública al manifiesto del ensamblado pero firmarlo cuando se haya probado. Para
obtener más información, vea Crear y usar ensamblados con nombre seguro y Retraso
de la firma de un ensamblado.

HighEntropyVA
La opción del compilador HighEntropyVA indica al kernel de Windows si un archivo
ejecutable determinado admite la selección aleatoria del diseño del espacio de
direcciones (ASLR) de alta entropía.

XML

<HighEntropyVA>true</HighEntropyVA>

Esta opción especifica que un archivo ejecutable de 64 bits o un archivo ejecutable

marcado con la opción del compilador PlatformTarget admite un espacio de
direcciones virtuales de alta entropía. La opción está habilitada de forma
predeterminada para todas las versiones de .NET Standard y .NET Core, y las versiones
de .NET Framework a partir de .NET Framework 4.5.

La opción HighEntropyVA habilita las versiones compatibles del kernel de Windows

para usar niveles superiores de entropía al aleatorizar el diseño del espacio de
direcciones de un proceso como parte de ASLR. El uso de niveles superiores de entropía
significa que un mayor número de direcciones se puede asignar a las regiones de
memoria como pilas y montones. Como resultado, la ubicación de un área de memoria
concreta es más difícil de adivinar. La opción del compilador HighEntropyVA necesita
que el archivo ejecutable de destino y todos los módulos de los que depende puedan
controlar los valores de puntero superiores a 4 gigabytes (GB), cuando se ejecutan como
un proceso de 64 bits.
Opciones del compilador de C# que
especifican recursos
Artículo • 15/02/2023 • Tiempo de lectura: 5 minutos

Las opciones siguientes controlan cómo el compilador de C# crea o importa recursos de

Win32. La nueva sintaxis de MSBuild se muestra en negrita. La sintaxis de csc.exe
anterior se muestra en code style .

Win32Resource / -win32res : se especifica un archivo de recursos (.res) de Win32.

Win32Icon / -win32icon : se hace referencia a los metadatos de los archivos de
ensamblado especificados.
Win32Manifest / -win32manifest :se especifica un archivo de manifiesto (.xml) de
Win32.
NoWin32Manifest / -nowin32manifest : no se incluye el manifiesto de Win32
predeterminado.
Resources / -resource : se inserta el recurso especificado (forma abreviada: /res).
LinkResources / -linkresources :se vincula el recurso especificado a este
ensamblado.

Win32Resource
La opción Win32Resource inserta un recurso de Win32 en el archivo de salida.

XML

<Win32Resource>filename</Win32Resource>

filename es el archivo de recursos que se quiere agregar al archivo de salida. Un

recurso de Win32 puede contener información de versión o de mapa de bits (icono) que
ayudaría a identificar la aplicación en el Explorador de archivos. Si no especifica esta
opción, el compilador generará información de versión en función de la versión del
ensamblado.

Win32Icon
La opción Win32Icon inserta un archivo .ico en el archivo de salida, lo que proporciona
al archivo de salida la apariencia esperada en el Explorador de archivos.

XML
 <Win32Icon>filename</Win32Icon>

filename es el archivo .ico que quiere agregar al archivo de salida. Se puede crear un

archivo .ico con el Compilador de recursos. El Compilador de recursos se invoca al

compilar un programa de Visual C++ y se crea un archivo .ico a partir del archivo .rc.

Win32Manifest
Use la opción Win32Manifest para especificar un archivo de manifiesto de aplicación
Win32 definido por el usuario que se va a insertar en un archivo portable ejecutable (PE)
del proyecto.

XML

<Win32Manifest>filename</Win32Manifest>

filename es el nombre y la ubicación del archivo de manifiesto personalizado. De forma

predeterminada, el compilador de C# inserta un manifiesto de aplicación que especifica

un nivel de ejecución solicitado de "asInvoker". Crea el manifiesto en la misma carpeta
en la que se compila el ejecutable. Si quiere proporcionar un manifiesto personalizado,
por ejemplo para especificar un nivel de ejecución solicitado de "highestAvailable" o
"requireAdministrator", use esta opción para especificar el nombre del archivo.

７ Nota

Esta opción y Win32Resources son mutuamente excluyentes. Si intenta usar ambas

en la misma línea de comandos, obtendrá un error de compilación.

Una aplicación sin manifiesto de aplicación que especifique un nivel de ejecución

solicitado estará sujeta a virtualización de archivos y Registro conforme a la
característica Control de cuentas de usuario de Windows. Para más información, vea
User Account Control (Control de cuentas de usuario).

La aplicación estará sujeta a virtualización si se cumple cualquiera de estas condiciones:

Se usa la opción NoWin32Manifest y no se proporciona ningún manifiesto en un

paso de compilación posterior o como parte de un archivo de recursos de
Windows ( .res) mediante la opción Win32Resource.
Se proporciona un manifiesto personalizado que no especifica un nivel de
ejecución solicitado.
Visual Studio crea un archivo .manifest predeterminado y lo almacena en los directorios
de depuración y versión junto con el archivo ejecutable. Puede agregar un manifiesto
personalizado si crea uno en cualquier editor de texto y luego lo agrega al proyecto. O
bien, puede hacer clic con el botón derecho en el icono Proyecto del Explorador de
soluciones, seleccionar Agregar nuevo elemento y luego Archivo de manifiesto de
aplicación. Después de haber agregado el archivo de manifiesto nuevo o existente,
aparecerá en la lista desplegable Manifiesto. Para más información, vea Página de
aplicación, Diseñador de proyectos (C#).

Puede proporcionar el manifiesto de aplicación como un paso personalizado posterior a

la compilación o como parte de un archivo de recursos Win32 con la opción
NoWin32Manifest. Use esa misma opción si quiere que la aplicación esté sujeta a
virtualización de archivos y Registro en Windows Vista.

NoWin32Manifest
Use la opción NoWin32Manifest para indicar al compilador que no inserte ningún
manifiesto de aplicación en el archivo ejecutable.

XML

<NoWin32Manifest />

Cuando se use esta opción, la aplicación estará sujeta a la virtualización en Windows

Vista a menos que proporcione un manifiesto de aplicación en un archivo de recursos
Win32 o durante un paso de compilación posterior.

En Visual Studio, defina esta opción en la página de propiedades de la aplicación

seleccionando la opción Crear aplicación sin manifiesto en la lista desplegable
Manifiesto. Para más información, vea Página de aplicación, Diseñador de proyectos
(C#).

Recursos
Inserta el recurso especificado en el archivo de salida.

XML

<Resources Include=filename>

<LogicalName>identifier</LogicalName>

<Access>accessibility-modifier</Access>

</Resources>

filename es el archivo de recursos de .NET que quiere insertar en el archivo de salida.

identifier (opcional) es el nombre lógico del recurso, que se usa para cargarlo. El valor
predeterminado es el nombre del archivo. accessibility-modifier (opcional) es la
accesibilidad del recurso: pública o privada. El valor predeterminado es public. De
manera predeterminada, los recursos son públicos en el ensamblado cuando se crean
mediante el compilador de C#. Para que sean privados, especifique el modificador de
accesibilidad private . No se permite ninguna otra accesibilidad distinta de public o
private . Si filename es un archivo de recursos de .NET creado, por ejemplo, con

Resgen.exe o en el entorno de desarrollo, se puede acceder a él con miembros del

espacio de nombres System.Resources. Para obtener más información, vea
System.Resources.ResourceManager. Para todos los demás recursos, use los métodos
GetManifestResource de la clase Assembly para tener acceso al recurso en tiempo de
ejecución. El orden de los recursos en el archivo de salida se determina a partir del
orden especificado en el archivo del proyecto.

LinkResources
Crea un vínculo a un recurso de .NET en el archivo de salida. El archivo de recursos no se
agrega al archivo de salida. LinkResources difiere de la opción Resource, que sí inserta
un archivo de recursos en el archivo de salida.

XML

<LinkResources Include=filename>

<LogicalName>identifier</LogicalName>

<Access>accessibility-modifier</Access>

</LinkResources>

filename es el archivo de recursos de .NET con el que quiere crear un vínculo desde el
ensamblado. identifier (opcional) es el nombre lógico del recurso, que se usa para
cargarlo. El valor predeterminado es el nombre del archivo. accessibility-modifier
(opcional) es la accesibilidad del recurso: pública o privada. El valor predeterminado es
public. De manera predeterminada, los recursos vinculados son públicos en el
ensamblado cuando se crean con el compilador de C#. Para que sean privados,
especifique el modificador de accesibilidad private . No se permite ningún otro
modificador distinto de public o private . Si filename es un archivo de recursos de
.NET creado, por ejemplo, con Resgen.exe o en el entorno de desarrollo, se puede
acceder a él con miembros del espacio de nombres System.Resources. Para obtener más
información, vea System.Resources.ResourceManager. Para todos los demás recursos,
use los métodos GetManifestResource de la clase Assembly para tener acceso al recurso
en tiempo de ejecución. El archivo especificado en filename puede tener cualquier
formato. Por ejemplo, se puede hacer que una DLL nativa forme parte de un
ensamblado para que se pueda instalar en la caché global de ensamblados y sea
accesible desde código administrado del ensamblado. También es posible realizar lo
mismo en Assembly Linker. Para obtener más información, vea Al.exe (Assembly Linker)
y Trabajar con ensamblados y la memoria caché global de ensamblados.
Otras opciones del compilador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Las opciones siguientes controlan distintos comportamientos del compilador. La nueva

sintaxis de MSBuild se muestra en negrita. La sintaxis de línea de comandos csc.exe
anterior se muestra en code style .

ResponseFiles / @CustomOpts.RSP : lea el archivo de respuesta especificado para

obtener más opciones.
NoLogo / -nologo : se suprime el mensaje de copyright del compilador.
NoConfig / -noconfig : no incluya automáticamente el archivo CSC.RSP .

ResponseFiles
La opción ResponseFiles le permite especificar un archivo que contiene opciones del
compilador y archivos de código fuente para compilar.

XML

<ResponseFiles>response_file</ResponseFiles>

response_file especifica el archivo en el que se enumeran las opciones del compilador

o los archivos de código fuente que se van a compilar. El compilador procesará las
opciones del compilador y los archivos de código fuente como si se hubieran
especificado en la línea de comandos. Para especificar más de un archivo de respuesta
en una compilación, especifique varias opciones de archivo de respuesta. En un archivo
de respuesta, puede haber varias opciones del compilador y archivos de código fuente
en una sola línea. Una sola especificación de opción del compilador debe aparecer en
una línea (no puede abarcar varias). Los archivos de respuesta pueden tener
comentarios que comiencen con el símbolo #. Especificar opciones del compilador
desde un archivo de respuesta es igual que enviar esos comandos en la línea de
comandos. El compilador procesa las opciones de comando a medida que se leen. Los
argumentos de línea de comandos pueden reemplazar las opciones enumeradas
anteriormente en archivos de respuesta. Por el contrario, las opciones en un archivo de
respuesta reemplazarán las opciones enumeradas anteriormente en la línea de
comandos o en otros archivos de respuesta. C# proporciona el archivo csc.rsp, que se
encuentra en el mismo directorio que el archivo csc.exe. Para obtener más información
sobre el formato de archivo de respuesta, vea NoConfig. No se puede establecer esta
opción del compilador en el entorno de desarrollo de Visual Studio, ni se puede cambiar
mediante programación. Estas son algunas líneas de un archivo de respuesta de
ejemplo:

Consola

# build the first output file

-target:exe -out:MyExe.exe source1.cs source2.cs

NoLogo
La opción NoLogo suprime la presentación del banner de inicio de sesión cuando se
inicia el compilador y muestra mensajes informativos durante la compilación.

XML

<NoLogo>true</NoLogo>

NoConfig
La opción NoConfig indica al compilador que no realice la compilación con el archivo
csc.rsp.

XML

<NoConfig>true</NoConfig>

El archivo csc.rsp hace referencia a todos los ensamblados incluidos en .NET Framework.

Las referencias reales que incluye el entorno de desarrollo Visual Studio de .NET
dependen del tipo de proyecto. Es posible modificar el archivo csc.rsp y especificar
opciones del compilador adicionales que se deban incluir en todas las compilaciones. Si
no quiere que el compilador busque y use la configuración del archivo csc.rsp,
especifique NoConfig. Esta opción del compilador no está disponible en Visual Studio y
no se puede cambiar mediante programación.
Opciones avanzadas del compilador de
C#
Artículo • 15/02/2023 • Tiempo de lectura: 11 minutos

Las opciones siguientes admiten escenarios avanzados. La nueva sintaxis de MSBuild se

muestra en negrita. La sintaxis de csc.exe anterior se muestra en code style .

MainEntryPoint, StartupObject / -main : se especifica el tipo que contiene el punto

de entrada.
PdbFile / -pdb : se especifica el nombre del archivo de información de depuración.
PathMap / -pathmap : se especifica una asignación para los nombres de rutas de
acceso de origen generados por el compilador.
ApplicationConfiguration / -appconfig : se especifica un archivo de configuración
de la aplicación que contenga la configuración de enlace de ensamblados.
AdditionalLibPaths / -lib : se especifican los directorios adicionales en los que
buscar referencias.
GenerateFullPaths / -fullpath : el compilador genera rutas de acceso completas.
PreferredUILang / -preferreduilang : se especifica el nombre del lenguaje de
salida preferido.
BaseAddress / -baseaddress : se especifica la dirección base de la biblioteca que se
va a compilar.
ChecksumAlgorithm / -checksumalgorithm : se especifica el algoritmo para calcular
la suma de comprobación del archivo de origen almacenada en el archivo PDB.
CodePage / -codepage : se especifica la página de códigos que se va a usar al abrir
los archivos de código fuente.
Utf8Output / -utf8output : se muestran los mensajes del compilador en
codificación UTF-8.
FileAlignment / -filealign : se especifica la alineación utilizada para las secciones
de archivos de salida.
ErrorEndLocation / -errorendlocation : se muestra la línea y la columna de salida
de la ubicación final de cada error.
NoStandardLib / -nostdlib : no se hace referencia a la biblioteca estándar
mscorlib.dll.
SubsystemVersion / -subsystemversion : se especifica la versión del subsistema de
este ensamblado.
ModuleAssemblyName / -moduleassemblyname : nombre del ensamblado del que
este módulo formará parte.
MainEntryPoint o StartupObject
Esta opción especifica la clase que contiene el punto de entrada al programa si hay más
de una clase que contenga un método Main .

XML

<StartupObject>MyNamespace.Program</StartupObject>

or

XML

<MainEntryPoint>MyNamespace.Program</MainEntryPoint>

Donde Program es el tipo que contiene el método Main . El nombre de clase

proporcionado debe ser completo: debe incluir el espacio de nombres completo que
contiene la clase, seguido del nombre de clase. Por ejemplo, cuando el método Main se
encuentra dentro de la clase Program en el espacio de nombres MyApplication.Core , la
opción del compilador tiene que ser -main:MyApplication.Core.Program . Si la
compilación incluye más de un tipo con un método Main, puede especificar qué tipo
contiene el método Main .

７ Nota

Esta opción no se puede usar para un proyecto que incluya instrucciones de nivel
superior, incluso si contiene uno o más métodos Main .

PdbFile
La opción del compilador PdbFile especifica el nombre y la ubicación del archivo de
símbolos de depuración. El valor filename especifica el nombre y la ubicación del
archivo de símbolos de depuración.

XML

<PdbFile>filename</PdbFile>

Al especificar DebugType, el compilador creará un archivo .pdb en el mismo directorio

donde creará el archivo de salida (.exe o .dll). El archivo .pdb tiene el mismo nombre de
archivo base que el del archivo de salida. PdbFile le permite especificar un nombre de
archivo y una ubicación distintos a los predeterminados para el archivo .pdb. No se
puede establecer esta opción del compilador en el entorno de desarrollo de Visual
Studio, ni se puede cambiar mediante programación.

PathMap
La opción del compilador PathMap especifica cómo asignar rutas de acceso físicas a los
nombres de rutas de acceso de origen generados por el compilador. Esta opción asigna
cada ruta de acceso física en la máquina donde el compilador se ejecuta a una ruta de
acceso correspondiente que debe escribirse en los archivos de salida. En el ejemplo
siguiente, path1 es la ruta completa a los archivos de código fuente en el entorno actual
y sourcePath1 es la ruta de origen sustituida por path1 en cualquier archivo de salida.
Para especificar varias rutas de acceso de origen asignadas, sepárelas con una coma.

XML

<PathMap>path1=sourcePath1,path2=sourcePath2</PathMap>

El compilador escribe la ruta de acceso de origen en la salida por las razones siguientes:

1. La ruta de acceso de origen se sustituye por un argumento cuando se aplica

CallerFilePathAttribute a un parámetro opcional.
2. La ruta de acceso de origen se inserta en un archivo PDB.
3. La ruta de acceso del archivo PDB se inserta en un archivo PE (ejecutable portable).

ApplicationConfiguration
La opción del compilador ApplicationConfiguration permite a una aplicación de C#
especificar la ubicación del archivo de configuración de la aplicación de un ensamblado
(app.config) al Common Language Runtime (CLR) en tiempo de enlace del ensamblado.

XML

<ApplicationConfiguration>file</ApplicationConfiguration>

file es el archivo de configuración de la aplicación que contiene los valores de enlace

del ensamblado. Un uso de ApplicationConfiguration es para escenarios avanzados en

los que un ensamblado tiene que hacer referencia a la versión de .NET Framework y a la
de .NET Framework para Silverlight de un ensamblado de referencia determinado al
mismo tiempo. Por ejemplo, un diseñador de XAML escrito en Windows Presentation
Foundation (WPF) podría tener que hacer referencia al escritorio de WPF, para la interfaz
de usuario del diseñador, y al subconjunto de WPF que se incluye con Silverlight. El
mismo ensamblado del diseñador tiene que tener acceso a ambos ensamblados. De
forma predeterminada, las referencias independientes producen un error del
compilador, ya que el enlace del ensamblado considera los dos ensamblados
equivalentes. La opción del compilador ApplicationConfiguration permite especificar la
ubicación de un archivo app.config que deshabilita el comportamiento predeterminado
mediante una etiqueta <supportPortability> , como se muestra en el ejemplo siguiente.

XML

<supportPortability PKT="7cec85d7bea7798e" enable="false"/>

El compilador pasa la ubicación del archivo a la lógica de enlace del ensamblado de

CLR.

７ Nota

Para usar el archivo app.config que ya está establecido en el proyecto, agregue la

etiqueta de propiedades <UseAppConfigForCompiler> al archivo .csproj y establezca
su valor en true . Para especificar otro archivo app.config, agregue la etiqueta
<AppConfigForCompiler> de propiedades y establezca su valor en la ubicación del

archivo.

En el siguiente ejemplo se muestra un archivo app.config que permite a una aplicación

tener referencias a la implementación de .NET Framework y de .NET Framework para
Silverlight de cualquier ensamblado de .NET Framework que exista en ambas
implementaciones. La opción del compilador ApplicationConfiguration especifica la
ubicación de este archivo app.config.

XML

<configuration>

<runtime>

<assemblyBinding>

<supportPortability PKT="7cec85d7bea7798e" enable="false"/>

<supportPortability PKT="31bf3856ad364e35" enable="false"/>

</assemblyBinding>

</runtime>

</configuration>

AdditionalLibPaths
La opción AdditionalLibPaths especifica la ubicación de los ensamblados a los que se
hace referencia con la opción References.

XML

<AdditionalLibPaths>dir1[,dir2]</AdditionalLibPaths>

dir1 es un directorio donde el compilador busca si un ensamblado al que se hace

referencia no se encuentra en el directorio de trabajo actual (el directorio desde el que
se invoca al compilador) o en el directorio del sistema de Common Language Runtime.
dir2 es uno o varios directorios adicionales en los que buscar referencias a

ensamblados. Separe los nombres de directorio con una coma y sin espacio en blanco
entre ellos. El compilador busca referencias a ensamblados que no presentan la ruta
completa en el siguiente orden:

1. Directorio de trabajo actual.

2. El directorio del sistema de Common Language Runtime.
3. Directorios especificados por AdditionalLibPaths.
4. Directorios especificados por la variable de entorno LIB.

Use Reference para especificar una referencia a un ensamblado. AdditionalLibPaths es

aditivo. Si se especifica más de una vez, se anexa a los valores existentes. Como en el
manifiesto del ensamblado no se especifica la ruta al ensamblado dependiente, la
aplicación buscará y usará el ensamblado en la caché global de ensamblados. El
compilador que hace referencia al ensamblado no implica que el Common Language
Runtime pueda encontrar y cargar el ensamblado en tiempo de ejecución. Vea Cómo el
motor en tiempo de ejecución ubica ensamblados para obtener los detalles sobre cómo
busca el motor en tiempo de ejecución los ensamblados a los que se hace referencia.

GenerateFullPaths
La opción GenerateFullPaths hace que el compilador especifique la ruta completa al
archivo cuando se muestran los errores de compilación y las advertencias.

Xml

<GenerateFullPaths>true</GenerateFullPaths>

De manera predeterminada, los errores y advertencias que se producen de la

compilación especifican el nombre del archivo en el que se ha detectado el error. La
opción GenerateFullPaths hace que el compilador especifique la ruta completa al
archivo. Esta opción del compilador no está disponible en Visual Studio y no se puede
cambiar mediante programación.

PreferredUILang
Mediante la opción del compilador PreferredUILang puede especificar el idioma en el
que el compilador de C# muestra el resultado, como los mensajes de error.

XML

<PreferredUILang>language</PreferredUILang>

language es el nombre del idioma que se va a usar para la salida del compilador. Puede
usar la opción del compilador PreferredUILang para especificar el idioma que quiere
que use el compilador de C# para los mensajes de error y otra salida de la línea de
comandos. Si el paquete de idioma para el idioma no está instalado, en su lugar se usa
la configuración de idioma del sistema operativo.

BaseAddress
La opción BaseAddress permite especificar la dirección base preferida en la que cargar
un archivo DLL. Para obtener más información sobre cuándo y por qué usar esta opción,
vea el blog de Larry Osterman.

XML

<BaseAddress>address</BaseAddress>

address es la dirección base del archivo DLL. Esta dirección puede especificarse como
un número octal, hexadecimal o decimal. La dirección base predeterminada para un
archivo DLL se establece mediante Common Language Runtime de .NET. La palabra de
orden inferior en esta dirección se redondeará. Por ejemplo, si especifica  0x11110001 , se
redondeará a  0x11110000 . Para completar el proceso de firma para un archivo DLL, use
SN.EXE con la opción -R.

ChecksumAlgorithm
Esta opción controla el algoritmo de suma de comprobación que se usa para codificar
los archivos de código fuente en el archivo PDB.

XML

<ChecksumAlgorithm>algorithm</ChecksumAlgorithm>

algorithm debe ser SHA1 (el valor predeterminado) o SHA256 .

CodePage
Esta opción especifica qué página de códigos se va a usar durante la compilación si la
página necesaria no es la página de códigos predeterminada actual del sistema.

XML

<CodePage>id</CodePage>

id es el id. de la página de códigos que se va a usar para todos los archivos de código

fuente de la compilación. El compilador primero intenta interpretar todos los archivos

de código fuente como UTF-8. Si los archivos de código fuente se encuentran en una
codificación distinta de UTF-8 y usan caracteres que no sean ASCII de 7 bits, utilice la
opción CodePage para especificar qué página de códigos se debe usar. CodePage se
aplica a todos los archivos de código fuente de la compilación. Vea GetCPInfo para
obtener información sobre cómo buscar las páginas de códigos que se admiten en su
sistema.

Utf8Output
La opción Utf8Output muestra los resultados del compilador en codificación UTF-8.

XML

<Utf8Output>true</Utf8Output>

En algunas configuraciones internacionales, el resultado del compilador no puede

mostrarse correctamente en la consola. Use Utf8Output y redirija el resultado del
compilador a un archivo.

FileAlignment
La opción FileAlignment permite especificar el tamaño de las secciones en el archivo de
salida. Los valores válidos son 512, 1024, 2048, 4096 y 8192. Estos valores están en
bytes.

XML

<FileAlignment>number</FileAlignment>

La opción FileAlignment se establece en la página Avanzado de las propiedades de

Compilación del proyecto en Visual Studio. Cada sección se alineará en un límite que es
un múltiplo del valor FileAlignment. No hay ningún valor predeterminado fijo. Si no se
especifica FileAlignment, Common Language Runtime elige un valor predeterminado en
tiempo de compilación. Al especificar el tamaño de la sección, el tamaño del archivo de
salida se ve afectado. Modificar el tamaño de la sección puede ser útil para los
programas que se ejecutan en dispositivos más pequeños. Use DUMPBIN para ver
información sobre las secciones en el archivo de salida.

ErrorEndLocation
Indica al compilador que muestre la línea y la columna de salida de la ubicación final de
cada error.

XML

<ErrorEndLocation>true</ErrorEndLocation>

De forma predeterminada, el compilador escribe la ubicación inicial en el origen para

todos los errores y advertencias. Cuando esta opción se establece en true, el compilador
escribe la ubicación inicial y final para todos los errores y advertencias.

NoStandardLib
NoStandardLib impide la importación de mscorlib.dll, que define el espacio de nombres
System completo.

XML

<NoStandardLib>true</NoStandardLib>

Use esta opción si desea definir o crear sus propios objetos y espacio de nombres
System. Si no se especifica NoStandardLib, mscorlib.dll se importa en el programa
(equivale a especificar <NoStandardLib>false</NoStandardLib> ).

SubsystemVersion
Especifica la versión mínima del subsistema en el que se ejecuta el archivo ejecutable.
Normalmente, esta opción garantiza que el archivo ejecutable pueda usar características
de seguridad que no están disponibles en versiones anteriores de Windows.

７ Nota

Para especificar el subsistema en sí mismo, use la opción del compilador

TargetType.

XML

<SubsystemVersion>major.minor</SubsystemVersion>

major.minor especifica la versión mínima necesaria del subsistema, expresada en una

notación de puntos para las versiones principales y secundarias. Por ejemplo, puede
especificar que una aplicación no se pueda ejecutar en un sistema operativo anterior a
Windows 7. Establezca el valor de esta opción en 6.01, como se describe en la tabla que
se muestra más adelante en este artículo. Especifique los valores de major y minor
como números enteros. Los ceros a la izquierda en la versión minor no cambian la
versión, pero los ceros a la derecha sí. Por ejemplo, 6.1 y 6.01 hacen referencia a la
misma versión, pero 6.10 hace referencia a una versión diferente. Se recomienda
expresar la versión secundaria como dos dígitos para evitar confusiones.

En la tabla siguiente se enumeran las versiones de subsistema habituales de Windows.

Versión de Windows Versión de subsistema

Windows Server 2003 5.02

Windows Vista 6.00

Windows 7 6.01

Windows Server 2008 6.01

Windows 8 6.02

El valor predeterminado de la opción del compilador SubsystemVersion depende de las

condiciones de la lista siguiente:
 El valor predeterminado es 6.02 si se establece cualquier opción del compilador en
la siguiente lista:
/target:appcontainerexe
/target:winmdobj
-platform:arm
El valor predeterminado es 6,00 si usa MSBuild, tiene como destino .NET
Framework 4.5 y no ha configurado ninguna de las opciones del compilador que
se han especificado anteriormente en esta lista.
El valor predeterminado es 4.00 si no se cumple ninguna de las condiciones
anteriores.

ModuleAssemblyName
Especifica el nombre de un ensamblado con tipos no públicos a los que puede acceder
un archivo .netmodule.

XML

<ModuleAssemblyName>assembly_name</ModuleAssemblyName>

Se debería usar ModuleAssemblyName al compilar un archivo .netmodule cuando se

cumplan las condiciones siguientes:

.netmodule necesita acceder a los tipos no públicos de un ensamblado existente.

Sabe el nombre del ensamblado en el que se compilará .netmodule.
El ensamblado existente ha concedido acceso de ensamblado de confianza al
ensamblado en el que se compilará .netmodule.

Para obtener más información sobre cómo crear un archivo .netmodule, vea la opción
TargetType de module. Para obtener más información sobre los ensamblados de
confianza, vea Ensamblados de confianza.
Comentarios de la documentación XML
Artículo • 15/02/2023 • Tiempo de lectura: 12 minutos

Los archivos de origen de C# pueden tener comentarios estructurados que generan

documentación de API para los tipos definidos en esos archivos. El compilador de C#
genera un archivo XML que contiene datos estructurados que representan los
comentarios y las firmas de API. Otras herramientas pueden procesar esa salida XML
para crear documentación legible en forma de páginas web o archivos PDF, por
ejemplo.

Este proceso proporciona muchas ventajas para agregar documentación de API en el

código:

El compilador de C# combina la estructura del código de C# con el texto de los

comentarios en un único documento XML.
El compilador de C# comprueba que los comentarios coinciden con las firmas de
API para las etiquetas pertinentes.
Las herramientas que procesan los archivos de documentación XML pueden definir
elementos y atributos XML específicos de esas herramientas.

Herramientas como Visual Studio proporcionan IntelliSense para muchos elementos

XML comunes que se usan en los comentarios de documentación.

En este artículo se tratan los siguientes temas:

Comentarios de documentación y generación de archivos XML

Etiquetas validadas por el compilador de C# y Visual Studio
Formato del archivo XML generado

Creación de la salida de documentación XML

Para crear documentación para el código, escriba campos de comentario especiales
indicados por tres barras diagonales. Los campos de comentario incluyen elementos
XML que describen el bloque de código que sigue a los comentarios. Por ejemplo:

C#

/// <summary>

/// This class performs an important function.

/// </summary>

public class MyClass {}

Establezca la opción GenerateDocumentationFile o DocumentationFile y el compilador

encontrará todos los campos de comentario con etiquetas XML en el código fuente y
creará un archivo de documentación XML a partir de esos comentarios. Cuando esta
opción está habilitada, el compilador genera la advertencia CS1591 para cualquier
miembro visible públicamente declarado en el proyecto sin comentarios de
documentación XML.

Formatos de comentario XML

El uso de comentarios de documentos XML requiere delimitadores que indiquen dónde
comienza y termina un comentario de documentación. Use los siguientes delimitadores
con las etiquetas de documentación XML:

Delimitador de una sola línea /// : los ejemplos de documentación y las plantillas
de proyecto de C# usan este formulario. Si hay un espacio en blanco después del
delimitador, no se incluye en la salida XML.

７ Nota

Visual Studio inserta automáticamente las etiquetas <summary> y </summary> ,

y coloca el cursor dentro de estas etiquetas después de escribir el delimitador
/// en el editor de código. Puede activar o desactivar esta característica en el

cuadro de diálogo Opciones.

Delimitadores de varias líneas /** */ : los delimitadores /** */ tienen las

siguientes reglas de formato:

En la línea que contiene el delimitador /** , si el resto de la línea es un espacio

en blanco, la línea no se procesa en busca de comentarios. Si el primer carácter
después del delimitador /** es un espacio en blanco, dicho carácter de espacio
en blanco se omite y se procesa el resto de la línea. En caso contrario, todo el
texto de la línea situado después del delimitador /** se procesa como parte del
comentario.

En la línea que contiene el delimitador */ , si solo hay un espacio en blanco

hasta el delimitador */ , esa línea se omite. En caso contrario, el texto de la línea
situado antes del delimitador */ se procesa como parte del comentario.

Para las líneas que aparecen después de la que comienza con el delimitador
/** , el compilador busca un patrón común al principio de cada línea. El patrón
puede consistir en un espacio en blanco opcional y un asterisco ( * ), seguido de
otro espacio en blanco opcional. Si el compilador encuentra un patrón común al
principio de cada línea que no comienza con el delimitador /** ni termina con
el delimitador */ , omite ese patrón para cada línea.

La única parte del comentario siguiente que se procesará es la línea que

comienza con <summary> . Los tres formatos de etiquetas producen los mismos
comentarios.

C#

/** <summary>text</summary> */

/**

<summary>text</summary>

*/

/**

* <summary>text</summary>

*/

El compilador identifica un patrón común de " * " al principio de la segunda y la

tercera línea. El patrón no se incluye en la salida.

C#

/**

* <summary>

* text </summary>*/

El compilador no encuentra ningún patrón común en el comentario siguiente

porque el segundo carácter de la tercera línea no es un asterisco. Todo el texto
de la segunda y la tercera línea se procesa como parte del comentario.

C#

/**

* <summary>

text </summary>

*/

El compilador no encuentra ningún patrón en el comentario siguiente por dos

razones. En primer lugar, el número de espacios antes del asterisco no es
coherente. En segundo lugar, la quinta línea comienza con una pestaña, que no
coincide con los espacios. Todo el texto de las líneas dos a cinco se procesa
como parte del comentario.
 C#

/**

* <summary>

* text

* text2

* </summary>

*/

Para hacer referencia a elementos XML (por ejemplo, la función procesa los elementos
XML concretos que desea describir en un comentario de documentación XML), puede
usar el mecanismo de entrecomillado estándar ( &lt; y &gt; ). Para hacer referencia a
identificadores genéricos en elementos de referencia de código ( cref ), puede usar los
caracteres de escape (por ejemplo, cref="List&lt;T&gt;" ) o llaves ( cref="List{T}" ).
Como caso especial, el compilador analiza las llaves como corchetes angulares para que
la creación del comentario de documentación resulte menos complicada al hacer
referencia a identificadores genéricos.

７ Nota

Los comentarios de documentación XML no son metadatos; no se incluyen en el

ensamblado compilado y, por tanto, no se puede obtener acceso a ellos mediante
reflexión.

Herramientas que aceptan la entrada de

documentación XML
Las siguientes herramientas crean la salida de los comentarios XML:

DocFX: DocFX es un generador de documentación de API para .NET, que

actualmente admite C#, Visual Basic y F#. También permite personalizar la
documentación de referencia generada. DocFX compila un sitio web HTML estático
a partir del código fuente y los archivos Markdown. Además, DocFX proporciona la
flexibilidad para personalizar el diseño y el estilo de su sitio web a través de
plantillas. También puede crear plantillas personalizadas.
Sandcastle : las herramientas de Sandcastle crean archivos de ayuda para
bibliotecas de clases administradas que contienen páginas de referencia tanto
conceptuales como de API. Las herramientas de Sandcastle se basan en la línea de
comandos y no tienen front-end de GUI, características de administración de
proyectos ni proceso de compilación automatizado. El Generador de archivos de
ayuda de Sandcastle proporciona herramientas independientes basadas en GUI y
 la línea de comandos para crear un archivo de ayuda de forma automatizada.
También está disponible un paquete de integración de Visual Studio para que los
proyectos de ayuda se puedan crear y administrar completamente desde
Visual Studio.
Doxygen : Doxygen genera un explorador de documentación en línea (en HTML)
o un manual de referencia fuera de línea (en LaTeX) a partir de un conjunto de
archivos de código fuente documentados. También se admite la generación de
resultados en RTF (MS Word), PostScript, PDF con hipervínculo, HTML comprimido,
DocBook y páginas man de Unix. Puede configurar Doxygen para extraer la
estructura de código de los archivos de código fuente no documentados.

Cadenas de identificador
Cada tipo o miembro se almacena en un elemento del archivo XML de salida. Cada uno
de esos elementos tiene una cadena de identificador única que identifica el tipo o
miembro. La cadena de identificador debe tener en cuenta los operadores, los
parámetros, los valores devueltos, los parámetros de tipo genérico y los parámetros
ref , in y out . Para codificar todos esos elementos potenciales, el compilador sigue

reglas claramente definidas para generar las cadenas de identificador. Los programas
que procesan el archivo XML usan la cadena de identificador para identificar el
elemento de reflexión o de metadatos correspondiente de .NET al que se aplica la
documentación.

El compilador cumple las siguientes reglas cuando genera las cadenas de identificador:

No hay ningún espacio en blanco en la cadena.

La primera parte de la cadena identifica el tipo de miembro mediante un carácter

único seguido de dos puntos. Se utilizan los siguientes tipos de miembros:

Carácter Tipo de Notas

miembro

N namespace No puede agregar comentarios de documentación a un espacio

de nombres, pero sí puede hacer referencias cruzadas a ellos, en
caso de que se admitan.

T type Un tipo es una clase, una interfaz, una estructura, una

enumeración o un delegado.

F campo

P propiedad Incluye indizadores u otras propiedades indizadas.

M método Incluye métodos especiales, como constructores y operadores.

 Carácter Tipo de Notas
miembro

E event

! cadena de El resto de la cadena proporciona información sobre el error. El

error compilador de C# genera información de error para vínculos que
no se puede resolver.

La segunda parte de la cadena es el nombre completo del elemento, que empieza

por la raíz del espacio de nombres. El nombre del elemento, sus tipos envolventes
y el espacio de nombres están separados por puntos. Si el nombre del elemento ya
contiene puntos, estos se reemplazan por el signo hash ("#"). Se supone que
ningún elemento tiene un signo hash directamente en su nombre. Por ejemplo, el
nombre completo del constructor de String es "System.String.#ctor".

Para las propiedades y los métodos, se indica la lista de parámetros entre

paréntesis. Si no hay ningún parámetro, tampoco habrá paréntesis. Los parámetros
se separan mediante comas. La codificación de cada parámetro sigue directamente
cómo se codifica en una firma de .NET (consulte
Microsoft.VisualStudio.CorDebugInterop.CorElementType para obtener las
definiciones de los elementos de todos los límites de la lista siguiente):
Tipos base. Los tipos normales ( ELEMENT_TYPE_CLASS o ELEMENT_TYPE_VALUETYPE )
se representan como el nombre completo del tipo.
Los tipos intrínsecos (por ejemplo, ELEMENT_TYPE_I4 , ELEMENT_TYPE_OBJECT ,
ELEMENT_TYPE_STRING , ELEMENT_TYPE_TYPEDBYREF y ELEMENT_TYPE_VOID ) se

representan como el nombre completo del tipo completo correspondiente. Por

ejemplo, System.Int32 o System.TypedReference .
ELEMENT_TYPE_PTR se representa como "*" después del tipo modificado.

ELEMENT_TYPE_BYREF se representa como "@" después del tipo modificado.

ELEMENT_TYPE_CMOD_OPT se representa como "!" y el nombre completo de la clase

modificadora, después del tipo modificado.

ELEMENT_TYPE_SZARRAY se representa como "[]" después del tipo de elemento de
la matriz.
ELEMENT_TYPE_ARRAY se representa como [límite inferior: size ,límite
inferior: size ], donde el número de comas es la clasificación - 1, y los límites
inferiores y el tamaño de cada dimensión, si se conocen, se representan en
decimales. Si no se especifican un límite inferior ni un tamaño, se omiten. Si se
omiten el límite inferior y el tamaño de una dimensión determinada, también se
omite ":". Por ejemplo, una matriz de dos dimensiones con 1 como los límites
inferiores y tamaños no especificados es [1:,1:].
 Solo para los operadores de conversión ( op_Implicit y op_Explicit ), el valor
devuelto del método se codifica como ~ seguido por el tipo de valor devuelto. Por
ejemplo: <member name="M:System.Decimal.op_Explicit(System.Decimal
arg)~System.Int32"> es la etiqueta del operador de conversión public static
explicit operator int (decimal value); declarado en la clase System.Decimal .

Para tipos genéricos, el nombre del tipo está seguido de una tilde aguda y después
de un número que indica el número de parámetros de tipo genérico. Por ejemplo:
<member name="T:SampleClass``2"> es la etiqueta de un tipo que se define como

public class SampleClass<T, U> .

Para los métodos que toman tipos genéricos
como parámetros, los parámetros de tipo genérico se especifican como números
precedidos por tildes graves (por ejemplo, `0,`1). Cada número representa una
notación de matriz de base cero para los parámetros genéricos del tipo.
ELEMENT_TYPE_PINNED se representa como "^" después del tipo modificado. El

compilador de C# nunca genera esta codificación.

ELEMENT_TYPE_CMOD_REQ se representa como "|" y el nombre completo de la clase

modificadora, después del tipo modificado. El compilador de C# nunca genera

esta codificación.
ELEMENT_TYPE_GENERICARRAY se representa como "[?]" después del tipo de

elemento de la matriz. El compilador de C# nunca genera esta codificación.

ELEMENT_TYPE_FNPTR se representa como "=FUNC: type (signature)", donde type

es el tipo de valor devuelto y signature se corresponde con los argumentos del

método. Si no hay ningún argumento, se omiten los paréntesis. El compilador
de C# nunca genera esta codificación.
Los siguientes componentes de la firma no se representan porque nunca se
usan para diferenciar métodos sobrecargados:
Convención de llamada
Tipo de valor devuelto
ELEMENT_TYPE_SENTINEL

En los ejemplos siguientes, se muestra cómo se generan las cadenas de identificador

para una clase y sus miembros:

C#

namespace MyNamespace

/// <summary>

/// Enter description here for class X.

/// ID string generated is "T:MyNamespace.MyClass".

/// </summary>

public unsafe class MyClass

 /// <summary>

/// Enter description here for the first constructor.

/// ID string generated is "M:MyNamespace.MyClass.#ctor".

/// </summary>

public MyClass() { }

/// <summary>

/// Enter description here for the second constructor.

/// ID string generated is

"M:MyNamespace.MyClass.#ctor(System.Int32)".

/// </summary>

/// <param name="i">Describe parameter.</param>

public MyClass(int i) { }

/// <summary>

/// Enter description here for field message.

/// ID string generated is "F:MyNamespace.MyClass.message".

/// </summary>

public string? message;

/// <summary>

/// Enter description for constant PI.

/// ID string generated is "F:MyNamespace.MyClass.PI".

/// </summary>

public const double PI = 3.14;

/// <summary>

/// Enter description for method func.

/// ID string generated is "M:MyNamespace.MyClass.func".

/// </summary>

/// <returns>Describe return value.</returns>

public int func() { return 1; }

/// <summary>

/// Enter description for method someMethod.

/// ID string generated is

"M:MyNamespace.MyClass.someMethod(System.String,System.Int32@,System.Void*)"
.

/// </summary>

/// <param name="str">Describe parameter.</param>

/// <param name="num">Describe parameter.</param>

/// <param name="ptr">Describe parameter.</param>

/// <returns>Describe return value.</returns>

public int someMethod(string str, ref int nm, void* ptr) { return 1;
}

/// <summary>

/// Enter description for method anotherMethod.

/// ID string generated is

"M:MyNamespace.MyClass.anotherMethod(System.Int16[],System.Int32[0:,0:])".

/// </summary>

/// <param name="array1">Describe parameter.</param>

/// <param name="array">Describe parameter.</param>

/// <returns>Describe return value.</returns>

public int anotherMethod(short[] array1, int[,] array) { return 0; }

 /// <summary>

/// Enter description for operator.

/// ID string generated is

"M:MyNamespace.MyClass.op_Addition(MyNamespace.MyClass,MyNamespace.MyClass)"
.

/// </summary>

/// <param name="first">Describe parameter.</param>

/// <param name="second">Describe parameter.</param>

/// <returns>Describe return value.</returns>

public static MyClass operator +(MyClass first, MyClass second) {

return first; }

/// <summary>

/// Enter description for property.

/// ID string generated is "P:MyNamespace.MyClass.prop".

/// </summary>

public int prop { get { return 1; } set { } }

/// <summary>

/// Enter description for event.

/// ID string generated is "E:MyNamespace.MyClass.OnHappened".

/// </summary>

public event Del? OnHappened;

/// <summary>

/// Enter description for index.

/// ID string generated is

"P:MyNamespace.MyClass.Item(System.String)".

/// </summary>

/// <param name="str">Describe parameter.</param>

/// <returns></returns>

public int this[string s] { get { return 1; } }

/// <summary>

/// Enter description for class Nested.

/// ID string generated is "T:MyNamespace.MyClass.Nested".

/// </summary>

public class Nested { }

/// <summary>

/// Enter description for delegate.

/// ID string generated is "T:MyNamespace.MyClass.Del".

/// </summary>

/// <param name="i">Describe parameter.</param>

public delegate void Del(int i);

/// <summary>

/// Enter description for operator.

/// ID string generated is

"M:MyNamespace.MyClass.op_Explicit(MyNamespace.MyClass)~System.Int32".

/// </summary>

/// <param name="myParameter">Describe parameter.</param>

/// <returns>Describe return value.</returns>

public static explicit operator int(MyClass myParameter) { return 1;

 }

Especificación del lenguaje C#

Para obtener más información, consulte el anexo Especificación del lenguaje C# sobre
los comentarios de documentación.
Etiquetas XML recomendadas para los
comentarios de la documentación de C#
Artículo • 22/09/2022 • Tiempo de lectura: 12 minutos

Los comentarios de la documentación de C# usan elementos XML para definir la

estructura de la documentación de salida. Una consecuencia de esta característica es
que resulta posible agregar cualquier XML válido en los comentarios de la
documentación. El compilador de C# copia estos elementos en el archivo XML de salida.
Aunque puede usar cualquier XML válido en los comentarios (incluido cualquier
elemento HTML válido), se recomienda documentar el código por varios motivos.

A continuación se ofrecen algunas recomendaciones, escenarios generales de casos de

uso y conceptos que debe conocer al usar etiquetas de documentación XML en el
código de C#. Aunque puede colocar cualquier etiqueta en los comentarios de la
documentación, en este artículo se describen las etiquetas recomendadas para las
construcciones de lenguaje más habituales. En todos los casos, debe adaptarse a estas
recomendaciones:

Por motivos de coherencia, se deben documentar todos los tipos públicamente

visibles y sus miembros públicos.
Los miembros privados también se pueden documentar mediante comentarios
XML, aunque esto expone el funcionamiento interno (potencialmente confidencial)
de la biblioteca.
Como mínimo, los tipos y sus miembros deben tener una etiqueta <summary> , ya
que su contenido es necesario para IntelliSense.
El texto de la documentación se debe escribir con frases completas que terminen
en punto.
Las clases parciales son totalmente compatibles, y la información de la
documentación se concatena en una única entrada de cada tipo.

La documentación XML empieza con /// . Cuando se crea un proyecto, las plantillas
agregan automáticamente unas líneas de inicio /// . El procesamiento de estos
comentarios tiene algunas restricciones:

La documentación debe ser XML con formato correcto. Si el XML no tiene el

formato correcto, el compilador genera una advertencia. En ese caso, el archivo de
documentación contiene un comentario que indica que se ha detectado un error.
Algunas de las etiquetas recomendadas tienen significados especiales:
La etiqueta <param> se usa para describir parámetros. Si se usa, el compilador
comprueba que el parámetro existe y que todos los parámetros se describen en
 la documentación. Si se produce un error en la comprobación, el compilador
emite una advertencia.
El atributo cref se puede asociar a cualquier etiqueta para hacer referencia a
un elemento de código. El compilador comprueba si existe este elemento de
código. Si se produce un error en la comprobación, el compilador emite una
advertencia. El compilador respeta todas las instrucciones using cuando busca
un tipo descrito en el atributo cref .
IntelliSense usa la etiqueta <summary> en Visual Studio para mostrar información
adicional sobre un tipo o miembro.

７ Nota

El archivo XML no proporciona información completa sobre los tipos y los

miembros (por ejemplo, no contiene información de tipos). Para obtener
información completa sobre un tipo o miembro, use el archivo de
documentación con reflexión en el tipo o miembro reales.

Los desarrolladores pueden crear su propio conjunto de etiquetas, que el

compilador copia en el archivo de salida.

Algunas de las etiquetas recomendadas se pueden usar en cualquier elemento de

lenguaje. Otras tienen un uso más especializado. Por último, algunas de las etiquetas se
usan para aplicar formato al texto de la documentación. En este artículo se describen las
etiquetas recomendadas organizadas por su uso.

El compilador comprueba la sintaxis de los elementos seguidos de un solo * en la

siguiente lista. Visual Studio proporciona a IntelliSense las etiquetas comprobadas por el
compilador y todas las etiquetas seguidas de ** en la siguiente lista. Además de las que
aparecen aquí, el compilador y Visual Studio validan las etiquetas <b> , <i> , <u> , <br/>
y <a> . El compilador también valida <tt> , que es HTML en desuso.

Etiquetas generales usadas para varios elementos: estas etiquetas son el conjunto
mínimo de cualquier API.
<summary>: el valor de este elemento se muestra en IntelliSense en
Visual Studio.
<remarks> **
Etiquetas usadas en miembros: estas etiquetas se usan al documentar métodos y
propiedades.
<returns>: el valor de este elemento se muestra en IntelliSense en Visual Studio.
<param> *: el valor de este elemento se muestra en IntelliSense en
Visual Studio.
<paramref>
 <exception> *
<value>: el valor de este elemento se muestra en IntelliSense en Visual Studio.
Formato de salida de documentación: estas etiquetas proporcionan instrucciones
de formato para las herramientas que generan documentación.
<para>
<list>
<c>
<code>
<example> **
Reutilización de texto de documentación: estas etiquetas proporcionan
herramientas que facilitan la reutilización de comentarios XML.
<inheritdoc> **
<include> *
Generación de vínculos y referencias: estas etiquetas generan vínculos a otra
documentación.
<see> *
<seealso> *
cref
href
Etiquetas para métodos y tipos genéricos: estas etiquetas solo se usan en métodos
y tipos genéricos.
<typeparam> *: el valor de este elemento se muestra en IntelliSense en
Visual Studio.
<typeparamref>

７ Nota

Los comentarios de documentación no pueden aplicarse en un espacio de

nombres.

Si quiere que aparezcan corchetes angulares en el texto de un comentario de la

documentación, use la codificación HTML de < y > , que es &lt; y &gt; ,
respectivamente. Esta codificación se muestra en el ejemplo siguiente.

C#

/// <summary>

/// This property always returns a value &lt; 1.

/// </summary>

Etiquetas generales

<summary>
XML

<summary>description</summary>

La etiqueta <summary> debe usarse para describir un tipo o un miembro de tipo. Use
<remarks> para agregar información adicional a una descripción de tipo. Use el atributo
cref para permitir que herramientas de documentación como DocFX y Sandcastle
creen hipervínculos internos a las páginas de documentación de los elementos de
código. El texto de la etiqueta <summary> es la única fuente de información sobre el tipo
en IntelliSense, y también se muestra en la ventana Examinador de objetos.

<remarks>
XML

<remarks>

description

</remarks>

La etiqueta <remarks> se usa para agregar información sobre un tipo o miembro de

este, y complementa la información especificada con <summary>. Esta información se
muestra en la ventana Examinador de objetos. Esta etiqueta puede incluir explicaciones
más extensas. Puede que le resulte más cómodo escribirla con secciones CDATA para
Markdown. Herramientas como docfx procesan el texto de Markdown en secciones
CDATA .

Miembros del documento

<returns>
XML

<returns>description</returns>

La etiqueta <returns> debe usarse en el comentario de una declaración de método para

describir el valor devuelto.

<param>
XML

<param name="name">description</param>

name : nombre de un parámetro de método. Ponga el nombre entre comillas

dobles (" "). Los nombres de los parámetros deben coincidir con la firma de la API.
Si uno o varios parámetros no aparecen, el compilador emite una advertencia. El
compilador también emite una advertencia si el valor de name no coincide con un
parámetro formal de la declaración del método.

La etiqueta <param> debe usarse en el comentario de una declaración de método para

describir uno de los parámetros del método. Para documentar varios parámetros, use
varias etiquetas <param> . El texto de la etiqueta <param> se muestra en IntelliSense, el
examinador de objetos y el informe web de comentario de código.

<paramref>
XML

<paramref name="name"/>

name : nombre del parámetro al que se hace referencia. Ponga el nombre entre

comillas dobles (" ").

La etiqueta <paramref> ofrece una manera de indicar que una palabra en los
comentarios del código (por ejemplo, en un bloque <summary> o <remarks> ) hace
referencia a un parámetro. El archivo XML se puede procesar para dar formato a esta
palabra de alguna manera distinta, por ejemplo, con una fuente en negrita o cursiva.

<exception>
XML

<exception cref="member">description</exception>

 cref = " member ": referencia a una excepción que está disponible desde el entorno
de compilación actual. El compilador comprueba si la excepción dada existe y
traduce member al nombre de elemento canónico en la salida XML. member debe
aparecer entre comillas dobles (" ").

La etiqueta <exception> le permite especificar qué excepciones se pueden producir. Esta

etiqueta se puede aplicar a definiciones de métodos, propiedades, eventos e
indizadores.

<value>
XML

<value>property-description</value>

La etiqueta <value> le permite describir el valor que representa una propiedad. Cuando
agrega una propiedad mediante un asistente de código en el entorno de desarrollo
.NET de Visual Studio, se agrega una etiqueta <summary> para la nueva propiedad.
Debe agregar manualmente una etiqueta <value> para describir el valor que representa
la propiedad.

Formato de salida de documentación

<para>
XML

<remarks>

<para>

This is an introductory paragraph.

</para>

<para>

This paragraph contains more details.

</para>

</remarks>

La etiqueta <para> se usa dentro de otra etiqueta, como <summary>, <remarks> o

<returns>, y permite agregar estructura al texto. La etiqueta <para> crea un párrafo a
doble espacio. Use la etiqueta <br/> si quiere un párrafo a un solo espacio.

<list>
 XML

<list type="bullet|number|table">

<listheader>

<term>term</term>

<description>description</description>
</listheader>

<item>

<term>Assembly</term>

<description>The library or executable built from a compilation.

</description>

</item>

</list>

El bloque <listheader> se usa para definir la fila de encabezado de una tabla o de una
lista de definiciones. Cuando se define una tabla, solo es necesario proporcionar una
entrada para term en el encabezado. Cada elemento de la lista se especifica con un
bloque <item> . Cuando se crea una lista de definiciones, es necesario especificar tanto
term como description . En cambio, para una tabla, lista con viñetas o lista numerada,

solo es necesario suministrar una entrada para description . Una lista o una tabla
pueden tener tantos bloques <item> como sean necesarios.

<c>
XML

<c>text</c>

La etiqueta <c> le proporciona una manera de indicar que el texto dentro de una
descripción debe marcarse como código. Use <code> para indicar varias líneas como
código.

<code>
XML

<code>

var index = 5;

index++;

</code>

La etiqueta <code> se usa para indicar varias líneas de código. Use <c> para indicar que
el texto de línea única dentro de una descripción debe marcarse como código.
<example>
XML

<example>

This shows how to increment an integer.

<code>

var index = 5;

index++;

</code>

</example>

La etiqueta <example> le permite especificar un ejemplo de cómo usar un método u

otro miembro de biblioteca. Un ejemplo normalmente implica el uso de la etiqueta
<code>.

Reutilización de texto de documentación

<inheritdoc>
XML

<inheritdoc [cref=""] [path=""]/>

Herede comentarios XML de clases base, interfaces y métodos similares. El empleo de

inheritdoc acaba con el copiado y pegado no deseados de comentarios XML

duplicados y mantiene los comentarios XML sincronizados automáticamente. Tenga en

cuenta que al agregar la etiqueta <inheritdoc> a un tipo, todos los miembros heredan
también los comentarios.

cref : especifica el miembro del que se hereda la documentación. Las etiquetas ya

definidas en el miembro actual no las invalidan las heredadas.
path : consulta de expresión XPath que genera un conjunto de nodos para mostrar.

Puede usar este atributo para filtrar las etiquetas que se van a incluir o excluir en la
documentación heredada.

Agregue los comentarios XML en las clases base o las interfaces y deje que inheritdoc
copie los comentarios en las clases en implementación. Agregue los comentarios XML a
los métodos sincrónicos y deje que inheritdoc copie los comentarios en las versiones
asincrónicas de los mismos métodos. Si quiere copiar los comentarios de un miembro
concreto, puede usar el atributo cref para especificar el miembro.
<include>
XML

<include file='filename' path='tagpath[@name="id"]' />

filename : nombre del archivo XML que contiene la documentación. El nombre de

archivo se puede calificar con una ruta de acceso relativa al archivo de código
fuente. Incluya filename entre comillas simples (' ').
tagpath : ruta de acceso de las etiquetas de filename que conduce a la etiqueta
name . Incluya la ruta de acceso entre comillas simples (' ').

name : especificador de nombre de la etiqueta que precede a los comentarios; name

tiene un elemento id .
id : identificador de la etiqueta que precede a los comentarios. Ponga el

identificador entre comillas dobles (" ").

La etiqueta <include> le permite hacer referencia a comentarios colocados en otro

archivo que describen los tipos y miembros en el código fuente. La inclusión de un
archivo externo es una alternativa a la colocación de los comentarios de la
documentación directamente en el archivo de código fuente. Al colocar la
documentación en un archivo independiente, puede aplicar el control de código fuente
a la documentación de forma independiente desde el código fuente. Una persona
puede haber extraído del repositorio el archivo de código fuente y otra el archivo de
documentación. La etiqueta <include> usa la sintaxis XML de XPath. Consulte la
documentación de XPath para ver formas de personalizar el uso de <include> .

Generación de vínculos y referencias

<see>
XML

<see cref="member"/>

<!-- or -->

<see cref="member">Link text</see>

<!-- or -->

<see href="link">Link Text</see>

<!-- or -->

<see langword="keyword"/>

 cref="member" : referencia a un miembro o campo al cual se puede llamar desde el

entorno de compilación actual. El compilador comprueba si el elemento de código

dado existe y pasa member al nombre de elemento en el resultado XML. Agregue
member entre comillas dobles (" "). Puede proporcionar otro texto de vínculo para
"cref" mediante una etiqueta de cierre independiente.
href="link" : vínculo interactivo a una dirección URL determinada. Por ejemplo,

<see href="https://github.com">GitHub</see> genera un vínculo en el que se

puede hacer clic, con texto GitHub que vincula a https://github.com .
langword="keyword" : palabra clave de lenguaje, como true o una de las otras
palabras clave válidas.

La etiqueta <see> permite especificar un vínculo desde el texto. Use <seealso> para
indicar que el texto debe colocarse en una sección Consulte también. Use el atributo
cref para crear hipervínculos internos a las páginas de documentación de los elementos
de código. Incluya los parámetros de tipo para especificar una referencia a un tipo
genérico o método, como cref="IDictionary{T, U}" . Además, href es un atributo
válido que actúa como un hipervínculo.

<seealso>
XML

<seealso cref="member"/>

<!-- or -->

<seealso href="link">Link Text</seealso>

cref="member" : referencia a un miembro o campo al cual se puede llamar desde el

entorno de compilación actual. El compilador comprueba si el elemento de código

dado existe y pasa member al nombre de elemento en el resultado XML. member
debe aparecer entre comillas dobles (" ").
href="link" : vínculo interactivo a una dirección URL determinada. Por ejemplo,
<seealso href="https://github.com">GitHub</seealso> genera un vínculo en el

que se puede hacer clic, con texto GitHub que vincula a https://github.com .

La etiqueta <seealso> permite especificar el texto que quiere que aparezca en una
sección Vea también. Use <see> para especificar un vínculo desde dentro del texto. No
se puede anidar la etiqueta seealso dentro de la etiqueta summary .

Atributo cref
El atributo cref de una etiqueta de documentación XML significa "referencia de
código". Especifica que el texto interno de la etiqueta es un elemento de código, como
un tipo, un método o una propiedad. En herramientas de documentación como
DocFX y Sandcastle , use los atributos cref para generar hipervínculos a la página
donde se documenta el tipo o miembro de manera automática.

Atributo href
El atributo href significa una referencia a una página web. Puede usarlo para hacer
referencia directamente a la documentación en línea sobre la API o la biblioteca.

Métodos y tipos genéricos

<typeparam>
XML

<typeparam name="TResult">The type returned from this method</typeparam>

TResult : nombre del parámetro de tipo. Ponga el nombre entre comillas dobles ("

").

La etiqueta <typeparam> debe usarse en el comentario de una declaración de método o

tipo genérico para describir un parámetro de tipo. Agregue una etiqueta para cada
parámetro de tipo del tipo o método genérico. El texto de la etiqueta <typeparam> se
muestra en IntelliSense.

<typeparamref>
XML

<typeparamref name="TKey"/>

TKey : nombre del parámetro de tipo. Ponga el nombre entre comillas dobles (" ").

Use esta etiqueta para permitir que los consumidores del archivo de documentación
den formato a la palabra de alguna manera distinta, por ejemplo en cursiva.

Etiquetas definidas por el usuario

Todas las etiquetas descritas anteriormente son las que reconoce el compilador de C#,
pero el usuario puede definir sus propias etiquetas.
Las herramientas como Sandcastle
proporcionan compatibilidad con etiquetas adicionales, como <event> y <note> , e
incluso permiten documentar espacios de nombres .
También se pueden usar
herramientas de generación de documentación internas o personalizadas con las
etiquetas estándar, y se admiten varios formatos de salida, de HTML a PDF.
Comentarios de documentación XML de
ejemplo
Artículo • 10/02/2023 • Tiempo de lectura: 18 minutos

Este artículo contiene tres ejemplos para agregar comentarios de documentación XML a
la mayoría de los elementos de lenguaje de C#. En el primer ejemplo se muestra cómo
documentar una clase con miembros diferentes. En el segundo se muestra cómo
reutilizar las explicaciones de una jerarquía de clases o interfaces. En el tercero se
muestran las etiquetas que se van a usar para las clases y los miembros genéricos. En el
segundo y tercer ejemplo se usan conceptos que se tratan en el primero.

Documentación de una clase, estructura o

interfaz
En el ejemplo siguiente se muestran elementos de lenguaje comunes y las etiquetas que
se recomienda usar para describir estos elementos. Los comentarios de la
documentación describen el uso de las etiquetas en lugar de la propia clase.

C#

/// <summary>

/// Every class and member should have a one sentence

/// summary describing its purpose.

/// </summary>

/// <remarks>

/// You can expand on that one sentence summary to

/// provide more information for readers. In this case,

/// the <c>ExampleClass</c> provides different C#

/// elements to show how you would add documentation

///comments for most elements in a typical class.

/// <para>

/// The remarks can add multiple paragraphs, so you can

/// write detailed information for developers that use

/// your work. You should add everything needed for

/// readers to be successful. This class contains

/// examples for the following:

/// </para>

/// <list type="table">

/// <item>

/// <term>Summary</term>

/// <description>

/// This should provide a one sentence summary of the class or member.

/// </description>

/// </item>

/// <item>

/// <term>Remarks</term>

/// <description>

/// This is typically a more detailed description of the class or member

/// </description>

/// </item>

/// <item>

/// <term>para</term>

/// <description>

/// The para tag separates a section into multiple paragraphs

/// </description>

/// </item>

/// <item>

/// <term>list</term>

/// <description>

/// Provides a list of terms or elements

/// </description>

/// </item>

/// <item>

/// <term>returns, param</term>

/// <description>

/// Used to describe parameters and return values

/// </description>

/// </item>

/// <item>

/// <term>value</term>

/// <description>Used to describe properties</description>

/// </item>

/// <item>

/// <term>exception</term>

/// <description>

/// Used to describe exceptions that may be thrown

/// </description>

/// </item>

/// <item>

/// <term>c, cref, see, seealso</term>

/// <description>

/// These provide code style and links to other

/// documentation elements

/// </description>

/// </item>

/// <item>

/// <term>example, code</term>

/// <description>

/// These are used for code examples

/// </description>

/// </item>

/// </list>

/// <para>

/// The list above uses the "table" style. You could

/// also use the "bullet" or "number" style. Neither

/// would typically use the "term" element.

/// <br/>

/// Note: paragraphs are double spaced. Use the *br*

/// tag for single spaced lines.

/// </para>

 /// </remarks>

public class ExampleClass

/// <value>

/// The <c>Label</c> property represents a label

/// for this instance.

/// </value>

/// <remarks>

/// The <see cref="Label"/> is a <see langword="string"/>

/// that you use for a label.

/// <para>

/// Note that there isn't a way to provide a "cref" to

/// each accessor, only to the property itself.

/// </para>

/// </remarks>

public string? Label

get;

set;

/// <summary>

/// Adds two integers and returns the result.

/// </summary>

/// <returns>

/// The sum of two integers.

/// </returns>

/// <param name="left">

/// The left operand of the addition.

/// </param>

/// <param name="right">

/// The right operand of the addition.

/// </param>

/// <example>

/// <code>

/// int c = Math.Add(4, 5);

/// if (c > 10)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// <exception cref="System.OverflowException">

/// Thrown when one parameter is

/// <see cref="Int32.MaxValue">MaxValue</see> and the other is

/// greater than 0.

/// Note that here you can also use

/// <see
href="https://docs.microsoft.com/dotnet/api/system.int32.maxvalue"/>

/// to point a web page instead.

/// </exception>

/// <see cref="ExampleClass"/> for a list of all

/// the tags in these examples.

/// <seealso cref="ExampleClass.Label"/>

public static int Add(int left, int right)

if ((left == int.MaxValue && right > 0) || (right ==

int.MaxValue && left > 0))

throw new System.OverflowException();

return left + right;

/// <summary>

/// This is an example of a positional record.

/// </summary>

/// <remarks>

/// There isn't a way to add XML comments for properties

/// created for positional records, yet. The language

/// design team is still considering what tags should

/// be supported, and where. Currently, you can use

/// the "param" tag to describe the parameters to the

/// primary constructor.

/// </remarks>

/// <param name="FirstName">

/// This tag will apply to the primary constructor parameter.

/// </param>

/// <param name="LastName">

/// This tag will apply to the primary constructor parameter.

/// </param>

public record Person(string FirstName, string LastName);

La incorporación de documentación puede abarrotar el código fuente con grandes

conjuntos de comentarios destinados a los usuarios de la biblioteca. Use la etiqueta
<Include> para separar los comentarios XML del código fuente. El código fuente hace
referencia a un archivo XML con la etiqueta <Include> :

C#

/// <include file='xml_include_tag.xml'

path='MyDocs/MyMembers[@name="test"]/*' />

class Test

static void Main()

/// <include file='xml_include_tag.xml'

path='MyDocs/MyMembers[@name="test2"]/*' />

class Test2

public void Test()

El segundo archivo, xml_include_tag.xml, contiene los comentarios de la documentación.

XML

<MyDocs>

<MyMembers name="test">

<summary>

The summary for this type.

</summary>

</MyMembers>

<MyMembers name="test2">

<summary>

The summary for this other type.

</summary>

</MyMembers>

</MyDocs>

Documentación de una jerarquía de clases e

interfaces
El elemento <inheritdoc> significa que un tipo o miembro hereda los comentarios de la
documentación de una interfaz o clase base. También puede usar el elemento
<inheritdoc> con el atributo cref para heredar comentarios de un miembro del mismo
tipo. En el ejemplo siguiente se muestran formas de usar esta etiqueta. Tenga en cuenta
que al agregar el atributo inheritdoc a un tipo, se heredan los comentarios de los
miembros. Puede evitar el uso de comentarios heredados escribiendo comentarios en
los miembros del tipo derivado. Estos se prefieren a los comentarios heredados.

C#

/// <summary>

/// A summary about this class.

/// </summary>

/// <remarks>

/// These remarks would explain more about this class.

/// In this example, these comments also explain the

/// general information about the derived class.

/// </remarks>

public class MainClass

///<inheritdoc/>

public class DerivedClass : MainClass

/// <summary>

/// This interface would describe all the methods in

/// its contract.

/// </summary>

/// <remarks>

/// While elided for brevity, each method or property

/// in this interface would contain docs that you want

/// to duplicate in each implementing class.

/// </remarks>

public interface ITestInterface

/// <summary>

/// This method is part of the test interface.

/// </summary>

/// <remarks>

/// This content would be inherited by classes

/// that implement this interface when the

/// implementing class uses "inheritdoc"

/// </remarks>

/// <returns>The value of <paramref name="arg" /> </returns>

/// <param name="arg">The argument to the method</param>

int Method(int arg);

///<inheritdoc cref="ITestInterface"/>

public class ImplementingClass : ITestInterface

// doc comments are inherited here.

public int Method(int arg) => arg;

/// <summary>

/// This class shows hows you can "inherit" the doc

/// comments from one method in another method.

/// </summary>

/// <remarks>

/// You can inherit all comments, or only a specific tag,

/// represented by an xpath expression.

/// </remarks>

public class InheritOnlyReturns

/// <summary>

/// In this example, this summary is only visible for this method.

/// </summary>

/// <returns>A boolean</returns>

public static bool MyParentMethod(bool x) { return x; }

/// <inheritdoc cref="MyParentMethod" path="/returns"/>

public static bool MyChildMethod() { return false; }

/// <Summary>

 /// This class shows an example ofsharing comments across methods.

/// </Summary>

public class InheritAllButRemarks

/// <summary>

/// In this example, this summary is visible on all the methods.

/// </summary>

/// <remarks>

/// The remarks can be inherited by other methods

/// using the xpath expression.

/// </remarks>

/// <returns>A boolean</returns>

public static bool MyParentMethod(bool x) { return x; }

/// <inheritdoc cref="MyParentMethod" path="//*[not(self::remarks)]"/>

public static bool MyChildMethod() { return false; }

Tipos genéricos
Use la etiqueta <typeparam> para describir los parámetros de tipo de tipos y métodos
genéricos. El valor del atributo cref exige nueva sintaxis para hacer referencia a una
clase o un método genéricos:

C#

/// <summary>

/// This is a generic class.

/// </summary>

/// <remarks>

/// This example shows how to specify the <see cref="GenericClass{T}"/>

/// type as a cref attribute.

/// In generic classes and methods, you'll often want to reference the

/// generic type, or the type parameter.

/// </remarks>

class GenericClass<T>

// Fields and members.

/// <Summary>

/// This shows examples of typeparamref and typeparam tags

/// </Summary>

public class ParamsAndParamRefs

/// <summary>

/// The GetGenericValue method.

/// </summary>

/// <remarks>

/// This sample shows how to specify the <see cref="GetGenericValue"/>

/// method as a cref attribute.

 /// The parameter and return value are both of an arbitrary type,

/// <typeparamref name="T"/>

/// </remarks>

public static T GetGenericValue<T>(T para)

return para;

Ejemplo de clase matemática

En el código siguiente se muestra un ejemplo realista de cómo agregar comentarios de
documentación a una biblioteca matemática.

C#

namespace TaggedLibrary

/*

The main Math class

Contains all methods for performing basic math functions

*/

/// <summary>

/// The main <c>Math</c> class.

/// Contains all methods for performing basic math functions.

/// <list type="bullet">

/// <item>

/// <term>Add</term>

/// <description>Addition Operation</description>

/// </item>

/// <item>

/// <term>Subtract</term>

/// <description>Subtraction Operation</description>

/// </item>

/// <item>

/// <term>Multiply</term>

/// <description>Multiplication Operation</description>

/// </item>

/// <item>

/// <term>Divide</term>

/// <description>Division Operation</description>

/// </item>

/// </list>

/// </summary>

/// <remarks>

/// <para>

/// This class can add, subtract, multiply and divide.

/// </para>

/// <para>

/// These operations can be performed on both

/// integers and doubles.

 /// </para>

/// </remarks>

public class Math

// Adds two integers and returns the result

/// <summary>

/// Adds two integers <paramref name="a"/> and <paramref name="b"/>

/// and returns the result.

/// </summary>

/// <returns>

/// The sum of two integers.

/// </returns>

/// <example>

/// <code>

/// int c = Math.Add(4, 5);

/// if (c > 10)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// <exception cref="System.OverflowException">

/// Thrown when one parameter is <see cref="Int32.MaxValue"/> and

the other

/// is greater than 0.

/// </exception>

/// See <see cref="Math.Add(double, double)"/> to add doubles.

/// <seealso cref="Math.Subtract(int, int)"/>

/// <seealso cref="Math.Multiply(int, int)"/>

/// <seealso cref="Math.Divide(int, int)"/>

/// <param name="a">An integer.</param>

/// <param name="b">An integer.</param>

public static int Add(int a, int b)

// If any parameter is equal to the max value of an integer

// and the other is greater than zero

if ((a == int.MaxValue && b > 0) ||

(b == int.MaxValue && a > 0))

throw new System.OverflowException();

return a + b;

// Adds two doubles and returns the result

/// <summary>

/// Adds two doubles <paramref name="a"/> and <paramref name="b"/>

/// and returns the result.

/// </summary>

/// <returns>

/// The sum of two doubles.

/// </returns>

/// <example>

/// <code>

/// double c = Math.Add(4.5, 5.4);

 /// if (c > 10)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// <exception cref="System.OverflowException">

/// Thrown when one parameter is max and the other

/// is greater than 0.</exception>

/// See <see cref="Math.Add(int, int)"/> to add integers.

/// <seealso cref="Math.Subtract(double, double)"/>

/// <seealso cref="Math.Multiply(double, double)"/>

/// <seealso cref="Math.Divide(double, double)"/>

/// <param name="a">A double precision number.</param>

/// <param name="b">A double precision number.</param>

public static double Add(double a, double b)

// If any parameter is equal to the max value of an integer

// and the other is greater than zero

if ((a == double.MaxValue && b > 0)

|| (b == double.MaxValue && a > 0))

throw new System.OverflowException();

return a + b;

// Subtracts an integer from another and returns the result

/// <summary>

/// Subtracts <paramref name="b"/> from <paramref name="a"/>

/// and returns the result.

/// </summary>

/// <returns>

/// The difference between two integers.

/// </returns>

/// <example>

/// <code>

/// int c = Math.Subtract(4, 5);

/// if (c > 1)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// See <see cref="Math.Subtract(double, double)"/> to subtract

doubles.

/// <seealso cref="Math.Add(int, int)"/>

/// <seealso cref="Math.Multiply(int, int)"/>

/// <seealso cref="Math.Divide(int, int)"/>

/// <param name="a">An integer.</param>

/// <param name="b">An integer.</param>

public static int Subtract(int a, int b)

return a - b;

// Subtracts a double from another and returns the result

/// <summary>

/// Subtracts a double <paramref name="b"/> from another

/// double <paramref name="a"/> and returns the result.

/// </summary>

/// <returns>

/// The difference between two doubles.

/// </returns>

/// <example>

/// <code>

/// double c = Math.Subtract(4.5, 5.4);

/// if (c > 1)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// See <see cref="Math.Subtract(int, int)"/> to subtract integers.

/// <seealso cref="Math.Add(double, double)"/>

/// <seealso cref="Math.Multiply(double, double)"/>

/// <seealso cref="Math.Divide(double, double)"/>

/// <param name="a">A double precision number.</param>

/// <param name="b">A double precision number.</param>

public static double Subtract(double a, double b)

return a - b;

// Multiplies two integers and returns the result

/// <summary>

/// Multiplies two integers <paramref name="a"/>

/// and <paramref name="b"/> and returns the result.

/// </summary>

/// <returns>

/// The product of two integers.

/// </returns>

/// <example>

/// <code>

/// int c = Math.Multiply(4, 5);

/// if (c > 100)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// See <see cref="Math.Multiply(double, double)"/> to multiply

doubles.

/// <seealso cref="Math.Add(int, int)"/>

/// <seealso cref="Math.Subtract(int, int)"/>

/// <seealso cref="Math.Divide(int, int)"/>

/// <param name="a">An integer.</param>

/// <param name="b">An integer.</param>

public static int Multiply(int a, int b)

return a * b;

// Multiplies two doubles and returns the result

/// <summary>

/// Multiplies two doubles <paramref name="a"/> and

/// <paramref name="b"/> and returns the result.

/// </summary>

/// <returns>

/// The product of two doubles.

/// </returns>

/// <example>

/// <code>

/// double c = Math.Multiply(4.5, 5.4);

/// if (c > 100.0)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// See <see cref="Math.Multiply(int, int)"/> to multiply integers.

/// <seealso cref="Math.Add(double, double)"/>

/// <seealso cref="Math.Subtract(double, double)"/>

/// <seealso cref="Math.Divide(double, double)"/>

/// <param name="a">A double precision number.</param>

/// <param name="b">A double precision number.</param>

public static double Multiply(double a, double b)

return a * b;

// Divides an integer by another and returns the result

/// <summary>

/// Divides an integer <paramref name="a"/> by another

/// integer <paramref name="b"/> and returns the result.

/// </summary>

/// <returns>

/// The quotient of two integers.

/// </returns>

/// <example>

/// <code>

/// int c = Math.Divide(4, 5);

/// if (c > 1)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// <exception cref="System.DivideByZeroException">

/// Thrown when <paramref name="b"/> is equal to 0.

/// </exception>

/// See <see cref="Math.Divide(double, double)"/> to divide doubles.

/// <seealso cref="Math.Add(int, int)"/>

/// <seealso cref="Math.Subtract(int, int)"/>

 /// <seealso cref="Math.Multiply(int, int)"/>

/// <param name="a">An integer dividend.</param>

/// <param name="b">An integer divisor.</param>

public static int Divide(int a, int b)

return a / b;

// Divides a double by another and returns the result

/// <summary>

/// Divides a double <paramref name="a"/> by another double

/// <paramref name="b"/> and returns the result.

/// </summary>

/// <returns>

/// The quotient of two doubles.

/// </returns>

/// <example>

/// <code>

/// double c = Math.Divide(4.5, 5.4);

/// if (c > 1.0)

/// {

/// Console.WriteLine(c);

/// }

/// </code>

/// </example>

/// <exception cref="System.DivideByZeroException">

/// Thrown when <paramref name="b"/> is equal to 0.

/// </exception>

/// See <see cref="Math.Divide(int, int)"/> to divide integers.

/// <seealso cref="Math.Add(double, double)"/>

/// <seealso cref="Math.Subtract(double, double)"/>

/// <seealso cref="Math.Multiply(double, double)"/>

/// <param name="a">A double precision dividend.</param>

/// <param name="b">A double precision divisor.</param>

public static double Divide(double a, double b)

return a / b;

Es posible que los comentarios oculten el código. En el ejemplo final se muestra cómo
se adaptaría esta biblioteca para usar la etiqueta include . Mueva toda la
documentación a un archivo XML:

XML

<docs>

<members name="math">

<Math>

<summary>

The main <c>Math</c> class.

 Contains all methods for performing basic math functions.

</summary>

<remarks>

<para>This class can add, subtract, multiply and divide.</para>

<para>These operations can be performed on both integers and doubles.

</para>

</remarks>

</Math>

<AddInt>

<summary>

Adds two integers <paramref name="a"/> and <paramref name="b"/>

and returns the result.

</summary>

<returns>

The sum of two integers.

</returns>

<example>

<code>

int c = Math.Add(4, 5);

if (c > 10)

Console.WriteLine(c);

</code>

</example>

<exception cref="System.OverflowException">Thrown when one

parameter is max

and the other is greater than 0.</exception>

See <see cref="Math.Add(double, double)"/> to add doubles.

<seealso cref="Math.Subtract(int, int)"/>

<seealso cref="Math.Multiply(int, int)"/>

<seealso cref="Math.Divide(int, int)"/>

<param name="a">An integer.</param>

<param name="b">An integer.</param>

</AddInt>

<AddDouble>

<summary>

Adds two doubles <paramref name="a"/> and <paramref name="b"/>

and returns the result.

</summary>

<returns>

The sum of two doubles.

</returns>

<example>

<code>

double c = Math.Add(4.5, 5.4);

if (c > 10)

Console.WriteLine(c);

</code>

</example>

<exception cref="System.OverflowException">Thrown when one parameter

is max

and the other is greater than 0.</exception>

 See <see cref="Math.Add(int, int)"/> to add integers.

<seealso cref="Math.Subtract(double, double)"/>

<seealso cref="Math.Multiply(double, double)"/>

<seealso cref="Math.Divide(double, double)"/>

<param name="a">A double precision number.</param>

<param name="b">A double precision number.</param>

</AddDouble>

<SubtractInt>

<summary>

Subtracts <paramref name="b"/> from <paramref name="a"/> and

returns the result.

</summary>

<returns>

The difference between two integers.

</returns>

<example>

<code>

int c = Math.Subtract(4, 5);

if (c > 1)

Console.WriteLine(c);

</code>

</example>

See <see cref="Math.Subtract(double, double)"/> to subtract doubles.

<seealso cref="Math.Add(int, int)"/>

<seealso cref="Math.Multiply(int, int)"/>

<seealso cref="Math.Divide(int, int)"/>

<param name="a">An integer.</param>

<param name="b">An integer.</param>

</SubtractInt>

<SubtractDouble>

<summary>

Subtracts a double <paramref name="b"/> from another

double <paramref name="a"/> and returns the result.

</summary>

<returns>

The difference between two doubles.

</returns>

<example>

<code>

double c = Math.Subtract(4.5, 5.4);

if (c > 1)

Console.WriteLine(c);

</code>

</example>

See <see cref="Math.Subtract(int, int)"/> to subtract integers.

<seealso cref="Math.Add(double, double)"/>

<seealso cref="Math.Multiply(double, double)"/>

<seealso cref="Math.Divide(double, double)"/>

<param name="a">A double precision number.</param>

<param name="b">A double precision number.</param>

</SubtractDouble>

<MultiplyInt>

<summary>

Multiplies two integers <paramref name="a"/> and

<paramref name="b"/> and returns the result.

</summary>

<returns>

The product of two integers.

</returns>

<example>

<code>

int c = Math.Multiply(4, 5);

if (c > 100)

Console.WriteLine(c);

</code>

</example>

See <see cref="Math.Multiply(double, double)"/> to multiply doubles.

<seealso cref="Math.Add(int, int)"/>

<seealso cref="Math.Subtract(int, int)"/>

<seealso cref="Math.Divide(int, int)"/>

<param name="a">An integer.</param>

<param name="b">An integer.</param>

</MultiplyInt>

<MultiplyDouble>

<summary>

Multiplies two doubles <paramref name="a"/> and

<paramref name="b"/> and returns the result.

</summary>

<returns>

The product of two doubles.

</returns>

<example>

<code>

double c = Math.Multiply(4.5, 5.4);

if (c > 100.0)

Console.WriteLine(c);

</code>

</example>

See <see cref="Math.Multiply(int, int)"/> to multiply integers.

<seealso cref="Math.Add(double, double)"/>

<seealso cref="Math.Subtract(double, double)"/>

<seealso cref="Math.Divide(double, double)"/>

<param name="a">A double precision number.</param>

<param name="b">A double precision number.</param>

</MultiplyDouble>

<DivideInt>

<summary>

Divides an integer <paramref name="a"/> by another integer

<paramref name="b"/> and returns the result.

</summary>

<returns>

The quotient of two integers.

 </returns>

<example>

<code>

int c = Math.Divide(4, 5);

if (c > 1)

Console.WriteLine(c);

</code>

</example>

<exception cref="System.DivideByZeroException">

Thrown when <paramref name="b"/> is equal to 0.

</exception>

See <see cref="Math.Divide(double, double)"/> to divide doubles.

<seealso cref="Math.Add(int, int)"/>

<seealso cref="Math.Subtract(int, int)"/>

<seealso cref="Math.Multiply(int, int)"/>

<param name="a">An integer dividend.</param>

<param name="b">An integer divisor.</param>

</DivideInt>

<DivideDouble>

<summary>

Divides a double <paramref name="a"/> by another

double <paramref name="b"/> and returns the result.

</summary>

<returns>

The quotient of two doubles.

</returns>

<example>

<code>

double c = Math.Divide(4.5, 5.4);

if (c > 1.0)

Console.WriteLine(c);

</code>

</example>

<exception cref="System.DivideByZeroException">Thrown when <paramref

name="b"/> is equal to 0.</exception>

See <see cref="Math.Divide(int, int)"/> to divide integers.

<seealso cref="Math.Add(double, double)"/>

<seealso cref="Math.Subtract(double, double)"/>

<seealso cref="Math.Multiply(double, double)"/>

<param name="a">A double precision dividend.</param>

<param name="b">A double precision divisor.</param>

</DivideDouble>

</members>

</docs>

En el XML anterior, los comentarios de documentación de cada miembro aparecen

directamente dentro de una etiqueta cuyo nombre indica lo que hacen, pero puede
elegir su propia estrategia.
El código usa la etiqueta <include> para hacer referencia al
elemento adecuado del archivo XML:
C#

namespace IncludeTag

/*

The main Math class

Contains all methods for performing basic math functions

*/

/// <include file='include.xml'

path='docs/members[@name="math"]/Math/*'/>

public class Math

// Adds two integers and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/AddInt/*'/>

public static int Add(int a, int b)

// If any parameter is equal to the max value of an integer

// and the other is greater than zero

if ((a == int.MaxValue && b > 0) || (b == int.MaxValue && a >

0))

throw new System.OverflowException();

return a + b;

// Adds two doubles and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/AddDouble/*'/>

public static double Add(double a, double b)

// If any parameter is equal to the max value of an integer

// and the other is greater than zero

if ((a == double.MaxValue && b > 0) || (b == double.MaxValue &&

a > 0))

throw new System.OverflowException();

return a + b;

// Subtracts an integer from another and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/SubtractInt/*'/>

public static int Subtract(int a, int b)

return a - b;

// Subtracts a double from another and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/SubtractDouble/*'/>

public static double Subtract(double a, double b)

 return a - b;

// Multiplies two integers and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/MultiplyInt/*'/>

public static int Multiply(int a, int b)

return a * b;

// Multiplies two doubles and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/MultiplyDouble/*'/>

public static double Multiply(double a, double b)

return a * b;

// Divides an integer by another and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/DivideInt/*'/>

public static int Divide(int a, int b)

return a / b;

// Divides a double by another and returns the result

/// <include file='include.xml'

path='docs/members[@name="math"]/DivideDouble/*'/>

public static double Divide(double a, double b)

return a / b;

El atributo file representa el nombre del archivo XML que contiene la

documentación.
El atributo path representa una consulta XPath para el tag name presente en el
file especificado.

El atributo name representa el especificador de nombre en la etiqueta que precede

a los comentarios.
El atributo id , que se puede usar en lugar de name , representa el identificador de
la etiqueta que precede a los comentarios.
Errores del compilador de C#
Artículo • 15/02/2023 • Tiempo de lectura: 2 minutos

Algunos errores del compilador de C# tienen temas correspondientes que explican por
qué se genera el error y, en algunos casos, cómo corregirlo. Utilice uno de los siguientes
pasos para ver si la Ayuda está disponible para un mensaje de error concreto.

Si usa Visual Studio, seleccione el número de error (por ejemplo, CS0029) en la

Ventana de salida y después presione la tecla F1.
Escriba el número de error en el cuadro Filtrar por título de la tabla de contenido.

Si ninguno de estos pasos conduce a información sobre el error, vaya al final de esta
página y envíe comentarios con el número o el texto del error.

Para obtener información sobre cómo configurar las opciones de advertencia y error en
C#, vea Opciones del compilador de C# o Compilar (Página, Diseñador de proyectos)
(C#) en Visual Studio.

７ Nota

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos

de los elementos de la interfaz de usuario de Visual Studio en las siguientes
instrucciones. La edición de Visual Studio que se tenga y la configuración que se
utilice determinan estos elementos. Para obtener más información, vea
Personalizar el IDE.

Vea también
Opciones del compilador de C#
Página Compilar (Diseñador de proyectos) (C#)
WarningLevel (opciones del compilador de C#)
NoWarn (opciones del compilador de C#)
Detailed table of contents
Artículo • 01/12/2022 • Tiempo de lectura: 12 minutos

Foreword
Introduction
§1 Scope
§2 Normative references
§3 Terms and definitions
§4 General description
§5 Conformance
§6 Lexical structure
§6.1 Programs
§6.2 Grammars
§6.2.1 General
§6.2.2 Grammar notation
§6.2.3 Lexical grammar
§6.2.4 Syntactic grammar
§6.2.5 Grammar ambiguities
§6.3 Lexical analysis
§6.3.1 General
§6.3.2 Line terminators
§6.3.3 Comments
§6.3.4 White space
§6.4 Tokens
§6.4.1 General
§6.4.2 Unicode character escape sequences
§6.4.3 Identifiers
§6.4.4 Keywords
§6.4.5 Literals
§6.4.5.1 General
§6.4.5.2 Boolean literals
§6.4.5.3 Integer literals
§6.4.5.4 Real literals
§6.4.5.5 Character literals
§6.4.5.6 String literals
§6.4.5.7 The null literal
§6.4.6 Operators and punctuators
§6.5 Pre-processing directives
§6.5.1 General
§6.5.2 Conditional compilation symbols
 §6.5.3 Pre-processing expressions
§6.5.4 Definition directives
§6.5.5 Conditional compilation directives
§6.5.6 Diagnostic directives
§6.5.7 Region directives
§6.5.8 Line directives
§6.5.9 Pragma directives
§7 Basic concepts
§7.1 Application startup
§7.2 Application termination
§7.3 Declarations
§7.4 Members
§7.4.1 General
§7.4.2 Namespace members
§7.4.3 Struct members
§7.4.4 Enumeration members
§7.4.5 Class members
§7.4.6 Interface members
§7.4.7 Array members
§7.4.8 Delegate members
§7.5 Member access
§7.5.1 General
§7.5.2 Declared accessibility
§7.5.3 Accessibility domains
§7.5.4 Protected access
§7.5.5 Accessibility constraints
§7.6 Signatures and overloading
§7.7 Scopes
§7.7.1 General
§7.7.2 Name hiding
§7.7.2.1 General
§7.7.2.2 Hiding through nesting
§7.7.2.3 Hiding through inheritance
§7.8 Namespace and type names
§7.8.1 General
§7.8.2 Unqualified names
§7.8.3 Fully qualified names
§7.9 Automatic memory management
§7.10 Execution order
§8 Types
 §8.1 General
§8.2 Reference types
§8.2.1 General
§8.2.2 Class types
§8.2.3 The object type
§8.2.4 The dynamic type
§8.2.5 The string type
§8.2.6 Interface types
§8.2.7 Array types
§8.2.8 Delegate types
§8.3 Value types
§8.3.1 General
§8.3.2 The System.ValueType type
§8.3.3 Default constructors
§8.3.4 Struct types
§8.3.5 Simple types
§8.3.6 Integral types
§8.3.7 Floating-point types
§8.3.8 The Decimal type
§8.3.9 The Bool type
§8.3.10 Enumeration types
§8.3.11 Nullable value types
§8.3.12 Boxing and unboxing
§8.4 Constructed types
§8.4.1 General
§8.4.2 Type arguments
§8.4.3 Open and closed types
§8.4.4 Bound and unbound types
§8.4.5 Satisfying constraints
§8.5 Type parameters
§8.6 Expression tree types
§8.7 The dynamic type
§8.8 Unmanaged types
§9 Variables
§9.1 General
§9.2 Variable categories
§9.2.1 General
§9.2.2 Static variables
§9.2.3 Instance variables
§9.2.3.1 General
 §9.2.3.2 Instance variables in classes
§9.2.3.3 Instance variables in structs
§9.2.4 Array elements
§9.2.5 Value parameters
§9.2.6 Reference parameters
§9.2.7 Output parameters
§9.2.8 Local variables
§9.3 Default values
§9.4 Definite assignment
§9.4.1 General
§9.4.2 Initially assigned variables
§9.4.3 Initially unassigned variables
§9.4.4 Precise rules for determining definite assignment
§9.4.4.1 General
§9.4.4.2 General rules for statements
§9.4.4.3 Block statements, checked, and unchecked statements
§9.4.4.4 Expression statements
§9.4.4.5 Declaration statements
§9.4.4.6 If statements
§9.4.4.7 Switch statements
§9.4.4.8 While statements
§9.4.4.9 Do statements
§9.4.4.10 For statements
§9.4.4.11 Break, continue, and goto statements
§9.4.4.12 Throw statements
§9.4.4.13 Return statements
§9.4.4.14 Try-catch statements
§9.4.4.15 Try-finally statements
§9.4.4.16 Try-catch-finally statements
§9.4.4.17 Foreach statements
§9.4.4.18 Using statements
§9.4.4.19 Lock statements
§9.4.4.20 Yield statements
§9.4.4.21 General rules for constant expressions
§9.4.4.22 General rules for simple expressions
§9.4.4.23 General rules for expressions with embedded expressions
§9.4.4.24 Invocation expressions and object creation expressions
§9.4.4.25 Simple assignment expressions
§9.4.4.26 && expressions
§9.4.4.27 || expressions
 §9.4.4.28 ! expressions
§9.4.4.29 ?? expressions
§9.4.4.30 ?: expressions
§9.4.4.31 Anonymous functions
§9.4.4.32 Throw expressions
§9.4.4.33 Rules for variables in local functions
§9.5 Variable references
§9.6 Atomicity of variable references
§10 Conversions
§10.1 General
§10.2 Implicit conversions
§10.2.1 General
§10.2.2 Identity conversion
§10.2.3 Implicit numeric conversions
§10.2.4 Implicit enumeration conversions
§10.2.5 Implicit interpolated string conversions
§10.2.6 Implicit nullable conversions
§10.2.7 Null literal conversions
§10.2.8 Implicit reference conversions
§10.2.9 Boxing conversions
§10.2.10 Implicit dynamic conversions
§10.2.11 Implicit constant expression conversions
§10.2.12 Implicit conversions involving type parameters
§10.2.13 User-defined implicit conversions
§10.2.14 Anonymous function conversions and method group conversions
§10.2.15 Default literal conversions
§10.2.16 Implicit throw conversions
§10.3 Explicit conversions
§10.3.1 General
§10.3.2 Explicit numeric conversions
§10.3.3 Explicit enumeration conversions
§10.3.4 Explicit nullable conversions
§10.3.5 Explicit reference conversions
§10.3.6 Unboxing conversions
§10.3.7 Explicit dynamic conversions
§10.3.8 Explicit conversions involving type parameters
§10.3.9 User-defined explicit conversions
§10.4 Standard conversions
§10.4.1 General
§10.4.2 Standard implicit conversions
 §10.4.3 Standard explicit conversions
§10.5 User-defined conversions
§10.5.1 General
§10.5.2 Permitted user-defined conversions
§10.5.3 Evaluation of user-defined conversions
§10.5.4 User-defined implicit conversions
§10.5.5 User-defined explicit conversions
§10.6 Conversions involving nullable types
§10.6.1 Nullable Conversions
§10.6.2 Lifted conversions
§10.7 Anonymous function conversions
§10.7.1 General
§10.7.2 Evaluation of anonymous function conversions to delegate types
§10.7.3 Evaluation of lambda expression conversions to expression tree types
§10.8 Method group conversions
§11 Expressions
§11.1 General
§11.2 Expression classifications
§11.2.1 General
§11.2.2 Values of expressions
§11.3 Static and Dynamic Binding
§11.3.1 General
§11.3.2 Binding-time
§11.3.3 Dynamic binding
§11.3.4 Types of subexpressions
§11.4 Operators
§11.4.1 General
§11.4.2 Operator precedence and associativity
§11.4.3 Operator overloading
§11.4.4 Unary operator overload resolution
§11.4.5 Binary operator overload resolution
§11.4.6 Candidate user-defined operators
§11.4.7 Numeric promotions
§11.4.7.1 General
§11.4.7.2 Unary numeric promotions
§11.4.7.3 Binary numeric promotions
§11.4.8 Lifted operators
§11.5 Member lookup
§11.5.1 General
§11.5.2 Base types
§11.6 Function members
§11.6.1 General
§11.6.2 Argument lists
§11.6.2.1 General
§11.6.2.2 Corresponding parameters
§11.6.2.3 Run-time evaluation of argument lists
§11.6.3 Type inference
§11.6.3.1 General
§11.6.3.2 The first phase
§11.6.3.3 The second phase
§11.6.3.4 Input types
§11.6.3.5 Output types
§11.6.3.6 Dependence
§11.6.3.7 Output type inferences
§11.6.3.8 Explicit parameter type inferences
§11.6.3.9 Exact inferences
§11.6.3.10 Lower-bound inferences
§11.6.3.11 Upper-bound inferences
§11.6.3.12 Fixing
§11.6.3.13 Inferred return type
§11.6.3.14 Type inference for conversion of method groups
§11.6.3.15 Finding the best common type of a set of expressions
§11.6.4 Overload resolution
§11.6.4.1 General
§11.6.4.2 Applicable function member
§11.6.4.3 Better function member
§11.6.4.4 Better conversion from expression
§11.6.4.5 Exactly matching expression
§11.6.4.6 Better conversion target
§11.6.4.7 Overloading in generic classes
§11.6.5 Compile-time checking of dynamic member invocation
§11.6.6 Function member invocation
§11.6.6.1 General
§11.6.6.2 Invocations on boxed instances
§11.7 Primary expressions
§11.7.1 General
§11.7.2 Literals
§11.7.3 Interpolated string expressions
§11.7.4 Simple names
§11.7.5 Parenthesized expressions
 §11.7.6 Member access
§11.7.6.1 General
§11.7.6.2 Identical simple names and type names
§11.7.7 Null Conditional Member Access
§11.7.8 Invocation expressions
§11.7.8.1 General
§11.7.8.2 Method invocations
§11.7.8.3 Extension method invocations
§11.7.8.4 Delegate invocations
§11.7.9 Null Conditional Invocation Expression
§11.7.10 Element access
§11.7.10.1 General
§11.7.10.2 Array access
§11.7.10.3 Indexer access
§11.7.11 Null Conditional Element Access
§11.7.12 This access
§11.7.13 Base access
§11.7.14 Postfix increment and decrement operators
§11.7.15 The new operator
§11.7.15.1 General
§11.7.15.2 Object creation expressions
§11.7.15.3 Object initializers
§11.7.15.4 Collection initializers
§11.7.15.5 Array creation expressions
§11.7.15.6 Delegate creation expressions
§11.7.15.7 Anonymous object creation expressions
§11.7.16 The typeof operator
§11.7.17 The sizeof operator
§11.7.18 The checked and unchecked operators
§11.7.19 Default value expressions
§11.7.20 Nameof expressions
§11.7.21 Anonymous method expressions
§11.8 Unary operators
§11.8.1 General
§11.8.2 Unary plus operator
§11.8.3 Unary minus operator
§11.8.4 Logical negation operator
§11.8.5 Bitwise complement operator
§11.8.6 Prefix increment and decrement operators
§11.8.7 Cast expressions
 §11.8.8 Await expressions
§11.8.8.1 General
§11.8.8.2 Awaitable expressions
§11.8.8.3 Classification of await expressions
§11.8.8.4 Run-time evaluation of await expressions
§11.9 Arithmetic operators
§11.9.1 General
§11.9.2 Multiplication operator
§11.9.3 Division operator
§11.9.4 Remainder operator
§11.9.5 Addition operator
§11.9.6 Subtraction operator
§11.10 Shift operators
§11.11 Relational and type-testing operators
§11.11.1 General
§11.11.2 Integer comparison operators
§11.11.3 Floating-point comparison operators
§11.11.4 Decimal comparison operators
§11.11.5 Boolean equality operators
§11.11.6 Enumeration comparison operators
§11.11.7 Reference type equality operators
§11.11.8 String equality operators
§11.11.9 Delegate equality operators
§11.11.10 Equality operators between nullable value types and the null literal
§11.11.11 The is operator
§11.11.12 The as operator
§11.12 Logical operators
§11.12.1 General
§11.12.2 Integer logical operators
§11.12.3 Enumeration logical operators
§11.12.4 Boolean logical operators
§11.12.5 Nullable Boolean & and | operators
§11.13 Conditional logical operators
§11.13.1 General
§11.13.2 Boolean conditional logical operators
§11.13.3 User-defined conditional logical operators
§11.14 The null coalescing operator
§11.15 The throw expression operator
§11.16 Conditional operator
§11.17 Anonymous function expressions
 §11.17.1 General
§11.17.2 Anonymous function signatures
§11.17.3 Anonymous function bodies
§11.17.4 Overload resolution
§11.17.5 Anonymous functions and dynamic binding
§11.17.6 Outer variables
§11.17.6.1 General
§11.17.6.2 Captured outer variables
§11.17.6.3 Instantiation of local variables
§11.17.7 Evaluation of anonymous function expressions
§11.17.8 Implementation Example
§11.18 Query expressions
§11.18.1 General
§11.18.2 Ambiguities in query expressions
§11.18.3 Query expression translation
§11.18.3.1 General
§11.18.3.2 select and group … by clauses with continuations
§11.18.3.3 Explicit range variable types
§11.18.3.4 Degenerate query expressions
§11.18.3.5 From, let, where, join and orderby clauses
§11.18.3.6 Select clauses
§11.18.3.7 Group clauses
§11.18.3.8 Transparent identifiers
§11.18.4 The query-expression pattern
§11.19 Assignment operators
§11.19.1 General
§11.19.2 Simple assignment
§11.19.3 Compound assignment
§11.19.4 Event assignment
§11.20 Expression
§11.21 Constant expressions
§11.22 Boolean expressions
§12 Statements
§12.1 General
§12.2 End points and reachability
§12.3 Blocks
§12.3.1 General
§12.3.2 Statement lists
§12.4 The empty statement
§12.5 Labeled statements
 §12.6 Declaration statements
§12.6.1 General
§12.6.2 Local variable declarations
§12.6.3 Local constant declarations
§12.6.4 Local function declarations
§12.7 Expression statements
§12.8 Selection statements
§12.8.1 General
§12.8.2 The if statement
§12.8.3 The switch statement
§12.9 Iteration statements
§12.9.1 General
§12.9.2 The while statement
§12.9.3 The do statement
§12.9.4 The for statement
§12.9.5 The foreach statement
§12.10 Jump statements
§12.10.1 General
§12.10.2 The break statement
§12.10.3 The continue statement
§12.10.4 The goto statement
§12.10.5 The return statement
§12.10.6 The throw statement
§12.11 The try statement
§12.12 The checked and unchecked statements
§12.13 The lock statement
§12.14 The using statement
§12.15 The yield statement
§13 Namespaces
§13.1 General
§13.2 Compilation units
§13.3 Namespace declarations
§13.4 Extern alias directives
§13.5 Using directives
§13.5.1 General
§13.5.2 Using alias directives
§13.5.3 Using namespace directives
§13.5.4 Using static directives
§13.6 Namespace member declarations
§13.7 Type declarations
 §13.8 Qualified alias member
§13.8.1 General
§13.8.2 Uniqueness of aliases
§14 Classes
§14.1 General
§14.2 Class declarations
§14.2.1 General
§14.2.2 Class modifiers
§14.2.2.1 General
§14.2.2.2 Abstract classes
§14.2.2.3 Sealed classes
§14.2.2.4 Static classes
§14.2.2.4.1 General
§14.2.2.4.2 Referencing static class types
§14.2.3 Type parameters
§14.2.4 Class base specification
§14.2.4.1 General
§14.2.4.2 Base classes
§14.2.4.3 Interface implementations
§14.2.5 Type parameter constraints
§14.2.6 Class body
§14.2.7 Partial declarations
§14.3 Class members
§14.3.1 General
§14.3.2 The instance type
§14.3.3 Members of constructed types
§14.3.4 Inheritance
§14.3.5 The new modifier
§14.3.6 Access modifiers
§14.3.7 Constituent types
§14.3.8 Static and instance members
§14.3.9 Nested types
§14.3.9.1 General
§14.3.9.2 Fully qualified name
§14.3.9.3 Declared accessibility
§14.3.9.4 Hiding
§14.3.9.5 this access
§14.3.9.6 Access to private and protected members of the containing type
§14.3.9.7 Nested types in generic classes
§14.3.10 Reserved member names
 §14.3.10.1 General
§14.3.10.2 Member names reserved for properties
§14.3.10.3 Member names reserved for events
§14.3.10.4 Member names reserved for indexers
§14.3.10.5 Member names reserved for finalizers
§14.4 Constants
§14.5 Fields
§14.5.1 General
§14.5.2 Static and instance fields
§14.5.3 Readonly fields
§14.5.3.1 General
§14.5.3.2 Using static readonly fields for constants
§14.5.3.3 Versioning of constants and static readonly fields
§14.5.4 Volatile fields
§14.5.5 Field initialization
§14.5.6 Variable initializers
§14.5.6.1 General
§14.5.6.2 Static field initialization
§14.5.6.3 Instance field initialization
§14.6 Methods
§14.6.1 General
§14.6.2 Method parameters
§14.6.2.1 General
§14.6.2.2 Value parameters
§14.6.2.3 Reference parameters
§14.6.2.4 Output parameters
§14.6.2.5 Parameter arrays
§14.6.3 Static and instance methods
§14.6.4 Virtual methods
§14.6.5 Override methods
§14.6.6 Sealed methods
§14.6.7 Abstract methods
§14.6.8 External methods
§14.6.9 Partial methods
§14.6.10 Extension methods
§14.6.11 Method body
§14.7 Properties
§14.7.1 General
§14.7.2 Static and instance properties
§14.7.3 Accessors
 §14.7.4 Automatically implemented properties
§14.7.5 Accessibility
§14.7.6 Virtual, sealed, override, and abstract accessors
§14.8 Events
§14.8.1 General
§14.8.2 Field-like events
§14.8.3 Event accessors
§14.8.4 Static and instance events
§14.8.5 Virtual, sealed, override, and abstract accessors
§14.9 Indexers
§14.10 Operators
§14.10.1 General
§14.10.2 Unary operators
§14.10.3 Binary operators
§14.10.4 Conversion operators
§14.11 Instance constructors
§14.11.1 General
§14.11.2 Constructor initializers
§14.11.3 Instance variable initializers
§14.11.4 Constructor execution
§14.11.5 Default constructors
§14.12 Static constructors
§14.13 Finalizers
§14.14 Iterators
§14.14.1 General
§14.14.2 Enumerator interfaces
§14.14.3 Enumerable interfaces
§14.14.4 Yield type
§14.14.5 Enumerator objects
§14.14.5.1 General
§14.14.5.2 The MoveNext method
§14.14.5.3 The Current property
§14.14.5.4 The Dispose method
§14.14.6 Enumerable objects
§14.14.6.1 General
§14.14.6.2 The GetEnumerator method
§14.15 Async Functions
§14.15.1 General
§14.15.2 Evaluation of a task-returning async function
§14.15.3 Evaluation of a void-returning async function
§15 Structs
§15.1 General
§15.2 Struct declarations
§15.2.1 General
§15.2.2 Struct modifiers
§15.2.3 Partial modifier
§15.2.4 Struct interfaces
§15.2.5 Struct body
§15.3 Struct members
§15.4 Class and struct differences
§15.4.1 General
§15.4.2 Value semantics
§15.4.3 Inheritance
§15.4.4 Assignment
§15.4.5 Default values
§15.4.6 Boxing and unboxing
§15.4.7 Meaning of this
§15.4.8 Field initializers
§15.4.9 Constructors
§15.4.10 Static constructors
§15.4.11 Automatically implemented properties
§16 Arrays
§16.1 General
§16.2 Array types
§16.2.1 General
§16.2.2 The System.Array type
§16.2.3 Arrays and the generic collection interfaces
§16.3 Array creation
§16.4 Array element access
§16.5 Array members
§16.6 Array covariance
§16.7 Array initializers
§17 Interfaces
§17.1 General
§17.2 Interface declarations
§17.2.1 General
§17.2.2 Interface modifiers
§17.2.3 Variant type parameter lists
§17.2.3.1 General
§17.2.3.2 Variance safety
 §17.2.3.3 Variance conversion
§17.2.4 Base interfaces
§17.3 Interface body
§17.4 Interface members
§17.4.1 General
§17.4.2 Interface methods
§17.4.3 Interface properties
§17.4.4 Interface events
§17.4.5 Interface indexers
§17.4.6 Interface member access
§17.5 Qualified interface member names
§17.6 Interface implementations
§17.6.1 General
§17.6.2 Explicit interface member implementations
§17.6.3 Uniqueness of implemented interfaces
§17.6.4 Implementation of generic methods
§17.6.5 Interface mapping
§17.6.6 Interface implementation inheritance
§17.6.7 Interface re-implementation
§17.6.8 Abstract classes and interfaces
§18 Enums
§18.1 General
§18.2 Enum declarations
§18.3 Enum modifiers
§18.4 Enum members
§18.5 The System.Enum type
§18.6 Enum values and operations
§19 Delegates
§19.1 General
§19.2 Delegate declarations
§19.3 Delegate members
§19.4 Delegate compatibility
§19.5 Delegate instantiation
§19.6 Delegate invocation
§20 Exceptions
§20.1 General
§20.2 Causes of exceptions
§20.3 The System.Exception class
§20.4 How exceptions are handled
§20.5 Common exception classes
§21 Attributes
§21.1 General
§21.2 Attribute classes
§21.2.1 General
§21.2.2 Attribute usage
§21.2.3 Positional and named parameters
§21.2.4 Attribute parameter types
§21.3 Attribute specification
§21.4 Attribute instances
§21.4.1 General
§21.4.2 Compilation of an attribute
§21.4.3 Run-time retrieval of an attribute instance
§21.5 Reserved attributes
§21.5.1 General
§21.5.2 The AttributeUsage attribute
§21.5.3 The Conditional attribute
§21.5.3.1 General
§21.5.3.2 Conditional methods
§21.5.3.3 Conditional attribute classes
§21.5.4 The Obsolete attribute
§21.5.5 Caller-info attributes
§21.5.5.1 General
§21.5.5.2 The CallerLineNumber attribute
§21.5.5.3 The CallerFilePath attribute
§21.5.5.4 The CallerMemberName attribute
§21.6 Attributes for interoperation
§22 Unsafe code
§22.1 General
§22.2 Unsafe contexts
§22.3 Pointer types
§22.4 Fixed and moveable variables
§22.5 Pointer conversions
§22.5.1 General
§22.5.2 Pointer arrays
§22.6 Pointers in expressions
§22.6.1 General
§22.6.2 Pointer indirection
§22.6.3 Pointer member access
§22.6.4 Pointer element access
§22.6.5 The address-of operator
 §22.6.6 Pointer increment and decrement
§22.6.7 Pointer arithmetic
§22.6.8 Pointer comparison
§22.6.9 The sizeof operator
§22.7 The fixed statement
§22.8 Fixed-size buffers
§22.8.1 General
§22.8.2 Fixed-size buffer declarations
§22.8.3 Fixed-size buffers in expressions
§22.8.4 Definite assignment checking
§22.9 Stack allocation
§A Grammar
§A.1 General
§A.2 Lexical grammar
§A.3 Syntactic grammar
§A.4 Grammar extensions for unsafe code
§B Portability issues
§B.1 General
§B.2 Undefined behavior
§B.3 Implementation-defined behavior
§B.4 Unspecified behavior
§B.5 Other Issues
§C Standard library
§C.1 General
§C.2 Standard Library Types defined in ISO/IEC 23271
§C.3 Standard Library Types not defined in ISO/IEC 23271
§C.4 Format Specifications
§C.5 Library Type Abbreviations
§D Documentation comments
§D.1 General
§D.2 Introduction
§D.3 Recommended tags
§D.3.1 General
§D.3.2 <c>
§D.3.3 <code>
§D.3.4 <example>
§D.3.5 <exception>
§D.3.6 <include>
§D.3.7 <list>
§D.3.8 <para>
 §D.3.9 <param>
§D.3.10 <paramref>
§D.3.11 <permission>
§D.3.12 <remarks>
§D.3.13 <returns>
§D.3.14 <see>
§D.3.15 <seealso>
§D.3.16 <summary>
§D.3.17 <typeparam>
§D.3.18 <typeparamref>
§D.3.19 <value>
§D.4 Processing the documentation file
§D.4.1 General
§D.4.2 ID string format
§D.4.3 ID string examples
§D.5 An example
§D.5.1 C# source code
§D.5.2 Resulting XML
§E Bibliography
Foreword
Artículo • 06/02/2023 • Tiempo de lectura: 2 minutos

This specification replaces ECMA-334:2022. Changes from the previous edition include
the addition of the following:

System.Delegate and System.Enum may now be used as class_type constraints.

Introducción
Artículo • 16/09/2021 • Tiempo de lectura: 52 minutos

C# (pronunciado "si sharp" en inglés) es un lenguaje de programación sencillo,

moderno, orientado a objetos y con seguridad de tipos. C# tiene sus raíces en la familia
de lenguajes C y será inmediatamente familiar para los programadores de C, C++ y Java.
C# está normalizado por ECMA International como el estándar *ECMA-334 _ y por
ISO/IEC como el estándar _ *iso/IEC 23270**. El compilador de C# de Microsoft para el
.NET Framework es una implementación compatible de ambos estándares.

C# es un lenguaje orientado a objetos, pero también incluye compatibilidad para

programación orientada a componentes. El diseño de software contemporáneo se basa
cada vez más en componentes de software en forma de paquetes independientes y
autodescriptivos de funcionalidad. La clave de estos componentes es que presentan un
modelo de programación con propiedades, métodos y eventos; tienen atributos que
proporcionan información declarativa sobre el componente; e incorporan su propia
documentación. C# proporciona construcciones de lenguaje para admitir directamente
estos conceptos, lo que permite que C# sea un lenguaje muy natural en el que crear y
usar componentes de software.

Varias características de C# ayudan en la construcción de aplicaciones sólidas y

duraderas: * la recolección de elementos no utilizados _ recupera automáticamente la
memoria ocupada por objetos no usados. el control de excepciones proporciona un
enfoque estructurado y extensible para la detección y recuperación de errores. y el
diseño con seguridad de tipos* del lenguaje hace imposible leer desde variables no
inicializadas, indizar matrices más allá de sus límites o realizar conversiones de tipo no
comprobadas.

C# tiene un sistema de tipo unificado. Todos los tipos de C#, incluidos los tipos
primitivos como int y double , se heredan de un único tipo object raíz. Por lo tanto,
todos los tipos comparten un conjunto de operaciones comunes, y los valores de todos
los tipos se pueden almacenar, transportar y utilizar de manera coherente. Además, C#
admite tipos de valor y tipos de referencia definidos por el usuario, lo que permite la
asignación dinámica de objetos, así como almacenamiento en línea de estructuras
ligeras.

Para asegurarse de que las programas y las bibliotecas de C# pueden evolucionar a lo

largo del tiempo de manera compatible, se ha puesto mucho énfasis en el
versionamiento del diseño de C#. Muchos lenguajes de programación prestan poca
atención a este problema y, como resultado, los programas escritos en dichos lenguajes
se interrumpen con más frecuencia de lo necesario cuando se introducen nuevas
versiones de las bibliotecas dependientes. Los aspectos del diseño de C# afectados
directamente por las consideraciones de versionamiento incluyen los modificadores
virtual y override independientes, las reglas para la resolución de sobrecargas de

métodos y la compatibilidad para declaraciones explícitas de miembros de interfaz.

En el resto de este capítulo se describen las características esenciales del lenguaje C#.
Aunque los capítulos posteriores describen las reglas y las excepciones en un modo
orientado a los detalles y, a veces, de forma matemática, en este capítulo se realiza una
mayor claridad y una brevedad a costa de la integridad. La intención es proporcionar al
lector una introducción al lenguaje que facilitará la escritura de programas iniciales y la
lectura de capítulos posteriores.

Hola a todos
El programa "Hola mundo" tradicionalmente se usa para presentar un lenguaje de
programación. En este caso, se usa C#:

C#

using System;

class Hello

static void Main() {

Console.WriteLine("Hello, World");

Normalmente, los archivos de código fuente de C# tienen la extensión de archivo .cs .

Suponiendo que el programa "Hello, World" se almacena en el archivo hello.cs , el
programa se puede compilar con el compilador de Microsoft C# mediante la línea de
comandos.

Consola

csc hello.cs

que genera un ensamblado ejecutable denominado hello.exe . La salida generada por

esta aplicación cuando se ejecuta es

Consola

Hello, World

El programa "Hola mundo" empieza con una directiva using que hace referencia al
espacio de nombres System . Los espacios de nombres proporcionan un método
jerárquico para organizar las bibliotecas y los programas de C#. Los espacios de
nombres contienen tipos y otros espacios de nombres; por ejemplo, el espacio de
nombres System contiene varios tipos, como la clase Console a la que se hace referencia
en el programa, y otros espacios de nombres, como IO y Collections . Una directiva
using que hace referencia a un espacio de nombres determinado permite el uso no
calificado de los tipos que son miembros de ese espacio de nombres. Debido a la
directiva using , puede utilizar el programa Console.WriteLine como abreviatura de
System.Console.WriteLine .

La clase Hello declarada por el programa "Hola mundo" tiene un miembro único, el
método llamado Main . El método Main se declara con el modificador static . Mientras
que los métodos de instancia pueden hacer referencia a una instancia de objeto
envolvente determinada utilizando la palabra clave this , los métodos estáticos
funcionan sin referencia a un objeto determinado. Por convención, un método estático
denominado Main sirve como punto de entrada de un programa.

La salida del programa la genera el método WriteLine de la clase Console en el espacio

de nombres System . Esta clase la proporcionan las bibliotecas de clases de .NET
Framework, a las que, de forma predeterminada, el compilador de Microsoft C# hace
referencia automáticamente. Tenga en cuenta que C# no tiene una biblioteca en tiempo
de ejecución independiente. En su lugar, el .NET Framework es la biblioteca en tiempo
de ejecución de C#.

Estructura del programa

Los conceptos clave de la organización en C# son programas _, _espacios de nombres_,
_tipos_, _miembros_ y _ensamblados*., types, members, and *assemblies*. Los programas
de C# constan de uno o más archivos de origen. Los programas declaran tipos, que
contienen miembros y pueden organizarse en espacios de nombres. Las clases e
interfaces son ejemplos de tipos. Los campos, los métodos, las propiedades y los
eventos son ejemplos de miembros. Cuando se compilan programas de C#, se
empaquetan físicamente en ensamblados. Normalmente, los ensamblados tienen la
extensión de archivo .exe o .dll , dependiendo de si implementan aplicaciones o _
bibliotecas *.

En el ejemplo

C#
 using System;

namespace Acme.Collections

public class Stack

Entry top;

public void Push(object data) {

top = new Entry(top, data);

public object Pop() {

if (top == null) throw new InvalidOperationException();

object result = top.data;

top = top.next;

return result;

class Entry

public Entry next;

public object data;

public Entry(Entry next, object data) {

this.next = next;
this.data = data;
}

declara una clase denominada Stack en un espacio de nombres denominado

Acme.Collections . El nombre completo de esta clase es Acme.Collections.Stack . La

clase contiene varios miembros: un campo denominado top , dos métodos

denominados Push y Pop , y una clase anidada denominada Entry . La clase Entry
contiene además tres miembros: un campo denominado next , un campo denominado
data y un constructor. Suponiendo que el código fuente del ejemplo se almacene en el

archivo acme.cs , la línea de comandos

Consola

csc /t:library acme.cs

compila el ejemplo como una biblioteca (código sin un punto de entrada Main y genera
un ensamblado denominado acme.dll .
Los ensamblados contienen código ejecutable en forma de instrucciones de lenguaje
intermedio _ (IL) e información simbólica con el formato _ Metadata *. Antes de
ejecutarlo, el código de IL de un ensamblado se convierte automáticamente en código
específico del procesador mediante el compilador de Just in Time (JIT) de .NET Common
Language Runtime.

Dado que un ensamblado es una unidad autodescriptiva de funcionalidad que contiene

código y metadatos, no hay necesidad de directivas #include ni archivos de
encabezado de C#. Los tipos y miembros públicos contenidos en un ensamblado
determinado estarán disponibles en un programa de C# simplemente haciendo
referencia a dicho ensamblado al compilar el programa. Por ejemplo, este programa usa
la clase Acme.Collections.Stack desde el ensamblado acme.dll :

C#

using System;

using Acme.Collections;

class Test

static void Main() {

Stack s = new Stack();

s.Push(1);

s.Push(10);

s.Push(100);

Console.WriteLine(s.Pop());

Console.WriteLine(s.Pop());

Console.WriteLine(s.Pop());

Si el programa se almacena en el archivo test.cs , cuando test.cs se compila, se

acme.dll puede hacer referencia al ensamblado mediante la opción del compilador /r :

Consola

csc /r:acme.dll test.cs

Esto crea un ensamblado ejecutable denominado test.exe , que, cuando se ejecuta,

produce el resultado:

Consola

100

10

C# permite que el texto de origen de un programa se almacene en varios archivos de

origen. Cuando se compila un programa de C# de varios archivos, todos los archivos de
origen se procesan juntos y los archivos de origen pueden hacerse referencia
mutuamente de forma libre; desde un punto de vista conceptual, es como si todos los
archivos de origen estuvieran concatenados en un archivo de gran tamaño antes de ser
procesados. En C# nunca se necesitan declaraciones adelantadas porque, excepto en
contadas ocasiones, el orden de declaración es insignificante. C# no limita un archivo de
origen a declarar solamente un tipo público ni precisa que el nombre del archivo de
origen coincida con un tipo declarado en el archivo de origen.

Tipos y variables
Hay dos tipos de tipos en C#: *tipos de valor _ y _ tipos de referencia *. Las variables de
tipos de valor contienen directamente los datos, mientras que las variables de los tipos
de referencia almacenan referencias a los datos, lo que se conoce como objetos. Con los
tipos de referencia, es posible que dos variables hagan referencia al mismo objeto y
que, por tanto, las operaciones en una variable afecten al objeto al que hace referencia
la otra variable. Con los tipos de valor, cada variable tiene su propia copia de los datos y
no es posible que las operaciones en una variable afecten a la otra (excepto en el caso
de las variables de parámetro ref y out ).

Los tipos de valor de C# se dividen en *** tipos simples*, _tipos de enumeración_, _tipos
de struct_ y tipos que _aceptan valores NULL_, y los tipos de referencia de C# se dividen en
_tipos de clase_, tipos de _interfaz_, _tipos de matriz*_ y tipos de delegado _ * * *.

En la tabla siguiente se proporciona información general sobre el sistema de tipos de

C#.

Categoría Descripción

Tipos de Tipos simples Entero con signo: sbyte , short , int , long
valor

Entero sin signo: byte , ushort , uint , ulong

Caracteres Unicode: char

Punto flotante de IEEE: float , double

Decimal de alta precisión: decimal

Booleano: bool
 Categoría Descripción

Tipos de enumeración Tipos definidos por el usuario con el formato enum E

{...}

Tipos de estructura Tipos definidos por el usuario con el formato struct S

{...}

Tipos que aceptan Extensiones de todos los demás tipos de valor con un
valores NULL valor null

Tipos de Tipos de clase Clase base definitiva de todos los demás tipos: object
referencia

Cadenas Unicode: string

Tipos definidos por el usuario con el formato class C

{...}

Tipos de interfaz Tipos definidos por el usuario con el formato interface

I {...}

Tipos de matriz Unidimensional y multidimensional; por ejemplo, int[] y

int[,]

Tipos delegados Tipos definidos por el usuario del formulario, por

ejemplo, delegate int D(...)

Los ocho tipos enteros proporcionan compatibilidad con valores de 8, 16, 32 y 64 bits
en formato con o sin signo.

Los dos tipos de punto flotante, float y double , se representan mediante los formatos
IEEE 754 de precisión sencilla de 32 bits y de doble precisión de 64 bits.

El tipo decimal es un tipo de datos de 128 bits adecuado para cálculos financieros y
monetarios.

El tipo de C# bool se usa para representar valores booleanos: valores que son true o
false .

El procesamiento de caracteres y cadenas en C# utiliza la codificación Unicode. El tipo

char representa una unidad de código UTF-16 y el tipo string representa una
secuencia de unidades de código UTF-16.

En la tabla siguiente se resumen los tipos numéricos de C#.

Categoría Bits Tipo Intervalo/precisión

 Categoría Bits Tipo Intervalo/precisión

Entero con signo 8 sbyte -128... 127

16 short -32768... 32, 767

32 int -2147483648... 2, 147, 483, 647

64 long -9223372036854775808... 9, 223, 372, 036, 854, 775, 807

Entero sin signo 8 byte 0... 255

16 ushort 0... 65, 535

32 uint 0... 4, 294, 967, 295

64 ulong 0... 18, 446, 744, 073, 709, 551, 615

Punto flotante 32 float 1,5 × 10 ^ − 45 a 3,4 × 10 ^ 38, precisión de 7 dígitos

64 double 5,0 × 10 ^ − 324 a 1,7 × 10 ^ 308, precisión de 15 dígitos

Decimal 128 decimal 1,0 × 10 ^ − 28 a 7,9 × 10 ^ 28, precisión de 28 dígitos

Los programas de C# utilizan declaraciones de tipos para crear nuevos tipos. Una
declaración de tipos especifica el nombre y los miembros del nuevo tipo. Cinco de las
categorías de tipos de C# las define el usuario: tipos de clase, tipos de estructura, tipos
de interfaz, tipos de enumeración y tipos delegados.

Un tipo de clase define una estructura de datos que contiene miembros de datos
(campos) y miembros de función (métodos, propiedades, etc.). Los tipos de clase
admiten herencia única y polimorfismo, mecanismos por los que las clases derivadas
pueden extender y especializar clases base.

Un tipo de estructura es similar a un tipo de clase en que representa una estructura con
miembros de datos y miembros de función. Sin embargo, a diferencia de las clases, las
estructuras son tipos de valor y no requieren la asignación del montón. Los tipos struct
no admiten la herencia especificada por el usuario y todos los tipos de struct se heredan
implícitamente del tipo object .

Un tipo de interfaz define un contrato como un conjunto con nombre de miembros de

función públicos. Una clase o estructura que implementa una interfaz debe
proporcionar implementaciones de los miembros de función de la interfaz. Una interfaz
puede heredar de varias interfaces base, y una clase o estructura puede implementar
varias interfaces.
Un tipo de delegado representa las referencias a métodos con una lista de parámetros
determinada y un tipo de valor devuelto. Los delegados permiten tratar métodos como
entidades que se puedan asignar a variables y se puedan pasar como parámetros. Los
delegados son similares al concepto de punteros de función en otros lenguajes, pero a
diferencia de los punteros de función, los delegados están orientados a objetos y
presentan seguridad de tipos.

Los tipos de clase, estructura, interfaz y delegado admiten genéricos, mediante los
cuales se pueden parametrizar con otros tipos.

Un tipo de enumeración es un tipo distinto con constantes con nombre. Cada tipo de
enumeración tiene un tipo subyacente, que debe ser uno de los ocho tipos enteros. El
conjunto de valores de un tipo de enumeración es igual que el conjunto de valores del
tipo subyacente.

C# admite matrices unidimensionales y multidimensionales de cualquier tipo. A

diferencia de los tipos enumerados anteriormente, los tipos de matriz no tienen que ser
declarados antes de usarlos. En su lugar, los tipos de matriz se crean mediante un
nombre de tipo entre corchetes. Por ejemplo, int[] es una matriz unidimensional de
int , int[,] es una matriz bidimensional de int y es una matriz unidimensional de
int[][] Matrices unidimensionales de int .

Los tipos que aceptan valores NULL tampoco tienen que declararse antes de que se
puedan utilizar. Para cada tipo de valor que no acepta valores NULL T , existe un tipo
que acepta valores NULL correspondiente T? , que puede contener un valor adicional
null . Por ejemplo, int? es un tipo que puede contener cualquier entero de 32 bits o el

valor null .

El sistema de tipos de C# está unificado, de modo que un valor de cualquier tipo se

puede tratar como un objeto. Todos los tipos de C# directa o indirectamente se derivan
del tipo de clase object , y object es la clase base definitiva de todos los tipos. Los
valores de tipos de referencia se tratan como objetos mediante la visualización de los
valores como tipo object . Los valores de los tipos de valor se tratan como objetos
mediante la realización de operaciones *Boxing _ y _ *conversión unboxing**. En el
ejemplo siguiente, un valor int se convierte en object y vuelve a int .

C#

using System;

class Test

static void Main() {

int i = 123;

 object o = i; // Boxing

int j = (int)o; // Unboxing

Cuando un valor de un tipo de valor se convierte al tipo object , se asigna una instancia
de objeto, también denominada "box", para contener el valor, y el valor se copia en ese
cuadro. Por el contrario, cuando una object referencia se convierte en un tipo de valor,
se realiza una comprobación de que el objeto al que se hace referencia es un cuadro del
tipo de valor correcto y, si la comprobación se realiza correctamente, se copia el valor
en el cuadro.

El sistema de tipos unificado de C# significa que los tipos de valor pueden convertirse
en objetos "a petición". Debido a la unificación, las bibliotecas de uso general que
utilizan el tipo object pueden usarse con tipos de referencia y tipos de valor.

Hay varios tipos de variables en C#, entre otras, campos, elementos de matriz, variables
locales y parámetros. Las variables representan ubicaciones de almacenamiento, y cada
variable tiene un tipo que determina qué valores se pueden almacenar en la variable,
como se muestra en la tabla siguiente.

Tipo de Contenido posible

variable

Tipo de Un valor de ese tipo exacto

valor
distinto a
NULL

Tipos de Un valor null o un valor de ese tipo exacto

valor
NULL

object Una referencia nula, una referencia a un objeto de cualquier tipo de referencia o una
referencia a un valor de conversión boxing de cualquier tipo de valor

Tipo de Una referencia nula, una referencia a una instancia de ese tipo de clase o una
clase referencia a una instancia de una clase derivada de ese tipo de clase.

Tipo de Una referencia nula, una referencia a una instancia de un tipo de clase que
interfaz implementa ese tipo de interfaz o una referencia a un valor de conversión boxing de
un tipo de valor que implementa ese tipo de interfaz.

Tipo de Una referencia nula, una referencia a una instancia de ese tipo de matriz o una
matriz referencia a una instancia de un tipo de matriz compatible
 Tipo de Contenido posible
variable

Tipo Una referencia nula o una referencia a una instancia de ese tipo de delegado.
delegado

Expresiones
Las expresiones _ se construyen a partir de _operandos_ y _operadores*. and *operators*.
Los operadores de una expresión indican qué operaciones se aplican a los operandos.
Ejemplos de operadores incluyen + , - , _ , / y new . Algunos ejemplos de operandos son
literales, campos, variables locales y expresiones.

Cuando una expresión contiene varios operadores, el *precedencia _ de los operadores

controla el orden en el que se evalúan los operadores individuales. Por ejemplo, la
expresión x + y _ z se evalúa como x + (y * z) porque el operador * tiene mayor
precedencia que el operador + .

La mayoría de los operadores se pueden sobrecargar. La sobrecarga de operador

permite la especificación de implementaciones de operadores definidas por el usuario
para operaciones donde uno o ambos operandos son de un tipo de struct o una clase
definidos por el usuario.

En la tabla siguiente se resumen los operadores de C# y se enumeran las categorías de

operador en orden de prioridad, de mayor a menor. Los operadores de la misma
categoría tienen la misma precedencia.

Categoría Expression Descripción

Principal x.m Acceso a miembros

x(...) Invocación de método y delegado

x[...] Acceso a matriz e indizador

x++ Postincremento

x-- Postdecremento

new T(...) Creación de objetos y delegados

new T(...) creación de objetos con inicializador

{...}

new {...} inicializador de objetos anónimos

Categoría Expression Descripción

new T[...] creación de matriz

typeof(T) obtener el objeto System.Type para T

checked(x) Evaluar expresión en contexto comprobado

unchecked(x) Evaluar expresión en contexto no comprobado

default(T) obtener valor predeterminado de tipo T

delegate Función anónima (método anónimo)

{...}

Unario +x Identidad

-x Negación

!x Negación lógica

~x Negación bit a bit

++x Preincremento

--x Predecremento

(T)x convertir explícitamente x en el tipo T

await x esperar asincrónicamente a que finalice x

Multiplicativa x * y Multiplicación

x / y División

x % y Resto

Aditiva x + y Suma, concatenación de cadenas, combinación de

delegados

x - y Resta, eliminación de delegados

Shift x << y Desplazamiento a la izquierda

x >> y Desplazamiento a la derecha

Comprobación de x < y Menor que

tipos y relacional

x > y Mayor que

x <= y Menor o igual que

 Categoría Expression Descripción

x >= y Mayor o igual que

x is T volver a ejecutar true si x es una T , de lo contrario

false

x as T volver a ejecutar x con tipo T , o null si x no es una T

Igualdad x == y Igual

x != y No igual a

Y lógico x & y AND bit a bit entero, AND lógico booleano

XOR lógico x ^ y XOR bit a bit entero, XOR lógico booleano

O lógico x | y OR bit a bit entero, OR lógico booleano

AND condicional x && y Solo evalúa y si x es true

OR condicional x || y Solo evalúa y si x es false

Uso combinado de x ?? y Se evalúa como y si x es null , en x caso contrario,.

NULL

Condicional x ? y : z se evalúa como y si x es true o z si x es false

Asignación o función x = y Asignación

anónima

x op= y Asignación compuesta; los operadores admitidos *= /=

%= += -= <<= son >>= &= ^= |=

(T x) => y Función anónima (expresión lambda)

Instrucciones
Las acciones de un programa se expresan mediante instrucciones. C# admite varios
tipos de instrucciones diferentes, varias de las cuales se definen en términos de
instrucciones insertadas.

Un bloque permite que se escriban varias instrucciones en contextos donde se permite

una única instrucción. Un bloque se compone de una lista de instrucciones escritas entre
los delimitadores { y } .

Las instrucciones de declaración se usan para declarar variables locales y constantes.

Las instrucciones de expresión se usan para evaluar expresiones. Entre las expresiones
que se pueden utilizar como instrucciones se incluyen las invocaciones de método, las
asignaciones de objetos que usan el new operador, las asignaciones mediante = y los
operadores de asignación compuesta, las operaciones de incremento y decremento
mediante los ++ -- operadores y y las expresiones Await.

Las instrucciones de selección se usan para seleccionar una de varias instrucciones

posibles para su ejecución en función del valor de alguna expresión. En este grupo están
las instrucciones if y switch .

Las instrucciones de iteración se utilizan para ejecutar repetidamente una instrucción

incrustada. En este grupo están las instrucciones while , do , for y foreach .

Las instrucciones de salto se usan para transferir el control. En este grupo están las
instrucciones break , continue , goto , throw , return y yield .

La instrucción try ... catch se usa para detectar excepciones que se producen durante la
ejecución de un bloque, y la instrucción try ... finally se usa para especificar el código
de finalización que siempre se ejecuta, tanto si se ha producido una excepción como si
no.

Las checked unchecked instrucciones y se utilizan para controlar el contexto de

comprobación de desbordamiento para conversiones y operaciones aritméticas de tipo
entero.

La instrucción lock se usa para obtener el bloqueo de exclusión mutua para un objeto
determinado, ejecutar una instrucción y, luego, liberar el bloqueo.

La instrucción using se usa para obtener un recurso, ejecutar una instrucción y, luego,
eliminar dicho recurso.

A continuación se muestran ejemplos de cada tipo de instrucción

Declaraciones de variables locales

C#

static void Main() {

int a;

int b = 2, c = 3;

a = 1;

Console.WriteLine(a + b + c);

Declaración de constante local

 C#

static void Main() {

const float pi = 3.1415927f;

const int r = 25;

Console.WriteLine(pi * r * r);

Expression (Instrucción)

C#

static void Main() {

int i;

i = 123; // Expression statement

Console.WriteLine(i); // Expression statement

i++; // Expression statement

Console.WriteLine(i); // Expression statement

Instrucción if

C#

static void Main(string[] args) {

if (args.Length == 0) {

Console.WriteLine("No arguments");

else {

Console.WriteLine("One or more arguments");

Instrucción switch

C#

static void Main(string[] args) {

int n = args.Length;

switch (n) {

case 0:

Console.WriteLine("No arguments");

break;

case 1:

Console.WriteLine("One argument");

break;

default:

Console.WriteLine("{0} arguments", n);

break;

Instrucción while

C#

static void Main(string[] args) {

int i = 0;

while (i < args.Length) {

Console.WriteLine(args[i]);

i++;

Instrucción do

C#

static void Main() {

string s;

do {

s = Console.ReadLine();

if (s != null) Console.WriteLine(s);

} while (s != null);

Instrucción for

C#

static void Main(string[] args) {

for (int i = 0; i < args.Length; i++) {

Console.WriteLine(args[i]);

Instrucción foreach

C#

static void Main(string[] args) {

foreach (string s in args) {

Console.WriteLine(s);

Instrucción break

C#

static void Main() {

while (true) {

string s = Console.ReadLine();

if (s == null) break;

Console.WriteLine(s);

Instrucción continue

C#

static void Main(string[] args) {

for (int i = 0; i < args.Length; i++) {

if (args[i].StartsWith("/")) continue;

Console.WriteLine(args[i]);

Instrucción goto

C#

static void Main(string[] args) {

int i = 0;

goto check;

loop:

Console.WriteLine(args[i++]);
check:

if (i < args.Length) goto loop;

Instrucción return

C#

static int Add(int a, int b) {

return a + b;

static void Main() {

Console.WriteLine(Add(1, 2));

return;

Instrucción yield

C#

static IEnumerable<int> Range(int from, int to) {

for (int i = from; i < to; i++) {

yield return i;
}

yield break;

static void Main() {

foreach (int x in Range(-10,10)) {

Console.WriteLine(x);

throw``try instrucciones y

C#

static double Divide(double x, double y) {

if (y == 0) throw new DivideByZeroException();

return x / y;

static void Main(string[] args) {

try {

if (args.Length != 2) {

throw new Exception("Two numbers required");

double x = double.Parse(args[0]);

double y = double.Parse(args[1]);

Console.WriteLine(Divide(x, y));

catch (Exception e) {

Console.WriteLine(e.Message);

finally {

Console.WriteLine("Good bye!");

checked``unchecked instrucciones y

C#

static void Main() {

int i = int.MaxValue;

checked {

Console.WriteLine(i + 1); // Exception

unchecked {

Console.WriteLine(i + 1); // Overflow

Instrucción lock

C#

class Account

decimal balance;

public void Withdraw(decimal amount) {

lock (this) {

if (amount > balance) {

throw new Exception("Insufficient funds");

balance -= amount;

Instrucción using

C#

static void Main() {

using (TextWriter w = File.CreateText("test.txt")) {

w.WriteLine("Line one");

w.WriteLine("Line two");

w.WriteLine("Line three");

Clases y objetos
*Las clases _ son los tipos más fundamentales de C#. Una clase es una estructura de
datos que combina estados (campos) y acciones (métodos y otros miembros de
función) en una sola unidad. Una clase proporciona una definición para las instancias
creadas dinámicamente de la clase, también conocidas como objetos. Las clases admiten
la herencia y el polimorfismo, mecanismos por los que las clases derivadas pueden
extender y especializar _ clases base *.

Las clases nuevas se crean mediante declaraciones de clase. Una declaración de clase se
inicia con un encabezado que especifica los atributos y modificadores de la clase, el
nombre de la clase, la clase base (si se indica) y las interfaces implementadas por la
clase. Al encabezado le sigue el cuerpo de la clase, que consta de una lista de
declaraciones de miembros escritas entre los delimitadores { y } .

La siguiente es una declaración de una clase simple denominada Point :

C#

public class Point

public int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

Las instancias de clases se crean mediante el operador new , que asigna memoria para
una nueva instancia, invoca un constructor para inicializar la instancia y devuelve una
referencia a la instancia. Las instrucciones siguientes crean dos objetos Point y
almacenan las referencias en esos objetos en dos variables:

C#

Point p1 = new Point(0, 0);

Point p2 = new Point(10, 20);

La memoria ocupada por un objeto se recupera automáticamente cuando el objeto ya

no está en uso. No es necesario ni posible desasignar explícitamente objetos en C#.

Miembros
Los miembros de una clase son *miembros estáticos _ o _ miembros de instancia *. Los
miembros estáticos pertenecen a clases y los miembros de instancia pertenecen a
objetos (instancias de clases).

En la tabla siguiente se proporciona información general sobre los tipos de miembros

que puede contener una clase.

Member Descripción

Constantes Valores constantes asociados a la clase

Campos Variables de la clase

 Member Descripción

Métodos Cálculos y acciones que pueden realizarse mediante la clase

Propiedades Acciones asociadas a la lectura y escritura de propiedades con nombre de la clase

Indizadores Acciones asociadas a la indexación de instancias de la clase como una matriz

Events Notificaciones que puede generar la clase

Operadores Conversiones y operadores de expresión admitidos por la clase

Constructores Acciones necesarias para inicializar instancias de la clase o la clase propiamente

dicha

Destructores Acciones que deben realizarse antes de que las instancias de la clase se descarten
de forma permanente

Tipos Tipos anidados declarados por la clase

Accesibilidad
Cada miembro de una clase tiene asociada una accesibilidad, que controla las regiones
del texto del programa que pueden tener acceso al miembro. Existen cinco formas
posibles de accesibilidad. Estos se resumen en la siguiente tabla.

Accesibilidad Significado

public Acceso no limitado

protected Acceso limitado a esta clase o a las clases derivadas de esta clase

internal Acceso limitado a este programa

protected internal Acceso limitado a este programa o a las clases derivadas de esta clase

private Acceso limitado a esta clase

Parámetros de tipo
Una definición de clase puede especificar un conjunto de parámetros de tipo poniendo
tras el nombre de clase una lista de nombres de parámetro de tipo entre corchetes
angulares. Los parámetros de tipo pueden usarse luego en el cuerpo de las
declaraciones de clase para definir a los miembros de la clase. En el ejemplo siguiente,
los parámetros de tipo de Pair son TFirst y TSecond :

C#
 public class Pair<TFirst,TSecond>

public TFirst First;

public TSecond Second;

Un tipo de clase que se declara para tomar parámetros de tipo se denomina tipo de
clase genérico. Los tipos struct, interfaz y delegado también pueden ser genéricos.

Cuando se usa la clase genérica, se deben proporcionar argumentos de tipo para cada
uno de los parámetros de tipo:

C#

Pair<int,string> pair = new Pair<int,string> { First = 1, Second = "two" };

int i = pair.First; // TFirst is int

string s = pair.Second; // TSecond is string

Un tipo genérico con argumentos de tipo proporcionados, como Pair<int,string> el

anterior, se denomina tipo construido.

Clases base
Una declaración de clase puede especificar una clase base colocando después del
nombre de clase y los parámetros de tipo dos puntos seguidos del nombre de la clase
base. Omitir una especificación de la clase base es igual que derivarla del tipo object .
En el ejemplo siguiente, la clase base de Point3D es Point y la clase base de Point es
object :

C#

public class Point

public int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

public class Point3D: Point

public int z;

public Point3D(int x, int y, int z): base(x, y) {

 this.z = z;

Una clase hereda a los miembros de su clase base. La herencia significa que una clase
contiene implícitamente todos los miembros de su clase base, excepto la instancia y
constructores estáticos, y los destructores de la clase base. Una clase derivada puede
agregar nuevos miembros a aquellos de los que hereda, pero no puede quitar la
definición de un miembro heredado. En el ejemplo anterior, Point3D hereda los campos
x y y de Point y cada instancia de Point3D contiene tres campos: x , y y z .

Existe una conversión implícita de un tipo de clase a cualquiera de sus tipos de clase
base. Por lo tanto, una variable de un tipo de clase puede hacer referencia a una
instancia de esa clase o a una instancia de cualquier clase derivada. Por ejemplo, dadas
las declaraciones de clase anteriores, una variable de tipo Point puede hacer referencia
a una instancia de Point o Point3D :

C#

Point a = new Point(10, 20);

Point b = new Point3D(10, 20, 30);

Campos
Un campo es una variable que está asociada con una clase o a una instancia de una
clase.

Un campo declarado con el static modificador define un campo estático. Un campo

estático identifica exactamente una ubicación de almacenamiento. Independientemente
del número de instancias de una clase que se creen, siempre solo hay una copia de un
campo estático.

Un campo declarado sin el static modificador define un campo de instancia. Cada

instancia de una clase contiene una copia independiente de todos los campos de
instancia de esa clase.

En el ejemplo siguiente, cada instancia de la clase Color tiene una copia independiente
de los campos de instancia r , g y b , pero solo hay una copia de los campos estáticos
Black , White , Red , Green y Blue :

C#
 public class Color

public static readonly Color Black = new Color(0, 0, 0);

public static readonly Color White = new Color(255, 255, 255);

public static readonly Color Red = new Color(255, 0, 0);

public static readonly Color Green = new Color(0, 255, 0);

public static readonly Color Blue = new Color(0, 0, 255);

private byte r, g, b;

public Color(byte r, byte g, byte b) {

this.r = r;

this.g = g;

this.b = b;

Como se muestra en el ejemplo anterior, los campos de solo lectura se puede declarar
con un modificador readonly . La asignación a un readonly campo solo se puede
producir como parte de la declaración del campo o en un constructor de la misma clase.

Métodos
Un *método _ es un miembro que implementa un cálculo o una acción que puede
realizar un objeto o una clase. Se tiene acceso a los métodos estáticos a través de la
clase. _ Se tiene acceso a los métodos de instancia* a través de instancias de la clase.

Los métodos tienen una lista (posiblemente vacía) de *Parameters _, que representan
valores o referencias a variables que se pasan al método, y un tipo de valor devuelto _ *
* *, que especifica el tipo del valor calculado y devuelto por el método. El tipo de valor
devuelto de un método es void si no devuelve un valor.

Al igual que los tipos, los métodos también pueden tener un conjunto de parámetros de
tipo, para lo cuales se deben especificar argumentos de tipo cuando se llama al método.
A diferencia de los tipos, los argumentos de tipo a menudo se pueden deducir de los
argumentos de una llamada al método y no es necesario proporcionarlos
explícitamente.

La signatura de un método debe ser única en la clase en la que se declara el método. La

signatura de un método se compone del nombre del método, el número de parámetros
de tipo y el número, los modificadores y los tipos de sus parámetros. La signatura de un
método no incluye el tipo de valor devuelto.

Parámetros
Los parámetros se usan para pasar valores o referencias a variables a métodos. Los
parámetros de un método obtienen sus valores reales de los argumentos que se
especifican cuando se invoca el método. Hay cuatro tipos de parámetros: parámetros de
valor, parámetros de referencia, parámetros de salida y matrices de parámetros.

Un parámetro de valor se usa para el paso de parámetros de entrada. Un parámetro de

valor corresponde a una variable local que obtiene su valor inicial del argumento que se
ha pasado para el parámetro. Las modificaciones en un parámetro de valor no afectan el
argumento que se pasa para el parámetro.

Los parámetros de valor pueden ser opcionales; se especifica un valor predeterminado

para que se puedan omitir los argumentos correspondientes.

Un parámetro de referencia se usa para el paso de parámetros de entrada y salida. El

argumento pasado para un parámetro de referencia debe ser una variable, y durante la
ejecución del método, el parámetro de referencia representa la misma ubicación de
almacenamiento que la variable del argumento. Un parámetro de referencia se declara
con el modificador ref . En el ejemplo siguiente se muestra el uso de parámetros ref .

C#

using System;

class Test

static void Swap(ref int x, ref int y) {

int temp = x;

x = y;

y = temp;

static void Main() {

int i = 1, j = 2;

Swap(ref i, ref j);

Console.WriteLine("{0} {1}", i, j); // Outputs "2 1"

Un parámetro de salida se usa para pasar parámetros de salida. Un parámetro de salida

es similar a un parámetro de referencia, salvo que el valor inicial del argumento
proporcionado por el llamador no es importante. Un parámetro de salida se declara con
el modificador out . En el ejemplo siguiente se muestra el uso de parámetros out .

C#

using System;

 class Test

static void Divide(int x, int y, out int result, out int remainder) {

result = x / y;

remainder = x % y;

static void Main() {

int res, rem;

Divide(10, 3, out res, out rem);

Console.WriteLine("{0} {1}", res, rem); // Outputs "3 1"

Una matriz de parámetros permite que se pasen a un método un número variable de

argumentos. Una matriz de parámetros se declara con el modificador params . Solo el
último parámetro de un método puede ser una matriz de parámetros y el tipo de una
matriz de parámetros debe ser un tipo de matriz unidimensional. Los métodos Write y
WriteLine de la clase System.Console son buenos ejemplos de uso de la matriz de

parámetros. Se declaran de la manera siguiente.

C#

public class Console

public static void Write(string fmt, params object[] args) {...}

public static void WriteLine(string fmt, params object[] args) {...}

...

Dentro de un método que usa una matriz de parámetros, la matriz de parámetros se

comporta exactamente igual que un parámetro normal de un tipo de matriz. Sin
embargo, en una invocación de un método con una matriz de parámetros, es posible
pasar un único argumento del tipo de matriz de parámetros o cualquier número de
argumentos del tipo de elemento de la matriz de parámetros. En este caso, una
instancia de matriz se e inicializa automáticamente con los argumentos dados. Este
ejemplo

C#

Console.WriteLine("x={0} y={1} z={2}", x, y, z);

es equivalente a escribir lo siguiente.

C#
 string s = "x={0} y={1} z={2}";

object[] args = new object[3];

args[0] = x;

args[1] = y;

args[2] = z;

Console.WriteLine(s, args);

Cuerpo del método y variables locales

El cuerpo de un método especifica las instrucciones que se ejecutan cuando se invoca el
método.

Un cuerpo del método puede declarar variables que son específicas de la invocación del
método. Estas variables se denominan variables locales. Una declaración de variable
local especifica un nombre de tipo, un nombre de variable y, posiblemente, un valor
inicial. En el ejemplo siguiente se declara una variable local i con un valor inicial de
cero y una variable local j sin ningún valor inicial.

C#

using System;

class Squares

static void Main() {

int i = 0;

int j;

while (i < 10) {

j = i * i;

Console.WriteLine("{0} x {0} = {1}", i, j);

i = i + 1;

C# requiere que se asigne definitivamente una variable local antes de que se pueda
obtener su valor. Por ejemplo, si la declaración de i anterior no incluyera un valor
inicial, el compilador notificaría un error con los usos posteriores de i porque i no se
asignaría definitivamente en esos puntos del programa.

Puede usar una instrucción return para devolver el control a su llamador. En un método
que devuelve void , las instrucciones return no pueden especificar una expresión. En un
método que devuelve void instrucciones no, return debe incluir una expresión que
calcule el valor devuelto.
Métodos estáticos y de instancia
Un método declarado con un modificador static es un método estático. Un método
estático no opera en una instancia específica y solo puede acceder directamente a
miembros estáticos.

Un método declarado sin un modificador static es un método de instancia. Un

método de instancia opera en una instancia específica y puede acceder a miembros
estáticos y de instancia. Se puede acceder explícitamente a la instancia en la que se
invoca un método de instancia como this . Es un error hacer referencia a this en un
método estático.

La siguiente clase Entity tiene miembros estáticos y de instancia.

C#

class Entity

static int nextSerialNo;

int serialNo;

public Entity() {

serialNo = nextSerialNo++;

public int GetSerialNo() {

return serialNo;

public static int GetNextSerialNo() {

return nextSerialNo;

public static void SetNextSerialNo(int value) {

nextSerialNo = value;

Cada instancia Entity contiene un número de serie (y probablemente alguna otra

información que no se muestra aquí). El constructor Entity (que es como un método de
instancia) inicializa la nueva instancia con el siguiente número de serie disponible. Dado
que el constructor es un miembro de instancia, se le permite acceder al campo de
instancia serialNo y al campo estático nextSerialNo .

Los métodos estáticos GetNextSerialNo y SetNextSerialNo pueden acceder al campo

estático nextSerialNo , pero sería un error para ellas acceder directamente al campo de
instancia serialNo .
En el ejemplo siguiente se muestra el uso de la clase Entity .

C#

using System;

class Test

static void Main() {

Entity.SetNextSerialNo(1000);

Entity e1 = new Entity();

Entity e2 = new Entity();

Console.WriteLine(e1.GetSerialNo()); // Outputs "1000"

Console.WriteLine(e2.GetSerialNo()); // Outputs "1001"

Console.WriteLine(Entity.GetNextSerialNo()); // Outputs "1002"

Tenga en cuenta que los métodos estáticos SetNextSerialNo y GetNextSerialNo se

invocan en la clase, mientras que el método de instancia GetSerialNo se invoca en
instancias de la clase.

Métodos virtual, de reemplazo y abstracto

Cuando una declaración de método de instancia incluye un virtual modificador, se

dice que el método es un *método virtual _. Cuando no virtual existe ningún
modificador, se dice que el método es un método no virtual* *.

Cuando se invoca un método virtual, el tipo de tiempo de ejecución* de la instancia

para la que tiene lugar la invocación determina la implementación de método real que
se va a invocar. En una invocación de método no virtual, el tipo de tiempo de
compilación _ * de la instancia es el factor determinante.

Un método virtual puede ser reemplazado en una clase derivada. Cuando una
declaración de método de instancia incluye un override modificador, el método
invalida un método virtual heredado con la misma firma. Mientras que una declaración
de método virtual introduce un método nuevo, una declaración de método de
reemplazo especializa un método virtual heredado existente proporcionando una nueva
implementación de ese método.

Un método abstracto es un método virtual sin implementación. Un método abstracto se

declara con el abstract modificador y solo se permite en una clase que también se
declara abstract . Un método abstracto debe reemplazarse en todas las clases
derivadas no abstractas.
En el ejemplo siguiente se declara una clase abstracta, Expression , que representa un
nodo de árbol de expresión y tres clases derivadas, Constant , VariableReference y
Operation , que implementan nodos de árbol de expresión para constantes, referencias a

variables y operaciones aritméticas. (Esto es similar a, pero no debe confundirse con los
tipos de árbol de expresión introducidos en los tipos de árbol de expresión).

C#

using System;

using System.Collections;

public abstract class Expression

public abstract double Evaluate(Hashtable vars);

public class Constant: Expression

double value;

public Constant(double value) {

this.value = value;

public override double Evaluate(Hashtable vars) {

return value;

public class VariableReference: Expression

string name;

public VariableReference(string name) {

this.name = name;

public override double Evaluate(Hashtable vars) {

object value = vars[name];

if (value == null) {

throw new Exception("Unknown variable: " + name);

return Convert.ToDouble(value);

public class Operation: Expression

Expression left;

char op;

Expression right;

 public Operation(Expression left, char op, Expression right) {

this.left = left;

this.op = op;

this.right = right;

public override double Evaluate(Hashtable vars) {

double x = left.Evaluate(vars);

double y = right.Evaluate(vars);

switch (op) {

case '+': return x + y;

case '-': return x - y;

case '*': return x * y;

case '/': return x / y;

throw new Exception("Unknown operator");

Las cuatro clases anteriores se pueden usar para modelar expresiones aritméticas. Por
ejemplo, usando instancias de estas clases, la expresión x + 3 se puede representar de
la manera siguiente.

C#

Expression e = new Operation(

new VariableReference("x"),

'+',

new Constant(3));

El método Evaluate de una instancia Expression se invoca para evaluar la expresión

determinada y generar un valor double . El método toma como argumento un
Hashtable que contiene nombres de variables (como claves de las entradas) y valores
(como valores de las entradas). El Evaluate método es un método abstracto virtual, lo
que significa que las clases derivadas no abstractas deben invalidarlo para proporcionar
una implementación real.

Una implementación de Constant de Evaluate simplemente devuelve la constante

almacenada. Una VariableReference implementación de busca el nombre de la variable
en la tabla hash y devuelve el valor resultante. Una implementación de Operation evalúa
primero los operandos izquierdo y derecho (mediante la invocación recursiva de sus
métodos Evaluate ) y luego realiza la operación aritmética correspondiente.

El siguiente programa usa las clases Expression para evaluar la expresión x * (y + 2)

para los distintos valores de x y y .
 C#

using System;

using System.Collections;

class Test

static void Main() {

Expression e = new Operation(

new VariableReference("x"),

'*',

new Operation(

new VariableReference("y"),

'+',

new Constant(2)

);

Hashtable vars = new Hashtable();

vars["x"] = 3;

vars["y"] = 5;

Console.WriteLine(e.Evaluate(vars)); // Outputs "21"

vars["x"] = 1.5;

vars["y"] = 9;

Console.WriteLine(e.Evaluate(vars)); // Outputs "16.5"

Sobrecarga de métodos

El método *Overloading _ permite que varios métodos de la misma clase tengan el

mismo nombre siempre y cuando tengan firmas únicas. Al compilar una invocación de
un método sobrecargado, el compilador usa _ Overload Resolution* para determinar el
método específico que se va a invocar. La resolución de sobrecarga busca el método
que mejor coincida con los argumentos o informa de un error si no se puede encontrar
ninguna mejor coincidencia. En el ejemplo siguiente se muestra la resolución de
sobrecarga en vigor. El comentario para cada invocación del método Main muestra qué
método se invoca realmente.

C#

class Test

static void F() {

Console.WriteLine("F()");
}

static void F(object x) {

Console.WriteLine("F(object)");

 static void F(int x) {

Console.WriteLine("F(int)");

static void F(double x) {

Console.WriteLine("F(double)");

static void F<T>(T x) {

Console.WriteLine("F<T>(T)");

static void F(double x, double y) {

Console.WriteLine("F(double, double)");

static void Main() {

F(); // Invokes F()

F(1); // Invokes F(int)

F(1.0); // Invokes F(double)

F("abc"); // Invokes F(object)

F((double)1); // Invokes F(double)

F((object)1); // Invokes F(object)

F<int>(1); // Invokes F<T>(T)

F(1, 1); // Invokes F(double, double)

Tal como se muestra en el ejemplo, un método determinado siempre se puede

seleccionar mediante la conversión explícita de los argumentos en los tipos de
parámetros exactos o el suministro explícito de los argumentos de tipo.

Otros miembros de función

Los miembros que contienen código ejecutable se conocen colectivamente como
miembros de función de una clase. En la sección anterior se han descrito métodos, que
son el tipo principal de los miembros de función. En esta sección se describen los demás
tipos de miembros de función admitidos por C#: constructores, propiedades,
indexadores, eventos, operadores y destructores.

En el código siguiente se muestra una clase genérica denominada List<T> , que

implementa una lista de objetos que se va a ampliar. La clase contiene varios ejemplos
de los tipos más comunes de miembros de función.

C#

public class List<T> {

// Constant...

const int defaultCapacity = 4;

// Fields...

T[] items;

int count;

// Constructors...

public List(int capacity = defaultCapacity) {

items = new T[capacity];

// Properties...

public int Count {

get { return count; }

public int Capacity {

get {

return items.Length;

set {

if (value < count) value = count;

if (value != items.Length) {

T[] newItems = new T[value];

Array.Copy(items, 0, newItems, 0, count);

items = newItems;
}

// Indexer...

public T this[int index] {

get {

return items[index];

set {

items[index] = value;

OnChanged();

// Methods...

public void Add(T item) {

if (count == Capacity) Capacity = count * 2;

items[count] = item;

count++;

OnChanged();

protected virtual void OnChanged() {

if (Changed != null) Changed(this, EventArgs.Empty);

public override bool Equals(object other) {

return Equals(this, other as List<T>);

static bool Equals(List<T> a, List<T> b) {

if (a == null) return b == null;

 if (b == null || a.count != b.count) return false;

for (int i = 0; i < a.count; i++) {

if (!object.Equals(a.items[i], b.items[i])) {

return false;

return true;

// Event...

public event EventHandler Changed;

// Operators...

public static bool operator ==(List<T> a, List<T> b) {

return Equals(a, b);

public static bool operator !=(List<T> a, List<T> b) {

return !Equals(a, b);

Constructores
C# admite constructores de instancia y estáticos. Un *constructor de instancia _ es un
miembro que implementa las acciones necesarias para inicializar una instancia de una
clase. Un constructor _ static* es un miembro que implementa las acciones necesarias
para inicializar una clase en sí misma cuando se carga por primera vez.

Un constructor se declara como un método sin ningún tipo de valor devuelto y el

mismo nombre que la clase contenedora. Si una declaración de constructor incluye un
modificador static , declara un constructor estático. De lo contrario, declara un
constructor de instancia.

Los constructores de instancias se pueden sobrecargar. Por ejemplo, la clase List<T>

declara dos constructores de instancia, una sin parámetros y otra que toma un
parámetro int . Los constructores de instancia se invocan mediante el operador new . Las
instrucciones siguientes asignan dos List<string> instancias de mediante cada uno de
los constructores de la List clase.

C#

List<string> list1 = new List<string>();

List<string> list2 = new List<string>(10);

A diferencia de otros miembros, los constructores de instancia no se heredan y una

clase no tiene ningún constructor de instancia que no sea el que se declara realmente
en la clase. Si no se proporciona ningún constructor de instancia para una clase, se
proporciona automáticamente uno vacío sin ningún parámetro.

Propiedades

*Properties _ son una extensión natural de los campos. Ambos son miembros con
nombre con tipos asociados y la sintaxis para acceder a los campos y las propiedades es
la misma. Sin embargo, a diferencia de los campos, las propiedades no denotan
ubicaciones de almacenamiento. En su lugar, las propiedades tienen _ descriptores de
acceso* que especifican las instrucciones que se ejecutarán cuando se lean o escriban
sus valores.

Una propiedad se declara como un campo, salvo que la declaración finaliza con un get
descriptor de acceso o un set descriptor de acceso escrito entre los delimitadores { y
en } lugar de terminar en un punto y coma. Una propiedad que tiene tanto un
descriptor de acceso get como un set descriptor de acceso es una propiedad * de
lectura y escritura , una propiedad que solo tiene un get descriptor de acceso es una
propiedad de solo lectura y una propiedad que solo tiene un set descriptor de acceso es
una propiedad de solo escritura* *.

Un get descriptor de acceso corresponde a un método sin parámetros con un valor

devuelto del tipo de propiedad. Excepto como destino de una asignación, cuando se
hace referencia a una propiedad en una expresión, el get descriptor de acceso de la
propiedad se invoca para calcular el valor de la propiedad.

Un set descriptor de acceso corresponde a un método con un solo parámetro

denominado value y ningún tipo de valor devuelto. Cuando se hace referencia a una
propiedad como el destino de una asignación o como el operando de ++ o -- , el set
descriptor de acceso se invoca con un argumento que proporciona el nuevo valor.

La clase List<T> declara dos propiedades, Count y Capacity , que son de solo lectura y
de lectura y escritura, respectivamente. El siguiente es un ejemplo de uso de estas
propiedades.

C#

List<string> names = new List<string>();

names.Capacity = 100; // Invokes set accessor

int i = names.Count; // Invokes get accessor

int j = names.Capacity; // Invokes get accessor

De forma similar a los campos y métodos, C# admite propiedades de instancia y

propiedades estáticas. Las propiedades estáticas se declaran con el static modificador
y las propiedades de instancia se declaran sin ella.

Los descriptores de acceso de una propiedad pueden ser virtuales. Cuando una
declaración de propiedad incluye un modificador virtual , abstract o override , se
aplica a los descriptores de acceso de la propiedad.

Indexadores
Un indexador es un miembro que permite indexar de la misma manera que una matriz.
Un indexador se declara como una propiedad, excepto por el hecho que el nombre del
miembro es this , seguido por una lista de parámetros que se escriben entre los
delimitadores [ y ] . Los parámetros están disponibles en los descriptores de acceso del
indexador. De forma similar a las propiedades, los indexadores pueden ser lectura y
escritura, de solo lectura y de solo escritura, y los descriptores de acceso de un
indexador pueden ser virtuales.

La clase List declara un único indexador de lectura y escritura que toma un parámetro
int . El indexador permite indexar instancias de List con valores int . Por ejemplo

C#

List<string> names = new List<string>();

names.Add("Liz");

names.Add("Martha");

names.Add("Beth");

for (int i = 0; i < names.Count; i++) {

string s = names[i];

names[i] = s.ToUpper();

Los indexadores se pueden sobrecargar, lo que significa que una clase puede declarar
varios indexadores siempre y cuando el número o los tipos de sus parámetros sean
diferentes.

Eventos
Un evento es un miembro que permite que una clase u objeto proporcionen
notificaciones. Un evento se declara como un campo, excepto por el hecho de que la
declaración incluye una palabra clave event , y el tipo debe ser un tipo delegado.
Dentro de una clase que declara un miembro de evento, el evento se comporta como
un campo de un tipo delegado (siempre que el evento no sea abstracto y no declare
descriptores de acceso). El campo almacena una referencia a un delegado que
representa los controladores de eventos que se han agregado al evento. Si no hay
ningún controlador de eventos presente, el campo es null .

La clase List<T> declara un único miembro de evento llamado Changed , lo que indica
que se ha agregado un nuevo elemento a la lista. El Changed evento lo desencadena el
OnChanged método virtual, que primero comprueba si el evento es null (lo que significa

que no hay ningún controlador presente). La noción de generar un evento es

equivalente exactamente a invocar el delegado representado por el evento; por lo tanto,
no hay ninguna construcción especial de lenguaje para generar eventos.

Los clientes reaccionan a los eventos mediante controladores de eventos. Los

controladores de eventos se asocian mediante el operador += y se quitan con el
operador -= . En el ejemplo siguiente se asocia un controlador de eventos con el evento
Changed de un objeto List<string> .

C#

using System;

class Test

static int changeCount;

static void ListChanged(object sender, EventArgs e) {

changeCount++;

static void Main() {

List<string> names = new List<string>();

names.Changed += new EventHandler(ListChanged);

names.Add("Liz");

names.Add("Martha");

names.Add("Beth");

Console.WriteLine(changeCount); // Outputs "3"

Para escenarios avanzados donde se desea controlar el almacenamiento subyacente de

un evento, una declaración de evento puede proporcionar explícitamente los
descriptores de acceso add y remove , que son similares en cierto modo al descriptor de
acceso set de una propiedad.
Operadores
Un operador es un miembro que define el significado de aplicar un operador de
expresión determinado a las instancias de una clase. Se pueden definir tres tipos de
operadores: operadores unarios, operadores binarios y operadores de conversión. Todos
los operadores se deben declarar como public y static .

La clase List<T> declara dos operadores, operator== y operator!= , y de este modo

proporciona un nuevo significado a expresiones que aplican esos operadores a
instancias List . En concreto, los operadores definen la igualdad de dos instancias
List<T> como la comparación de cada uno de los objetos contenidos con sus métodos
Equals . En el ejemplo siguiente se usa el operador == para comparar dos instancias

List<int> .

C#

using System;

class Test

static void Main() {

List<int> a = new List<int>();

a.Add(1);

a.Add(2);

List<int> b = new List<int>();

b.Add(1);

b.Add(2);

Console.WriteLine(a == b); // Outputs "True"

b.Add(3);

Console.WriteLine(a == b); // Outputs "False"

El primer objeto Console.WriteLine genera True porque las dos listas contienen el
mismo número de objetos con los mismos valores en el mismo orden. Si List<T> no
hubiera definido operator== , el primer objeto Console.WriteLine habría generado
False porque a y b hacen referencia a diferentes instancias de List<int> .

Destructores
Un destructor es un miembro que implementa las acciones necesarias para destruir una
instancia de una clase. Los destructores no pueden tener parámetros, no pueden tener
modificadores de accesibilidad y no se pueden invocar explícitamente. El destructor de
una instancia se invoca automáticamente durante la recolección de elementos no
utilizados.
El recolector de elementos no utilizados tiene una latitud ancha a la hora de decidir
cuándo recopilar objetos y ejecutar destructores. En concreto, el tiempo de las
invocaciones de destructor no es determinista y los destructores se pueden ejecutar en
cualquier subproceso. Por estas y otras razones, las clases deben implementar
destructores solo cuando no sean factibles otras soluciones.

La instrucción using proporciona un mejor enfoque para la destrucción de objetos.

Estructuras
Al igual que las clases, los structs son estructuras de datos que pueden contener
miembros de datos y miembros de función, pero a diferencia de las clases, los structs
son tipos de valor y no requieren asignación del montón. Una variable de un tipo de
struct almacena directamente los datos del struct, mientras que una variable de un tipo
de clase almacena una referencia a un objeto asignado dinámicamente. Los tipos struct
no admiten la herencia especificada por el usuario y todos los tipos de struct se heredan
implícitamente del tipo object .

Los structs son particularmente útiles para estructuras de datos pequeñas que tengan
semánticas de valor. Los números complejos, los puntos de un sistema de coordenadas
o los pares clave-valor de un diccionario son buenos ejemplos de structs. El uso de un
struct en lugar de una clase para estructuras de datos pequeñas puede suponer una
diferencia sustancial en el número de asignaciones de memoria que realiza una
aplicación. Por ejemplo, el siguiente programa crea e inicializa una matriz de 100
puntos. Si Point se implementa como una clase, se crean instancias de 101 objetos
distintos: uno para la matriz y uno por cada uno de los 100 elementos.

C#

class Point

public int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

class Test

static void Main() {

Point[] points = new Point[100];

for (int i = 0; i < 100; i++) points[i] = new Point(i, i);

Una alternativa es crear Point un struct.

C#

struct Point

public int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

Ahora, se crea la instancia de un solo objeto: la de la matriz, y las instancias de Point se

asignan en línea dentro de la matriz.

Los structs se invocan con el operador new , pero eso no implica que se asigne memoria.
En lugar de asignar dinámicamente un objeto y devolver una referencia a él, un
constructor de structs simplemente devuelve el valor del struct propiamente dicho
(normalmente en una ubicación temporal en la pila) y este valor se copia luego cuando
es necesario.

Con las clases, es posible que dos variables hagan referencia al mismo objeto y, que por
tanto, las operaciones en una variable afecten al objeto al que hace referencia la otra
variable. Con los struct, cada variable tiene su propia copia de los datos y no es posible
que las operaciones en una afecten a la otra. Por ejemplo, la salida generada por el
fragmento de código siguiente depende de si Point es una clase o un struct.

C#

Point a = new Point(10, 10);

Point b = a;

a.x = 20;

Console.WriteLine(b.x);

Si Point es una clase, el resultado es 20 porque a y b hacen referencia al mismo

objeto. Si Point es un struct, el resultado es 10 porque la asignación de a a b crea una
copia del valor, y esta copia no se ve afectada por la asignación subsiguiente a a.x .

En el ejemplo anterior se resaltan dos de las limitaciones de los structs. En primer lugar,
copiar un struct entero normalmente es menos eficaz que copiar una referencia a un
objeto, por lo que el paso de parámetros de asignación y valor puede ser más costoso
con structs que con tipos de referencia. En segundo lugar, a excepción de los
parámetros ref y out , no es posible crear referencias a structs, que excluyen su uso en
varias situaciones.

Matrices
*Array _ es una estructura de datos que contiene un número de variables a las que se
tiene acceso a través de índices calculados. Las variables contenidas en una matriz,
también denominadas elementos de la matriz, son todas del mismo tipo y este tipo se
denomina el tipo de elemento _ * de la matriz.

Los tipos de matriz son tipos de referencia, y la declaración de una variable de matriz
simplemente establece un espacio reservado para una referencia a una instancia de
matriz. Las instancias de matriz reales se crean dinámicamente en tiempo de ejecución
mediante el new operador. La operación new especifica la longitud de la nueva instancia
de matriz, que luego se fija para la vigencia de la instancia. Los índices de los elementos
de una matriz van de 0 a Length - 1 . El operador new inicializa automáticamente los
elementos de una matriz a su valor predeterminado, que, por ejemplo, es cero para
todos los tipos numéricos y null para todos los tipos de referencias.

En el ejemplo siguiente se crea una matriz de elementos int , se inicializa la matriz y se

imprime el contenido de la matriz.

C#

using System;

class Test

static void Main() {

int[] a = new int[10];

for (int i = 0; i < a.Length; i++) {

a[i] = i * i;

for (int i = 0; i < a.Length; i++) {

Console.WriteLine("a[{0}] = {1}", i, a[i]);

En este ejemplo se crea y funciona en una *matriz unidimensional _. C# también admite

matrices multidimensionales. El número de dimensiones de un tipo de matriz, también
conocido como el _ rango* del tipo de matriz, es uno más el número de comas escritas
entre los corchetes del tipo de matriz. En el ejemplo siguiente se asigna una matriz
unidimensional, bidimensional y de tres dimensiones.
 C#

int[] a1 = new int[10];

int[,] a2 = new int[10, 5];

int[,,] a3 = new int[10, 5, 2];

La matriz a1 contiene 10 elementos, la matriz a2 50 (10 × 5) elementos y la matriz a3

100 (10 × 5 × 2) elementos.

El tipo de elemento de una matriz puede ser cualquiera, incluido un tipo de matriz. Una
matriz con elementos de un tipo de matriz a veces se conoce como matriz escalonada
porque las longitudes de las matrices de elementos no tienen que ser iguales. En el
ejemplo siguiente se asigna una matriz de matrices de int :

C#

int[][] a = new int[3][];

a[0] = new int[10];

a[1] = new int[5];

a[2] = new int[20];

La primera línea crea una matriz con tres elementos, cada uno de tipo int[] y cada uno
con un valor inicial de null . Las líneas posteriores inicializan entonces los tres
elementos con referencias a instancias de matriz individuales de longitud variable.

El operador new permite especificar los valores iniciales de los elementos de matriz
mediante un inicializador de matriz, que es una lista de las expresiones escritas entre
los delimitadores { y } . En el ejemplo siguiente se asigna e inicializa un tipo int[] con
tres elementos.

C#

int[] a = new int[] {1, 2, 3};

Tenga en cuenta que la longitud de la matriz se deduce del número de expresiones

entre { y } . Las declaraciones de variable local y campo se pueden acortar más para
que así no sea necesario reformular el tipo de matriz.

C#

int[] a = {1, 2, 3};

Los dos ejemplos anteriores son equivalentes a lo siguiente:

 C#

int[] t = new int[3];

t[0] = 1;

t[1] = 2;

t[2] = 3;

int[] a = t;

Interfaces
Una interfaz define un contrato que se puede implementar mediante clases y structs.
Una interfaz puede contener métodos, propiedades, eventos e indexadores. Una interfaz
no proporciona implementaciones de los miembros que define, simplemente especifica
los miembros que se deben proporcionar mediante clases o structs que implementan la
interfaz.

Las interfaces pueden usar herencia múltiple. En el ejemplo siguiente, la interfaz

IComboBox hereda de ITextBox y IListBox .

C#

interface IControl

void Paint();

interface ITextBox: IControl

void SetText(string text);

interface IListBox: IControl

void SetItems(string[] items);

interface IComboBox: ITextBox, IListBox {}

Las clases y los structs pueden implementar varias interfaces. En el ejemplo siguiente, la
clase EditBox implementa IControl y IDataBound .

C#

interface IDataBound

void Bind(Binder b);

 public class EditBox: IControl, IDataBound

public void Paint() {...}

public void Bind(Binder b) {...}

Cuando una clase o un struct implementan una interfaz determinada, las instancias de
esa clase o struct se pueden convertir implícitamente a ese tipo de interfaz. Por ejemplo

C#

EditBox editBox = new EditBox();

IControl control = editBox;

IDataBound dataBound = editBox;

En casos donde una instancia no se conoce estáticamente para implementar una

interfaz determinada, se pueden usar conversiones de tipo dinámico. Por ejemplo, las
siguientes instrucciones usan conversiones de tipo dinámico para obtener las
implementaciones de un objeto y de la IControl IDataBound interfaz. Dado que el tipo
real del objeto es EditBox , las conversiones se realizan correctamente.

C#

object obj = new EditBox();

IControl control = (IControl)obj;

IDataBound dataBound = (IDataBound)obj;

En la EditBox clase anterior, el Paint método de la IControl interfaz y el Bind método

de la IDataBound interfaz se implementan mediante public miembros. C# también
admite implementaciones explícitas de miembros de interfaz, con las que la clase o el
struct pueden evitar la creación de miembros public . Una implementación de miembro
de interfaz explícito se escribe con el nombre de miembro de interfaz completo. Por
ejemplo, la clase EditBox podría implementar los métodos IControl.Paint y
IDataBound.Bind mediante implementaciones de miembros de interfaz explícitos del
modo siguiente.

C#

public class EditBox: IControl, IDataBound

void IControl.Paint() {...}

void IDataBound.Bind(Binder b) {...}

Solo se puede acceder a los miembros de interfaz explícitos mediante el tipo de interfaz.
Por ejemplo, la implementación de IControl.Paint proporcionada por la EditBox clase
anterior solo se puede invocar convirtiendo primero la EditBox referencia al IControl
tipo de interfaz.

C#

EditBox editBox = new EditBox();

editBox.Paint(); // Error, no such method

IControl control = editBox;

control.Paint(); // Ok

Enumeraciones
Un tipo de enumeración es un tipo de valor distinto con un conjunto de constantes con
nombre. En el ejemplo siguiente se declara y se utiliza un tipo de enumeración
denominado Color con tres valores constantes,, Red Green y Blue .

C#

using System;

enum Color

Red,

Green,

Blue

class Test

static void PrintColor(Color color) {

switch (color) {

case Color.Red:

Console.WriteLine("Red");

break;

case Color.Green:

Console.WriteLine("Green");

break;

case Color.Blue:

Console.WriteLine("Blue");

break;

default:

Console.WriteLine("Unknown color");

break;

static void Main() {

 Color c = Color.Red;

PrintColor(c);

PrintColor(Color.Blue);

Cada tipo de enumeración tiene un tipo entero correspondiente denominado el tipo

subyacente del tipo de enumeración. Un tipo de enumeración que no declara
explícitamente un tipo subyacente tiene un tipo subyacente de int . El formato de
almacenamiento y el intervalo de valores posibles de un tipo enum vienen
determinados por su tipo subyacente. El conjunto de valores que puede tomar un tipo
de enumeración no está limitado por sus miembros de enumeración. En concreto,
cualquier valor del tipo subyacente de una enumeración se puede convertir al tipo de
enumeración y es un valor válido distinto de ese tipo de enumeración.

En el ejemplo siguiente se declara un tipo de enumeración denominado Alignment con

un tipo subyacente de sbyte .

C#

enum Alignment: sbyte

Left = -1,

Center = 0,

Right = 1

Como se muestra en el ejemplo anterior, una declaración de miembro de enumeración

puede incluir una expresión constante que especifique el valor del miembro. El valor
constante para cada miembro de la enumeración debe estar en el intervalo del tipo
subyacente de la enumeración. Cuando una declaración de miembro de enumeración
no especifica explícitamente un valor, el miembro recibe el valor cero (si es el primer
miembro del tipo de enumeración) o el valor del miembro de enumeración anterior
textual más uno.

Los valores de enumeración se pueden convertir en valores enteros y viceversa

mediante conversiones de tipos. Por ejemplo

C#

int i = (int)Color.Blue; // int i = 2;

Color c = (Color)2; // Color c = Color.Blue;

El valor predeterminado de cualquier tipo de enumeración es el valor entero cero

convertido al tipo de enumeración. En los casos en los que las variables se inicializan
automáticamente en un valor predeterminado, este es el valor dado a las variables de
los tipos de enumeración. Para que el valor predeterminado de un tipo de enumeración
sea fácilmente disponible, el literal se 0 convierte implícitamente a cualquier tipo de
enumeración. Por tanto, el siguiente código es válido.

C#

Color c = 0;

Delegados
Un tipo de delegado representa las referencias a métodos con una lista de parámetros
determinada y un tipo de valor devuelto. Los delegados permiten tratar métodos como
entidades que se puedan asignar a variables y se puedan pasar como parámetros. Los
delegados son similares al concepto de punteros de función en otros lenguajes, pero a
diferencia de los punteros de función, los delegados están orientados a objetos y
presentan seguridad de tipos.

En el siguiente ejemplo se declara y usa un tipo de delegado denominado Function .

C#

using System;

delegate double Function(double x);

class Multiplier

double factor;

public Multiplier(double factor) {

this.factor = factor;

public double Multiply(double x) {

return x * factor;

class Test

static double Square(double x) {

return x * x;

 static double[] Apply(double[] a, Function f) {

double[] result = new double[a.Length];

for (int i = 0; i < a.Length; i++) result[i] = f(a[i]);

return result;

static void Main() {

double[] a = {0.0, 0.5, 1.0};

double[] squares = Apply(a, Square);

double[] sines = Apply(a, Math.Sin);

Multiplier m = new Multiplier(2.0);

double[] doubles = Apply(a, m.Multiply);

Una instancia del tipo de delegado Function puede hacer referencia a cualquier método
que tome un argumento double y devuelva un valor double . El método Apply aplica un
elemento Function determinado a los elementos de double[] y devuelve double[] con
los resultados. En el método Main , Apply se usa para aplicar tres funciones diferentes a
un valor double[] .

Un delegado puede hacer referencia a un método estático (como Square o Math.Sin en

el ejemplo anterior) o un método de instancia (como m.Multiply en el ejemplo
anterior). Un delegado que hace referencia a un método de instancia también hace
referencia a un objeto determinado y, cuando se invoca el método de instancia a través
del delegado, ese objeto se convierte en this en la invocación.

Los delegados también pueden crearse mediante funciones anónimas, que son
"métodos insertados" que se crean sobre la marcha. Las funciones anónimas pueden ver
las variables locales de los métodos adyacentes. Por lo tanto, el ejemplo de
multiplicador anterior se puede escribir más fácilmente sin usar una Multiplier clase:

C#

double[] doubles = Apply(a, (double x) => x * 2.0);

Una propiedad interesante y útil de un delegado es que no sabe ni necesita conocer la

clase del método al que hace referencia; lo único que importa es que el método al que
se hace referencia tenga los mismos parámetros y el tipo de valor devuelto que el
delegado.

Atributos
Los tipos, los miembros y otras entidades en un programa de C # admiten
modificadores que controlan ciertos aspectos de su comportamiento. Por ejemplo, la
accesibilidad de un método se controla mediante los modificadores public , protected ,
internal y private . C # generaliza esta funcionalidad de manera que los tipos de
información declarativa definidos por el usuario se puedan adjuntar a las entidades del
programa y recuperarse en tiempo de ejecución. Los programas especifican esta
información declarativa adicional mediante la definición y el uso de atributos.

En el ejemplo siguiente se declara un atributo HelpAttribute que se puede colocar en

entidades de programa para proporcionar vínculos a la documentación asociada.

C#

using System;

public class HelpAttribute: Attribute

string url;

string topic;

public HelpAttribute(string url) {

this.url = url;

public string Url {

get { return url; }

public string Topic {

get { return topic; }

set { topic = value; }

Todas las clases de atributo derivan de la System.Attribute clase base proporcionada

por el .NET Framework. Los atributos se pueden aplicar proporcionando su nombre,
junto con cualquier argumento, entre corchetes, justo antes de la declaración asociada.
Si el nombre de un atributo termina en Attribute , esa parte del nombre se puede
omitir cuando se hace referencia al atributo. Por ejemplo, el atributo HelpAttribute se
puede usar de la manera siguiente.

C#

[Help("http://msdn.microsoft.com/.../MyClass.htm")]

public class Widget

[Help("http://msdn.microsoft.com/.../MyClass.htm", Topic = "Display")]

 public void Display(string text) {}

En este ejemplo se adjunta un HelpAttribute a la Widget clase y otro HelpAttribute al

Display método en la clase. Los constructores públicos de una clase de atributos
controlan la información que se debe proporcionar cuando el atributo se adjunta a una
entidad de programa. Se puede proporcionar información adicional haciendo referencia
a las propiedades públicas de lectura y escritura de la clase de atributos (como la
referencia a la propiedad Topic usada anteriormente).

En el ejemplo siguiente se muestra cómo se puede recuperar la información de

atributos de una entidad de programa determinada en tiempo de ejecución mediante la
reflexión.

C#

using System;

using System.Reflection;

class Test

static void ShowHelp(MemberInfo member) {

HelpAttribute a = Attribute.GetCustomAttribute(member,

typeof(HelpAttribute)) as HelpAttribute;

if (a == null) {

Console.WriteLine("No help for {0}", member);

else {

Console.WriteLine("Help for {0}:", member);

Console.WriteLine(" Url={0}, Topic={1}", a.Url, a.Topic);

static void Main() {

ShowHelp(typeof(Widget));

ShowHelp(typeof(Widget).GetMethod("Display"));

Cuando se solicita un atributo determinado mediante reflexión, se invoca al constructor

de la clase de atributos con la información proporcionada en el origen del programa y
se devuelve la instancia de atributo resultante. Si se proporciona información adicional
mediante propiedades, dichas propiedades se establecen en los valores dados antes de
devolver la instancia del atributo.
1 Scope
Artículo • 13/01/2022 • Tiempo de lectura: 2 minutos

This specification describes the form and establishes the interpretation of programs
written in the C# programming language. It describes

The representation of C# programs;

The syntax and constraints of the C# language;
The semantic rules for interpreting C# programs;
The restrictions and limits imposed by a conforming implementation of C#.

This specification does not describe

The mechanism by which C# programs are transformed for use by a data-

processing system;
The mechanism by which C# applications are invoked for use by a data-processing
system;
The mechanism by which input data are transformed for use by a C# application;
The mechanism by which output data are transformed after being produced by a
C# application;
The size or complexity of a program and its data that will exceed the capacity of
any specific data-processing system or the capacity of a particular processor;
All minimal requirements of a data-processing system that is capable of
supporting a conforming implementation.
2 Normative references
Artículo • 18/03/2022 • Tiempo de lectura: 2 minutos

The following normative documents contain provisions, which, through reference in this
text, constitute provisions of this specification. For dated references, subsequent
amendments to, or revisions of, any of these publications do not apply. However, parties
to agreements based on this specification are encouraged to investigate the possibility
of applying the most recent editions of the normative documents indicated below. For
undated references, the latest edition of the normative document referred to applies.
Members of ISO and IEC maintain registers of currently valid specifications.

ISO/IEC 23271:2012, Common Language Infrastructure (CLI), Partition IV: Base Class

Library (BCL), Extended Numerics Library, and Extended Array Library.

ISO 80000-2, Quantities and units — Part 2: Mathematical signs and symbols to be used
in the natural sciences and technology.

ISO/IEC 2382, Information technology — Vocabulary.

ISO/IEC 60559:2020, Information technology — Microprocessor Systems — Floating-Point

arithmetic

The Unicode Consortium. The Unicode Standard,

https://www.unicode.org/standard/standard.html
3 Terms and definitions
Artículo • 14/06/2022 • Tiempo de lectura: 2 minutos

For the purposes of this specification, the following definitions apply. Other terms are
defined where they appear in italic type or on the left side of a syntax rule. Terms
explicitly defined in this specification are not to be presumed to refer implicitly to similar
terms defined elsewhere. Terms not defined in this specification are to be interpreted
according to ISO/IEC 2382.1. Mathematical symbols not defined in this specification are
to be interpreted according to ISO 80000-2.

application
assembly with an entry point
application domain
entity that enables application isolation by acting as a container for application
state
argument
expression in the comma-separated list bounded by the parentheses in a
method or instance constructor call expression or bounded by the square
brackets in an element access expression
assembly
one or more files output by the compiler as a result of program compilation
behavior
external appearance or action
behavior, implementation-defined
unspecified behavior where each implementation documents how the choice is
made
behavior, undefined
behavior, upon use of a non-portable or erroneous construct or of erroneous
data, for which this specification imposes no requirements
behavior, unspecified
behavior where this specification provides two or more possibilities and
imposes no further requirements on which is chosen in any instance
character (when used without a qualifier)
In the context of a non-Unicode encoding, the meaning of character in that
encoding; or
In the context of a character literal or a value of type char, a Unicode code point
in the range U+0000 to U+FFFF (including surrogate code points), that is a UTF-
16 code unit; or
Otherwise, a Unicode code point
class library
 assembly that can be used by other assemblies
compilation unit
ordered sequence of Unicode characters that is input to a compiler
diagnostic message
message belonging to an implementation-defined subset of the
implementation’s output messages
error, compile-time
error reported during program translation
exception
exceptional condition reported during program execution
implementation
particular set of software (running in a particular translation environment under
particular control options) that performs translation of programs for, and
supports execution of methods in, a particular execution environment
module
the contents of an assembly produced by a compiler. Some implementations
may have facilities to produce assemblies that contain more than one module.
The behavior in such situations is outside the scope of this specification
namespace
logical organizational system grouping related program elements
parameter
variable declared as part of a method, instance constructor, operator, or indexer
definition, which acquires a value on entry to that function member
program
one or more compilation units that are presented to the compiler and are run or
executed by an execution environment
unsafe code
code that is permitted to perform such lower-level operations as declaring and
operating on pointers, performing conversions between pointers and integral
types, and taking the address of variables
warning, compile-time
informational message reported during program translation, which is intended
to identify a potentially questionable usage of a program element
4 General description
Artículo • 08/04/2022 • Tiempo de lectura: 2 minutos

This text is informative.

This specification is intended to be used by implementers, academics, and application

programmers. As such, it contains a considerable amount of explanatory material that,
strictly speaking, is not necessary in a formal language specification.

This standard is divided into the following subdivisions: front matter; language syntax,
constraints, and semantics; and annexes.

Examples are provided to illustrate possible forms of the constructions described.

References are used to refer to related clauses. Notes are provided to give advice or
guidance to implementers or programmers. Annexes provide additional information and
summarize the information contained in this specification.

End of informative text.

Informative text is indicated in the following ways:

1. Whole or partial clauses or annexes delimited by “This clause/text is informative”

and “End of informative text”.
2. Example: The following example … code fragment, possibly with some narrative …
end example The Example: and end example markers are in the same paragraph for
single paragraph examples. If an example spans multiple paragraphs, the end
example marker should be its own paragraph.
3. Note: narrative … end note The Note: and end note markers are in the same
paragraph for single paragraph notes. If a note spans multiple paragraphs, the end
note marker should be its own paragraph.

All text not marked as being informative is normative.

5 Conformance
Artículo • 18/03/2022 • Tiempo de lectura: 2 minutos

Conformance is of interest to the following audiences:

Those designing, implementing, or maintaining C# implementations.

Governmental or commercial entities wishing to procure C# implementations.
Testing organizations wishing to provide a C# conformance test suite.
Programmers wishing to port code from one C# implementation to another.
Educators wishing to teach Standard C#.
Authors wanting to write about Standard C#.

As such, conformance is most important, and the bulk of this specification is aimed at
specifying the characteristics that make C# implementations and C# programs
conforming ones.

The text in this specification that specifies requirements is considered normative. All
other text in this specification is informative; that is, for information purposes only.
Unless stated otherwise, all text is normative. Normative text is further broken into
required and conditional categories. Conditionally normative text specifies a feature
and its requirements where the feature is optional. However, if that feature is provided,
its syntax and semantics shall be exactly as specified.

Undefined behavior is indicated in this specification only by the words ‘undefined

behavior.’

A strictly conforming program shall use only those features of the language specified in
this specification as being required. (This means that a strictly conforming program
cannot use any conditionally normative feature.) It shall not produce output dependent
on any unspecified, undefined, or implementation-defined behavior.

A conforming implementation of C# shall accept any strictly conforming program.

A conforming implementation of C# shall provide and support all the types, values,
objects, properties, methods, and program syntax and semantics described in the
normative (but not the conditionally normative) parts in this specification.

A conforming implementation of C# shall interpret characters in conformance with the

Unicode Standard. Conforming implementations shall accept compilation units encoded
with the UTF-8 encoding form.

A conforming implementation of C# shall not successfully translate source containing a

#error preprocessing directive unless it is part of a group skipped by conditional
compilation.

A conforming implementation of C# shall produce at least one diagnostic message if

the source program violates any rule of syntax, or any negative requirement (defined as
a “shall” or “shall not” or “error” or “warning” requirement), unless that requirement is
marked with the words “no diagnostic is required”.

A conforming implementation of C# is permitted to provide additional types, values,

objects, properties, and methods beyond those described in this specification, provided
they do not alter the behavior of any strictly conforming program. Conforming
implementations are required to diagnose programs that use extensions that are ill
formed according to this specification. Having done so, however, they can compile and
execute such programs. (The ability to have extensions implies that a conforming
implementation reserves no identifiers other than those explicitly reserved in this
specification.)

A conforming implementation of C# shall be accompanied by a document that defines

all implementation-defined characteristics, and all extensions.

A conforming implementation of C# shall support the class library documented in Annex

C. This library is included by reference in this specification.

A conforming program is one that is acceptable to a conforming implementation. (Such

a program is permitted to contain extensions or conditionally normative features.)
Estructura léxica
Artículo • 16/09/2021 • Tiempo de lectura: 31 minutos

Programas
Un programa de C# * _ consta de uno o varios archivos de código fuente, conocido
formalmente como unidades de compilación* (unidades de compilación). Un archivo de
origen es una secuencia ordenada de caracteres Unicode. Los archivos de origen suelen
tener una correspondencia uno a uno con los archivos de un sistema de archivos, pero
esta correspondencia no es necesaria. Para obtener la máxima portabilidad, se
recomienda codificar los archivos de un sistema de archivos con la codificación UTF-8.

En términos conceptuales, un programa se compila mediante tres pasos:

1. Transformación, que convierte un archivo de un repertorio de caracteres

determinado y un esquema de codificación en una secuencia de caracteres
Unicode.
2. Análisis léxico, que convierte una secuencia de caracteres de entrada Unicode en
una secuencia de tokens.
3. Análisis sintáctico, que convierte el flujo de tokens en código ejecutable.

Gramáticas
Esta especificación presenta la sintaxis del lenguaje de programación C# con dos
gramáticas. La gramática léxica _ (gramática léxica) define cómo se combinan los
caracteres Unicode para formar terminadores de línea, espacios en blanco, comentarios,
tokens y directivas de procesamiento previo. La _ gramática sintáctica* (gramática
sintáctica) define el modo en que los tokens resultantes de la gramática léxica se
combinan para formar programas de C#.

Notación gramatical
Las gramáticas léxicas y sintácticas se presentan en Backus-Naur formulario mediante la
notación de la herramienta de gramática ANTLR.

Gramática léxica
La gramática léxica de C# se presenta en el análisis léxico, los tokensy las directivas de
procesamiento previo. Los símbolos de terminal de la gramática léxica son los caracteres
del juego de caracteres Unicode y la gramática léxica especifica cómo se combinan los
caracteres para formar tokens (tokens), espacios en blanco (espacio en blanco),
comentarios (comentarios) y directivas de preprocesamiento (directivas de
procesamiento previo).

Cada archivo de código fuente de un programa de C# debe ajustarse a la producción de

entrada de la gramática léxica (análisis léxico).

Gramática sintáctica
La gramática sintáctica de C# se presenta en los capítulos y los apéndices que siguen
este capítulo. Los símbolos de terminal de la gramática sintáctica son los tokens
definidos por la gramática léxica y la gramática sintáctica especifica cómo se combinan
los tokens para formar programas de C#.

Cada archivo de código fuente de un programa de C# debe ajustarse a la

compilation_unit producción de la gramática sintáctica (unidades de compilación).

Análisis léxico
La producción de entrada define la estructura léxica de un archivo de código fuente de
C#. Cada archivo de código fuente de un programa de C# debe ajustarse a esta
producción de gramática léxica.

antlr

input

: input_section?

input_section

: input_section_part+

input_section_part

: input_element* new_line

| pp_directive

input_element

: whitespace

| comment

| token

Cinco elementos básicos componen la estructura léxica de un archivo de código fuente

de C#: terminadores de línea (terminadores de línea), espacios en blanco (espacios en
blanco), comentarios (comentarios), tokens (tokens) y directivas de preprocesamiento
(directivas de procesamiento previo). De estos elementos básicos, solo los tokens son
significativos en la gramática sintáctica de un programa de C# (gramática sintáctica).

El procesamiento léxico de un archivo de código fuente de C# consiste en reducir el

archivo en una secuencia de tokens que se convierte en la entrada del análisis sintáctico.
Los terminadores de línea, los espacios en blanco y los comentarios pueden servir para
separar los tokens y las directivas de procesamiento previo pueden provocar que se
omitan las secciones del archivo de código fuente, pero, de lo contrario, estos
elementos léxicos no tienen ningún impacto en la estructura sintáctica de un programa
de C#.

En el caso de los literales de cadena interpolados (literales de cadena interpolados), un

único token lo genera inicialmente el análisis léxico, pero se divide en varios elementos
de entrada que se someten repetidamente al análisis léxico hasta que todos los literales
de cadena interpolados se han resuelto. Los tokens resultantes sirven como entrada
para el análisis sintáctico.

Cuando varias producciones de gramática léxica coinciden con una secuencia de

caracteres de un archivo de código fuente, el procesamiento léxico siempre forma el
elemento léxico más largo posible. Por ejemplo, la secuencia de caracteres // se
procesa como el principio de un Comentario de una sola línea porque ese elemento
léxico es más largo que un / token único.

Terminadores de línea
Los terminadores de línea dividen los caracteres de un archivo de código fuente de C#
en líneas.

antlr

new_line

: '<Carriage return character (U+000D)>'

| '<Line feed character (U+000A)>'

| '<Carriage return character (U+000D) followed by line feed character

(U+000A)>'

| '<Next line character (U+0085)>'

| '<Line separator character (U+2028)>'

| '<Paragraph separator character (U+2029)>'

Por compatibilidad con las herramientas de edición de código fuente que agregan
marcadores de fin de archivo y para permitir que un archivo de código fuente se vea
como una secuencia de líneas terminadas correctamente, se aplican las
transformaciones siguientes, en orden, a cada archivo de código fuente de un programa
de C#:

Si el último carácter del archivo de código fuente es un carácter control-Z ( U+001A

), este carácter se elimina.
Un carácter de retorno de carro ( U+000D ) se agrega al final del archivo de código
fuente si ese archivo de código fuente no está vacío y si el último carácter del
archivo de código fuente no es un retorno de carro () U+000D , un salto de línea (
U+000A ), un separador de líneas ( U+2028 ) o un separador de párrafo ( U+2029 ).

Comentarios
Se admiten dos formatos de comentarios: de una sola línea y delimitados.\ Comentarios
de una sola línea: empiece con los caracteres // y amplíe hasta el final de la línea de
código fuente. Los _comentarios delimitados_ comienzan con los caracteres /_ y
terminan con los caracteres */ . Los comentarios delimitados pueden abarcar varias
líneas.

antlr

comment

: single_line_comment

| delimited_comment

single_line_comment

: '//' input_character*

input_character

: '<Any Unicode character except a new_line_character>'

new_line_character

: '<Carriage return character (U+000D)>'

| '<Line feed character (U+000A)>'

| '<Next line character (U+0085)>'

| '<Line separator character (U+2028)>'

| '<Paragraph separator character (U+2029)>'

delimited_comment

: '/*' delimited_comment_section* asterisk+ '/'

 delimited_comment_section

: '/'

| asterisk* not_slash_or_asterisk

asterisk

: '*'

not_slash_or_asterisk

: '<Any Unicode character except / or *>'

Los comentarios no se anidan. Las secuencias de caracteres /* y */ no tienen ningún

significado especial dentro de un // Comentario y las secuencias de caracteres // y /*
no tienen ningún significado especial dentro de un comentario delimitado.

Los comentarios no se procesan dentro de los literales de carácter y de cadena.

En el ejemplo

C#

/* Hello, world program

This program writes "hello, world" to the console

*/

class Hello

static void Main() {

System.Console.WriteLine("hello, world");

se incluye un comentario delimitado.

En el ejemplo

C#

// Hello, world program

// This program writes "hello, world" to the console

//

class Hello // any name will do for this class

static void Main() { // this method must be named "Main"

System.Console.WriteLine("hello, world");

se muestran varios comentarios de una línea.

Espacio en blanco
El espacio en blanco se define como cualquier carácter con la clase Unicode ZS (que
incluye el carácter de espacio), así como el carácter de tabulación horizontal, el carácter
de tabulación vertical y el carácter de avance de la forma.

antlr

whitespace

: '<Any character with Unicode class Zs>'

| '<Horizontal tab character (U+0009)>'

| '<Vertical tab character (U+000B)>'

| '<Form feed character (U+000C)>'

Tokens
Hay varios tipos de tokens: identificadores, palabras clave, literales, operadores y signos
de puntuación. Los espacios en blanco y los comentarios no son tokens, aunque actúan
como separadores de tokens.

antlr

token

: identifier

| keyword

| integer_literal

| real_literal

| character_literal

| string_literal

| interpolated_string_literal
| operator_or_punctuator

Secuencias de escape de caracteres Unicode

Una secuencia de escape de caracteres Unicode representa un carácter Unicode. Las
secuencias de escape de caracteres Unicode se procesan en identificadores
(identificadores), literales de carácter (literales de carácter) y literales de cadena
normales (literales de cadena). Un escape de carácter Unicode no se procesa en ninguna
otra ubicación (por ejemplo, para formar un operador, un signo de puntuación o una
palabra clave).
 antlr

unicode_escape_sequence

: '\\u' hex_digit hex_digit hex_digit hex_digit

| '\\U' hex_digit hex_digit hex_digit hex_digit hex_digit hex_digit

hex_digit hex_digit

Una secuencia de escape Unicode representa el carácter Unicode que forma el número
hexadecimal después de los \u caracteres "" o "" \U . Dado que C# usa una codificación
de 16 bits de puntos de código Unicode en caracteres y valores de cadena, no se
permite un carácter Unicode en el intervalo de U + 10000 a U + 10FFFF en un literal de
carácter y se representa mediante un par suplente Unicode en un literal de cadena. No
se admiten los caracteres Unicode con puntos de código anteriores a 0x10FFFF.

No se realizan varias traducciones. Por ejemplo, el literal de cadena " \u005Cu005C " es
equivalente a " \u005C " en lugar de " \ ". El valor Unicode \u005C es el carácter " \ ".

En el ejemplo

C#

class Class1

static void Test(bool \u0066) {

char c = '\u0066';

if (\u0066)

System.Console.WriteLine(c.ToString());

muestra varios usos de \u0066 , que es la secuencia de escape para la letra " f ". El
programa es equivalente a

C#

class Class1

static void Test(bool f) {

char c = 'f';

if (f)

System.Console.WriteLine(c.ToString());

Identificadores
Las reglas para los identificadores que se proporcionan en esta sección corresponden
exactamente a las recomendadas por el Anexo 31 del estándar Unicode, con la
excepción de que el carácter de subrayado se permite como carácter inicial (como el
tradicional en el lenguaje de programación C), las secuencias de escape Unicode se
permiten en los identificadores y el @ carácter "

antlr

identifier

: available_identifier

| '@' identifier_or_keyword

available_identifier

: '<An identifier_or_keyword that is not a keyword>'

identifier_or_keyword

: identifier_start_character identifier_part_character*

identifier_start_character

: letter_character

| '_'

identifier_part_character

: letter_character

| decimal_digit_character

| connecting_character

| combining_character

| formatting_character

letter_character

: '<A Unicode character of classes Lu, Ll, Lt, Lm, Lo, or Nl>'
| '<A unicode_escape_sequence representing a character of classes Lu,
Ll, Lt, Lm, Lo, or Nl>'

combining_character

: '<A Unicode character of classes Mn or Mc>'

| '<A unicode_escape_sequence representing a character of classes Mn or

Mc>'

decimal_digit_character

: '<A Unicode character of the class Nd>'

| '<A unicode_escape_sequence representing a character of the class Nd>'

connecting_character

: '<A Unicode character of the class Pc>'

 | '<A unicode_escape_sequence representing a character of the class Pc>'

formatting_character

: '<A Unicode character of the class Cf>'

| '<A unicode_escape_sequence representing a character of the class Cf>'

Para obtener información sobre las clases de caracteres Unicode mencionadas

anteriormente, vea el estándar Unicode, versión 3,0, sección 4,5.

Entre los ejemplos de identificadores válidos se incluyen " identifier1 ", " _identifier2
" y " @if ".

Un identificador en un programa conforme debe estar en el formato canónico definido

por la forma de normalización Unicode C, tal y como se define en el Anexo 15 del
estándar Unicode. El comportamiento cuando se encuentra un identificador no en la
forma de normalización C está definido por la implementación; sin embargo, no es
necesario un diagnóstico.

El prefijo " @ " permite el uso de palabras clave como identificadores, lo que resulta útil
al interactuar con otros lenguajes de programación. El carácter @ no es realmente parte
del identificador, por lo que el identificador podría verse en otros idiomas como un
identificador normal, sin el prefijo. Un identificador con un @ prefijo se denomina
identificador textual. Se permite el uso del @ prefijo para los identificadores que no son
palabras clave, pero se desaconseja encarecidamente como una cuestión de estilo.

El ejemplo:

C#

class @class

public static void @static(bool @bool) {

if (@bool)

System.Console.WriteLine("true");

else

System.Console.WriteLine("false");

class Class1

static void M() {

cl\u0061ss.st\u0061tic(true);

define una clase denominada " class " con un método estático denominado " static "
que toma un parámetro con el nombre " bool ". Tenga en cuenta que, puesto que no se
permiten los escapes de Unicode en palabras clave, el token " cl\u0061ss " es un
identificador y es el mismo identificador que " @class ".

Dos identificadores se consideran iguales si son idénticos después de aplicar las

transformaciones siguientes, en orden:

El prefijo " @ ", si se utiliza, se quita.

Cada unicode_escape_sequence se transforma en el carácter Unicode
correspondiente.
Se quitan los formatting_character s.

Los identificadores que contienen dos caracteres de subrayado consecutivos ( U+005F )

se reservan para su uso por parte de la implementación. Por ejemplo, una
implementación podría proporcionar palabras clave extendidas que comienzan con dos
guiones bajos.

Palabras clave
Una palabra clave es una secuencia similar a un identificador de caracteres que está
reservada y no se puede usar como identificador excepto cuando está precedida por el
@ carácter.

antlr

keyword

: 'abstract' | 'as' | 'base' | 'bool' | 'break'

| 'byte' | 'case' | 'catch' | 'char' | 'checked'

| 'class' | 'const' | 'continue' | 'decimal' | 'default'

| 'delegate' | 'do' | 'double' | 'else' | 'enum'

| 'event' | 'explicit' | 'extern' | 'false' | 'finally'

| 'fixed' | 'float' | 'for' | 'foreach' | 'goto'

| 'if' | 'implicit' | 'in' | 'int' | 'interface'

| 'internal' | 'is' | 'lock' | 'long' | 'namespace'

| 'new' | 'null' | 'object' | 'operator' | 'out'

| 'override' | 'params' | 'private' | 'protected' | 'public'

| 'readonly' | 'ref' | 'return' | 'sbyte' | 'sealed'

| 'short' | 'sizeof' | 'stackalloc' | 'static' | 'string'

| 'struct' | 'switch' | 'this' | 'throw' | 'true'

| 'try' | 'typeof' | 'uint' | 'ulong' | 'unchecked'

| 'unsafe' | 'ushort' | 'using' | 'virtual' | 'void'

| 'volatile' | 'while'

En algunos lugares de la gramática, los identificadores específicos tienen un significado

especial, pero no son palabras clave. Dichos identificadores se denominan a veces
"palabras clave contextuales". Por ejemplo, dentro de una declaración de propiedad, los
get identificadores "" y " set " tienen un significado especial (descriptores de acceso).
Un identificador distinto de get o set nunca se permite en estas ubicaciones, por lo
que este uso no entra en conflicto con el uso de estas palabras como identificadores. En
otros casos, como con el identificador " var " en las declaraciones de variables locales
con tipo implícito (declaraciones devariables locales), una palabra clave contextual
puede entrar en conflicto con los nombres declarados. En tales casos, el nombre
declarado tiene prioridad sobre el uso del identificador como palabra clave contextual.

Literales
Un literal es una representación de código fuente de un valor.

antlr

literal

: boolean_literal

| integer_literal

| real_literal

| character_literal

| string_literal

| null_literal

booleanos, literales

Hay dos valores literales booleanos: true y false .

antlr

boolean_literal

: 'true'

| 'false'

El tipo de una boolean_literal es bool .

Literales enteros
Los literales enteros se utilizan para escribir valores de tipos int , uint , long y ulong .
Los literales enteros tienen dos formas posibles: decimal y hexadecimal.
 antlr

integer_literal

: decimal_integer_literal

| hexadecimal_integer_literal
;

decimal_integer_literal

: decimal_digit+ integer_type_suffix?

decimal_digit

: '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'

integer_type_suffix

: 'U' | 'u' | 'L' | 'l' | 'UL' | 'Ul' | 'uL' | 'ul' | 'LU' | 'Lu' | 'lU'
| 'lu'

hexadecimal_integer_literal

: '0x' hex_digit+ integer_type_suffix?

| '0X' hex_digit+ integer_type_suffix?

hex_digit

: '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'

| 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f';

El tipo de un literal entero se determina de la siguiente manera:

Si el literal no tiene sufijo, tiene el primero de estos tipos en el que se puede

representar su valor: int , uint , long , ulong .
Si el literal tiene el sufijo U o u , tiene el primero de estos tipos en el que se puede
representar su valor: uint , ulong .
Si el literal tiene el sufijo L o l , tiene el primero de estos tipos en el que se puede
representar su valor: long , ulong .
Si el literal tiene el sufijo UL , Ul , uL , ul , LU , Lu , lU o lu , es de tipo ulong .

Si el valor representado por un literal entero está fuera del intervalo del ulong tipo, se
produce un error en tiempo de compilación.

Como cuestión de estilo, se sugiere que " L " se use en lugar de " l " cuando se
escriben literales de tipo long , ya que es fácil confundir la letra " l " con el dígito " 1 ".

Para permitir que los valores y más pequeños posibles int long se escriban como
literales enteros decimales, existen las dos reglas siguientes:
 Cuando un decimal_integer_literal con el valor 2147483648 (2 ^ 31) y no hay
ningún integer_type_suffix aparece como el token inmediatamente después de un
token de operador unario menos (operador unario menos), el resultado es una
constante de tipo int con el valor-2147483648 (-2 ^ 31). En todas las demás
situaciones, tal decimal_integer_literal es de tipo uint .
Cuando un decimal_integer_literal con el valor 9223372036854775808 (2 ^ 63) y no
integer_type_suffix o el integer_type_suffix L o l aparece como el token
inmediatamente después de un token de operador unario menos (operador unario
menos), el resultado es una constante de tipo long con el valor-
9.223.372.036.854.775.808 (-2 ^ 63). En todas las demás situaciones, tal
decimal_integer_literal es de tipo ulong .

Literales reales
Los literales reales se utilizan para escribir valores de tipos float , double y decimal .

antlr

real_literal

: decimal_digit+ '.' decimal_digit+ exponent_part? real_type_suffix?

| '.' decimal_digit+ exponent_part? real_type_suffix?

| decimal_digit+ exponent_part real_type_suffix?

| decimal_digit+ real_type_suffix

exponent_part

: 'e' sign? decimal_digit+

| 'E' sign? decimal_digit+

sign

: '+'

| '-'

real_type_suffix

: 'F' | 'f' | 'D' | 'd' | 'M' | 'm'

Si no se especifica ningún real_type_suffix , el tipo del literal real es double . De lo

contrario, el sufijo de tipo real determina el tipo del literal real, como se indica a
continuación:

Un literal real con sufijo F o f es de tipo float . Por ejemplo, los literales 1f ,
1.5f , 1e10f y 123.456F son de tipo float .
 Un literal real con sufijo D o d es de tipo double . Por ejemplo, los literales 1d ,
1.5d , 1e10d y 123.456D son de tipo double .
Un literal real con sufijo M o m es de tipo decimal . Por ejemplo, los literales 1m ,
1.5m , 1e10m y 123.456M son de tipo decimal . Este literal se convierte en un
decimal valor mediante el uso del valor exacto, y, si es necesario, se redondea al

valor representable más cercano mediante el redondeo bancario (el tipo decimal).
Cualquier escala aparente en el literal se conserva a menos que el valor se
redondee o el valor sea cero (en cuyo caso, el signo y la escala serán 0). Por lo
tanto, el literal se 2.900m analizará para formar el decimal con el signo 0 , el
coeficiente 2900 y la escala 3 .

Si el literal especificado no se puede representar en el tipo indicado, se produce un error

en tiempo de compilación.

El valor de un literal real de tipo float o double se determina mediante el modo

"redondeo al más cercano" de IEEE.

Tenga en cuenta que, en un literal real, siempre se requieren dígitos decimales después
del separador decimal. Por ejemplo, 1.3F es un literal real pero 1.F no es.

Literales de carácter
Un literal de carácter representa un carácter único y normalmente consta de un carácter
entre comillas, como en 'a' .

Nota: la notación gramatical ANTLR hace que la siguiente confusión. En ANTLR, cuando
escribe, \' representa una comilla simple ' . Y, cuando se escribe \\ , representa una
sola barra diagonal inversa \ . Por lo tanto, la primera regla para un literal de carácter
significa que empieza con una comilla simple, un carácter y, a continuación, una comilla
simple. Y las once secuencias de escape simples posibles son \' , \" , \\ , \0 , \a , \b
, \f , \n , \r , \t , \v .

antlr

character_literal

: '\'' character '\''

character

: single_character

| simple_escape_sequence

| hexadecimal_escape_sequence
| unicode_escape_sequence

 single_character

: '<Any character except \' (U+0027), \\ (U+005C), and

new_line_character>'

simple_escape_sequence

: '\\\'' | '\\"' | '\\\\' | '\\0' | '\\a' | '\\b' | '\\f' | '\\n' |

'\\r' | '\\t' | '\\v'

hexadecimal_escape_sequence

: '\\x' hex_digit hex_digit? hex_digit? hex_digit?;

Un carácter que sigue a un carácter de barra diagonal inversa ( \ ) en un carácter debe

ser uno de los caracteres siguientes: ' , " , \ , 0 , a , b , f , n , r ,, t u , U ,, x v . De
lo contrario, se produce un error en tiempo de compilación.

Una secuencia de escape hexadecimal representa un único carácter Unicode, con el

valor formado por el número hexadecimal siguiente a " \x ".

Si el valor representado por un literal de carácter es mayor que U+FFFF , se produce un

error en tiempo de compilación.

Una secuencia de escape de caracteres Unicode (secuencias de escape de caracteres

Unicode) en un literal de carácter debe estar en el intervalo de U+0000 U+FFFF .

Una secuencia de escape simple representa una codificación de caracteres Unicode, tal y
como se describe en la tabla siguiente.

Secuencia de escape Nombre de carácter Codificación Unicode

\' Comilla simple 0x0027

\" Comilla doble 0x0022

\\ Barra diagonal inversa 0x005C

\0 Null 0x0000

\a Alerta 0x0007

\b Retroceso 0x0008

\f Avance de página 0x000C

\n Nueva línea 0x000A

\r Retorno de carro 0x000D

 Secuencia de escape Nombre de carácter Codificación Unicode

\t Tabulación horizontal 0x0009

\v Tabulación vertical 0x000B

El tipo de una character_literal es char .

Literales de cadena
C# admite dos formatos de literales de cadena: * literales de cadena normales _ y _
literales de cadena textuales *.

Un literal de cadena normal consta de cero o más caracteres entre comillas dobles,
como en "hello" , y puede incluir secuencias de escape simples (por ejemplo, \t para
el carácter de tabulación) y secuencias de escape hexadecimal y Unicode.

Un literal de cadena textual se compone de un @ carácter seguido de un carácter de

comilla doble, cero o más caracteres, y un carácter de comilla doble de cierre. Un
ejemplo sencillo es @"hello" . En un literal de cadena textual, los caracteres entre los
delimitadores se interpretan literalmente, la única excepción es un
quote_escape_sequence. En concreto, las secuencias de escape simples, y las secuencias
de escape hexadecimales y Unicode no se procesan en literales de cadena textuales. Un
literal de cadena textual puede abarcar varias líneas.

antlr

string_literal

: regular_string_literal

| verbatim_string_literal

regular_string_literal

: '"' regular_string_literal_character* '"'

regular_string_literal_character

: single_regular_string_literal_character

| simple_escape_sequence

| hexadecimal_escape_sequence
| unicode_escape_sequence

single_regular_string_literal_character

: '<Any character except " (U+0022), \\ (U+005C), and

new_line_character>'

 verbatim_string_literal

: '@"' verbatim_string_literal_character* '"'

verbatim_string_literal_character
: single_verbatim_string_literal_character

| quote_escape_sequence

single_verbatim_string_literal_character

: '<any character except ">'

quote_escape_sequence

: '""'

Un carácter que sigue a un carácter de barra diagonal inversa ( \ ) en un

regular_string_literal_character debe ser uno de los caracteres siguientes: ' , " , \ , 0 ,
a , b , f , n , r ,, t u , U ,, x v . De lo contrario, se produce un error en tiempo de

compilación.

En el ejemplo

C#

string a = "hello, world"; // hello, world

string b = @"hello, world"; // hello, world

string c = "hello \t world"; // hello world

string d = @"hello \t world"; // hello \t world

string e = "Joe said \"Hello\" to me"; // Joe said "Hello" to me

string f = @"Joe said ""Hello"" to me"; // Joe said "Hello" to me

string g = "\\\\server\\share\\file.txt"; // \\server\share\file.txt

string h = @"\\server\share\file.txt"; // \\server\share\file.txt

string i = "one\r\ntwo\r\nthree";

string j = @"one

two

three";

muestra varios literales de cadena. El último literal de cadena, j , es un literal de cadena

textual que abarca varias líneas. Los caracteres entre comillas, incluidos los espacios en
blanco, como los caracteres de nueva línea, se conservan literalmente.

Dado que una secuencia de escape hexadecimal puede tener un número variable de
dígitos hexadecimales, el literal de cadena "\x123" contiene un carácter único con el
valor hexadecimal 123. Para crear una cadena que contenga el carácter con el valor
hexadecimal 12 seguido del carácter 3, puede "\x00123" escribir "\x12" + "3" en su
lugar o.

El tipo de una string_literal es string .

Cada literal de cadena no tiene necesariamente como resultado una nueva instancia de
cadena. Cuando dos o más literales de cadena que son equivalentes de acuerdo con el
operador de igualdad de cadena (operadores de igualdad de cadena) aparecen en el
mismo programa, estos literales de cadena hacen referencia a la misma instancia de
cadena. Por ejemplo, la salida generada por

C#

class Test

static void Main() {

object a = "hello";

object b = "hello";

System.Console.WriteLine(a == b);

se True debe a que los dos literales hacen referencia a la misma instancia de cadena.

Literales de cadena interpolados

Los literales de cadena interpolados son similares a los literales de cadena, pero
contienen huecos delimitados por { y } , donde se pueden producir expresiones. En
tiempo de ejecución, las expresiones se evalúan con el propósito de tener sus
formularios de texto sustituidos en la cadena en el lugar donde se produce el agujero.
La sintaxis y la semántica de la interpolación de cadenas se describen en la sección
(cadenas interpoladas).

Al igual que los literales de cadena, los literales de cadena interpolados pueden ser
normales o literales. Los literales de cadena normales interpolados están delimitados
por $" y " , y los literales de cadena textual interpolados están delimitados por $@" y "
.

Al igual que otros literales, el análisis léxico de un literal de cadena interpolada produce
inicialmente un token único, según la gramática siguiente. Sin embargo, antes del
análisis sintáctico, el token único de un literal de cadena interpolada se divide en varios
tokens para las partes de la cadena que los rodean, y los elementos de entrada que se
producen en los huecos se analizan léxicamente de nuevo. Esto puede, a su vez, generar
más literales de cadena interpolados que se van a procesar, pero, si léxicamente
correcto, dará lugar a una secuencia de tokens para que los procese el análisis
sintáctico.

antlr

interpolated_string_literal

: '$' interpolated_regular_string_literal

| '$' interpolated_verbatim_string_literal

interpolated_regular_string_literal

: interpolated_regular_string_whole

| interpolated_regular_string_start
interpolated_regular_string_literal_body interpolated_regular_string_end

interpolated_regular_string_literal_body

: regular_balanced_text

| interpolated_regular_string_literal_body
interpolated_regular_string_mid regular_balanced_text

interpolated_regular_string_whole
: '"' interpolated_regular_string_character* '"'

interpolated_regular_string_start
: '"' interpolated_regular_string_character* '{'

interpolated_regular_string_mid

: interpolation_format? '}'
interpolated_regular_string_characters_after_brace? '{'

interpolated_regular_string_end

: interpolation_format? '}'
interpolated_regular_string_characters_after_brace? '"'

interpolated_regular_string_characters_after_brace

: interpolated_regular_string_character_no_brace

| interpolated_regular_string_characters_after_brace
interpolated_regular_string_character

interpolated_regular_string_character

: single_interpolated_regular_string_character

| simple_escape_sequence

| hexadecimal_escape_sequence
| unicode_escape_sequence

| open_brace_escape_sequence

 | close_brace_escape_sequence
;

interpolated_regular_string_character_no_brace

: '<Any interpolated_regular_string_character except

close_brace_escape_sequence and any hexadecimal_escape_sequence or
unicode_escape_sequence designating } (U+007D)>'

single_interpolated_regular_string_character

: '<Any character except \" (U+0022), \\ (U+005C), { (U+007B), }

(U+007D), and new_line_character>'

open_brace_escape_sequence

: '{{'

close_brace_escape_sequence

: '}}'

regular_balanced_text

: regular_balanced_text_part+
;

regular_balanced_text_part

: single_regular_balanced_text_character

| delimited_comment

| '@' identifier_or_keyword

| string_literal

| interpolated_string_literal
| '(' regular_balanced_text ')'

| '[' regular_balanced_text ']'

| '{' regular_balanced_text '}'

single_regular_balanced_text_character

: '<Any character except / (U+002F), @ (U+0040), \" (U+0022), $

(U+0024), ( (U+0028), ) (U+0029), [ (U+005B), ] (U+005D), { (U+007B), }
(U+007D) and new_line_character>'
| '</ (U+002F), if not directly followed by / (U+002F) or * (U+002A)>'

interpolation_format

: ':' interpolation_format_character+

interpolation_format_character

: '<Any character except \" (U+0022), : (U+003A), { (U+007B) and }

(U+007D)>'

interpolated_verbatim_string_literal

: interpolated_verbatim_string_whole

 | interpolated_verbatim_string_start
interpolated_verbatim_string_literal_body interpolated_verbatim_string_end

interpolated_verbatim_string_literal_body

: verbatim_balanced_text

| interpolated_verbatim_string_literal_body
interpolated_verbatim_string_mid verbatim_balanced_text

interpolated_verbatim_string_whole

: '@"' interpolated_verbatim_string_character* '"'

interpolated_verbatim_string_start

: '@"' interpolated_verbatim_string_character* '{'

interpolated_verbatim_string_mid

: interpolation_format? '}'
interpolated_verbatim_string_characters_after_brace? '{'

interpolated_verbatim_string_end

: interpolation_format? '}'
interpolated_verbatim_string_characters_after_brace? '"'

interpolated_verbatim_string_characters_after_brace

: interpolated_verbatim_string_character_no_brace

| interpolated_verbatim_string_characters_after_brace
interpolated_verbatim_string_character

interpolated_verbatim_string_character

: single_interpolated_verbatim_string_character

| quote_escape_sequence

| open_brace_escape_sequence

| close_brace_escape_sequence
;

interpolated_verbatim_string_character_no_brace

: '<Any interpolated_verbatim_string_character except

close_brace_escape_sequence>'

single_interpolated_verbatim_string_character

: '<Any character except \" (U+0022), { (U+007B) and } (U+007D)>'

verbatim_balanced_text

: verbatim_balanced_text_part+

verbatim_balanced_text_part

 : single_verbatim_balanced_text_character

| comment

| '@' identifier_or_keyword

| string_literal

| interpolated_string_literal
| '(' verbatim_balanced_text ')'

| '[' verbatim_balanced_text ']'

| '{' verbatim_balanced_text '}'

single_verbatim_balanced_text_character

: '<Any character except / (U+002F), @ (U+0040), \" (U+0022), $

(U+0024), ( (U+0028), ) (U+0029), [ (U+005B), ] (U+005D), { (U+007B) and }
(U+007D)>'

| '</ (U+002F), if not directly followed by / (U+002F) or * (U+002A)>'

Un token de interpolated_string_literal se interpreta como varios tokens y otros

elementos de entrada como se indica a continuación, en el orden de aparición en el
interpolated_string_literal:

Las apariciones de lo siguiente se interpretan como tokens individuales

independientes: el $ signo inicial, la interpolated_regular_string_whole, la
interpolated_regular_string_start, el interpolated_regular_string_mid,
interpolated_regular_string_end, interpolated_verbatim_string_whole,
interpolated_verbatim_string_start, interpolated_verbatim_string_mid y
interpolated_verbatim_string_end.
Las repeticiones de regular_balanced_text y verbatim_balanced_text entre ellas se
reprocesan como un input_section (análisis léxico) y se reinterpretan como la
secuencia resultante de los elementos de entrada. A su vez, pueden incluir tokens
literales de cadena interpolados que se van a reinterpretar.

El análisis sintáctico volverá a combinar los tokens en un interpolated_string_expression

(cadenas interpoladas).

Ejemplos TODO

El literal null

antlr

null_literal

: 'null'

El null_literal se puede convertir implícitamente a un tipo de referencia o a un tipo que

acepta valores NULL.

Operadores y signos de puntuación

Hay varios tipos de operadores y signos de puntuación. Los operadores se usan en
expresiones para describir las operaciones con uno o varios operandos implicados. Por
ejemplo, la expresión a + b usa el operador + para agregar los dos operandos a y b .
Los signos de puntuación se usan para agrupar y separar.

antlr

operator_or_punctuator

: '{' | '}' | '[' | ']' | '(' | ')' | '.' | ',' | ':' | ';'

| '+' | '-' | '*' | '/' | '%' | '&' | '|' | '^' | '!' | '~'

| '=' | '<' | '>' | '?' | '??' | '::' | '++' | '--' | '&&' | '||'

| '->' | '==' | '!=' | '<=' | '>=' | '+=' | '-=' | '*=' | '/=' | '%='

| '&=' | '|=' | '^=' | '<<' | '<<=' | '=>'

right_shift

: '>>'

right_shift_assignment

: '>>='

La barra vertical de las producciones RIGHT_SHIFT y right_shift_assignment se utiliza para

indicar que, a diferencia de otras producciones en la gramática sintáctica, no se
permiten caracteres de ningún tipo (ni siquiera espacios en blanco) entre los tokens.
Estas producciones se tratan de forma especial para habilitar el control correcto de
type_parameter_list s (parámetros de tipo).

Directivas de procesamiento previo

Las directivas de procesamiento previo proporcionan la capacidad de omitir
condicionalmente las secciones de los archivos de código fuente, notificar las
condiciones de error y ADVERTENCIA, y para delimitar distintas regiones del código
fuente. El término "directivas de procesamiento previo" solo se usa para mantener la
coherencia con los lenguajes de programación C y C++. En C#, no hay ningún paso de
procesamiento previo independiente; las directivas de procesamiento previo se
procesan como parte de la fase de análisis léxico.
 antlr

pp_directive

: pp_declaration

| pp_conditional

| pp_line

| pp_diagnostic

| pp_region

| pp_pragma

Están disponibles las siguientes directivas de procesamiento previo:

#define y #undef , que se usan para definir y anular la definición, respectivamente,

de símbolos de compilación condicional (directivas de declaración).

#if , #elif , #else y #endif , que se usan para omitir condicionalmente las

secciones del código fuente (directivas de compilación condicional).

#line , que se usa para controlar los números de línea emitidos para errores y

advertencias (directivas de línea).

#error y #warning , que se usan para emitir errores y advertencias,
respectivamente (directivas de diagnóstico).
#region y #endregion , que se usan para marcar explícitamente las secciones del
código fuente (directivas de región).
#pragma , que se usa para especificar información contextual opcional para el

compilador (directivas pragma).

Una directiva de procesamiento previo siempre ocupa una línea de código fuente
independiente y siempre comienza con un # carácter y un nombre de directiva de
preprocesamiento. Los espacios en blanco pueden aparecer antes del # carácter y entre
el # carácter y el nombre de la Directiva.

Una línea de código fuente que contiene una #define #undef Directiva,, #if , #elif ,
#else , #endif , #line o #endregion puede terminar con un Comentario de una sola

línea. Los comentarios delimitados (el /* */ estilo de los comentarios) no se permiten

en líneas de código fuente que contengan directivas de procesamiento previo.

Las directivas de procesamiento previo no son tokens y no forman parte de la gramática

sintáctica de C#. Sin embargo, las directivas de procesamiento previo se pueden usar
para incluir o excluir secuencias de tokens y, de ese modo, pueden afectar al significado
de un programa de C#. Por ejemplo, cuando se compila, el programa:

C#
 #define A

#undef B

class C

#if A

void F() {}

#else

void G() {}

#endif

#if B

void H() {}

#else

void I() {}

#endif

da como resultado la misma secuencia de tokens que el programa:

C#

class C

void F() {}

void I() {}

Por lo tanto, mientras que los dos programas son bastante diferentes y sintácticamente,
son idénticos.

Símbolos de compilación condicional

La funcionalidad de compilación condicional proporcionada por #if las #elif
directivas,, #else y #endif se controla a través de expresiones de procesamiento previo
(expresiones de procesamiento previo) y símbolos de compilación condicional.

antlr

conditional_symbol

: '<Any identifier_or_keyword except true or false>'

Un símbolo de compilación condicional tiene dos Estados posibles: *Defined _ o _

undefined *. Al principio del procesamiento léxico de un archivo de código fuente, un
símbolo de compilación condicional es indefinido, a menos que se haya definido
explícitamente mediante un mecanismo externo (como una opción del compilador de
línea de comandos). Cuando #define se procesa una directiva, el símbolo de
compilación condicional denominado en esa Directiva se define en ese archivo de
código fuente. El símbolo permanece definido hasta que #undef se procesa una
directiva para el mismo símbolo, o hasta que se alcanza el final del archivo de código
fuente. Una implicación de esto es que #define #undef las directivas y de un archivo de
código fuente no tienen ningún efecto en otros archivos de código fuente del mismo
programa.

Cuando se hace referencia en una expresión de procesamiento previo, un símbolo de

compilación condicional definido tiene el valor booleano true y un símbolo de
compilación condicional sin definir tiene el valor booleano false . No hay ningún
requisito de que los símbolos de compilación condicional se declaren explícitamente
antes de que se haga referencia a ellos en expresiones de procesamiento previo. En su
lugar, los símbolos no declarados simplemente están sin definir y, por tanto, tienen el
valor false .

El espacio de nombres de los símbolos de compilación condicional es distinto y

separado de todas las demás entidades con nombre en un programa de C#. Solo se
puede hacer referencia a los símbolos de compilación condicional en las #define
#undef directivas y y en las expresiones de procesamiento previo.

Expresiones de procesamiento previo

Las expresiones de procesamiento previo pueden producirse en las #if #elif directivas
y. Los operadores ! , == , != && y || se permiten en las expresiones de procesamiento
previo y los paréntesis se pueden usar para la agrupación.

antlr

pp_expression

: whitespace? pp_or_expression whitespace?

pp_or_expression

: pp_and_expression

| pp_or_expression whitespace? '||' whitespace? pp_and_expression

pp_and_expression

: pp_equality_expression

| pp_and_expression whitespace? '&&' whitespace? pp_equality_expression

pp_equality_expression

 : pp_unary_expression

| pp_equality_expression whitespace? '==' whitespace?

pp_unary_expression

| pp_equality_expression whitespace? '!=' whitespace?

pp_unary_expression

pp_unary_expression

: pp_primary_expression

| '!' whitespace? pp_unary_expression

pp_primary_expression

: 'true'

| 'false'

| conditional_symbol

| '(' whitespace? pp_expression whitespace? ')'

Cuando se hace referencia en una expresión de procesamiento previo, un símbolo de

compilación condicional definido tiene el valor booleano true y un símbolo de
compilación condicional sin definir tiene el valor booleano false .

La evaluación de una expresión de procesamiento previo siempre produce un valor

booleano. Las reglas de evaluación de una expresión de procesamiento previo son las
mismas que las de una expresión constante (expresiones constantes), salvo que las
únicas entidades definidas por el usuario a las que se puede hacer referencia son
símbolos de compilación condicionales.

Directivas de declaración
Las directivas de declaración se utilizan para definir o anular la definición de símbolos
de compilación condicional.

antlr

pp_declaration

: whitespace? '#' whitespace? 'define' whitespace conditional_symbol

pp_new_line

| whitespace? '#' whitespace? 'undef' whitespace conditional_symbol

pp_new_line

pp_new_line

: whitespace? single_line_comment? new_line

El procesamiento de una #define Directiva hace que se defina el símbolo de

compilación condicional dado, empezando por la línea de código fuente que sigue a la
Directiva. Del mismo modo, el procesamiento de una #undef Directiva hace que el
símbolo de compilación condicional dado quede sin definir, empezando por la línea de
código fuente que sigue a la Directiva.

Las #define #undef directivas y de un archivo de código fuente deben aparecer antes
del primer token (tokens) en el archivo de código fuente; de lo contrario, se produce un
error en tiempo de compilación. En términos intuitivos, #define y #undef las directivas
deben preceder a cualquier "código real" en el archivo de código fuente.

El ejemplo:

C#

#define Enterprise

#if Professional || Enterprise

#define Advanced

#endif

namespace Megacorp.Data

#if Advanced

class PivotTable {...}

#endif

es válido porque las #define directivas preceden al primer token (la namespace palabra
clave) en el archivo de código fuente.

En el ejemplo siguiente se produce un error en tiempo de compilación porque un

#define sigue código real:

C#

#define A

namespace N

#define B

#if B

class Class1 {}

#endif

#define Puede definir un símbolo de compilación condicional que ya esté definido, sin

que intervenga ningún #undef símbolo. En el ejemplo siguiente se define un símbolo de

compilación condicional A y, a continuación, se define de nuevo.

C#

#define A

#define A

Un #undef puede "anular la definición" de un símbolo de compilación condicional que

no está definido. En el ejemplo siguiente se define un símbolo de compilación
condicional A y, a continuación, se anula su definición dos veces; aunque el segundo
#undef no tiene ningún efecto, sigue siendo válido.

C#

#define A

#undef A

#undef A

Directivas de compilación condicional

Las directivas de compilación condicional se usan para incluir o excluir de forma
condicional partes de un archivo de código fuente.

antlr

pp_conditional

: pp_if_section pp_elif_section* pp_else_section? pp_endif

pp_if_section

: whitespace? '#' whitespace? 'if' whitespace pp_expression pp_new_line

conditional_section?

pp_elif_section

: whitespace? '#' whitespace? 'elif' whitespace pp_expression

pp_new_line conditional_section?

pp_else_section:

| whitespace? '#' whitespace? 'else' pp_new_line conditional_section?

pp_endif

: whitespace? '#' whitespace? 'endif' pp_new_line

conditional_section

 : input_section

| skipped_section

skipped_section

: skipped_section_part+

skipped_section_part

: skipped_characters? new_line

| pp_directive

skipped_characters

: whitespace? not_number_sign input_character*

not_number_sign

: '<Any input_character except #>'

Como se indica en la sintaxis, las directivas de compilación condicional se deben escribir

como conjuntos compuestos de, en orden, una #if Directiva, cero o más #elif
directivas, cero o una #else Directiva y una #endif Directiva. Entre las directivas se
encuentran las secciones condicionales del código fuente. Cada sección se controla
mediante la Directiva inmediatamente anterior. Una sección condicional puede contener
directivas de compilación condicional anidadas, siempre que estas directivas formen
conjuntos completos.

Un pp_conditional selecciona como máximo uno de los conditional_section s incluidos

para el procesamiento léxico normal:

Los pp_expression s de las #if #elif directivas y se evalúan en orden hasta que se
produce una true . Si una expresión produce true , se selecciona la
conditional_section de la directiva correspondiente.
Si todos los pp_expression producen false y, si una #else Directiva está presente,
se selecciona el conditional_section de la #else Directiva.
De lo contrario, no se selecciona ningún conditional_section .

La conditional_section seleccionada, si la hay, se procesa como una input_section normal:

el código fuente contenido en la sección debe adherirse a la gramática léxica; los tokens
se generan a partir del código fuente de la sección. y las directivas de procesamiento
previo de la sección tienen los efectos prescritos.

El resto de conditional_section s, si los hay, se procesan como skipped_section s: excepto

las directivas de procesamiento previo, el código fuente de la sección no necesita
adherirse a la gramática léxica; no se generan tokens a partir del código fuente de la
sección; y las directivas de procesamiento previo de la sección deben ser léxicamente
correctas, pero no se procesan de otra manera. Dentro de un conditional_section que se
está procesando como una skipped_section, cualquier conditional_section anidado
(contenido en construcciones anidadas #if ... #endif y #region ... #endregion ) también
se procesa como skipped_section s.

En el ejemplo siguiente se muestra cómo se pueden anidar las directivas de compilación

condicional:

C#

#define Debug // Debugging on

#undef Trace // Tracing off

class PurchaseTransaction

void Commit() {

#if Debug

CheckConsistency();

#if Trace

WriteToLog(this.ToString());

#endif

#endif

CommitHelper();

Excepto en el caso de las directivas de procesamiento previo, el código fuente omitido

no está sujeto al análisis léxico. Por ejemplo, lo siguiente es válido a pesar del
comentario sin terminar en la #else sección:

C#

#define Debug // Debugging on

class PurchaseTransaction

void Commit() {

#if Debug

CheckConsistency();

#else

/* Do something else

#endif

Sin embargo, tenga en cuenta que las directivas de procesamiento previo deben ser
léxicamente correctas incluso en secciones omitidas del código fuente.

Las directivas de procesamiento previo no se procesan cuando aparecen dentro de

elementos de entrada de varias líneas. Por ejemplo, el programa:

C#

class Hello

static void Main() {

System.Console.WriteLine(@"hello,

#if Debug

world

#else

Nebraska

#endif

");

da como resultado el resultado:

Consola

hello,

#if Debug

world

#else

Nebraska

#endif

En casos peculiares, el conjunto de directivas de procesamiento previo que se procesa

puede depender de la evaluación del pp_expression. El ejemplo:

C#

#if X

/*

#else

/* */ class Q { }

#endif

siempre genera el mismo flujo de token ( class Q { } ), independientemente de si X

está definido o no. Si X se define, las únicas directivas procesadas son #if y #endif ,
debido al comentario de varias líneas. Si X es undefined, tres directivas ( #if , #else ,
#endif ) forman parte del conjunto de directivas.
Directivas de diagnóstico
Las directivas de diagnóstico se utilizan para generar explícitamente mensajes de error y
de advertencia que se detectan de la misma manera que otros errores y advertencias en
tiempo de compilación.

antlr

pp_diagnostic

: whitespace? '#' whitespace? 'error' pp_message

| whitespace? '#' whitespace? 'warning' pp_message

pp_message

: new_line

| whitespace input_character* new_line

El ejemplo:

C#

#warning Code review needed before check-in

#if Debug && Retail

#error A build can't be both debug and retail

#endif

class Test {...}

siempre genera una advertencia ("se requiere una revisión del código antes de la
inserción en el repositorio") y genera un error en tiempo de compilación ("una
compilación no puede ser Debug and Retail") si se definen los símbolos condicionales
Debug y Retail . Tenga en cuenta que un pp_message puede contener texto arbitrario;
en concreto, no es necesario que los tokens sean correctos, tal y como se muestra en la
palabra comilla simple can't .

Directivas de región
Las directivas region se usan para marcar explícitamente las regiones del código fuente.

antlr

pp_region

: pp_start_region conditional_section? pp_end_region

 pp_start_region

: whitespace? '#' whitespace? 'region' pp_message

pp_end_region

: whitespace? '#' whitespace? 'endregion' pp_message

;

No se adjunta ningún significado semántico a una región; las regiones están pensadas
para que las use el programador o las herramientas automatizadas para marcar una
sección del código fuente. El mensaje especificado en una #region Directiva o del
#endregion mismo modo no tiene ningún significado semántico; simplemente sirve para
identificar la región. La coincidencia #region de las #endregion directivas y puede tener
distintos pp_message.

El procesamiento léxico de una región:

C#

#region

...

#endregion

corresponde exactamente al procesamiento léxico de una directiva de compilación

condicional del formulario:

C#

#if true

...

#endif

Directivas de línea
Las directivas de línea se pueden usar para modificar los números de línea y los
nombres de archivo de origen que el compilador indica en la salida, como advertencias
y errores, y que se usan en los atributos de información de llamador (atributos de
información de llamador).

Las directivas de línea se utilizan normalmente en herramientas de metaprogramaciones

que generan código fuente de C# a partir de otra entrada de texto.

antlr
 pp_line

: whitespace? '#' whitespace? 'line' whitespace line_indicator

pp_new_line

line_indicator

: decimal_digit+ whitespace file_name

| decimal_digit+

| 'default'

| 'hidden'

file_name

: '"' file_name_character+ '"'

file_name_character

: '<Any input_character except ">'

Cuando no hay #line directivas presentes, el compilador informa de los números de

línea verdaderos y los nombres de archivo de origen en su salida. Al procesar una #line
Directiva que incluye un line_indicator que no es default , el compilador trata la línea
después de la Directiva con el número de línea especificado (y el nombre de archivo, si
se especifica).

Una #line default Directiva invierte el efecto de todas las directivas de #line anteriores.
El compilador notifica la información de línea verdadera para las líneas siguientes,
exactamente como si no #line se hubieran procesado directivas.

Una #line hidden Directiva no tiene ningún efecto en el archivo y los números de línea
indicados en los mensajes de error, pero afecta a la depuración de nivel de origen. Al
depurar, todas las líneas entre una #line hidden Directiva y la #line Directiva
subsiguiente (que no es #line hidden ) no tienen información de número de línea. Al
recorrer el código en el depurador, estas líneas se omitirán por completo.

Tenga en cuenta que un file_name difiere de un literal de cadena normal en el que no se

procesan los caracteres de escape; el \ carácter "" simplemente designa un carácter de
barra diagonal inversa normal dentro de un file_name.

Directivas pragma
La #pragma Directiva de preprocesamiento se usa para especificar información
contextual opcional para el compilador. La información proporcionada en una #pragma
directiva nunca cambiará la semántica del programa.
 antlr

pp_pragma

: whitespace? '#' whitespace? 'pragma' whitespace pragma_body

pp_new_line

pragma_body

: pragma_warning_body

C# proporciona #pragma directivas para controlar las advertencias del compilador. Las
versiones futuras del lenguaje pueden incluir #pragma directivas adicionales. Para
garantizar la interoperabilidad con otros compiladores de C#, el compilador de
Microsoft C# no emite errores de compilación para las directivas desconocidas #pragma ;
sin embargo, estas directivas generan advertencias.

ADVERTENCIA de pragma
La #pragma warning Directiva se usa para deshabilitar o restaurar todo o un conjunto
determinado de mensajes de advertencia durante la compilación del texto del programa
subsiguiente.

antlr

pragma_warning_body

: 'warning' whitespace warning_action

| 'warning' whitespace warning_action whitespace warning_list

warning_action

: 'disable'

| 'restore'

warning_list

: decimal_digit+ (whitespace? ',' whitespace? decimal_digit+)*

;

Una #pragma warning Directiva que omite la lista de advertencias afecta a todas las
advertencias. Una #pragma warning Directiva que incluye una lista de advertencias afecta
solo a las advertencias especificadas en la lista.

Una #pragma warning disable Directiva deshabilita todos o el conjunto de advertencias

especificado.
Una #pragma warning restore Directiva restaura todos o el conjunto de advertencias
especificado en el estado que estaba en vigor al principio de la unidad de compilación.
Tenga en cuenta que si se ha deshabilitado una advertencia determinada externamente,
una #pragma warning restore (ya sea para toda o la advertencia específica) no volverá a
habilitar esa advertencia.

En el ejemplo siguiente se muestra el uso de #pragma warning para deshabilitar

temporalmente la advertencia que se indica cuando se hace referencia a los miembros
obsoletos, mediante el número de advertencia del compilador de Microsoft C#.

C#

using System;

class Program

[Obsolete]

static void Foo() {}

static void Main() {

#pragma warning disable 612

Foo();

#pragma warning restore 612

Conceptos básicos
Artículo • 16/09/2021 • Tiempo de lectura: 50 minutos

Inicio de la aplicación
Un ensamblado que tiene un punto de entrada* _ se denomina aplicación. Cuando se
ejecuta una aplicación, se crea un nuevo _ _ *dominio de aplicación**. Puede haber varias
instancias diferentes de una aplicación en el mismo equipo al mismo tiempo, y cada una
tiene su propio dominio de aplicación.

Un dominio de aplicación permite el aislamiento de aplicaciones actuando como un

contenedor para el estado de la aplicación. Un dominio de aplicación actúa como
contenedor y límite para los tipos definidos en la aplicación y las bibliotecas de clases
que usa. Los tipos que se cargan en un dominio de aplicación son distintos del mismo
tipo cargado en otro dominio de aplicación y las instancias de objetos no se comparten
directamente entre los dominios de aplicación. Por ejemplo, cada dominio de aplicación
tiene su propia copia de variables estáticas para estos tipos, y un constructor estático
para un tipo se ejecuta como máximo una vez por dominio de aplicación. Las
implementaciones son gratuitas para proporcionar directivas específicas de
implementación o mecanismos para la creación y destrucción de dominios de
aplicación.

El inicio de la aplicación se produce cuando el entorno de ejecución llama a un método

designado, al que se hace referencia como punto de entrada de la aplicación. Este
método de punto de entrada siempre se denomina Main y puede tener una de las
firmas siguientes:

C#

static void Main() {...}

static void Main(string[] args) {...}

static int Main() {...}

static int Main(string[] args) {...}

Como se muestra, el punto de entrada puede devolver opcionalmente un int valor.

Este valor devuelto se usa en la finalización de la aplicación (finalizaciónde la aplicación).

El punto de entrada puede tener opcionalmente un parámetro formal. El parámetro

puede tener cualquier nombre, pero el tipo del parámetro debe ser string[] . Si el
parámetro formal está presente, el entorno de ejecución crea y pasa un string[]
argumento que contiene los argumentos de la línea de comandos que se especificaron
al iniciarse la aplicación. El string[] argumento nunca es null, pero puede tener una
longitud de cero si no se especificó ningún argumento de línea de comandos.

Dado que C# admite la sobrecarga de métodos, una clase o un struct pueden contener
varias definiciones de algún método, siempre que cada una tenga una firma diferente.
Sin embargo, dentro de un único programa, ninguna clase o struct puede contener más
de un método denominado Main cuya definición lo califique como punto de entrada de
la aplicación. No obstante, se permiten otras versiones sobrecargadas de, Main siempre
que tengan más de un parámetro, o su único parámetro sea distinto del tipo string[] .

Una aplicación puede estar formada por varias clases o Structs. Es posible que más de
una de estas clases o Structs contengan un método denominado Main cuya definición
sea apta para su uso como punto de entrada de la aplicación. En estos casos, se debe
usar un mecanismo externo (como una opción del compilador de línea de comandos)
para seleccionar uno de estos Main métodos como punto de entrada.

En C#, cada método se debe definir como miembro de una clase o struct. Normalmente,
la accesibilidad declarada (accesibilidad declarada) de un método viene determinada
por los modificadores de acceso (modificadores de acceso) especificados en su
declaración y, de igual forma, la accesibilidad declarada de un tipo viene determinada
por los modificadores de acceso especificados en su declaración. Para que se pueda
llamar a un método dado de un tipo determinado, tanto el tipo como el miembro
deben ser accesibles. Sin embargo, el punto de entrada de la aplicación es un caso
especial. En concreto, el entorno de ejecución puede tener acceso al punto de entrada
de la aplicación, independientemente de su accesibilidad declarada y sin tener en
consideración la accesibilidad declarada de sus declaraciones de tipos envolventes.

Es posible que el método de punto de entrada de la aplicación no esté en una

declaración de clase genérica.

En todos los demás aspectos, los métodos de punto de entrada se comportan como los
que no son puntos de entrada.

Finalización de aplicaciones
La finalización de la aplicación devuelve el control al entorno de ejecución.

Si el tipo de valor devuelto del método de punto de entrada* de la aplicación es int ,

el valor devuelto actúa como el código de estado de terminación _ * de la aplicación * *.
El propósito de este código es permitir la comunicación de éxito o error en el entorno
de ejecución.

Si el tipo de valor devuelto del método de punto de entrada es void , al alcanzar la llave
de } cierre () que finaliza ese método, o la ejecución de una return instrucción que no
tiene ninguna expresión, da como resultado un código de estado de finalización de 0 .

Antes de la finalización de una aplicación, se llama a los destructores para todos sus
objetos que todavía no se han recolectado como elemento no utilizado, a menos que se
haya suprimido dicha limpieza (por ejemplo, mediante una llamada al método de
biblioteca GC.SuppressFinalize ).

Declaraciones
Las declaraciones de un programa de C# definen los elementos constituyentes del
programa. Los programas de C# se organizan mediante espacios de nombres
(espaciosde nombres), que pueden contener declaraciones de tipos y declaraciones de
espacio de nombres anidadas. Las declaraciones de tipos (declaraciones de tipo) se
utilizan para definir clases (clases), Structs (Structs), interfaces (interfaces),
enumeraciones (enumeraciones) y delegados (delegados). Los tipos de miembros
permitidos en una declaración de tipo dependen del formulario de la declaración de
tipos. Por ejemplo, las declaraciones de clase pueden contener declaraciones de
constantes (constantes). campos (campos), métodos (métodos), propiedades
(propiedades), eventos (eventos), indexadores (indizadores), operadores (operadores),
constructores de instancias (constructores de instancias), constructores estáticos
(constructores estáticos), destructores (destructores) y tipos anidados (tipos anidados).

Una declaración define un nombre en el espacio de declaración al que pertenece la

declaración. A excepción de los miembros sobrecargados (firmas y sobrecarga), es un
error en tiempo de compilación tener dos o más declaraciones que introducen
miembros con el mismo nombre en un espacio de declaración. Nunca es posible que un
espacio de declaración contenga distintos tipos de miembros con el mismo nombre. Por
ejemplo, un espacio de declaración nunca puede contener un campo y un método con
el mismo nombre.

Hay varios tipos diferentes de espacios de declaración, como se describe a continuación.

En todos los archivos de código fuente de un programa,

namespace_member_declaration s sin namespace_declaration de inclusión son
miembros de un único espacio de declaración combinado denominado espacio de
declaración global.
Dentro de todos los archivos de código fuente de un programa,
namespace_member_declaration s dentro de namespace_declaration s que tienen el
mismo nombre de espacio de nombres completo son miembros de un solo
espacio de declaración combinado.
Cada declaración de clase, struct o interfaz crea un nuevo espacio de declaración.
Los nombres se introducen en este espacio de declaración a través de
class_member_declaration s, struct_member_declaration s,
interface_member_declaration s o type_parameter s. A excepción de las
declaraciones de constructor de instancia sobrecargadas y las declaraciones de
constructor estático, una clase o struct no puede contener una declaración de
miembro con el mismo nombre que la clase o la estructura. Una clase, estructura o
interfaz permite la declaración de métodos sobrecargados e indexadores. Además,
una clase o struct permite la declaración de constructores de instancia
sobrecargados y operadores. Por ejemplo, una clase, un struct o una interfaz
pueden contener varias declaraciones de método con el mismo nombre, siempre
que estas declaraciones de método difieran en su firma (firmas y sobrecarga).
Tenga en cuenta que las clases base no contribuyen al espacio de declaración de
una clase, y las interfaces base no contribuyen al espacio de declaración de una
interfaz. Por lo tanto, una clase derivada o una interfaz pueden declarar un
miembro con el mismo nombre que un miembro heredado. Este miembro se dice
que oculta el miembro heredado.
Cada declaración de delegado crea un nuevo espacio de declaración. Los nombres
se introducen en este espacio de declaración a través de parámetros formales
(fixed_parameter s y parameter_array s) y type_parameter s.
Cada declaración de enumeración crea un nuevo espacio de declaración. Los
nombres se introducen en este espacio de declaración a través de
enum_member_declarations.
Cada declaración de método, declaración de indexador, declaración de operador,
declaración de constructor de instancia y función anónima crea un nuevo espacio
de declaración denominado *espacio de declaración de variable local. Los
nombres se introducen en este espacio de declaración a través de los parámetros
formales (_fixed_parameter * s y parameter_array s) y type_parameter s. El cuerpo
del miembro de función o de la función anónima, si existe, se considera anidado
dentro del espacio de declaración de la variable local. Es un error que un espacio
de declaración de variable local y un espacio de declaración de variable local
anidada contengan elementos con el mismo nombre. Por lo tanto, dentro de un
espacio de declaración anidado no es posible declarar una variable o constante
local con el mismo nombre que una variable o constante local en un espacio de
declaración de inclusión. Es posible que dos espacios de declaración contengan
 elementos con el mismo nombre siempre y cuando ningún espacio de declaración
contenga el otro.
Cada bloque o switch_block , así como una instrucción for, foreach y using , crea un
espacio de declaración de variable local para las variables locales y las constantes
locales. Los nombres se introducen en este espacio de declaración a través de
local_variable_declaration s y local_constant_declaration s. Tenga en cuenta que los
bloques que se producen como o dentro del cuerpo de un miembro de función o
de una función anónima están anidados dentro del espacio de declaración de
variable local declarado por esas funciones para sus parámetros. Por lo tanto, es un
error tener, por ejemplo, un método con una variable local y un parámetro con el
mismo nombre.
Cada bloque o switch_block crea un espacio de declaración independiente para las
etiquetas. Los nombres se introducen en este espacio de declaración a través de
labeled_statement s y se hace referencia a los nombres a través de goto_statement
s. El espacio de declaración de etiqueta de un bloque incluye cualquier bloque
anidado. Por lo tanto, dentro de un bloque anidado no es posible declarar una
etiqueta con el mismo nombre que una etiqueta en un bloque de inclusión.

El orden textual en el que se declaran los nombres no suele ser significativo. En

concreto, el orden textual no es significativo para la declaración y el uso de espacios de
nombres, constantes, métodos, propiedades, eventos, indizadores, operadores,
constructores de instancias, destructores, constructores estáticos y tipos. El orden de
declaración es significativo de las siguientes maneras:

El orden de declaración de las declaraciones de campo y las declaraciones de

variables locales determina el orden en que se ejecutan sus inicializadores (si
existen).
Las variables locales deben definirse antes de que se usen (ámbitos).
El orden de declaración para las declaraciones de miembros de enumeración
(miembros de enumeración) es importante cuando se omiten los valores de
constant_expression .

El espacio de declaración de un espacio de nombres es "Open Terminated" y dos

declaraciones de espacios de nombres con el mismo nombre completo contribuyen al
mismo espacio de declaración. Por ejemplo

C#

namespace Megacorp.Data

class Customer

...

namespace Megacorp.Data

class Order

...

Las dos declaraciones de espacio de nombres anteriores contribuyen al mismo espacio

de declaración; en este caso, se declaran dos clases con los nombres completos
Megacorp.Data.Customer y Megacorp.Data.Order . Dado que las dos declaraciones

contribuyen al mismo espacio de declaración, habría producido un error en tiempo de

compilación si cada una de ellas contenía una declaración de una clase con el mismo
nombre.

Tal y como se especificó anteriormente, el espacio de declaración de un bloque incluye

cualquier bloque anidado. Por lo tanto, en el ejemplo siguiente, los F G métodos y
generan un error en tiempo de compilación porque el nombre i se declara en el
bloque exterior y no se puede volver a declarar en el bloque interno. Sin embargo, H los
I métodos y son válidos, ya que los dos i se declaran en bloques independientes no
anidados.

C#

class A

void F() {

int i = 0;

if (true) {

int i = 1;

void G() {

if (true) {

int i = 0;

int i = 1;

void H() {

if (true) {

int i = 0;

if (true) {

int i = 1;

void I() {

for (int i = 0; i < 10; i++)

H();

for (int i = 0; i < 10; i++)

H();

Miembros
Los espacios de nombres y los tipos tienen miembros. Los miembros de una entidad
están disponibles con carácter general a través del uso de un nombre completo que
empieza por una referencia a la entidad, seguido de un . token "", seguido del nombre
del miembro.

Los miembros de un tipo se declaran en la declaración de tipos o se heredan de la clase

base del tipo. Cuando un tipo hereda de una clase base, todos los miembros de la clase
base, excepto los constructores de instancia, destructores y constructores estáticos, se
convierten en miembros del tipo derivado. La accesibilidad declarada de un miembro de
clase base no controla si el miembro se hereda (la herencia se extiende a cualquier
miembro que no sea un constructor de instancia, un constructor estático o un
destructor). Sin embargo, es posible que no se pueda obtener acceso a un miembro
heredado en un tipo derivado, ya sea debido a su accesibilidad declarada (accesibilidad
declarada) o porque está oculta por una declaración en el propio tipo (ocultando a
travésde la herencia).

Miembros del espacio de nombres

Los espacios de nombres y los tipos que no tienen ningún espacio de nombres
envolvente son miembros del espacio de nombres global. Se corresponde directamente
con los nombres declarados en el espacio de declaración global.

Los espacios de nombres y los tipos declarados dentro de un espacio de nombres son
miembros de ese espacio de nombres. Esto corresponde directamente a los nombres
declarados en el espacio de declaración del espacio de nombres.

Los espacios de nombres no tienen restricciones de acceso. No es posible declarar

espacios de nombres privados, protegidos o internos, y los nombres de los espacios de
nombres siempre son accesibles públicamente.
Miembros de estructuras
Los miembros de un struct son los miembros declarados en la estructura y los miembros
heredados de la clase base directa de la estructura System.ValueType y la clase base
indirecta object .

Los miembros de un tipo simple se corresponden directamente con los miembros del
tipo de struct con alias del tipo simple:

Los miembros de sbyte son los miembros de la System.SByte estructura.

Los miembros de byte son los miembros de la System.Byte estructura.
Los miembros de short son los miembros de la System.Int16 estructura.
Los miembros de ushort son los miembros de la System.UInt16 estructura.
Los miembros de int son los miembros de la System.Int32 estructura.
Los miembros de uint son los miembros de la System.UInt32 estructura.
Los miembros de long son los miembros de la System.Int64 estructura.
Los miembros de ulong son los miembros de la System.UInt64 estructura.
Los miembros de char son los miembros de la System.Char estructura.
Los miembros de float son los miembros de la System.Single estructura.
Los miembros de double son los miembros de la System.Double estructura.
Los miembros de decimal son los miembros de la System.Decimal estructura.
Los miembros de bool son los miembros de la System.Boolean estructura.

Miembros de enumeración
Los miembros de una enumeración son las constantes declaradas en la enumeración y
los miembros heredados de la clase base directa de la enumeración System.Enum y las
clases base indirectas System.ValueType y object .

Miembros de clase
Los miembros de una clase son los miembros declarados en la clase y los miembros
heredados de la clase base (excepto para la clase object que no tiene clase base). Los
miembros heredados de la clase base incluyen las constantes, campos, métodos,
propiedades, eventos, indizadores, operadores y tipos de la clase base, pero no los
constructores de instancias, destructores y constructores estáticos de la clase base. Los
miembros de clase base se heredan sin tener en cuenta su accesibilidad.

Una declaración de clase puede contener declaraciones de constantes, campos,

métodos, propiedades, eventos, indizadores, operadores, constructores de instancias,
destructores, constructores estáticos y tipos.

Los miembros de object y string corresponden directamente a los miembros de los

tipos de clase a los que se les ha contorno:

Los miembros de object son los miembros de la System.Object clase.

Los miembros de string son los miembros de la System.String clase.

Miembros de interfaz
Los miembros de una interfaz son los miembros declarados en la interfaz y en todas las
interfaces base de la interfaz. Los miembros de la clase object no son, estrictamente
hablando, miembros de cualquier interfaz (miembros de lainterfaz). Sin embargo, los
miembros de la clase object están disponibles a través de la búsqueda de miembros en
cualquier tipo de interfaz (búsqueda de miembros).

Miembros de la matriz
Los miembros de una matriz son los miembros heredados de la clase System.Array .

Miembros de delegado
Los miembros de un delegado son los miembros heredados de la clase System.Delegate
.

Acceso a miembros
Las declaraciones de miembros permiten el control sobre el acceso a miembros. La
accesibilidad de un miembro se establece mediante la accesibilidad declarada
(accesibilidad declarada) del miembro combinado con la accesibilidad del tipo
contenedor inmediato, si existe.

Cuando se permite el acceso a un miembro determinado, se dice que el miembro es

*accesible _. Por el contrario, cuando no se permite el acceso a un miembro
determinado, se dice que el miembro es _ inaccesible *. Se permite el acceso a un
miembro cuando la ubicación textual en la que tiene lugar el acceso se incluye en el
dominio de accesibilidad (dominios de accesibilidad) del miembro.

Accesibilidad declarada
La accesibilidad declarada de un miembro puede ser una de las siguientes:

Público, que se selecciona mediante la inclusión public de un modificador en la

declaración de miembro. El significado intuitivo de public es "acceso no limitado".
Protected, que se selecciona mediante protected la inclusión de un modificador
en la declaración de miembro. El significado intuitivo de protected es "acceso
limitado a la clase contenedora o a los tipos derivados de la clase contenedora".
Internal, que se selecciona mediante la inclusión internal de un modificador en la
declaración de miembro. El significado intuitivo de internal es "acceso limitado a
este programa".
Protected internal (es decir, Protected o Internal), que se selecciona mediante la
inclusión de protected y un internal modificador en la declaración de miembro.
El significado intuitivo de protected internal es "acceso limitado a este programa
o tipos derivados de la clase contenedora".
Private, que se selecciona incluyendo un private modificador en la declaración de
miembro. El significado intuitivo de private es "acceso limitado al tipo
contenedor".

Dependiendo del contexto en el que tenga lugar una declaración de miembro, solo se
permiten determinados tipos de accesibilidad declarada. Además, cuando una
declaración de miembro no incluye modificadores de acceso, el contexto en el que se
produce la declaración determina la accesibilidad declarada predeterminada.

Los espacios de nombres han declarado implícitamente la public accesibilidad. No

se permiten modificadores de acceso en las declaraciones de espacio de nombres.
Los tipos declarados en unidades de compilación o espacios de nombres pueden
tener public o internal declarar accesibilidad y de forma predeterminada como
internal accesibilidad declarada.

Los miembros de clase pueden tener cualquiera de los cinco tipos de accesibilidad
declarada y tienen como valor predeterminado la private accesibilidad declarada.
(Tenga en cuenta que un tipo declarado como miembro de una clase puede tener
cualquiera de los cinco tipos de accesibilidad declarada, mientras que un tipo
declarado como miembro de un espacio de nombres solo puede tener public o
internal declarar accesibilidad).
Los miembros de struct pueden tener public , internal o la private accesibilidad
declarada y tienen como valor predeterminado la private accesibilidad declarada
porque los Structs están sellados implícitamente. Los miembros de estructura
introducidos en un struct (es decir, no heredados por ese struct) no pueden tener
protected o protected internal declarar accesibilidad. (Tenga en cuenta que un
tipo declarado como miembro de un struct puede tener public , internal o la
 private accesibilidad declarada, mientras que un tipo declarado como miembro

de un espacio de nombres solo puede tener public o internal declarar

accesibilidad).
Los miembros de interfaz han declarado de forma implícita la public accesibilidad.
No se permiten modificadores de acceso en las declaraciones de miembros de
interfaz.
Los miembros de enumeración han declarado implícitamente la public
accesibilidad. No se permiten modificadores de acceso en las declaraciones de
miembros de enumeración.

Dominios de accesibilidad
El dominio de accesibilidad* de un miembro se compone de las secciones
(posiblemente disjuntos) del texto del programa en el que se permite el acceso al
miembro. A efectos de definir el dominio de accesibilidad de un miembro, se dice que
un miembro es de nivel superior si no se declara dentro de un tipo, y se dice que un
miembro está anidado si se declara dentro de otro tipo. Además, el texto del programa
de un programa se define como todo el texto del programa contenido en todos los
archivos de código fuente del programa, y el texto del programa de un tipo se define
como todo el texto del programa incluido en el _type_declaration * s de ese tipo
(incluidos, posiblemente, los tipos anidados dentro del tipo).

El dominio de accesibilidad de un tipo predefinido (como object , int o double ) es

ilimitado.

El dominio de accesibilidad de un tipo sin enlazar de nivel superior T (tipos enlazados y

sin enlazar) que se declara en un programa P se define de la manera siguiente:

Si la accesibilidad declarada de T es public , el dominio de accesibilidad de T es

el texto de programa de P y cualquier programa al que haga referencia P .
Si la accesibilidad declarada de T es internal , el dominio de accesibilidad de T es
el texto de programa de P .

A partir de estas definiciones, sigue que el dominio de accesibilidad de un tipo sin

enlazar de nivel superior siempre es al menos el texto del programa del programa en el
que se declara ese tipo.

El dominio de accesibilidad de un tipo construido T<A1, ..., An> es la intersección del

dominio de accesibilidad del tipo genérico sin enlazar T y los dominios de accesibilidad
de los argumentos de tipo A1, ..., An .
El dominio de accesibilidad de un miembro anidado M declarado en un tipo T dentro
de un programa P se define de la manera siguiente (teniendo en cuenta que M , por lo
tanto, puede ser un tipo):

Si la accesibilidad declarada de M es public , el dominio de accesibilidad de M es el

dominio de accesibilidad de T .
Si la accesibilidad declarada de M es protected internal , permita que D sea la
Unión del texto del programa de P y el texto del programa de cualquier tipo
derivado de T , que se declara fuera de P . El dominio de accesibilidad de M es la
intersección del dominio de accesibilidad de T con D .
Si la accesibilidad declarada de M es protected , permita que D sea la Unión del
texto del programa de T y el texto del programa de cualquier tipo derivado de T .
El dominio de accesibilidad de M es la intersección del dominio de accesibilidad de
T con D .

Si la accesibilidad declarada de M es internal , el dominio de accesibilidad de M es

la intersección del dominio de accesibilidad de T con el texto de programa de P .
Si la accesibilidad declarada de M es private , el dominio de accesibilidad de M es
el texto de programa de T .

A partir de estas definiciones, sigue que el dominio de accesibilidad de un miembro

anidado siempre es al menos el texto del programa del tipo en el que se declara el
miembro. Además, sigue que el dominio de accesibilidad de un miembro nunca es más
inclusivo que el dominio de accesibilidad del tipo en el que se declara el miembro.

En términos intuitivos, cuando se tiene acceso a un tipo o miembro M , se evalúan los

pasos siguientes para asegurarse de que se permite el acceso:

En primer lugar, si M se declara dentro de un tipo (en lugar de una unidad de

compilación o un espacio de nombres), se produce un error en tiempo de
compilación si ese tipo no es accesible.
Después, si M es public , se permite el acceso.
De lo contrario, si M es protected internal , se permite el acceso si se produce en
el programa en el que M se declara, o si se produce dentro de una clase derivada
de la clase en la que M se declara y tiene lugar a través del tipo de clase derivada
(acceso protegido para miembros de instancia).
De lo contrario, si M es protected , se permite el acceso si se produce dentro de la
clase en la que M se declara, o si se produce en una clase derivada de la clase en la
que M se declara y tiene lugar a través del tipo de clase derivada (acceso protegido
para miembros de instancia).
 De lo contrario, si M es internal , se permite el acceso si se produce en el
programa en el que M se declara.
De lo contrario, si M es private , se permite el acceso si se produce dentro del tipo
en el que M se declara.
De lo contrario, no se puede obtener acceso al tipo o miembro y se produce un
error en tiempo de compilación.

En el ejemplo

C#

public class A

public static int X;

internal static int Y;

private static int Z;

internal class B

public static int X;

internal static int Y;

private static int Z;

public class C

public static int X;

internal static int Y;

private static int Z;

private class D

public static int X;

internal static int Y;

private static int Z;

las clases y los miembros tienen los siguientes dominios de accesibilidad:

El dominio de accesibilidad de A y A.X es ilimitado.

El dominio de accesibilidad de A.Y , B , B.X , B.Y , B.C , B.C.X y B.C.Y es el texto
del programa que lo contiene.
El dominio de accesibilidad de A.Z es el texto de programa de A .
El dominio de accesibilidad de B.Z y B.D es el texto de programa de B , incluido
el texto del programa de B.C y B.D .
El dominio de accesibilidad de B.C.Z es el texto de programa de B.C .
 El dominio de accesibilidad de B.D.X y B.D.Y es el texto de programa de B ,
incluido el texto del programa de B.C y B.D .
El dominio de accesibilidad de B.D.Z es el texto de programa de B.D .

Como se muestra en el ejemplo, el dominio de accesibilidad de un miembro nunca es

mayor que el de un tipo contenedor. Por ejemplo, aunque todos los X miembros tienen
una accesibilidad declarada pública, todos pero A.X tienen dominios de accesibilidad
que están restringidos por un tipo contenedor.

Como se describe en miembros, todos los miembros de una clase base, excepto los
constructores de instancias, destructores y constructores estáticos, los heredan los tipos
derivados. Esto incluye incluso miembros privados de una clase base. Sin embargo, el
dominio de accesibilidad de un miembro privado incluye solo el texto del programa del
tipo en el que se declara el miembro. En el ejemplo

C#

class A

int x;

static void F(B b) {

b.x = 1; // Ok

class B: A

static void F(B b) {

b.x = 1; // Error, x not accessible

la B clase hereda el miembro privado x de la A clase. Dado que el miembro es privado,

solo es accesible dentro del class_body de A . Por lo tanto, el acceso a se b.x realiza
correctamente en el A.F método, pero se produce un error en el B.F método.

Acceso protegido para miembros de instancia

Cuando se protected tiene acceso a un miembro de instancia fuera del texto del
programa de la clase en la que se declara, y cuando se protected internal tiene acceso
a un miembro de instancia fuera del texto del programa en el que se declara, el acceso
debe realizarse dentro de una declaración de clase que deriva de la clase en la que se
declara. Además, el acceso debe realizarse a través de una instancia de ese tipo de clase
derivada o de un tipo de clase construido a partir de él. Esta restricción evita que una
clase derivada tenga acceso a miembros protegidos de otras clases derivadas, incluso
cuando los miembros se heredan de la misma clase base.

Supongamos B que es una clase base que declara un miembro M de instancia

protegido y que D es una clase que deriva de B . En el class_body de D , el acceso a M
puede adoptar uno de los siguientes formatos:

Type_name o primary_expression no calificados del formulario M .

Primary_expression del formulario E.M , siempre que el tipo de E sea T o una
clase derivada de T , donde T es el tipo de clase D o un tipo de clase construido a
partir de D
Primary_expression del formulario base.M .

Además de estas formas de acceso, una clase derivada puede tener acceso a un
constructor de instancia protegido de una clase base en un constructor_initializer
(inicializadores de constructor).

En el ejemplo

C#

public class A

protected int x;

static void F(A a, B b) {

a.x = 1; // Ok

b.x = 1; // Ok

public class B: A

static void F(A a, B b) {

a.x = 1; // Error, must access through instance of B

b.x = 1; // Ok

dentro de A , es posible obtener acceso x a través de instancias de A y B , ya que en

cualquier caso el acceso se realiza a través de una instancia de A o una clase derivada
de A . Sin embargo, en B , no es posible obtener acceso x a través de una instancia de
A , ya que no se A deriva de B .

En el ejemplo
 C#

class C<T>

protected T x;

class D<T>: C<T>

static void F() {

D<T> dt = new D<T>();

D<int> di = new D<int>();

D<string> ds = new D<string>();

dt.x = default(T);

di.x = 123;

ds.x = "test";

las tres asignaciones a x se permiten porque todas tienen lugar a través de instancias
de tipos de clase construidas a partir del tipo genérico.

Restricciones de accesibilidad
Varias construcciones del lenguaje C# requieren que un tipo sea al menos tan accesible
como miembro u otro tipo. Se dice que un tipo T es al menos tan accesible como
miembro o tipo M si el dominio de accesibilidad de T es un supraconjunto del dominio
de accesibilidad de M . En otras palabras, T es al menos tan accesible como M si T es
accesible en todos los contextos en los que M es accesible.

Existen las siguientes restricciones de accesibilidad:

La clase base directa de un tipo de clase debe ser al menos igual de accesible que
el propio tipo de clase.
Las interfaces base explícitas de un tipo de interfaz deben ser al menos igual de
accesibles que el propio tipo de interfaz.
El tipo de valor devuelto y los tipos de parámetros de un tipo de delegado deben
ser al menos igual de accesibles que el propio tipo de delegado.
El tipo de una constante debe ser al menos igual de accesible que la propia
constante.
El tipo de un campo debe ser al menos igual de accesible que el propio campo.
El tipo de valor devuelto y los tipos de parámetros de un método deben ser al
menos igual de accesibles que el propio método.
El tipo de una propiedad debe ser al menos igual de accesible que la misma
propiedad.
 El tipo de un evento debe ser al menos igual de accesible que el propio evento.
Los tipos de parámetro y el tipo de un indexador deben ser al menos igual de
accesibles que el propio indexador.
El tipo de valor devuelto y los tipos de parámetro de un operador deben ser al
menos igual de accesibles que el propio operador.
Los tipos de parámetro de un constructor de instancia deben ser al menos tan
accesibles como el propio constructor de instancia.

En el ejemplo

C#

class A {...}

public class B: A {...}

la B clase produce un error en tiempo de compilación porque A no es al menos tan

accesible como B .

Del mismo modo, en el ejemplo

C#

class A {...}

public class B

A F() {...}

internal A G() {...}

public A H() {...}

el H método en B produce un error en tiempo de compilación porque el tipo de valor

devuelto A no es al menos tan accesible como el método.

Firmas y sobrecarga
Los métodos, los constructores de instancia, los indizadores y los operadores se
caracterizan por sus firmas:

La firma de un método consta del nombre del método, el número de parámetros

de tipo y el tipo y la clase (valor, referencia o salida) de cada uno de sus
parámetros formales, que se considera en el orden de izquierda a derecha. Para
 estos propósitos, cualquier parámetro de tipo del método que se produce en el
tipo de un parámetro formal se identifica no por su nombre, sino por su posición
ordinal en la lista de argumentos de tipo del método. La firma de un método no
incluye específicamente el tipo de valor devuelto, el params modificador que se
puede especificar para el parámetro situado más a la derecha, ni las restricciones
de parámetro de tipo opcionales.
La firma de un constructor de instancia consta del tipo y el tipo (valor, referencia o
salida) de cada uno de sus parámetros formales, considerados en el orden de
izquierda a derecha. La firma de un constructor de instancia no incluye
específicamente el params modificador que se puede especificar para el parámetro
situado más a la derecha.
La firma de un indexador consta del tipo de cada uno de sus parámetros formales,
que se considera en el orden de izquierda a derecha. La firma de un indexador no
incluye específicamente el tipo de elemento, ni incluye el params modificador que
se puede especificar para el parámetro situado más a la derecha.
La firma de un operador consta del nombre del operador y el tipo de cada uno de
sus parámetros formales, considerados en el orden de izquierda a derecha. La
firma de un operador no incluye específicamente el tipo de resultado.

Las firmas son el mecanismo de habilitación para la sobrecarga de miembros en clases,

Structs e interfaces:

La sobrecarga de métodos permite a una clase, estructura o interfaz declarar varios

métodos con el mismo nombre, siempre que sus firmas sean únicas dentro de esa
clase, estructura o interfaz.
La sobrecarga de constructores de instancia permite a una clase o struct declarar
varios constructores de instancia, siempre que sus firmas sean únicas dentro de
esa clase o estructura.
La sobrecarga de indexadores permite a una clase, estructura o interfaz declarar
varios indexadores, siempre que sus firmas sean únicas dentro de esa clase,
estructura o interfaz.
La sobrecarga de los operadores permite a una clase o struct declarar varios
operadores con el mismo nombre, siempre que sus firmas sean únicas dentro de
esa clase o estructura.

Aunque out ref los modificadores de parámetro y se consideran parte de una firma,
los miembros declarados en un tipo único no pueden diferir en la firma únicamente en
ref y out . Se produce un error en tiempo de compilación si dos miembros se declaran

en el mismo tipo con firmas que serían iguales si todos los parámetros de ambos
métodos con out Modificadores se cambiaran a ref modificadores. Para otros
propósitos de coincidencia de la firma (por ejemplo, ocultar o reemplazar), ref y out se
consideran parte de la firma y no coinciden entre sí. (Esta restricción consiste en permitir
que los programas de C# se traduzcan fácilmente para ejecutarse en el Common
Language Infrastructure (CLI), que no proporciona una manera de definir métodos que
difieren únicamente en ref y out ).

En el caso de las firmas, los tipos object y dynamic se consideran iguales. Por lo tanto,
los miembros declarados en un tipo único pueden no diferir en la firma únicamente en
object y dynamic .

En el ejemplo siguiente se muestra un conjunto de declaraciones de método

sobrecargado junto con sus firmas.

C#

interface ITest

void F(); // F()

void F(int x); // F(int)

void F(ref int x); // F(ref int)

void F(out int x); // F(out int) error

void F(int x, int y); // F(int, int)

int F(string s); // F(string)

int F(int x); // F(int) error

void F(string[] a); // F(string[])

void F(params string[] a); // F(string[]) error

Tenga en cuenta que todos los ref out modificadores de parámetro y (parámetros de
método) forman parte de una firma. Por lo tanto, F(int) y F(ref int) son firmas
únicas. Sin embargo, F(ref int) y F(out int) no se pueden declarar dentro de la
misma interfaz porque sus firmas difieren únicamente en ref y out . Además, tenga en
cuenta que el tipo de valor devuelto y el params modificador no forman parte de una
firma, por lo que no es posible sobrecargar únicamente en función del tipo de valor
devuelto o de la inclusión o exclusión del params modificador. Como tal, las
declaraciones de los métodos F(int) e F(params string[]) identificados anteriormente
provocan un error en tiempo de compilación.
Ámbitos
El *ámbito _ de un nombre es la región del texto del programa en la que es posible
hacer referencia a la entidad declarada por el nombre sin la calificación del nombre. Los
ámbitos se pueden anidar y un ámbito interno puede volver a declarar el significado de
un nombre desde un ámbito externo (sin embargo, no se quita la restricción impuesta
por las declaraciones que se encuentran dentro de un bloque anidado no es posible
declarar una variable local con el mismo nombre que una variable local en un bloque de
inclusión). A continuación, se dice que el nombre del ámbito externo es _ Hidden* en la
región del texto del programa que abarca el ámbito interno, y el acceso al nombre
exterior solo es posible mediante la calificación del nombre.

El ámbito de un miembro de espacio de nombres declarado por un

namespace_member_declaration (miembros de espacio de nombres) sin ningún
namespace_declaration envolvente es todo el texto del programa.
El ámbito de un miembro de espacio de nombres declarado por una
namespace_member_declaration dentro de una namespace_declaration cuyo
nombre completo es N el namespace_body de cada namespace_declaration cuyo
nombre completo es N o comienza por N , seguido de un punto.
El ámbito del nombre definido por una extern_alias_directive se extiende por las
using_directive s, global_attributes y namespace_member_declaration s de su unidad
de compilación o cuerpo de espacio de nombres que contiene inmediatamente.
Un extern_alias_directive no aporta ningún miembro nuevo al espacio de
declaración subyacente. En otras palabras, una extern_alias_directive no es
transitiva, sino que afecta solo a la unidad de compilación o al cuerpo del espacio
de nombres en el que se produce.
El ámbito de un nombre definido o importado por un using_directive (mediante
directivas) se extiende por los namespace_member_declaration s del
compilation_unit o namespace_body en el que se produce el using_directive . Un
using_directive puede hacer que cero o más nombres de espacio de nombres, tipo
o miembro estén disponibles dentro de un compilation_unit o namespace_body
determinado, pero no aporta ningún miembro nuevo al espacio de declaración
subyacente. En otras palabras, una using_directive no es transitiva sino que solo
afecta al compilation_unit o namespace_body en el que se produce.
El ámbito de un parámetro de tipo declarado por un type_parameter_list en un
class_declaration (declaraciones de clase) es el class_base,
type_parameter_constraints_clause s y class_body de ese class_declaration.
El ámbito de un parámetro de tipo declarado por un type_parameter_list en una
struct_declaration (declaraciones de struct) es el struct_interfaces,
type_parameter_constraints_clause s y struct_body de ese struct_declaration.
El ámbito de un parámetro de tipo declarado por un type_parameter_list en una
interface_declaration (declaraciones de interfaz) es el interface_base,
type_parameter_constraints_clause s y interface_body de ese interface_declaration.
El ámbito de un parámetro de tipo declarado por un type_parameter_list en una
delegate_declaration (declaraciones de delegado) es el return_type,
formal_parameter_list y type_parameter_constraints_clause s de ese
delegate_declaration.
El ámbito de un miembro declarado por un class_member_declaration (cuerpo de
clase) es el class_body en el que se produce la declaración. Además, el ámbito de
un miembro de clase se extiende al class_body de las clases derivadas que se
incluyen en el dominio de accesibilidad (dominios de accesibilidad) del miembro.
El ámbito de un miembro declarado por un struct_member_declaration (miembros
de struct) es el struct_body en el que se produce la declaración.
El ámbito de un miembro declarado por un enum_member_declaration (enumerar
miembros) es el enum_body en el que se produce la declaración.
El ámbito de un parámetro declarado en una method_declaration (métodos) es el
method_body de ese method_declaration.
El ámbito de un parámetro declarado en una indexer_declaration (indizadores) es el
accessor_declarations de ese indexer_declaration.
El ámbito de un parámetro declarado en una operator_declaration (operadores) es
el bloque de ese operator_declaration.
El ámbito de un parámetro declarado en una constructor_declaration (constructores
de instancia) es el constructor_initializer y el bloque de ese constructor_declaration.
El ámbito de un parámetro declarado en una lambda_expression (expresiones de
función anónimas) es el anonymous_function_body de ese lambda_expression
El ámbito de un parámetro declarado en una anonymous_method_expression
(expresiones de función anónimas) es el bloque de ese
anonymous_method_expression.
El ámbito de una etiqueta declarada en un labeled_statement (instrucciones con
etiqueta) es el bloque en el que se produce la declaración.
El ámbito de una variable local declarada en un local_variable_declaration
(declaraciones de variables locales) es el bloque en el que se produce la
declaración.
El ámbito de una variable local declarada en un switch_block de una switch
instrucción (la instrucción switch) es el switch_block.
El ámbito de una variable local declarada en un for_initializer de una for
instrucción (la instrucción for) es el for_initializer, el for_condition, el for_iterator y la
instrucción contenida de la for instrucción.
El ámbito de una constante local declarada en un local_constant_declaration
(declaraciones de constantes locales) es el bloque en el que se produce la
 declaración. Es un error en tiempo de compilación hacer referencia a una
constante local en una posición textual que precede a su constant_declarator.
El ámbito de una variable declarada como parte de un foreach_statement,
using_statement, lock_statement o query_expression viene determinado por la
expansión de la construcción especificada.

Dentro del ámbito de un espacio de nombres, una clase, un struct o un miembro de

enumeración, es posible hacer referencia al miembro en una posición textual que
preceda a la declaración del miembro. Por ejemplo

C#

class A

void F() {

i = 1;

int i = 0;

Aquí, es válido para F que haga referencia a i antes de que se declare.

Dentro del ámbito de una variable local, se trata de un error en tiempo de compilación
para hacer referencia a la variable local en una posición textual que precede al
local_variable_declarator de la variable local. Por ejemplo

C#

class A

int i = 0;

void F() {

i = 1; // Error, use precedes declaration

int i;

i = 2;

void G() {

int j = (j = 1); // Valid

void H() {

int a = 1, b = ++a; // Valid

En el F método anterior, la primera asignación a no hace i referencia específicamente

al campo declarado en el ámbito externo. En su lugar, hace referencia a la variable local
y produce un error en tiempo de compilación porque precede textualmente a la
declaración de la variable. En el G método, el uso de j en el inicializador para la
declaración de j es válido porque el uso no precede al local_variable_declarator. En el H
método, un local_variable_declarator subsiguiente hace referencia correctamente a una
variable local declarada en un local_variable_declarator anterior dentro del mismo
local_variable_declaration.

Las reglas de ámbito de las variables locales están diseñadas para garantizar que el
significado de un nombre usado en un contexto de expresión siempre es el mismo
dentro de un bloque. Si el ámbito de una variable local solo se extiende desde su
declaración hasta el final del bloque, en el ejemplo anterior, la primera asignación se
asignaría a la variable de instancia y la segunda asignación asignaría a la variable local,
lo que posiblemente provocaría errores en tiempo de compilación si las instrucciones
del bloque se reorganizaran posteriormente.

El significado de un nombre dentro de un bloque puede variar en función del contexto

en el que se usa el nombre. En el ejemplo

C#

using System;

class A {}

class Test

static void Main() {

string A = "hello, world";

string s = A; // expression context

Type t = typeof(A); // type context

Console.WriteLine(s); // writes "hello, world"

Console.WriteLine(t); // writes "A"

el nombre A se usa en un contexto de expresión para hacer referencia a la variable local

A y en un contexto de tipo para hacer referencia a la clase A .

Ocultación de nombres
El ámbito de una entidad suele abarcar más texto del programa que el espacio de
declaración de la entidad. En concreto, el ámbito de una entidad puede incluir
declaraciones que introducen nuevos espacios de declaración que contienen entidades
con el mismo nombre. Dichas declaraciones hacen que la entidad original se convierta
en *Hidden _. Por el contrario, se dice que una entidad es _ visible* cuando no está
oculta.

La ocultación de nombres se produce cuando los ámbitos se superponen mediante

anidamiento y cuando los ámbitos se superponen a través de la herencia. En las
secciones siguientes se describen las características de los dos tipos de ocultación.

Ocultar mediante anidamiento

La ocultación de nombres mediante el anidamiento puede producirse como resultado

de anidar espacios de nombres o tipos dentro de los espacios de nombres, como
resultado de anidar tipos dentro de clases o Structs, y como resultado de parámetros y
declaraciones de variables locales.

En el ejemplo

C#

class A

int i = 0;

void F() {

int i = 1;

void G() {

i = 1;

dentro del F método, la variable de instancia i está oculta por la variable local i , pero
dentro del G método i todavía hace referencia a la variable de instancia.

Cuando un nombre de un ámbito interno oculta un nombre en un ámbito externo,

oculta todas las apariciones sobrecargadas de ese nombre. En el ejemplo

C#

class Outer

static void F(int i) {}

 static void F(string s) {}

class Inner

void G() {

F(1); // Invokes Outer.Inner.F

F("Hello"); // Error

static void F(long l) {}

la llamada F(1) invoca el F declarado en Inner porque todas las repeticiones externas
de F están ocultas por la declaración interna. Por la misma razón, la llamada F("Hello")
produce un error en tiempo de compilación.

Ocultar a través de la herencia

La ocultación de nombres a través de la herencia se produce cuando las clases o Structs
declaran nombres que se heredaron de clases base. Este tipo de ocultación de nombres
adopta uno de los siguientes formatos:

Una constante, un campo, una propiedad, un evento o un tipo introducidos en una

clase o struct oculta todos los miembros de clase base con el mismo nombre.
Un método introducido en una clase o struct oculta todos los miembros de clase
base que no son de método con el mismo nombre y todos los métodos de clase
base con la misma firma (nombre de método y número de parámetros,
modificadores y tipos).
Un indizador introducido en una clase o struct oculta todos los indizadores de
clase base con la misma firma (número de parámetros y tipos).

Las reglas que rigen las declaraciones de operador (operadores) hacen imposible que
una clase derivada declare un operador con la misma signatura que un operador en una
clase base. Por lo tanto, los operadores nunca se ocultan entre sí.

Al contrario que ocultar un nombre de un ámbito externo, si se oculta un nombre

accesible desde un ámbito heredado, se genera una advertencia. En el ejemplo

C#

class Base

public void F() {}

 class Derived: Base

public void F() {} // Warning, hiding an inherited name

la declaración de F en Derived produce una advertencia que se va a informar. Ocultar

un nombre heredado no es específicamente un error, ya que esto impedirá la evolución
independiente de las clases base. Por ejemplo, la situación anterior podría haber surgido
debido a que una versión posterior de Base presentó un F método que no estaba
presente en una versión anterior de la clase. Si la situación anterior hubiera sido un
error, cualquier cambio realizado en una clase base en una biblioteca de clases con
versiones independientes podría provocar que las clases derivadas dejen de ser válidas.

La advertencia causada por ocultar un nombre heredado puede eliminarse mediante el

uso del new modificador:

C#

class Base

public void F() {}

class Derived: Base

new public void F() {}

El new modificador indica que F en Derived es "nuevo" y que, en realidad, está

diseñado para ocultar el miembro heredado.

Una declaración de un nuevo miembro oculta un miembro heredado solo dentro del
ámbito del nuevo miembro.

C#

class Base

public static void F() {}

class Derived: Base

new private static void F() {} // Hides Base.F in Derived only

class MoreDerived: Derived

static void G() { F(); } // Invokes Base.F

En el ejemplo anterior, la declaración de F en Derived oculta el F objeto heredado de

Base , pero como el nuevo F en Derived tiene acceso privado, su ámbito no se
extiende a MoreDerived . Por lo tanto, la llamada F() en MoreDerived.G es válida y
llamará a Base.F .

Espacio de nombres y nombres de tipo

Varios contextos de un programa de C# requieren que se especifique un
namespace_name o un type_name .

antlr

namespace_name

: namespace_or_type_name

type_name

: namespace_or_type_name

namespace_or_type_name

: identifier type_argument_list?

| namespace_or_type_name '.' identifier type_argument_list?

| qualified_alias_member

Un namespace_name es un namespace_or_type_name que hace referencia a un espacio

de nombres. Después de la resolución tal y como se describe a continuación, el
namespace_or_type_name de una namespace_name debe hacer referencia a un espacio
de nombres o, de lo contrario, se producirá un error en tiempo de compilación. Ningún
argumento de tipo (argumentos de tipo) puede estar presente en un namespace_name
(solo los tipos pueden tener argumentos de tipo).

Un type_name es un namespace_or_type_name que hace referencia a un tipo. Después

de la resolución tal y como se describe a continuación, el namespace_or_type_name de
una type_name debe hacer referencia a un tipo o, de lo contrario, se producirá un error
en tiempo de compilación.

Si el namespace_or_type_name es un miembro de alias calificado, su significado es como

se describe en calificadores de alias de espacios de nombres. De lo contrario, una
namespace_or_type_name tiene una de las cuatro formas siguientes:
 I

I<A1, ..., Ak>

N.I

N.I<A1, ..., Ak>

donde I es un identificador único, N es un namespace_or_type_name y <A1, ..., Ak>

es un type_argument_list opcional. Si no se especifica ningún type_argument_list ,
considere la posibilidad k de que sea cero.

El significado de un namespace_or_type_name se determina de la manera siguiente:

Si el namespace_or_type_name tiene el formato I o I<A1, ..., Ak> :

Si K es cero y el namespace_or_type_name aparece dentro de una declaración
de método genérico (métodos) y la Declaración incluye un parámetro de tipo
(parámetros de tipo) con el nombre   I , el namespace_or_type_name hace
referencia a ese parámetro de tipo.
De lo contrario, si el namespace_or_type_name aparece dentro de una
declaración de tipos, para cada tipo   T de instancia (el tipo de instancia),
empezando por el tipo de instancia de esa declaración de tipos y continuando
con el tipo de instancia de cada declaración de clase o estructura envolvente (si
existe):
Si K es cero y la declaración de T incluye un parámetro de tipo con el
nombre   I , el namespace_or_type_name hace referencia a ese parámetro de
tipo.
De lo contrario, si el namespace_or_type_name aparece dentro del cuerpo de
la declaración de tipos, T o cualquiera de sus tipos base contiene un tipo
anidado accesible   I con parámetros de nombre y K   tipo, el
namespace_or_type_name hace referencia a ese tipo construido con los
argumentos de tipo especificados. Si hay más de un tipo de este tipo, se
selecciona el tipo declarado en el tipo más derivado. Tenga en cuenta que los
miembros que no son de tipo (constantes, campos, métodos, propiedades,
indizadores, operadores, constructores de instancias, destructores y
constructores estáticos) y miembros de tipo con un número diferente de
parámetros de tipo se omiten al determinar el significado del
namespace_or_type_name.
Si los pasos anteriores no se realizaron correctamente, para cada espacio de
nombres   N , empezando por el espacio de nombres en el que se produce el
namespace_or_type_name , continuando con cada espacio de nombres
envolvente (si existe) y finalizando con el espacio de nombres global, los
siguientes pasos se evalúan hasta que se encuentra una entidad:
 Si K es cero y I es el nombre de un espacio de nombres en   N , entonces:
Si la ubicación donde se produce el namespace_or_type_name se incluye
en una declaración de espacio de nombres para N y la declaración del
espacio de nombres contiene un extern_alias_directive o
using_alias_directive que asocia el nombre   I con un espacio de nombres
o un tipo, el namespace_or_type_name es ambiguo y se produce un error
en tiempo de compilación.
De lo contrario, el namespace_or_type_name hace referencia al espacio de
nombres denominado I en N .
De lo contrario, si N contiene un tipo accesible con   I parámetros de tipo y
nombre K   , entonces:
Si K es cero y la ubicación donde se produce el namespace_or_type_name
se incluye en una declaración de espacio de nombres para N y la
declaración del espacio de nombres contiene un extern_alias_directive o
using_alias_directive que asocia el nombre   I con un espacio de nombres
o un tipo, el namespace_or_type_name es ambiguo y se produce un error
en tiempo de compilación.
De lo contrario, el namespace_or_type_name hace referencia al tipo
construido con los argumentos de tipo especificados.
De lo contrario, si la ubicación donde se produce el namespace_or_type_name
se incluye en una declaración de espacio de nombres para N :
Si K es cero y la declaración del espacio de nombres contiene un
extern_alias_directive o using_alias_directive que asocia el nombre   I con
un espacio de nombres o tipo importado, el namespace_or_type_name
hace referencia a ese espacio de nombres o tipo.
De lo contrario, si los espacios de nombres y las declaraciones de tipos
importados por using_namespace_directive s y using_alias_directive s de la
declaración del espacio de nombres contienen exactamente un tipo
accesible   I K   con parámetros de tipo y nombre, el
namespace_or_type_name hace referencia a ese tipo construido con los
argumentos de tipo especificados.
De lo contrario, si los espacios de nombres y las declaraciones de tipos
importados por using_namespace_directive s y using_alias_directive s de la
declaración del espacio de nombres contienen más de un tipo accesible
con   I parámetros de tipo y nombre K   , el namespace_or_type_name es
ambiguo y se produce un error.
De lo contrario, el namespace_or_type_name es indefinido y se produce un error
en tiempo de compilación.
 De lo contrario, el namespace_or_type_name tiene el formato N.I o el formato
N.I<A1, ..., Ak> . N se resuelve primero como namespace_or_type_name. Si la
resolución de N no es correcta, se produce un error en tiempo de compilación. De
lo contrario, N.I o N.I<A1, ..., Ak> se resuelve de la siguiente manera:
Si K es cero y N hace referencia a un espacio de nombres y N contiene un
espacio de nombres anidado con el nombre I , el namespace_or_type_name
hace referencia a ese espacio de nombres anidado.
De lo contrario, si N hace referencia a un espacio de nombres y N contiene un
tipo accesible   I K   con parámetros de tipo y nombre, el
namespace_or_type_name hace referencia a ese tipo construido con los
argumentos de tipo especificados.
De lo contrario, si N hace referencia a un tipo de clase o struct (posiblemente
construido) y N a cualquiera de sus clases base contiene un tipo accesible
anidado   I K   con parámetros de tipo y nombre, el namespace_or_type_name
hace referencia a ese tipo construido con los argumentos de tipo especificados.
Si hay más de un tipo de este tipo, se selecciona el tipo declarado en el tipo
más derivado. Tenga en cuenta que si el significado de N.I se está
determinando como parte de la resolución de la especificación de clase base de
N , la clase base directa de N se considera objeto (clases base).
De lo contrario, N.I es un namespace_or_type_name no válido y se produce un
error en tiempo de compilación.

Solo se permite que un namespace_or_type_name haga referencia a una clase estática

(clases estáticas) si

La namespace_or_type_name es T en un namespace_or_type_name del formulario

T.I , o

El namespace_or_type_name es T en un typeof_expression (listas de argumentos1)

del formulario typeof(T) .

Nombres completos
Cada espacio de nombres y tipo tiene un nombre completo, que identifica de forma
única el espacio de nombres o el tipo entre todos los demás. El nombre completo de un
espacio de nombres o tipo N se determina de la siguiente manera:

Si N es miembro del espacio de nombres global, su nombre completo es N .

De lo contrario, su nombre completo es S.N , donde S es el nombre completo del
espacio de nombres o tipo en el que N se declara.
En otras palabras, el nombre completo de N es la ruta de acceso jerárquica completa de
los identificadores que conducen a, a partir del N espacio de nombres global. Dado que
cada miembro de un espacio de nombres o tipo debe tener un nombre único, sigue que
el nombre completo de un espacio de nombres o tipo es siempre único.

En el ejemplo siguiente se muestran varias declaraciones de espacio de nombres y tipo

junto con sus nombres completos asociados.

C#

class A {} // A

namespace X // X

class B // X.B

class C {} // X.B.C

namespace Y // X.Y

class D {} // X.Y.D

namespace X.Y // X.Y

class E {} // X.Y.E

Administración de memoria automática

C# emplea la administración automática de la memoria, que libera a los desarrolladores
de la asignación y liberación manuales de la memoria ocupada por los objetos. Las
directivas de administración de memoria automática se implementan mediante un
recolector de elementos no utilizados. El ciclo de vida de la administración de memoria
de un objeto es el siguiente:

1. Cuando se crea el objeto, se le asigna memoria, se ejecuta el constructor y el

objeto se considera activo.
2. Si no se puede tener acceso al objeto, o a cualquier parte del mismo, por cualquier
continuación posible de ejecución, que no sea la ejecución de destructores, el
objeto se considera que ya no está en uso y se puede elegir para su destrucción. El
compilador de C# y el recolector de elementos no utilizados pueden optar por
analizar el código para determinar qué referencias a un objeto se pueden usar en
 el futuro. Por ejemplo, si una variable local que se encuentra en el ámbito es la
única referencia existente a un objeto, pero nunca se hace referencia a esa variable
local en ninguna continuación posible de ejecución del punto de ejecución actual
del procedimiento, el recolector de elementos no utilizados puede (pero no es
necesario) tratar el objeto como ya no está en uso.
3. Una vez que el objeto es válido para la destrucción, en algún momento posterior
no especificado, se ejecuta el destructor(destructores) (si existe) para el objeto. En
circunstancias normales, el destructor del objeto solo se ejecuta una vez, aunque
las API específicas de la implementación pueden permitir que se invalide este
comportamiento.
4. Una vez que se ejecuta el destructor de un objeto, si no se puede tener acceso a
ese objeto o a cualquier parte del mismo, cualquier continuación posible de
ejecución, incluida la ejecución de destructores, el objeto se considera inaccesible
y el objeto pasa a ser válido para la colección.
5. Por último, en algún momento después de que el objeto sea válido para la
recolección, el recolector de elementos no utilizados libera la memoria asociada a
ese objeto.

El recolector de elementos no utilizados mantiene información sobre el uso de los

objetos y usa esta información para tomar decisiones de administración de memoria,
como la ubicación de la memoria para buscar un objeto recién creado, Cuándo se debe
reubicar un objeto y cuándo un objeto ya no está en uso o es inaccesible.

Al igual que otros lenguajes que suponen la existencia de un recolector de elementos

no utilizados, C# está diseñado de modo que el recolector de elementos no utilizados
pueda implementar una amplia gama de directivas de administración de memoria. Por
ejemplo, C# no requiere que se ejecuten destructores o que los objetos se recopilen tan
pronto como sean válidos, o que los destructores se ejecuten en un orden determinado
o en un subproceso determinado.

El comportamiento del recolector de elementos no utilizados puede controlarse, hasta

cierto punto, a través de métodos estáticos en la clase System.GC . Esta clase se puede
usar para solicitar que se produzca una colección, destructores que se van a ejecutar (o
no ejecutar), etc.

Dado que el recolector de elementos no utilizados tiene una latitud ancha a la hora de
decidir cuándo recopilar objetos y ejecutar destructores, una implementación
compatible puede generar resultados que sean diferentes de los que se muestran en el
código siguiente. El programa

C#
 using System;

class A

~A() {

Console.WriteLine("Destruct instance of A");

class B

object Ref;

public B(object o) {

Ref = o;

~B() {

Console.WriteLine("Destruct instance of B");

class Test

static void Main() {

B b = new B(new A());

b = null;

GC.Collect();

GC.WaitForPendingFinalizers();

crea una instancia de la clase A y una instancia de la clase B . Estos objetos son válidos
para la recolección de elementos no utilizados cuando b se asigna el valor a la variable
null , ya que no es posible que ningún código escrito por el usuario tenga acceso a
ellos. El resultado puede ser

Consola

Destruct instance of A

Destruct instance of B

or

Consola

Destruct instance of B

Destruct instance of A

Dado que el lenguaje no impone ninguna restricción en el orden en el que los objetos
se recolectan como elementos no utilizados.

En casos sutiles, la distinción entre "candidato a la destrucción" y "puede ser válida para
la recopilación" puede ser importante. Por ejemplo,

C#

using System;

class A

~A() {

Console.WriteLine("Destruct instance of A");

public void F() {

Console.WriteLine("A.F");
Test.RefA = this;

class B

public A Ref;

~B() {

Console.WriteLine("Destruct instance of B");

Ref.F();

class Test

public static A RefA;

public static B RefB;

static void Main() {

RefB = new B();

RefA = new A();

RefB.Ref = RefA;

RefB = null;

RefA = null;

// A and B now eligible for destruction

GC.Collect();

GC.WaitForPendingFinalizers();

// B now eligible for collection, but A is not

if (RefA != null)

Console.WriteLine("RefA is not null");

En el programa anterior, si el recolector de elementos no utilizados elige ejecutar el

destructor de A antes del destructor de B , el resultado de este programa podría ser:

Consola

Destruct instance of A

Destruct instance of B

A.F

RefA is not null

Tenga en cuenta que aunque la instancia de A no estaba en uso y A se ejecutó el

destructor de, todavía es posible A llamar a los métodos de (en este caso, F ) desde
otro destructor. Además, tenga en cuenta que la ejecución de un destructor puede
hacer que un objeto se pueda utilizar de nuevo desde el programa principal. En este
caso, la ejecución del B destructor de ha provocado que una instancia de A que
anteriormente no estaba en uso sea accesible desde la referencia activa Test.RefA .
Después de la llamada a WaitForPendingFinalizers , la instancia de B es válida para la
recolección, pero la instancia de A no es, debido a la referencia Test.RefA .

Para evitar la confusión y el comportamiento inesperado, suele ser una buena idea que
los destructores solo realicen la limpieza en los datos almacenados en sus propios
campos del objeto y no realicen ninguna acción en los objetos a los que se hace
referencia ni en los campos estáticos.

Una alternativa al uso de destructores es dejar que una clase implemente la

System.IDisposable interfaz. Esto permite al cliente del objeto determinar cuándo
liberar los recursos del objeto, normalmente mediante el acceso al objeto como un
recurso en una using instrucción (la instrucción using).

Orden de ejecución
La ejecución de un programa de C# continúa de tal forma que los efectos secundarios
de cada subproceso en ejecución se conserven en puntos de ejecución críticos. Un
efecto secundario se define como una lectura o escritura de un campo volátil, una
escritura en una variable no volátil, una escritura en un recurso externo y el inicio de una
excepción. Los puntos de ejecución críticos en los que se debe conservar el orden de
estos efectos secundarios son las referencias a campos volátiles (campos volátiles), las
lock instrucciones (instrucción lock) y la creación y terminación de subprocesos. El

entorno de ejecución es gratuito para cambiar el orden de ejecución de un programa de

C#, sujeto a las siguientes restricciones:
La dependencia de los datos se conserva dentro de un subproceso de ejecución. Es
decir, el valor de cada variable se calcula como si todas las instrucciones del
subproceso se ejecutaran en el orden del programa original.
Se conservan las reglas de ordenación de inicialización (inicialización de campos e
inicializadores de variables).
El orden de los efectos secundarios se conserva con respecto a las lecturas y
escrituras volátiles (campos volátiles). Además, el entorno de ejecución no necesita
evaluar parte de una expresión si puede deducir que el valor de esa expresión no
se usa y que no se producen efectos secundarios necesarios (incluidos los
causados por una llamada a un método o el acceso a un campo volátil). Cuando se
interrumpe la ejecución del programa mediante un evento asincrónico (como una
excepción iniciada por otro subproceso), no se garantiza que los efectos
secundarios observables estén visibles en el orden del programa original.
Tipos
Artículo • 16/09/2021 • Tiempo de lectura: 35 minutos

Los tipos del lenguaje C# se dividen en dos categorías principales: tipos de valor _ y
_tipos de referencia*.. Ambos tipos de valor y tipos de referencia pueden ser tipos
genéricos, que toman uno o varios parámetros de tipo _ * * *. Los parámetros de tipo
pueden designar tanto tipos de valor como tipos de referencia.

antlr

type

: value_type

| reference_type

| type_parameter

| type_unsafe

La categoría final de tipos, punteros, solo está disponible en código no seguro. Esto se
describe con más detalle en tipos de puntero.

Los tipos de valor se diferencian de los tipos de referencia en que las variables de los
tipos de valor contienen directamente sus datos, mientras que las variables de los tipos
de referencia almacenan referencias en sus datos, lo que se conoce como "objetos *". Con
los tipos de referencia, es posible que dos variables hagan referencia al mismo objeto y,
por lo tanto, las operaciones en una variable afecten al objeto al que hace referencia la
otra variable. Con los tipos de valor, cada variable tiene su propia copia de los datos y
no es posible que las operaciones en una afecten a la otra.

El sistema de tipos de C# está unificado, de modo que un valor de cualquier tipo se

puede tratar como un objeto. Todos los tipos de C# directa o indirectamente se derivan
del tipo de clase object , y object es la clase base definitiva de todos los tipos. Los
valores de tipos de referencia se tratan como objetos mediante la visualización de los
valores como tipo object . Los valores de los tipos de valor se tratan como objetos
realizando las operaciones de conversión boxing y unboxing (conversión boxing y
conversión unboxing).

Tipos de valor
Un tipo de valor es un tipo de estructura o un tipo de enumeración. C# proporciona un
conjunto de tipos de struct predefinidos denominados tipos simples. Los tipos simples
se identifican mediante palabras reservadas.
antlr

value_type

: struct_type

| enum_type

struct_type

: type_name

| simple_type

| nullable_type

simple_type

: numeric_type

| 'bool'

numeric_type

: integral_type

| floating_point_type

| 'decimal'

integral_type

: 'sbyte'

| 'byte'

| 'short'

| 'ushort'

| 'int'

| 'uint'

| 'long'

| 'ulong'

| 'char'

floating_point_type

: 'float'

| 'double'

nullable_type

: non_nullable_value_type '?'

non_nullable_value_type

: type

enum_type

: type_name

A diferencia de una variable de un tipo de referencia, una variable de un tipo de valor

solo puede contener el valor null si el tipo de valor es un tipo que acepta valores NULL.
Para cada tipo de valor que no acepta valores NULL, hay un tipo de valor que acepta
valores NULL correspondiente que denota el mismo conjunto de valores más el valor
null .

La asignación a una variable de un tipo de valor crea una copia del valor que se va a
asignar. Esto difiere de la asignación a una variable de un tipo de referencia, que copia
la referencia pero no el objeto identificado por la referencia.

Tipo System. ValueType

Todos los tipos de valor heredan implícitamente de la clase System.ValueType , que, a su
vez, hereda de la clase object . No es posible que ningún tipo derive de un tipo de
valor y, por tanto, los tipos de valor están sellados implícitamente (clases selladas).

Tenga en cuenta que System.ValueType no es un value_type. En su lugar, es una

class_type de la que se derivan automáticamente todos los value_type s.

Constructores predeterminados
Todos los tipos de valor declaran implícitamente un constructor de instancia sin
parámetros público denominado *constructor predeterminado _. El constructor
predeterminado devuelve una instancia inicializada en cero, conocida como el valor _
default* para el tipo de valor:

Para todos los Simple_Type s, el valor predeterminado es el valor generado por un

patrón de bits de todos los ceros:
Para sbyte , byte , short , ushort , int , uint , long y ulong , el valor
predeterminado es 0 .
En char , el valor predeterminado es '\x0000' .
En float , el valor predeterminado es 0.0f .
En double , el valor predeterminado es 0.0d .
En decimal , el valor predeterminado es 0.0m .
En bool , el valor predeterminado es false .
Para un enum_type E , el valor predeterminado es 0 , convertido al tipo E .
Para un struct_type, el valor predeterminado es el valor generado al establecer
todos los campos de tipo de valor en sus valores predeterminados y todos los
campos de tipo de referencia en null .
 Para un nullable_type el valor predeterminado es una instancia para la que la
HasValue propiedad es false y la Value propiedad no está definida. El valor
predeterminado también se conoce como el valor null del tipo que acepta valores
NULL.

Al igual que cualquier otro constructor de instancia, el constructor predeterminado de

un tipo de valor se invoca mediante el new operador. Por motivos de eficacia, este
requisito no está diseñado para tener realmente la implementación que genera una
llamada al constructor. En el ejemplo siguiente, las variables i y j se inicializan en cero.

C#

class A

void F() {

int i = 0;

int j = new int();

Dado que cada tipo de valor tiene implícitamente un constructor de instancia sin
parámetros público, no es posible que un tipo de struct contenga una declaración
explícita de un constructor sin parámetros. Sin embargo, se permite que un tipo de
estructura declare constructores de instancia con parámetros (constructores).

Tipos de estructura
Un tipo de estructura es un tipo de valor que puede declarar constantes, campos,
métodos, propiedades, indizadores, operadores, constructores de instancias,
constructores estáticos y tipos anidados. La declaración de tipos de struct se describe en
declaraciones de struct.

Tipos simples
C# proporciona un conjunto de tipos de struct predefinidos denominados tipos simples.
Los tipos simples se identifican mediante palabras reservadas, pero estas palabras
reservadas son simplemente alias para los tipos de struct predefinidos en el System
espacio de nombres, tal como se describe en la tabla siguiente.

Palabra reservada Tipo con alias

sbyte System.SByte
 Palabra reservada Tipo con alias

byte System.Byte

short System.Int16

ushort System.UInt16

int System.Int32

uint System.UInt32

long System.Int64

ulong System.UInt64

char System.Char

float System.Single

double System.Double

bool System.Boolean

decimal System.Decimal

Dado que un tipo simple incluye un alias para un tipo de estructura, cada tipo simple
tiene miembros. Por ejemplo, int tiene los miembros declarados en System.Int32 y los
miembros heredados de System.Object , y se permiten las siguientes instrucciones:

C#

int i = int.MaxValue; // System.Int32.MaxValue constant

string s = i.ToString(); // System.Int32.ToString() instance method

string t = 123.ToString(); // System.Int32.ToString() instance method

Los tipos simples se diferencian de otros tipos struct en que permiten determinadas
operaciones adicionales:

La mayoría de los tipos simples permiten crear valores escribiendo literales

(literales). Por ejemplo, 123 es un literal de tipo int y 'a' es un literal de tipo
char . C# no hace ningún aprovisionamiento de los literales de tipos struct en
general, y los valores no predeterminados de otros tipos struct siempre se crean
en última instancia mediante constructores de instancias de esos tipos de
estructura.
Cuando los operandos de una expresión son constantes de tipo simple, es posible
que el compilador evalúe la expresión en tiempo de compilación. Este tipo de
 expresión se conoce como constant_expression (expresiones constantes). Las
expresiones que implican operadores definidos por otros tipos struct no se
consideran expresiones constantes.
A través const de las declaraciones, es posible declarar constantes de los tipos
simples (constantes). No es posible tener constantes de otros tipos struct, pero los
campos proporcionan un efecto similar static readonly .
Las conversiones que implican tipos simples pueden participar en la evaluación de
operadores de conversión definidos por otros tipos de struct, pero un operador de
conversión definido por el usuario nunca puede participar en la evaluación de otro
operador definido por el usuario (evaluación de conversiones definidas por el
usuario).

Tipos enteros
C# admite nueve tipos enteros: sbyte , byte , short , ushort , int , uint , long , ulong
y char . Los tipos enteros tienen los siguientes tamaños y rangos de valores:

El sbyte tipo representa enteros de 8 bits con signo con valores comprendidos
entre-128 y 127.
El byte tipo representa enteros de 8 bits sin signo con valores comprendidos entre
0 y 255.
El short tipo representa enteros de 16 bits con signo con valores comprendidos
entre-32768 y 32767.
El ushort tipo representa enteros de 16 bits sin signo con valores comprendidos
entre 0 y 65535.
El int tipo representa enteros de 32 bits con signo con valores comprendidos
entre-2147483648 y 2147483647.
El uint tipo representa enteros de 32 bits sin signo con valores comprendidos
entre 0 y 4294967295.
El long tipo representa enteros de 64 bits con signo con valores comprendidos
entre-9223372036854775808 y 9223372036854775807.
El ulong tipo representa enteros de 64 bits sin signo con valores comprendidos
entre 0 y 18446744073709551615.
El char tipo representa enteros de 16 bits sin signo con valores comprendidos
entre 0 y 65535. El conjunto de valores posibles para el tipo char corresponde al
juego de caracteres Unicode. Aunque char tiene la misma representación que
ushort , no todas las operaciones permitidas en un tipo se permiten en el otro.

Los operadores unarios y binarios de tipo entero siempre operan con una precisión de
32 bits con signo, una precisión de 32 bits sin signo, una precisión de 64 con signo o
una precisión de bit 64 sin signo:

En el caso de los operadores unario + y ~ , el operando se convierte al tipo T ,

donde T es el primero de int ,, uint long y ulong que puede representar
completamente todos los valores posibles del operando. La operación se realiza
entonces con la precisión del tipo T y el tipo del resultado es T .
Para el operador unario - , el operando se convierte al tipo T , donde T es el
primero de int y long que puede representar completamente todos los valores
posibles del operando. La operación se realiza entonces con la precisión del tipo T
y el tipo del resultado es T . El operador unario - no se puede aplicar a operandos
de tipo ulong .
En el caso de los operadores binarios + ,,,,,,,,,, - * / % & ^ | == != > , < , y >=
<= , los operandos se convierten al tipo T , donde T es el primero de int , uint ,
y, long ulong que puede representar por completo todos los valores posibles de
ambos operandos. La operación se realiza entonces con la precisión del tipo T y el
tipo del resultado es T (o bool para los operadores relacionales). No se permite
que un operando sea de tipo long y el otro para ser de tipo ulong con los
operadores binarios.
En el caso de los operadores binarios << y >> , el operando izquierdo se convierte
al tipo T , donde T es el primero de int ,, y, uint long ulong que puede
representar completamente todos los valores posibles del operando. La operación
se realiza entonces con la precisión del tipo T y el tipo del resultado es T .

El char tipo se clasifica como un tipo entero, pero difiere de los demás tipos enteros de
dos maneras:

No hay ninguna conversión implícita de otros tipos al tipo char . En concreto,

aunque los sbyte tipos, byte y ushort tienen intervalos de valores que se pueden
representar completamente con el char tipo, las conversiones implícitas de sbyte ,
byte o ushort char no existen.

Las constantes del char tipo deben escribirse como character_literal s o como
integer_literal s en combinación con una conversión al tipo char . Por ejemplo,
(char)10 es lo mismo que '\x000A' .

Los checked unchecked operadores and y las instrucciones se utilizan para controlar la
comprobación de desbordamiento de las operaciones aritméticas de tipo entero y las
conversiones (los operadores Checked y unchecked). En un checked contexto, un
desbordamiento produce un error en tiempo de compilación o provoca
System.OverflowException que se produzca una excepción. En un unchecked contexto,
se omiten los desbordamientos y se descartan los bits de orden superior que no caben
en el tipo de destino.

Tipos de punto flotante

C# admite dos tipos de punto flotante: float y double . Los float double tipos y se
representan mediante los formatos IEEE 754 de precisión sencilla de 32 bits y de doble
precisión de 64 bits, que proporcionan los siguientes conjuntos de valores:

Cero positivo y cero negativo. En la mayoría de los casos, cero positivo y cero
negativo se comportan exactamente igual que el valor cero simple, pero ciertas
operaciones distinguen entre los dos (operador de división).
Infinito positivo y infinito negativo. Los infinitos se generan mediante operaciones
como la división por cero de un número distinto de cero. Por ejemplo, 1.0 / 0.0
produce infinito positivo y -1.0 / 0.0 produce infinito negativo.
El valor no numérico , a menudo abreviado como Nan. Los Nan se generan
mediante operaciones de punto flotante no válidas, como la división de cero por
cero.
El conjunto finito de valores distintos de cero del formulario s * m * 2^e , donde
s es 1 o-1, y m y e vienen determinados por el tipo de punto flotante
determinado: para float , 0 < m < 2^24 y -149 <= e <= 104 , y para double , 0 <
m < 2^53 y -1075 <= e <= 970 . Los números de punto flotante desnormalizados se

consideran valores distintos de cero válidos.

El float tipo puede representar valores comprendidos entre aproximadamente

1.5 * 10^-45 y 3.4 * 10^38 con una precisión de 7 dígitos.

El double tipo puede representar valores comprendidos entre aproximadamente

5.0 * 10^-324 y 1.7 × 10^308 con una precisión de 15-16 dígitos.

Si uno de los operandos de un operador binario es de un tipo de punto flotante, el otro

operando debe ser de un tipo entero o de un tipo de punto flotante, y la operación se
evalúa como sigue:

Si uno de los operandos es de un tipo entero, ese operando se convierte en el tipo

de punto flotante del otro operando.
Después, si alguno de los operandos es de tipo double , el otro operando se
convierte en double , la operación se realiza utilizando al menos el double
intervalo y la precisión, y el tipo del resultado es double (o bool para los
operadores relacionales).
 De lo contrario, la operación se realiza utilizando al menos el float intervalo y la
precisión, y el tipo del resultado es float (o bool para los operadores
relacionales).

Los operadores de punto flotante, incluidos los operadores de asignación, nunca

generan excepciones. En su lugar, en situaciones excepcionales, las operaciones de
punto flotante producen cero, infinito o NaN, como se describe a continuación:

Si el resultado de una operación de punto flotante es demasiado pequeño para el

formato de destino, el resultado de la operación se convierte en cero positivo o
negativo.
Si el resultado de una operación de punto flotante es demasiado grande para el
formato de destino, el resultado de la operación se convierte en infinito positivo o
infinito negativo.
Si una operación de punto flotante no es válida, el resultado de la operación se
convierte en NaN.
Si uno o los dos operandos de una operación de punto flotante son NaN, el
resultado de la operación se convierte en NaN.

Las operaciones de punto flotante se pueden realizar con una precisión mayor que el
tipo de resultado de la operación. Por ejemplo, algunas arquitecturas de hardware
admiten un tipo de punto flotante "extendido" o "Long Double" con un intervalo y una
precisión mayores que el double tipo y realizan implícitamente todas las operaciones de
punto flotante con este tipo de precisión superior. Solo con un costo excesivo en el
rendimiento se pueden realizar estas arquitecturas de hardware para realizar
operaciones de punto flotante con menos precisión y, en lugar de requerir una
implementación para que se pierda rendimiento y precisión, C# permite usar un tipo de
precisión mayor para todas las operaciones de punto flotante. Aparte de ofrecer
resultados más precisos, esto rara vez tiene efectos medibles. Sin embargo, en las
expresiones con el formato x * y / z , donde la multiplicación genera un resultado que
está fuera del double intervalo, pero la división posterior devuelve el resultado temporal
al double intervalo, el hecho de que la expresión se evalúe en un formato de intervalo
más alto puede provocar que se genere un resultado finito en lugar de un infinito.

El tipo decimal
El tipo decimal es un tipo de datos de 128 bits adecuado para cálculos financieros y
monetarios. El decimal tipo puede representar valores comprendidos entre
1.0 * 10^-28 y aproximadamente 7.9 * 10^28 con 28-29 dígitos significativos.
El conjunto finito de valores de tipo decimal tiene el formato (-1)^s * c * 10^-e ,
donde el signo s es 0 o 1, el coeficiente c lo proporciona 0 <= *c* < 2^96 y la escala e
es tal que 0 <= e <= 28 . El decimal tipo no admite ceros con signo, infinitos o Nan. Un
decimal se representa como un entero de 96 bits escalado por una potencia de diez.
Para decimal s con un valor absoluto menor que 1.0m , el valor es exacto hasta la
posición decimal 28, pero no más. Para decimal s con un valor absoluto mayor o igual
que 1.0m , el valor es exacto a 28 o 29 dígitos. Al contrario que float los double tipos
de datos y, los números fraccionarios decimales como 0,1 se pueden representar
exactamente en la decimal representación. En las float double representaciones y,
estos números suelen ser fracciones infinitas, por lo que las representaciones son más
propensas a errores de redondeo.

Si uno de los operandos de un operador binario es de tipo decimal , el otro operando

debe ser de un tipo entero o de tipo decimal . Si hay un operando de tipo entero, se
convierte en decimal antes de que se realice la operación.

El resultado de una operación con valores de tipo decimal es que resultaría de calcular
un resultado exacto (conservando la escala, tal y como se define para cada operador) y,
a continuación, redondear para ajustarse a la representación. Los resultados se
redondean al valor representable más cercano y, cuando un resultado está igualmente
cerca de dos valores representables, al valor que tiene un número par en la posición del
dígito menos significativo (esto se conoce como "redondeo bancario"). Un resultado de
cero siempre tiene un signo de 0 y una escala de 0.

Si una operación aritmética decimal produce un valor menor o igual que 5 * 10^-29 en
valor absoluto, el resultado de la operación se convierte en cero. Si una decimal
operación aritmética genera un resultado que es demasiado grande para el decimal
formato, System.OverflowException se produce una excepción.

El decimal tipo tiene mayor precisión pero menor que los tipos de punto flotante. Por lo
tanto, las conversiones de los tipos de punto flotante a decimal pueden producir
excepciones de desbordamiento, y las conversiones de decimal a los tipos de punto
flotante podrían provocar la pérdida de precisión. Por estos motivos, no existe ninguna
conversión implícita entre los tipos de punto flotante y decimal , y sin conversiones
explícitas, no es posible mezclar los operandos y el punto flotante decimal en la misma
expresión.

Tipo bool
El bool tipo representa las cantidades lógicas booleanas. Los valores posibles de tipo
bool son true y false .

No existe ninguna conversión estándar entre bool y otros tipos. En concreto, el bool
tipo es distinto e independiente de los tipos enteros, y bool no se puede usar un valor
en lugar de un valor entero, y viceversa.

En los lenguajes C y C++, un valor entero o de punto flotante cero, o un puntero nulo se
puede convertir al valor booleano false , y un valor entero distinto de cero o de punto
flotante, o un puntero no nulo se puede convertir al valor booleano true . En C#, estas
conversiones se realizan comparando explícitamente un valor entero o de punto
flotante en cero, o comparando explícitamente una referencia de objeto a null .

Tipos de enumeración
Un tipo de enumeración es un tipo distinto con constantes con nombre. Cada tipo de
enumeración tiene un tipo subyacente, que debe ser byte , sbyte , short , ushort , int
, uint long o ulong . El conjunto de valores del tipo de enumeración es el mismo que
el conjunto de valores del tipo subyacente. Los valores del tipo de enumeración no
están restringidos a los valores de las constantes con nombre. Los tipos de enumeración
se definen mediante declaraciones de enumeración (declaracionesde enumeración).

Tipos que aceptan valores NULL

Un tipo que acepta valores NULL puede representar todos los valores de su tipo
subyacente más un valor null adicional. Se escribe un tipo que acepta valores NULL T? ,
donde T es el tipo subyacente. Esta sintaxis es una abreviatura de System.Nullable<T> y
las dos formas se pueden usar indistintamente.

Un tipo de valor que no acepta valores NULL es un tipo de valor distinto de

System.Nullable<T> y su abreviatura T? (para cualquier T ), además de cualquier

parámetro de tipo restringido para ser un tipo de valor que no acepta valores NULL (es
decir, cualquier parámetro de tipo con una struct restricción). El System.Nullable<T>
tipo especifica la restricción de tipo de valor para T (restricciones de parámetro de tipo),
lo que significa que el tipo subyacente de un tipo que acepta valores NULL puede ser
cualquier tipo de valor que no acepte valores NULL. El tipo subyacente de un tipo que
acepta valores NULL no puede ser un tipo que acepta valores NULL ni un tipo de
referencia. Por ejemplo, int?? y string? son tipos no válidos.

Una instancia de un tipo que acepta valores NULL T? tiene dos propiedades públicas de
solo lectura:
 Una HasValue propiedad de tipo bool
Una Value propiedad de tipo T

Una instancia para la que HasValue es true se dice que no es NULL. Una instancia que
no es null contiene un valor conocido y Value devuelve ese valor.

Una instancia para la que HasValue es false se dice que es NULL. Una instancia null tiene
un valor sin definir. Al intentar leer la Value de una instancia null,
System.InvalidOperationException se produce una excepción. El proceso de acceso a la
Value propiedad de una instancia que acepta valores NULL se conoce como

desencapsulado.

Además del constructor predeterminado, todos los tipos que aceptan valores NULL T?
tienen un constructor público que toma un único argumento de tipo T . Dado un valor
x de tipo T , una invocación del constructor con el formato

C#

new T?(x)

crea una instancia no NULL de T? para la que la Value propiedad es x . El proceso de

creación de una instancia no NULL de un tipo que acepta valores NULL para un valor
determinado se conoce como ajuste.

Las conversiones implícitas están disponibles desde el null literal a T? (conversiones de

literales null) y de T a T? (conversiones implícitas que aceptan valores NULL).

Tipos de referencia
Un tipo de referencia es un tipo de clase, un tipo de interfaz, un tipo de matriz o un tipo
de delegado.

antlr

reference_type

: class_type

| interface_type

| array_type

| delegate_type

class_type

: type_name

| 'object'

 | 'dynamic'

| 'string'

interface_type

: type_name

array_type

: non_array_type rank_specifier+

non_array_type

: type

rank_specifier

: '[' dim_separator* ']'

dim_separator

: ','

delegate_type

: type_name

Un valor de tipo de referencia es una referencia a una *instancia de del tipo, que se
conoce como un objeto _ * * *. El valor especial null es compatible con todos los tipos
de referencia e indica la ausencia de una instancia.

Tipos de clase
Un tipo de clase define una estructura de datos que contiene miembros de datos
(constantes y campos), miembros de función (métodos, propiedades, eventos,
indizadores, operadores, constructores de instancias, destructores y constructores
estáticos) y tipos anidados. Los tipos de clase admiten la herencia, un mecanismo por el
que las clases derivadas pueden extender y especializar clases base. Las instancias de
tipos de clase se crean mediante object_creation_expression s (expresiones de creación
de objetos).

Los tipos de clase se describen en clases.

Algunos tipos de clase predefinidos tienen un significado especial en el lenguaje C#, tal
y como se describe en la tabla siguiente.

Tipo de clase Descripción

 Tipo de clase Descripción

System.Object Última clase base de todos los demás tipos. Vea el tipo de objeto.

System.String Tipo de cadena del lenguaje C#. Vea el tipo de cadena.

System.ValueType Clase base de todos los tipos de valor. Vea el tipo System. ValueType.

System.Enum La clase base de todos los tipos de enumeración. Vea enumeraciones.

System.Array La clase base de todos los tipos de matriz. Vea Matrices.

System.Delegate La clase base de todos los tipos de delegado. Vea delegados.

System.Exception La clase base de todos los tipos de excepción. Vea excepciones.

El tipo de objeto
El object tipo de clase es la clase base definitiva de todos los demás tipos. Cada tipo de
C# deriva directa o indirectamente del object tipo de clase.

La palabra clave object es simplemente un alias para la clase predefinida System.Object

.

Tipo dynamic
El dynamic tipo, como object , puede hacer referencia a cualquier objeto. Cuando se
aplican operadores a expresiones de tipo dynamic , su resolución se aplaza hasta que se
ejecuta el programa. Por lo tanto, si el operador no se puede aplicar legalmente al
objeto al que se hace referencia, no se proporciona ningún error durante la compilación.
En su lugar, se producirá una excepción cuando se produzca un error en la resolución
del operador en tiempo de ejecución.

Su finalidad es permitir el enlace dinámico, que se describe en detalle en el enlace

dinámico.

dynamic se considera idéntico a object excepto en los siguientes aspectos:

Las operaciones en expresiones de tipo dynamic se pueden enlazar dinámicamente

(enlace dinámico).
La inferencia de tipos (inferencia de tipos) preferirá dynamic object si ambas son
candidatas.

Debido a esta equivalencia, lo siguiente incluye:

 Existe una conversión de identidad implícita entre object y dynamic , y entre los
tipos construidos que son iguales al reemplazar dynamic por object
Las conversiones implícitas y explícitas a y desde object también se aplican a y
desde dynamic .
Las firmas de método que son iguales cuando se reemplaza dynamic con object
se consideran la misma firma
dynamic No se distingue el tipo de object en tiempo de ejecución.
Una expresión del tipo dynamic se conoce como una expresión dinámica.

Tipo string
El string tipo es un tipo de clase sellado que hereda directamente de object . Las
instancias de la string clase representan cadenas de caracteres Unicode.

Los valores del string tipo pueden escribirse como literales de cadena (literales de
cadena).

La palabra clave string es simplemente un alias para la clase predefinida System.String

.

Tipos de interfaz
Una interfaz define un contrato. Una clase o estructura que implementa una interfaz
debe adherirse a su contrato. Una interfaz puede heredar de varias interfaces base, y
una clase o estructura puede implementar varias interfaces.

Los tipos de interfaz se describen en interfaces.

Tipos de matriz
Una matriz es una estructura de datos que contiene cero o más variables a las que se
tiene acceso a través de índices calculados. Las variables contenidas en una matriz,
denominadas también elementos de la matriz, son todas del mismo tipo y este tipo se
conoce como tipo de elemento de la matriz.

Los tipos de matriz se describen en matrices.

Tipos delegados
Un delegado es una estructura de datos que hace referencia a uno o más métodos. En
el caso de los métodos de instancia, también hace referencia a sus instancias de objeto
correspondientes.

El equivalente más cercano de un delegado en C o C++ es un puntero a función, pero

mientras que un puntero a función solo puede hacer referencia a funciones estáticas, un
delegado puede hacer referencia a métodos estáticos y de instancia. En el último caso,
el delegado almacena no solo una referencia al punto de entrada del método, sino
también una referencia a la instancia de objeto en la que se invoca el método.

Los tipos de delegado se describen en delegados.

Conversiones boxing y unboxing

El concepto de conversión boxing y unboxing es fundamental para el sistema de tipos
de C#. Proporciona un puente entre value_type s y reference_type s permitiendo que
cualquier valor de una value_type se convierta al tipo y desde él object . Las
conversiones boxing y unboxing permiten una vista unificada del sistema de tipos en el
que un valor de cualquier tipo se puede tratar en última instancia como un objeto.

Conversiones Boxing
Una conversión boxing permite convertir implícitamente un value_type en un
reference_type. Existen las siguientes conversiones Boxing:

Desde cualquier value_type al tipo object .

Desde cualquier value_type al tipo System.ValueType .
Desde cualquier non_nullable_value_type a cualquier interface_type implementado
por el value_type.
Desde cualquier nullable_type a cualquier interface_type implementado por el tipo
subyacente de la nullable_type.
Desde cualquier enum_type al tipo System.Enum .
Desde cualquier nullable_type con un enum_type subyacente al tipo System.Enum .
Tenga en cuenta que una conversión implícita de un parámetro de tipo se
ejecutará como conversión boxing si en tiempo de ejecución termina la conversión
de un tipo de valor a un tipo de referencia (conversiones implícitas que implican
parámetros de tipo).

La conversión boxing de un valor de una non_nullable_value_type consiste en asignar

una instancia de objeto y copiar el valor de non_nullable_value_type en esa instancia.

La conversión boxing de un valor de un nullable_type genera una referencia nula si es el

null valor ( HasValue is false ) o el resultado de desencapsular y convertir en Boxing el
valor subyacente en caso contrario.

El proceso real de conversión boxing de un valor de un non_nullable_value_type se

explica mejor al imaginarse la existencia de una clase de conversión boxing genérica,
que se comporta como si se hubiese declarado de la siguiente manera:

C#

sealed class Box<T>: System.ValueType

T value;

public Box(T t) {

value = t;

La conversión boxing de un valor v de tipo T ahora consiste en ejecutar la expresión

new Box<T>(v) y devolver la instancia resultante como un valor de tipo object . Por lo
tanto, las instrucciones

C#

int i = 123;

object box = i;

se corresponden conceptualmente con

C#

int i = 123;

object box = new Box<int>(i);

Una clase Boxing como Box<T> la anterior no existe realmente y el tipo dinámico de un
valor de conversión boxing no es realmente un tipo de clase. En su lugar, un valor con
conversión boxing de tipo T tiene el tipo dinámico T y una comprobación de tipos
dinámicos mediante el is operador puede simplemente hacer referencia al tipo T . Por
ejemplo,

C#

int i = 123;

object box = i;

if (box is int) {

Console.Write("Box contains an int");

dará como resultado la cadena " Box contains an int " en la consola.

Una conversión boxing implica que se realice una copia del valor al que se va a aplicar la
conversión boxing. Esto es diferente de la conversión de un reference_type al tipo
object , en el que el valor sigue haciendo referencia a la misma instancia y simplemente

se considera como el tipo menos derivado object . Por ejemplo, dada la declaración

C#

struct Point

public int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

las instrucciones siguientes

C#

Point p = new Point(10, 10);

object box = p;

p.x = 20;

Console.Write(((Point)box).x);

dará como resultado el valor 10 en la consola de porque la operación de conversión

boxing implícita que se produce en la asignación de p a box hace que se copie el valor
de p . Si Point se hubiera declarado class en su lugar, el valor 20 sería Output porque
p y box haría referencia a la misma instancia.

Conversiones unboxing
Una conversión unboxing permite convertir un reference_type explícitamente en un
value_type. Existen las siguientes conversiones unboxing:

Del tipo object a cualquier value_type.

Del tipo System.ValueType a cualquier value_type.
Desde cualquier interface_type a cualquier non_nullable_value_type que
implementa la interface_type.
Desde cualquier interface_type a cualquier nullable_type cuyo tipo subyacente
implementa la interface_type.
 Del tipo System.Enum a cualquier enum_type.
Del tipo System.Enum a cualquier nullable_type con un enum_type subyacente.
Tenga en cuenta que una conversión explícita a un parámetro de tipo se ejecutará
como una conversión unboxing si en tiempo de ejecución termina la conversión de
un tipo de referencia a un tipo de valor (conversiones dinámicas explícitas).

Una operación de conversión unboxing a un non_nullable_value_type consiste en

comprobar primero que la instancia de objeto es un valor de conversión boxing del
non_nullable_value_type especificado y, a continuación, copiar el valor fuera de la
instancia.

La conversión unboxing a un nullable_type genera el valor null del nullable_type si el

operando de origen es null , o el resultado ajustado de la conversión unboxing de la
instancia de objeto en el tipo subyacente de la nullable_type en caso contrario.

Al hacer referencia a la clase de conversión boxing imaginaria descrita en la sección

anterior, una conversión unboxing de un objeto box en un value_type T consiste en
ejecutar la expresión ((Box<T>)box).value . Por lo tanto, las instrucciones

C#

object box = 123;

int i = (int)box;

se corresponden conceptualmente con

C#

object box = new Box<int>(123);

int i = ((Box<int>)box).value;

Para que una conversión unboxing a una non_nullable_value_type determinada se realice

correctamente en tiempo de ejecución, el valor del operando de origen debe ser una
referencia a un valor de conversión boxing de ese non_nullable_value_type. Si el
operando de origen es null , System.NullReferenceException se produce una
excepción. Si el operando de origen es una referencia a un objeto incompatible,
System.InvalidCastException se produce una excepción.

Para que una conversión unboxing a una nullable_type determinada se realice

correctamente en tiempo de ejecución, el valor del operando de origen debe ser null o
una referencia a un valor de conversión boxing del non_nullable_value_type subyacente
de la nullable_type. Si el operando de origen es una referencia a un objeto incompatible,
System.InvalidCastException se produce una excepción.
Tipos construidos
Una declaración de tipo genérico, por sí sola, denota un *tipo genérico sin enlazar, que
se usa como "Blueprint" para formar muchos tipos diferentes, por medio de la
aplicación de argumentos de tipo. Los argumentos de tipo se escriben entre corchetes
angulares ( < y > ) inmediatamente después del nombre del tipo genérico. Un tipo que
incluye al menos un argumento de tipo se denomina tipo construido. Un tipo construido
se puede usar en la mayoría de los lugares del lenguaje en el que puede aparecer un
nombre de tipo. Un tipo genérico sin enlazar solo se puede usar dentro de un
_typeof_expression * (el operador typeof).

Los tipos construidos también se pueden usar en expresiones como nombres simples
(nombres simples) o al obtener acceso a un miembro (acceso a miembros).

Cuando se evalúa un namespace_or_type_name , solo se tienen en cuenta los tipos

genéricos con el número correcto de parámetros de tipo. Por lo tanto, es posible usar el
mismo identificador para identificar distintos tipos, siempre que los tipos tengan
distintos números de parámetros de tipo. Esto resulta útil cuando se combinan clases
genéricas y no genéricas en el mismo programa:

C#

namespace Widgets

class Queue {...}

class Queue<TElement> {...}

namespace MyApplication

using Widgets;

class X

Queue q1; // Non-generic Widgets.Queue

Queue<int> q2; // Generic Widgets.Queue

Un type_name podría identificar un tipo construido aunque no especifique directamente

los parámetros de tipo. Esto puede ocurrir cuando un tipo está anidado dentro de una
declaración de clase genérica y el tipo de instancia de la declaración contenedora se usa
implícitamente para la búsqueda de nombres (tipos anidados en clases genéricas):

C#
 class Outer<T>

public class Inner {...}

public Inner i; // Type of i is Outer<T>.Inner

En código no seguro, no se puede usar un tipo construido como unmanaged_type (tipos

de puntero).

Argumentos de tipo
Cada argumento de una lista de argumentos de tipo es simplemente un tipo.

antlr

type_argument_list

: '<' type_arguments '>'

type_arguments

: type_argument (',' type_argument)*

type_argument

: type

En el código no seguro (código no seguro), un type_argument no puede ser un tipo de

puntero. Cada argumento de tipo debe satisfacer las restricciones en el parámetro de
tipo correspondiente (restricciones de parámetro de tipo).

Tipos abiertos y cerrados

Todos los tipos se pueden clasificar como * tipos abiertos _ o _ tipos cerrados *. Un tipo
abierto es un tipo que implica parámetros de tipo. Más concretamente:

Un parámetro de tipo define un tipo abierto.

Un tipo de matriz es un tipo abierto solo si su tipo de elemento es un tipo abierto.
Un tipo construido es un tipo abierto solo si uno o varios de sus argumentos de
tipo es un tipo abierto. Un tipo anidado construido es un tipo abierto si y solo si
uno o varios de sus argumentos de tipo o los argumentos de tipo de sus tipos
contenedores es un tipo abierto.

Un tipo cerrado es un tipo que no es un tipo abierto.

En tiempo de ejecución, todo el código dentro de una declaración de tipos genéricos se
ejecuta en el contexto de un tipo construido cerrado que se creó mediante la aplicación
de argumentos de tipo a la declaración genérica. Cada parámetro de tipo dentro del
tipo genérico se enlaza a un tipo en tiempo de ejecución determinado. El
procesamiento en tiempo de ejecución de todas las instrucciones y expresiones siempre
se produce con tipos cerrados y los tipos abiertos solo se producen durante el
procesamiento en tiempo de compilación.

Cada tipo construido cerrado tiene su propio conjunto de variables estáticas, que no se
comparten con otros tipos construidos cerrados. Puesto que no existe un tipo abierto
en tiempo de ejecución, no hay variables estáticas asociadas a un tipo abierto. Dos tipos
construidos cerrados son del mismo tipo si se construyen a partir del mismo tipo
genérico sin enlazar y sus argumentos de tipo correspondientes son del mismo tipo.

Tipos enlazados y sin enlazar

El término *tipo sin enlazar _ hace referencia a un tipo no genérico o a un tipo genérico
sin enlazar. El término _ Bound Type* hace referencia a un tipo no genérico o a un tipo
construido.

Un tipo sin enlazar hace referencia a la entidad declarada por una declaración de tipos.
Un tipo genérico sin enlazar no es en sí mismo un tipo y no se puede usar como el tipo
de una variable, argumento o valor devuelto, o como un tipo base. La única
construcción en la que se puede hacer referencia a un tipo genérico sin enlazar es la
typeof expresión (el operador typeof).

Satisfacer restricciones
Siempre que se hace referencia a un tipo construido o a un método genérico, los
argumentos de tipo proporcionados se comprueban con las restricciones de parámetro
de tipo declaradas en el tipo o método genérico (restricciones de parámetro de tipo).
Para cada where cláusula, el argumento de tipo A que se corresponde con el parámetro
de tipo con nombre se compara con cada restricción de la manera siguiente:

Si la restricción es un tipo de clase, un tipo de interfaz o un parámetro de tipo,

permita C representar esa restricción con los argumentos de tipo proporcionados
que se sustituyen por los parámetros de tipo que aparecen en la restricción. Para
satisfacer la restricción, debe ser el caso de que el tipo A se pueda convertir al tipo
C mediante una de las siguientes acciones:

Una conversión de identidad (conversión de identidad)

Una conversión de referencia implícita (conversiones de referencia implícita)
 Una conversión boxing (conversiones boxing), siempre que el tipo a sea un tipo
de valor que no acepte valores NULL.
Referencia implícita, conversión boxing o conversión de parámetros de tipo de
un parámetro de tipo A a C .
Si la restricción es la restricción de tipo de referencia ( class ), el tipo A debe
cumplir uno de los siguientes elementos:
A es un tipo de interfaz, tipo de clase, tipo de delegado o tipo de matriz. Tenga
en cuenta que System.ValueType y System.Enum son tipos de referencia que
satisfacen esta restricción.
A es un parámetro de tipo que se sabe que es un tipo de referencia

(restricciones de parámetro de tipo).

Si la restricción es la restricción de tipo de valor ( struct ), el tipo A debe cumplir
uno de los siguientes elementos:
A es un tipo de estructura o un tipo de enumeración, pero no un tipo que
acepta valores NULL. Tenga en cuenta que System.ValueType y System.Enum son
tipos de referencia que no cumplen esta restricción.
A es un parámetro de tipo que tiene la restricción de tipo de valor (restricciones
de parámetro de tipo).
Si la restricción es la restricción del constructor new() , el tipo A no debe ser
abstract y debe tener un constructor sin parámetros público. Esto se cumple si se

cumple una de las siguientes condiciones:

A es un tipo de valor, ya que todos los tipos de valor tienen un constructor

predeterminado público (constructores predeterminados).

A es un parámetro de tipo que tiene la restricción de constructor (restricciones
de parámetro de tipo).
A es un parámetro de tipo que tiene la restricción de tipo de valor (restricciones
de parámetro de tipo).
A es una clase que no es abstract y contiene un constructor declarado

explícitamente public sin parámetros.

A no es abstract y tiene un constructor predeterminado (constructores

predeterminados).

Se produce un error en tiempo de compilación si los argumentos de tipo especificados

no satisfacen una o varias restricciones de un parámetro de tipo.

Dado que los parámetros de tipo no se heredan, las restricciones nunca se heredan. En
el ejemplo siguiente, D debe especificar la restricción en su parámetro de tipo T para
que T cumpla la restricción impuesta por la clase base B<T> . En cambio, E la clase no
necesita especificar una restricción, porque List<T> implementa IEnumerable para any
T .
 C#

class B<T> where T: IEnumerable {...}

class D<T>: B<T> where T: IEnumerable {...}

class E<T>: B<List<T>> {...}

Parámetros de tipo
Un parámetro de tipo es un identificador que designa un tipo de valor o un tipo de
referencia al que está enlazado el parámetro en tiempo de ejecución.

antlr

type_parameter

: identifier

Dado que se pueden crear instancias de un parámetro de tipo con muchos argumentos
de tipo reales diferentes, los parámetros de tipo tienen operaciones y restricciones
ligeramente diferentes a las de otros tipos. Entre ellos, se incluye:

Un parámetro de tipo no se puede usar directamente para declarar una clase base
(clase base) o una interfaz (listas de parámetros de tipo variante).
Las reglas para la búsqueda de miembros en parámetros de tipo dependen de las
restricciones, si las hay, que se aplican al parámetro de tipo. Se detallan en la
búsqueda de miembros.
Las conversiones disponibles para un parámetro de tipo dependen de las
restricciones, si las hay, que se aplican al parámetro de tipo. Se detallan en
conversiones implícitas que implican parámetros de tipo y conversiones dinámicas
explícitas.
El literal null no se puede convertir en un tipo proporcionado por un parámetro
de tipo, excepto si se sabe que el parámetro de tipo es un tipo de referencia
(conversiones implícitas que implican parámetros de tipo). Sin embargo, default
en su lugar se puede utilizar una expresión (expresiones de valor predeterminado).
Además, un valor con un tipo proporcionado por un parámetro de tipo puede
compararse con null mediante == y != (operadores de igualdad de tipos
dereferencia), a menos que el parámetro de tipo tenga la restricción de tipo de
valor.
Una new expresión (expresiones de creación de objetos) solo se puede utilizar con
un parámetro de tipo si el parámetro de tipo está restringido por un
 constructor_constraint o la restricción de tipo de valor (restricciones de parámetro
de tipo).
Un parámetro de tipo no se puede usar en ningún lugar dentro de un atributo.
No se puede usar un parámetro de tipo en un acceso de miembro (acceso a
miembros) o nombre de tipo (espacio de nombresy nombres de tipo) para
identificar un miembro estático o un tipo anidado.
En código no seguro, no se puede usar un parámetro de tipo como
unmanaged_type (tipos de puntero).

Como tipo, los parámetros de tipo son únicamente una construcción en tiempo de
compilación. En tiempo de ejecución, cada parámetro de tipo se enlaza a un tipo en
tiempo de ejecución que se especificó proporcionando un argumento de tipo a la
declaración de tipos genéricos. Por lo tanto, el tipo de una variable declarada con un
parámetro de tipo, en tiempo de ejecución, será un tipo construido cerrado (tipos
abiertos y cerrados). La ejecución en tiempo de ejecución de todas las instrucciones y
expresiones que impliquen parámetros de tipo usa el tipo real que se proporcionó
como argumento de tipo para ese parámetro.

Tipos de árbol de expresión

*Los árboles de expresión _ permiten representar expresiones lambda como estructuras
de datos en lugar de código ejecutable. Los árboles de expresión son valores de _ tipos
de árbol de expresión* del formulario System.Linq.Expressions.Expression<D> , donde D
es cualquier tipo de delegado. En el resto de esta especificación, haremos referencia a
estos tipos con la abreviatura Expression<D> .

Si existe una conversión de una expresión lambda a un tipo de delegado D , también

existe una conversión al tipo de árbol de expresión Expression<D> . Mientras que la
conversión de una expresión lambda a un tipo de delegado genera un delegado que
hace referencia al código ejecutable de la expresión lambda, la conversión a un tipo de
árbol de expresión crea una representación de árbol de expresión de la expresión
lambda.

Los árboles de expresión son representaciones eficaces de datos en memoria de

expresiones lambda y hacen que la estructura de la expresión lambda sea transparente y
explícita.

Al igual que un tipo D de delegado, Expression<D> se dice que tiene tipos de parámetro
y de valor devuelto, que son los mismos que los de D .
En el ejemplo siguiente se representa una expresión lambda como código ejecutable y
como un árbol de expresión. Dado que existe una conversión a Func<int,int> , también
existe una conversión a Expression<Func<int,int>> :

C#

Func<int,int> del = x => x + 1; // Code

Expression<Func<int,int>> exp = x => x + 1; // Data

Después de estas asignaciones, el delegado del hace referencia a un método que

devuelve x + 1 y el árbol de expresión exp hace referencia a una estructura de datos
que describe la expresión x => x + 1 .

La definición exacta del tipo genérico, Expression<D> así como las reglas precisas para
construir un árbol de expresión cuando una expresión lambda se convierte en un tipo
de árbol de expresión, está fuera del ámbito de esta especificación.

Es importante hacer dos cosas:

No todas las expresiones lambda se pueden convertir en árboles de expresión. Por

ejemplo, las expresiones lambda con cuerpos de instrucciones y expresiones
lambda que contienen expresiones de asignación no se pueden representar. En
estos casos, todavía existe una conversión, pero se producirá un error en tiempo
de compilación. Estas excepciones se detallan en conversiones de funciones
anónimas.

Expression<D> proporciona un método Compile de instancia que genera un

delegado de tipo D :

C#

Func<int,int> del2 = exp.Compile();

Al invocar este delegado se produce el código representado por el árbol de

expresión que se va a ejecutar. Por lo tanto, dado que las definiciones anteriores,
del y DEL2 son equivalentes, y las dos instrucciones siguientes tendrán el mismo
efecto:

C#

int i1 = del(1);

int i2 = del2(1);

Después de ejecutar este código, i1 y i2 ambos tendrán el valor 2 .

variables
Artículo • 16/09/2021 • Tiempo de lectura: 33 minutos

Las variables representan ubicaciones de almacenamiento. Cada variable tiene un tipo

que determina qué valores se pueden almacenar en la variable. C# es un lenguaje con
seguridad de tipos y el compilador de C# garantiza que los valores almacenados en
variables siempre sean del tipo adecuado. El valor de una variable se puede cambiar
mediante la asignación o mediante el uso de los ++ operadores -- y .

Se debe asignar definitivamente una variable (asignación definitiva)para poder obtener

su valor.

Como se describe en las secciones siguientes, las variables se asignan inicialmente a* o

_*inicialmente sin asignar **. Una variable asignada inicialmente tiene un valor inicial
bien definido y siempre se considera asignada definitivamente. Una variable
inicialmente sin asignación no tiene ningún valor inicial. Para que una variable
inicialmente sin asignar se considere definitivamente asignada en una ubicación
determinada, debe producirse una asignación a la variable en todas las rutas de
ejecución posibles que conducen a esa ubicación.

Categorías de variable
C# define siete categorías de variables: variables estáticas, variables de instancia,
elementos de matriz, parámetros de valor, parámetros de referencia, parámetros de
salida y variables locales. Las secciones siguientes describen cada una de estas
categorías.

En el ejemplo

C#

class A

public static int x;

int y;

void F(int[] v, int a, ref int b, out int c) {

int i = 1;

c = a + b++;

x es una variable estática, es una variable de instancia, es un elemento de matriz, es un

parámetro de valor, es un parámetro de referencia, es un parámetro de salida y y v[0]

es una variable a b c i local.

Variables estáticas
Un campo declarado con el static modificador se denomina variable estática. Una
variable estática entra en vigor antes de la ejecución del constructor
estático(constructores estáticos) para su tipo de contenido y deja de existir cuando el
dominio de aplicación asociado deja de existir.

El valor inicial de una variable estática es el valor predeterminado(valores

predeterminados)del tipo de la variable.

A efectos de la comprobación de asignación definitiva, se considera que una variable

estática está asignada inicialmente.

Variables de instancia
Un campo declarado sin el static modificador se denomina variable de instancia.

Variables de instancia en clases

Una variable de instancia de una clase entra en vigor cuando se crea una nueva
instancia de esa clase y deja de existir cuando no hay referencias a esa instancia y se ha
ejecutado el destructor de la instancia (si existe).

El valor inicial de una variable de instancia de una clase es el valor predeterminado

(valores predeterminados) del tipo de la variable.

Para la comprobación de asignación definitiva, una variable de instancia de una clase se

considera asignada inicialmente.

Variables de instancia en estructuras

Una variable de instancia de un struct tiene exactamente la misma duración que la

variable de estructura a la que pertenece. En otras palabras, cuando una variable de un
tipo de estructura entra en existencia o deja de existir, también lo hacen las variables de
instancia de la estructura .

El estado de asignación inicial de una variable de instancia de un struct es el mismo que

el de la variable de estructura contenedora. En otras palabras, cuando una variable de
estructura se considera asignada inicialmente, también lo son sus variables de instancia
y, cuando una variable de estructura se considera inicialmente sin asignar, sus variables
de instancia tampoco tienen asignación.

Elementos de matriz
Los elementos de una matriz se crean cuando se crea una instancia de matriz y dejan de
existir cuando no hay referencias a esa instancia de matriz.

El valor inicial de cada uno de los elementos de una matriz es el valor predeterminado
(Valores predeterminados) del tipo de los elementos de la matriz.

Para la comprobación de asignación definitiva, un elemento de matriz se considera

asignado inicialmente.

Parámetros de valor
Un parámetro declarado sin un ref modificador o es un parámetro de out valor.

Un parámetro de valor entra en vigor tras la invocación del miembro de función

(método, constructor de instancia, accessor u operador) o de la función anónima a la
que pertenece el parámetro, y se inicializa con el valor del argumento proporcionado en
la invocación. Normalmente, un parámetro de valor deja de existir al devolver el
miembro de función o la función anónima. Sin embargo, si una función anónima
captura el parámetro value (expresiones de funciónanónimas),su duración se extiende al
menos hasta que el delegado o el árbol de expresión creado a partir de esa función
anónima sea apto para la recolección de elementos no utilizados.

Para la comprobación de asignación definitiva, un parámetro de valor se considera

asignado inicialmente.

Parámetros de referencia
Un parámetro declarado con un ref modificador es un parámetro de referencia.

Un parámetro de referencia no crea una nueva ubicación de almacenamiento. En su

lugar, un parámetro de referencia representa la misma ubicación de almacenamiento
que la variable especificada como argumento en el miembro de función o la invocación
de función anónima. Por lo tanto, el valor de un parámetro de referencia siempre es el
mismo que la variable subyacente.
Las siguientes reglas de asignación definidas se aplican a los parámetros de referencia.
Tenga en cuenta las distintas reglas para los parámetros de salida que se describen en
Parámetros de salida.

Una variable debe asignarse definitivamente(definiciónde asignación ) antes de

que se pueda pasar como parámetro de referencia en una invocación de delegado
o miembro de función.
Dentro de un miembro de función o una función anónima, un parámetro de
referencia se considera asignado inicialmente.

Dentro de un método de instancia o un accessor de instancia de un tipo struct, la

palabra clave se comporta exactamente como un parámetro de referencia del tipo this
de estructura ( Esteacceso).

Parámetros de salida
Un parámetro declarado con un out modificador es un parámetro de salida.

Un parámetro de salida no crea una nueva ubicación de almacenamiento. En su lugar,

un parámetro de salida representa la misma ubicación de almacenamiento que la
variable especificada como argumento en la invocación de delegado o miembro de
función. Por lo tanto, el valor de un parámetro de salida siempre es el mismo que la
variable subyacente.

Las siguientes reglas de asignación definidas se aplican a los parámetros de salida.

Tenga en cuenta las distintas reglas para los parámetros de referencia que se describen
en Parámetros de referencia.

No es necesario asignar definitivamente una variable para poder pasarla como

parámetro de salida en una invocación de delegado o miembro de función.
Después de la finalización normal de una invocación de delegado o miembro de
función, cada variable que se pasó como parámetro de salida se considera
asignada en esa ruta de acceso de ejecución.
Dentro de un miembro de función o una función anónima, un parámetro de salida
se considera inicialmente sin signo.
Todos los parámetros de salida de un miembro de función o una función anónima
deben asignarse definitivamente (Definite assignment) antes de que el miembro
de función o la función anónima vuelvan con normalidad.

Dentro de un constructor de instancia de un tipo de estructura, la palabra clave se

comporta exactamente como un parámetro de salida del tipo this de estructura (
Esteacceso).
Variables locales
Una variable local _ se declara mediante un _local_variable_declaration, que puede
producirse en un bloque , un for_statement , un switch_statement o un using_statement;
o por un foreach_statement o un specific_catch_clause para un try_statement.

La duración de una variable local es la parte de la ejecución del programa durante la

cual se garantiza que el almacenamiento se reservará para ella. Esta duración se
extiende al menos desde la entrada en el bloque , for_statement, switch_statement,
using_statement, foreach_statement o specific_catch_clause con el que está asociada,
hasta que la ejecución de ese bloque , for_statement, switch_statement, using_statement,
foreach_statement o specific_catch_clause finaliza de cualquier manera. (Al escribir un
bloque delimitado o llamar a un método se suspende, pero no finaliza, la ejecución del
bloque actual , for_statement, switch_statement, using_statement, foreach_statement o
specific_catch_clause). Si una función anónima captura la variable local (variablesexternas
capturadas), su duración se extiende al menos hasta que el delegado o el árbol de
expresión creados a partir de la función anónima, junto con cualquier otro objeto que
llegue a hacer referencia a la variable capturada, sean aptos para la recolección de
elementos no utilizados.

Si el bloque primario , for_statement, switch_statement, using_statement,

foreach_statement o specific_catch_clause se introduce de forma recursiva, se crea una
nueva instancia de la variable local cada vez y su local_variable_initializer, si existe, se
evalúa cada vez.

Una variable local introducida por un local_variable_declaration no se inicializa

automáticamente y, por tanto, no tiene ningún valor predeterminado. Para la
comprobación de asignación definitiva, una variable local introducida por un
local_variable_declaration se considera inicialmente sin asignación. Un
local_variable_declaration puede incluir un local_variable_initializer , en cuyo caso la
variable se considera definitivamente asignada solo después de la expresión de
inicialización ( Instrucciones de declaración).

Dentro del ámbito de una variable local introducida por un local_variable_declaration, es

un error en tiempo de compilación hacer referencia a esa variable local en una posición
textual que precede a su local_variable_declarator. Si la declaración de variable local es
implícita (declaraciones de variable local), también es un error hacer referencia a la
variable dentro de su local_variable_declarator.

Una variable local introducida por un foreach_statement o un specific_catch_clause se

considera definitivamente asignada en todo su ámbito.
La duración real de una variable local depende de la implementación. Por ejemplo, un
compilador podría determinar estáticamente que una variable local de un bloque solo
se usa para una pequeña parte de ese bloque. Con este análisis, el compilador podría
generar código que da como resultado que el almacenamiento de la variable tenga una
duración más corta que su bloque que lo contiene.

El almacenamiento al que hace referencia una variable de referencia local se reclama

independientemente de la duración de esa variable de referencia local (Administración
automática de memoria).

Valores predeterminados
Las siguientes categorías de variables se inicializan automáticamente en sus valores
predeterminados:

Variables estáticas.
Variables de instancia de instancias de clase.
Elementos de matriz.

El valor predeterminado de una variable depende del tipo de la variable y se determina

de la siguiente manera:

Para una variable de un value_type, el valor predeterminado es el mismo que el

valor calculado por el constructor predeterminado de value_type (Constructores
predeterminados).
Para una variable de un reference_type, el valor predeterminado es null .

La inicialización de los valores predeterminados normalmente se realiza haciendo que el

administrador de memoria o el recolector de elementos no utilizados inicialicen la
memoria en todos los bits-cero antes de que se asigne para su uso. Por esta razón, es
conveniente usar all-bits-zero para representar la referencia nula.

Asignación definitiva
En una ubicación determinada del código ejecutable de un miembro de función, se dice
que una variable se asigna definitivamente si el compilador puede demostrar, mediante
un análisis de flujo estático determinado(reglasprecisas para determinar la asignación
definitiva), que la variable se ha inicializado automáticamente o ha sido el destino de al
menos una asignación. De forma informal, las reglas de asignación definitiva son:

Una variable asignada inicialmente (variablesasignadas inicialmente)siempre se

considera asignada definitivamente.
 Unavariableinicialmente sin asignar ( variables inicialmente sin asignar ) se
considera asignada definitivamente en una ubicación determinada si todas las
rutas de ejecución posibles que conducen a esa ubicación contienen al menos una
de las siguientes:
Una asignación simple(asignación simple)en la que la variable es el operando
izquierdo.
Expresión de invocación(expresionesde invocación) o expresión de creación de
objetos(expresionesde creación de objetos) que pasa la variable como
parámetro de salida.
Para una variable local, una declaración de variable local(declaraciones de
variable local)que incluye un inicializador de variable.

La especificación formal subyacente a las reglas informales anteriores se describe en

Variables asignadasinicialmente, Variables inicialmente sin asignar y Reglas precisas para
determinar la asignación definitiva.

Los estados de asignación definidos de las variables de instancia de una variable

struct_type se realiza un seguimiento individual y colectivamente. Además de las reglas
anteriores, las siguientes reglas se aplican a struct_type variables y sus variables de
instancia:

Una variable de instancia se considera definitivamente asignada si su variable

struct_type se considera asignada definitivamente.
Una struct_type variable se considera definitivamente asignada si cada una de sus
variables de instancia se considera asignada definitivamente.

La asignación definitiva es un requisito en los contextos siguientes:

Una variable debe asignarse definitivamente en cada ubicación donde se obtiene

su valor. Esto garantiza que los valores no definidos nunca se produzcan. La
aparición de una variable en una expresión se considera para obtener el valor de la
variable, excepto cuando
la variable es el operando izquierdo de una asignación simple,
la variable se pasa como un parámetro de salida o
la variable es struct_type variable y se produce como el operando izquierdo de
un acceso de miembro.
Una variable debe asignarse definitivamente en cada ubicación donde se pasa
como parámetro de referencia. Esto garantiza que el miembro de función que se
invoca puede tener en cuenta el parámetro de referencia asignado inicialmente.
Todos los parámetros de salida de un miembro de función deben asignarse
definitivamente en cada ubicación en la que el miembro de la función devuelve (a
través de una instrucción o a través de la ejecución que llega al final del cuerpo del
 return miembro de la función). Esto garantiza que los miembros de la función no

devuelvan valores indefinidos en los parámetros de salida, lo que permite al

compilador considerar una invocación de miembro de función que toma una
variable como parámetro de salida equivalente a una asignación a la variable.
La this variable de un constructor struct_type instancia de debe asignarse
definitivamente en cada ubicación donde devuelve ese constructor de instancia.

Variables asignadas inicialmente

Las siguientes categorías de variables se clasifican como asignadas inicialmente:

Variables estáticas.
Variables de instancia de instancias de clase.
Variables de instancia de variables de estructura asignadas inicialmente.
Elementos de matriz.
Parámetros de valor.
Parámetros de referencia.
Variables declaradas en una catch cláusula o una instrucción foreach .

Variables inicialmente sin signo

Las siguientes categorías de variables se clasifican como inicialmente sin signo:

Variables de instancia de variables de estructura inicialmente sin signo.

Parámetros de salida, incluida this la variable de constructores de instancia de
struct.
Variables locales, excepto las declaradas en catch una cláusula o una instrucción
foreach .

Reglas precisas para determinar la asignación definitiva

Para determinar que cada variable usada está asignada definitivamente, el compilador
debe usar un proceso equivalente al descrito en esta sección.

El compilador procesa el cuerpo de cada miembro de función que tiene una o varias
variables inicialmente sin asignación. Para cada variable inicialmente sin asignación v, el
compilador determina un estado de asignación definitiva _ para _v en cada uno de los
puntos siguientes del miembro de función:

Al principio de cada instrucción

En el punto final(puntos de conexión y capacidad dealcance) de cada instrucción
 En cada arco que transfiere el control a otra instrucción o al punto final de una
instrucción
Al principio de cada expresión
Al final de cada expresión

El estado de asignación definido de v puede ser:

Asignado definitivamente. Esto indica que en todos los flujos de control posibles
hasta este punto, se ha asignado un valor a v.
No está asignado definitivamente. Para el estado de una variable al final de una
expresión de tipo , el estado de una variable que no está asignada definitivamente
puede (pero no necesariamente) entrar en uno de los siguientes bool subes
estados:
Se ha asignado definitivamente después de la expresión true. Este estado indica
que v se asigna definitivamente si la expresión booleana se evaluó como true,
pero no se asigna necesariamente si la expresión booleana se evaluó como
false.
Se ha asignado definitivamente después de la expresión false. Este estado indica
que v se asigna definitivamente si la expresión booleana se evaluó como false,
pero no se asigna necesariamente si la expresión booleana se evaluó como true.

Las reglas siguientes rigen cómo se determina el estado de una variable v en cada
ubicación.

Reglas generales para instrucciones

v no se asigna definitivamente al principio de un cuerpo de miembro de función.
v se asigna definitivamente al principio de cualquier instrucción inaccesible.
El estado de asignación definido de v al principio de cualquier otra instrucción se
determina comprobando el estado de asignación definido de v en todas las
transferencias de flujo de control que tienen como destino el principio de esa
instrucción. Si (y solo si) v se asigna definitivamente en todas estas transferencias
de flujo de control, v se asigna definitivamente al principio de la instrucción . El
conjunto de posibles transferencias de flujo de control se determina de la misma
manera que para comprobar la capacidad de alcance de la instrucción (puntosde
conexión y capacidad de alcance).
El estado de asignación definitiva de v en el punto final de un bloque, , , , , , , o
instrucción se determina comprobando el estado de asignación definitiva de v en
todas las transferencias de flujo de control que tienen como destino el punto final
de checked esa unchecked if while do for foreach lock using switch
instrucción. Si v se asigna definitivamente en todas estas transferencias de flujo de
 control, v se asigna definitivamente al punto final de la instrucción. De lo contrario;
v no se asigna definitivamente en el punto final de la instrucción . El conjunto de
posibles transferencias de flujo de control se determina de la misma manera que
para comprobar la capacidad de alcance de la instrucción (puntosde conexión y
capacidad de alcance).

Instrucciones block, checked y unchecked

El estado de asignación definitiva de v en la transferencia de control a la primera
instrucción de la lista de instrucciones del bloque (o hasta el punto final del bloque, si la
lista de instrucciones está vacía) es el mismo que la instrucción de asignación definitiva
de v antes de la instrucción block, checked o unchecked .

Instrucciones de expresión
Para una instrucción de expresión stmt que consta de la expresión expr:

v tiene el mismo estado de asignación definitiva al principio de expr que al

principio de stmt.
Si v si se asigna definitivamente al final de expr, se asigna definitivamente al punto
final de stmt; de lo contrario; no se asigna definitivamente en el punto final de
stmt.

Instrucciones de declaración
Si stmt es una instrucción de declaración sin inicializadores, v tiene el mismo
estado de asignación definitiva en el punto final de stmt que al principio de stmt.
Si stmt es una instrucción de declaración con inicializadores, el estado de
asignación definido para v se determina como si stmt fuera una lista de
instrucciones, con una instrucción de asignación para cada declaración con un
inicializador (en el orden de declaración).

Instrucciones If
Para un if stmt de instrucción con el formato:

C#

if ( expr ) then_stmt else else_stmt

 v tiene el mismo estado de asignación definido al principio de expr que al principio

de stmt.
Si v se asigna definitivamente al final de expr, se asigna definitivamente en la
transferencia del flujo de control a then_stmt y a else_stmt o al punto final de stmt
si no hay ninguna cláusula else.
Si v tiene el estado "asignado definitivamente después de la expresión verdadera"
al final de expr, se asigna definitivamente en la transferencia de flujo de control a
then_stmt y no se asigna definitivamente en la transferencia de flujo de control a
else_stmt o al punto final de stmt si no hay ninguna cláusula else.
Si v tiene el estado "asignado definitivamente después de la expresión falsa" al
final de expr, se asigna definitivamente en la transferencia de flujo de control a
else_stmt y no se asigna definitivamente en la transferencia de flujo de control a
then_stmt. Se asigna definitivamente al punto final de stmt si y solo si se asigna
definitivamente en el punto final de then_stmt.
De lo contrario, se considera que v no está asignado definitivamente en la
transferencia del flujo de control a then_stmt o else_stmt o al punto final de stmt si
no hay ninguna cláusula else.

Instrucciones switch

En una switch instrucción stmt con una expresión de control expr:

El estado de asignación definido de v al principio de expr es el mismo que el

estado de v al principio de stmt.
El estado de asignación definido de v en la transferencia de flujo de control a una
lista de instrucciones de bloque de modificador accesible es el mismo que el
estado de asignación definido de v al final de expr.

Instrucciones While

Para una while instrucción stmt del formulario:

C#

while ( expr ) while_body

v tiene el mismo estado de asignación definido al principio de expr que al principio

de stmt.
Si v se asigna definitivamente al final de expr, se asigna definitivamente en la
transferencia del flujo de control a while_body y al punto final de stmt.
 Si v tiene el estado "definitivamente asignado después de la expresión true" al final
de expr, se asigna definitivamente en la transferencia del flujo de control a
while_body, pero no se asigna definitivamente al punto final de stmt.
Si v tiene el estado "definitivamente asignado después de la expresión falsa" al
final de expr, se asigna definitivamente en la transferencia del flujo de control al
punto final de stmt, pero no se asigna definitivamente en la transferencia del flujo
de control a while_body.

Instrucciones Do

Para un do stmt de instrucción con el formato :

C#

do do_body while ( expr ) ;

v tiene el mismo estado de asignación definido en la transferencia del flujo de

control desde el principio de stmt a do_body que al principio de stmt.
v tiene el mismo estado de asignación definido al principio de expr que al final de
do_body.
Si v se asigna definitivamente al final de expr, se asigna definitivamente en la
transferencia del flujo de control al punto final de stmt.
Si v tiene el estado "definitivamente asignado después de la expresión false" al
final de expr, se asigna definitivamente en la transferencia del flujo de control al
punto final de stmt.

Para instrucciones
Definición de la comprobación de for asignación para una instrucción del formulario:

C#

for ( for_initializer ; for_condition ; for_iterator ) embedded_statement

se hace como si la instrucción se hubiera escrito:

C#

for_initializer ;

while ( for_condition ) {

embedded_statement ;

for_iterator ;

Si la for_condition se omite de la instrucción , la evaluación de la asignación definitiva

continúa como si for_condition se reemplazara por en for la true expansión anterior.

Instrucciones Break, continue y goto

El estado de asignación definitiva de v en la transferencia del flujo de control causado

por una instrucción , o es el mismo que el estado de asignación definido de v al
principio de break la continue goto instrucción.

Instrucciones Throw

Para una instrucción stmt del formulario

C#

throw expr ;

El estado de asignación definido de v al principio de expr es el mismo que el estado de

asignación definido de v al principio de stmt.

Instrucciones Return
Para una instrucción stmt del formulario

C#

return expr ;

El estado de asignación definido de v al principio de expr es el mismo que el

estado de asignación definido de v al principio de stmt.
Si v es un parámetro de salida, debe asignarse definitivamente:
after expr
o al final del finally bloque de o try - finally try - catch - finally que
incluye la return instrucción .

Para una instrucción stmt del formulario:

C#
 return ;

Si v es un parámetro de salida, debe asignarse definitivamente:

antes de stmt
o al final del finally bloque de o try - finally try - catch - finally que
incluye la return instrucción .

Instrucciones Try-catch

Para una instrucción stmt del formulario:

C#

try try_block

catch(...) catch_block_1

...

catch(...) catch_block_n

El estado de asignación definido de v al principio de try_block es el mismo que el

estado de asignación definido de v al principio de stmt.
El estado de asignación definitiva de v al principio de catch_block_i (para cualquier
i) es el mismo que el estado de asignación definitiva de v al principio de stmt.
El estado de asignación definitiva de v en el punto final de stmt está asignado
definitivamente si (y sólo si) v se asigna definitivamente en el punto final de
try_block y cada catch_block_i (para cada i de 1 a n).

Instrucciones Try-finally
Para una try instrucción stmt del formulario:

C#

try try_block finally finally_block

El estado de asignación definido de v al principio de try_block es el mismo que el

estado de asignación definido de v al principio de stmt.
El estado de asignación definido de v al principio de finally_block es el mismo que
el estado de asignación definido de v al principio de stmt.
El estado de asignación definitiva de v en el punto final de stmt se asigna
definitivamente si (y solo si) se cumple al menos una de las siguientes condiciones:
v se asigna definitivamente al final de la try_block
 v se asigna definitivamente al final del finally_block

Si se realiza una transferencia de flujo de control (por ejemplo, una instrucción ) que
comienza dentro de try_block y termina fuera de try_block , v también se considera
asignado definitivamente en esa transferencia de flujo de control si v se asigna
definitivamente al punto final de goto finally_block. (Esto no es solo si, si v se asigna
definitivamente por otro motivo en esta transferencia de flujo de control, se sigue
considerando asignado definitivamente).

Instrucciones Try-catch-finally

Definición del análisis de asignación try - catch - finally para una instrucción del
formulario:

C#

try try_block

catch(...) catch_block_1

...

catch(...) catch_block_n

finally *finally_block*

se hace como si la instrucción fuera try - finally una instrucción que incluye una try
- catch instrucción :

C#

try {

try try_block

catch(...) catch_block_1

...

catch(...) catch_block_n

finally finally_block

En el ejemplo siguiente se muestra cómo los distintos bloques de una instrucción ( la

instrucción try ) afectan a try la asignacióndefinitiva.

C#

class A

static void F() {

int i, j;

try {

goto LABEL;

 // neither i nor j definitely assigned

i = 1;

// i definitely assigned

catch {

// neither i nor j definitely assigned

i = 3;

// i definitely assigned

finally {

// neither i nor j definitely assigned

j = 5;

// j definitely assigned

// i and j definitely assigned

LABEL:;

// j definitely assigned

Instrucciones Foreach
Para un foreach stmt de instrucción con el formato :

C#

foreach ( type identifier in expr ) embedded_statement

El estado de asignación definitiva de v al principio de expr es el mismo que el

estado de v al principio de stmt.
El estado de asignación definitiva de v en la transferencia del flujo de control a
embedded_statement o al punto final de stmt es el mismo que el estado de v al
final de expr.

Uso de las instrucciones

Para un using stmt de instrucción con el formato :

C#

using ( resource_acquisition ) embedded_statement

 El estado de asignación definitiva de v al principio de resource_acquisition es el

mismo que el estado de v al principio de stmt.
El estado de asignación definitiva de v en la transferencia del flujo de control a
embedded_statement es el mismo que el estado de v al final de
resource_acquisition.

Instrucciones lock
Para una lock instrucción stmt del formulario:

C#

lock ( expr ) embedded_statement

El estado de asignación definido de v al principio de expr es el mismo que el

estado de v al principio de stmt.
El estado de asignación definido de v en la transferencia de flujo de control a
embedded_statement es el mismo que el estado de v al final de expr.

Instrucciones Yield

Para una yield return instrucción stmt del formulario:

C#

yield return expr ;

El estado de asignación definido de v al principio de expr es el mismo que el

estado de v al principio de stmt.
El estado de asignación definido de v al final de stmt es el mismo que el estado de
v al final de expr.
Una yield break instrucción no tiene ningún efecto en el estado de asignación
definido.

Reglas generales para expresiones simples

La regla siguiente se aplica a estos tipos de expresiones: literales(literales),nombres
simples(nombressimples), expresiones de acceso a miembros(accesoa miembros),
expresiones de acceso base no indexadas(accesobase), expresiones (el operador typeof),
expresiones de valor predeterminado (expresiones de valor predeterminado) y typeof
nameof expresiones(expresiones Nameof).
 El estado de asignación definido de v al final de dicha expresión es el mismo que
el estado de asignación definido de v al principio de la expresión.

Reglas generales para expresiones con expresiones insertadas

Las reglas siguientes se aplican a estos tipos de expresiones: expresiones entre

paréntesis(expresionesentre paréntesis), expresiones de acceso a elementos(accesoa
elementos),expresiones de acceso base con indexación (accesobase),expresiones de
incremento y decremento(operadoresde incremento y decremento de postfijo,
operadores de incremento y decremento de prefijo), expresiones de
conversión(expresionesde conversión), expresiones + unarias, - , ~ , * expresiones,
binary , , , , , , expressions (operadores aritméticos , operadores Shift , operadores
relacionales y de prueba de tipos , operadores lógicos), expresiones de asignación
compuesta (asignación compuesta) y + - * / % << >> < <= > >= == != is as & |
^ checked expresiones (operadores comprobados unchecked y no comprobados),

además de expresiones de creación de matrices y delegados (el nuevo operador ).

Cada una de estas expresiones tiene una o varias sub expressions que se evalúan
incondicionalmente en un orden fijo. Por ejemplo, el operador binario evalúa el lado
izquierdo del operador y, a % continuación, el lado derecho. Una operación de
indexación evalúa la expresión indizada y, a continuación, evalúa cada una de las
expresiones de índice, en orden de izquierda a derecha. Para una expresión expr, que
tiene sub expressions e1, e2, ..., eN, eN evaluadas en ese orden:

El estado de asignación definitiva de v al principio de e1 es el mismo que el estado

de asignación definitiva al principio de expr.
El estado de asignación definitiva de v al principio de ei (i mayor que uno) es el
mismo que el estado de asignación definitiva al final de la subexpresión anterior.
El estado de asignación definitiva de v al final de expr es el mismo que el estado de
asignación definitiva al final de eN.

Expresiones de invocación y expresiones de creación de objetos

Para una expresión de invocación expr del formulario:

C#

primary_expression ( arg1 , arg2 , ... , argN )

o una expresión de creación de objetos del formulario:

C#
 new type ( arg1 , arg2 , ... , argN )

Para una expresión de invocación, el estado de asignación definido de v antes de

primary_expression es el mismo que el estado de v antes de expr.
Para una expresión de invocación, el estado de asignación definido de v antes de
arg1 es el mismo que el estado de v después de primary_expression.
Para una expresión de creación de objetos, el estado de asignación definido de v
antes de arg1 es el mismo que el estado de v antes de expr.
Para cada argumento argi, el estado de asignación definido de v después de argi
viene determinado por las reglas de expresión normal, omitiendo los ref
modificadores o out .
Para cada argumento argi para cualquier i mayor que uno, el estado de asignación
definitiva de v antes argi es el mismo que el estado de v después de la anterior
arg.
Si la variable v se pasa como argumento (es decir, un argumento con el formato )
en cualquiera de los out argumentos, el estado de v después de out v expr se
asigna definitivamente. De lo contrario; el estado de v después de expr es el mismo
que el estado de v después de argN.
Para inicializadores de matriz (expresionesde creación dematrices),inicializadores
de objeto (inicializadores de objeto), inicializadores de colección(inicializadoresde
colección) e inicializadores de objeto anónimos (expresiones de creación de
objetosanónimos),el estado de asignación definido viene determinado por la
expansión de la que se definen estas construcciones en términos de .

Expresiones de asignación simples

Para una expresión expr con el formato w = expr_rhs :

El estado de asignación definido de v antes expr_rhs es el mismo que el estado de

asignación definido de v antes de expr.
El estado de asignación definido de v después de expr viene determinado por:
Si w es la misma variable que v, el estado de asignación definido de v después
de expr se asigna definitivamente.
De lo contrario, si la asignación se produce dentro del constructor de instancia
de un tipo struct, si w es un acceso de propiedad que designa una propiedad
implementada automáticamente P en la instancia que se está construyendo y v
es el campo de respaldo oculto de P, el estado de asignación definitiva de v
después de expr se asigna definitivamente.
De lo contrario, el estado de asignación definitiva de v después de expr es el
mismo que el estado de asignación definitiva de v después de expr_rhs.
&& expresiones (AND condicionales)
Para un expr de expresión con el formato expr_first && expr_second :

El estado de asignación definitiva de v antes expr_first es el mismo que el estado

de asignación definitiva de v antes de expr.
El estado de asignación definitiva de v antes de expr_second se asigna
definitivamente si el estado de v después de expr_first se asigna definitivamente o
"se asigna definitivamente después de la expresión verdadera". De lo contrario, no
se asigna definitivamente.
El estado de asignación definitiva de v después de expr viene determinado por:
Si expr_first es una expresión constante con el valor , el estado de asignación
definitiva de v después de false expr es el mismo que el estado de asignación
definido de v después de expr_first.
De lo contrario, si el estado de v expr_first se asigna definitivamente, el estado
de v después de expr se asigna definitivamente.
De lo contrario, si el estado de v después de expr_second se asigna
definitivamente y el estado de v después de expr_first es "definitivamente
asignado después de la expresión false", el estado de v después de expr se
asigna definitivamente.
De lo contrario, si el estado de v después de expr_second se asigna
definitivamente o "se asigna definitivamente después de la expresión
verdadera", el estado de v después de expr se "asigna definitivamente después
de la expresión verdadera".
De lo contrario, si el estado de v después de expr_first es "asignado
definitivamente después de la expresión falsa" y el estado de v después de
expr_second se "asigna definitivamente después de la expresión falsa", el estado
de v después de expr se "asigna definitivamente después de la expresión falsa".
De lo contrario, el estado de v después de expr no se asigna definitivamente.

En el ejemplo

C#

class A

static void F(int x, int y) {

int i;

if (x >= 0 && (i = y) >= 0) {

// i definitely assigned

else {

// i not definitely assigned

// i not definitely assigned

La variable i se considera definitivamente asignada en una de las instrucciones

incrustadas de una if instrucción, pero no en la otra. En la instrucción del método , la
variable se asigna definitivamente en la primera instrucción incrustada porque la
ejecución de la expresión siempre precede a if la ejecución de esta instrucción F i (i
= y) incrustada. Por el contrario, la variable no se asigna definitivamente en la segunda

instrucción incrustada, ya que podría haber probado false, lo que da lugar a que la
variable no i x >= 0 esté i asignada.

|| Expresiones (OR condicionales)

Para una expresión expr con el formato expr_first || expr_second :

El estado de asignación definido de v antes expr_first es el mismo que el estado de

asignación definido de v antes de expr.
El estado de asignación definido de v antes de expr_second se asigna
definitivamente si el estado de v después de expr_first se asigna definitivamente o
"se asigna definitivamente después de la expresión falsa". De lo contrario, no se
asigna definitivamente.
La instrucción de asignación definitiva de v después de expr viene determinada por:
Si expr_first es una expresión constante con el valor , el estado de asignación
definido de v después de true expr es el mismo que el estado de asignación
definido de v después de expr_first.
De lo contrario, si el estado de v después de expr_first está asignado
definitivamente, el estado de v después de expr se asigna definitivamente.
De lo contrario, si el estado de v después de expr_second se asigna
definitivamente y el estado de v después de expr_first es "definitivamente
asignado después de la expresión verdadera", el estado de v después de expr se
asigna definitivamente.
De lo contrario, si el estado de v después de expr_second se asigna
definitivamente o "se asigna definitivamente después de la expresión falsa", el
estado de v después de expr se "asigna definitivamente después de la expresión
falsa".
De lo contrario, si el estado de v después de expr_first es "definitivamente
asignado después de la expresión verdadera" y el estado de v después de
expr_second se "asigna definitivamente después de la expresión verdadera", el
estado de v después de expr se "asigna definitivamente después de la expresión
verdadera".
 De lo contrario, el estado de v después de expr no se asigna definitivamente.

En el ejemplo

C#

class A

static void G(int x, int y) {

int i;

if (x >= 0 || (i = y) >= 0) {

// i not definitely assigned

else {

// i definitely assigned

// i not definitely assigned

la variable i se considera asignada definitivamente en una de las instrucciones

insertadas de una if instrucción, pero no en la otra. En la instrucción del método , la
variable se asigna definitivamente en la segunda instrucción incrustada porque la
ejecución de la expresión siempre precede a la if ejecución de esta instrucción G i (i
= y) incrustada. Por el contrario, la variable no se asigna definitivamente en la primera

instrucción incrustada, ya que podría haber probado true, lo que da lugar a que la
variable no i x >= 0 esté i asignada.

! Expresiones (negación lógica)

Para un expr de expresión con el formato ! expr_operand :

El estado de asignación definitiva de v antes expr_operand es el mismo que el

estado de asignación definitiva de v antes de expr.
El estado de asignación definitiva de v después de expr viene determinado por:
Si el estado de v después de *expr_operand *está asignado definitivamente, el
estado de v después de expr se asigna definitivamente.
Si el estado de v después de *expr_operand *no está asignado definitivamente,
el estado de v después de expr no se asigna definitivamente.
Si el estado de v después de *expr_operand *está "asignado definitivamente
después de la expresión falsa", el estado de v después de expr se "asigna
definitivamente después de la expresión verdadera".
Si el estado de v después de *expr_operand *está "asignado definitivamente
después de la expresión verdadera", el estado de v después de expr se "asigna
 definitivamente después de la expresión falsa".

?? Expresiones (uso de valores NULL)

Para un expr de expresión con el formato expr_first ?? expr_second :

El estado de asignación definido de v antes expr_first es el mismo que el estado de

asignación definido de v antes de expr.
El estado de asignación definido de v antes expr_second es el mismo que el estado
de asignación definido de v después de expr_first.
La instrucción de asignación definitiva de v después de expr viene determinada por:
Si expr_first es una expresión constante (Expresionesconstantes ) con valor
NULL, el estado de v después de expr es el mismo que el estado de v después
de expr_second.
De lo contrario, el estado de v después de expr es el mismo que el estado de
asignación definido de v después de expr_first.

?: expresiones (condicionales)
Para un expr de expresión con el formato expr_cond ? expr_true : expr_false :

El estado de asignación definido de v antes expr_cond es el mismo que el estado

de v antes de expr.
El estado de asignación definido de v antes de expr_true se asigna definitivamente
si y solo si se mantiene una de las siguientes opciones:
expr_cond es una expresión constante con el valor false
el estado de v después de expr_cond se asigna definitivamente o
"definitivamente asignado después de la expresión verdadera".
El estado de asignación definitiva de v antes de expr_false se asigna
definitivamente si y solo si se mantiene una de las siguientes opciones:
expr_cond es una expresión constante con el valor true
el estado de v después de expr_cond se asigna definitivamente o
"definitivamente asignado después de la expresión falsa".
El estado de asignación definitiva de v después de expr viene determinado por:
Si expr_cond es una expresión constante (Expresionesconstantes ) con valor , el
estado de v después de true expr es el mismo que el estado de v después de
expr_true.
De lo contrario, si expr_cond es una expresión constante (Expresionesconstantes
) con valor , el estado de v después de false expr es el mismo que el estado de
v después de expr_false.
 De lo contrario, si el estado de v después de expr_true se asigna definitivamente
y el estado de v después de expr_false se asigna definitivamente, el estado de v
después de expr se asigna definitivamente.
De lo contrario, el estado de v después de expr no se asigna definitivamente.

Funciones anónimas

Para un lambda_expression o anonymous_method_expression con un cuerpo (bloque o

expresión ):

El estado de asignación definitiva de una variable externa v antes del cuerpo es el

mismo que el estado de v antes de expr. Es decir, el estado de asignación definido
de las variables externas se hereda del contexto de la función anónima.
El estado de asignación definitiva de una variable externa v después de expr es el
mismo que el estado de v antes de expr.

En el ejemplo

C#

delegate bool Filter(int i);

void F() {

int max;

// Error, max is not definitely assigned

Filter f = (int n) => n < max;

max = 5;

DoWork(f);

genera un error en tiempo de compilación, ya max que no se asigna definitivamente

donde se declara la función anónima. En el ejemplo

C#

delegate void D();

void F() {

int n;

D d = () => { n = 1; };

d();

// Error, n is not definitely assigned

 Console.WriteLine(n);

también genera un error en tiempo de compilación, ya que la asignación a en la función

anónima no afecta al estado de asignación definido de fuera de n n la función
anónima.

Referencias de variables
Un variable_reference es una expresión que se clasifica como una variable. Un
variable_reference indica una ubicación de almacenamiento a la que se puede acceder
tanto para capturar el valor actual como para almacenar un nuevo valor.

antlr

variable_reference

: expression

En C y C++, una variable_reference se conoce como valor L.

Atomicidad de las referencias de variables

Las lecturas y escrituras de los siguientes tipos de datos son atómicas: bool , , , , , , , , y
char tipos de byte sbyte short ushort uint int float referencia. Además, las
lecturas y escrituras de tipos de enumeración con un tipo subyacente en la lista anterior
también son atómicas. No se garantiza que las lecturas y escrituras de otros tipos, como
, , y , así como los tipos definidos por el long ulong double decimal usuario, sean
atómicas. Aparte de las funciones de biblioteca diseñadas para ese propósito, no hay
ninguna garantía de lectura-modificación-escritura atómica, como en el caso de
incremento o decremento.
Conversiones
Artículo • 16/09/2021 • Tiempo de lectura: 49 minutos

Una *conversión _ permite tratar una expresión como si se tratase de un tipo

determinado. Una conversión puede hacer que una expresión de un tipo determinado
se trate como si tuviera un tipo diferente o que una expresión sin un tipo obtenga un
tipo. Las conversiones pueden ser implícitas o _ explícitas *, y esto determina si se
requiere una conversión explícita. Por ejemplo, la conversión del tipo int al tipo long
es implícita, por lo que las expresiones de tipo se int pueden tratar implícitamente
como de tipo long . La conversión opuesta, del tipo long al tipo int , es explícita y, por
tanto, se requiere una conversión explícita.

C#

int a = 123;

long b = a; // implicit conversion from int to long

int c = (int) b; // explicit conversion from long to int

Algunas conversiones están definidas por el lenguaje. Los programas también pueden
definir sus propias conversiones (conversiones definidas por el usuario).

Conversiones implícitas
Las conversiones siguientes se clasifican como conversiones implícitas:

Conversiones de identidad
Conversiones numéricas implícitas
Conversiones de enumeración implícitas
Conversiones de cadenas interpoladas IMPLÍCITAS
Conversiones implícitas que aceptan valores NULL
Conversiones de literales null
Conversiones de referencias implícitas
Conversiones Boxing
Conversiones dinámicas IMPLÍCITAS
Conversiones implícitas de expresiones constantes
Conversiones implícitas definidas por el usuario
Conversiones de función anónima
Conversiones de grupos de métodos

Las conversiones implícitas pueden producirse en diversas situaciones, incluidas las

invocaciones de miembros de función (comprobación en tiempo de compilación de la
resolución dinámica de sobrecarga), las expresiones de conversión (expresiones de
conversión) y las asignaciones (operadores deasignación).

Las conversiones implícitas predefinidas siempre se realizan correctamente y nunca

provocan que se inicien excepciones. Las conversiones implícitas definidas por el usuario
diseñadas correctamente deberían presentar también estas características.

En lo que respecta a la conversión, los tipos object y dynamic se consideran

equivalentes.

Sin embargo, las conversiones dinámicas (conversiones dinámicasimplícitas y

conversiones dinámicas explícitas) solo se aplican a las expresiones de tipo dynamic (el
tipo dinámico).

Conversión de identidad
Una conversión de identidad convierte de cualquier tipo al mismo tipo. Esta conversión
existe de manera que se puede decir que una entidad que ya tiene un tipo necesario se
puede convertir en ese tipo.

Dado object dynamic que y se consideran equivalentes, hay una conversión de

identidad entre object y dynamic , y entre los tipos construidos que son iguales al
reemplazar todas las apariciones de dynamic por object .

Conversiones numéricas implícitas

Las conversiones numéricas implícitas son:

De sbyte a short , int ,,, long float double o decimal .

De byte a short , ushort , int , uint , long , ulong , float , double o decimal .
De short a int , long , float , double o decimal .
De ushort a int , uint , long , ulong , float , double o decimal .
De int a long , float , double o decimal .
De uint a long , ulong , float , double o decimal .
De long a float , double o decimal .
De ulong a float , double o decimal .
De char a ushort , int , uint , long , ulong , float , double o decimal .
De float a double .

Las conversiones de int , uint , long o ulong a float y desde long o ulong a double
pueden provocar una pérdida de precisión, pero nunca producirán una pérdida de
magnitud. El resto de conversiones numéricas implícitas nunca pierden información.

No hay conversiones implícitas al char tipo, por lo que los valores de los otros tipos
enteros no se convierten automáticamente al char tipo.

Conversiones de enumeración implícitas

Una conversión de enumeración implícita permite convertir el decimal_integer_literal 0
en cualquier enum_type y en cualquier nullable_type cuyo tipo subyacente sea un
enum_type. En el último caso, la conversión se evalúa convirtiendo en el enum_type
subyacente y ajustando el resultado (tipos que aceptan valores NULL).

Conversiones de cadenas interpoladas IMPLÍCITAS

Una conversión de cadena interpolada implícita permite convertir un
interpolated_string_expression (cadenas interpoladas) en System.IFormattable o
System.FormattableString (que implementa System.IFormattable ).

Cuando se aplica esta conversión, un valor de cadena no se compone de la cadena

interpolada. En su lugar System.FormattableString , se crea una instancia de, tal y como
se describe en cadenas interpoladas.

Conversiones implícitas que aceptan valores NULL

Las conversiones implícitas predefinidas que operan en tipos de valor que no aceptan
valores null también se pueden usar con formas que aceptan valores NULL de esos
tipos. Para cada una de las conversiones implícitas y numéricas predefinidas que
convierten de un tipo de valor que no acepta valores NULL S a un tipo de valor que no
acepta valores NULL T , existen las siguientes conversiones implícitas que aceptan
valores NULL:

Una conversión implícita de S? a T? .

Una conversión implícita de S a T? .

La evaluación de una conversión implícita que acepta valores NULL en función de una
conversión subyacente de S a T continúa como sigue:

Si la conversión que acepta valores NULL es de S? a T? :

Si el valor de origen es null ( HasValue la propiedad es false), el resultado es el
valor null de tipo T? .
 De lo contrario, la conversión se evalúa como un desajuste de S? a S , seguido
de la conversión subyacente de S a T , seguida de un ajuste (tipos que aceptan
valores NULL) de T a T? .

Si la conversión que acepta valores NULL es de S a T? , la conversión se evalúa

como la conversión subyacente de S a T seguida de un ajuste de T a T? .

Conversiones de literales null

Existe una conversión implícita del null literal a cualquier tipo que acepte valores NULL.
Esta conversión genera el valor null (tipos que aceptan valores NULL) del tipo que
acepta valores NULL dado.

Conversiones de referencias implícitas

Las conversiones de referencia implícitas son:

Desde cualquier reference_type hasta object y dynamic .

Desde cualquier class_type S a cualquier class_type T , proporcionado S se deriva
de T .
De cualquier class_type S a cualquier interface_type T , proporcionado S
implementa T .
Desde cualquier interface_type S a cualquier interface_type T , proporcionado S se
deriva de T .
En un array_type S con un tipo de elemento SE a un array_type T con un tipo de
elemento TE , siempre que se cumplan todas las condiciones siguientes:
S y T solo difieren en el tipo de elemento. En otras palabras, S y T tienen el

mismo número de dimensiones.

SE Y TE son reference_type s.
Existe una conversión de referencia implícita de SE a TE .
Desde cualquier array_type hasta System.Array y las interfaces que implementa.
Desde un tipo de matriz unidimensional S[] hasta
System.Collections.Generic.IList<T> y sus interfaces base, siempre que haya una

conversión implícita de identidad o de referencia de S a T .

Desde cualquier delegate_type hasta System.Delegate y las interfaces que
implementa.
Del literal null a cualquier reference_type.
Desde cualquier reference_type a un reference_type T si tiene una conversión
implícita o de referencia a un reference_type T0 y T0 tiene una conversión de
 identidad en T .
Desde cualquier reference_type a un tipo de interfaz o delegado T si tiene una
conversión implícita o de referencia a una interfaz o un tipo de delegado T0 y T0
es convertible en varianza (conversión de varianza) en T .
Conversiones implícitas que implican parámetros de tipo que se sabe que son
tipos de referencia. Vea conversiones implícitas que implican parámetros de tipo
para obtener más información sobre las conversiones implícitas que implican
parámetros de tipo.

Las conversiones de referencia implícitas son las conversiones entre reference_type s que
se pueden demostrar que siempre se realizan correctamente y, por tanto, no requieren
comprobaciones en tiempo de ejecución.

Las conversiones de referencia, implícitas o explícitas, nunca cambian la identidad

referencial del objeto que se va a convertir. En otras palabras, aunque una conversión de
referencia puede cambiar el tipo de la referencia, nunca cambia el tipo o valor del
objeto al que se hace referencia.

Conversiones Boxing
Una conversión boxing permite que un value_type se convierta implícitamente en un
tipo de referencia. Existe una conversión boxing de cualquier non_nullable_value_type a
object and dynamic , a System.ValueType y a cualquier interface_type implementado por

el non_nullable_value_type. Además, un enum_type se puede convertir al tipo

System.Enum .

Existe una conversión boxing de una nullable_type a un tipo de referencia, solo si existe
una conversión boxing del non_nullable_value_type subyacente al tipo de referencia.

Un tipo de valor tiene una conversión boxing a un tipo de interfaz I si tiene una
conversión boxing a un tipo de interfaz I0 y I0 tiene una conversión de identidad en I
.

Un tipo de valor tiene una conversión boxing a un tipo de interfaz I si tiene una
conversión boxing a un tipo de interfaz o delegado I0 y I0 se convierte en varianza
(conversión de varianza) en I .

La conversión boxing de un valor de una non_nullable_value_type consiste en asignar

una instancia de objeto y copiar el valor de value_type en esa instancia. Se puede aplicar
la conversión boxing a un struct al tipo System.ValueType , ya que es una clase base
para todos los Structs (herencia).
La conversión boxing de un valor de una nullable_type procede de la siguiente manera:

Si el valor de origen es null ( HasValue la propiedad es false), el resultado es una

referencia nula del tipo de destino.
De lo contrario, el resultado es una referencia a una conversión boxing T generada
al desempaquetar y aplicar la conversión boxing al valor de origen.

Las conversiones Boxing se describen con más detalle en conversiones boxing.

Conversiones dinámicas IMPLÍCITAS

Existe una conversión dinámica implícita de una expresión de tipo dynamic a cualquier
tipo T . La conversión está enlazada dinámicamente (enlace dinámico), lo que significa
que se buscará una conversión implícita en tiempo de ejecución desde el tipo en tiempo
de ejecución de la expresión hasta T . Si no se encuentra ninguna conversión, se
produce una excepción en tiempo de ejecución.

Tenga en cuenta que esta conversión implícita aparentemente infringe el Consejo en el

principio de las conversiones implícitas que una conversión implícita nunca debe
producir una excepción. Sin embargo, no es la propia conversión, sino la búsqueda de la
conversión que produce la excepción. El riesgo de que se produzcan excepciones en
tiempo de ejecución es inherente al uso del enlace dinámico. Si no se desea el enlace
dinámico de la conversión, la expresión se puede convertir primero a object y, a
continuación, al tipo deseado.

En el ejemplo siguiente se muestran las conversiones dinámicas implícitas:

C#

object o = "object"

dynamic d = "dynamic";

string s1 = o; // Fails at compile-time -- no conversion exists

string s2 = d; // Compiles and succeeds at run-time

int i = d; // Compiles but fails at run-time -- no conversion exists

Las asignaciones a s2 y i ambos emplean conversiones dinámicas IMPLÍCITAS, donde

el enlace de las operaciones se suspende hasta el tiempo de ejecución. En tiempo de
ejecución, las conversiones implícitas se buscan desde el tipo en tiempo de ejecución
de, d -- string hasta el tipo de destino. Una conversión se encuentra en string pero
no en int .

Conversiones implícitas de expresiones constantes

Una conversión de expresión constante implícita permite las siguientes conversiones:

Un constant_expression (expresiones constantes) de tipo int se puede convertir al

tipo sbyte , byte , short , ushort , uint o ulong , siempre que el valor de la
constant_expression esté dentro del intervalo del tipo de destino.
Un constant_expression de tipo long se puede convertir al tipo ulong , siempre
que el valor de la constant_expression no sea negativo.

Conversiones implícitas que implican parámetros de tipo

Existen las siguientes conversiones implícitas para un parámetro de tipo determinado T
:

De T a su clase base efectiva C , de T a cualquier clase base de C y de T a

cualquier interfaz implementada por C . En tiempo de ejecución, si T es un tipo de
valor, la conversión se ejecuta como conversión boxing. De lo contrario, la
conversión se ejecuta como una conversión de referencia implícita o una
conversión de identidad.
De T a un tipo de interfaz I en un T conjunto de interfaz eficaz y de T a
cualquier interfaz base de I . En tiempo de ejecución, si T es un tipo de valor, la
conversión se ejecuta como conversión boxing. De lo contrario, la conversión se
ejecuta como una conversión de referencia implícita o una conversión de
identidad.
De T a un parámetro de tipo U , proporcionado T depende de U (restricciones de
parámetro detipo). En tiempo de ejecución, si U es un tipo de valor, T y U son
necesariamente el mismo tipo y no se realiza ninguna conversión. De lo contrario,
si T es un tipo de valor, la conversión se ejecuta como una conversión boxing. De
lo contrario, la conversión se ejecuta como una conversión de referencia implícita
o una conversión de identidad.
Desde el literal null hasta T , T se sabe que se trata de un tipo de referencia.
De T a un tipo de referencia I si tiene una conversión implícita a un tipo de
referencia S0 y S0 tiene una conversión de identidad en S . En tiempo de
ejecución, la conversión se ejecuta de la misma forma que la conversión a S0 .
De T a un tipo de interfaz I si tiene una conversión implícita a un tipo de interfaz
o delegado I0 y I0 se pueden convertir en varianza I (conversión devarianza). En
tiempo de ejecución, si T es un tipo de valor, la conversión se ejecuta como
conversión boxing. De lo contrario, la conversión se ejecuta como una conversión
de referencia implícita o una conversión de identidad.
Si T se sabe que es un tipo de referencia (restricciones de parámetro de tipo), las
conversiones anteriores se clasifican como conversiones de referencia IMPLÍCITAS
(conversiones de referencia implícita). Si T no se sabe que es un tipo de referencia, las
conversiones anteriores se clasifican como conversiones Boxing (conversionesBoxing).

Conversiones implícitas definidas por el usuario

Una conversión implícita definida por el usuario se compone de una conversión
implícita estándar opcional, seguida de una ejecución de un operador de conversión
implícita definido por el usuario, seguida de otra conversión implícita estándar opcional.
Las reglas exactas para evaluar las conversiones implícitas definidas por el usuario se
describen en procesamiento de conversiones implícitas definidas por el usuario.

Conversiones de funciones anónimas y conversiones de

grupos de métodos
Las funciones anónimas y los grupos de métodos no tienen tipos en y, pero se pueden
convertir implícitamente en tipos de delegado o tipos de árbol de expresión. Las
conversiones de función anónima se describen con más detalle en conversiones de
funciones anónimas y conversiones de grupos de métodos en conversiones de grupos
de métodos.

Conversiones explícitas
Las conversiones siguientes se clasifican como conversiones explícitas:

Todas las conversiones implícitas.

Conversiones numéricas explícitas.
Conversiones de enumeración explícitas.
Conversiones explícitas que aceptan valores NULL.
Conversiones de referencia explícitas.
Conversiones explícitas de la interfaz.
Conversiones unboxing.
Conversiones dinámicas explícitas
Conversiones explícitas definidas por el usuario.

Las conversiones explícitas pueden producirse en expresiones de conversión

(expresiones de conversión).

El conjunto de conversiones explícitas incluye todas las conversiones implícitas. Esto

significa que se permiten expresiones de conversión redundantes.
Las conversiones explícitas que no son conversiones implícitas son conversiones que no
se pueden demostrar que siempre se realizan correctamente, conversiones en las que se
sabe que podrían perder información y conversiones entre dominios de tipos lo
suficientemente diferentes como para merecen la notación explícita.

Conversiones numéricas explícitas

Las conversiones numéricas explícitas son las conversiones de un numeric_type a otro
numeric_type para el que no existe una conversión numérica implícita (Conversiones
numéricas implícitas):

De sbyte a byte , ushort , uint , ulong o char .

Desde byte hasta sbyte y char .
De short a sbyte , byte ,,, ushort uint ulong o char .
De ushort a sbyte , byte , short o char .
De int a sbyte , byte , short , ushort , uint , ulong o char .
De uint a sbyte , byte ,,, short ushort int o char .
De long a sbyte , byte , short , ushort , int , uint , ulong o char .
De ulong a sbyte , byte , short , ushort , int , uint , long o char .
De char a sbyte , byte o short .
De float a sbyte , byte , short , ushort , int , uint , long , ulong , char o
decimal .

De double a sbyte , byte , short , ushort , int , uint , long , ulong , char ,
float o decimal .

De decimal a sbyte , byte , short , ushort , int , uint , long , ulong , char ,
float o double .

Dado que las conversiones explícitas incluyen todas las conversiones numéricas
implícitas y explícitas, siempre es posible convertir de cualquier numeric_type a cualquier
otra numeric_type mediante una expresión de conversión (expresiones de conversión).

Las conversiones numéricas explícitas podrían perder información o provocar que se

produzcan excepciones. Una conversión numérica explícita se procesa de la siguiente
manera:

En el caso de una conversión de un tipo entero a otro tipo entero, el

procesamiento depende del contexto de comprobación de desbordamiento (los
operadores comprobados y sin comprobar) en el que tiene lugar la conversión:
En un checked contexto, la conversión se realiza correctamente si el valor del
operando de origen está dentro del intervalo del tipo de destino, pero produce
 una excepción System.OverflowException si el valor del operando de origen está
fuera del intervalo del tipo de destino.
En un unchecked contexto, la conversión siempre se realiza correctamente y
continúa como se indica a continuación.
Si el tipo de origen es mayor que el tipo de destino, el valor de origen se
trunca al descartar sus bits "extra" más significativos. El resultado se trata
como un valor del tipo de destino.
Si el tipo de origen es menor que el tipo de destino, el valor de origen se
amplía mediante signos o ceros para que tenga el mismo tamaño que el tipo
de destino. La ampliación mediante signos se usa si el tipo de origen tiene
signo; se emplea ampliación mediante ceros si el tipo de origen no tiene
signo. El resultado se trata como un valor del tipo de destino.
Si el tipo de origen es del mismo tamaño que el tipo de destino, el valor de
origen se trata como un valor del tipo de destino.
En el caso de una conversión de decimal a un tipo entero, el valor de origen se
redondea hacia cero al valor entero más cercano, y este valor entero se convierte
en el resultado de la conversión. Si el valor entero resultante está fuera del
intervalo del tipo de destino, System.OverflowException se produce una excepción.
En el caso de una conversión de float o double a un tipo entero, el
procesamiento depende del contexto de comprobación de desbordamiento (los
operadores comprobados y sin comprobar) en el que tiene lugar la conversión:
En un checked contexto, la conversión se realiza de la siguiente manera:
Si el valor del operando es NaN o infinito, System.OverflowException se
produce una excepción.
De lo contrario, el operando de origen se redondea hacia cero al valor entero
más cercano. Si este valor entero está dentro del intervalo del tipo de
destino, este valor es el resultado de la conversión.
De lo contrario, se produce una excepción System.OverflowException .
En un unchecked contexto, la conversión siempre se realiza correctamente y
continúa como se indica a continuación.
Si el valor del operando es NaN o infinito, el resultado de la conversión es un
valor no especificado del tipo de destino.
De lo contrario, el operando de origen se redondea hacia cero al valor entero
más cercano. Si este valor entero está dentro del intervalo del tipo de
destino, este valor es el resultado de la conversión.
De lo contrario, el resultado de la conversión es un valor no especificado del
tipo de destino.
En el caso de una conversión de double a float , el double valor se redondea al
float valor más próximo. Si el double valor es demasiado pequeño para
representarlo como un float , el resultado es cero positivo o cero negativo. Si el
 double valor es demasiado grande para representarlo como un float , el

resultado se convierte en infinito positivo o infinito negativo. Si el double valor es

Nan, el resultado es también Nan.
En el caso de una conversión de float o double a decimal , el valor de origen se
convierte en decimal representación y se redondea al número más cercano
después de la posición decimal 28 si es necesario (el tipo decimal). Si el valor de
origen es demasiado pequeño para representarlo como un decimal , el resultado
se convierte en cero. Si el valor de origen es NaN, infinito o demasiado grande
para representarse como decimal , System.OverflowException se produce una
excepción.
En el caso de una conversión de decimal a float o double , el decimal valor se
redondea al double valor o más próximo float . Aunque esta conversión puede
perder precisión, nunca provoca que se produzca una excepción.

Conversiones de enumeración explícitas

Las conversiones de enumeración explícitas son:

De sbyte , byte , short , ushort , int , uint , long , ulong , char , float ,
double o decimal a cualquier enum_type.
Desde cualquier enum_type a sbyte , byte , short , ushort , int , uint , long ,
ulong ,,, char float double o decimal .

Desde cualquier enum_type a cualquier otro enum_type.

Una conversión de enumeración explícita entre dos tipos se procesa tratando cualquier
enum_type participante como el tipo subyacente de ese enum_type y, a continuación,
realizando una conversión numérica implícita o explícita entre los tipos resultantes. Por
ejemplo, dada una enum_type E con y el tipo subyacente de int , una conversión de E
a byte se procesa como una conversión numérica explícita (Conversiones numéricas
explícitas) de int a byte , y una conversión de byte a E se procesa como una
conversión numérica implícita (conversionesnuméricas implícitas) de byte a int .

Conversiones explícitas que aceptan valores NULL

Las conversiones explícitas que aceptan valores NULL permiten conversiones explícitas
explícitas que operan en tipos de valor que no aceptan valores NULL para usarse
también con formas que aceptan valores NULL de esos tipos. Para cada una de las
conversiones explícitas predefinidas que convierten de un tipo de valor que no acepta
valores NULL S a un tipo de valor que no acepta valores NULL T (conversión de
identidad, conversiones numéricas implícitas, conversiones de enumeración implícita,
Conversiones numéricas explícitasy conversiones de enumeración explícita), existen las
siguientes conversiones que aceptan valores NULL:

Una conversión explícita de S? a T? .

Una conversión explícita de S a T? .
Una conversión explícita de S? a T .

La evaluación de una conversión que acepta valores NULL en función de una conversión
subyacente de S a T continúa como sigue:

Si la conversión que acepta valores NULL es de S? a T? :

Si el valor de origen es null ( HasValue la propiedad es false), el resultado es el
valor null de tipo T? .
De lo contrario, la conversión se evalúa como un desajuste de S? a S , seguido
de la conversión subyacente de S a T , seguida de un ajuste de T a T? .
Si la conversión que acepta valores NULL es de S a T? , la conversión se evalúa
como la conversión subyacente de S a T seguida de un ajuste de T a T? .
Si la conversión que acepta valores NULL es de S? a T , la conversión se evalúa
como un desajuste de S? a S seguido de la conversión subyacente de S a T .

Tenga en cuenta que un intento de desencapsular un valor que acepta valores null
producirá una excepción si el valor es null .

Conversiones de referencia explícitas

Las conversiones de referencia explícitas son:

Desde object y dynamic hasta cualquier otro reference_type.

Desde cualquier class_type S a cualquier class_type T , proporcionado S es una
clase base de T .
De cualquier class_type S a cualquier interface_type T , proporcionado no S está
sellado y se proporciona no S implementa T .
De cualquier interface_type S a cualquier class_type T , proporcionado T no es
una implementación sellada o proporcionada T S .
Desde cualquier interface_type S a cualquier interface_type T , proporcionado S
no se deriva de T .
En un array_type S con un tipo de elemento SE a un array_type T con un tipo de
elemento TE , siempre que se cumplan todas las condiciones siguientes:
S y T solo difieren en el tipo de elemento. En otras palabras, S y T tienen el
mismo número de dimensiones.
 SE Y TE son reference_type s.

Existe una conversión de referencia explícita de SE a TE .

Desde System.Array y las interfaces que implementa en cualquier array_type.
Desde un tipo de matriz unidimensional S[] hasta
System.Collections.Generic.IList<T> y sus interfaces base, siempre que haya una

conversión de referencia explícita de S a T .

Desde System.Collections.Generic.IList<S> y sus interfaces base a un tipo de
matriz unidimensional T[] , siempre que haya una conversión explícita de
identidad o de referencia de S a T .
Desde System.Delegate y las interfaces que implementa en cualquier
delegate_type.
Desde un tipo de referencia a un tipo de referencia T si tiene una conversión de
referencia explícita a un tipo de referencia T0 y T0 tiene una conversión de
identidad T .
Desde un tipo de referencia a un tipo de interfaz o delegado T si tiene una
conversión de referencia explícita a una interfaz o un tipo de delegado T0 y T0 se
puede convertir en varianza o es convertible en T T T0 (conversión devarianza).
Desde D<S1...Sn> hasta D<T1...Tn> donde D<X1...Xn> es un tipo de delegado
genérico, D<S1...Sn> no es compatible con o es idéntico a D<T1...Tn> , y para
cada parámetro Xi de tipo de D los siguientes elementos:
Si Xi es invariable, Si es idéntico a Ti .
Si Xi es covariante, hay una identidad implícita o explícita o una conversión de
referencia de Si a Ti .
Si Xi es contravariante, Si y Ti son idénticos o ambos tipos de referencia.
Conversiones explícitas que implican parámetros de tipo que se sabe que son tipos
de referencia. Para obtener más información sobre las conversiones explícitas que
implican parámetros de tipo, vea conversiones explícitas que implican parámetros
de tipo.

Las conversiones de referencia explícitas son esas conversiones entre los tipos de
referencia que requieren comprobaciones en tiempo de ejecución para asegurarse de
que son correctas.

Para que una conversión de referencia explícita se realice correctamente en tiempo de

ejecución, el valor del operando de origen debe ser null , o el tipo real del objeto al
que hace referencia el operando de origen debe ser un tipo que se pueda convertir al
tipo de destino mediante una conversión de referencia implícita (conversiones de
referencia implícita) o una conversión boxing (conversiones boxing). Si se produce un
error en una conversión de referencia explícita, System.InvalidCastException se produce
una excepción.

Las conversiones de referencia, implícitas o explícitas, nunca cambian la identidad

referencial del objeto que se va a convertir. En otras palabras, aunque una conversión de
referencia puede cambiar el tipo de la referencia, nunca cambia el tipo o valor del
objeto al que se hace referencia.

Conversiones unboxing
Una conversión unboxing permite que un tipo de referencia se convierta explícitamente
en un value_type. Existe una conversión unboxing de los tipos object , dynamic y
System.ValueType en cualquier non_nullable_value_type y desde cualquier interface_type
a cualquier non_nullable_value_type que implemente el interface_type. Además,
System.Enum se puede aplicar la conversión unboxing a cualquier enum_type.

Existe una conversión unboxing de un tipo de referencia a un nullable_type si existe una

conversión unboxing del tipo de referencia al non_nullable_value_type subyacente de la
nullable_type.

Un tipo S de valor tiene una conversión unboxing de un tipo de interfaz I si tiene una
conversión unboxing de un tipo de interfaz I0 y I0 tiene una conversión de identidad
en I .

Un tipo S de valor tiene una conversión unboxing de un tipo de interfaz I si tiene una
conversión unboxing de un tipo de interfaz o delegado, I0 y I0 se puede convertir en
varianza o ser convertible en I I I0 (conversión devarianza).

Una operación de conversión unboxing consiste en comprobar primero que la instancia

de objeto es un valor de conversión boxing del value_type especificado y, a
continuación, copiar el valor fuera de la instancia. Al aplicar la conversión unboxing a
una referencia nula a un nullable_type , se genera el valor null de la nullable_type. Se
puede aplicar la conversión unboxing a un struct del tipo System.ValueType , ya que es
una clase base para todos los Structs (herencia).

Las conversiones unboxing se describen con más detalle en conversiones unboxing.

Conversiones dinámicas explícitas

Existe una conversión dinámica explícita de una expresión de tipo dynamic a cualquier
tipo T . La conversión está enlazada dinámicamente (enlace dinámico), lo que significa
que se buscará una conversión explícita en tiempo de ejecución desde el tipo en tiempo
de ejecución de la expresión hasta T . Si no se encuentra ninguna conversión, se
produce una excepción en tiempo de ejecución.

Si no se desea el enlace dinámico de la conversión, la expresión se puede convertir

primero a object y, a continuación, al tipo deseado.

Supongamos que se define la clase siguiente:

C#

class C

int i;

public C(int i) { this.i = i; }

public static explicit operator C(string s)

return new C(int.Parse(s));

En el ejemplo siguiente se muestran las conversiones dinámicas explícitas:

C#

object o = "1";

dynamic d = "2";

var c1 = (C)o; // Compiles, but explicit reference conversion fails

var c2 = (C)d; // Compiles and user defined conversion succeeds

La mejor conversión de o a C se encuentra en tiempo de compilación para ser una

conversión de referencia explícita. Esto produce un error en tiempo de ejecución,
porque "1" no es en realidad C . La conversión de d a C sin embargo, como una
conversión dinámica explícita, se suspende en tiempo de ejecución, donde se encuentra
una conversión definida por el usuario del tipo en tiempo de ejecución de d -- string -
-a C , y se realiza correctamente.

Conversiones explícitas que implican parámetros de tipo

Existen las siguientes conversiones explícitas para un parámetro de tipo determinado T :

Desde la clase base efectiva C de T a T y desde cualquier clase base de C a T . En

tiempo de ejecución, si T es un tipo de valor, la conversión se ejecuta como
 conversión unboxing. De lo contrario, la conversión se ejecuta como una
conversión de referencia explícita o una conversión de identidad.
Desde cualquier tipo de interfaz a T . En tiempo de ejecución, si T es un tipo de
valor, la conversión se ejecuta como conversión unboxing. De lo contrario, la
conversión se ejecuta como una conversión de referencia explícita o una
conversión de identidad.
De T a cualquier interface_type I siempre y cuando no haya una conversión
implícita de T a I . En tiempo de ejecución, si T es un tipo de valor, la conversión
se ejecuta como una conversión boxing seguida de una conversión de referencia
explícita. De lo contrario, la conversión se ejecuta como una conversión de
referencia explícita o una conversión de identidad.
De un parámetro de tipo U a T , proporcionado T depende de U (restricciones de
parámetro detipo). En tiempo de ejecución, si U es un tipo de valor, T y U son
necesariamente el mismo tipo y no se realiza ninguna conversión. De lo contrario,
si T es un tipo de valor, la conversión se ejecuta como conversión unboxing. De lo
contrario, la conversión se ejecuta como una conversión de referencia explícita o
una conversión de identidad.

Si T se sabe que es un tipo de referencia, las conversiones anteriores se clasifican como

conversiones de referencia explícitas (conversiones de referencia explícita). Si T no se
sabe que es un tipo de referencia, las conversiones anteriores se clasifican como
conversiones unboxing (conversiones unboxing).

Las reglas anteriores no permiten una conversión explícita directa de un parámetro de

tipo sin restricciones a un tipo que no sea de interfaz, lo que podría ser sorprendente. La
razón de esta regla es evitar la confusión y hacer que la semántica de dichas
conversiones sea clara. Por ejemplo, consideremos la siguiente declaración:

C#

class X<T>

public static long F(T t) {

return (long)t; // Error

Si se permitía la conversión directa explícita de t a int , es posible que cabría esperar

que X<int>.F(7) devolvería   7L . Sin embargo, no lo haría, porque las conversiones
numéricas estándar solo se tienen en cuenta cuando se sabe que los tipos son
numéricos en tiempo de enlace. Para que la semántica esté clara, en su lugar se debe
escribir en el ejemplo anterior:
 C#

class X<T>

public static long F(T t) {

return (long)(object)t; // Ok, but will only work when T is

long

Este código se compilará ahora pero la ejecución X<int>.F(7) producirá una excepción
en tiempo de ejecución, ya que una conversión boxing int no se puede convertir
directamente a long .

Conversiones explícitas definidas por el usuario

Una conversión explícita definida por el usuario se compone de una conversión explícita
estándar opcional, seguida de una ejecución de un operador de conversión implícito o
explícito definido por el usuario, seguida de otra conversión explícita estándar opcional.
Las reglas exactas para evaluar las conversiones explícitas definidas por el usuario se
describen en procesamiento de conversiones explícitas definidas por el usuario.

Conversiones estándar
Las conversiones estándar son las conversiones predefinidas que pueden producirse
como parte de una conversión definida por el usuario.

Conversiones implícitas estándar

Las siguientes conversiones implícitas se clasifican como conversiones implícitas
estándar:

Conversiones de identidad (conversión de identidad)

Conversiones numéricas IMPLÍCITAS (Conversiones numéricas implícitas)
Conversiones implícitas que aceptan valores NULL (conversiones implícitas que
aceptan valores NULL)
Conversiones de referencia IMPLÍCITAS (conversiones de referencia implícitas)
Conversiones Boxing (conversiones boxing)
Conversiones implícitas de expresiones constantes (conversiones implícitas de
expresión constante)
Conversiones implícitas que implican parámetros de tipo (conversiones implícitas
que implican parámetros de tipo)
Las conversiones implícitas estándar excluyen específicamente las conversiones
implícitas definidas por el usuario.

Conversiones explícitas estándar

Las conversiones explícitas estándar son todas las conversiones implícitas estándar más
el subconjunto de las conversiones explícitas para las que existe una conversión
implícita estándar opuesta. En otras palabras, si existe una conversión implícita estándar
de un tipo A a un tipo B , existe una conversión explícita estándar del tipo A al tipo B y
del tipo B al tipo A .

Conversiones definidas por el usuario

C# permite aumentar las conversiones implícitas y explícitas predefinidas mediante
conversiones definidas por el usuario. Las conversiones definidas por el usuario se
introducen mediante la declaración de operadores de conversión (operadores de
conversión) en tipos de clase y estructura.

Conversiones permitidas definidas por el usuario

C# solo permite declarar determinadas conversiones definidas por el usuario. En
concreto, no es posible volver a definir una conversión implícita o explícita ya existente.

Para un tipo de origen S y tipo de destino determinados, T si S o T son tipos que

aceptan valores NULL, permiten S0 y T0 hacen referencia a sus tipos subyacentes, de lo
contrario, S0 y T0 son iguales a S y T respectivamente. Una clase o struct puede
declarar una conversión de un tipo de origen S a un tipo de destino T solo si se
cumplen todas las condiciones siguientes:

S0 y T0 son tipos diferentes.

S0 O T0 es el tipo de clase o estructura en el que tiene lugar la declaración del

operador.
Ni S0 ni T0 es un interface_type.
Sin incluir las conversiones definidas por el usuario, no existe una conversión de S
a T o de T a S .

Las restricciones que se aplican a las conversiones definidas por el usuario se explican
en los operadores de conversión.

Operadores de conversión de elevación

Dado un operador de conversión definido por el usuario que convierte de un tipo de
valor que no acepta valores NULL S a un tipo de valor que no acepta valores NULL T ,
existe un operador de conversión de elevación que convierte de S? en T? . Este
operador de conversión de elevación realiza un desajuste de S? a S seguido de la
conversión definida por el usuario de S a seguida de T un ajuste de T a, con la
excepción de T? que un valor null S? convierte directamente a un valor null T? .

Un operador de conversión de elevación tiene la misma clasificación implícita o explícita

que su operador de conversión definido por el usuario subyacente. El término
"conversión definida por el usuario" se aplica al uso de operadores de conversión
definidos por el usuario y de elevación.

Evaluación de conversiones definidas por el usuario

Una conversión definida por el usuario convierte un valor de su tipo, denominado
source Type _, a otro tipo, denominado tipo de _destino*.. La evaluación de una
conversión definida por el usuario se centra en buscar el operador de conversión
definido por el usuario "más específico" para los tipos de origen y destino concretos.
Esta determinación se divide en varios pasos:

Buscar el conjunto de clases y estructuras desde las que se considerarán los

operadores de conversión definidos por el usuario. Este conjunto está formado por
el tipo de origen y sus clases base, así como el tipo de destino y sus clases base
(con suposiciones implícitas de que solo las clases y los Structs pueden declarar
operadores definidos por el usuario, y que los tipos que no son de clase no tienen
clases base). Para los fines de este paso, si el tipo de origen o de destino es un
nullable_type, se utiliza en su lugar su tipo subyacente.
A partir de ese conjunto de tipos, determinar qué operadores de conversión
definidos por el usuario y de elevación son aplicables. Para que un operador de
conversión sea aplicable, debe ser posible realizar una conversión estándar
(conversiones estándar) del tipo de origen al tipo de operando del operador, y
debe ser posible realizar una conversión estándar del tipo de resultado del
operador al tipo de destino.
Del conjunto de operadores definidos por el usuario aplicables, que determinan
qué operador es el más específico de forma inequívoca. En términos generales, el
operador más específico es el operador cuyo tipo de operando es "más cercano" al
tipo de origen y cuyo tipo de resultado es "más cercano" al tipo de destino. Los
operadores de conversión definidos por el usuario son preferibles a los operadores
de conversión de elevación. En las secciones siguientes se definen las reglas
exactas para establecer el operador de conversión definido por el usuario más
específico.
Una vez que se ha identificado un operador de conversión definido por el usuario más
específico, la ejecución real de la conversión definida por el usuario implica hasta tres
pasos:

En primer lugar, si es necesario, realizar una conversión estándar del tipo de origen
al tipo de operando del operador de conversión definido por el usuario o de
elevación.
A continuación, se invoca el operador de conversión definido por el usuario o de
elevación para realizar la conversión.
Por último, si es necesario, realizar una conversión estándar del tipo de resultado
del operador de conversión definido por el usuario o de elevación al tipo de
destino.

La evaluación de una conversión definida por el usuario nunca implica más de un

operador de conversión definido por el usuario o de elevación. En otras palabras, una
conversión de tipo S a tipo T nunca ejecutará primero una conversión definida por el
usuario de S a X y, a continuación, ejecutará una conversión definida por el usuario de
X en T .

En las secciones siguientes se proporcionan definiciones exactas de la evaluación de las

conversiones implícitas o explícitas definidas por el usuario. Las definiciones hacen uso
de los siguientes términos:

Si existe una conversión implícita estándar (conversiones implícitas estándar) de un

tipo A a un tipo B , y si ni A ni B son interface_type s, A se dice que es
*englobado por _ y B B se dice que es _ englob * A .
El tipo más abarcado en un conjunto de tipos es el que abarca todos los demás
tipos del conjunto. Si no hay ningún tipo único que abarque todos los demás
tipos, el conjunto no tiene más tipo de englobado. En términos más intuitivos, el
tipo más amplio es el tipo "mayor" del conjunto (el tipo al que se puede convertir
cada uno de los demás tipos de forma implícita).
El tipo más abarcado en un conjunto de tipos es el que se incluye en todos los
demás tipos del conjunto. Si no hay ningún tipo único incluido en el resto de tipos,
el conjunto no tiene el tipo más abarcado. En términos más intuitivos, el tipo más
abarcado es el tipo "más pequeño" del conjunto (el tipo que se puede convertir
implícitamente en cada uno de los demás tipos).

Procesamiento de conversiones implícitas definidas por el

usuario
Una conversión implícita definida por el usuario del tipo S al tipo T se procesa de la
siguiente manera:

Determine los tipos S0 y T0 . Si S o T son tipos que aceptan valores NULL, S0 y

T0 son sus tipos subyacentes; de lo contrario, S0 y T0 son iguales a S y T
respectivamente.
Busque el conjunto de tipos, D , del que se considerarán los operadores de
conversión definidos por el usuario. Este conjunto consta de S0 (si S0 es una clase
o struct), las clases base de S0 (si es S0 una clase) y T0 (si T0 es una clase o un
struct).
Busque el conjunto de operadores de conversión de elevación y definidos por el
usuario aplicables, U . Este conjunto consta de los operadores de conversión
implícita definidos por el usuario y de elevación que se declaran mediante las
clases o Structs de D que se convierten de un tipo que abarca S a un tipo
englobado por T . Si U está vacío, la conversión no está definida y se produce un
error en tiempo de compilación.
Busque el tipo de origen más específico, SX , de los operadores en U :
Si alguno de los operadores de U convierte en S , entonces SX es S .
De lo contrario, SX es el tipo más abarcado en el conjunto combinado de tipos
de origen de los operadores de U . Si no se encuentra exactamente un tipo más
abarcado, la conversión es ambigua y se produce un error en tiempo de
compilación.
Busque el tipo de destino más específico, TX , de los operadores en U :
Si alguno de los operadores de U se convierte en T , entonces TX es T .
De lo contrario, TX es el tipo más abarcado en el conjunto combinado de tipos
de destino de los operadores de U . Si no se encuentra exactamente un tipo
más englobado, la conversión es ambigua y se produce un error en tiempo de
compilación.
Busque el operador de conversión más específico:
Si U contiene exactamente un operador de conversión definido por el usuario
que convierte de SX a TX , este es el operador de conversión más específico.
De lo contrario, si U contiene exactamente un operador de conversión de
elevación que convierte de SX a TX , este es el operador de conversión más
específico.
De lo contrario, la conversión es ambigua y se produce un error en tiempo de
compilación.
Por último, aplique la conversión:
Si S no es SX , se realiza una conversión implícita estándar de S a SX .
Se invoca al operador de conversión más específico para convertir de SX a TX .
 Si TX no es T , se realiza una conversión implícita estándar de TX a T .

Procesamiento de conversiones explícitas definidas por el

usuario
Una conversión explícita definida por el usuario del tipo S al tipo T se procesa de la
siguiente manera:

Determine los tipos S0 y T0 . Si S o T son tipos que aceptan valores NULL, S0 y

T0 son sus tipos subyacentes; de lo contrario, S0 y T0 son iguales a S y T

respectivamente.
Busque el conjunto de tipos, D , del que se considerarán los operadores de
conversión definidos por el usuario. Este conjunto consta de S0 (si S0 es una clase
o struct), las clases base de S0 (si es S0 una clase), T0 (si T0 es una clase o
estructura) y las clases base de T0 (si T0 es una clase).
Busque el conjunto de operadores de conversión de elevación y definidos por el
usuario aplicables, U . Este conjunto consta de los operadores de conversión
implícitos y de elevación definidos por el usuario declarados por las clases o
Structs de D que se convierten de un tipo que engloba o engloba S a un tipo
englobado o englobado por T . Si U está vacío, la conversión no está definida y se
produce un error en tiempo de compilación.
Busque el tipo de origen más específico, SX , de los operadores en U :
Si alguno de los operadores de U convierte en S , entonces SX es S .
De lo contrario, si alguno de los operadores de U se convierte de tipos que
abarcan S , SX es el tipo más abarcado en el conjunto combinado de tipos de
origen de esos operadores. Si no se puede encontrar ningún tipo más abarcado,
la conversión es ambigua y se produce un error en tiempo de compilación.
De lo contrario, SX es el tipo más abarcado en el conjunto combinado de tipos
de origen de los operadores de U . Si no se encuentra exactamente un tipo más
englobado, la conversión es ambigua y se produce un error en tiempo de
compilación.
Busque el tipo de destino más específico, TX , de los operadores en U :
Si alguno de los operadores de U se convierte en T , entonces TX es T .
De lo contrario, si cualquiera de los operadores de U se convierte en tipos que
están englobados por T , TX es el tipo más abarcado en el conjunto combinado
de tipos de destino de esos operadores. Si no se encuentra exactamente un tipo
más englobado, la conversión es ambigua y se produce un error en tiempo de
compilación.
 De lo contrario, TX es el tipo más abarcado en el conjunto combinado de tipos
de destino de los operadores de U . Si no se puede encontrar ningún tipo más
abarcado, la conversión es ambigua y se produce un error en tiempo de
compilación.
Busque el operador de conversión más específico:
Si U contiene exactamente un operador de conversión definido por el usuario
que convierte de SX a TX , este es el operador de conversión más específico.
De lo contrario, si U contiene exactamente un operador de conversión de
elevación que convierte de SX a TX , este es el operador de conversión más
específico.
De lo contrario, la conversión es ambigua y se produce un error en tiempo de
compilación.
Por último, aplique la conversión:
Si S no es SX , se realiza una conversión explícita estándar de S a SX .
Se invoca el operador de conversión definido por el usuario más específico para
convertir de SX a TX .
Si TX no es T , se realiza una conversión explícita estándar de TX a T .

Conversiones de función anónima

Un anonymous_method_expression o lambda_expression se clasifica como una función
anónima (expresiones de función anónima). La expresión no tiene un tipo, pero se
puede convertir de forma implícita a un tipo de delegado o un tipo de árbol de
expresión compatible. En concreto, una función anónima F es compatible con un tipo
de delegado D proporcionado:

Si F contiene un anonymous_function_signature, D y F tienen el mismo número de

parámetros.
Si no F contiene un anonymous_function_signature, D puede tener cero o más
parámetros de cualquier tipo, siempre y cuando ningún parámetro de D tenga el
out modificador de parámetro.

Si F tiene una lista de parámetros con tipo explícito, cada parámetro de D tiene el
mismo tipo y modificadores que el parámetro correspondiente de F .
Si F tiene una lista de parámetros con tipo implícito, D no tiene ref out
parámetros o.
Si el cuerpo de F es una expresión y D tiene un void tipo de valor devuelto o F es
asincrónico D y tiene el tipo de valor devuelto Task , cuando cada parámetro de F
recibe el tipo del parámetro correspondiente en D , el cuerpo de F es una
 expresión válida (WRT expresiones) que se permitiría como statement_expression
(instrucciones de expresión).
Si el cuerpo de F es un bloque de instrucciones y D tiene un void tipo de valor
devuelto o F es asincrónico y D tiene el tipo de valor devuelto Task , cuando cada
parámetro de F recibe el tipo del parámetro correspondiente en D , el cuerpo de
F es un bloque de instrucciones válido (WRT bloques) en el que ninguna return

instrucción especifica una expresión.

Si el cuerpo de F es una expresión y F no es asincrónico y D tiene un tipo de valor
devuelto que no es nulo T , o F si es asincrónico y D tiene un tipo de valor
devuelto Task<T> , cuando cada parámetro de F se asigna al tipo del parámetro
correspondiente en D , el cuerpo de F es una expresión válida (las
expresionesWRT) que es implícitamente convertible a T .
Si el cuerpo de F es un bloque de instrucciones, y F no es Async y D tiene un tipo
de valor devuelto que no es void T , o F es Async y D tiene un tipo de valor
devuelto Task<T> , cuando cada parámetro de F recibe el tipo del parámetro
correspondiente en D , el cuerpo de F es un bloque de instrucciones válido (WRT
bloques) con un punto final no accesible en el que cada return instrucción
especifica una expresión que se puede convertir implícitamente en T .

Por motivos de brevedad, en esta sección se usa la forma abreviada para los tipos de
tarea Task y Task<T> (funciones asincrónicas).

Una expresión lambda F es compatible con un tipo de árbol de expresión

Expression<D> si F es compatible con el tipo de delegado D . Tenga en cuenta que esto

no se aplica a los métodos anónimos, solo a las expresiones lambda.

Ciertas expresiones lambda no se pueden convertir en tipos de árbol de expresión:

aunque la conversión existe, se produce un error en tiempo de compilación. Este es el
caso si la expresión lambda:

Tiene un cuerpo de bloque

Contiene operadores de asignación simples o compuestos
Contiene una expresión enlazada dinámicamente
Async

En los ejemplos siguientes se usa un tipo de delegado genérico Func<A,R> que

representa una función que toma un argumento de tipo A y devuelve un valor de tipo
R :

C#
 delegate R Func<A,R>(A arg);

En las asignaciones

C#

Func<int,int> f1 = x => x + 1; // Ok

Func<int,double> f2 = x => x + 1; // Ok

Func<double,int> f3 = x => x + 1; // Error

Func<int, Task<int>> f4 = async x => x + 1; // Ok

los tipos de valor devuelto y de parámetro de cada función anónima se determinan a

partir del tipo de la variable a la que se asigna la función anónima.

La primera asignación convierte correctamente la función anónima en el tipo de

delegado Func<int,int> porque, cuando x se especifica el tipo int , x+1 es una
expresión válida que se convertirá implícitamente al tipo int .

Del mismo modo, la segunda asignación convierte correctamente la función anónima en

el tipo Func<int,double> de delegado porque el resultado de x+1 (de tipo int ) es
implícitamente convertible al tipo double .

Sin embargo, la tercera asignación es un error en tiempo de compilación porque,

cuando x se especifica double el tipo, el resultado de x+1 (de tipo double ) no se
pueden convertir implícitamente al tipo int .

La cuarta asignación convierte correctamente la función asincrónica anónima en el tipo

de delegado Func<int, Task<int>> porque el resultado de x+1 (de tipo int ) se
convertirá implícitamente al tipo int de resultado del tipo de tarea Task<int> .

Las funciones anónimas pueden influir en la resolución de sobrecarga y participar en la

inferencia de tipos. Consulte miembros de función para obtener más detalles.

Evaluación de conversiones de funciones anónimas a

tipos de delegado
La conversión de una función anónima a un tipo de delegado genera una instancia de
delegado que hace referencia a la función anónima y al conjunto (posiblemente vacío)
de variables externas capturadas que están activas en el momento de la evaluación.
Cuando se invoca el delegado, se ejecuta el cuerpo de la función anónima. El código del
cuerpo se ejecuta utilizando el conjunto de variables externas capturadas al que hace
referencia el delegado.

La lista de invocaciones de un delegado generado a partir de una función anónima

contiene una sola entrada. No se especifican el objeto de destino exacto y el método de
destino del delegado. En concreto, no se especifica si el objeto de destino del delegado
es null , el this valor del miembro de función envolvente o algún otro objeto.

Se permiten las conversiones de funciones anónimas semánticamente idénticas con el

mismo conjunto (posiblemente vacío) de instancias de variables externas capturadas en
los mismos tipos de delegado (aunque no es necesario) para devolver la misma
instancia de delegado. El término semánticamente idéntico se usa aquí para indicar que
la ejecución de las funciones anónimas, en todos los casos, produce los mismos efectos
dados los mismos argumentos. Esta regla permite optimizar el código como el
siguiente.

C#

delegate double Function(double x);

class Test

static double[] Apply(double[] a, Function f) {

double[] result = new double[a.Length];

for (int i = 0; i < a.Length; i++) result[i] = f(a[i]);

return result;

static void F(double[] a, double[] b) {

a = Apply(a, (double x) => Math.Sin(x));

b = Apply(b, (double y) => Math.Sin(y));

...

Dado que los dos delegados de función anónimos tienen el mismo conjunto (vacío) de
variables externas capturadas y como las funciones anónimas son idénticas
semánticamente, el compilador puede hacer que los delegados hagan referencia al
mismo método de destino. En realidad, el compilador puede devolver la misma
instancia de delegado de ambas expresiones de función anónimas.

Evaluación de conversiones de funciones anónimas a

tipos de árbol de expresión
La conversión de una función anónima en un tipo de árbol de expresión genera un árbol
de expresión (tipos de árbol de expresión). Más concretamente, la evaluación de la
conversión de funciones anónimas conduce a la construcción de una estructura de
objeto que representa la estructura de la propia función anónima. La estructura precisa
del árbol de expresión, así como el proceso exacto para crearla, se definen en la
implementación.

Ejemplo de implementación
En esta sección se describe una posible implementación de conversiones de funciones
anónimas en términos de otras construcciones de C#. La implementación que se
describe aquí se basa en los mismos principios utilizados por el compilador de Microsoft
C#, pero no es una implementación asignada, ni es lo único posible. Solo se mencionan
brevemente las conversiones a los árboles de expresión, ya que su semántica exacta está
fuera del ámbito de esta especificación.

En el resto de esta sección se proporcionan varios ejemplos de código que contiene

funciones anónimas con diferentes características. En cada ejemplo, se proporciona una
traducción correspondiente al código que usa solo otras construcciones de C#. En los
ejemplos, se supone que el identificador D representa el siguiente tipo de delegado:

C#

public delegate void D();

La forma más sencilla de una función anónima es aquella que no captura variables
externas:

C#

class Test

static void F() {

D d = () => { Console.WriteLine("test"); };

Esto se puede traducir a una creación de instancias de delegado que hace referencia a
un método estático generado por el compilador en el que se coloca el código de la
función anónima:

C#
 class Test

static void F() {

D d = new D(__Method1);

static void __Method1() {

Console.WriteLine("test");

En el ejemplo siguiente, la función anónima hace referencia a los miembros de instancia

de this :

C#

class Test

int x;

void F() {

D d = () => { Console.WriteLine(x); };

Esto puede traducirse a un método de instancia generado por el compilador que

contenga el código de la función anónima:

C#

class Test

int x;

void F() {

D d = new D(__Method1);

void __Method1() {

Console.WriteLine(x);

En este ejemplo, la función anónima captura una variable local:

C#

class Test

 void F() {

int y = 123;

D d = () => { Console.WriteLine(y); };

La duración de la variable local debe extenderse ahora a al menos la duración del

delegado de función anónima. Esto puede lograrse mediante la "activación" de la
variable local en un campo de una clase generada por el compilador. La creación de
instancias de la variable local (creaciónde instancias de variables locales) corresponde
entonces a la creación de una instancia de la clase generada por el compilador y el
acceso a la variable local corresponde al acceso a un campo en la instancia de la clase
generada por el compilador. Además, la función anónima se convierte en un método de
instancia de la clase generada por el compilador:

C#

class Test

void F() {

__Locals1 __locals1 = new __Locals1();

__locals1.y = 123;

D d = new D(__locals1.__Method1);

class __Locals1

public int y;

public void __Method1() {

Console.WriteLine(y);
}

Por último, la función anónima siguiente captura this y dos variables locales con
distintas duraciones:

C#

class Test

int x;

void F() {

int y = 123;

for (int i = 0; i < 10; i++) {

int z = i * 2;

D d = () => { Console.WriteLine(x + y + z); };

En este caso, se crea una clase generada por el compilador para cada bloque de
instrucciones en el que se capturan las variables locales de forma que las variables
locales de los diferentes bloques puedan tener duraciones independientes. Una
instancia de __Locals2 , la clase generada por el compilador para el bloque de
instrucciones interno, contiene la variable local z y un campo que hace referencia a una
instancia de __Locals1 . Una instancia de __Locals1 , la clase generada por el
compilador para el bloque de instrucciones exterior, contiene la variable local y y un
campo que hace referencia this al miembro de función envolvente. Con estas
estructuras de datos es posible llegar a todas las variables externas capturadas a través
de una instancia de __Local2 , y el código de la función anónima se puede implementar
como un método de instancia de esa clase.

C#

class Test

void F() {

__Locals1 __locals1 = new __Locals1();

__locals1.__this = this;

__locals1.y = 123;

for (int i = 0; i < 10; i++) {

__Locals2 __locals2 = new __Locals2();

__locals2.__locals1 = __locals1;

__locals2.z = i * 2;

D d = new D(__locals2.__Method1);

class __Locals1

public Test __this;

public int y;

class __Locals2

public __Locals1 __locals1;

public int z;

public void __Method1() {

Console.WriteLine(__locals1.__this.x + __locals1.y + z);

También se puede usar la misma técnica que se aplica aquí para capturar variables
locales al convertir funciones anónimas en árboles de expresión: las referencias a los
objetos generados por el compilador se pueden almacenar en el árbol de expresión y el
acceso a las variables locales se puede representar como accesos de campo en estos
objetos. La ventaja de este enfoque es que permite compartir las variables locales
"levantadas" entre los delegados y los árboles de expresión.

Conversiones de grupos de métodos

Existe una conversión implícita (conversiones implícitas) de un grupo de métodos
(clasificaciones de expresión) a un tipo de delegado compatible. Dado un tipo de
delegado D y una expresión E que se clasifica como grupo de métodos, existe una
conversión implícita de E a D si E contiene al menos un método aplicable en su forma
normal (miembro defunción aplicable) a una lista de argumentos construida mediante el
uso de los tipos de parámetros y modificadores de D , como se describe a continuación.

La aplicación en tiempo de compilación de una conversión de un grupo de métodos E a

un tipo de delegado D se describe en lo siguiente. Tenga en cuenta que la existencia de
una conversión implícita de E a no D garantiza que la aplicación en tiempo de
compilación de la conversión se realice correctamente sin errores.

Se selecciona un solo método M que corresponde a una invocación de método

(invocaciones de método) del formulario E(A) , con las siguientes modificaciones:
La lista A de argumentos es una lista de expresiones, cada una clasificada como
una variable y con el tipo y el modificador ( ref o out ) del parámetro
correspondiente en el formal_parameter_list de D .
Los métodos candidatos considerados solo son aquellos que se aplican en su
forma normal (miembro de función aplicable), no los que solo se aplican en su
forma expandida.
Si el algoritmo de las invocaciones de método produce un error, se produce un
error en tiempo de compilación. De lo contrario, el algoritmo genera un único
método mejor M con el mismo número de parámetros que D y se considera que la
conversión existe.
El método seleccionado M debe ser compatible (delegados de compatibilidad) con
el tipo de delegado D o, de lo contrario, se producirá un error en tiempo de
compilación.
Si el método seleccionado M es un método de instancia, la expresión de instancia
asociada a E determina el objeto de destino del delegado.
Si el método seleccionado M es un método de extensión que se indica mediante
un acceso a miembro en una expresión de instancia, esa expresión de instancia
 determina el objeto de destino del delegado.
El resultado de la conversión es un valor de tipo   D , es decir, un delegado recién
creado que hace referencia al método seleccionado y al objeto de destino.
Tenga en cuenta que este proceso puede dar lugar a la creación de un delegado a
un método de extensión, si el algoritmo de las invocaciones de método no
encuentra un método de instancia pero tiene éxito en el procesamiento de la
invocación de E(A) como una invocación de método de extensión (invocaciones
de método de extensión). Por lo tanto, un delegado creado captura el método de
extensión, así como su primer argumento.

En el ejemplo siguiente se muestran las conversiones de grupos de métodos:

C#

delegate string D1(object o);

delegate object D2(string s);

delegate object D3();

delegate string D4(object o, params object[] a);

delegate string D5(int i);

class Test

static string F(object o) {...}

static void G() {

D1 d1 = F; // Ok

D2 d2 = F; // Ok

D3 d3 = F; // Error -- not applicable

D4 d4 = F; // Error -- not applicable in normal form

D5 d5 = F; // Error -- applicable but not compatible

La asignación para d1 convertir implícitamente el grupo de métodos F en un valor de

tipo D1 .

La asignación a d2 muestra cómo se puede crear un delegado para un método que

tiene tipos de parámetro menos derivados (contravariante) y un tipo de valor devuelto
más derivado (covariante).

La asignación a d3 muestra cómo no existe ninguna conversión si el método no es

aplicable.
La asignación a d4 muestra cómo el método debe ser aplicable en su forma normal.

La asignación a d5 muestra cómo se permite que los tipos de valor devuelto y de

parámetro del delegado y el método difieran solo para los tipos de referencia.

Como con todas las demás conversiones implícitas y explícitas, el operador de

conversión se puede usar para realizar explícitamente una conversión de grupo de
métodos. Por lo tanto, el ejemplo

C#

object obj = new EventHandler(myDialog.OkClick);

en su lugar, se puede escribir

C#

object obj = (EventHandler)myDialog.OkClick;

Los grupos de métodos pueden influir en la resolución de sobrecarga y participar en la

inferencia de tipos. Consulte miembros de función para obtener más detalles.

La evaluación en tiempo de ejecución de una conversión de grupo de métodos continúa

como sigue:

Si el método seleccionado en tiempo de compilación es un método de instancia, o

es un método de extensión al que se tiene acceso como un método de instancia, el
objeto de destino del delegado se determina a partir de la expresión de instancia
asociada a E :
Se evalúa la expresión de instancia. Si esta evaluación provoca una excepción,
no se ejecuta ningún paso más.
Si la expresión de instancia es de un reference_type, el valor calculado por la
expresión de instancia se convierte en el objeto de destino. Si el método
seleccionado es un método de instancia y el objeto de destino es null ,
System.NullReferenceException se produce una excepción y no se ejecuta
ningún paso más.
Si la expresión de instancia es de un value_type, se realiza una operación de
conversión boxing (conversiones boxing) para convertir el valor en un objeto y
este objeto se convierte en el objeto de destino.
De lo contrario, el método seleccionado forma parte de una llamada al método
estático y el objeto de destino del delegado es null .
Se asigna una nueva instancia del tipo de delegado D . Si no hay suficiente
memoria disponible para asignar la nueva instancia, System.OutOfMemoryException
se produce una excepción y no se ejecuta ningún paso más.
La nueva instancia de delegado se inicializa con una referencia al método que se
determinó en tiempo de compilación y una referencia al objeto de destino
calculado anteriormente.
Expresiones
Artículo • 16/09/2021 • Tiempo de lectura: 228 minutos

Una expresión es una secuencia de operadores y operandos. En este capítulo se define

la sintaxis, el orden de evaluación de los operandos y operadores y el significado de las
expresiones.

Clasificaciones de expresiones
Una expresión se clasifica de las siguientes formas:

Un valor. Todos los valores tienen un tipo asociado.

Una variable. Cada variable tiene un tipo asociado, es decir, el tipo declarado de la
variable.
Espacio de nombres. Una expresión con esta clasificación solo puede aparecer
como la parte izquierda de un member_access (acceso a miembros). En cualquier
otro contexto, una expresión clasificada como un espacio de nombres produce un
error en tiempo de compilación.
Un tipo. Una expresión con esta clasificación solo puede aparecer como el lado
izquierdo de un member_access (acceso a miembros) o como un operando para el
as operador (el operador as), el is operador (operador is) o el typeof operador

(el operador typeof). En cualquier otro contexto, una expresión clasificada como un
tipo genera un error en tiempo de compilación.
Un grupo de métodos, que es un conjunto de métodos sobrecargados que
resultan de una búsqueda de miembros (búsqueda de miembros). Un grupo de
métodos puede tener una expresión de instancia asociada y una lista de
argumentos de tipo asociada. Cuando se invoca un método de instancia, el
resultado de evaluar la expresión de instancia se convierte en la instancia
representada por this (este acceso). Se permite un grupo de métodos en un
invocation_expression (expresiones de invocación), un delegate_creation_expression
(expresiones de creación de delegado) y como el lado izquierdo de un operador is
y se puede convertir implícitamente en un tipo de delegado compatible
(conversiones de grupo de métodos). En cualquier otro contexto, una expresión
clasificada como grupo de métodos produce un error en tiempo de compilación.
Un literal null. Una expresión con esta clasificación se puede convertir
implícitamente a un tipo de referencia o a un tipo que acepta valores NULL.
Una función anónima. Una expresión con esta clasificación se puede convertir
implícitamente en un tipo de delegado compatible o un tipo de árbol de
expresión.
 Un acceso de propiedad. Cada acceso de propiedad tiene un tipo asociado, es
decir, el tipo de la propiedad. Además, un acceso de propiedad puede tener una
expresión de instancia asociada. Cuando se invoca un descriptor get set de
acceso (el bloque o) de una propiedad de instancia, el resultado de evaluar la
expresión de instancia se convierte en la instancia representada por this (este
acceso).
Un acceso de evento. Cada acceso a eventos tiene un tipo asociado, es decir, el
tipo del evento. Además, un acceso a eventos puede tener una expresión de
instancia asociada. Un acceso a eventos puede aparecer como el operando
izquierdo de += los -= operadores y (asignación de eventos). En cualquier otro
contexto, una expresión clasificada como acceso de evento produce un error en
tiempo de compilación.
Un acceso de indexador. Cada acceso de indexador tiene un tipo asociado, es
decir, el tipo de elemento del indexador. Además, un acceso de indexador tiene
una expresión de instancia asociada y una lista de argumentos asociada. Cuando
se invoca un descriptor get set de acceso (el bloque o) de un acceso de
indexador, el resultado de evaluar la expresión de instancia se convierte en la
instancia representada por this (este acceso) y el resultado de evaluar la lista de
argumentos se convierte en la lista de parámetros de la invocación.
Nada. Esto sucede cuando la expresión es una invocación de un método con un
tipo de valor devuelto de void . Una expresión clasificada como Nothing solo es
válida en el contexto de una statement_expression (instrucciones de expresión).

El resultado final de una expresión nunca es un espacio de nombres, tipo, grupo de

métodos o acceso a eventos. En su lugar, como se indicó anteriormente, estas
categorías de expresiones son construcciones intermedias que solo se permiten en
determinados contextos.

Un acceso de propiedad o de indexador siempre se reclasifica como un valor realizando

una invocación del descriptor de acceso get o del descriptor de acceso set. El descriptor
de acceso concreto viene determinado por el contexto de la propiedad o el acceso del
indexador: Si el acceso es el destino de una asignación, se invoca al descriptor de acceso
set para asignar un nuevo valor (asignación simple). De lo contrario, el descriptor de
acceso get se invoca para obtener el valor actual (valores de las expresiones).

Valores de las expresiones

En última instancia, la mayoría de las construcciones que implican una expresión
requieren que la expresión denote un valor. En tales casos, si la expresión real denota
un espacio de nombres, un tipo, un grupo de métodos o nada, se produce un error en
tiempo de compilación. Sin embargo, si la expresión denota un acceso de propiedad, un
acceso a indexador o una variable, el valor de la propiedad, el indexador o la variable se
sustituyen implícitamente:

El valor de una variable es simplemente el valor almacenado actualmente en la

ubicación de almacenamiento identificada por la variable. Una variable se debe
considerar definitivamente asignada (asignación definitiva) antes de que se pueda
obtener su valor o, de lo contrario, se producirá un error en tiempo de
compilación.
El valor de una expresión de acceso de propiedad se obtiene invocando el
descriptor de acceso get de la propiedad. Si la propiedad no tiene un descriptor de
acceso get, se produce un error en tiempo de compilación. De lo contrario, se
realiza una invocación de miembro de función (comprobación en tiempo de
compilación de la resolución dinámica de sobrecarga) y el resultado de la
invocación se convierte en el valor de la expresión de acceso de propiedad.
El valor de una expresión de acceso de indexador se obtiene al invocar el descriptor
de acceso get del indexador. Si el indizador no tiene ningún descriptor de acceso
get, se produce un error en tiempo de compilación. De lo contrario, se realiza una
invocación de un miembro de función (comprobación en tiempo de compilación
de la resolución dinámica de sobrecarga) con la lista de argumentos asociada a la
expresión de acceso del indizador y el resultado de la invocación se convierte en el
valor de la expresión de acceso del indexador.

Enlaces estáticos y dinámicos

El proceso de determinar el significado de una operación basándose en el tipo o valor
de las expresiones constituyentes (argumentos, operandos, receptores) a menudo se
conoce como enlace. Por ejemplo, el significado de una llamada al método se
determina en función del tipo del receptor y de los argumentos. El significado de un
operador se determina en función del tipo de sus operandos.

En C#, el significado de una operación se suele determinar en tiempo de compilación,

basándose en el tipo en tiempo de compilación de sus expresiones constituyentes. Del
mismo modo, si una expresión contiene un error, el compilador detecta el error y lo
emite. Este enfoque se conoce como enlace estático.

Sin embargo, si una expresión es una expresión dinámica (es decir, tiene el tipo dynamic
), esto indica que cualquier enlace en el que participe debería basarse en su tipo en
tiempo de ejecución (es decir, el tipo real del objeto que denota en tiempo de
ejecución) en lugar del tipo que tiene en tiempo de compilación. Por consiguiente, el
enlace de esta operación se aplaza hasta el momento en que se ejecuta la operación
durante la ejecución del programa. Esto se conoce como enlace dinámico.
Cuando una operación está enlazada dinámicamente, el compilador realiza poca o
ninguna comprobación. En su lugar, si se produce un error en el enlace en tiempo de
ejecución, los errores se registran como excepciones en tiempo de ejecución.

Las siguientes operaciones en C# están sujetas al enlace:

Acceso a miembros: e.M

Invocación de método: e.M(e1, ..., eN)
Invocación de delegado: e(e1, ..., eN)
Acceso a elementos: e[e1, ..., eN]
Creación de objetos: new C(e1, ..., eN)
Operadores unarios sobrecargados: + , - , ! , ~ , ++ , -- , true , false
Operadores binarios sobrecargados: + , - , * , / ,,, % & && , | , || , ?? , ^ , << ,
>> , == , != , > , < , >= , <=
Operadores de asignación: = , += , -= , *= , /= , %= , &= , |= , ^= , <<= , >>=
Conversiones implícitas y explícitas

Cuando no hay ninguna expresión dinámica implicada, el valor predeterminado de C#

es el enlace estático, lo que significa que los tipos en tiempo de compilación de las
expresiones constituyentes se usan en el proceso de selección. Sin embargo, cuando
una de las expresiones constituyentes de las operaciones enumeradas anteriormente es
una expresión dinámica, la operación se enlaza dinámicamente.

Tiempo de enlace
El enlace estático se realiza en tiempo de compilación, mientras que el enlace dinámico
tiene lugar en tiempo de ejecución. En las secciones siguientes, el término tiempo de
enlace hace referencia a un tiempo de compilación o a un tiempo de ejecución, en
función de cuándo tenga lugar el enlace.

En el ejemplo siguiente se muestran las nociones de enlace estático y dinámico y del

tiempo de enlace:

C#

object o = 5;

dynamic d = 5;

Console.WriteLine(5); // static binding to Console.WriteLine(int)

Console.WriteLine(o); // static binding to Console.WriteLine(object)

Console.WriteLine(d); // dynamic binding to Console.WriteLine(int)

Las dos primeras llamadas se enlazan estáticamente: la sobrecarga de

Console.WriteLine se selecciona basándose en el tipo en tiempo de compilación de su
argumento. Por lo tanto, el tiempo de enlace es el tiempo de compilación.

La tercera llamada está enlazada dinámicamente: la sobrecarga de Console.WriteLine se

selecciona basándose en el tipo en tiempo de ejecución de su argumento. Esto sucede
porque el argumento es una expresión dinámica: su tipo en tiempo de compilación es
dynamic . Por lo tanto, el tiempo de enlace para la tercera llamada es en tiempo de
ejecución.

Enlace dinámico
El propósito de los enlaces dinámicos es permitir que los programas de C# interactúen
con objetos dinámicos, es decir, los objetos que no siguen las reglas normales del
sistema de tipos de c#. Los objetos dinámicos pueden ser objetos de otros lenguajes de
programación con distintos sistemas de tipos, o bien pueden ser objetos que se
configuran mediante programación para implementar su propia semántica de enlace
para diferentes operaciones.

El mecanismo por el que un objeto dinámico implementa su propia semántica es la

implementación definida. Una interfaz determinada, que se ha definido de nuevo en la
implementación, se implementa mediante objetos dinámicos para indicar al tiempo de
ejecución de C# que tienen una semántica especial. Por lo tanto, cada vez que las
operaciones en un objeto dinámico se enlazan dinámicamente, su propia semántica de
enlace, en lugar de las de C# tal como se especifica en este documento, asumen el
control.

Aunque el propósito del enlace dinámico es permitir la interoperación con objetos

dinámicos, C# permite el enlace dinámico en todos los objetos, tanto si son dinámicos
como si no. Esto permite una integración más fluida de los objetos dinámicos, ya que
los resultados de las operaciones en ellos pueden no ser objetos dinámicos, pero siguen
siendo un tipo desconocido para el programador en tiempo de compilación. Además, el
enlace dinámico puede ayudar a eliminar el código basado en la reflexión propenso a
errores, incluso cuando ningún objeto implicado sea de objetos dinámicos.

En las secciones siguientes se describe para cada construcción del lenguaje exactamente
cuando se aplica el enlace dinámico, qué comprobación del tiempo de compilación se
aplica, en caso de que se aplique, y cuál es el resultado en tiempo de compilación y la
clasificación de la expresión.

Tipos de expresiones constituyentes

Cuando una operación se enlaza estáticamente, el tipo de una expresión constituyente
(por ejemplo, un receptor, un argumento, un índice o un operando) siempre se
considera el tipo en tiempo de compilación de esa expresión.

Cuando una operación se enlaza de forma dinámica, el tipo de una expresión

constituyente se determina de maneras diferentes en función del tipo en tiempo de
compilación de la expresión constituyente:

Se considera que una expresión constitutiva del tipo en tiempo de compilación

dynamic tiene el tipo del valor real al que se evalúa la expresión en tiempo de

ejecución.
Expresión constituyente cuyo tipo en tiempo de compilación es un parámetro de
tipo se considera que tiene el tipo al que está enlazado el parámetro de tipo en
tiempo de ejecución.
De lo contrario, se considera que la expresión Constituyente tiene su tipo en
tiempo de compilación.

Operadores
Las expresiones se construyen a partir de los operadores*operandos _ y. Los operadores
de una expresión indican qué operaciones se aplican a los operandos. Ejemplos de
operadores incluyen + , - , _ , / y new . Algunos ejemplos de operandos son literales,
campos, variables locales y expresiones.

Hay tres tipos de operadores:

Operadores unarios. Los operadores unarios toman un operando y usan la

notación de prefijo (como --x ) o la notación de postfijo (como x++ ).
Operadores binarios. Los operadores binarios toman dos operandos y todos usan
la notación infija (como x + y ).
Operador ternario. Solo un operador ternario, ?: , existe; toma tres operandos y
usa la notación de infijo ( c ? x : y ).

El orden de evaluación de los operadores de una expresión viene determinado por la

precedencia _ and _ asociativity de los operadores (precedencia y asociatividad del
operador).

Los operandos de una expresión se evalúan de izquierda a derecha. Por ejemplo, en

F(i) + G(i++) * H(i) , se llama al método con F el valor anterior de i , a continuación,
se llama al método G con el valor anterior de i , y, por último, H se llama al método
con el nuevo valor de i . Esto es independiente de la prioridad de operador y no está
relacionada con ella.
Algunos operadores se pueden sobrecargar. La sobrecarga de operadores permite
especificar implementaciones de operador definidas por el usuario para las operaciones
donde uno o ambos operandos son de una clase definida por el usuario o un tipo de
estructura (sobrecarga de operadores).

Prioridad y asociatividad de los operadores

Cuando una expresión contiene varios operadores, el *precedencia _ de los operadores
controla el orden en el que se evalúan los operadores individuales. Por ejemplo, la
expresión x + y _ z se evalúa como x + (y * z) porque el operador * tiene mayor
precedencia que el operador binario + . La precedencia de un operador se establece
mediante la definición de su producción gramatical asociada. Por ejemplo, un
additive_expression se compone de una secuencia de multiplicative_expression s
separadas + por - operadores or, lo que permite que los operadores + y tengan -
menor prioridad que los * / operadores, y % .

En la tabla siguiente se resumen todos los operadores en orden de prioridad, de mayor

a menor:

Sección Categoría Operadores

Expresiones principales Principal x.y f(x) a[x] x++ x-- new typeof default
checked unchecked delegate

Operadores unarios Unario + - ! ~ ++x --x (T)x

Operadores aritméticos Multiplicativa * / %

Operadores aritméticos Aditiva + -

Operadores de desplazamiento Shift << >>

Operadores relacionales y de Comprobación de < > <= >= is as

prueba de tipos tipos y relacional

Operadores relacionales y de Igualdad == !=

prueba de tipos

Operadores lógicos Y lógico &

Operadores lógicos XOR lógico ^

Operadores lógicos O lógico |

Operadores lógicos AND condicional &&

condicionales
 Sección Categoría Operadores

Operadores lógicos OR condicional ||

condicionales

Operador de uso combinado de Uso combinado ??

NULL de NULL

Operador condicional Condicional ?:

Operadores de asignación, Asignación y = *= /= %= += -= <<= >>= &= ^= |= =>

expresiones de función expresión lambda
anónimas

Cuando un operando se encuentra entre dos operadores con la misma precedencia, la

asociatividad de los operadores controla el orden en que se realizan las operaciones:

Excepto en el caso de los operadores de asignación y el operador de uso

combinado de NULL, todos los operadores binarios son asociativos a la izquierda,
lo que significa que las operaciones se realizan de izquierda a derecha. Por
ejemplo, x + y + z se evalúa como (x + y) + z .
Los operadores de asignación, el operador de uso combinado de NULL y el
operador condicional ( ?: ) son asociativos a la derecha, lo que significa que las
operaciones se realizan de derecha a izquierda. Por ejemplo, x = y = z se evalúa
como x = (y = z) .

La precedencia y la asociatividad pueden controlarse mediante paréntesis. Por ejemplo,

x + y * z primero multiplica y por z y luego suma el resultado a x , pero (x + y) * z
primero suma x y y y luego multiplica el resultado por z .

Sobrecarga de operadores
Todos los operadores unarios y binarios tienen implementaciones predefinidas que
están disponibles automáticamente en cualquier expresión. Además de las
implementaciones predefinidas, las implementaciones definidas por el usuario se
pueden introducir incluyendo operator declaraciones en clases y Structs (operadores).
Las implementaciones de operador definidas por el usuario siempre tienen prioridad
sobre las implementaciones de operadores predefinidas: solo cuando no existan
implementaciones de operadores definidos por el usuario aplicables, se tendrán en
cuenta las implementaciones de operadores predefinidas, como se describe en
resolución de sobrecargas de operador unario y resolución de sobrecarga de
operadores binarios.

Los operadores unarios sobrecargables son:

 C#

+ - ! ~ ++ -- true false

Aunque true y false no se utilizan explícitamente en expresiones (y, por consiguiente,

no se incluyen en la tabla de precedencia en la precedencia y asociatividadde los
operadores), se consideran operadores porque se invocan en varios contextos de
expresión: Expresiones booleanas (Expresiones booleanas) y expresiones que implican al
operador condicional (operador condicional) y operadores lógicos condicionales
(operadores lógicos condicionales)

Los operadores binarios sobrecargables son:

C#

+ - * / % & | ^ << >> == != > < >= <=

Solo se pueden sobrecargar los operadores enumerados anteriormente. En concreto, no

es posible sobrecargar el acceso a miembros, la invocación de métodos o los = &&
operadores,,,,,,,,,,, || ?? ?: => checked unchecked new typeof default as y is .

Cuando se sobrecarga un operador binario, el operador de asignación correspondiente,

si lo hay, también se sobrecarga de modo implícito. Por ejemplo, una sobrecarga del
operador * también es una sobrecarga del operador *= . Esto se describe con más
detalle en asignación compuesta. Tenga en cuenta que el operador de asignación ( = )
no se puede sobrecargar. Una asignación siempre realiza una copia simple de bits de un
valor en una variable.

Las operaciones de conversión, como (T)x , se sobrecargan proporcionando

conversiones definidas por el usuario (conversiones definidas por el usuario).

El acceso a elementos, como a[x] , no se considera un operador sobrecargable. En su

lugar, se admite la indexación definida por el usuario a través de indexadores
(indizadores).

En las expresiones, se hace referencia a los operadores mediante la notación de

operador y, en las declaraciones, se hace referencia a los operadores mediante la
notación funcional. En la tabla siguiente se muestra la relación entre el operador y las
notaciones funcionales para los operadores unarios y binarios. En la primera entrada, OP
denota cualquier operador de prefijo unario sobrecargable. En la segunda entrada, OP
denota los operadores y postfijo unarios ++ -- . En la tercera entrada, OP denota
cualquier operador binario sobrecargable.
 Notación de operador Notación funcional

op x operator op(x)

x op operator op(x)

x op y operator op(x,y)

Las declaraciones de operador definidas por el usuario siempre requieren que al menos
uno de los parámetros sea del tipo de clase o estructura que contiene la declaración de
operador. Por lo tanto, no es posible que un operador definido por el usuario tenga la
misma firma que un operador predefinido.

Las declaraciones de operador definidas por el usuario no pueden modificar la sintaxis,

la precedencia o la asociatividad de un operador. Por ejemplo, el / operador siempre es
un operador binario, siempre tiene el nivel de prioridad especificado en precedencia y
asociatividadde los operadores y siempre es asociativo a la izquierda.

Aunque es posible que un operador definido por el usuario realice cualquier cálculo, se
desaconsejan las implementaciones que generan resultados distintos de los que se
esperaban de forma intuitiva. Por ejemplo, una implementación de operator == debería
comparar los dos operandos para determinar si son iguales y devolver un bool
resultado adecuado.

Las descripciones de operadores individuales en expresiones primarias a través de

operadores lógicos condicionales especifican las implementaciones predefinidas de los
operadores y cualquier regla adicional que se aplique a cada operador. En las
descripciones se usa la *resolución de sobrecargas del operador unario***, la _resolución
de sobrecarga del operador binario*, y _ valores de promoción *, las definiciones de que se
encuentran en las secciones siguientes., and _*numeric promotion**, definitions of which
are found in the following sections.

Resolución de sobrecarga del operador unario

Una operación con el formato op x o x op , donde op es un operador unario
sobrecargable y x es una expresión de tipo X , se procesa de la siguiente manera:

El conjunto de operadores candidatos definidos por el usuario que proporciona X

para la operación operator op(x) se determina mediante las reglas de los
operadores candidatos definidospor el usuario.
Si el conjunto de operadores definidos por el usuario candidatos no está vacío, se
convierte en el conjunto de operadores candidatos para la operación. De lo
contrario, las implementaciones unarias predefinidas operator op , incluidas sus
 formas de elevación, se convierten en el conjunto de operadores candidatos para
la operación. Las implementaciones predefinidas de un operador determinado se
especifican en la descripción del operador (expresiones primarias y operadores
unarios).
Las reglas de resolución de sobrecarga de la resolución de sobrecarga se aplican al
conjunto de operadores candidatos para seleccionar el mejor operador con
respecto a la lista de argumentos (x) , y este operador se convierte en el
resultado del proceso de resolución de sobrecarga. Si la resolución de sobrecarga
no selecciona un solo operador mejor, se produce un error en tiempo de enlace.

Resolución de sobrecarga del operador binario

Una operación con el formato x op y , donde op es un operador binario sobrecargable,
x es una expresión de tipo X y y es una expresión de tipo Y , que se procesa de la
siguiente manera:

Se determina el conjunto de operadores candidatos definidos por el usuario que

proporciona X y Y para la operación operator op(x,y) . El conjunto consta de la
Unión de los operadores candidatos proporcionados por X y los operadores
candidatos proporcionados por, cada uno de los cuales se Y determina mediante
las reglas de los operadores candidatos definidospor el usuario. Si X y Y son del
mismo tipo, o si X y Y se derivan de un tipo base común, los operadores
candidatos compartidos solo se producen en el conjunto combinado una vez.
Si el conjunto de operadores definidos por el usuario candidatos no está vacío, se
convierte en el conjunto de operadores candidatos para la operación. De lo
contrario, las implementaciones binarias predefinidas operator op , incluidas sus
formas de elevación, se convierten en el conjunto de operadores candidatos para
la operación. Las implementaciones predefinidas de un operador determinado se
especifican en la descripción del operador (operadores aritméticos a través de
operadores lógicos condicionales). En el caso de los operadores de enumeración y
delegado predefinidos, los únicos operadores considerados son los definidos por
un tipo de delegado o de enumeración que es el tipo en tiempo de enlace de uno
de los operandos.
Las reglas de resolución de sobrecarga de la resolución de sobrecarga se aplican al
conjunto de operadores candidatos para seleccionar el mejor operador con
respecto a la lista de argumentos (x,y) , y este operador se convierte en el
resultado del proceso de resolución de sobrecarga. Si la resolución de sobrecarga
no selecciona un solo operador mejor, se produce un error en tiempo de enlace.

Operadores candidatos definidos por el usuario

Dado un tipo T y una operación operator op(A) , donde op es un operador
sobrecargable y A es una lista de argumentos, el conjunto de operadores definidos por
el usuario candidatos que proporciona T for operator op(A) se determina de la manera
siguiente:

Determine el tipo T0 . Si T es un tipo que acepta valores NULL, T0 es su tipo

subyacente, de lo contrario, T0 es igual a T .
Para todas las operator op declaraciones de T0 y todas las formas de elevación de
estos operadores, si al menos un operador es aplicable (miembro de función
aplicable) con respecto a la lista de argumentos A , el conjunto de operadores
candidatos está formado por todos los operadores aplicables en T0 .
De lo contrario, si T0 es object , el conjunto de operadores candidatos está vacío.
De lo contrario, el conjunto de operadores candidatos proporcionado por T0 es el
conjunto de operadores candidatos proporcionado por la clase base directa de T0
, o la clase base efectiva de T0 si T0 es un parámetro de tipo.

Promociones numéricas
La promoción numérica consiste en realizar automáticamente determinadas
conversiones implícitas de los operandos de los operadores binarios y unarios
predefinidos. La promoción numérica no es un mecanismo distinto, sino un efecto de
aplicar la resolución de sobrecarga a los operadores predefinidos. La promoción
numérica específicamente no afecta a la evaluación de operadores definidos por el
usuario, aunque se pueden implementar operadores definidos por el usuario para
mostrar efectos similares.

Como ejemplo de promoción numérica, tenga en cuenta las implementaciones

predefinidas del * operador binario:

C#

int operator *(int x, int y);

uint operator *(uint x, uint y);

long operator *(long x, long y);

ulong operator *(ulong x, ulong y);

float operator *(float x, float y);

double operator *(double x, double y);

decimal operator *(decimal x, decimal y);

Cuando se aplican las reglas de resolución de sobrecarga (resolución de sobrecarga) a

este conjunto de operadores, el efecto es seleccionar el primero de los operadores para
los que existen conversiones implícitas desde los tipos de operando. Por ejemplo, para
la operación b * s , donde b es byte y s es short , la resolución de sobrecarga
selecciona operator *(int,int) como el mejor operador. Por lo tanto, el efecto es que
b y s se convierten en y int el tipo del resultado es int . Del mismo modo, para la

operación i * d , donde i es int y d es double , la resolución de sobrecarga

selecciona operator *(double,double) como el mejor operador.

Promociones numéricas unarias

La promoción numérica unaria se produce para los operandos de los + - operadores
unarios predefinidos, y ~ . La promoción numérica unaria simplemente consiste en
convertir operandos de tipo sbyte , byte , short , ushort o char en tipo int . Además,
para el operador unario - , la promoción numérica unaria convierte operandos de tipo
uint al tipo long .

Promociones numéricas binarias

La promoción numérica binaria se produce para los operandos de los + - * / % & |

^ == != > < >= <= operadores binarios predefinidos,,,,,,,,,,,, y. La promoción numérica

binaria convierte implícitamente ambos operandos en un tipo común que, en el caso de

los operadores no relacionales, también se convierte en el tipo de resultado de la
operación. La promoción numérica binaria consiste en aplicar las siguientes reglas, en el
orden en que aparecen aquí:

Si alguno de los operandos es de tipo decimal , el otro operando se convierte al

tipo decimal , o se produce un error en tiempo de enlace si el otro operando es de
tipo float o double .
De lo contrario, si alguno de los operandos es de tipo double , el otro operando se
convierte al tipo double .
De lo contrario, si alguno de los operandos es de tipo float , el otro operando se
convierte al tipo float .
De lo contrario, si alguno de los operandos es de tipo ulong , el otro operando se
convierte al tipo ulong , o se produce un error en tiempo de enlace si el otro
operando es de tipo sbyte , short , int o long .
De lo contrario, si alguno de los operandos es de tipo long , el otro operando se
convierte al tipo long .
De lo contrario, si alguno de los operandos es de tipo uint y el otro operando es
de tipo sbyte , short o int , ambos operandos se convierten al tipo long .
De lo contrario, si alguno de los operandos es de tipo uint , el otro operando se
convierte al tipo uint .
 De lo contrario, ambos operandos se convierten al tipo int .

Tenga en cuenta que la primera regla no permite ninguna operación que mezcle el
decimal tipo con double los float tipos y. La regla sigue el hecho de que no hay

conversiones implícitas entre el decimal tipo y los double float tipos y.

Tenga en cuenta también que no es posible que un operando sea de tipo ulong cuando
el otro operando es de un tipo entero con signo. La razón es que no existe ningún tipo
entero que pueda representar el intervalo completo de ulong , así como los tipos
enteros con signo.

En los dos casos anteriores, se puede usar una expresión de conversión para convertir
explícitamente un operando en un tipo que sea compatible con el otro operando.

En el ejemplo

C#

decimal AddPercent(decimal x, double percent) {

return x * (1.0 + percent / 100.0);

se produce un error en tiempo de enlace porque decimal no se puede multiplicar por

double . El error se resuelve convirtiendo explícitamente el segundo operando en

decimal , como se indica a continuación:

C#

decimal AddPercent(decimal x, double percent) {

return x * (decimal)(1.0 + percent / 100.0);

Operadores de elevación
Los operadores de elevación permiten a los operadores predefinidos y definidos por el
usuario que operan en tipos de valor que no aceptan valores NULL usarse también con
formas que aceptan valores NULL de esos tipos. Los operadores de elevación se
construyen a partir de operadores predefinidos y definidos por el usuario que cumplen
ciertos requisitos, como se describe a continuación:

Para los operadores unarios

C#
 + ++ - -- ! ~

existe una forma de elevación de un operador si el operando y los tipos de

resultado son tipos de valor que no aceptan valores NULL. La forma de elevación
se construye agregando un único ? modificador al operando y a los tipos de
resultado. El operador de elevación genera un valor NULL si el operando es NULL.
De lo contrario, el operador de elevación desencapsula el operando, aplica el
operador subyacente y ajusta el resultado.

Para los operadores binarios

C#

+ - * / % & | ^ << >>

existe una forma de elevación de un operador si el operando y los tipos de

resultado son todos tipos de valor que no aceptan valores NULL. La forma de
elevación se construye agregando un único ? modificador a cada operando y tipo
de resultado. El operador de elevación genera un valor NULL si uno o los dos
operandos son NULL (una excepción son los & | operadores y del bool? tipo,
como se describe en operadores lógicos booleanos). De lo contrario, el operador
de elevación desencapsula los operandos, aplica el operador subyacente y ajusta el
resultado.

Para los operadores de igualdad

C#

== !=

existe una forma de elevación de un operador si los tipos de operando son tipos
de valor que no aceptan valores NULL y si el tipo de resultado es bool . La forma
de elevación se construye agregando un único ? modificador a cada tipo de
operando. El operador de elevación considera que dos valores NULL son iguales y
un valor NULL es distinto de cualquier valor distinto de NULL. Si ambos operandos
no son NULL, el operador de elevación desencapsula los operandos y aplica el
operador subyacente para generar el bool resultado.

Para los operadores relacionales

C#
 < > <= >=

existe una forma de elevación de un operador si los tipos de operando son tipos
de valor que no aceptan valores NULL y si el tipo de resultado es bool . La forma
de elevación se construye agregando un único ? modificador a cada tipo de
operando. El operador de elevación produce el valor false si uno o los dos
operandos son NULL. De lo contrario, el operador de elevación desencapsula los
operandos y aplica el operador subyacente para generar el bool resultado.

Búsqueda de miembros
Una búsqueda de miembros es el proceso por el que se determina el significado de un
nombre en el contexto de un tipo. Una búsqueda de miembros se puede producir como
parte de la evaluación de una simple_name (nombres simples) o un member_access
(acceso a miembros) en una expresión. Si el simple_name o member_access se produce
como primary_expression de un invocation_expression (invocaciones de método), se dice
que el miembro se invoca.

Si un miembro es un método o un evento, o si es una constante, un campo o una

propiedad de un tipo de delegado (delegados) o del tipo dynamic (el tipo dinámico), se
dice que el miembro es invocable.

La búsqueda de miembros considera no solo el nombre de un miembro, sino también el

número de parámetros de tipo que tiene el miembro y si el miembro es accesible. En lo
que respecta a la búsqueda de miembros, los métodos genéricos y los tipos genéricos
anidados tienen el número de parámetros de tipo indicado en sus declaraciones
respectivas y todos los demás miembros tienen parámetros de tipo cero.

Una búsqueda de miembro de un nombre   N con K   parámetros de tipo en un tipo   T

se procesa de la siguiente manera:

En primer lugar, se determina un conjunto de miembros accesibles denominados

 N :
Si T es un parámetro de tipo, el conjunto es la Unión de los conjuntos de
miembros accesibles denominados   N en cada uno de los tipos especificados
como restricción principal o restricción secundaria (restricciones de parámetro
de tipo) para   T , junto con el conjunto de miembros accesibles denominados
  N en object .
De lo contrario, el conjunto se compone de todos los miembros accesibles
(acceso a miembros) denominados   N en   T , incluidos los miembros heredados
 y los miembros accesibles denominados   N en object . Si T es un tipo
construido, el conjunto de miembros se obtiene sustituyendo los argumentos
de tipo tal y como se describe en miembros de tipos construidos. Los miembros
que incluyen un override modificador se excluyen del conjunto.
Después, si K es cero, se quitan todos los tipos anidados cuyas declaraciones
incluyen parámetros de tipo. Si K no es cero, se quitan todos los miembros con un
número diferente de parámetros de tipo. Tenga en cuenta que cuando K es cero,
no se quitan los métodos que tienen parámetros de tipo, ya que el proceso de
inferencia de tipos (inferencia de tipos) podría inferir los argumentos de tipo.
Después, si se invoca el miembro, todos los miembros que no sean de invocable se
quitarán del conjunto.
Después, los miembros que están ocultos por otros miembros se quitan del
conjunto. Para cada miembro del S.M conjunto, donde S es el tipo en el que   M se
declara el miembro, se aplican las siguientes reglas:
Si M es una constante, un campo, una propiedad, un evento o un miembro de
enumeración, todos los miembros declarados en un tipo base de S se quitan
del conjunto.
Si M es una declaración de tipos, todos los tipos que no sean declarados en un
tipo base de S se quitan del conjunto y todas las declaraciones de tipos con el
mismo número de parámetros de tipo M declarados en un tipo base de S se
quitan del conjunto.
Si M es un método, todos los miembros que no sean de método declarados en
un tipo base de S se quitan del conjunto.
Después, los miembros de interfaz que están ocultos por miembros de clase se
quitan del conjunto. Este paso solo tiene efecto si T es un parámetro de tipo y T
tiene una clase base efectiva distinta de object y un conjunto de interfaces
efectivo que no está vacío (restricciones de parámetro de tipo). Para cada miembro
del S.M conjunto, donde S es el tipo en el que se declara el miembro M , se
aplican las reglas siguientes si S es una declaración de clase distinta de object :
Si M es una constante, un campo, una propiedad, un evento, un miembro de
enumeración o una declaración de tipos, todos los miembros declarados en una
declaración de interfaz se quitan del conjunto.
Si M es un método, se quitan del conjunto todos los miembros que no son de
método declarados en una declaración de interfaz y todos los métodos con la
misma firma que M se declaran en una declaración de interfaz se quitan del
conjunto.
Por último, si se han quitado los miembros ocultos, se determina el resultado de la
búsqueda:
 Si el conjunto está formado por un único miembro que no es un método, este
miembro es el resultado de la búsqueda.
De lo contrario, si el conjunto solo contiene métodos, este grupo de métodos
es el resultado de la búsqueda.
De lo contrario, la búsqueda es ambigua y se produce un error en tiempo de
enlace.

Para búsquedas de miembros en tipos que no sean de tipo e interfaces, y búsquedas de

miembros en interfaces que son estrictamente de herencia única (cada interfaz de la
cadena de herencia tiene exactamente cero o una interfaz base directa), el efecto de las
reglas de búsqueda es simplemente que los miembros derivados ocultan los miembros
base con el mismo nombre o signatura. Dichas búsquedas de herencia única nunca son
ambiguas. Las ambigüedades que pueden surgir en las búsquedas de miembros en
interfaces de herencia múltiple se describen en acceso a miembros de interfaz.

Tipos base
En lo que respecta a la búsqueda de miembros, T se considera que un tipo tiene los
siguientes tipos base:

Si T es object , T no tiene ningún tipo base.

Si T es un enum_type, los tipos base de T son los tipos de clase System.Enum ,
System.ValueType y object .

Si T es un struct_type, los tipos base de T son los tipos de clase System.ValueType

y object .
Si T es un class_type, los tipos base de T son las clases base de T , incluido el tipo
de clase object .
Si T es un interface_type, los tipos base de T son las interfaces base de T y el tipo
de clase object .
Si T es un array_type, los tipos base de T son los tipos de clase System.Array y
object .
Si T es un delegate_type, los tipos base de T son los tipos de clase
System.Delegate y object .

Miembros de función
Los miembros de función son miembros que contienen instrucciones ejecutables. Los
miembros de función siempre son miembros de tipos y no pueden ser miembros de
espacios de nombres. C# define las siguientes categorías de miembros de función:
 Métodos
Propiedades
Events
Indizadores
Operadores definidos por el usuario
Constructores de instancias
Constructores estáticos
Destructores

A excepción de los destructores y los constructores estáticos (que no se pueden invocar

explícitamente), las instrucciones contenidas en miembros de función se ejecutan a
través de las invocaciones de miembros de función. La sintaxis real para escribir una
invocación de miembros de función depende de la categoría de miembro de función
determinada.

La lista de argumentos (listas de argumentos) de una invocación de miembros de

función proporciona valores reales o referencias de variable para los parámetros del
miembro de función.

Las invocaciones de métodos genéricos pueden emplear la inferencia de tipos para

determinar el conjunto de argumentos de tipo que se van a pasar al método. Este
proceso se describe en inferencia de tipos.

Las invocaciones de métodos, indizadores, operadores y constructores de instancia

emplean la resolución de sobrecarga para determinar cuál de un conjunto candidato de
miembros de función se va a invocar. Este proceso se describe en resolución de
sobrecarga.

Una vez que se ha identificado un miembro de función determinado en tiempo de

enlace, posiblemente a través de la resolución de sobrecarga, el proceso real en tiempo
de ejecución de la invocación del miembro de función se describe en la comprobación
en tiempo de compilación de la resolución de sobrecarga dinámica.

En la tabla siguiente se resume el procesamiento que tiene lugar en construcciones que

implican las seis categorías de miembros de función que se pueden invocar
explícitamente. En la tabla,,, e x y y value indican expresiones clasificadas como
variables o valores, T indica una expresión clasificada como un tipo, F es el nombre
simple de un método y P es el nombre simple de una propiedad.

Construir Ejemplo Descripción

Construir Ejemplo Descripción

Invocación F(x,y) La resolución de sobrecarga se aplica para seleccionar el mejor método

de método F en la clase o estructura contenedora. El método se invoca con la lista
de argumentos (x,y) . Si el método no es static , la expresión de
instancia es this .

T.F(x,y) La resolución de sobrecarga se aplica para seleccionar el mejor método

F en la clase o estructura T . Se produce un error en tiempo de enlace
si el método no es static . El método se invoca con la lista de
argumentos (x,y) .

e.F(x,y) La resolución de sobrecarga se aplica para seleccionar el mejor método

F en la clase, estructura o interfaz dada por el tipo de e . Se produce un
error en tiempo de enlace si el método es static . El método se invoca
con la expresión de instancia e y la lista de argumentos (x,y) .

Property P get Se invoca el descriptor de acceso de la propiedad P en la clase o

Access estructura contenedora. Se produce un error en tiempo de compilación
si P es de solo escritura. Si P no es static , la expresión de instancia es
this .

P = El set descriptor de acceso de la propiedad P en la clase o estructura

value contenedora se invoca con la lista de argumentos (value) . Se produce
un error en tiempo de compilación si P es de solo lectura. Si P no es
static , la expresión de instancia es this .

T.P get Se invoca el descriptor de acceso de la propiedad P en la clase o

estructura T . Se produce un error en tiempo de compilación si P no es
static o si P es de solo escritura.

T.P = El set descriptor de acceso de la propiedad P de la clase o struct T se

value invoca con la lista de argumentos (value) . Se produce un error en
tiempo de compilación si P no es static o si P es de solo lectura.

e.P El get descriptor de acceso de la propiedad P en la clase, estructura o

interfaz proporcionada por el tipo de e se invoca con la expresión de
instancia e . Se produce un error en tiempo de enlace si P es static o
si P es de solo escritura.

e.P = El set descriptor de acceso de la propiedad P en la clase, estructura o

value interfaz proporcionada por el tipo de e se invoca con la expresión de
instancia e y la lista de argumentos (value) . Se produce un error en
tiempo de enlace si P es static o si P es de solo lectura.

Acceso a E += add Se invoca el descriptor de acceso del evento E en la clase o

eventos value estructura contenedora. Si E no es static, la expresión de instancia es
this .
Construir Ejemplo Descripción

E -= remove Se invoca el descriptor de acceso del evento E en la clase o

value estructura contenedora. Si E no es static, la expresión de instancia es
this .

T.E += add Se invoca el descriptor de acceso del evento E en la clase o

value estructura T . Se produce un error en tiempo de enlace si E no es
estático.

T.E -= remove Se invoca el descriptor de acceso del evento E en la clase o

value estructura T . Se produce un error en tiempo de enlace si E no es
estático.

e.E += El add descriptor de acceso del evento E en la clase, estructura o

value interfaz proporcionada por el tipo de e se invoca con la expresión de
instancia e . Se produce un error en tiempo de enlace si E es estático.

e.E -= El remove descriptor de acceso del evento E en la clase, estructura o

value interfaz proporcionada por el tipo de e se invoca con la expresión de
instancia e . Se produce un error en tiempo de enlace si E es estático.

Acceso a e[x,y] La resolución de sobrecarga se aplica para seleccionar el mejor

indizador indexador en la clase, estructura o interfaz dada por el tipo de e. El get
descriptor de acceso del indizador se invoca con la expresión de
instancia e y la lista de argumentos (x,y) . Se produce un error en
tiempo de enlace si el indizador es de solo escritura.

e[x,y] = La resolución de sobrecarga se aplica para seleccionar el mejor

value indexador en la clase, estructura o interfaz dada por el tipo de e . El
set descriptor de acceso del indizador se invoca con la expresión de
instancia e y la lista de argumentos (x,y,value) . Se produce un error
en tiempo de enlace si el indizador es de solo lectura.

Invocación -x La resolución de sobrecarga se aplica para seleccionar el mejor

de operador unario en la clase o estructura dada por el tipo de x . El
operador operador seleccionado se invoca con la lista de argumentos (x) .

x + y La resolución de sobrecarga se aplica para seleccionar el mejor

operador binario en las clases o Structs que proporcionan los tipos de
x y y . El operador seleccionado se invoca con la lista de argumentos
(x,y) .

Invocación new La resolución de sobrecarga se aplica para seleccionar el mejor

del T(x,y) constructor de instancia en la clase o estructura T . El constructor de
constructor instancia se invoca con la lista de argumentos (x,y) .
de
instancia
Listas de argumentos
Cada invocación de miembro de función y delegado incluye una lista de argumentos
que proporciona valores reales o referencias de variable para los parámetros del
miembro de función. La sintaxis para especificar la lista de argumentos de una
invocación de miembros de función depende de la categoría de miembros de función:

En el caso de los constructores de instancias, los métodos, los indizadores y los

delegados, los argumentos se especifican como un argument_list, como se
describe a continuación. En el caso de los indizadores, al invocar el set descriptor
de acceso, la lista de argumentos incluye también la expresión especificada como
operando derecho del operador de asignación.
En el caso de las propiedades, la lista de argumentos está vacía al invocar el get
descriptor de acceso y se compone de la expresión especificada como operando
derecho del operador de asignación al invocar el set descriptor de acceso.
En el caso de los eventos, la lista de argumentos se compone de la expresión
especificada como operando derecho del += -= operador o.
En el caso de los operadores definidos por el usuario, la lista de argumentos se
compone del operando único del operador unario o de los dos operandos del
operador binario.

Los argumentos de las propiedades (propiedades), los eventos (eventos) y los

operadores definidos por el usuario (operadores) siempre se pasan como parámetros de
valor (parámetros de valor). Los argumentos de los indizadores (indizadores) siempre se
pasan como parámetros de valor (parámetros de valor) o como matrices de parámetros
(matrices deparámetros). Los parámetros de referencia y de salida no se admiten para
estas categorías de miembros de función.

Los argumentos de una invocación de constructor de instancia, método, indexador o

delegado se especifican como un argument_list:

antlr

argument_list

: argument (',' argument)*

argument

: argument_name? argument_value

argument_name

: identifier ':'

 argument_value

: expression

| 'ref' variable_reference

| 'out' variable_reference

Una argument_list está formada por uno o más argumentos, separados por comas. Cada
argumento consta de un argument_name opcional seguido de un argument_value. Un
argumento con un argument_name se conoce como un argumento *con nombre,
mientras que un argumento * sin un argument_name es un argumento posicional*. Es un
error que un argumento posicional aparezca después de un argumento con nombre en
un _argument_list *.

El argument_value puede adoptar uno de los siguientes formatos:

Una expresión, que indica que el argumento se pasa como parámetro de valor
(parámetros de valor).
Palabra clave ref seguida de un variable_reference (referencias de variable), que
indica que el argumento se pasa como parámetro de referencia (parámetros de
referencia). Una variable debe estar asignada definitivamente (asignación
definitiva) antes de que se pueda pasar como un parámetro de referencia. Palabra
clave out seguida de un variable_reference (referencias de variable), que indica que
el argumento se pasa como parámetro de salida (parámetros de salida). Una
variable se considera asignada definitivamente (asignación definitiva) después de
una invocación de miembro de función en la que se pasa la variable como
parámetro de salida.

Parámetros correspondientes
Para cada argumento de una lista de argumentos debe haber un parámetro
correspondiente en el miembro de función o el delegado que se va a invocar.

La lista de parámetros que se utiliza en lo siguiente se determina de la siguiente manera:

En el caso de los métodos virtuales y los indizadores definidos en las clases, la lista
de parámetros se elige de la declaración o invalidación más específica del
miembro de función, empezando por el tipo estático del receptor y buscando en
sus clases base.
En el caso de los métodos e indexadores de la interfaz, la lista de parámetros se
selecciona como la definición más específica del miembro, empezando por el tipo
de interfaz y buscando en las interfaces base. Si no se encuentra ninguna lista de
parámetros única, se construye una lista de parámetros con nombres inaccesibles y
 ningún parámetro opcional, de modo que las invocaciones no pueden usar
parámetros con nombre u omitir argumentos opcionales.
Para los métodos parciales, se usa la lista de parámetros de la declaración de
método parcial de definición.
En el caso de todos los demás miembros de función y delegados, solo hay una
lista de parámetros única, que es la que se usa.

La posición de un argumento o parámetro se define como el número de argumentos o

parámetros que lo preceden en la lista de argumentos o en la lista de parámetros.

Los parámetros correspondientes para los argumentos de miembro de función se

establecen de la siguiente manera:

Argumentos en el argument_list de constructores de instancia, métodos,

indizadores y delegados:
Un argumento posicional en el que se produce un parámetro fijo en la misma
posición en la lista de parámetros corresponde a ese parámetro.
Un argumento posicional de un miembro de función con una matriz de
parámetros invocada en su forma normal corresponde a la matriz de
parámetros, que debe aparecer en la misma posición en la lista de parámetros.
Argumento posicional de un miembro de función con una matriz de parámetros
invocada en su forma expandida, donde no se produce ningún parámetro fijo
en la misma posición en la lista de parámetros, corresponde a un elemento de
la matriz de parámetros.
Un argumento con nombre corresponde al parámetro con el mismo nombre en
la lista de parámetros.
En el caso de los indizadores, al invocar el set descriptor de acceso, la
expresión especificada como operando derecho del operador de asignación
corresponde al value parámetro implícito de la set declaración del descriptor
de acceso.
En el caso de las propiedades, al invocar el get descriptor de acceso no hay
ningún argumento. Al invocar el set descriptor de acceso, la expresión
especificada como operando derecho del operador de asignación corresponde al
value parámetro implícito de la set declaración del descriptor de acceso.
En el caso de los operadores unarios definidos por el usuario (incluidas las
conversiones), el único operando corresponde al parámetro único de la
declaración del operador.
En el caso de los operadores binarios definidos por el usuario, el operando
izquierdo corresponde al primer parámetro y el operando derecho se corresponde
con el segundo parámetro de la declaración del operador.
Evaluación en tiempo de ejecución de listas de argumentos
Durante el procesamiento en tiempo de ejecución de una invocación de miembro de
función (comprobación en tiempo de compilación de la resolución dinámica de
sobrecarga), las expresiones o referencias de variables de una lista de argumentos se
evalúan en orden, de izquierda a derecha, de la manera siguiente:

Para un parámetro de valor, se evalúa la expresión de argumento y se realiza una

conversión implícita (conversiones implícitas) en el tipo de parámetro
correspondiente. El valor resultante se convierte en el valor inicial del parámetro de
valor en la invocación del miembro de función.
Para un parámetro de referencia o de salida, se evalúa la referencia de la variable y
la ubicación de almacenamiento resultante se convierte en la ubicación de
almacenamiento representada por el parámetro en la invocación del miembro de
función. Si la referencia de variable dada como parámetro de referencia o de salida
es un elemento de matriz de un reference_type, se realiza una comprobación en
tiempo de ejecución para asegurarse de que el tipo de elemento de la matriz es
idéntico al tipo del parámetro. Si se produce un error en esta comprobación,
System.ArrayTypeMismatchException se produce una excepción.

Los métodos, indizadores y constructores de instancias pueden declarar su parámetro

situado más a la derecha para que sea una matriz de parámetros (matrices de
parámetros). Estos miembros de función se invocan en su forma normal o en su forma
expandida, en función de cuál sea aplicable (miembro de función aplicable):

Cuando se invoca un miembro de función con una matriz de parámetros en su

forma normal, el argumento dado para la matriz de parámetros debe ser una
expresión única que se pueda convertir implícitamente (conversiones implícitas) al
tipo de matriz de parámetros. En este caso, la matriz de parámetros actúa
exactamente como un parámetro de valor.
Cuando se invoca un miembro de función con una matriz de parámetros en su
forma expandida, la invocación debe especificar cero o más argumentos
posicionales para la matriz de parámetros, donde cada argumento es una
expresión que es convertible implícitamente (conversiones implícitas) al tipo de
elemento de la matriz de parámetros. En este caso, la invocación crea una instancia
del tipo de matriz de parámetros con una longitud correspondiente al número de
argumentos, inicializa los elementos de la instancia de la matriz con los valores de
argumento especificados y utiliza la instancia de matriz recién creada como
argumento real.

Las expresiones de una lista de argumentos siempre se evalúan en el orden en que se

escriben. Por lo tanto, el ejemplo
 C#

class Test

static void F(int x, int y = -1, int z = -2) {

System.Console.WriteLine("x = {0}, y = {1}, z = {2}", x, y, z);

static void Main() {

int i = 0;

F(i++, i++, i++);

F(z: i++, x: i++);

genera el resultado

Consola

x = 0, y = 1, z = 2

x = 4, y = -1, z = 3

Las reglas de covarianza de matriz (covarianza de matriz) permiten que un valor de un

tipo de matriz A[] sea una referencia a una instancia de un tipo de matriz B[] , siempre
que exista una conversión de referencia implícita de B a A . Debido a estas reglas,
cuando un elemento de matriz de un reference_type se pasa como parámetro de
referencia o de salida, se requiere una comprobación en tiempo de ejecución para
asegurarse de que el tipo de elemento real de la matriz es idéntico al del parámetro. En
el ejemplo

C#

class Test

static void F(ref object x) {...}

static void Main() {

object[] a = new object[10];

object[] b = new string[10];

F(ref a[0]); // Ok

F(ref b[1]); // ArrayTypeMismatchException

la segunda invocación de F hace que System.ArrayTypeMismatchException se produzca

una excepción porque el tipo de elemento real de b es string y no object .
Cuando se invoca un miembro de función con una matriz de parámetros en su forma
expandida, la invocación se procesa exactamente como si se hubiera insertado una
expresión de creación de matriz con un inicializador de matriz (expresiones de creación
de matriz) alrededor de los parámetros expandidos. Por ejemplo, dada la declaración

C#

void F(int x, int y, params object[] args);

las siguientes invocaciones de la forma expandida del método

C#

F(10, 20);

F(10, 20, 30, 40);

F(10, 20, 1, "hello", 3.0);

se corresponde exactamente con

C#

F(10, 20, new object[] {});

F(10, 20, new object[] {30, 40});

F(10, 20, new object[] {1, "hello", 3.0});

En concreto, tenga en cuenta que se crea una matriz vacía cuando no hay ningún
argumento dado para la matriz de parámetros.

Cuando se omiten los argumentos de un miembro de función con los parámetros

opcionales correspondientes, se pasan implícitamente los argumentos predeterminados
de la declaración de miembro de función. Dado que siempre son constantes, su
evaluación no afectará al orden de evaluación de los argumentos restantes.

Inferencia de tipos
Cuando se llama a un método genérico sin especificar argumentos de tipo, un proceso
de inferencia de tipos intenta deducir los argumentos de tipo de la llamada. La
presencia de la inferencia de tipos permite usar una sintaxis más cómoda para llamar a
un método genérico y permite al programador evitar especificar información de tipos
redundantes. Por ejemplo, dada la declaración del método:

C#
 class Chooser

static Random rand = new Random();

public static T Choose<T>(T first, T second) {

return (rand.Next(2) == 0)? first: second;

es posible invocar el Choose método sin especificar explícitamente un argumento de

tipo:

C#

int i = Chooser.Choose(5, 213); // Calls Choose<int>

string s = Chooser.Choose("foo", "bar"); // Calls Choose<string>

A través de la inferencia de tipos, los argumentos de tipo int y string se determinan a

partir de los argumentos del método.

La inferencia de tipos se produce como parte del procesamiento en tiempo de enlace de

una invocación de método (invocaciones de método) y tiene lugar antes del paso de
resolución de sobrecarga de la invocación. Cuando se especifica un grupo de métodos
determinado en una invocación de método y no se especifica ningún argumento de tipo
como parte de la invocación del método, se aplica la inferencia de tipos a cada método
genérico del grupo de métodos. Si la inferencia de tipos se realiza correctamente, los
argumentos de tipo deducido se usan para determinar los tipos de argumentos para la
resolución de sobrecarga subsiguiente. Si la resolución de sobrecarga elige un método
genérico como el que se va a invocar, los argumentos de tipo deducido se usan como
argumentos de tipo reales para la invocación. Si se produce un error en la inferencia de
tipos para un método determinado, ese método no participa en la resolución de
sobrecarga. El error de inferencia de tipos, en y de sí mismo, no produce un error en
tiempo de enlace. Sin embargo, a menudo se produce un error en tiempo de enlace
cuando la resolución de sobrecarga no encuentra ningún método aplicable.

Si el número de argumentos proporcionado es diferente del número de parámetros del

método, se producirá un error inmediatamente en la inferencia. En caso contrario,
supongamos que el método genérico tiene la siguiente firma:

C#

Tr M<X1,...,Xn>(T1 x1, ..., Tm xm)

Con una llamada al método de la forma M(E1...Em) , la tarea de inferencia de tipo es

buscar argumentos S1...Sn de tipo únicos para cada uno de los parámetros de tipo
X1...Xn , de modo que la llamada M<S1...Sn>(E1...Em) sea válida.

Durante el proceso de inferencia, cada parámetro de tipo Xi se fija en un tipo

determinado Si o se desfija con un conjunto de límites asociado. Cada uno de los
límites es algún tipo T . Inicialmente, cada variable Xi de tipo se desfija con un
conjunto vacío de límites.

La inferencia de tipos tiene lugar en fases. Cada fase intentará deducir los argumentos
de tipo para obtener más variables de tipo basadas en los resultados de la fase anterior.
La primera fase realiza algunas inferencias iniciales de límites, mientras que en la
segunda fase se corrigen las variables de tipo a tipos específicos y se deducen más
límites. Es posible que la segunda fase se repita varias veces.

Nota: La inferencia de tipos no solo tiene lugar cuando se llama a un método genérico.
La inferencia de tipos para la conversión de grupos de métodos se describe en
inferencia de tipos para la conversión de grupos de métodos y encontrar el mejor tipo
común de un conjunto de expresiones se describe en Buscar el mejor tipo común de un
conjunto de expresiones.

La primera fase

Para cada uno de los argumentos del método Ei :

Si Ei es una función anónima, se realiza una inferencia de tipo de parámetro

explícita (inferencias de tipos de parámetros explícitos) de Ei a Ti
De lo contrario, si Ei tiene un tipo U y xi es un parámetro de valor, se realiza una
inferencia de enlace inferior desde U a Ti .
De lo contrario, si Ei tiene un tipo U y xi es un ref out parámetro o, se realiza
una inferencia exacta desde U a Ti .
De lo contrario, no se realiza ninguna inferencia para este argumento.

La segunda fase

La segunda fase continúa como sigue:

Todas las variables de tipo Xi sin corregir que no dependen de (dependencia) Xj

se corrigen (corrigiendo).
Si no existe ninguna variable de tipo, se fijan todas las variables de tipo no fijas Xi
para las que se retrasen:
 Hay al menos una variable de tipo Xj que depende de Xi
Xi tiene un conjunto de límites no vacío
Si no existe ninguna variable de tipo y hay variables de tipo sin corregir , se
produce un error en la inferencia de tipos.
De lo contrario, si no existen más variables de tipo sin corregir , la inferencia de
tipos se realiza correctamente.
De lo contrario, para todos los argumentos Ei con el tipo de parámetro
correspondiente Ti en el que los tipos de salida (tipos de salida) contienen
variables de tipo sin corregir Xj pero los tipos de entrada (tipos de entrada) no,
una inferencia de tipo de salida (inferencias de tipo de salida) se realiza desde Ei a
Ti . A continuación, se repite la segunda fase.

Tipos de entrada
Si E es un grupo de métodos o una función anónima con tipos implícitos y T es un tipo
de delegado o un tipo de árbol de expresión, todos los tipos de parámetro de T son
tipos de entrada de tipo E T .

Tipos de salida
Si E es un grupo de métodos o una función anónima y T es un tipo de delegado o un
tipo de árbol de expresión, el tipo de valor devuelto de T es un tipo de salida de E con
el tipo T .

Dependencia
Una variable de tipo sin fijo Xi depende directamente de una variable de tipo sin corregir
Xj si para algún argumento Ek con tipo Tk Xj se produce en un tipo de entrada de Ek

con el tipo Tk y Xi se produce en un tipo de salida de Ek con el tipo Tk .

Xj depende de Xi Si Xj depende directamente de Xi o si Xi depende directamente de

Xk y Xk depende de Xj . Por lo tanto, "depende de" es el cierre transitivo pero no

reflexivo de "depende directamente de".

Inferencias de tipos de salida

Una inferencia de tipo de salida se realiza desde una expresión E a un tipo T de la
siguiente manera:
 Si E es una función anónima con el tipo de valor devuelto inferido U (tipo de
valordevuelto deducido) y es un tipo de T delegado o un tipo de árbol de
expresión con el tipo de valor devuelto Tb , una inferencia de límite inferior
(inferencias de límite inferior) se realiza desde U a Tb .
De lo contrario, si E es un grupo de métodos y T es un tipo de delegado o de
árbol de expresión con tipos de parámetro T1...Tk y tipo de valor devuelto Tb , y
la resolución de sobrecarga de E con los tipos T1...Tk produce un único método
con el tipo de valor devuelto U , se realiza una inferencia de enlace inferior desde U
a Tb .
De lo contrario, si E es una expresión de tipo U , se realiza una inferencia de enlace
inferior desde U a T .
De lo contrario, no se realiza ninguna inferencia.

Inferencias explícitas de tipos de parámetros

Una inferencia de tipo de parámetro explícita se realiza desde una expresión E a un tipo
T de la siguiente manera:

Si E es una función anónima con tipo explícito con tipos de parámetro U1...Uk y
T es un tipo de delegado o un tipo de árbol de expresión con tipos de parámetro

V1...Vk , para cada Ui se realiza una inferencia exacta (inferencias exactas) desde

Ui hasta el Vi correspondiente

Inferencias exactas

Una inferencia exacta de un tipo U a un tipo V se realiza de la siguiente manera:

Si V es uno de los fijos Xi , U se agrega al conjunto de límites exactos para Xi .

De lo contrario V1...Vk , U1...Uk los conjuntos y se determinan comprobando si

se aplica cualquiera de los casos siguientes:
V es un tipo V1[...] de matriz y U es un tipo U1[...] de matriz del mismo

rango
V es el tipo V1? y U es el tipo. U1?

V es un tipo construido C<V1...Vk> y U es un tipo construido. C<U1...Uk>

Si se aplica cualquiera de estos casos, se realiza una inferencia exacta desde cada
Ui hasta el correspondiente Vi .

En caso contrario, no se realiza ninguna inferencia.

Inferencias con límite inferior
Una inferencia de límite inferior desde un tipo U a un tipo V se realiza de la siguiente
manera:

Si V es uno de los desfijos Xi , U se agrega al conjunto de límites inferiores para

Xi .

De lo contrario, si V es el tipo V1? y U es el tipo U1? , se realiza una inferencia de

límite inferior desde U1 a V1 .

De lo contrario U1...Uk , V1...Vk los conjuntos y se determinan comprobando si

se aplica cualquiera de los casos siguientes:

V es un tipo V1[...] de matriz y U es un tipo U1[...] de matriz (o un

parámetro de tipo cuyo tipo base efectivo es U1[...] ) del mismo rango

V es uno de IEnumerable<V1> , ICollection<V1> o IList<V1> y U es un tipo de

matriz unidimensional U1[] (o un parámetro de tipo cuyo tipo base efectivo es

U1[] )

V es una clase, un struct, una interfaz o un tipo de delegado construidos

C<V1...Vk> y hay un tipo único C<U1...Uk> , de modo que U (o, si U es un

parámetro de tipo, su clase base efectiva o cualquier miembro de su conjunto
de interfaz efectivo) es idéntico a, hereda de (directa o indirectamente) o
implementa (directa o indirectamente) C<U1...Uk> .

(La restricción de unicidad significa que, en la interfaz Case C<T> {} class U:

C<X>, C<Y> {} , no se realiza ninguna inferencia al deducir de U a C<T> porque
U1 puede ser X o Y ).

Si se aplica cualquiera de estos casos, se realiza una inferencia desde cada Ui hasta
el correspondiente, como se indica a continuación Vi :
Si Ui no se sabe que es un tipo de referencia, se realiza una inferencia exacta .
De lo contrario, si U es un tipo de matriz, se realiza una inferencia de límite
inferior .
De lo contrario, si V es C<V1...Vk> , la inferencia depende del parámetro de
tipo i-ésima de C :
Si es covariante, se realiza una inferencia de límite inferior .
Si es contravariante, se realiza una inferencia enlazada en el límite superior .
Si es invariable, se realiza una inferencia exacta .
 De lo contrario, no se realiza ninguna inferencia.

Inferencias de límite superior

Una inferencia de límite superior de un tipo U a un tipo V se realiza de la siguiente
manera:

Si V es uno de los desfijos Xi , U se agrega al conjunto de límites superiores para

Xi .

De lo contrario V1...Vk , U1...Uk los conjuntos y se determinan comprobando si

se aplica cualquiera de los casos siguientes:

U es un tipo U1[...] de matriz y V es un tipo V1[...] de matriz del mismo

rango

U es uno de IEnumerable<Ue> , ICollection<Ue> o IList<Ue> y V es un tipo de

matriz unidimensional. Ve[]

U es el tipo U1? y V es el tipo. V1?

U es un tipo de clase, estructura, interfaz o delegado construido C<U1...Uk> y V

es una clase, estructura, interfaz o tipo de delegado que es idéntico a, hereda
de (directa o indirectamente) o implementa (directa o indirectamente) un tipo
único. C<V1...Vk>

(La restricción de unicidad significa que, si tenemos interface C<T>{} class

V<Z>: C<X<Z>>, C<Y<Z>>{} , no se realiza ninguna inferencia al deducir de C<U1>
a V<Q> . No se realizan inferencias de U1 en X<Q> ni Y<Q> .)

Si se aplica cualquiera de estos casos, se realiza una inferencia desde cada Ui hasta
el correspondiente, como se indica a continuación Vi :
Si Ui no se sabe que es un tipo de referencia, se realiza una inferencia exacta .
De lo contrario, si V es un tipo de matriz, se realiza una inferencia de límite
superior .
De lo contrario, si U es C<U1...Uk> , la inferencia depende del parámetro de
tipo i-ésima de C :
Si es covariante, se realiza una inferencia enlazada en el límite superior .
Si es contravariante, se realiza una inferencia de límite inferior .
Si es invariable, se realiza una inferencia exacta .

De lo contrario, no se realiza ninguna inferencia.

Corrección de
Una variable de tipo sin corregir Xi con un conjunto de límites se fija de la manera
siguiente:

El conjunto de tipos candidatos Uj comienza como el conjunto de todos los tipos

del conjunto de límites para Xi .
A continuación, examinaremos cada límite de a Xi su vez: para cada límite exacto
U de Xi todos los tipos Uj que no sean idénticos a, U se quitan del conjunto de

candidatos. Para cada límite inferior U de Xi todos los tipos Uj a los que no se
haya quitado una conversión implícita del U conjunto de candidatos. Para cada
límite superior U de Xi todos los tipos Uj a partir de los cuales no se quita una
conversión implícita de en U el conjunto de candidatos.
Si entre los tipos de candidatos restantes Uj hay un tipo único V desde el que hay
una conversión implícita a todos los demás tipos candidatos, Xi se fija en V .
De lo contrario, se produce un error en la inferencia de tipos.

Tipo de valor devuelto deducido

El tipo de valor devuelto deducido de una función anónima F se usa durante la

inferencia de tipos y la resolución de sobrecarga. El tipo de valor devuelto deducido
solo se puede determinar para una función anónima en la que se conocen todos los
tipos de parámetro, ya sea porque se proporcionan explícitamente, se proporcionan a
través de una conversión de función anónima o se infieren durante la inferencia de tipos
en una invocación de método genérico envolvente.

El tipo de resultado deducido se determina de la siguiente manera:

Si el cuerpo de F es una expresión que tiene un tipo, el tipo de resultado deducido

de F es el tipo de esa expresión.
Si el cuerpo de F es un bloque y el conjunto de expresiones de las instrucciones
del bloque return tiene un mejor tipo común T (encontrar el mejor tipo común
de un conjunto de expresiones), el tipo de resultado deducido de F es T .
De lo contrario, no se puede inferir un tipo de resultado para F .

El tipo de valor devuelto deducido se determina de la siguiente manera:

Si F es Async y el cuerpo de F es una expresión clasificada como Nothing

(clasificación de expresión) o un bloque de instrucciones en el que ninguna
instrucción return tiene expresiones, el tipo de valor devuelto deducido es
System.Threading.Tasks.Task
 Si F es Async y tiene un tipo de resultado deducido T , el tipo de valor devuelto
deducido es System.Threading.Tasks.Task<T> .
Si F no es asincrónico y tiene un tipo de resultado deducido T , el tipo de valor
devuelto deducido es T .
De lo contrario, no se puede inferir un tipo de valor devuelto para F .

Como ejemplo de inferencia de tipos que implica funciones anónimas, tenga en cuenta
el Select método de extensión declarado en la System.Linq.Enumerable clase:

C#

namespace System.Linq

public static class Enumerable

public static IEnumerable<TResult> Select<TSource,TResult>(

this IEnumerable<TSource> source,

Func<TSource,TResult> selector)

foreach (TSource element in source) yield return

selector(element);

Suponiendo que el System.Linq espacio de nombres se importó con una using cláusula
y, dada una clase Customer con una Name propiedad de tipo string , el Select método
se puede usar para seleccionar los nombres de una lista de clientes:

C#

List<Customer> customers = GetCustomerList();

IEnumerable<string> names = customers.Select(c => c.Name);

La invocación del método de extensión (invocaciones de método de extensión) de

Select se procesa rescribiendo la invocación a una invocación de método estático:

C#

IEnumerable<string> names = Enumerable.Select(customers, c => c.Name);

Dado que los argumentos de tipo no se especificaron explícitamente, se usa la

inferencia de tipos para inferir los argumentos de tipo. En primer lugar, el customers
argumento está relacionado con el source parámetro, infiriendo T a Customer . A
continuación, con el proceso de inferencia de tipos de función anónima descrito
anteriormente, c se especifica el tipo Customer y la expresión c.Name está relacionada
con el tipo de valor devuelto del selector parámetro, infiriendo S a string . Por lo
tanto, la invocación es equivalente a

C#

Sequence.Select<Customer,string>(customers, (Customer c) => c.Name)

y el resultado es de tipo IEnumerable<string> .

En el ejemplo siguiente se muestra cómo la inferencia de tipos de función anónima

permite la información de tipo para "fluir" entre los argumentos de una invocación de
método genérico. Dado el método:

C#

static Z F<X,Y,Z>(X value, Func<X,Y> f1, Func<Y,Z> f2) {

return f2(f1(value));

Inferencia de tipos para la invocación:

C#

double seconds = F("1:15:30", s => TimeSpan.Parse(s), t => t.TotalSeconds);

continúa del modo siguiente: en primer lugar, el argumento "1:15:30" está relacionado
con el value parámetro, X que se infiere en string . A continuación, el parámetro de la
primera función anónima, s , recibe el tipo deducido string y la expresión
TimeSpan.Parse(s) está relacionada con el tipo de valor devuelto de f1 , infiriendo Y a

System.TimeSpan . Por último, el parámetro de la segunda función anónima, t , recibe el

tipo deducido System.TimeSpan y la expresión t.TotalSeconds está relacionada con el

tipo de valor devuelto de f2 , infiriendo Z a double . Por lo tanto, el resultado de la
invocación es de tipo double .

Inferencia de tipos para la conversión de grupos de métodos

De forma similar a las llamadas de métodos genéricos, la inferencia de tipos también se

debe aplicar cuando un grupo de métodos M que contiene un método genérico se
convierte en un tipo de delegado determinado D (conversiones de grupo de métodos).
Dado un método
 C#

Tr M<X1...Xn>(T1 x1 ... Tm xm)

y el grupo M de métodos que se asigna al tipo de delegado D la tarea de inferencia de

tipo es buscar argumentos de tipo para S1...Sn que la expresión:

C#

M<S1...Sn>

se convierte en compatible (declaraciones de delegado) con D .

A diferencia del algoritmo de inferencia de tipos para las llamadas de método genérico,
en este caso solo hay tipos de argumento, no hay expresiones de argumento. En
concreto, no hay ninguna función anónima y, por lo tanto, no es necesario que haya
varias fases de inferencia.

En su lugar, todos Xi se consideran sin corregir y se realiza una inferencia de enlace

inferior desde cada tipo Uj de argumento de D al tipo de parámetro correspondiente
Tj de M . Si no se encuentra ningún Xi límite, se produce un error en la inferencia de

tipos. De lo contrario, todos Xi se corrigen en los correspondientes Si , que son el

resultado de la inferencia de tipos.

Buscar el mejor tipo común de un conjunto de expresiones

En algunos casos, es necesario inferir un tipo común para un conjunto de expresiones.
En concreto, los tipos de elemento de matrices con tipo implícito y los tipos de valor
devueltos de las funciones anónimas con cuerpos de bloque se encuentran de esta
manera.

Intuitivamente, dado un conjunto de expresiones, E1...Em Esta inferencia debe ser

equivalente a llamar a un método.

C#

Tr M<X>(X x1 ... X xm)

con los Ei argumentos as.

Más concretamente, la inferencia comienza con una variable de tipo no fija X . A

continuación, se realizan inferencias de tipos de salida de cada Ei a X . Por último, X es
fijo y, si es correcto, el tipo resultante S es el mejor tipo común resultante para las
expresiones. Si no S existe, las expresiones no tienen el mejor tipo común.

Resolución de sobrecarga
La resolución de sobrecarga es un mecanismo en tiempo de enlace para seleccionar el
mejor miembro de función que se va a invocar a partir de una lista de argumentos y un
conjunto de miembros de función candidatos. La resolución de sobrecarga selecciona el
miembro de función que se va a invocar en los siguientes contextos distintos dentro de
C#:

Invocación de un método denominado en un invocation_expression (invocaciones

de método).
Invocación de un constructor de instancia denominado en un
object_creation_expression (expresiones de creación de objetos).
Invocación de un descriptor de acceso de indexador a través de un element_access
(acceso a elementos).
Invocación de un operador predefinido o definido por el usuario al que se hace
referencia en una expresión (resolución desobrecarga del operador unario y
resolución de sobrecarga del operador binario).

Cada uno de estos contextos define el conjunto de miembros de función candidatas y la

lista de argumentos en su propia manera única, tal como se describe en detalle en las
secciones mencionadas anteriormente. Por ejemplo, el conjunto de candidatos para una
invocación de método no incluye métodos marcados override (búsqueda de
miembros) y los métodos de una clase base no son candidatos si algún método de una
clase derivada es aplicable (invocaciones de método).

Una vez identificados los miembros de la función candidata y la lista de argumentos, la

selección del mejor miembro de función es la misma en todos los casos:

Dado el conjunto de miembros de función candidatos aplicables, se ubica el mejor

miembro de función de ese conjunto. Si el conjunto contiene solo un miembro de
función, ese miembro de función es el mejor miembro de función. De lo contrario,
el mejor miembro de función es un miembro de función que es mejor que todos
los demás miembros de función con respecto a la lista de argumentos
determinada, siempre que cada miembro de función se compare con el resto de
miembros de función mediante las reglas de un mejor miembro de función. Si no
hay exactamente un miembro de función que sea mejor que todos los demás
miembros de función, la invocación del miembro de función es ambigua y se
produce un error en tiempo de enlace.
En las secciones siguientes se definen los significados exactos de los términos *
miembro de función aplicable _ y _ mejor miembro de función *.

Miembro de función aplicable

Se dice que un miembro de función es un miembro de función aplicable con respecto a

una lista A de argumentos cuando se cumplen todas las condiciones siguientes:

Cada argumento de A corresponde a un parámetro en la declaración de miembro

de función tal y como se describe en los parámetros correspondientes, y cualquier
parámetro para el que ningún argumento corresponde es un parámetro opcional.
Para cada argumento de A , el modo de paso de parámetros del argumento (es
decir, el valor, ref o out ) es idéntico al modo de paso de parámetros del
parámetro correspondiente, y
para un parámetro de valor o una matriz de parámetros, existe una conversión
implícita (conversiones implícitas) del argumento al tipo del parámetro
correspondiente, o bien
para un ref out parámetro o, el tipo del argumento es idéntico al tipo del
parámetro correspondiente. Después de All, ref un out parámetro o es un alias
para el argumento pasado.

Para un miembro de función que incluye una matriz de parámetros, si el miembro de

función es aplicable a las reglas anteriores, se dice que es aplicable en su *formulario
normal _. Si un miembro de función que incluye una matriz de parámetros no es
aplicable en su forma normal, el miembro de función puede ser aplicable en su forma
expandida _ * * *:

La forma expandida se construye reemplazando la matriz de parámetros en la

declaración de miembro de función con cero o más parámetros de valor del tipo
de elemento de la matriz de parámetros de modo que el número de argumentos
de la lista de argumentos A coincida con el número total de parámetros. Si A tiene
menos argumentos que el número de parámetros fijos en la declaración de
miembro de función, no se puede construir la forma expandida del miembro de
función y, por tanto, no es aplicable.
De lo contrario, el formulario expandido es aplicable si para cada argumento del A
modo de paso de parámetros del argumento es idéntico al modo de paso de
parámetros del parámetro correspondiente, y
para un parámetro de valor fijo o un parámetro de valor creado por la
expansión, existe una conversión implícita (conversiones implícitas) del tipo del
argumento al tipo del parámetro correspondiente, o bien
 para un ref out parámetro o, el tipo del argumento es idéntico al tipo del
parámetro correspondiente.

Mejor miembro de función

Con el fin de determinar el mejor miembro de función, se construye una lista de

argumentos con la que se ha quitado una lista que contiene solo las expresiones de
argumento en el orden en que aparecen en la lista de argumentos original.

Las listas de parámetros para cada uno de los miembros de la función candidata se
construyen de la siguiente manera:

La forma expandida se utiliza si el miembro de función solo se aplica en el

formulario expandido.
Los parámetros opcionales sin argumentos correspondientes se quitan de la lista
de parámetros
Los parámetros se reordenan para que se produzcan en la misma posición que el
argumento correspondiente en la lista de argumentos.

Dada una lista A de argumentos con un conjunto de expresiones de argumentos {E1,

E2, ..., En} y dos miembros de función aplicables Mp y Mq con tipos de parámetros
{P1, P2, ..., Pn} y {Q1, Q2, ..., Qn} , Mp se define como un miembro de función

mejor que Mq si

para cada argumento, la conversión implícita de Ex a Qx no es mejor que la

conversión implícita de Ex a Px , y
para al menos un argumento, la conversión de Ex a Px es mejor que la conversión
de Ex a Qx .

Al realizar esta evaluación, si Mp o Mq es aplicable en su forma expandida, Px o Qx hace

referencia a un parámetro en la forma expandida de la lista de parámetros.

En caso de que las secuencias de tipo de parámetro   {P1, P2, ..., Pn} y {Q1, Q2, ...,
Qn} sean equivalentes (es decir Pi , cada una tiene una conversión de identidad en la
correspondiente Qi ), se aplican las siguientes reglas de separación de desempates, en
orden, para determinar el mejor miembro de función.

Si Mp es un método no genérico y Mq es un método genérico, Mp es mejor que Mq

.
De lo contrario, si Mp es aplicable en su forma normal y Mq tiene una params
matriz y solo es aplicable en su forma expandida, Mp es mejor que Mq .
 De lo contrario, si Mp tiene más parámetros declarados que Mq , Mp es mejor que
Mq . Esto puede ocurrir si ambos métodos tienen params matrices y solo se
pueden aplicar en sus formularios expandidos.
De lo contrario, si todos los parámetros de Mp tienen un argumento
correspondiente, mientras que los argumentos predeterminados deben sustituirse
por al menos un parámetro opcional en Mq , entonces Mp es mejor que Mq .
De lo contrario, si Mp tiene tipos de parámetro más específicos que Mq , entonces
Mp es mejor que Mq . Permita {R1, R2, ..., Rn} y {S1, S2, ..., Sn} represente

los tipos de parámetro sin instancia y sin expandir de Mp y Mq . Mp los tipos de

parámetro de son más específicos que Mq si, para cada parámetro, Rx no es
menos específico que Sx , y, para al menos un parámetro, Rx es más específico
que Sx :
Un parámetro de tipo es menos específico que un parámetro sin tipo.
De forma recursiva, un tipo construido es más específico que otro tipo
construido (con el mismo número de argumentos de tipo) si al menos un
argumento de tipo es más específico y ningún argumento de tipo es menos
específico que el argumento de tipo correspondiente en el otro.
Un tipo de matriz es más específico que otro tipo de matriz (con el mismo
número de dimensiones) si el tipo de elemento del primero es más específico
que el tipo de elemento del segundo.
De lo contrario, si un miembro es un operador no de elevación y el otro es un
operador de elevación, el valor de uno no elevado es mejor.
De lo contrario, ninguno de los miembros de función es mejor.

Mejor conversión de la expresión

Dada una conversión implícita C1 que convierte de una expresión E a un tipo T1 , y una
conversión implícita C2 que convierte de una expresión E a un tipo T2 , C1 es una
conversión mejor que C2 si E no coincide exactamente con T2 y al menos uno de los
siguientes elementos:

E coincide exactamente con T1 (expresión de coincidencia exacta)

T1 es un destino de conversión mejor que T2 (mejor destinode la conversión)

Expresión coincidente exactamente

Dada una expresión E y un tipo T , E coincide exactamente T si uno de los siguientes
contiene:

E tiene un tipo S y existe una conversión de identidad de S a T

 E es una función anónima, T es un tipo de delegado D o un tipo de árbol

Expression<D> de expresión y uno de los siguientes elementos contiene:

Existe un tipo de valor devuelto deducido X para E en el contexto de la lista de
parámetros de D (tipo de valor devuelto deducido) y existe una conversión de
identidad de X en el tipo de valor devuelto de D
E No es asincrónico y D tiene un tipo de valor devuelto Y o E es asincrónico y

D tiene un tipo de valor devuelto Task<Y> , y una de las siguientes:

El cuerpo de E es una expresión que coincide exactamente con Y
El cuerpo de E es un bloque de instrucciones donde cada instrucción return
devuelve una expresión que coincide exactamente con Y

Mejor destino de la conversión

Dados dos tipos diferentes T1 y T2 , T1 es un mejor destino de la conversión que T2 si
no existe una conversión implícita de T2 a T1 , y al menos uno de los siguientes:

Una conversión implícita de T1 a T2 EXISTS

T1 es un tipo de delegado D1 o un tipo de árbol de expresión Expression<D1> ,

T2 es un tipo de delegado D2 o un tipo Expression<D2> de árbol de expresión, D1

tiene un tipo de valor devuelto S1 y uno de los siguientes:
D2 Devuelve void

D2 tiene un tipo de valor devuelto S2 y S1 es un destino de conversión mejor

que S2
T1 es Task<S1> , T2 es Task<S2> y S1 es un destino de conversión mejor que S2
T1 es S1 o S1? S1 , donde es un tipo entero con signo y T2 es o, S2 S2? donde

S2 es un tipo entero sin signo. Concretamente:

S1 es sbyte y S2 es byte , ushort , uint o ulong

S1 es short y S2 es ushort , uint o ulong

S1 es int y S2 es uint , o ulong

S1 es long y S2 es ulong

Sobrecarga en clases genéricas

Mientras que las signaturas declaradas deben ser únicas, es posible que la sustitución de
los argumentos de tipo dé como resultado firmas idénticas. En tales casos, las reglas de
separación de sobrecargas de la resolución de sobrecarga anterior seleccionarán el
miembro más específico.
En los ejemplos siguientes se muestran las sobrecargas válidas y no válidas según esta
regla:

C#

interface I1<T> {...}

interface I2<T> {...}

class G1<U>

int F1(U u); // Overload resolution for G<int>.F1

int F1(int i); // will pick non-generic

void F2(I1<U> a); // Valid overload

void F2(I2<U> a);

class G2<U,V>
{

void F3(U u, V v); // Valid, but overload resolution for

void F3(V v, U u); // G2<int,int>.F3 will fail

void F4(U u, I1<V> v); // Valid, but overload resolution for

void F4(I1<V> v, U u); // G2<I1<int>,int>.F4 will fail

void F5(U u1, I1<V> v2); // Valid overload

void F5(V v1, U u2);

void F6(ref U u); // valid overload

void F6(out V v);

Comprobación en tiempo de compilación de la resolución

dinámica de sobrecarga
Para la mayoría de las operaciones enlazadas dinámicamente, el conjunto de posibles
candidatos para la resolución se desconoce en tiempo de compilación. En algunos
casos, sin embargo, el conjunto de candidatos se conoce en tiempo de compilación:

Llamadas a métodos estáticos con argumentos dinámicos

Llamadas al método de instancia donde el receptor no es una expresión dinámica
Llamadas de indexador en las que el receptor no es una expresión dinámica
Llamadas de constructor con argumentos dinámicos

En estos casos, se realiza una comprobación limitada en tiempo de compilación para

cada candidato a fin de ver si alguna de ellas podría aplicarse en tiempo de ejecución.
Esta comprobación consta de los siguientes pasos:
 Inferencia de tipos parciales: cualquier argumento de tipo que no dependa directa
o indirectamente de un argumento de tipo dynamic se deduce mediante las reglas
de inferencia de tipos. Los argumentos de tipo restantes son desconocidos.
Comprobación parcial de aplicabilidad: la aplicabilidad se comprueba según el
miembro de función aplicable, pero se omiten los parámetros cuyos tipos son
desconocidos.
Si ningún candidato pasa esta prueba, se produce un error en tiempo de
compilación.

Invocación de miembros de función

En esta sección se describe el proceso que tiene lugar en tiempo de ejecución para
invocar un miembro de función determinado. Se supone que un proceso de tiempo de
enlace ya ha determinado el miembro determinado que se va a invocar, posiblemente
aplicando la resolución de sobrecarga a un conjunto de miembros de función
candidatos.

Con el fin de describir el proceso de invocación, los miembros de función se dividen en

dos categorías:

Miembros de función estáticos. Se trata de constructores de instancia, métodos

estáticos, descriptores de acceso de propiedades estáticas y operadores definidos
por el usuario. Los miembros de función estáticos siempre son no virtuales.
Miembros de función de instancia. Son métodos de instancia, descriptores de
acceso de propiedades de instancia y descriptores de acceso de indexador. Los
miembros de la función de instancia son no virtuales o virtuales, y siempre se
invocan en una instancia determinada. La instancia se calcula mediante una
expresión de instancia y se vuelve accesible dentro del miembro de función como
this (este acceso).

El procesamiento en tiempo de ejecución de una invocación de miembro de función

consta de los pasos siguientes, donde M es el miembro de función y, si M es un
miembro de instancia, E es la expresión de instancia:

Si M es un miembro de función estática:

La lista de argumentos se evalúa como se describe en listas de argumentos.
Se invoca a M .

Si M es un miembro de función de instancia declarado en una value_type:

E se evalúa. Si esta evaluación provoca una excepción, no se ejecuta ningún

paso más.
 Si E no está clasificado como una variable, se crea una variable local temporal
de E tipo y el valor de E se asigna a esa variable. E a continuación, se
reclasifica como una referencia a esa variable local temporal. La variable
temporal es accesible como this en M , pero no de otra manera. Por lo tanto,
solo cuando E es una variable verdadera, el autor de la llamada puede observar
los cambios que M realiza en this .
La lista de argumentos se evalúa como se describe en listas de argumentos.
Se invoca a M . La variable a la que hace referencia E se convierte en la variable
a la que hace referencia this .

Si M es un miembro de función de instancia declarado en una reference_type:

E se evalúa. Si esta evaluación provoca una excepción, no se ejecuta ningún

paso más.
La lista de argumentos se evalúa como se describe en listas de argumentos.
Si el tipo de E es un value_type, se realiza una conversión boxing (conversiones
boxing) para convertir E al tipo object y E se considera que es de tipo object
en los pasos siguientes. En este caso, M solo puede ser un miembro de
System.Object .
E Se comprueba que el valor de es válido. Si el valor de E es null ,

System.NullReferenceException se produce una excepción y no se ejecuta

ningún paso más.
Se determina la implementación del miembro de función que se va a invocar:
Si el tipo de tiempo de enlace de E es una interfaz, el miembro de función
que se va a invocar es la implementación de M proporcionada por el tipo en
tiempo de ejecución de la instancia de a la que hace referencia E . Este
miembro de función se determina aplicando las reglas de asignación de
interfaz (asignación de interfaz) para determinar la implementación de M
proporcionada por el tipo en tiempo de ejecución de la instancia a la que
hace referencia E .
De lo contrario, si M es un miembro de función virtual, el miembro de
función que se va a invocar es la implementación de M proporcionada por el
tipo en tiempo de ejecución de la instancia a la que hace referencia E . Este
miembro de función se determina aplicando las reglas para determinar la
implementación más derivada (métodos virtuales) de M con respecto al tipo
en tiempo de ejecución de la instancia a la que hace referencia E .
De lo contrario, M es un miembro de función no virtual y el miembro de
función que se va a invocar es en M sí mismo.
Se invoca la implementación de miembro de función determinada en el paso
anterior. El objeto al que hace referencia E se convierte en el objeto al que hace
 referencia this .

Invocaciones en instancias de conversión boxing

Un miembro de función implementado en un value_type se puede invocar a través de
una instancia de conversión boxing de que value_type en las situaciones siguientes:

Cuando el miembro de función es un override de un método heredado del tipo

object y se invoca a través de una expresión de instancia de tipo object .
Cuando el miembro de función es una implementación de un miembro de función
de interfaz y se invoca a través de una expresión de instancia de un interface_type.
Cuando el miembro de función se invoca a través de un delegado.

En estas situaciones, se considera que la instancia con conversión boxing contiene una
variable del value_type y esta variable se convierte en la variable a la que hace referencia
this la invocación de miembros de función. En concreto, esto significa que cuando se

invoca un miembro de función en una instancia de conversión boxing, es posible que el

miembro de función modifique el valor contenido en la instancia de conversión boxing.

Expresiones primarias
Las expresiones primarias incluyen las formas más sencillas de las expresiones.

antlr

primary_expression

: primary_no_array_creation_expression

| array_creation_expression

primary_no_array_creation_expression

: literal

| interpolated_string_expression

| simple_name

| parenthesized_expression

| member_access

| invocation_expression

| element_access

| this_access

| base_access

| post_increment_expression

| post_decrement_expression

| object_creation_expression

| delegate_creation_expression

| anonymous_object_creation_expression

| typeof_expression

| checked_expression

 | unchecked_expression

| default_value_expression

| nameof_expression

| anonymous_method_expression
| primary_no_array_creation_expression_unsafe

Las expresiones primarias se dividen entre array_creation_expression s y

primary_no_array_creation_expression s. Al tratar la expresión de creación de matrices de
esta manera, en lugar de enumerarla junto con las otras formas de expresión simples,
permite que la gramática no permita el código potencialmente confuso, como

C#

object o = new int[3][1];

que de otro modo se interpretaría como

C#

object o = (new int[3])[1];

Literales
Un primary_expression que consta de un literal (literales) se clasifica como un valor.

Cadenas interpoladas
Un interpolated_string_expression consta de un $ signo seguido de un literal de cadena
normal o textual, en el que los huecos, delimitados por { y } , escriben expresiones y
especificaciones de formato. Una expresión de cadena interpolada es el resultado de
una interpolated_string_literal que se ha dividido en tokens individuales, tal y como se
describe en literales de cadena interpolados.

antlr

interpolated_string_expression

: '$' interpolated_regular_string

| '$' interpolated_verbatim_string

interpolated_regular_string

: interpolated_regular_string_whole

| interpolated_regular_string_start interpolated_regular_string_body
interpolated_regular_string_end

interpolated_regular_string_body

: interpolation (interpolated_regular_string_mid interpolation)*

interpolation

: expression

| expression ',' constant_expression

interpolated_verbatim_string

: interpolated_verbatim_string_whole

| interpolated_verbatim_string_start interpolated_verbatim_string_body
interpolated_verbatim_string_end

interpolated_verbatim_string_body
: interpolation (interpolated_verbatim_string_mid interpolation)+

El constant_expression de una interpolación debe tener una conversión implícita a int .

Un interpolated_string_expression se clasifica como un valor. Si se convierte

inmediatamente en System.IFormattable o System.FormattableString con una
conversión de cadena interpolada implícita (conversiones de cadenas interpoladas
implícitas), la expresión de cadena interpolada tiene ese tipo. De lo contrario, tiene el
tipo string .

Si el tipo de una cadena interpolada es System.IFormattable o

System.FormattableString , el significado es una llamada a
System.Runtime.CompilerServices.FormattableStringFactory.Create . Si el tipo es

string , el significado de la expresión es una llamada a string.Format . En ambos casos,

la lista de argumentos de la llamada consta de un literal de cadena de formato con

marcadores de posición para cada interpolación y un argumento para cada expresión
correspondiente a los marcadores de posición.

El literal de cadena de formato se construye como sigue, donde N es el número de

interpolaciones en el interpolated_string_expression:

Si un interpolated_regular_string_whole o un interpolated_verbatim_string_whole
siguen el $ signo, el literal de cadena de formato es ese token.
De lo contrario, el literal de cadena de formato consta de:
En primer lugar, interpolated_regular_string_start o
interpolated_verbatim_string_start
A continuación, para cada número I de 0 a N-1 :
 La representación decimal de I
Después, si la interpolación correspondiente tiene una constant_expression,
una , (coma) seguida de la representación decimal del valor de la
constant_expression
A continuación, el interpolated_regular_string_mid,
interpolated_regular_string_end, interpolated_verbatim_string_mid o
interpolated_verbatim_string_end inmediatamente después de la
interpolación correspondiente.

Los argumentos subsiguientes son simplemente las expresiones de las interpolaciones (si
existen), en orden.

TODO: ejemplos.

Nombres simples
Un simple_name consta de un identificador, seguido opcionalmente de una lista de
argumentos de tipo:

antlr

simple_name

: identifier type_argument_list?

Una simple_name tiene el formato I o el formato I<A1,...,Ak> , donde I es un

identificador único y <A1,...,Ak> es un type_argument_list opcional. Si no se especifica
ningún type_argument_list , considere la posibilidad K de que sea cero. La simple_name
se evalúa y se clasifica de la manera siguiente:

Si K es cero y el simple_name aparece dentro de un bloque y el espacio de

declaración de variable local del bloque(o el de un bloque de inclusión) contiene
una variable local, un parámetro o una constante con el nombre   I , el
simple_name hace referencia a esa variable local, parámetro o constante y se
clasifica como una variable o valor.

Si K es cero y el simple_name aparece dentro del cuerpo de una declaración de

método genérico y la Declaración incluye un parámetro de tipo con el nombre   I ,
el simple_name hace referencia a ese parámetro de tipo.

De lo contrario, para cada tipo de instancia   T (el tipo de instancia), empezando

por el tipo de instancia de la declaración de tipo de inclusión inmediata y
continuando con el tipo de instancia de cada declaración de clase o estructura
envolvente (si existe):
Si K es cero y la declaración de T incluye un parámetro de tipo con el nombre
  I , el simple_name hace referencia a ese parámetro de tipo.
De lo contrario, si una búsqueda de miembro (búsqueda de miembros) de I in
T con argumentos de K   tipo produce una coincidencia:

Si T es el tipo de instancia de la clase o el tipo de estructura de inclusión

inmediata y la búsqueda identifica uno o más métodos, el resultado es un
grupo de métodos con una expresión de instancia asociada de this . Si se
especificó una lista de argumentos de tipo, se usa para llamar a un método
genérico (invocaciones de método).
De lo contrario, si T es el tipo de instancia de la clase o el tipo de estructura
que se encuentra inmediatamente, si la búsqueda identifica un miembro de
instancia, y si la referencia se produce dentro del cuerpo de un constructor
de instancia, un método de instancia o un descriptor de acceso de instancia,
el resultado es el mismo que un acceso a miembro (acceso a miembros) del
formulario this.I . Esto solo puede ocurrir cuando K es cero.
De lo contrario, el resultado es el mismo que un acceso a miembro (acceso a
miembros) del formulario T.I o T.I<A1,...,Ak> . En este caso, es un error en
tiempo de enlace para que el simple_name haga referencia a un miembro de
instancia.

De lo contrario, para cada espacio de nombres   N , empezando por el espacio de

nombres en el que se produce el simple_name , continuando con cada espacio de
nombres envolvente (si existe) y finalizando con el espacio de nombres global, se
evalúan los pasos siguientes hasta que se encuentra una entidad:
Si K es cero y I es el nombre de un espacio de nombres en   N , entonces:
Si la ubicación donde se produce el simple_name se incluye en una
declaración de espacio de nombres para N y la declaración del espacio de
nombres contiene un extern_alias_directive o using_alias_directive que asocia
el nombre   I con un espacio de nombres o un tipo, el simple_name es
ambiguo y se produce un error en tiempo de compilación.
De lo contrario, el simple_name hace referencia al espacio de nombres
denominado I en N .
De lo contrario, si N contiene un tipo accesible con   I parámetros de tipo y
nombre K   , entonces:
Si K es cero y la ubicación donde se produce el simple_name se incluye en
una declaración de espacio de nombres para N y la declaración del espacio
de nombres contiene un extern_alias_directive o using_alias_directive que
 asocia el nombre   I con un espacio de nombres o un tipo, el simple_name es
ambiguo y se produce un error en tiempo de compilación.
De lo contrario, el namespace_or_type_name hace referencia al tipo
construido con los argumentos de tipo especificados.
De lo contrario, si la ubicación donde se produce el simple_name se incluye en
una declaración de espacio de nombres para   N :
Si K es cero y la declaración del espacio de nombres contiene un
extern_alias_directive o using_alias_directive que asocia el nombre   I con un
espacio de nombres o tipo importado, el simple_name hace referencia a ese
espacio de nombres o tipo.
De lo contrario, si los espacios de nombres y las declaraciones de tipos
importados por using_namespace_directive s y using_static_directive s de la
declaración del espacio de nombres contienen exactamente un tipo accesible
o un miembro estático que no es de extensión   I K   con parámetros de tipo
y nombre, el simple_name hace referencia a ese tipo o miembro construido
con los argumentos de tipo especificados.
De lo contrario, si los espacios de nombres y los tipos importados por la
using_namespace_directive s de la declaración del espacio de nombres
contienen más de un tipo accesible o un miembro estático de método que
no es de extensión con   I parámetros de tipo y nombre K   , el simple_name
es ambiguo y se produce un error.

Tenga en cuenta que todo el paso es exactamente paralelo al paso

correspondiente en el procesamiento de un namespace_or_type_name (espacio de
nombres y nombres de tipo).

De lo contrario, el simple_name es indefinido y se produce un error en tiempo de

compilación.

Expresiones entre paréntesis

Un parenthesized_expression consta de una expresión entre paréntesis.

antlr

parenthesized_expression

: '(' expression ')'

Un parenthesized_expression se evalúa evaluando la expresión entre paréntesis. Si la

expresión entre paréntesis denota un espacio de nombres o un tipo, se produce un error
en tiempo de compilación. De lo contrario, el resultado de la parenthesized_expression
es el resultado de la evaluación de la expresión contenida.

Acceso a miembros
Un member_access consta de un primary_expression, un predefined_type o un
qualified_alias_member, seguido de un token " . ", seguido de un identificador, seguido
opcionalmente de un type_argument_list.

antlr

member_access

: primary_expression '.' identifier type_argument_list?

| predefined_type '.' identifier type_argument_list?

| qualified_alias_member '.' identifier

predefined_type

: 'bool' | 'byte' | 'char' | 'decimal' | 'double' | 'float' | 'int'

| 'long'

| 'object' | 'sbyte' | 'short' | 'string' | 'uint' | 'ulong' |

'ushort'

La qualified_alias_member producción se define en calificadores de alias del espacio de

nombres.

Una member_access tiene el formato E.I o el formato E.I<A1, ..., Ak> , donde E es
una expresión principal, I es un identificador único y <A1, ..., Ak> es un
type_argument_list opcional. Si no se especifica ningún type_argument_list , considere la
posibilidad K de que sea cero.

Un member_access con un primary_expression de tipo dynamic está enlazado

dinámicamente (enlace dinámico). En este caso, el compilador clasifica el acceso a
miembros como un acceso de propiedad de tipo dynamic . A continuación, se aplican
las siguientes reglas para determinar el significado de la member_access en tiempo de
ejecución, utilizando el tipo en tiempo de ejecución en lugar del tipo en tiempo de
compilación del primary_expression. Si esta clasificación en tiempo de ejecución
conduce a un grupo de métodos, el acceso a miembros debe ser el primary_expression
de un invocation_expression.

La member_access se evalúa y se clasifica de la manera siguiente:

Si K es cero y E es un espacio de nombres y E contiene un espacio de nombres

anidado con el nombre   I , el resultado es dicho espacio de nombres.
De lo contrario, si E es un espacio de nombres y E contiene un tipo accesible   I
K   con parámetros de tipo y nombre, el resultado será ese tipo construido con los
argumentos de tipo especificados.
Si E es un predefined_type o un primary_expression clasificado como un tipo, si E
no es un parámetro de tipo y si una búsqueda de miembro (búsqueda de
miembros) de I en E con parámetros de K   tipo produce una coincidencia, E.I
se evalúa y se clasifica de la manera siguiente:
Si I identifica un tipo, el resultado es el tipo construido con los argumentos de
tipo especificados.
Si I identifica uno o más métodos, el resultado es un grupo de métodos sin
expresión de instancia asociada. Si se especificó una lista de argumentos de
tipo, se usa para llamar a un método genérico (invocaciones de método).
Si I identifica una static propiedad, el resultado es un acceso de propiedad
sin expresión de instancia asociada.
Si I identifica un static campo:
Si el campo es readonly y la referencia se produce fuera del constructor
estático de la clase o estructura en la que se declara el campo, el resultado es
un valor, es decir, el valor del campo estático   I de   E .
De lo contrario, el resultado es una variable, es decir, el campo estático   I en
 E .
Si I identifica un static evento:
Si la referencia aparece dentro de la clase o estructura en la que se declara el
evento y el evento se declaró sin event_accessor_declarations (eventos), E.I
se procesa exactamente como si I fuera un campo estático.
De lo contrario, el resultado es un acceso de evento sin expresión de
instancia asociada.
Si I identifica una constante, el resultado es un valor, es decir, el valor de dicha
constante.
Si I identifica un miembro de enumeración, el resultado es un valor, es decir, el
valor de ese miembro de la enumeración.
De lo contrario, E.I es una referencia de miembro no válida y se produce un
error en tiempo de compilación.
Si E es un acceso de propiedad, un acceso de indexador, una variable o un valor,
cuyo tipo es   T , y una búsqueda de miembro (búsqueda de miembros) de I en T
con argumentos de K   tipo produce una coincidencia, E.I se evalúa y se clasifica
de la manera siguiente:
En primer lugar, si E es un acceso de propiedad o indizador, se obtiene el valor
de la propiedad o el acceso del indexador (valores de las expresiones) y E se
reclasifica como un valor.
Si I identifica uno o más métodos, el resultado es un grupo de métodos con
una expresión de instancia asociada de E . Si se especificó una lista de
argumentos de tipo, se usa para llamar a un método genérico (invocaciones de
método).
Si I identifica una propiedad de instancia,
Si E es this , I identifica una propiedad implementada automáticamente
(propiedades implementadas automáticamente) sin un establecedor y la
referencia se produce dentro de un constructor de instancia para un tipo de
clase o struct T , el resultado es una variable, es decir, el campo de respaldo
oculto para la propiedad automática proporcionada por I en la instancia de
T proporcionada por this .

De lo contrario, el resultado es un acceso de propiedad con una expresión de

instancia asociada de   E .
Si T es un class_type e I identifica un campo de instancia de que class_type:
Si el valor de E es null , System.NullReferenceException se produce una
excepción.
De lo contrario, si el campo es readonly y la referencia se produce fuera de
un constructor de instancia de la clase en la que se declara el campo, el
resultado es un valor, es decir, el valor del campo   I en el objeto al que hace
referencia   E .
De lo contrario, el resultado es una variable, es decir, el campo del   I objeto
al que hace referencia   E .
Si T es un struct_type e I identifica un campo de instancia de que struct_type:
Si E es un valor, o si el campo es readonly y la referencia se produce fuera
de un constructor de instancia de la estructura en la que se declara el campo,
el resultado es un valor, es decir, el valor del campo   I en la instancia de la
estructura especificada por   E .
De lo contrario, el resultado es una variable, es decir, el campo   I de la
instancia de struct proporcionado por   E .
Si I identifica un evento de instancia:
Si la referencia se produce dentro de la clase o estructura en la que se
declara el evento y el evento se declaró sin event_accessor_declarations
(eventos), y la referencia no se produce como el lado izquierdo de un += -=
operador OR, E.I se procesa exactamente como si I fuera un campo de
instancia.
De lo contrario, el resultado es un evento de acceso con una expresión de
instancia asociada de   E .
 De lo contrario, se intenta procesar E.I como una invocación de método de
extensión (invocaciones de método de extensión). Si se produce un error, E.I es
una referencia de miembro no válida y se produce un error en tiempo de enlace.

Nombres simples y nombres de tipo idénticos

En un acceso de miembro del formulario E.I , si E es un identificador único, y si el
significado de E como simple_name (nombres simples) es una constante, un campo,
una propiedad, una variable local o un parámetro con el mismo tipo que el significado
de E como type_name (espacio de nombres y nombres de tipo), se permiten ambos
significados posibles E . Los dos significados posibles de E.I nunca son ambiguos, ya
que I debe ser necesariamente miembro del tipo E en ambos casos. En otras palabras,
la regla simplemente permite el acceso a los miembros estáticos y los tipos anidados E
en los que, de lo contrario, se produciría un error en tiempo de compilación. Por
ejemplo:

C#

struct Color

public static readonly Color White = new Color(...);

public static readonly Color Black = new Color(...);

public Color Complement() {...}

class A

public Color Color; // Field Color of type Color

void F() {

Color = Color.Black; // References Color.Black static

member

Color = Color.Complement(); // Invokes Complement() on Color

field

static void G() {

Color c = Color.White; // References Color.White static

member

Ambigüedades de la gramática
Las producciones de simple_name (nombres simples) y member_access (acceso a
miembros) pueden dar lugar a ambigüedades en la gramática de expresiones. Por
ejemplo, la instrucción:

C#

F(G<A,B>(7));

podría interpretarse como una llamada a F con dos argumentos, G < A y B > (7) .
Como alternativa, podría interpretarse como una llamada a F con un argumento, que es
una llamada a un método genérico   G con dos argumentos de tipo y un argumento
normal.

Si se puede analizar una secuencia de tokens (en contexto) como simple_name

(nombres simples), member_access (acceso a miembros) o pointer_member_access
(acceso a miembros de puntero) que finaliza con un type_argument_list (argumentos de
tipo), se examina el token inmediatamente posterior al token de cierre > . Si es uno de

C#

( ) ] } : ; , . ? == != | ^

a continuación, el type_argument_list se conserva como parte del simple_name,

member_access o pointer_member_access y se descarta cualquier otro posible análisis de
la secuencia de tokens. De lo contrario, el type_argument_list no se considera parte de la
simple_name, member_access o pointer_member_access, aunque no haya ningún otro
análisis posible de la secuencia de tokens. Tenga en cuenta que estas reglas no se
aplican al analizar una type_argument_list en un namespace_or_type_name (espacio de
nombres y nombres de tipo). La instrucción

C#

F(G<A,B>(7));

, según esta regla, se interpretará como una llamada a F con un argumento, que es una
llamada a un método genérico G con dos argumentos de tipo y un argumento normal.
Las instrucciones

C#

F(G < A, B > 7);

F(G < A, B >> 7);

cada uno de ellos se interpretará como una llamada a F con dos argumentos. La
instrucción

C#

x = F < A > +y;

se interpretará como un operador menor que, mayor que y unario más, como si se
hubiera escrito la instrucción x = (F < A) > (+y) , en lugar de un simple_name con un
type_argument_list seguido de un operador binario Plus. En la instrucción

C#

x = y is C<T> + z;

los tokens C<T> se interpretan como un namespace_or_type_name con un

type_argument_list.

Expresiones de invocación
Un invocation_expression se utiliza para invocar un método.

antlr

invocation_expression

: primary_expression '(' argument_list? ')'

Un invocation_expression está enlazado dinámicamente (enlace dinámico) si al menos

uno de los siguientes contiene:

El primary_expression tiene el tipo en tiempo de compilación dynamic .

Al menos un argumento del argument_list opcional tiene el tipo en tiempo de
compilación dynamic y el primary_expression no tiene un tipo de delegado.

En este caso, el compilador clasifica el invocation_expression como un valor de tipo

dynamic . A continuación, se aplican las siguientes reglas para determinar el significado

de la invocation_expression en tiempo de ejecución, utilizando el tipo en tiempo de

ejecución en lugar del tipo en tiempo de compilación de los primary_expression y
argumentos que tienen el tipo en tiempo de compilación dynamic . Si el
primary_expression no tiene el tipo en tiempo de compilación dynamic , la invocación
del método sufre una comprobación limitada del tiempo de compilación, como se
describe en comprobación en tiempo de compilación de la resolución de sobrecarga
dinámica.

El primary_expression de una invocation_expression debe ser un grupo de métodos o un

valor de un delegate_type. Si el primary_expression es un grupo de métodos, el
invocation_expression es una invocación de método (invocaciones de método). Si el
primary_expression es un valor de un delegate_type, el invocation_expression es una
invocación de delegado (invocaciones de delegado). Si el primary_expression no es un
grupo de métodos ni un valor de un delegate_type, se produce un error en tiempo de
enlace.

El argument_list opcional (listas de argumentos) proporciona valores o referencias a

variables para los parámetros del método.

El resultado de evaluar una invocation_expression se clasifica como sigue:

Si el invocation_expression invoca un método o un delegado que devuelve void , el

resultado es Nothing. Una expresión que se clasifique como Nothing solo se
permite en el contexto de una statement_expression (instrucciones de expresión) o
como el cuerpo de un lambda_expression (expresiones de función anónima). En
caso contrario, se produce un error en tiempo de enlace.
De lo contrario, el resultado es un valor del tipo devuelto por el método o el
delegado.

Invocaciones de método

En el caso de una invocación de método, el primary_expression de la

invocation_expression debe ser un grupo de métodos. El grupo de métodos identifica el
método que se va a invocar o el conjunto de métodos sobrecargados desde los que se
va a elegir un método específico que se va a invocar. En el último caso, la determinación
del método específico que se va a invocar se basa en el contexto proporcionado por los
tipos de los argumentos en el argument_list.

El procesamiento en tiempo de enlace de una invocación de método con el formato

M(A) , donde M es un grupo de métodos (posiblemente incluido un type_argument_list)
y A es un argument_list opcional, consta de los siguientes pasos:

Se construye el conjunto de métodos candidatos para la invocación del método.

Para cada método F asociado al grupo de métodos M :
Si F no es genérico, F es un candidato cuando:
M no tiene ninguna lista de argumentos de tipo y
F es aplicable con respecto a A (miembro de función aplicable).
 Si F es genérico y M no tiene ninguna lista de argumentos de tipo, F es un
candidato cuando:
La inferencia de tipos (inferencia de tipo) se realiza correctamente,
deduciendo una lista de argumentos de tipo para la llamada y
Una vez que los argumentos de tipo deducido se sustituyen por los
parámetros de tipo de método correspondientes, todos los tipos construidos
en la lista de parámetros de F satisfacen sus restricciones (quecumplencon
las restricciones) y la lista de parámetros de F es aplicable con respecto a A
(miembro defunción aplicable).
Si F es genérico e M incluye una lista de argumentos de tipo, F es un candidato
cuando:
F tiene el mismo número de parámetros de tipo de método que se
proporcionaron en la lista de argumentos de tipo y
Una vez que los argumentos de tipo se sustituyen por los parámetros de tipo
de método correspondientes, todos los tipos construidos en la lista de
parámetros de F satisfacen sus restricciones (quecumplencon las
restricciones) y la lista de parámetros de F es aplicable con respecto a A
(miembro defunción aplicable).
El conjunto de métodos candidatos se reduce para que solo contengan métodos
de los tipos más derivados: para cada método del C.F conjunto, donde C es el
tipo en el que F se declara el método, todos los métodos declarados en un tipo
base de C se quitan del conjunto. Además, si C es un tipo de clase distinto de
object , todos los métodos declarados en un tipo de interfaz se quitan del

conjunto. (Esta última regla solo tiene efecto cuando el grupo de métodos era el
resultado de una búsqueda de miembros en un parámetro de tipo que tiene una
clase base efectiva que no es un objeto y un conjunto de interfaces efectivo no
vacío).
Si el conjunto resultante de métodos candidatos está vacío, se abandona el
procesamiento posterior a lo largo de los pasos siguientes y, en su lugar, se intenta
procesar la invocación como una invocación de método de extensión
(invocaciones de método de extensión). Si se produce un error, no existe ningún
método aplicable y se produce un error en tiempo de enlace.
El mejor método del conjunto de métodos candidatos se identifica mediante las
reglas de resolución de sobrecarga de la resolución de sobrecarga. Si no se puede
identificar un único método mejor, la invocación del método es ambigua y se
produce un error en tiempo de enlace. Al realizar la resolución de sobrecarga, los
parámetros de un método genérico se tienen en cuenta después de sustituir los
argumentos de tipo (proporcionados o deducidos) para los parámetros de tipo de
método correspondientes.
Se realiza la validación final del mejor método elegido:
 El método se valida en el contexto del grupo de métodos: Si el mejor método es
un método estático, el grupo de métodos debe haber sido el resultado de un
simple_name o de un member_access a través de un tipo. Si el mejor método es
un método de instancia, el grupo de métodos debe haber sido el resultado de
un simple_name, un member_access a través de una variable o un valor, o un
base_access. Si ninguno de estos requisitos es true, se produce un error en
tiempo de enlace.
Si el mejor método es un método genérico, los argumentos de tipo
(suministrados o deducidos) se comprueban con las restricciones (quecumplen
las restricciones) declaradas en el método genérico. Si algún argumento de tipo
no satisface las restricciones correspondientes en el parámetro de tipo, se
produce un error en tiempo de enlace.

Una vez que se ha seleccionado y validado un método en tiempo de enlace según los
pasos anteriores, la invocación real en tiempo de ejecución se procesa de acuerdo con
las reglas de invocación de miembros de función descritas en la comprobación en
tiempo de compilación de la resolución dinámica de sobrecarga.

El efecto intuitivo de las reglas de resolución descritas anteriormente es el siguiente:

para encontrar el método determinado invocado por una invocación de método,
empiece con el tipo indicado por la invocación del método y continúe con la cadena de
herencia hasta que se encuentre al menos una declaración de método aplicable,
accesible y que no sea de invalidación. A continuación, realice la inferencia de tipos y la
resolución de sobrecarga en el conjunto de métodos aplicables, accesibles y no
invalidaciones declarados en ese tipo e invoque el método de la forma que se
seleccione. Si no se encuentra ningún método, pruebe en su lugar para procesar la
invocación como una invocación de método de extensión.

Invocaciones de métodos de extensión

En una invocación de método (invocaciones en instancias de conversión boxing) de uno
de los formularios

C#

expr . identifier ( )

expr . identifier ( args )

expr . identifier < typeargs > ( )

expr . identifier < typeargs > ( args )

Si el procesamiento normal de la invocación no encuentra ningún método aplicable, se

realiza un intento de procesar la construcción como una invocación de método de
extensión. Si expr o cualquiera de los argumentos tiene el tipo en tiempo de compilación
dynamic , los métodos de extensión no se aplicarán.

El objetivo es encontrar el mejor type_name C , de modo que pueda tener lugar la

invocación de método estático correspondiente:

C#

C . identifier ( expr )

C . identifier ( expr , args )

C . identifier < typeargs > ( expr )

C . identifier < typeargs > ( expr , args )

Un método de extensión Ci.Mj es válido si:

Ci es una clase no genérica y no anidada

El nombre de Mj es Identifier
Mj es accesible y aplicable cuando se aplica a los argumentos como un método

estático, como se muestra arriba.

Existe una conversión implícita de identidad, de referencia o de conversión boxing
de expr al tipo del primer parámetro de Mj .

La búsqueda de C continúa como sigue:

A partir de la declaración de espacio de nombres envolvente más cercana,

continuando con cada declaración de espacio de nombres envolvente y finalizando
con la unidad de compilación que lo contiene, se realizan sucesivos intentos para
buscar un conjunto candidato de métodos de extensión:
Si el espacio de nombres o la unidad de compilación especificados contiene
directamente declaraciones de tipos no genéricos Ci con métodos de
extensión válidos Mj , el conjunto de estos métodos de extensión es el conjunto
de candidatos.
Si los tipos Ci importados por using_static_declarations y que se declaran
directamente en los espacios de nombres importados por
using_namespace_directive s en el espacio de nombres o la unidad de
compilación especificados directamente contienen métodos de extensión
válidos Mj , el conjunto de estos métodos de extensión es el conjunto de
candidatos.
 Si no se encuentra ningún conjunto candidato en ninguna declaración de espacio
de nombres envolvente o unidad de compilación, se produce un error en tiempo
de compilación.
De lo contrario, se aplica la resolución de sobrecarga al conjunto de candidatos tal
y como se describe en (resolución de sobrecarga). Si no se encuentra ningún
método mejor, se produce un error en tiempo de compilación.
C es el tipo en el que se declara el mejor método como método de extensión.

Con C como destino, la llamada al método se procesa a continuación como una

invocación de método estático (comprobación en tiempo de compilación de la
resolución dinámica de sobrecarga).

Las reglas anteriores implican que los métodos de instancia tienen prioridad sobre los
métodos de extensión, que los métodos de extensión disponibles en las declaraciones
de espacios de nombres internos tienen prioridad sobre los métodos de extensión
disponibles en las declaraciones de espacios de nombres exteriores y que los métodos
de extensión declarados directamente en un espacio de nombres tienen prioridad sobre
los métodos de extensión importados en el mismo espacio de nombres con una
directiva Por ejemplo:

C#

public static class E

public static void F(this object obj, int i) { }

public static void F(this object obj, string s) { }

class A { }

class B

public void F(int i) { }

class C

public void F(object obj) { }

class X

static void Test(A a, B b, C c) {

a.F(1); // E.F(object, int)

a.F("hello"); // E.F(object, string)

b.F(1); // B.F(int)

b.F("hello"); // E.F(object, string)

 c.F(1); // C.F(object)

c.F("hello"); // C.F(object)

En el ejemplo, el B método de tiene prioridad sobre el primer método de extensión y el

C método de tiene prioridad sobre ambos métodos de extensión.

C#

public static class C

public static void F(this int i) { Console.WriteLine("C.F({0})", i); }

public static void G(this int i) { Console.WriteLine("C.G({0})", i); }

public static void H(this int i) { Console.WriteLine("C.H({0})", i); }

namespace N1

public static class D

public static void F(this int i) { Console.WriteLine("D.F({0})", i);

}

public static void G(this int i) { Console.WriteLine("D.G({0})", i);

}

namespace N2

using N1;

public static class E

public static void F(this int i) { Console.WriteLine("E.F({0})", i);

}

class Test

static void Main(string[] args)

1.F();

2.G();

3.H();

El resultado de este ejemplo es:

 Consola

E.F(1)

D.G(2)

C.H(3)

D.G tiene prioridad sobre y C.G E.F tiene prioridad sobre D.F y C.F .

Invocaciones de delegado

En el caso de una invocación de delegado, el primary_expression de la

invocation_expression debe ser un valor de un delegate_type. Además, si se considera
que el delegate_type ser un miembro de función con la misma lista de parámetros que el
delegate_type, el delegate_type debe ser aplicable (miembro de función aplicable) con
respecto al argument_list del invocation_expression.

El procesamiento en tiempo de ejecución de una invocación de delegado con el

formato D(A) , donde D es una primary_expression de un delegate_type y A es un
argument_list opcional, consta de los siguientes pasos:

D se evalúa. Si esta evaluación provoca una excepción, no se ejecuta ningún paso

más.
D Se comprueba que el valor de es válido. Si el valor de D es null ,
System.NullReferenceException se produce una excepción y no se ejecuta ningún

paso más.
De lo contrario, D es una referencia a una instancia de delegado. Las invocaciones
de miembros de función (comprobación en tiempo de compilación de la
resolución dinámica de sobrecarga) se realizan en cada una de las entidades a las
que se puede llamar en la lista de invocaciones del delegado. Para las entidades a
las que se puede llamar que se componen de un método de instancia y de
instancia, la instancia de para la invocación es la instancia contenida en la entidad
a la que se puede

Acceso a elementos
Un element_access consta de un primary_no_array_creation_expression, seguido de un [
token "", seguido de un argument_list, seguido de un ] token "". El argument_list se
compone de uno o más argumentos, separados por comas.

antlr
 element_access

: primary_no_array_creation_expression '[' expression_list ']'

La argument_list de un element_access no puede contener ref out argumentos o.

Un element_access está enlazado dinámicamente (enlace dinámico) si al menos uno de

los siguientes contiene:

El primary_no_array_creation_expression tiene el tipo en tiempo de compilación

dynamic .

Al menos una expresión de la argument_list tiene el tipo en tiempo de compilación

dynamic y el primary_no_array_creation_expression no tiene un tipo de matriz.

En este caso, el compilador clasifica el element_access como un valor de tipo dynamic . A

continuación, se aplican las siguientes reglas para determinar el significado de la
element_access en tiempo de ejecución, utilizando el tipo en tiempo de ejecución en
lugar del tipo en tiempo de compilación de las expresiones
primary_no_array_creation_expression y argument_list que tienen el tipo en tiempo de
compilación dynamic . Si el primary_no_array_creation_expression no tiene el tipo en
tiempo de compilación dynamic , el acceso al elemento sufre una comprobación de
tiempo de compilación limitada, como se describe en comprobación en tiempo de
compilación de la resolución de sobrecarga dinámica.

Si el primary_no_array_creation_expression de una element_access es un valor de un

array_type, el element_access es un acceso a la matriz (acceso a la matriz). De lo
contrario, el primary_no_array_creation_expression debe ser una variable o un valor de
una clase, estructura o tipo de interfaz que tenga uno o más miembros del indexador,
en cuyo caso el element_access es un acceso de indexador (acceso del indexador).

Acceso a matriz

Para un acceso de matriz, el primary_no_array_creation_expression de la element_access

debe ser un valor de un array_type. Además, el argument_list de un acceso de matriz no
puede contener argumentos con nombre. El número de expresiones en el argument_list
debe ser el mismo que el rango de la array_type, y cada expresión debe ser de tipo int ,
uint , long , ulong o debe poder convertirse implícitamente a uno o varios de estos

tipos.

El resultado de evaluar un acceso de matriz es una variable del tipo de elemento de la

matriz, es decir, el elemento de matriz seleccionado por los valores de las expresiones
de la argument_list.

El procesamiento en tiempo de ejecución de un acceso de matriz del formulario P[A] ,

donde P es una primary_no_array_creation_expression de un array_type y A es un
argument_list, consta de los siguientes pasos:

P se evalúa. Si esta evaluación provoca una excepción, no se ejecuta ningún paso

más.
Las expresiones de índice del argument_list se evalúan en orden, de izquierda a
derecha. Después de la evaluación de cada expresión de índice, se realiza una
conversión implícita (conversiones implícitas) en uno de los siguientes tipos: int ,
uint , long , ulong . Se elige el primer tipo de esta lista para el que existe una

conversión implícita. Por ejemplo, si la expresión de índice es de tipo short , se

realiza una conversión implícita a int , ya que es posible realizar conversiones
implícitas de short a int y de short a long . Si la evaluación de una expresión de
índice o de la conversión implícita subsiguiente produce una excepción, no se
evalúan más expresiones de índice y no se ejecuta ningún paso más.
P Se comprueba que el valor de es válido. Si el valor de P es null ,

System.NullReferenceException se produce una excepción y no se ejecuta ningún

paso más.
El valor de cada expresión del argument_list se comprueba con respecto a los
límites reales de cada dimensión de la instancia de la matriz a la que hace
referencia P . Si uno o más valores están fuera del intervalo,
System.IndexOutOfRangeException se produce una excepción y no se ejecuta

ningún paso más.

Se calcula la ubicación del elemento de matriz proporcionado por las expresiones
de índice y esta ubicación se convierte en el resultado del acceso a la matriz.

Acceso a indizador
En el caso de un acceso de indexador, el primary_no_array_creation_expression de la
element_access debe ser una variable o valor de un tipo de clase, struct o interfaz, y este
tipo debe implementar uno o más indexadores aplicables con respecto a la
argument_list del element_access.

El procesamiento en tiempo de enlace de un acceso del indizador del formulario P[A] ,

donde P es una primary_no_array_creation_expression de una clase, un struct o un tipo
de interfaz T , y A es un argument_list, consta de los siguientes pasos:

Se crea el conjunto de indexadores proporcionado por T . El conjunto está

formado por todos los indizadores declarados en T o un tipo base de T que no
 son override declaraciones y son accesibles en el contexto actual (acceso a
miembros).
El conjunto se reduce a los indizadores aplicables y no ocultos por otros
indexadores. Las siguientes reglas se aplican a cada indexador del S.I conjunto,
donde S es el tipo en el que se declara el indexador I :
Si I no es aplicable con respecto a A (miembro de función aplicable), I se
quita del conjunto.
Si I es aplicable con respecto a A (miembro de función aplicable), todos los
indexadores declarados en un tipo base de S se quitan del conjunto.
Si I es aplicable con respecto a A (miembro de función aplicable) y S es un
tipo de clase distinto de object , todos los indexadores declarados en una
interfaz se quitan del conjunto.
Si el conjunto resultante de indizadores candidatos está vacío, no existe ningún
indexador aplicable y se produce un error en tiempo de enlace.
El mejor indexador del conjunto de indizadores candidatos se identifica mediante
las reglas de resolución de sobrecarga de la resolución de sobrecarga. Si no se
puede identificar un único indexador mejor, el acceso del indexador es ambiguo y
se produce un error en tiempo de enlace.
Las expresiones de índice del argument_list se evalúan en orden, de izquierda a
derecha. El resultado de procesar el acceso del indexador es una expresión
clasificada como un acceso de indexador. La expresión de acceso del indizador
hace referencia al indizador determinado en el paso anterior y tiene una expresión
de instancia asociada de P y una lista de argumentos asociada de A .

En función del contexto en el que se utiliza, un acceso de indexador provoca la

invocación del descriptor de acceso get o del descriptor de acceso set del indexador. Si el
acceso del indizador es el destino de una asignación, se invoca al descriptor de acceso
set para asignar un nuevo valor (asignación simple). En todos los demás casos, el
descriptor de acceso get se invoca para obtener el valor actual (valores de las
expresiones).

Este acceso
Un this_access consta de la palabra reservada this .

antlr

this_access

: 'this'

Solo se permite un this_access en el bloque de un constructor de instancia, un método

de instancia o un descriptor de acceso de instancia. Tiene uno de los significados
siguientes:

Cuando this se utiliza en una primary_expression dentro de un constructor de

instancia de una clase, se clasifica como un valor. El tipo del valor es el tipo de
instancia (el tipo de instancia) de la clase en la que se produce el uso y el valor es
una referencia al objeto que se está construyendo.
Cuando this se utiliza en una primary_expression dentro de un método de
instancia o un descriptor de acceso de instancia de una clase, se clasifica como un
valor. El tipo del valor es el tipo de instancia (el tipo de instancia) de la clase en la
que se produce el uso y el valor es una referencia al objeto para el que se invocó el
método o el descriptor de acceso.
Cuando this se utiliza en una primary_expression dentro de un constructor de
instancia de un struct, se clasifica como una variable. El tipo de la variable es el tipo
de instancia (el tipo de instancia) del struct en el que se produce el uso y la
variable representa el struct que se está construyendo. La this variable de un
constructor de instancia de una estructura se comporta exactamente igual que un
out parámetro del tipo de estructura; en concreto, esto significa que la variable

debe estar asignada definitivamente en todas las rutas de acceso de ejecución del
constructor de instancia.
Cuando this se utiliza en una primary_expression dentro de un método de
instancia o un descriptor de acceso de instancia de un struct, se clasifica como una
variable. El tipo de la variable es el tipo de instancia (el tipo de instancia) del struct
en el que se produce el uso.
Si el método o el descriptor de acceso no es un iterador (iteradores), la this
variable representa la estructura para la que se invocó el método o descriptor
de acceso, y se comporta exactamente igual que un ref parámetro del tipo de
estructura.
Si el método o descriptor de acceso es un iterador, la this variable representa
una copia del struct para el que se invocó el método o descriptor de acceso, y
se comporta exactamente igual que un parámetro de valor del tipo de
estructura.

El uso de this en una primary_expression en un contexto distinto de los enumerados

anteriormente es un error en tiempo de compilación. En concreto, no es posible hacer
referencia a this en un método estático, un descriptor de acceso de propiedad estática
o en una variable_initializer de una declaración de campo.

Acceso base
Un base_access consta de la palabra reservada base seguida de un . token "" y un
identificador o un argument_list entre corchetes:

antlr

base_access

: 'base' '.' identifier

| 'base' '[' expression_list ']'

Un base_access se utiliza para tener acceso a los miembros de clase base que están
ocultos por miembros con el mismo nombre en la clase o el struct actual. Solo se
permite un base_access en el bloque de un constructor de instancia, un método de
instancia o un descriptor de acceso de instancia. Cuando base.I se produce en una
clase o struct, I debe indicar un miembro de la clase base de esa clase o estructura. Del
mismo modo, cuando base[E] se produce en una clase, debe existir un indexador
aplicable en la clase base.

En tiempo de enlace, base_access expresiones del formulario base.I y base[E] se

evalúan exactamente como si se hubieran escrito ((B)this).I y ((B)this)[E] , donde
B es la clase base de la clase o estructura en la que se produce la construcción. Así,

base.I y base[E] corresponden a this.I y this[E] , salvo this que se ve como una

instancia de la clase base.

Cuando un base_access hace referencia a un miembro de función virtual (un método,

una propiedad o un indizador), se cambia la determinación del miembro de función que
se va a invocar en tiempo de ejecución (comprobación en tiempo de compilación de la
resolución dinámica de sobrecarga). El miembro de función que se invoca se determina
mediante la búsqueda de la implementación más derivada (métodos virtuales) del
miembro de función con respecto a B (en lugar de con respecto al tipo en tiempo de
ejecución de this , como sería habitual en un acceso no base). Por lo tanto, dentro
override de un virtual miembro de función, se puede usar un base_access para

invocar la implementación heredada del miembro de función. Si el miembro de función

al que hace referencia una base_access es abstracto, se produce un error en tiempo de
enlace.

Operadores de incremento y decremento posfijos

antlr

post_increment_expression

: primary_expression '++'

post_decrement_expression

: primary_expression '--'

El operando de una operación de incremento o decremento postfijo debe ser una

expresión clasificada como una variable, un acceso de propiedad o un acceso de
indexador. El resultado de la operación es un valor del mismo tipo que el operando.

Si el primary_expression tiene el tipo en tiempo de compilación dynamic , el operador

está enlazado dinámicamente (enlace dinámico), el post_increment_expression o
post_decrement_expression tiene el tipo en tiempo de compilación dynamic y se aplican
las siguientes reglas en tiempo de ejecución utilizando el tipo en tiempo de ejecución
del primary_expression.

Si el operando de una operación de incremento o decremento postfijo es una

propiedad o un indexador, la propiedad o el indexador deben tener un get set
descriptor de acceso y. Si no es así, se produce un error en tiempo de enlace.

La resolución de sobrecargas de operador unario (resolución de sobrecarga de

operadores unarios) se aplica para seleccionar una implementación de operador
específica. ++ Existen operadores y predefinidos -- para los tipos siguientes: sbyte ,
byte , short , ushort , int , uint ,,, long ulong char , float , double , decimal y

cualquier tipo de enumeración. Los operadores predefinidos ++ devuelven el valor

generado agregando 1 al operando y los operadores predefinidos -- devuelven el valor
generado restando 1 del operando. En un checked contexto, si el resultado de esta
suma o resta está fuera del intervalo del tipo de resultado y el tipo de resultado es un
tipo entero o de enumeración, System.OverflowException se produce una excepción.

El procesamiento en tiempo de ejecución de una operación de incremento o

decremento postfijo del formulario x++ o x-- consta de los siguientes pasos:

Si x se clasifica como una variable:

x se evalúa para generar la variable.
El valor de x se guarda.
El operador seleccionado se invoca con el valor guardado de x como
argumento.
El valor devuelto por el operador se almacena en la ubicación especificada por
la evaluación de x .
El valor guardado de x se convierte en el resultado de la operación.
Si x se clasifica como un acceso de propiedad o indizador:
 La expresión de instancia (si x no es static ) y la lista de argumentos (si x es
un acceso de indexador) asociadas a x se evalúan, y los resultados se usan en
las get set llamadas a descriptores de acceso y posteriores.
get Se invoca el descriptor de acceso de x y se guarda el valor devuelto.
El operador seleccionado se invoca con el valor guardado de x como
argumento.
El set descriptor de acceso de x se invoca con el valor devuelto por el
operador como su value argumento.
El valor guardado de x se convierte en el resultado de la operación.

Los ++ -- operadores y también admiten la notación de prefijo (operadores de

incremento y decremento de prefijo). Normalmente, el resultado de x++ o x-- es el
valor de x antes de la operación, mientras que el resultado de ++x o --x es el valor de
x después de la operación. En cualquier caso, x tiene el mismo valor después de la

operación.

Una operator ++ implementación de o operator -- se puede invocar mediante la

notación de prefijo o postfijo. No es posible tener implementaciones de operador
independientes para las dos notaciones.

Operador new
El new operador se usa para crear nuevas instancias de tipos.

Hay tres formas de new expresiones:

Las expresiones de creación de objetos se utilizan para crear nuevas instancias de

tipos de clase y tipos de valor.
Las expresiones de creación de matrices se utilizan para crear nuevas instancias de
tipos de matriz.
Las expresiones de creación de delegados se utilizan para crear nuevas instancias
de tipos de delegado.

El new operador implica la creación de una instancia de un tipo, pero no implica

necesariamente la asignación dinámica de memoria. En concreto, las instancias de tipos
de valor no requieren memoria adicional más allá de las variables en las que residen, y
no se produce ninguna asignación dinámica cuando new se usa para crear instancias de
tipos de valor.

Expresiones de creación de objetos

Un object_creation_expression se usa para crear una nueva instancia de un class_type o
un value_type.

antlr

object_creation_expression

: 'new' type '(' argument_list? ')' object_or_collection_initializer?

| 'new' type object_or_collection_initializer

object_or_collection_initializer

: object_initializer

| collection_initializer

El tipo de un object_creation_expression debe ser un class_type, un value_type o un

type_parameter. El tipo no puede ser un abstract class_type.

Solo se permite el argument_list opcional (listas de argumentos) si el tipo es un

class_type o un struct_type.

Una expresión de creación de objeto puede omitir la lista de argumentos del

constructor y los paréntesis de cierre especificados que incluye un inicializador de
objeto o un inicializador de colección. Omitir la lista de argumentos del constructor y los
paréntesis de inclusión equivale a especificar una lista de argumentos vacía.

El procesamiento de una expresión de creación de objetos que incluye un inicializador

de objeto o un inicializador de colección consiste en procesar primero el constructor de
instancia y después procesar las inicializaciones de miembro o elemento especificadas
por el inicializador de objeto (inicializadores de objeto) o el inicializador de colección
(inicializadores de colección).

Si alguno de los argumentos del argument_list opcional tiene el tipo en tiempo de

compilación dynamic , el object_creation_expression está enlazado dinámicamente
(enlace dinámico) y se aplican las siguientes reglas en tiempo de ejecución utilizando el
tipo en tiempo de ejecución de los argumentos de la argument_list que tienen el tipo de
tiempo de compilación dynamic . Sin embargo, la creación de objetos sufre una
comprobación de tiempo de compilación limitada, como se describe en comprobación
en tiempo de compilación de la resolución dinámica de sobrecarga.

El procesamiento en tiempo de enlace de un object_creation_expression del formulario

new T(A) , donde T es un class_type o un value_type y A es un argument_list opcional,
consta de los siguientes pasos:

Si T es un value_type y A no está presente:

 El object_creation_expression es una invocación de constructor predeterminada.
El resultado de la object_creation_expression es un valor de tipo T , es decir, el
valor predeterminado para T tal y como se define en el tipo System. ValueType.
De lo contrario, si T es un type_parameter y A no está presente:
Si no se ha especificado ninguna restricción de tipo de valor o restricción de
constructor (restricciones de parámetro de tipo) para T , se produce un error en
tiempo de enlace.
El resultado de la object_creation_expression es un valor del tipo en tiempo de
ejecución al que se ha enlazado el parámetro de tipo, es decir, el resultado de
invocar el constructor predeterminado de ese tipo. El tipo en tiempo de
ejecución puede ser un tipo de referencia o un tipo de valor.
De lo contrario, si T es un class_type o un struct_type:
Si T es un abstract class_type, se produce un error en tiempo de compilación.
El constructor de instancia que se va a invocar se determina mediante las reglas
de resolución de sobrecarga de la resolución de sobrecarga. El conjunto de
constructores de instancias candidatas se compone de todos los constructores
de instancia accesibles declarados en T que se aplican con respecto a A
(miembro de función aplicable). Si el conjunto de constructores de instancia
candidata está vacío, o si no se puede identificar un único constructor de
instancia mejor, se produce un error en tiempo de enlace.
El resultado de la object_creation_expression es un valor de tipo T , es decir, el
valor generado al invocar el constructor de instancia determinado en el paso
anterior.
De lo contrario, el object_creation_expression no es válido y se produce un error en
tiempo de enlace.

Aunque el object_creation_expression esté enlazado dinámicamente, el tipo en tiempo de

compilación sigue siendo T .

El procesamiento en tiempo de ejecución de un object_creation_expression del

formulario new T(A) , donde T es class_type o un struct_type y A es un argument_list
opcional, consta de los siguientes pasos:

Si T es un class_type:
Se asigna una nueva instancia de la clase T . Si no hay suficiente memoria
disponible para asignar la nueva instancia, System.OutOfMemoryException se
produce una excepción y no se ejecuta ningún paso más.
Todos los campos de la nueva instancia se inicializan con sus valores
predeterminados (valores predeterminados).
El constructor de instancia se invoca de acuerdo con las reglas de invocación de
miembros de función (comprobación en tiempo de compilación de la resolución
 dinámica de sobrecarga). Se pasa automáticamente una referencia a la instancia
recién asignada al constructor de instancia y se puede tener acceso a la
instancia desde dentro de ese constructor como this .
Si T es un struct_type:
Una instancia de tipo T se crea asignando una variable local temporal. Puesto
que se requiere un constructor de instancia de un struct_type para asignar
definitivamente un valor a cada campo de la instancia que se va a crear, no es
necesario inicializar la variable temporal.
El constructor de instancia se invoca de acuerdo con las reglas de invocación de
miembros de función (comprobación en tiempo de compilación de la resolución
dinámica de sobrecarga). Se pasa automáticamente una referencia a la instancia
recién asignada al constructor de instancia y se puede tener acceso a la
instancia desde dentro de ese constructor como this .

Inicializadores de objeto
Un inicializador de objeto especifica valores para cero o más campos, propiedades o
elementos indizados de un objeto.

antlr

object_initializer

: '{' member_initializer_list? '}'

| '{' member_initializer_list ',' '}'

member_initializer_list

: member_initializer (',' member_initializer)*

member_initializer

: initializer_target '=' initializer_value

initializer_target

: identifier

| '[' argument_list ']'

initializer_value

: expression

| object_or_collection_initializer

Un inicializador de objeto consta de una secuencia de inicializadores de miembro,

delimitada por { } tokens y y separados por comas. Cada member_initializer designa
un destino para la inicialización. Un identificador debe asignar un nombre a un campo o
propiedad accesible del objeto que se va a inicializar, mientras que una argument_list
entre corchetes debe especificar los argumentos de un indizador accesible en el objeto
que se va a inicializar. Es un error que un inicializador de objeto incluya más de un
inicializador de miembro para el mismo campo o propiedad.

Cada initializer_target va seguido de un signo igual y una expresión, un inicializador de

objeto o un inicializador de colección. No es posible que las expresiones del inicializador
de objeto hagan referencia al objeto recién creado que se está inicializando.

Inicializador de miembro que especifica una expresión después de que el signo igual se
procese de la misma manera que una asignación (asignación simple) al destino.

Inicializador de miembro que especifica un inicializador de objeto después de que el

signo igual sea un inicializador de objeto anidado, es decir, una inicialización de un
objeto incrustado. En lugar de asignar un nuevo valor al campo o propiedad, las
asignaciones en el inicializador de objeto anidado se tratan como asignaciones a los
miembros del campo o de la propiedad. Los inicializadores de objeto anidados no se
pueden aplicar a las propiedades con un tipo de valor o a los campos de solo lectura
con un tipo de valor.

Inicializador de miembro que especifica un inicializador de colección después de que el

signo igual sea una inicialización de una colección incrustada. En lugar de asignar una
nueva colección al campo de destino, propiedad o indizador, los elementos
proporcionados en el inicializador se agregan a la colección a la que hace referencia el
destino. El destino debe ser de un tipo de colección que satisfaga los requisitos
especificados en los inicializadores de colección.

Los argumentos de un inicializador de índice siempre se evaluarán exactamente una vez.

Por lo tanto, aunque los argumentos acaben nunca en usarse (por ejemplo, debido a un
inicializador anidado vacío), se evaluarán por sus efectos secundarios.

La clase siguiente representa un punto con dos coordenadas:

C#

public class Point

int x, y;

public int X { get { return x; } set { x = value; } }

public int Y { get { return y; } set { y = value; } }

Point Se puede crear e inicializar una instancia de de la siguiente manera:

 C#

Point a = new Point { X = 0, Y = 1 };

que tiene el mismo efecto que

C#

Point __a = new Point();

__a.X = 0;

__a.Y = 1;

Point a = __a;

donde __a es una variable temporal invisible e inaccesible en caso contrario. La clase
siguiente representa un rectángulo creado a partir de dos puntos:

C#

public class Rectangle

Point p1, p2;

public Point P1 { get { return p1; } set { p1 = value; } }

public Point P2 { get { return p2; } set { p2 = value; } }

Rectangle Se puede crear e inicializar una instancia de de la siguiente manera:

C#

Rectangle r = new Rectangle {

P1 = new Point { X = 0, Y = 1 },

P2 = new Point { X = 2, Y = 3 }

};

que tiene el mismo efecto que

C#

Rectangle __r = new Rectangle();

Point __p1 = new Point();

__p1.X = 0;

__p1.Y = 1;

__r.P1 = __p1;

Point __p2 = new Point();

__p2.X = 2;

__p2.Y = 3;

 __r.P2 = __p2;

Rectangle r = __r;

donde __r __p1 y __p2 son variables temporales que, de lo contrario, son invisibles e
inaccesibles.

Rectangle El constructor de si asigna las dos instancias incrustadas Point

C#

public class Rectangle

Point p1 = new Point();

Point p2 = new Point();

public Point P1 { get { return p1; } }

public Point P2 { get { return p2; } }

la construcción siguiente se puede utilizar para inicializar las Point instancias

incrustadas en lugar de asignar nuevas instancias:

C#

Rectangle r = new Rectangle {

P1 = { X = 0, Y = 1 },

P2 = { X = 2, Y = 3 }

};

que tiene el mismo efecto que

C#

Rectangle __r = new Rectangle();

__r.P1.X = 0;

__r.P1.Y = 1;

__r.P2.X = 2;

__r.P2.Y = 3;

Rectangle r = __r;

Dada una definición adecuada de C, el ejemplo siguiente:

C#

var c = new C {

x = true,

y = { a = "Hello" },

z = { 1, 2, 3 },

 ["x"] = 5,

[0,0] = { "a", "b" },

[1,2] = {}

};

es equivalente a esta serie de asignaciones:

C#

C __c = new C();

__c.x = true;

__c.y.a = "Hello";

__c.z.Add(1);

__c.z.Add(2);

__c.z.Add(3);

string __i1 = "x";

__c[__i1] = 5;

int __i2 = 0, __i3 = 0;

__c[__i2,__i3].Add("a");

__c[__i2,__i3].Add("b");

int __i4 = 1, __i5 = 2;

var c = __c;

donde __c , etc., se generan variables que son invisibles e inaccesibles para el código
fuente. Tenga en cuenta que los argumentos de [0,0] se evalúan solo una vez, y los
argumentos de [1,2] se evalúan una vez, aunque nunca se utilicen.

Inicializadores de colección

Un inicializador de colección especifica los elementos de una colección.

antlr

collection_initializer

: '{' element_initializer_list '}'

| '{' element_initializer_list ',' '}'

element_initializer_list

: element_initializer (',' element_initializer)*

element_initializer

: non_assignment_expression

| '{' expression_list '}'

expression_list

 : expression (',' expression)*

Un inicializador de colección consta de una secuencia de inicializadores de elemento,

encerrados por { } tokens y y separados por comas. Cada inicializador de elemento
especifica un elemento que se va a agregar al objeto de colección que se está
inicializando y consta de una lista de expresiones delimitadas por { } tokens y y
separadas por comas. Un inicializador de elemento de una sola expresión se puede
escribir sin llaves, pero no puede ser una expresión de asignación para evitar la
ambigüedad con los inicializadores de miembro. La non_assignment_expression
Production se define en Expression.

A continuación se muestra un ejemplo de una expresión de creación de objeto que

incluye un inicializador de colección:

C#

List<int> digits = new List<int> { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };

El objeto de colección al que se aplica un inicializador de colección debe ser de un tipo

que implemente System.Collections.IEnumerable o se produzca un error en tiempo de
compilación. Para cada elemento especificado en orden, el inicializador de colección
invoca un Add método en el objeto de destino con la lista de expresiones del
inicializador de elemento como lista de argumentos, aplicando la búsqueda de
miembros normal y la resolución de sobrecarga para cada invocación. Por lo tanto, el
objeto de colección debe tener una instancia o un método de extensión aplicable con el
nombre Add de cada inicializador de elemento.

La clase siguiente representa un contacto con un nombre y una lista de números de

teléfono:

C#

public class Contact

string name;

List<string> phoneNumbers = new List<string>();

public string Name { get { return name; } set { name = value; } }

public List<string> PhoneNumbers { get { return phoneNumbers; } }

List<Contact> Se puede crear e inicializar como se indica a continuación:

 C#

var contacts = new List<Contact> {

new Contact {

Name = "Chris Smith",

PhoneNumbers = { "206-555-0101", "425-882-8080" }

},

new Contact {

Name = "Bob Harris",

PhoneNumbers = { "650-555-0199" }

};

que tiene el mismo efecto que

C#

var __clist = new List<Contact>();

Contact __c1 = new Contact();

__c1.Name = "Chris Smith";

__c1.PhoneNumbers.Add("206-555-0101");

__c1.PhoneNumbers.Add("425-882-8080");

__clist.Add(__c1);

Contact __c2 = new Contact();

__c2.Name = "Bob Harris";

__c2.PhoneNumbers.Add("650-555-0199");

__clist.Add(__c2);

var contacts = __clist;

donde __clist __c1 y __c2 son variables temporales que, de lo contrario, son invisibles
e inaccesibles.

Expresiones de creación de matrices

Un array_creation_expression se usa para crear una nueva instancia de un array_type.

antlr

array_creation_expression

: 'new' non_array_type '[' expression_list ']' rank_specifier*

array_initializer?

| 'new' array_type array_initializer

| 'new' rank_specifier array_initializer

Una expresión de creación de matriz del primer formulario asigna una instancia de
matriz del tipo resultante de la eliminación de cada una de las expresiones individuales
de la lista de expresiones. Por ejemplo, la expresión de creación de matriz new
int[10,20] genera una instancia de matriz de tipo int[,] y la expresión new int[10][,]
de creación de matriz genera una matriz de tipo int[][,] . Cada expresión de la lista de
expresiones debe ser de tipo int , uint , long o ulong , o bien se puede convertir
implícitamente a uno o varios de estos tipos. El valor de cada expresión determina la
longitud de la dimensión correspondiente en la instancia de matriz recién asignada.
Dado que la longitud de una dimensión de matriz no debe ser negativa, es un error en
tiempo de compilación tener un constant_expression con un valor negativo en la lista de
expresiones.

Excepto en un contexto no seguro (contextos no seguros), no se especifica el diseño de

las matrices.

Si una expresión de creación de matriz del primer formulario incluye un inicializador de

matriz, cada expresión de la lista de expresiones debe ser una constante y las longitudes
de rango y dimensión especificadas por la lista de expresiones deben coincidir con las
del inicializador de matriz.

En una expresión de creación de matriz del segundo o tercer formulario, el rango del
tipo de matriz o especificador de rango especificado debe coincidir con el del
inicializador de matriz. Las longitudes de las dimensiones individuales se deducen del
número de elementos de cada uno de los niveles de anidamiento correspondientes del
inicializador de matriz. Por lo tanto, la expresión

C#

new int[,] {{0, 1}, {2, 3}, {4, 5}}

corresponde exactamente a

C#

new int[3, 2] {{0, 1}, {2, 3}, {4, 5}}

Se hace referencia a una expresión de creación de matriz del tercer formulario como
una expresión de creación de matriz con tipo * implícita _. Es similar a la segunda
forma, salvo que el tipo de elemento de la matriz no se proporciona explícitamente,
pero se determina como el mejor tipo común (encontrar el mejor tipo común de un
conjunto de expresiones) del conjunto de expresiones en el inicializador de matriz. En el
caso de una matriz multidimensional, es decir, una en la que el _rank_specifier *
contiene al menos una coma, este conjunto incluye todas las expresiones que se
encuentran en los array_initializer anidados.
Los inicializadores de matriz se describen con más detalle en inicializadores de matriz.

El resultado de evaluar una expresión de creación de matriz se clasifica como un valor,

es decir, una referencia a la instancia de la matriz recién asignada. El procesamiento en
tiempo de ejecución de una expresión de creación de matriz consta de los siguientes
pasos:

Las expresiones de longitud de dimensión del expression_list se evalúan en orden,

de izquierda a derecha. Después de la evaluación de cada expresión, se realiza una
conversión implícita (conversiones implícitas) en uno de los siguientes tipos int :
uint ,, long , ulong . Se elige el primer tipo de esta lista para el que existe una
conversión implícita. Si la evaluación de una expresión o la conversión implícita
subsiguiente produce una excepción, no se evalúan más expresiones y no se
ejecuta ningún otro paso.
Los valores calculados de las longitudes de dimensión se validan como se indica a
continuación. Si uno o varios de los valores son menores que cero,
System.OverflowException se produce una excepción y no se ejecuta ningún otro

paso.
Se asigna una instancia de matriz con las longitudes de dimensión dadas. Si no hay
suficiente memoria disponible para asignar la nueva instancia,
System.OutOfMemoryException se produce una excepción y no se ejecuta ningún
paso más.
Todos los elementos de la nueva instancia de matriz se inicializan con sus valores
predeterminados (valores predeterminados).
Si la expresión de creación de matriz contiene un inicializador de matriz, cada
expresión del inicializador de matriz se evalúa y se asigna a su elemento de matriz
correspondiente. Las evaluaciones y las asignaciones se realizan en el orden en el
que se escriben las expresiones en el inicializador de matriz; es decir, los elementos
se inicializan en el orden de índice creciente, con la dimensión situada más a la
derecha aumentando primero. Si la evaluación de una expresión determinada o la
asignación subsiguiente al elemento de matriz correspondiente produce una
excepción, no se inicializa ningún otro elemento (y los demás elementos tendrán
sus valores predeterminados).

Una expresión de creación de matriz permite la creación de instancias de una matriz con
elementos de un tipo de matriz, pero los elementos de dicha matriz se deben inicializar
manualmente. Por ejemplo, la instrucción

C#

int[][] a = new int[100][];

crea una matriz unidimensional con 100 elementos de tipo int[] . El valor inicial de
cada elemento es null . No es posible que la misma expresión de creación de matriz
cree también instancias de las submatrices y la instrucción

C#

int[][] a = new int[100][5]; // Error

produce un error en tiempo de compilación. En su lugar, la creación de instancias de las

submatrices debe realizarse manualmente, como en

C#

int[][] a = new int[100][];

for (int i = 0; i < 100; i++) a[i] = new int[5];

Cuando una matriz de matrices tiene una forma "rectangular", es decir, cuando las
submatrices tienen la misma longitud, es más eficaz usar una matriz multidimensional.
En el ejemplo anterior, la creación de instancias de la matriz de matrices crea 101
objetos, una matriz externa y submatrices de 100. En cambio,

C#

int[,] = new int[100, 5];

crea un solo objeto, una matriz bidimensional y realiza la asignación en una única
instrucción.

A continuación se muestran ejemplos de expresiones de creación de matrices con tipo

implícito:

C#

var a = new[] { 1, 10, 100, 1000 }; // int[]

var b = new[] { 1, 1.5, 2, 2.5 }; // double[]

var c = new[,] { { "hello", null }, { "world", "!" } }; // string[,]

var d = new[] { 1, "one", 2, "two" }; // Error

La última expresión genera un error en tiempo de compilación porque ni int ni string

se pueden convertir implícitamente al otro, por lo que no hay ningún tipo común más
adecuado. En este caso, se debe usar una expresión de creación de matriz con tipo
explícito, por ejemplo, especificando el tipo object[] . Como alternativa, uno de los
elementos se puede convertir a un tipo base común, que luego se convertiría en el tipo
de elemento deducido.

Las expresiones de creación de matrices con tipo implícito se pueden combinar con
inicializadores de objeto anónimos (expresiones de creación de objetos anónimos) para
crear estructuras de datos con tipos anónimos. Por ejemplo:

C#

var contacts = new[] {

new {

Name = "Chris Smith",

PhoneNumbers = new[] { "206-555-0101", "425-882-8080" }

},

new {

Name = "Bob Harris",

PhoneNumbers = new[] { "650-555-0199" }

};

Expresiones de creación de delegados

Un delegate_creation_expression se usa para crear una nueva instancia de un

delegate_type.

antlr

delegate_creation_expression

: 'new' delegate_type '(' expression ')'

El argumento de una expresión de creación de delegado debe ser un grupo de

métodos, una función anónima o un valor del tipo en tiempo de compilación dynamic o
un delegate_type. Si el argumento es un grupo de métodos, identifica el método y, para
un método de instancia, el objeto para el que se va a crear un delegado. Si el
argumento es una función anónima, define directamente los parámetros y el cuerpo del
método del destino del delegado. Si el argumento es un valor, identifica una instancia
de delegado de la que se va a crear una copia.

Si la expresión tiene el tipo en tiempo de compilación dynamic , el

delegate_creation_expression está enlazado dinámicamente (enlace dinámico) y las
reglas siguientes se aplican en tiempo de ejecución mediante el tipo en tiempo de
ejecución de la expresión. De lo contrario, las reglas se aplican en tiempo de
compilación.

El procesamiento en tiempo de enlace de un delegate_creation_expression del formulario

new D(E) , donde D es una delegate_type y E es una expresión, consta de los siguientes
pasos:

Si E es un grupo de métodos, la expresión de creación de delegado se procesa de

la misma manera que una conversión de grupo de métodos (conversiones de
grupo de métodos) de E a D .
Si E es una función anónima, la expresión de creación de delegado se procesa de
la misma manera que una conversión de función anónima (conversiones de
funciones anónimas) de E a D .
Si E es un valor, E debe ser compatible (declaraciones de delegado) con y D el
resultado es una referencia a un delegado recién creado de tipo D que hace
referencia a la misma lista de invocación que E . Si E no es compatible con D , se
produce un error en tiempo de compilación.

El procesamiento en tiempo de ejecución de un delegate_creation_expression del

formulario new D(E) , donde D es una delegate_type y E es una expresión, consta de los
siguientes pasos:

Si E es un grupo de métodos, la expresión de creación de delegado se evalúa

como una conversión de grupo de métodos (conversiones de grupo de métodos)
de E a D .
Si E es una función anónima, la creación del delegado se evalúa como una
conversión de función anónima de E a D (conversiones de función anónimas).
Si E es un valor de un delegate_type:
E se evalúa. Si esta evaluación provoca una excepción, no se ejecuta ningún

paso más.
Si el valor de E es null , System.NullReferenceException se produce una
excepción y no se ejecuta ningún paso más.
Se asigna una nueva instancia del tipo de delegado D . Si no hay suficiente
memoria disponible para asignar la nueva instancia,
System.OutOfMemoryException se produce una excepción y no se ejecuta ningún
paso más.
La nueva instancia de delegado se inicializa con la misma lista de invocación
que la instancia de delegado proporcionada por E .

La lista de invocaciones de un delegado se determina cuando se crea una instancia del

delegado y permanece constante durante toda la duración del delegado. En otras
palabras, no es posible cambiar las entidades a las que se puede llamar de destino de
un delegado una vez que se ha creado. Cuando se combinan dos delegados o uno se
quita de otro (declaraciones de delegado), se genera un nuevo delegado. no se ha
cambiado el contenido de ningún delegado existente.

No es posible crear un delegado que haga referencia a una propiedad, un indexador, un

operador definido por el usuario, un constructor de instancia, un destructor o un
constructor estático.

Como se describió anteriormente, cuando se crea un delegado a partir de un grupo de

métodos, la lista de parámetros formales y el tipo de valor devuelto del delegado
determinan cuál de los métodos sobrecargados se deben seleccionar. En el ejemplo

C#

delegate double DoubleFunc(double x);

class A

DoubleFunc f = new DoubleFunc(Square);

static float Square(float x) {

return x * x;

static double Square(double x) {

return x * x;

el A.f campo se inicializa con un delegado que hace referencia al segundo Square
método porque ese método coincide exactamente con la lista de parámetros formales y
el tipo de valor devuelto de DoubleFunc . Si el segundo Square método no estuviera
presente, se habría producido un error en tiempo de compilación.

Expresiones de creación de objetos anónimos

Un anonymous_object_creation_expression se usa para crear un objeto de un tipo

anónimo.

antlr

anonymous_object_creation_expression

: 'new' anonymous_object_initializer

anonymous_object_initializer

 : '{' member_declarator_list? '}'

| '{' member_declarator_list ',' '}'

member_declarator_list

: member_declarator (',' member_declarator)*

member_declarator

: simple_name

| member_access

| base_access

| null_conditional_member_access

| identifier '=' expression

Un inicializador de objeto anónimo declara un tipo anónimo y devuelve una instancia de

ese tipo. Un tipo anónimo es un tipo de clase sin nombre que hereda directamente de
object . Los miembros de un tipo anónimo son una secuencia de propiedades de solo

lectura que se deducen del inicializador de objeto anónimo utilizado para crear una
instancia del tipo. En concreto, un inicializador de objeto anónimo con el formato

C#

new { p1 = e1, p2 = e2, ..., pn = en }

declara un tipo anónimo del formulario

C#

class __Anonymous1

private readonly T1 f1;

private readonly T2 f2;

...

private readonly Tn fn;

public __Anonymous1(T1 a1, T2 a2, ..., Tn an) {

f1 = a1;

f2 = a2;

...

fn = an;

public T1 p1 { get { return f1; } }

public T2 p2 { get { return f2; } }

...

public Tn pn { get { return fn; } }

public override bool Equals(object __o) { ... }

 public override int GetHashCode() { ... }

donde cada Tx es el tipo de la expresión correspondiente ex . La expresión utilizada en

un member_declarator debe tener un tipo. Por lo tanto, se trata de un error en tiempo
de compilación para que una expresión de una member_declarator sea NULL o una
función anónima. También es un error en tiempo de compilación para que la expresión
tenga un tipo no seguro.

El compilador genera automáticamente los nombres de un tipo anónimo y del

parámetro para su Equals método, y no se puede hacer referencia a ellos en el texto del
programa.

En el mismo programa, dos inicializadores de objeto anónimo que especifican una

secuencia de propiedades de los mismos nombres y tipos en tiempo de compilación en
el mismo orden generarán instancias del mismo tipo anónimo.

En el ejemplo

C#

var p1 = new { Name = "Lawnmower", Price = 495.00 };

var p2 = new { Name = "Shovel", Price = 26.95 };

p1 = p2;

la asignación en la última línea se permite porque p1 y p2 son del mismo tipo anónimo.

Los Equals GetHashcode métodos y en los tipos anónimos invalidan los métodos
heredados de y object se definen en términos de Equals y de las GetHashcode
propiedades, de modo que dos instancias del mismo tipo anónimo son iguales si y solo
si todas sus propiedades son iguales.

Un declarador de miembro se puede abreviar como un nombre simple (inferencia de

tipos), un acceso a miembro (comprobación en tiempo de compilación de la resolución
dinámica de sobrecarga), un acceso base (acceso base) o un acceso a miembro
condicional nulo (expresiones condicionales NULL como inicializadores de proyección).
Esto se denomina inicializador de proyección y es la abreviatura de una declaración de
y la asignación a una propiedad con el mismo nombre. En concreto, los declaradores de
miembros de los formularios

C#

identifier

expr.identifier

son exactamente equivalentes a lo siguiente, respectivamente:

C#

identifier = identifier

identifier = expr.identifier

Por lo tanto, en un inicializador de proyección, el identificador selecciona tanto el valor

como el campo o la propiedad a los que se asigna el valor. De manera intuitiva, un
inicializador de proyección proyecta no solo un valor, sino también el nombre del valor.

El operador typeof
El typeof operador se usa para obtener el System.Type objeto para un tipo.

antlr

typeof_expression

: 'typeof' '(' type ')'

| 'typeof' '(' unbound_type_name ')'

| 'typeof' '(' 'void' ')'

unbound_type_name

: identifier generic_dimension_specifier?

| identifier '::' identifier generic_dimension_specifier?

| unbound_type_name '.' identifier generic_dimension_specifier?

generic_dimension_specifier

: '<' comma* '>'

comma

: ','

La primera forma de typeof_expression consta de una typeof palabra clave seguida de

un tipo entre paréntesis. El resultado de una expresión de este formulario es el
System.Type objeto para el tipo indicado. Solo hay un System.Type objeto para un tipo
determinado. Esto significa que para un tipo   T , typeof(T) == typeof(T) siempre es
true. El tipo no puede ser dynamic .

La segunda forma de typeof_expression consta de una typeof palabra clave seguida de

un unbound_type_name entre paréntesis. Un unbound_type_name es muy similar a un
type_name (espacio de nombres y nombres de tipo), salvo que un unbound_type_name
contiene generic_dimension_specifier s donde una type_name contiene
type_argument_list s. Cuando el operando de una typeof_expression es una secuencia de
tokens que satisface las gramáticas de unbound_type_name y type_name, es decir,
cuando no contiene un generic_dimension_specifier ni un type_argument_list, la
secuencia de tokens se considera una type_name. El significado de un
unbound_type_name se determina de la manera siguiente:

Convierta la secuencia de tokens en un type_name reemplazando cada

generic_dimension_specifier por un type_argument_list que tenga el mismo número
de comas y la palabra clave object que cada type_argument.
Evalúe el type_name resultante, pasando por alto todas las restricciones de
parámetros de tipo.
El unbound_type_name se resuelve en el tipo genérico sin enlazar asociado con el
tipo construido resultante (tipos enlazados y sin enlazar).

El resultado de la typeof_expression es el System.Type objeto para el tipo genérico sin

enlazar resultante.

La tercera forma de typeof_expression consta de una typeof palabra clave seguida de

una void palabra clave entre paréntesis. El resultado de una expresión de este
formulario es el System.Type objeto que representa la ausencia de un tipo. El objeto de
tipo devuelto por typeof(void) es distinto del objeto de tipo devuelto para cualquier
tipo. Este objeto de tipo especial es útil en las bibliotecas de clases que permiten la
reflexión en métodos del lenguaje, donde esos métodos desean tener una manera de
representar el tipo de valor devuelto de cualquier método, incluidos los métodos void,
con una instancia de System.Type .

El typeof operador se puede utilizar en un parámetro de tipo. El resultado es el

System.Type objeto para el tipo en tiempo de ejecución que se ha enlazado al

parámetro de tipo. El typeof operador también se puede usar en un tipo construido o

en un tipo genérico sin enlazar (tipos enlazados y sin enlazar). El System.Type objeto
para un tipo genérico sin enlazar no es el mismo que el System.Type objeto del tipo de
instancia. El tipo de instancia es siempre un tipo construido cerrado en tiempo de
ejecución, por lo que su System.Type objeto depende de los argumentos de tipo en
tiempo de ejecución en uso, mientras que el tipo genérico sin enlazar no tiene ningún
argumento de tipo.

En el ejemplo

C#
 using System;

class X<T>

public static void PrintTypes() {

Type[] t = {

typeof(int),

typeof(System.Int32),

typeof(string),

typeof(double[]),

typeof(void),

typeof(T),

typeof(X<T>),

typeof(X<X<T>>),

typeof(X<>)

};

for (int i = 0; i < t.Length; i++) {

Console.WriteLine(t[i]);

class Test

static void Main() {

X<int>.PrintTypes();

genera el siguiente resultado:

Consola

System.Int32

System.Int32

System.String

System.Double[]

System.Void

System.Int32

X`1[System.Int32]

X`1[X`1[System.Int32]]

X`1[T]

Tenga en cuenta que int y System.Int32 son el mismo tipo.

Tenga en cuenta también que el resultado de no typeof(X<>) depende del argumento

de tipo, sino del resultado de typeof(X<T>) .

Operadores checked y unchecked

Los checked unchecked operadores y se usan para controlar el contexto de
comprobación de desbordamiento para las operaciones aritméticas de tipo entero y las
conversiones.

antlr

checked_expression

: 'checked' '(' expression ')'

unchecked_expression

: 'unchecked' '(' expression ')'

El checked operador evalúa la expresión contenida en un contexto comprobado y el

unchecked operador evalúa la expresión contenida en un contexto no comprobado. Un

checked_expression o unchecked_expression corresponde exactamente a un

parenthesized_expression (expresiones entre paréntesis), salvo que la expresión
contenida se evalúa en el contexto de comprobación de desbordamiento determinado.

El contexto de comprobación de desbordamiento también se puede controlar a través

de las checked unchecked instrucciones y (las instrucciones checked y unchecked).

Las siguientes operaciones se ven afectadas por el contexto de comprobación de

desbordamiento establecido por los checked unchecked operadores y y las
instrucciones:

Los operadores predefinidos ++ y -- unarios (operadores deincremento y

decremento postfijo y operadores de incremento y decremento de prefijo) cuando
el operando es de un tipo entero.
- Operador unario predefinido (operador unario menos), cuando el operando es

de un tipo entero.
Los + operadores binarios predefinidos,, - * y / (operadores aritméticos),
cuando ambos operandos son de tipos enteros.
Conversiones numéricas explícitas (Conversiones numéricas explícitas) de un tipo
entero a otro tipo entero, o de float o double a un tipo entero.

Cuando una de las operaciones anteriores produce un resultado que es demasiado

grande para representarlo en el tipo de destino, el contexto en el que se realiza la
operación controla el comportamiento resultante:

En un checked contexto, si la operación es una expresión constante (expresiones

constantes), se produce un error en tiempo de compilación. De lo contrario,
 cuando la operación se realiza en tiempo de ejecución, System.OverflowException
se produce una excepción.
En un unchecked contexto, el resultado se trunca descartando los bits de orden
superior que no caben en el tipo de destino.

En el caso de las expresiones que no son constantes (expresiones que se evalúan en

tiempo de ejecución) que no están incluidas en ningún checked unchecked operador o
instrucción, el contexto de comprobación de desbordamiento predeterminado es
unchecked a menos que los factores externos (como los modificadores de compilador y

la configuración del entorno de ejecución) llamen a para su checked evaluación.

En el caso de expresiones constantes (expresiones que se pueden evaluar por completo

en tiempo de compilación), el contexto de comprobación de desbordamiento
predeterminado siempre es checked . A menos que una expresión constante se coloque
explícitamente en un unchecked contexto, los desbordamientos que se producen
durante la evaluación en tiempo de compilación de la expresión siempre producen
errores en tiempo de compilación.

El cuerpo de una función anónima no se ve afectado por checked o unchecked los

contextos en los que se produce la función anónima.

En el ejemplo

C#

class Test

static readonly int x = 1000000;

static readonly int y = 1000000;

static int F() {

return checked(x * y); // Throws OverflowException

static int G() {

return unchecked(x * y); // Returns -727379968

static int H() {

return x * y; // Depends on default

no se detectan errores en tiempo de compilación, ya que ninguna de las expresiones se

puede evaluar en tiempo de compilación. En tiempo de ejecución, el F método produce
una excepción System.OverflowException y el G método devuelve-727379968 (los 32
bits inferiores del resultado fuera del intervalo). El comportamiento del H método
depende del contexto de comprobación de desbordamiento predeterminado para la
compilación, pero es igual o igual que F G .

En el ejemplo

C#

class Test

const int x = 1000000;

const int y = 1000000;

static int F() {

return checked(x * y); // Compile error, overflow

static int G() {

return unchecked(x * y); // Returns -727379968

static int H() {

return x * y; // Compile error, overflow

los desbordamientos que se producen al evaluar las expresiones constantes en F y H

provocan que se notifiquen los errores en tiempo de compilación porque las
expresiones se evalúan en un checked contexto. También se produce un
desbordamiento al evaluar la expresión constante en G , pero como la evaluación tiene
lugar en un unchecked contexto, el desbordamiento no se registra.

Los checked unchecked operadores y solo afectan al contexto de comprobación de

desbordamiento para las operaciones que están contenidas textualmente en los (
tokens "" y "" ) . Los operadores no tienen ningún efecto en los miembros de función
que se invocan como resultado de evaluar la expresión contenida. En el ejemplo

C#

class Test

static int Multiply(int x, int y) {

return x * y;

static int F() {

return checked(Multiply(1000000, 1000000));

el uso de checked en F no afecta a la evaluación de x * y en Multiply , por lo que x *

y se evalúa en el contexto de comprobación de desbordamiento predeterminado.

El unchecked operador es práctico cuando se escriben constantes de los tipos enteros

con signo en notación hexadecimal. Por ejemplo:

C#

class Test

public const int AllBits = unchecked((int)0xFFFFFFFF);

public const int HighBit = unchecked((int)0x80000000);

Las dos constantes hexadecimales anteriores son de tipo uint . Dado que las constantes
están fuera del int intervalo, sin el unchecked operador, las conversiones a int
generarán errores en tiempo de compilación.

Los checked unchecked operadores y y las instrucciones permiten a los programadores

controlar determinados aspectos de algunos cálculos numéricos. Sin embargo, el
comportamiento de algunos operadores numéricos depende de los tipos de datos de
los operandos. Por ejemplo, si se multiplican dos decimales, siempre se produce una
excepción en el desbordamiento incluso dentro de una unchecked construcción
explícita. Del mismo modo, si se multiplican dos floats, nunca se produce una excepción
en el desbordamiento incluso dentro de una checked construcción explícita. Además,
otros operadores nunca se ven afectados por el modo de comprobación, ya sea de
forma predeterminada o explícita.

Expresiones de valor predeterminado

Una expresión de valor predeterminado se usa para obtener el valor predeterminado
(valores predeterminados) de un tipo. Normalmente, se usa una expresión de valor
predeterminado para los parámetros de tipo, ya que es posible que no se conozca si el
parámetro de tipo es un tipo de valor o un tipo de referencia. (No existe ninguna
conversión del null literal a un parámetro de tipo a menos que se sepa que el
parámetro de tipo es un tipo de referencia).

antlr
 default_value_expression

: 'default' '(' type ')'

Si el tipo de un default_value_expression se evalúa en tiempo de ejecución en un tipo de

referencia, el resultado se null convierte en ese tipo. Si el tipo de un
default_value_expression se evalúa en tiempo de ejecución en un tipo de valor, el
resultado es el valor predeterminado del Value_type(constructores predeterminados).

Un default_value_expression es una expresión constante (expresiones constantes) si el

tipo es un tipo de referencia o un parámetro de tipo que se sabe que es un tipo de
referencia (restricciones de parámetro de tipo). Además, una default_value_expression es
una expresión constante si el tipo es uno de los siguientes tipos de valor: sbyte , byte ,
short , ushort , int , uint , long , ulong ,, char ,, float double decimal , bool o
cualquier tipo de enumeración.

Expresiones Name
Un nameof_expression se utiliza para obtener el nombre de una entidad de programa
como una cadena de constante.

antlr

nameof_expression

: 'nameof' '(' named_entity ')'

named_entity

: simple_name

| named_entity_target '.' identifier type_argument_list?

named_entity_target

: 'this'

| 'base'

| named_entity

| predefined_type

| qualified_alias_member

Gramaticalmente hablando, el operando named_entity siempre es una expresión. Dado

que nameof no es una palabra clave reservada, una expresión name es siempre
sintácticamente ambigua con una invocación del nombre simple nameof . Por motivos
de compatibilidad, si la búsqueda de nombres (nombres simples) del nombre nameof se
realiza correctamente, la expresión se trata como un invocation_expression ,
independientemente de si la invocación es legal. En caso contrario, es un
nameof_expression.

El significado de la named_entity de una nameof_expression es el significado de la misma

como una expresión; es decir, como un simple_name, un base_access o un
member_access. Sin embargo, si la búsqueda descrita en nombres simples y acceso a
miembros produce un error porque se encontró un miembro de instancia en un
contexto estático, un nameof_expression no genera este error.

Se trata de un error en tiempo de compilación para un named_entity que designa que

un grupo de métodos tiene un type_argument_list. Es un error en tiempo de compilación
para que un named_entity_target tenga el tipo dynamic .

Un nameof_expression es una expresión constante de tipo string y no tiene ningún

efecto en tiempo de ejecución. En concreto, su named_entity no se evalúa y se omite
para los fines del análisis de asignación definitiva (reglas generales para expresiones
simples). Su valor es el último identificador de la named_entity antes del
type_argument_list final opcional, transformada de la siguiente manera:

El prefijo " @ ", si se utiliza, se quita.

Cada unicode_escape_sequence se transforma en el carácter Unicode
correspondiente.
Se quitan los formatting_characters .

Se trata de las mismas transformaciones aplicadas en los identificadores al probar la

igualdad entre los identificadores.

TODO: ejemplos

Expresiones de método anónimo

Una anonymous_method_expression es una de las dos formas de definir una función
anónima. Se describen con más detalle en expresiones de función anónima.

Operadores unarios
Los ? + operadores,, - , ! , ~ , ++ , -- , CAST y await se denominan operadores
unarios.

antlr
 unary_expression

: primary_expression

| null_conditional_expression
| '+' unary_expression

| '-' unary_expression

| '!' unary_expression

| '~' unary_expression

| pre_increment_expression

| pre_decrement_expression

| cast_expression

| await_expression

| unary_expression_unsafe

Si el operando de una unary_expression tiene el tipo en tiempo de compilación dynamic

, se enlaza dinámicamente (enlace dinámico). En este caso, el tipo en tiempo de
compilación del unary_expression es dynamic y la resolución que se describe a
continuación se realizará en tiempo de ejecución mediante el tipo en tiempo de
ejecución del operando.

Operador condicional de NULL

El operador condicional null aplica una lista de operaciones a su operando solo si ese
operando no es NULL. De lo contrario, el resultado de aplicar el operador es null .

antlr

null_conditional_expression

: primary_expression null_conditional_operations

null_conditional_operations

: null_conditional_operations? '?' '.' identifier type_argument_list?

| null_conditional_operations? '?' '[' argument_list ']'

| null_conditional_operations '.' identifier type_argument_list?

| null_conditional_operations '[' argument_list ']'

| null_conditional_operations '(' argument_list? ')'

La lista de operaciones puede incluir operaciones de acceso a miembros y acceso a

elementos (que pueden ser a su vez valores condicionales null), así como invocación.

Por ejemplo, la expresión a.b?[0]?.c() es un null_conditional_expression con un

primary_expression a.b y null_conditional_operations ?[0] (acceso a un elemento
condicional null), ?.c (acceso a miembro condicional null) y () (Invocación).
Para un null_conditional_expression E con un primary_expression P , supongamos que
E0 es la expresión obtenida quitando textualmente el interlineado ? de cada una de las
null_conditional_operations de E que tienen uno. Conceptualmente, E0 es la expresión
que se evaluará si ninguna de las comprobaciones nulas representadas por ? s
encuentra un null .

Además, supongamos que E1 es la expresión obtenida quitando textualmente el

principio de ? solo el primero de la null_conditional_operations en E . Esto puede
conducir a una expresión principal (si solo había una ? ) o a otra
null_conditional_expression.

Por ejemplo, si E es la expresión a.b?[0]?.c() , E0 es la expresión a.b[0].c() y E1 es

la expresión a.b[0]?.c() .

Si E0 se clasifica como Nothing, E se clasifica como Nothing. De lo contrario, E se

clasifica como un valor.

E0 y E1 se usan para determinar el significado de E :

Si E se produce como statement_expression el significado de E es el mismo que el

de la instrucción

C#

if ((object)P != null) E1;

excepto que P se evalúa solo una vez.

De lo contrario, si E0 se clasifica como Nothing, se produce un error en tiempo de

compilación.

De lo contrario, T0 será el tipo de E0 .

Si T0 es un parámetro de tipo que no se sabe que es un tipo de referencia o un

tipo de valor que no acepta valores NULL, se produce un error en tiempo de
compilación.

Si T0 es un tipo de valor que no acepta valores NULL, el tipo de E es T0? y el

significado de E es el mismo que

C#

((object)P == null) ? (T0?)null : E1

 excepto que P se evalúa solo una vez.

De lo contrario, el tipo de E es T0 y el significado de E es el mismo que

C#

((object)P == null) ? null : E1

excepto que P se evalúa solo una vez.

Si E1 es un null_conditional_expression, estas reglas se aplican de nuevo, anidando las

pruebas para null hasta que no haya más ? , y la expresión se ha reducido hasta el
final de la expresión principal E0 .

Por ejemplo, si la expresión a.b?[0]?.c() se produce como una expresión de

instrucción, como en la instrucción:

C#

a.b?[0]?.c();

su significado es equivalente a:

C#

if (a.b != null) a.b[0]?.c();

lo que es equivalente a:

C#

if (a.b != null) if (a.b[0] != null) a.b[0].c();

Salvo que a.b y a.b[0] se evalúan solo una vez.

Si se produce en un contexto donde se usa su valor, como en:

C#

var x = a.b?[0]?.c();

y suponiendo que el tipo de la invocación final no es un tipo de valor que no acepta

valores NULL, su significado es equivalente a:
 C#

var x = (a.b == null) ? null : (a.b[0] == null) ? null : a.b[0].c();

salvo que a.b y a.b[0] se evalúan solo una vez.

Expresiones condicionales NULL como inicializadores de

proyección
Solo se permite una expresión condicional NULL como member_declarator en un
anonymous_object_creation_expression (expresiones de creación de objetos anónimos) si
finaliza con un acceso a miembro (opcionalmente condicional). Gramaticalmente, este
requisito se puede expresar de la siguiente manera:

antlr

null_conditional_member_access

: primary_expression null_conditional_operations? '?' '.' identifier

type_argument_list?

| primary_expression null_conditional_operations '.' identifier

type_argument_list?

Este es un caso especial de la gramática de null_conditional_expression anterior. La

producción de member_declarator en expresiones de creación de objetos anónimos
incluye solo null_conditional_member_access.

Expresiones condicionales NULL como expresiones de instrucción

Solo se permite una expresión condicional NULL como statement_expression

(instrucciones de expresión) si finaliza con una invocación. Gramaticalmente, este
requisito se puede expresar de la siguiente manera:

antlr

null_conditional_invocation_expression

: primary_expression null_conditional_operations '(' argument_list? ')'

Este es un caso especial de la gramática de null_conditional_expression anterior. La

producción de statement_expression en las instrucciones de expresión incluye solo
null_conditional_invocation_expression.
Operador unario más
En el caso de una operación +x con el formato, se aplica la resolución de sobrecargas
de operador unario (resolución de sobrecarga del operador unario) para seleccionar una
implementación de operador específica. El operando se convierte al tipo de parámetro
del operador seleccionado y el tipo del resultado es el tipo de valor devuelto del
operador. Los operadores unarios más predefinidos más son:

C#

int operator +(int x);

uint operator +(uint x);

long operator +(long x);

ulong operator +(ulong x);

float operator +(float x);

double operator +(double x);

decimal operator +(decimal x);

Para cada uno de estos operadores, el resultado es simplemente el valor del operando.

Operador unario menos

En el caso de una operación -x con el formato, se aplica la resolución de sobrecargas
de operador unario (resolución de sobrecarga del operador unario) para seleccionar una
implementación de operador específica. El operando se convierte al tipo de parámetro
del operador seleccionado y el tipo del resultado es el tipo de valor devuelto del
operador. Los operadores de negación predefinidos son:

Negación de entero:

C#

int operator -(int x);

long operator -(long x);

El resultado se calcula restando x de cero. Si el valor de x es el menor valor

representable del tipo de operando (-2 ^ 31 para int o-2 ^ 63 para long ), la
negación matemática de x no se podrá representar en el tipo de operando. Si esto
ocurre dentro de un checked contexto, System.OverflowException se produce una
excepción; si se produce dentro de un unchecked contexto, el resultado es el valor
del operando y no se registra el desbordamiento.
 Si el operando del operador de negación es de tipo uint , se convierte al tipo
long y el tipo del resultado es long . Una excepción es la regla que permite int
escribir el valor-2147483648 (-2 ^ 31) como un literal entero decimal (literales
enteros).

Si el operando del operador de negación es de tipo ulong , se produce un error en

tiempo de compilación. Una excepción es la regla que permite long escribir el
valor-9.223.372.036.854.775.808 (-2 ^ 63) como un literal entero decimal (literales
enteros).

Negación de punto flotante:

C#

float operator -(float x);

double operator -(double x);

El resultado es el valor de x con el signo invertido. Si x es Nan, el resultado es

también Nan.

Negación decimal:

C#

decimal operator -(decimal x);

El resultado se calcula restando x de cero. La negación decimal es equivalente a

usar el operador unario menos de tipo System.Decimal .

Operador de negación lógica.

En el caso de una operación !x con el formato, se aplica la resolución de sobrecargas
de operador unario (resolución de sobrecarga del operador unario) para seleccionar una
implementación de operador específica. El operando se convierte al tipo de parámetro
del operador seleccionado y el tipo del resultado es el tipo de valor devuelto del
operador. Solo existe un operador lógico de negación predefinido:

C#

bool operator !(bool x);

Este operador calcula la negación lógica del operando: Si el operando es true , el

resultado es false . Si el operando es false , el resultado es true .

Operador de complemento bit a bit

En el caso de una operación ~x con el formato, se aplica la resolución de sobrecargas
de operador unario (resolución de sobrecarga del operador unario) para seleccionar una
implementación de operador específica. El operando se convierte al tipo de parámetro
del operador seleccionado y el tipo del resultado es el tipo de valor devuelto del
operador. Los operadores de complemento bit a bit predefinidos son:

C#

int operator ~(int x);

uint operator ~(uint x);

long operator ~(long x);

ulong operator ~(ulong x);

Para cada uno de estos operadores, el resultado de la operación es el complemento bit

a bit de x .

Cada tipo de enumeración E proporciona implícitamente el siguiente operador de

complemento bit a bit:

C#

E operator ~(E x);

El resultado de evaluar ~x , donde x es una expresión de un tipo de enumeración E

con un tipo subyacente U , es exactamente igual que la evaluación (E)(~(U)x) , con la
excepción de que la conversión a E siempre se realiza como si estuviera en un
unchecked contexto (operadores comprobados y sin comprobar).

Operadores de incremento y decremento prefijos

antlr

pre_increment_expression

: '++' unary_expression

pre_decrement_expression

: '--' unary_expression

El operando de una operación de incremento o decremento de prefijo debe ser una

expresión clasificada como una variable, un acceso a la propiedad o un acceso a un
indexador. El resultado de la operación es un valor del mismo tipo que el operando.

Si el operando de una operación de incremento o decremento de prefijo es una

propiedad o un indexador, la propiedad o el indexador deben tener un get set
descriptor de acceso y. Si no es así, se produce un error en tiempo de enlace.

La resolución de sobrecargas de operador unario (resolución de sobrecarga de

operadores unarios) se aplica para seleccionar una implementación de operador
específica. ++ Existen operadores y predefinidos -- para los tipos siguientes: sbyte ,
byte , short , ushort , int , uint ,,, long ulong char , float , double , decimal y
cualquier tipo de enumeración. Los operadores predefinidos ++ devuelven el valor
generado agregando 1 al operando y los operadores predefinidos -- devuelven el valor
generado restando 1 del operando. En un checked contexto, si el resultado de esta
suma o resta está fuera del intervalo del tipo de resultado y el tipo de resultado es un
tipo entero o de enumeración, System.OverflowException se produce una excepción.

El procesamiento en tiempo de ejecución de una operación de incremento o

decremento de prefijo del formulario ++x o --x consta de los siguientes pasos:

Si x se clasifica como una variable:

x se evalúa para generar la variable.

El operador seleccionado se invoca con el valor de x como argumento.

El valor devuelto por el operador se almacena en la ubicación especificada por
la evaluación de x .
El valor devuelto por el operador se convierte en el resultado de la operación.
Si x se clasifica como un acceso de propiedad o indizador:
La expresión de instancia (si x no es static ) y la lista de argumentos (si x es
un acceso de indexador) asociadas a x se evalúan, y los resultados se usan en
las get set llamadas a descriptores de acceso y posteriores.
get Se invoca el descriptor de acceso de x .
El operador seleccionado se invoca con el valor devuelto por el get descriptor
de acceso como su argumento.
El set descriptor de acceso de x se invoca con el valor devuelto por el
operador como su value argumento.
El valor devuelto por el operador se convierte en el resultado de la operación.
Los ++ -- operadores y también admiten la notación de postfijo (operadores de
incremento y decremento de postfijo). Normalmente, el resultado de x++ o x-- es el
valor de x antes de la operación, mientras que el resultado de ++x o --x es el valor de
x después de la operación. En cualquier caso, x tiene el mismo valor después de la
operación.

Una operator++ implementación de o operator-- se puede invocar mediante la

notación de prefijo o postfijo. No es posible tener implementaciones de operador
independientes para las dos notaciones.

Expresiones de conversión
Un cast_expression se utiliza para convertir explícitamente una expresión a un tipo
determinado.

antlr

cast_expression

: '(' type ')' unary_expression

Cast_expression del formulario (T)E , donde T es un tipo y E es un unary_expression,

realiza una conversión explícita (conversiones explícitas) del valor de E en el tipo T . Si
no existe una conversión explícita de E a T , se produce un error en tiempo de enlace.
De lo contrario, el resultado es el valor generado por la conversión explícita. El resultado
siempre se clasifica como un valor, incluso si E denota una variable.

La gramática de una cast_expression conduce a ciertas ambigüedades sintácticas. Por

ejemplo, la expresión (x)-y se puede interpretar como un cast_expression (una
conversión de -y a tipo x ) o como un additive_expression combinado con un
parenthesized_expression (que calcula el valor x - y) .

Para resolver las ambigüedades de cast_expression , existe la siguiente regla: una

secuencia de uno o más tokens(espacio en blanco) entre paréntesis se considera el inicio
de un cast_expression solo si se cumple al menos una de las siguientes condiciones:

La secuencia de tokens es la gramática correcta para un tipo, pero no para una

expresión.
La secuencia de tokens es la gramática correcta para un tipo, y el token que sigue
inmediatamente al paréntesis de cierre es el token " ~ ", el token " ! ", el token "
( ", un identificador (secuencias de escape de caracteres Unicode), un literal

(literales) o cualquier palabra clave (Keywords) excepto as y is .

El término "gramática correcta" anterior significa que la secuencia de tokens debe
ajustarse a la producción gramatical concreta. En concreto, no se tiene en cuenta el
significado real de los identificadores constituyentes. Por ejemplo, si x y y son
identificadores, x.y es la gramática correcta para un tipo, incluso si x.y no denota
realmente un tipo.

En la regla de desambiguación se sigue que, si x y y son identificadores,, (x)y (x)(y)

y (x)(-y) son cast_expression s, pero (x)-y no es, aunque x identifique un tipo. Sin
embargo, si x es una palabra clave que identifica un tipo predefinido (como int ), las
cuatro formas son cast_expression s (porque tal palabra clave podría no ser una
expresión por sí misma).

Expresiones Await
El operador Await se usa para suspender la evaluación de la función asincrónica
envolvente hasta que se haya completado la operación asincrónica representada por el
operando.

antlr

await_expression

: 'await' unary_expression

Solo se permite un await_expression en el cuerpo de una función asincrónica (funciones

asincrónicas). Dentro de la función asincrónica envolvente más cercana, puede que no
se produzca una await_expression en estos lugares:

Dentro de una función anónima anidada (no asincrónica)

Dentro del bloque de un lock_statement
En un contexto no seguro

Tenga en cuenta que no se puede producir un await_expression en la mayoría de los

lugares de una query_expression, porque se transforman sintácticamente para usar
expresiones lambda no asincrónicas.

Dentro de una función asincrónica, await no se puede usar como identificador. Por lo
tanto, no hay ambigüedades sintácticas entre las expresiones Await y varias expresiones
que intervienen en identificadores. Fuera de las funciones asincrónicas, await actúa
como un identificador normal.

El operando de un await_expression se denomina *Task _. Representa una operación

asincrónica que puede o no completarse en el momento en que se evalúa el
_await_expression *. El propósito del operador Await es suspender la ejecución de la
función asincrónica envolvente hasta que se complete la tarea en espera y, a
continuación, obtener el resultado.

Expresiones que admiten Await

Es necesario que la tarea de una expresión Await sea Await. Una expresión t es de
esperable si una de las siguientes contiene:

t es del tipo de tiempo de compilación dynamic

t tiene una instancia accesible o un método de extensión llamado sin GetAwaiter

parámetros y sin parámetros de tipo, y un tipo de valor devuelto para el que se

retienen A todos los elementos siguientes:
A implementa la interfaz System.Runtime.CompilerServices.INotifyCompletion
(en adelante conocida como INotifyCompletion por motivos de brevedad)
A tiene una propiedad de instancia accesible y legible IsCompleted de tipo bool

A tiene un método de instancia accesible sin GetResult parámetros y sin

parámetros de tipo

El propósito del GetAwaiter método es obtener un *Await _ para la tarea. El tipo A se

denomina el tipo _ awaiter* para la expresión Await.

El propósito de la IsCompleted propiedad es determinar si la tarea ya se ha completado.

Si es así, no es necesario suspender la evaluación.

El propósito del INotifyCompletion.OnCompleted método es registrar una "continuación"

en la tarea; es decir, un delegado (de tipo System.Action ) que se invocará una vez que
se complete la tarea.

El propósito del GetResult método es obtener el resultado de la tarea una vez que ha
finalizado. Este resultado puede ser una finalización correcta, posiblemente con un valor
de resultado, o puede ser una excepción producida por el GetResult método.

Clasificación de expresiones Await

La expresión await t se clasifica de la misma forma que la expresión
(t).GetAwaiter().GetResult() . Por lo tanto, si el tipo de valor devuelto de GetResult es
void , el await_expression se clasifica como Nothing. Si tiene un tipo de valor devuelto

distinto de void T , el await_expression se clasifica como un valor de tipo T .

Evaluación en tiempo de ejecución de expresiones Await
En tiempo de ejecución, la expresión await t se evalúa como sigue:

Un Await a se obtiene evaluando la expresión (t).GetAwaiter() .

bool b Se obtiene mediante la evaluación de la expresión (a).IsCompleted .
Si b es false , la evaluación depende de si a implementa la interfaz
System.Runtime.CompilerServices.ICriticalNotifyCompletion (en adelante
conocida como ICriticalNotifyCompletion por motivos de brevedad). Esta
comprobación se realiza en el momento del enlace; es decir, en tiempo de
ejecución si a tiene el tipo de tiempo de compilación dynamic y en tiempo de
compilación, en caso contrario. Se r debe indicar el delegado de reanudación
(funciones asincrónicas):
Si no a implementa ICriticalNotifyCompletion , se evalúa la expresión (a as
(INotifyCompletion)).OnCompleted(r) .

Si a implementa ICriticalNotifyCompletion , se evalúa la expresión (a as

(ICriticalNotifyCompletion)).UnsafeOnCompleted(r) .

A continuación, la evaluación se suspende y el control se devuelve al autor de la

llamada actual de la función asincrónica.
Inmediatamente después de (si b era true ), o después de la invocación posterior
del delegado de reanudación (si b era false ), (a).GetResult() se evalúa la
expresión. Si devuelve un valor, ese valor es el resultado de la await_expression. De
lo contrario, el resultado es Nothing.

La implementación de un espera de los métodos de interfaz

INotifyCompletion.OnCompleted y ICriticalNotifyCompletion.UnsafeOnCompleted debe

hacer que r se invoque el delegado como máximo una vez. De lo contrario, el

comportamiento de la función asincrónica envolvente es indefinido.

Operadores aritméticos
Los * / operadores,, % , + y - se denominan operadores aritméticos.

antlr

multiplicative_expression

: unary_expression

| multiplicative_expression '*' unary_expression

| multiplicative_expression '/' unary_expression

| multiplicative_expression '%' unary_expression

 additive_expression

: multiplicative_expression

| additive_expression '+' multiplicative_expression

| additive_expression '-' multiplicative_expression

Si un operando de un operador aritmético tiene el tipo en tiempo de compilación

dynamic , la expresión está enlazada dinámicamente (enlace dinámico). En este caso, el
tipo en tiempo de compilación de la expresión es dynamic y la resolución que se
describe a continuación se realiza en tiempo de ejecución mediante el tipo en tiempo
de ejecución de los operandos que tienen el tipo en tiempo de compilación dynamic .

Operador de multiplicación
En el caso de una operación x * y con el formato, se aplica la resolución de
sobrecargas del operador binario (resolución de sobrecarga del operador binario) para
seleccionar una implementación de operador específica. Los operandos se convierten en
los tipos de parámetro del operador seleccionado y el tipo del resultado es el tipo de
valor devuelto del operador.

A continuación se enumeran los operadores de multiplicación predefinidos. Todos los

operadores calculan el producto de x y y .

Multiplicación de enteros:

C#

int operator *(int x, int y);

uint operator *(uint x, uint y);

long operator *(long x, long y);

ulong operator *(ulong x, ulong y);

En un checked contexto, si el producto está fuera del intervalo del tipo de

resultado, System.OverflowException se produce una excepción. En un unchecked
contexto, no se informan los desbordamientos y se descartan los bits significativos
de orden superior fuera del intervalo del tipo de resultado.

Multiplicación de punto flotante:

C#

float operator *(float x, float y);

double operator *(double x, double y);

 El producto se calcula de acuerdo con las reglas de aritmética de IEEE 754. En la

tabla siguiente se enumeran los resultados de todas las posibles combinaciones de
valores finitos distintos de cero, ceros, infinitos y NaN. En la tabla, x e y son
valores finitos positivos. z es el resultado de x * y . Si el resultado es demasiado
grande para el tipo de destino, z es infinito. Si el resultado es demasiado pequeño
para el tipo de destino, z es cero.

+y -y +0 -0 +inf -inf NaN

+x +z -Z +0 -0 +inf -inf NaN

-X -Z +z -0 +0 -inf +inf NaN

+0 +0 -0 +0 -0 NaN NaN NaN

-0 -0 +0 -0 +0 NaN NaN NaN

+inf +inf -inf NaN NaN +inf -inf NaN

-inf -inf +inf NaN NaN -inf +inf NaN

NaN NaN NaN NaN NaN NaN NaN NaN

Multiplicación decimal:

C#

decimal operator *(decimal x, decimal y);

Si el valor resultante es demasiado grande para representarlo en el decimal

formato, System.OverflowException se produce una excepción. Si el valor del
resultado es demasiado pequeño para representarlo en el decimal formato, el
resultado es cero. La escala del resultado, antes de cualquier redondeo, es la suma
de las escalas de los dos operandos.

La multiplicación decimal es equivalente a usar el operador de multiplicación de

tipo System.Decimal .

Operador de división
En el caso de una operación x / y con el formato, se aplica la resolución de
sobrecargas del operador binario (resolución de sobrecarga del operador binario) para
seleccionar una implementación de operador específica. Los operandos se convierten en
los tipos de parámetro del operador seleccionado y el tipo del resultado es el tipo de
valor devuelto del operador.

A continuación se enumeran los operadores de división predefinidos. Todos los

operadores calculan el cociente de x y y .

División de enteros:

C#

int operator /(int x, int y);

uint operator /(uint x, uint y);

long operator /(long x, long y);

ulong operator /(ulong x, ulong y);

Si el valor del operando derecho es cero, System.DivideByZeroException se

produce una excepción.

La división redondea el resultado hacia cero. Por lo tanto, el valor absoluto del
resultado es el entero posible más grande que sea menor o igual que el valor
absoluto del cociente de los dos operandos. El resultado es cero o positivo cuando
los dos operandos tienen el mismo signo y cero o negativo cuando los dos
operandos tienen signos opuestos.

Si el operando izquierdo es el valor más pequeño que se representable int o long

y el operando derecho es -1 , se produce un desbordamiento. En un checked
contexto, esto hace que System.ArithmeticException se produzca una excepción
(o una subclase de ella). En un unchecked contexto, se define como si se
System.ArithmeticException produjera una excepción (o una subclase de ella) o el

desbordamiento se desinforma de que el valor resultante es el del operando

izquierdo.

División de punto flotante:

C#

float operator /(float x, float y);

double operator /(double x, double y);

El cociente se calcula de acuerdo con las reglas de aritmética de IEEE 754. En la

tabla siguiente se enumeran los resultados de todas las posibles combinaciones de
valores finitos distintos de cero, ceros, infinitos y NaN. En la tabla, x e y son
valores finitos positivos. z es el resultado de x / y . Si el resultado es demasiado
 grande para el tipo de destino, z es infinito. Si el resultado es demasiado pequeño
para el tipo de destino, z es cero.

+y -y +0 -0 +inf -inf NaN

+x +z -Z +inf -inf +0 -0 NaN

-X -Z +z -inf +inf -0 +0 NaN

+0 +0 -0 NaN NaN +0 -0 NaN

-0 -0 +0 NaN NaN -0 +0 NaN

+inf +inf -inf +inf -inf NaN NaN NaN

-inf -inf +inf -inf +inf NaN NaN NaN

NaN NaN NaN NaN NaN NaN NaN NaN

División decimal:

C#

decimal operator /(decimal x, decimal y);

Si el valor del operando derecho es cero, System.DivideByZeroException se

produce una excepción. Si el valor resultante es demasiado grande para
representarlo en el decimal formato, System.OverflowException se produce una
excepción. Si el valor del resultado es demasiado pequeño para representarlo en el
decimal formato, el resultado es cero. La escala del resultado es la menor escala

que conservará un resultado igual al valor decimal que se va a representar más

cercano al resultado matemático verdadero.

La división decimal es equivalente a usar el operador de división de tipo

System.Decimal .

Operador de resto
En el caso de una operación x % y con el formato, se aplica la resolución de
sobrecargas del operador binario (resolución de sobrecarga del operador binario) para
seleccionar una implementación de operador específica. Los operandos se convierten en
los tipos de parámetro del operador seleccionado y el tipo del resultado es el tipo de
valor devuelto del operador.
A continuación se enumeran los operadores de resto predefinidos. Todos los
operadores calculan el resto de la división entre x y y .

Resto entero:

C#

int operator %(int x, int y);

uint operator %(uint x, uint y);

long operator %(long x, long y);

ulong operator %(ulong x, ulong y);

El resultado de x % y es el valor generado por x - (x / y) * y . Si y es cero,

System.DivideByZeroException se produce una excepción.

Si el operando izquierdo es el menor int long valor o y el operando derecho es

-1 , System.OverflowException se produce una excepción. En ningún caso, se x %
y produce una excepción en la que x / y no se producirá una excepción.

Resto de punto flotante:

C#

float operator %(float x, float y);

double operator %(double x, double y);

En la tabla siguiente se enumeran los resultados de todas las posibles

combinaciones de valores finitos distintos de cero, ceros, infinitos y NaN. En la
tabla, x e y son valores finitos positivos. z es el resultado de x % y y se calcula
como x - n * y , donde n es el entero más grande posible que es menor o igual
que x / y . Este método de calcular el resto es análogo al que se usa para los
operandos de entero, pero difiere de la definición de IEEE 754 (en que n es el
entero más próximo a x / y ).

+y -y +0 -0 +inf -inf NaN

+x +z +z NaN NaN x x NaN

-X -Z -Z NaN NaN -X -X NaN

+0 +0 +0 NaN NaN +0 +0 NaN

-0 -0 -0 NaN NaN -0 -0 NaN

+inf NaN NaN NaN NaN NaN NaN NaN

 -inf NaN NaN NaN NaN NaN NaN NaN

NaN NaN NaN NaN NaN NaN NaN NaN

Resto decimal:

C#

decimal operator %(decimal x, decimal y);

Si el valor del operando derecho es cero, System.DivideByZeroException se

produce una excepción. La escala del resultado, antes de cualquier redondeo, es el
mayor de las escalas de los dos operandos y el signo del resultado, si es distinto
de cero, es el mismo que el de x .

El resto decimal es equivalente a usar el operador de resto de tipo System.Decimal

.

Operador de suma
En el caso de una operación x + y con el formato, se aplica la resolución de
sobrecargas del operador binario (resolución de sobrecarga del operador binario) para
seleccionar una implementación de operador específica. Los operandos se convierten en
los tipos de parámetro del operador seleccionado y el tipo del resultado es el tipo de
valor devuelto del operador.

A continuación se enumeran los operadores de suma predefinidos. En el caso de los

tipos numéricos y de enumeración, los operadores de suma predefinidos calculan la
suma de los dos operandos. Cuando uno o ambos operandos son de tipo cadena, los
operadores de suma predefinidos concatenan la representación de cadena de los
operandos.

Suma de enteros:

C#

int operator +(int x, int y);

uint operator +(uint x, uint y);

long operator +(long x, long y);

ulong operator +(ulong x, ulong y);

En un checked contexto, si la suma está fuera del intervalo del tipo de resultado,
System.OverflowException se produce una excepción. En un unchecked contexto,
no se informan los desbordamientos y se descartan los bits significativos de orden
superior fuera del intervalo del tipo de resultado.

Adición de punto flotante:

C#

float operator +(float x, float y);

double operator +(double x, double y);

La suma se calcula de acuerdo con las reglas de aritmética de IEEE 754. En la tabla
siguiente se enumeran los resultados de todas las posibles combinaciones de
valores finitos distintos de cero, ceros, infinitos y NaN. En la tabla, x e y son
valores finitos distintos de cero y z es el resultado de x + y . Si x e y tienen la
misma magnitud pero signos opuestos, z es cero positivo. Si x + y es demasiado
grande para representarlo en el tipo de destino, z es un infinito con el mismo
signo que x + y .

y +0 -0 +inf -inf NaN

x z x x +inf -inf NaN

+0 y +0 +0 +inf -inf NaN

-0 y +0 -0 +inf -inf NaN

+inf +inf +inf +inf +inf NaN NaN

-inf -inf -inf -inf NaN -inf NaN

NaN NaN NaN NaN NaN NaN NaN

Suma decimal:

C#

decimal operator +(decimal x, decimal y);

Si el valor resultante es demasiado grande para representarlo en el decimal

formato, System.OverflowException se produce una excepción. La escala del
resultado, antes de cualquier redondeo, es el mayor de las escalas de los dos
operandos.
La suma decimal es equivalente a usar el operador de suma de tipo
System.Decimal .

Adición de enumeración. Cada tipo de enumeración proporciona implícitamente

los siguientes operadores predefinidos, donde E es el tipo de enumeración, y U es
el tipo subyacente de E :

C#

E operator +(E x, U y);

E operator +(U x, E y);

En tiempo de ejecución, estos operadores se evalúan exactamente como (E)((U)x

+ (U)y) .

Concatenación de cadenas:

C#

string operator +(string x, string y);

string operator +(string x, object y);

string operator +(object x, string y);

Estas sobrecargas del operador binario + realizan la concatenación de cadenas. Si

un operando de la concatenación de cadenas es null , se sustituye una cadena
vacía. De lo contrario, cualquier argumento que no sea de cadena se convierte en
su representación de cadena invocando el ToString método virtual heredado del
tipo object . Si ToString devuelve null , se sustituye una cadena vacía.

C#

using System;

class Test

static void Main() {

string s = null;

Console.WriteLine("s = >" + s + "<"); // displays s = ><

int i = 1;

Console.WriteLine("i = " + i); // displays i = 1

float f = 1.2300E+15F;

Console.WriteLine("f = " + f); // displays f =

1.23E+15

decimal d = 2.900m;

Console.WriteLine("d = " + d); // displays d =

2.900

El resultado del operador de concatenación de cadenas es una cadena que consta

de los caracteres del operando izquierdo seguidos de los caracteres del operando
derecho. El operador de concatenación de cadenas nunca devuelve un null valor.
System.OutOfMemoryException Se puede producir una excepción si no hay suficiente
memoria disponible para asignar la cadena resultante.

Combinación de delegado. Cada tipo de delegado proporciona implícitamente el

siguiente operador predefinido, donde D es el tipo de delegado:

C#

D operator +(D x, D y);

El operador binario + realiza la combinación de delegados cuando ambos

operandos son de algún tipo de delegado D . (Si los operandos tienen distintos
tipos de delegado, se produce un error en tiempo de enlace). Si el primer
operando es null , el resultado de la operación es el valor del segundo operando
(aunque también sea null ). De lo contrario, si el segundo operando es null , el
resultado de la operación es el valor del primer operando. De lo contrario, el
resultado de la operación es una nueva instancia de delegado que, cuando se
invoca, invoca el primer operando y, a continuación, invoca el segundo operando.
Para obtener ejemplos de la combinación de delegados, vea operador de resta e
invocación de delegado. Puesto que System.Delegate no es un tipo de delegado,
operator   + no está definido para él.

Operador de resta
En el caso de una operación x - y con el formato, se aplica la resolución de
sobrecargas del operador binario (resolución de sobrecarga del operador binario) para
seleccionar una implementación de operador específica. Los operandos se convierten en
los tipos de parámetro del operador seleccionado y el tipo del resultado es el tipo de
valor devuelto del operador.

A continuación se enumeran los operadores de resta predefinidos. Los operadores se

restann y de x .

Resta de enteros:

C#
 int operator -(int x, int y);

uint operator -(uint x, uint y);

long operator -(long x, long y);

ulong operator -(ulong x, ulong y);

En un checked contexto, si la diferencia está fuera del intervalo del tipo de

resultado, System.OverflowException se produce una excepción. En un unchecked
contexto, no se informan los desbordamientos y se descartan los bits significativos
de orden superior fuera del intervalo del tipo de resultado.

Resta de punto flotante:

C#

float operator -(float x, float y);

double operator -(double x, double y);

La diferencia se calcula de acuerdo con las reglas de aritmética de IEEE 754. En la

tabla siguiente se enumeran los resultados de todas las posibles combinaciones de
valores finitos distintos de cero, ceros, infinitos y Nan. En la tabla, x e y son
valores finitos distintos de cero y z es el resultado de x - y . Si x e y son iguales,
z es cero positivo. Si x - y es demasiado grande para representarlo en el tipo de
destino, z es un infinito con el mismo signo que x - y .

y +0 -0 +inf -inf NaN

x z x x -inf +inf NaN

+0 -y +0 +0 -inf +inf NaN

-0 -y -0 +0 -inf +inf NaN

+inf +inf +inf +inf NaN +inf NaN

-inf -inf -inf -inf -inf NaN NaN

NaN NaN NaN NaN NaN NaN NaN

Resta decimal:

C#

decimal operator -(decimal x, decimal y);

Si el valor resultante es demasiado grande para representarlo en el decimal

formato, System.OverflowException se produce una excepción. La escala del
resultado, antes de cualquier redondeo, es el mayor de las escalas de los dos
operandos.

La resta decimal es equivalente a usar el operador de resta de tipo System.Decimal

.

Resta de enumeración. Cada tipo de enumeración proporciona implícitamente el

siguiente operador predefinido, donde E es el tipo de enumeración, y U es el tipo
subyacente de E :

C#

U operator -(E x, E y);

Este operador se evalúa exactamente como (U)((U)x - (U)y) . En otras palabras,

el operador calcula la diferencia entre los valores ordinales de x y y , y el tipo del
resultado es el tipo subyacente de la enumeración.

C#

E operator -(E x, U y);

Este operador se evalúa exactamente como (E)((U)x - y) . En otras palabras, el

operador resta un valor del tipo subyacente de la enumeración, lo que produce un
valor de la enumeración.

Eliminación de delegados. Cada tipo de delegado proporciona implícitamente el

siguiente operador predefinido, donde D es el tipo de delegado:

C#

D operator -(D x, D y);

El operador binario - realiza la eliminación del delegado cuando ambos

operandos son de algún tipo de delegado D . Si los operandos tienen distintos
tipos de delegado, se produce un error en tiempo de enlace. Si el primer operando
es null , el resultado de la operación es null . De lo contrario, si el segundo
operando es null , el resultado de la operación es el valor del primer operando.
De lo contrario, ambos operandos representan listas de invocación (declaraciones
de delegado) que tienen una o más entradas y el resultado es una nueva lista de
 invocación que se compone de la lista del primer operando con las entradas del
segundo operando que se han quitado, siempre que la lista del segundo operando
sea una sublista contigua adecuada de la primera. (Para determinar la igualdad de
la lista, las entradas correspondientes se comparan como para el operador de
igualdad de delegado (operadores de igualdad de delegado)). De lo contrario, el
resultado es el valor del operando izquierdo. En el proceso no se cambia ninguna
de las listas de operandos. Si la lista del segundo operando coincide con varias
sublistas de entradas contiguas de la lista del primer operando, se quita la sublista
coincidente situada más a la derecha de las entradas contiguas. Si la eliminación
da como resultado una lista vacía, el resultado es null . Por ejemplo:

C#

delegate void D(int x);

class C

public static void M1(int i) { /* ... */ }

public static void M2(int i) { /* ... */ }

class Test

static void Main() {

D cd1 = new D(C.M1);

D cd2 = new D(C.M2);

D cd3 = cd1 + cd2 + cd2 + cd1; // M1 + M2 + M2 + M1

cd3 -= cd1; // => M1 + M2 + M2

cd3 = cd1 + cd2 + cd2 + cd1; // M1 + M2 + M2 + M1

cd3 -= cd1 + cd2; // => M2 + M1

cd3 = cd1 + cd2 + cd2 + cd1; // M1 + M2 + M2 + M1

cd3 -= cd2 + cd2; // => M1 + M1

cd3 = cd1 + cd2 + cd2 + cd1; // M1 + M2 + M2 + M1

cd3 -= cd2 + cd1; // => M1 + M2

cd3 = cd1 + cd2 + cd2 + cd1; // M1 + M2 + M2 + M1

cd3 -= cd1 + cd1; // => M1 + M2 + M2 + M1

Operadores de desplazamiento
Los << >> operadores y se utilizan para realizar operaciones de desplazamiento de bits.

antlr
 shift_expression

: additive_expression

| shift_expression '<<' additive_expression

| shift_expression right_shift additive_expression

Si un operando de una shift_expression tiene el tipo en tiempo de compilación dynamic ,

la expresión está enlazada dinámicamente (enlace dinámico). En este caso, el tipo en
tiempo de compilación de la expresión es dynamic y la resolución que se describe a
continuación se realiza en tiempo de ejecución mediante el tipo en tiempo de ejecución
de los operandos que tienen el tipo en tiempo de compilación dynamic .

Para una operación con el formato x << count o x >> count , se aplica la resolución de
sobrecargas del operador binario (resolución de sobrecarga del operador binario) para
seleccionar una implementación de operador específica. Los operandos se convierten en
los tipos de parámetro del operador seleccionado y el tipo del resultado es el tipo de
valor devuelto del operador.

Al declarar un operador de desplazamiento sobrecargado, el tipo del primer operando

siempre debe ser la clase o el struct que contiene la declaración del operador y el tipo
del segundo operando siempre debe ser int .

A continuación se enumeran los operadores de desplazamiento predefinidos.

Desplazar a la izquierda:

C#

int operator <<(int x, int count);

uint operator <<(uint x, int count);

long operator <<(long x, int count);

ulong operator <<(ulong x, int count);

El << operador se desplaza a la x izquierda un número de bits calculado como se

describe a continuación.

Los bits de orden superior fuera del intervalo del tipo de resultado de x se
descartan, los bits restantes se desplazan a la izquierda y las posiciones de bits
vacías de orden inferior se establecen en cero.

Desplazamiento a la derecha:

C#
 int operator >>(int x, int count);

uint operator >>(uint x, int count);

long operator >>(long x, int count);

ulong operator >>(ulong x, int count);

El >> operador se desplaza a la x derecha un número de bits calculado como se

describe a continuación.

Cuando x es de tipo int o long , los bits de orden inferior de x se descartan, los
bits restantes se desplazan a la derecha y las posiciones de bits vacías de orden
superior se establecen en cero si x no es negativo y se establecen en uno si x es
negativo.

Cuando x es de tipo uint o ulong , los bits de orden inferior de x se descartan,

los bits restantes se desplazan a la derecha y las posiciones de bits vacías de orden
superior se establecen en cero.

En el caso de los operadores predefinidos, el número de bits que se va a desplazar se

calcula de la manera siguiente:

Cuando el tipo de x es int o uint , el número de turnos viene dado por los cinco
bits de orden inferior de count . En otras palabras, el número de turnos se calcula
a partir de count & 0x1F .
Cuando el tipo de x es long o ulong , el recuento de desplazamiento lo
proporcionan los seis bits de orden inferior de count . En otras palabras, el número
de turnos se calcula a partir de count & 0x3F .

Si el número de turnos resultante es cero, los operadores de desplazamiento

simplemente devuelven el valor de x .

Las operaciones de desplazamiento nunca causan desbordamientos y producen los

mismos resultados en checked y unchecked contextos.

Cuando el operando izquierdo del >> operador es de un tipo entero con signo, el
operador realiza un desplazamiento aritmético a la derecha, donde el valor del bit más
significativo (el bit de signo) del operando se propaga a las posiciones de bits vacías de
orden superior. Cuando el operando izquierdo del >> operador es de un tipo entero sin
signo, el operador realiza un desplazamiento lógico derecho en el que las posiciones de
bits vacías de orden superior siempre se establecen en cero. Para realizar la operación
opuesta a la que se infiere del tipo de operando, se pueden usar conversiones explícitas.
Por ejemplo, si x es una variable de tipo int , la operación unchecked((int)((uint)x >>
y)) realiza un desplazamiento lógico a la derecha de x .
Operadores de comprobación de tipos y
relacionales
Los == != operadores,, < ,, > <= , >= is y as se denominan operadores relacionales y
de prueba de tipos.

antlr

relational_expression

: shift_expression

| relational_expression '<' shift_expression

| relational_expression '>' shift_expression

| relational_expression '<=' shift_expression

| relational_expression '>=' shift_expression

| relational_expression 'is' type

| relational_expression 'as' type

equality_expression

: relational_expression

| equality_expression '==' relational_expression

| equality_expression '!=' relational_expression

El is operador se describe en el operador is y el as operador se describe en el

operador as.

Los == != operadores, < , > , <= y >= son operadores de comparación.

Si un operando de un operador de comparación tiene el tipo en tiempo de compilación

dynamic , la expresión está enlazada dinámicamente (enlace dinámico). En este caso, el

tipo en tiempo de compilación de la expresión es dynamic y la resolución que se

describe a continuación se realiza en tiempo de ejecución mediante el tipo en tiempo
de ejecución de los operandos que tienen el tipo en tiempo de compilación dynamic .

Para una operación con el formato x OP y , donde OP es un operador de comparación,

se aplica la resolución de sobrecarga (resolución de sobrecarga del operador binario)
para seleccionar una implementación de operador específica. Los operandos se
convierten en los tipos de parámetro del operador seleccionado y el tipo del resultado
es el tipo de valor devuelto del operador.

Los operadores de comparación predefinidos se describen en las secciones siguientes.

Todos los operadores de comparación predefinidos devuelven un resultado de tipo
bool , tal y como se describe en la tabla siguiente.
 Operación Resultado

x == y true``x es si es igual a y ; false en caso contrario, es.

x != y true``x es si no es igual a y ; false en caso contrario, es.

x < y true si x es menor que y , false en caso contrario

x > y true si x es mayor que y , false en caso contrario

x <= y true si x es menor o igual que y , false en caso contrario

x >= y true si x es mayor o igual que y , false en caso contrario

Operadores de comparación de enteros

Los operadores de comparación de enteros predefinidos son:

C#

bool operator ==(int x, int y);

bool operator ==(uint x, uint y);

bool operator ==(long x, long y);

bool operator ==(ulong x, ulong y);

bool operator !=(int x, int y);

bool operator !=(uint x, uint y);

bool operator !=(long x, long y);

bool operator !=(ulong x, ulong y);

bool operator <(int x, int y);

bool operator <(uint x, uint y);

bool operator <(long x, long y);

bool operator <(ulong x, ulong y);

bool operator >(int x, int y);

bool operator >(uint x, uint y);

bool operator >(long x, long y);

bool operator >(ulong x, ulong y);

bool operator <=(int x, int y);

bool operator <=(uint x, uint y);

bool operator <=(long x, long y);

bool operator <=(ulong x, ulong y);

bool operator >=(int x, int y);

bool operator >=(uint x, uint y);

bool operator >=(long x, long y);

bool operator >=(ulong x, ulong y);

Cada uno de estos operadores compara los valores numéricos de los dos operandos de
tipo entero y devuelve un bool valor que indica si la relación concreta es true o false .

Operadores de comparación de punto flotante

Los operadores de comparación de punto flotante predefinidos son:

C#

bool operator ==(float x, float y);

bool operator ==(double x, double y);

bool operator !=(float x, float y);

bool operator !=(double x, double y);

bool operator <(float x, float y);

bool operator <(double x, double y);

bool operator >(float x, float y);

bool operator >(double x, double y);

bool operator <=(float x, float y);

bool operator <=(double x, double y);

bool operator >=(float x, float y);

bool operator >=(double x, double y);

Los operadores comparan los operandos según las reglas del estándar IEEE 754:

Si alguno de los operandos es NaN, el resultado es false para todos los

operadores excepto != , para los que el resultado es true . Para dos operandos
cualesquiera, x != y siempre genera el mismo resultado que !(x == y) . Sin
embargo, cuando uno o ambos operandos son Nan, los < operadores,, > <= y >=
no producen los mismos resultados que la negación lógica del operador opuesto.
Por ejemplo, si uno de los valores de x y y es Nan, x < y es false , pero !(x >=
y) es true .

Cuando ninguno de los operandos es NaN, los operadores comparan los valores
de los dos operandos de punto flotante con respecto a la ordenación.

C#

-inf < -max < ... < -min < -0.0 == +0.0 < +min < ... < +max < +inf

donde min y max son los valores finitos positivos más pequeños y mayores que se
pueden representar en el formato de punto flotante dado. Los efectos importantes
 de este orden son:
Los ceros negativos y positivos se consideran iguales.
Un infinito negativo se considera menor que todos los demás valores, pero es
igual a otro infinito negativo.
Un infinito positivo se considera mayor que el resto de los valores, pero es igual
a otro infinito positivo.

Operadores de comparación decimal

Los operadores de comparación decimal predefinidos son:

C#

bool operator ==(decimal x, decimal y);

bool operator !=(decimal x, decimal y);

bool operator <(decimal x, decimal y);

bool operator >(decimal x, decimal y);

bool operator <=(decimal x, decimal y);

bool operator >=(decimal x, decimal y);

Cada uno de estos operadores compara los valores numéricos de los dos operandos
decimales y devuelve un bool valor que indica si la relación concreta es true o false .
Cada comparación decimal es equivalente a usar el operador relacional o de igualdad
correspondiente de tipo System.Decimal .

Operadores de igualdad booleanos

Los operadores de igualdad booleano predefinidos son:

C#

bool operator ==(bool x, bool y);

bool operator !=(bool x, bool y);

El resultado de == es true si x y y son true o si x y y son false . De lo contrario, el

resultado es false .

El resultado de != es false si x y y son true o si x y y son false . De lo contrario, el

resultado es true . Cuando los operandos son de tipo bool , el != operador produce el
mismo resultado que el ^ operador.

Operadores de comparación de enumeración

Cada tipo de enumeración proporciona implícitamente los siguientes operadores de
comparación predefinidos:

C#

bool operator ==(E x, E y);

bool operator !=(E x, E y);

bool operator <(E x, E y);

bool operator >(E x, E y);

bool operator <=(E x, E y);

bool operator >=(E x, E y);

El resultado de evaluar x op y , donde x y y son expresiones de un tipo de

enumeración E con un tipo subyacente U , y op es uno de los operadores de
comparación, es exactamente igual que evaluar ((U)x) op ((U)y) . En otras palabras,
los operadores de comparación de tipos de enumeración simplemente comparan los
valores enteros subyacentes de los dos operandos.

Operadores de igualdad de tipos de referencia

Los operadores de igualdad de tipos de referencia predefinidos son:

C#

bool operator ==(object x, object y);

bool operator !=(object x, object y);

Los operadores devuelven el resultado de comparar las dos referencias de igualdad o de

no igualdad.

Puesto que los operadores de igualdad de tipos de referencia predefinidos aceptan

operandos de tipo object , se aplican a todos los tipos que no declaran operator ==
operator != los miembros y aplicables. Por el contrario, todos los operadores de
igualdad definidos por el usuario aplicables ocultan de forma eficaz los operadores de
igualdad de tipos de referencia predefinidos.

Los operadores de igualdad de tipos de referencia predefinidos requieren uno de los

siguientes:

Ambos operandos son un valor de un tipo conocido como reference_type o literal

null . Además, existe una conversión de referencia explícita (conversiones de

referencia explícitas) desde el tipo de uno de los operandos al tipo del otro
operando.
 Un operando es un valor de T tipo T , donde es un type_parameter y el otro
operando es el literal null . Además, no T tiene la restricción de tipo de valor.

A menos que se cumpla una de estas condiciones, se produce un error en tiempo de

enlace. Las implicaciones destacadas de estas reglas son:

Es un error en tiempo de enlace usar los operadores de igualdad de tipos de

referencia predefinidos para comparar dos referencias que se sabe que son
diferentes en tiempo de enlace. Por ejemplo, si los tipos en tiempo de enlace de
los operandos son dos tipos de clase A y B , y si no se A B derivan de la otra,
sería imposible que los dos operandos hagan referencia al mismo objeto. Por lo
tanto, la operación se considera un error en tiempo de enlace.
Los operadores de igualdad de tipos de referencia predefinidos no permiten
comparar los operandos de tipo de valor. Por lo tanto, a menos que un tipo de
estructura declare sus propios operadores de igualdad, no es posible comparar
valores de ese tipo de estructura.
Los operadores de igualdad de tipos de referencia predefinidos nunca provocan
que se produzcan operaciones de conversión boxing para sus operandos. No
tendría sentido realizar estas operaciones de conversión boxing, ya que las
referencias a las instancias de conversión boxing recién asignadas serían
necesariamente distintas de las demás referencias.
Si un operando de un tipo de parámetro de tipo T se compara con null y el tipo
en tiempo de ejecución de T es un tipo de valor, el resultado de la comparación es
false .

En el ejemplo siguiente se comprueba si un argumento de un tipo de parámetro de tipo

sin restricciones es null .

C#

class C<T>

void F(T x) {

if (x == null) throw new ArgumentNullException();

...

La x == null construcción se permite aunque T pueda representar un tipo de valor y el

resultado se define simplemente como false cuando T es un tipo de valor.

En el caso de una operación de la forma x == y o x != y , si es aplicable operator == o

operator != existe, las reglas de resolución de sobrecarga del operador (resolución de
sobrecarga del operador binario) seleccionarán ese operador en lugar del operador de
igualdad de tipos de referencia predefinido. Sin embargo, siempre es posible
seleccionar el operador de igualdad de tipos de referencia predefinido convirtiendo
explícitamente uno o ambos operandos al tipo object . En el ejemplo

C#

using System;

class Test

static void Main() {

string s = "Test";

string t = string.Copy(s);

Console.WriteLine(s == t);

Console.WriteLine((object)s == t);

Console.WriteLine(s == (object)t);

Console.WriteLine((object)s == (object)t);

genera el resultado

Consola

True

False

False

False

Las s t variables y hacen referencia a dos string instancias distintas que contienen los
mismos caracteres. La primera comparación genera resultados True porque el operador
de igualdad de cadena predefinido (operadores de igualdad de cadena) está
seleccionado cuando ambos operandos son de tipo string . El resto de las
comparaciones False se generan porque el operador de igualdad de tipos de referencia
predefinido se selecciona cuando uno o ambos operandos son del tipo object .

Tenga en cuenta que la técnica anterior no es significativa para los tipos de valor. En el
ejemplo

C#

class Test

static void Main() {

int i = 123;

int j = 123;

 System.Console.WriteLine((object)i == (object)j);

False se produce porque las conversiones crean referencias a dos instancias

independientes de valores de conversión boxing int .

Operadores de igualdad de cadenas

Los operadores de igualdad de cadena predefinidos son:

C#

bool operator ==(string x, string y);

bool operator !=(string x, string y);

Dos string valores se consideran iguales cuando se cumple una de las siguientes
condiciones:

Ambos valores son null .

Ambos valores son referencias no nulas a instancias de cadena que tienen
longitudes idénticas y caracteres idénticos en cada posición de carácter.

Los operadores de igualdad de cadena comparan valores de cadena en lugar de

referencias de cadena. Cuando dos instancias de cadena independientes contienen
exactamente la misma secuencia de caracteres, los valores de las cadenas son iguales,
pero las referencias son diferentes. Como se describe en operadores de igualdad de
tipos de referencia, los operadores de igualdad de tipos de referencia se pueden usar
para comparar referencias de cadena en lugar de valores de cadena.

Operadores de igualdad de delegado

Cada tipo de delegado proporciona implícitamente los siguientes operadores de
comparación predefinidos:

C#

bool operator ==(System.Delegate x, System.Delegate y);

bool operator !=(System.Delegate x, System.Delegate y);

Dos instancias de delegado se consideran iguales como se indica a continuación:

 Si alguna de las instancias de delegado es null , son iguales si y solo si ambos son
null .
Si los delegados tienen un tipo diferente en tiempo de ejecución, nunca son
iguales.
Si ambas instancias de delegado tienen una lista de invocaciones (declaraciones de
delegado), esas instancias son iguales si y solo si sus listas de invocación tienen la
misma longitud, y cada entrada de una lista de invocación de una de ellas es igual
(tal como se define a continuación) a la entrada correspondiente, en orden, en la
lista de invocación de otro.

Las siguientes reglas rigen la igualdad de las entradas de la lista de invocación:

Si dos entradas de la lista de invocación hacen referencia al mismo método

estático, las entradas son iguales.
Si dos entradas de la lista de invocación hacen referencia al mismo método no
estático en el mismo objeto de destino (tal y como se define en los operadores de
igualdad de referencia), las entradas son iguales.
Las entradas de la lista de invocación generadas a partir de la evaluación de
anonymous_method_expression s o lambda_expression con el mismo conjunto
(posiblemente vacío) de las instancias de variables externas capturadas están
permitidas (pero no necesarias).

Operadores de igualdad y null

Los == != operadores y permiten que un operando sea un valor de un tipo que acepta
valores NULL y el otro para ser el null literal, incluso si no existe ningún operador
predefinido o definido por el usuario (en formato sin elevación o elevado) para la
operación.

Para una operación de uno de los formularios

C#

x == null

null == x

x != null

null != x

donde x es una expresión de un tipo que acepta valores NULL, si la resolución de

sobrecarga del operador (resolución de sobrecarga del operador binario) no encuentra
un operador aplicable, el resultado se calcula en su lugar a partir de la HasValue
propiedad de x . En concreto, las dos primeras formas se traducen en !x.HasValue y se
traducen las dos últimas x.HasValue .

El operador is
El is operador se usa para comprobar dinámicamente si el tipo en tiempo de ejecución
de un objeto es compatible con un tipo determinado. El resultado de la operación E is
T , donde E es una expresión y T es un tipo, es un valor booleano que indica si se E

puede convertir correctamente al tipo T mediante una conversión de referencia, una

conversión boxing o una conversión unboxing. La operación se evalúa como sigue,
después de que se hayan sustituido los argumentos de tipo para todos los parámetros
de tipo:

Si E es una función anónima, se produce un error en tiempo de compilación

Si E es un grupo de métodos o el null literal, si el tipo de E es un tipo de
referencia o un tipo que acepta valores NULL y el valor de E es null, el resultado es
false.
En caso contrario, deje que D represente el tipo dinámico de de la E siguiente
manera:
Si el tipo de E es un tipo de referencia, D es el tipo en tiempo de ejecución de
la referencia de instancia de E .
Si el tipo de E es un tipo que acepta valores NULL, D es el tipo subyacente de
ese tipo que acepta valores NULL.
Si el tipo de E es un tipo de valor que no acepta valores NULL, D es el tipo de
E .
El resultado de la operación depende de y de la manera D T siguiente:
Si T es un tipo de referencia, el resultado es true si D y T son del mismo tipo, si
D es un tipo de referencia y una conversión de referencia implícita de D a T
EXISTS, o si D es un tipo de valor y una conversión boxing de D a T EXISTS.
Si T es un tipo que acepta valores NULL, el resultado es true si D es el tipo
subyacente de T .
Si T es un tipo de valor que no acepta valores NULL, el resultado es true si D y
T son del mismo tipo.
De lo contrario, el resultado es false.

Tenga en cuenta que las conversiones definidas por el usuario no se tienen en cuenta
por el is operador.

El operador as
El as operador se usa para convertir explícitamente un valor en un tipo de referencia
determinado o un tipo que acepta valores NULL. A diferencia de una expresión de
conversión (expresiones de conversión), el as operador nunca produce una excepción.
En su lugar, si la conversión indicada no es posible, el valor resultante es null .

En una operación del formulario E as T , E debe ser una expresión y T debe ser un
tipo de referencia, un parámetro de tipo conocido como un tipo de referencia o un tipo
que acepta valores NULL. Además, al menos uno de los siguientes debe ser true o, de lo
contrario, se producirá un error en tiempo de compilación:

Una identidad (conversión de identidad), implícita que acepta valores NULL

(conversiones implícitas que aceptan valores NULL), referencia implícita
(conversiones dereferencias implícitas), conversión boxing (conversiones boxing),
conversión explícita de valores NULL (conversionesexplícitas que aceptan valores
NULL), referencia explícita (conversiones dereferencia explícita) o conversión
unboxing (conversionesunboxing) de E a T .
El tipo de E o T es un tipo abierto.
E es el null literal.

Si el tipo en tiempo de compilación de E no es dynamic , la operación E as T produce

el mismo resultado que

C#

E is T ? (T)(E) : (T)null

salvo que E solo se evalúa una vez. Se puede esperar que el compilador optimice E as
T para realizar como máximo una comprobación de tipos dinámicos en lugar de las dos

comprobaciones de tipos dinámicos implícitas por la expansión anterior.

Si el tipo en tiempo de compilación de E es dynamic , a diferencia del operador de

conversión, el as operador no está enlazado dinámicamente (enlace dinámico). Por lo
tanto, la expansión en este caso es:

C#

E is T ? (T)(object)(E) : (T)null

Tenga en cuenta que algunas conversiones, como las conversiones definidas por el
usuario, no son posibles con el as operador y deben realizarse en su lugar mediante
expresiones de conversión.
En el ejemplo

C#

class X

public string F(object o) {

return o as string; // OK, string is a reference type

public T G<T>(object o) where T: Attribute {

return o as T; // Ok, T has a class constraint

public U H<U>(object o) {

return o as U; // Error, U is unconstrained

T se sabe que el parámetro de tipo de G es un tipo de referencia, porque tiene la

restricción de clase. U Sin embargo, el parámetro de tipo de H no es; por lo tanto, no se

permite el uso del as operador en H .

Operadores lógicos
Los & ^ operadores, y | se denominan operadores lógicos.

antlr

and_expression

: equality_expression

| and_expression '&' equality_expression

exclusive_or_expression

: and_expression

| exclusive_or_expression '^' and_expression

inclusive_or_expression

: exclusive_or_expression

| inclusive_or_expression '|' exclusive_or_expression

Si un operando de un operador lógico tiene el tipo en tiempo de compilación dynamic ,

la expresión está enlazada dinámicamente (enlace dinámico). En este caso, el tipo en
tiempo de compilación de la expresión es dynamic y la resolución que se describe a
continuación se realiza en tiempo de ejecución mediante el tipo en tiempo de ejecución
de los operandos que tienen el tipo en tiempo de compilación dynamic .

En el caso de una operación con el formato x op y , donde op es uno de los

operadores lógicos, se aplica la resolución de sobrecarga (resolución de sobrecarga del
operador binario) para seleccionar una implementación de operador específica. Los
operandos se convierten en los tipos de parámetro del operador seleccionado y el tipo
del resultado es el tipo de valor devuelto del operador.

En las secciones siguientes se describen los operadores lógicos predefinidos.

Operadores lógicos enteros

Los operadores lógicos de enteros predefinidos son:

C#

int operator &(int x, int y);

uint operator &(uint x, uint y);

long operator &(long x, long y);

ulong operator &(ulong x, ulong y);

int operator |(int x, int y);

uint operator |(uint x, uint y);

long operator |(long x, long y);

ulong operator |(ulong x, ulong y);

int operator ^(int x, int y);

uint operator ^(uint x, uint y);

long operator ^(long x, long y);

ulong operator ^(ulong x, ulong y);

El & operador calcula el lógico bit AND a bit de los dos operandos, el | operador calcula
el operador lógico bit OR a bit de los dos operandos y el ^ operador calcula la lógica
exclusiva bit OR a bit de los dos operandos. No es posible realizar desbordamientos en
estas operaciones.

Operadores lógicos de enumeración

Cada tipo de enumeración E proporciona implícitamente los siguientes operadores
lógicos predefinidos:

C#
 E operator &(E x, E y);

E operator |(E x, E y);

E operator ^(E x, E y);

El resultado de evaluar x op y , donde x y y son expresiones de un tipo de

enumeración E con un tipo subyacente U , y op es uno de los operadores lógicos, es
exactamente igual que evaluar (E)((U)x op (U)y) . En otras palabras, los operadores
lógicos de tipo de enumeración simplemente realizan la operación lógica en el tipo
subyacente de los dos operandos.

Operadores lógicos booleanos

Los operadores lógicos booleanos predefinidos son:

C#

bool operator &(bool x, bool y);

bool operator |(bool x, bool y);

bool operator ^(bool x, bool y);

El resultado de x & y es true si tanto x como y son true . De lo contrario, el resultado

es false .

El resultado de x | y es true si x o y es true . De lo contrario, el resultado es false .

El resultado de x ^ y es true si x es true y y es false , o x es false y y es true .

De lo contrario, el resultado es false . Cuando los operandos son de tipo bool , el ^
operador calcula el mismo resultado que el != operador.

Operadores lógicos booleanos que aceptan valores NULL

El tipo Boolean que acepta valores NULL bool? puede representar tres valores,, true
false y null , y es conceptualmente similar al tipo de tres valores que se usa para las

Expresiones booleanas en SQL. Para asegurarse de que los resultados generados por los
& | operadores y para los bool? operandos son coherentes con la lógica de tres
valores de SQL, se proporcionan los siguientes operadores predefinidos:

C#

bool? operator &(bool? x, bool? y);

bool? operator |(bool? x, bool? y);

En la tabla siguiente se enumeran los resultados generados por estos operadores para
todas las combinaciones de los valores true , false y null .

x y x & y x | y

true true true true

true false false true

true null null true

false true false true

false false false false

false null false null

null true null true

null false false null

null null null null

Operadores lógicos condicionales

Los operadores && y || se denominan operadores lógicos condicionales. También se
denominan operadores lógicos "de cortocircuito".

antlr

conditional_and_expression

: inclusive_or_expression

| conditional_and_expression '&&' inclusive_or_expression

conditional_or_expression

: conditional_and_expression

| conditional_or_expression '||' conditional_and_expression

Los && || operadores y son versiones condicionales de & los | operadores y:

La operación x && y corresponde a la operación x & y , salvo que y solo se

evalúa si x no es false .
La operación x || y corresponde a la operación x | y , salvo que y solo se
evalúa si x no es true .
Si un operando de un operador lógico condicional tiene el tipo en tiempo de
compilación dynamic , la expresión está enlazada dinámicamente (enlace dinámico). En
este caso, el tipo en tiempo de compilación de la expresión es dynamic y la resolución
que se describe a continuación se realiza en tiempo de ejecución mediante el tipo en
tiempo de ejecución de los operandos que tienen el tipo en tiempo de compilación
dynamic .

Una operación con el formato x && y o x || y se procesa aplicando la resolución de

sobrecarga (resolución de sobrecarga del operador binario) como si la operación se
hubiera escrito x & y o x | y . A continuación,

Si la resolución de sobrecarga no encuentra un único operador mejor, o si la

resolución de sobrecarga selecciona uno de los operadores lógicos de enteros
predefinidos, se produce un error en tiempo de enlace.
De lo contrario, si el operador seleccionado es uno de los operadores lógicos
booleanos predefinidos (operadores lógicos booleanos) o los operadores lógicos
booleanos que aceptan valores NULL (operadores lógicosbooleanos que aceptan
valores NULL), la operación se procesa como se describe en operadores lógicos
condicionales booleanos.
De lo contrario, el operador seleccionado es un operador definido por el usuario y
la operación se procesa como se describe en operadores lógicos condicionales
definidos por el usuario.

No es posible sobrecargar directamente los operadores lógicos condicionales. Sin

embargo, dado que los operadores lógicos condicionales se evalúan en términos de los
operadores lógicos normales, las sobrecargas de los operadores lógicos normales son,
con ciertas restricciones, que también se consideran sobrecargas de los operadores
lógicos condicionales. Esto se describe con más detalle en operadores lógicos
condicionales definidos por el usuario.

Operadores lógicos condicionales booleanos

Cuando los operandos de && o || son de tipo bool , o cuando los operandos son de
tipos que no definen un aplicable operator & o operator | , pero definen conversiones
implícitas en bool , la operación se procesa de la siguiente manera:

La operación x && y se evalúa como x ? y : false . En otras palabras, x se

evalúa primero y se convierte al tipo bool . Después, si x es true , y se evalúa y
se convierte al tipo bool , y se convierte en el resultado de la operación. De lo
contrario, el resultado de la operación es false .
 La operación x || y se evalúa como x ? true : y . En otras palabras, x se evalúa
primero y se convierte al tipo bool . Después, si x es true , el resultado de la
operación es true . De lo contrario, y se evalúa y se convierte al tipo bool , y se
convierte en el resultado de la operación.

Operadores lógicos condicionales definidos por el

usuario
Cuando los operandos de && o || son de tipos que declaran un o definido por
operator & el usuario aplicable, deben cumplirse operator | las dos condiciones
siguientes, donde T es el tipo en el que se declara el operador seleccionado:

El tipo de valor devuelto y el tipo de cada parámetro del operador seleccionado

deben ser T . En otras palabras, el operador debe calcular la lógica AND or lógica
OR de dos operandos de tipo T y debe devolver un resultado de tipo T .

T debe contener declaraciones de operator true y operator false .

Se produce un error en tiempo de enlace si no se cumple alguno de estos requisitos. De

lo contrario, la && || operación OR se evalúa combinando el definido por el usuario
operator true o operator false con el operador definido por el usuario seleccionado:

La operación x && y se evalúa como T.false(x) ? x : T.&(x, y) , donde

T.false(x) es una invocación del operator false declarado en T , y T.&(x, y) es
una invocación del seleccionado operator & . En otras palabras, x se evalúa
primero y operator false se invoca en el resultado para determinar si x es false
definitivamente. Después, si x es definitivamente false, el resultado de la
operación es el valor previamente calculado para x . De lo contrario, y se evalúa y
el seleccionado operator & se invoca en el valor calculado previamente para x y el
valor calculado para y para generar el resultado de la operación.
La operación x || y se evalúa como T.true(x) ? x : T.|(x, y) , donde
T.true(x) es una invocación del operator true declarado en T , y T.|(x,y) es

una invocación del seleccionado operator| . En otras palabras, x se evalúa

primero y operator true se invoca en el resultado para determinar si x es true
definitivamente. A continuación, si x es true definitivamente, el resultado de la
operación es el valor previamente calculado para x . De lo contrario, y se evalúa y
el seleccionado operator | se invoca en el valor calculado previamente para x y el
valor calculado para y para generar el resultado de la operación.
En cualquiera de estas operaciones, la expresión proporcionada por x solo se evalúa
una vez, y la expresión proporcionada por y no se evalúa ni se evalúa exactamente una
vez.

Para obtener un ejemplo de un tipo que implementa operator true y operator false ,
vea Database Boolean Type.

Operador de uso combinado de NULL

El ?? operador se denomina operador de uso combinado de NULL.

antlr

null_coalescing_expression

: conditional_or_expression

| conditional_or_expression '??' null_coalescing_expression

Una expresión de fusión nula del formulario a ?? b requiere a que sea de un tipo que
acepte valores NULL o un tipo de referencia. Si a no es null, el resultado de a ?? b es a
; de lo contrario, el resultado es b . La operación b solo se evalúa si a es NULL.

El operador de uso combinado de NULL es asociativo a la derecha, lo que significa que

las operaciones se agrupan de derecha a izquierda. Por ejemplo, una expresión con el
formato a ?? b ?? c se evalúa como a ?? (b ?? c) . En términos generales, una
expresión con el formato E1 ?? E2 ?? ... ?? En devuelve el primero de los operandos
que no son NULL, o null si todos los operandos son NULL.

El tipo de la expresión a ?? b depende de las conversiones implícitas que están

disponibles en los operandos. En orden de preferencia, el tipo de a ?? b es A0 , A o B ,
donde A es el tipo de a (siempre que a tenga un tipo), B es el tipo de b (siempre que
b tenga un tipo) y A0 es el tipo subyacente de A si A es un tipo que acepta valores
NULL, o de A lo contrario. En concreto, a ?? b se procesa de la siguiente manera:

Si A existe y no es un tipo que acepta valores NULL o un tipo de referencia, se

produce un error en tiempo de compilación.
Si b es una expresión dinámica, el tipo de resultado es dynamic . En tiempo de
ejecución, a se evalúa primero. Si a no es null, a se convierte en dinámico y se
convierte en el resultado. De lo contrario, b se evalúa y se convierte en el
resultado.
 De lo contrario, si A existe y es un tipo que acepta valores NULL y existe una
conversión implícita de b a A0 , el tipo de resultado es A0 . En tiempo de
ejecución, a se evalúa primero. Si a no es null, a se desencapsulará en A0 el tipo
y se convertirá en el resultado. De lo contrario, b se evalúa y se convierte al tipo
A0 , y se convierte en el resultado.

De lo contrario, si A existe y existe una conversión implícita de b a A , el tipo de

resultado es A . En tiempo de ejecución, a se evalúa primero. Si a no es null, a se
convierte en el resultado. De lo contrario, b se evalúa y se convierte al tipo A , y se
convierte en el resultado.
De lo contrario, si b tiene un tipo B y existe una conversión implícita de a a B , el
tipo de resultado es B . En tiempo de ejecución, a se evalúa primero. Si a no es
null, a se desencapsulará en A0 el tipo (si A existe y acepta valores NULL) y se
convertirá al tipo, lo que se B convierte en el resultado. De lo contrario, b se
evalúa y se convierte en el resultado.
De lo contrario, a y b son incompatibles y se produce un error en tiempo de
compilación.

Operador condicional
El ?: operador se denomina operador condicional. En ocasiones también se denomina
operador ternario.

antlr

conditional_expression

: null_coalescing_expression

| null_coalescing_expression '?' expression ':' expression

Una expresión condicional del formulario b ? x : y evalúa primero la condición b .

Después, si b es true , x se evalúa y se convierte en el resultado de la operación. De lo
contrario, y se evalúa y se convierte en el resultado de la operación. Una expresión
condicional nunca evalúa x y y .

El operador condicional es asociativo a la derecha, lo que significa que las operaciones

se agrupan de derecha a izquierda. Por ejemplo, una expresión con el formato a ? b :
c ? d : e se evalúa como a ? b : (c ? d : e) .

El primer operando del ?: operador debe ser una expresión que se pueda convertir
implícitamente a bool , o una expresión de un tipo que implemente operator true . Si
no se cumple ninguno de estos requisitos, se produce un error en tiempo de
compilación.

Los operandos segundo y tercero, x y y , del ?: operador controlan el tipo de la

expresión condicional.

Si x tiene el tipo X y y tiene el tipo Y , entonces

Si existe una conversión implícita (conversiones implícitas) de X a Y , pero no
de Y a X , entonces Y es el tipo de la expresión condicional.
Si existe una conversión implícita (conversiones implícitas) de Y a X , pero no
de X a Y , entonces X es el tipo de la expresión condicional.
De lo contrario, no se puede determinar ningún tipo de expresión y se produce
un error en tiempo de compilación.
Si solo uno de x y y tiene un tipo, y x y y , de se pueden convertir
implícitamente a ese tipo, es el tipo de la expresión condicional.
De lo contrario, no se puede determinar ningún tipo de expresión y se produce un
error en tiempo de compilación.

El procesamiento en tiempo de ejecución de una expresión condicional con el formato b

? x : y consta de los siguientes pasos:

En primer lugar, b se evalúa y bool se determina el valor de b :

Si una conversión implícita del tipo de b bool existe, esta conversión implícita
se realiza para generar un bool valor.
De lo contrario, el operator true definido por el tipo de b se invoca para
generar un bool valor.
Si el bool valor generado por el paso anterior es true , x se evalúa y se convierte
al tipo de la expresión condicional y se convierte en el resultado de la expresión
condicional.
De lo contrario, y se evalúa y se convierte al tipo de la expresión condicional y se
convierte en el resultado de la expresión condicional.

Expresiones de funciones anónimas

Una función anónima es una expresión que representa una definición de método "en
línea". Una función anónima no tiene un valor o un tipo en y de sí mismo, pero se
pueden convertir en un tipo de árbol de expresión o delegado compatible. La
evaluación de una conversión de función anónima depende del tipo de destino de la
conversión: si es un tipo de delegado, la conversión se evalúa como un valor de
delegado que hace referencia al método que define la función anónima. Si es un tipo de
árbol de expresión, la conversión se evalúa como un árbol de expresión que representa
la estructura del método como una estructura de objeto.

Por motivos históricos, hay dos tipos sintácticos de funciones anónimas, es decir,
lambda_expression s y anonymous_method_expression s. Para casi todos los propósitos,
lambda_expression s son más concisos y expresivos que anonymous_method_expression
s, que permanecen en el lenguaje por compatibilidad con versiones anteriores.

antlr

lambda_expression

: anonymous_function_signature '=>' anonymous_function_body

anonymous_method_expression

: 'delegate' explicit_anonymous_function_signature? block

anonymous_function_signature

: explicit_anonymous_function_signature

| implicit_anonymous_function_signature

explicit_anonymous_function_signature

: '(' explicit_anonymous_function_parameter_list? ')'

explicit_anonymous_function_parameter_list

: explicit_anonymous_function_parameter (','
explicit_anonymous_function_parameter)*

explicit_anonymous_function_parameter

: anonymous_function_parameter_modifier? type identifier

anonymous_function_parameter_modifier

: 'ref'

| 'out'

implicit_anonymous_function_signature

: '(' implicit_anonymous_function_parameter_list? ')'

| implicit_anonymous_function_parameter

implicit_anonymous_function_parameter_list

: implicit_anonymous_function_parameter (','
implicit_anonymous_function_parameter)*

implicit_anonymous_function_parameter

 : identifier

anonymous_function_body

: expression

| block

El => operador tiene la misma prioridad que la asignación ( = ) y es asociativo a la

derecha.

Una función anónima con el async modificador es una función asincrónica y sigue las
reglas descritas en funciones asincrónicas.

Los parámetros de una función anónima en forma de lambda_expression se pueden

escribir explícita o implícitamente. En una lista de parámetros con tipo explícito, se
indica explícitamente el tipo de cada parámetro. En una lista de parámetros con tipos
implícitos, los tipos de los parámetros se deducen del contexto en el que se produce la
función anónima; en concreto, cuando la función anónima se convierte en un tipo de
delegado o un tipo de árbol de expresión compatible, ese tipo proporciona los tipos de
parámetro (conversiones de funciones anónimas).

En una función anónima con un solo parámetro con tipo implícito, los paréntesis se
pueden omitir en la lista de parámetros. En otras palabras, una función anónima con el
formato

C#

( param ) => expr

se puede abreviar como

C#

param => expr

La lista de parámetros de una función anónima en forma de un

anonymous_method_expression es opcional. Si se especifica, los parámetros se deben
escribir explícitamente. En caso contrario, la función anónima se convertirá en un
delegado con cualquier lista de parámetros que no contenga out parámetros.

Se puede tener acceso al cuerpo de un bloque de una función anónima (puntos de

conexión y disponibilidad) a menos que la función anónima se encuentre dentro de una
instrucción inalcanzable.
A continuación se muestran algunos ejemplos de funciones anónimas:

C#

x => x + 1 // Implicitly typed, expression body

x => { return x + 1; } // Implicitly typed, statement body

(int x) => x + 1 // Explicitly typed, expression body

(int x) => { return x + 1; } // Explicitly typed, statement body

(x, y) => x * y // Multiple parameters

() => Console.WriteLine() // No parameters

async (t1,t2) => await t1 + await t2 // Async

delegate (int x) { return x + 1; } // Anonymous method expression

delegate { return 1 + 1; } // Parameter list omitted

El comportamiento de lambda_expression s y anonymous_method_expression s es el

mismo, salvo los siguientes puntos:

anonymous_method_expression s permiten omitir completamente la lista de

parámetros, lo que produce Convertibility para delegar tipos de cualquier lista de
parámetros de valor.
lambda_expression s permiten omitir e inferir los tipos de parámetro, mientras que
anonymous_method_expression s requieren que se indiquen explícitamente los
tipos de parámetro.
El cuerpo de una lambda_expression puede ser una expresión o un bloque de
instrucciones, mientras que el cuerpo de una anonymous_method_expression debe
ser un bloque de instrucciones.
Solo lambda_expression s tienen conversiones a tipos de árbol de expresión
compatibles (tipos de árbol de expresión).

Firmas de funciones anónimas

El anonymous_function_signature opcional de una función anónima define los nombres
y, opcionalmente, los tipos de los parámetros formales de la función anónima. El ámbito
de los parámetros de la función anónima es el anonymous_function_body. (Ámbitos)
Junto con la lista de parámetros (si se especifica), el cuerpo del método anónimo
constituye un espacio de declaración (declaraciones). Por lo tanto, es un error en tiempo
de compilación que el nombre de un parámetro de la función anónima coincida con el
nombre de una variable local, una constante local o un parámetro cuyo ámbito incluya
el anonymous_method_expression o lambda_expression.

Si una función anónima tiene un explicit_anonymous_function_signature, el conjunto de

tipos de delegado compatibles y los tipos de árbol de expresión están restringidos a los
que tienen los mismos tipos de parámetros y modificadores en el mismo orden. A
diferencia de las conversiones de grupos de métodos (conversiones de grupos de
métodos), no se admite la varianza de tipos de parámetros de función anónimos. Si una
función anónima no tiene un anonymous_function_signature, el conjunto de tipos de
delegado compatibles y tipos de árbol de expresión está restringido a los que no tienen
out parámetros.

Tenga en cuenta que un anonymous_function_signature no puede incluir atributos o una

matriz de parámetros. No obstante, un anonymous_function_signature puede ser
compatible con un tipo de delegado cuya lista de parámetros contiene una matriz de
parámetros.

Tenga en cuenta también que la conversión a un tipo de árbol de expresión, incluso si es

compatible, todavía puede producir un error en tiempo de compilación (tipos de árbol
de expresión).

Cuerpos de función anónimos

El cuerpo (expresión o bloque) de una función anónima está sujeto a las siguientes
reglas:

Si la función anónima incluye una firma, los parámetros especificados en la firma

están disponibles en el cuerpo. Si la función anónima no tiene ninguna firma, se
puede convertir en un tipo de delegado o tipo de expresión con parámetros
(conversiones de funciones anónimas), pero no se puede tener acceso a los
parámetros en el cuerpo.
A excepción de los ref out parámetros o especificados en la firma (si existen) de
la función anónima envolvente más cercana, se trata de un error en tiempo de
compilación para que el cuerpo tenga acceso a un ref out parámetro o.
Cuando el tipo de this es un tipo de estructura, es un error en tiempo de
compilación para que el cuerpo tenga acceso this . Esto es así si el acceso es
explícito (como en this.x ) o implícito (como en x donde x es un miembro de
instancia de la estructura). Esta regla simplemente prohíbe el acceso y no afecta a
si la búsqueda de miembros da como resultado un miembro de la estructura.
El cuerpo tiene acceso a las variables externas (variables externas) de la función
anónima. El acceso de una variable externa hará referencia a la instancia de la
variable que está activa en el momento en que se evalúa el lambda_expression o
anonymous_method_expression (evaluación de expresiones de función anónimas).
Es un error en tiempo de compilación que el cuerpo contenga una instrucción
goto , una break instrucción o una continue instrucción cuyo destino esté fuera

del cuerpo o dentro del cuerpo de una función anónima contenida.

Una return instrucción del cuerpo devuelve el control de una invocación de la
función anónima envolvente más cercana, no del miembro de función envolvente.
 Una expresión especificada en una return instrucción se debe poder convertir
implícitamente al tipo de valor devuelto del tipo de delegado o del tipo de árbol
de expresión al que se convierte el lambda_expression o
anonymous_method_expression más próximo (conversiones de función anónima).

No se especifica explícitamente si hay alguna manera de ejecutar el bloque de una

función anónima que no sea a través de la evaluación y la invocación del
lambda_expression o anonymous_method_expression. En concreto, el compilador puede
optar por implementar una función anónima mediante la sintetización de uno o varios
métodos o tipos con nombre. Los nombres de estos elementos sintetizados deben tener
un formato reservado para el uso del compilador.

Resolución de sobrecarga y funciones anónimas

Las funciones anónimas de una lista de argumentos participan en la inferencia de tipos y
en la resolución de sobrecarga. Consulte la inferencia de tipos y la resolución de
sobrecargas para ver las reglas exactas.

En el ejemplo siguiente se muestra el efecto de las funciones anónimas en la resolución

de sobrecarga.

C#

class ItemList<T>: List<T>

public int Sum(Func<T,int> selector) {

int sum = 0;

foreach (T item in this) sum += selector(item);

return sum;

public double Sum(Func<T,double> selector) {

double sum = 0;
foreach (T item in this) sum += selector(item);

return sum;

La ItemList<T> clase tiene dos Sum métodos. Cada toma un selector argumento, que
extrae el valor que se va a sumar de un elemento de lista. El valor extraído puede ser
int o, double y la suma resultante también es int o double .

Los Sum métodos se pueden utilizar, por ejemplo, para calcular las sumas de una lista de
líneas de detalle en un pedido.
 C#

class Detail

public int UnitCount;

public double UnitPrice;

...

void ComputeSums() {

ItemList<Detail> orderDetails = GetOrderDetails(...);

int totalUnits = orderDetails.Sum(d => d.UnitCount);

double orderTotal = orderDetails.Sum(d => d.UnitPrice * d.UnitCount);

...

En la primera invocación de orderDetails.Sum , ambos Sum métodos son aplicables

porque la función anónima d => d. UnitCount es compatible con Func<Detail,int> y
Func<Detail,double> . Sin embargo, la resolución de sobrecarga selecciona el primer
Sum método porque la conversión a Func<Detail,int> es mejor que la conversión a

Func<Detail,double> .

En la segunda invocación de orderDetails.Sum , solo el segundo Sum método es

aplicable porque la función anónima d => d.UnitPrice * d.UnitCount genera un valor
de tipo double . Por lo tanto, la resolución de sobrecarga elige el segundo Sum método
para esa invocación.

Funciones anónimas y enlace dinámico

Una función anónima no puede ser un receptor, un argumento o un operando de una
operación enlazada dinámicamente.

Variables externas
Cualquier variable local, parámetro de valor o matriz de parámetros cuyo ámbito incluya
el lambda_expression o anonymous_method_expression se denomina una variable
externa de la función anónima. En un miembro de función de instancia de una clase, el
this valor se considera un parámetro de valor y es una variable externa de cualquier

función anónima incluida dentro del miembro de función.

Variables externas capturadas

Cuando una función anónima hace referencia a una variable externa, se dice que la
función anónima ha capturado la variable externa. Normalmente, la duración de una
variable local se limita a la ejecución del bloque o la instrucción con la que está asociada
(variables locales). Sin embargo, la duración de una variable externa capturada se
extiende al menos hasta que el delegado o el árbol de expresión creado a partir de la
función anónima sea válido para la recolección de elementos no utilizados.

En el ejemplo

C#

using System;

delegate int D();

class Test

static D F() {

int x = 0;

D result = () => ++x;

return result;

static void Main() {

D d = F();

Console.WriteLine(d());

Console.WriteLine(d());

Console.WriteLine(d());

la x función anónima captura la variable local y la duración de x se extiende al menos

hasta que el delegado devuelto F por se pueda seleccionar para la recolección de
elementos no utilizados (que no se produce hasta el final del programa). Dado que cada
invocación de la función anónima funciona en la misma instancia de x , el resultado del
ejemplo es:

Consola

Cuando una función anónima captura una variable local o un parámetro de valor, la
variable local o el parámetro ya no se considera una variable fija (variables fijas y
móviles), sino que se considera una variable móvil. Por lo tanto, cualquier unsafe código
que toma la dirección de una variable externa capturada debe usar primero la fixed
instrucción para corregir la variable.

Tenga en cuenta que, a diferencia de una variable no capturada, una variable local
capturada se puede exponer simultáneamente a varios subprocesos de ejecución.

Creación de instancias de variables locales

Se considera que se crea una instancia de una variable local cuando la ejecución entra
en el ámbito de la variable. Por ejemplo, cuando se invoca el método siguiente, x se
crea una instancia de la variable local y se inicializa tres veces, una vez para cada
iteración del bucle.

C#

static void F() {

for (int i = 0; i < 3; i++) {

int x = i * 2 + 1;

...

Sin embargo, mover la declaración de x fuera del bucle produce una única creación de
instancias de x :

C#

static void F() {

int x;

for (int i = 0; i < 3; i++) {

x = i * 2 + 1;

...

Cuando no se capturan, no hay forma de observar exactamente la frecuencia con la que

se crea una instancia de una variable local, ya que las duraciones de las instancias no se
pueden usar para que cada creación de instancias use simplemente la misma ubicación
de almacenamiento. Sin embargo, cuando una función anónima captura una variable
local, los efectos de la creación de instancias se hacen evidentes.

En el ejemplo

C#
 using System;

delegate void D();

class Test

static D[] F() {

D[] result = new D[3];

for (int i = 0; i < 3; i++) {

int x = i * 2 + 1;

result[i] = () => { Console.WriteLine(x); };

return result;

static void Main() {

foreach (D d in F()) d();

genera el resultado:

Consola

Sin embargo, cuando la declaración de x se mueve fuera del bucle:

C#

static D[] F() {

D[] result = new D[3];

int x;

for (int i = 0; i < 3; i++) {

x = i * 2 + 1;

result[i] = () => { Console.WriteLine(x); };

return result;

el resultado es:

Consola

Si un bucle for declara una variable de iteración, se considera que esa variable se declara
fuera del bucle. Por lo tanto, si se cambia el ejemplo para capturar la variable de
iteración en sí:

C#

static D[] F() {

D[] result = new D[3];

for (int i = 0; i < 3; i++) {

result[i] = () => { Console.WriteLine(i); };

return result;

solo se captura una instancia de la variable de iteración, que genera el resultado:

Consola

Es posible que los delegados de función anónimos compartan algunas variables

capturadas pero tengan instancias independientes de otras. Por ejemplo, si F se cambia
a

C#

static D[] F() {

D[] result = new D[3];

int x = 0;

for (int i = 0; i < 3; i++) {

int y = 0;

result[i] = () => { Console.WriteLine("{0} {1}", ++x, ++y); };

return result;

los tres delegados capturan la misma instancia de x , pero las instancias independientes
de y , y el resultado es:

Consola

1 1

2 1

3 1

Las funciones anónimas independientes pueden capturar la misma instancia de una

variable externa. En el ejemplo:

C#

using System;

delegate void Setter(int value);

delegate int Getter();

class Test

static void Main() {

int x = 0;

Setter s = (int value) => { x = value; };

Getter g = () => { return x; };

s(5);

Console.WriteLine(g());

s(10);

Console.WriteLine(g());

las dos funciones anónimas capturan la misma instancia de la variable local x y, por
tanto, pueden "comunicarse" a través de esa variable. La salida del ejemplo es:

Consola

10

Evaluación de expresiones de función anónimas

Una función anónima F siempre debe convertirse en un tipo de delegado D o en un
tipo E de árbol de expresión, ya sea directamente o a través de la ejecución de una
expresión de creación de delegado new D(F) . Esta conversión determina el resultado de
la función anónima, como se describe en conversiones de funciones anónimas.

Expresiones de consulta
Las expresiones de consulta proporcionan una sintaxis integrada de lenguaje para las
consultas que es similar a los lenguajes de consulta jerárquica y relacional, como SQL y
XQuery.
antlr

query_expression

: from_clause query_body

from_clause

: 'from' type? identifier 'in' expression

query_body

: query_body_clauses? select_or_group_clause query_continuation?

query_body_clauses

: query_body_clause

| query_body_clauses query_body_clause

query_body_clause

: from_clause

| let_clause

| where_clause

| join_clause

| join_into_clause

| orderby_clause

let_clause

: 'let' identifier '=' expression

where_clause

: 'where' boolean_expression

join_clause

: 'join' type? identifier 'in' expression 'on' expression 'equals'

expression

join_into_clause

: 'join' type? identifier 'in' expression 'on' expression 'equals'

expression 'into' identifier

orderby_clause

: 'orderby' orderings

orderings

: ordering (',' ordering)*

 ordering

: expression ordering_direction?

ordering_direction

: 'ascending'

| 'descending'

select_or_group_clause

: select_clause

| group_clause

select_clause

: 'select' expression

group_clause

: 'group' expression 'by' expression

query_continuation

: 'into' identifier query_body

Una expresión de consulta comienza con una from cláusula y termina con una select
group cláusula o. La from cláusula Initial puede ir seguida de cero o más from let

cláusulas,, where join o orderby . Cada from cláusula es un generador que introduce
una *variable de rango _ que va por los elementos de una secuencia _ * * *. Cada let
cláusula presenta una variable de rango que representa un valor calculado por medio de
las variables de rango anteriores. Cada where cláusula es un filtro que excluye
elementos del resultado. Cada join cláusula compara las claves especificadas de la
secuencia de origen con claves de otra secuencia, produciendo pares coincidentes. Cada
orderby cláusula reordena los elementos según los criterios especificados. La select

cláusula final o group especifica la forma del resultado en términos de las variables de
rango. Por último, into se puede usar una cláusula para "Insertar" consultas tratando
los resultados de una consulta como un generador en una consulta posterior.

Ambigüedades en expresiones de consulta

Las expresiones de consulta contienen una serie de "palabras clave contextuales", es
decir, identificadores que tienen un significado especial en un contexto determinado. En
concreto, se trata from de,, where join , on , equals , into , let , orderby , ascending
,, descending select group y by . Para evitar ambigüedades en las expresiones de
consulta producidas por el uso mixto de estos identificadores como palabras clave o
nombres simples, estos identificadores se consideran palabras clave cuando se
producen en cualquier parte de una expresión de consulta.

Para este propósito, una expresión de consulta es cualquier expresión que empiece por
" from identifier " seguido de cualquier token excepto " ; ", " = " o " , ".

Para usar estas palabras como identificadores dentro de una expresión de consulta, se
les puede anteponer " @ " (identificadores).

Traducción de expresiones de consulta

El lenguaje C# no especifica la semántica de ejecución de las expresiones de consulta.
En su lugar, las expresiones de consulta se convierten en invocaciones de métodos que
se adhieren al patrón de expresión de consulta (el patrón de expresión de consulta). En
concreto, las expresiones de consulta se convierten en invocaciones de métodos
denominados Where ,, Select SelectMany , Join , GroupJoin , OrderBy ,
OrderByDescending , ThenBy , ThenByDescending , GroupBy y Cast . Se espera que estos

métodos tengan firmas concretas y tipos de resultado, como se describe en el patrón de

expresión de consulta. Estos métodos pueden ser métodos de instancia del objeto que
se consulta o métodos de extensión que son externos al objeto e implementan la
ejecución real de la consulta.

La conversión de las expresiones de consulta a las invocaciones de método es una

asignación sintáctica que se produce antes de que se haya realizado cualquier enlace de
tipo o resolución de sobrecarga. Se garantiza que la conversión es sintácticamente
correcta, pero no se garantiza que genere código C# correcto semánticamente. Después
de la traducción de las expresiones de consulta, las invocaciones de método resultantes
se procesan como invocaciones de método regulares y esto puede a su vez detectar
errores, por ejemplo, si los métodos no existen, si los argumentos tienen tipos
incorrectos, o si los métodos son genéricos y se produce un error en la inferencia de
tipos.

Una expresión de consulta se procesa mediante la aplicación repetida de las siguientes

traducciones hasta que no se puedan realizar más reducciones. Las traducciones se
muestran por orden de aplicación: cada sección presupone que las traducciones de las
secciones anteriores se han realizado de forma exhaustiva y, una vez agotadas, una
sección no se volverá a visitar posteriormente en el procesamiento de la misma
expresión de consulta.

No se permite la asignación a variables de rango en expresiones de consulta. Sin

embargo, se permite que una implementación de C# no siempre aplique esta
restricción, ya que a veces esto no es posible con el esquema de traducción sintáctica
que se muestra aquí.

Ciertas traducciones insertan variables de rango con identificadores transparentes

indicados por * . Las propiedades especiales de los identificadores transparentes se
tratan en profundidad en los identificadores transparentes.

Cláusulas SELECT y GroupBy con continuaciones

Expresión de consulta con una continuación

C#

from ... into x ...

se traduce en

C#

from x in ( from ... ) ...

Las traducciones de las secciones siguientes suponen que las consultas no tienen
ninguna into continuación.

En el ejemplo

C#

from c in customers

group c by c.Country into g

select new { Country = g.Key, CustCount = g.Count() }

se traduce en

C#

from g in

from c in customers
group c by c.Country

select new { Country = g.Key, CustCount = g.Count() }

la traducción final que es

C#
 customers.

GroupBy(c => c.Country).

Select(g => new { Country = g.Key, CustCount = g.Count() })

Tipos de variables de rango explícitas

Una from cláusula que especifica explícitamente un tipo de variable de rango

C#

from T x in e

se traduce en

C#

from x in ( e ) . Cast < T > ( )

Una join cláusula que especifica explícitamente un tipo de variable de rango

C#

join T x in e on k1 equals k2

se traduce en

C#

join x in ( e ) . Cast < T > ( ) on k1 equals k2

Las traducciones de las secciones siguientes suponen que las consultas no tienen tipos
de variable de intervalo explícitos.

En el ejemplo

C#

from Customer c in customers

where c.City == "London"

select c

se traduce en
 C#

from c in customers.Cast<Customer>()

where c.City == "London"

select c

la traducción final que es

C#

customers.

Cast<Customer>().

Where(c => c.City == "London")

Los tipos de variables de rango explícitos son útiles para consultar colecciones que
implementan la interfaz no genérica IEnumerable , pero no la IEnumerable<T> interfaz
genérica. En el ejemplo anterior, sería el caso si customers fuera de tipo ArrayList .

Expresiones de consulta degeneradas

Una expresión de consulta con el formato

C#

from x in e select x

se traduce en

C#

( e ) . Select ( x => x )

En el ejemplo

C#

from c in customers

select c

se traduce en

C#

customers.Select(c => c)

Una expresión de consulta degenerada es aquella que selecciona trivialmente los

elementos del origen. Una fase posterior de la traducción quita las consultas
degeneradas que se introdujeron en otros pasos de traducción mediante su origen. Sin
embargo, es importante asegurarse de que el resultado de una expresión de consulta
nunca sea el propio objeto de origen, ya que esto revelaría el tipo e identidad del origen
al cliente de la consulta. Por lo tanto, este paso protege las consultas degeneradas
escritas directamente en el código fuente mediante una llamada explícita Select en el
origen. A continuación, llega a los implementadores de Select y otros operadores de
consulta para asegurarse de que estos métodos nunca devuelven el propio objeto de
origen.

Cláusulas from, Let, Where, join y OrderBy

Expresión de consulta con una segunda from cláusula seguida de una select cláusula

C#

from x1 in e1

from x2 in e2

select v

se traduce en

C#

( e1 ) . SelectMany( x1 => e2 , ( x1 , x2 ) => v )

Expresión de consulta con una segunda from cláusula seguida de un valor distinto de
una select cláusula:

C#

from x1 in e1

from x2 in e2

...

se traduce en

C#

from * in ( e1 ) . SelectMany( x1 => e2 , ( x1 , x2 ) => new { x1 , x2 } )

...

Una expresión de consulta con una let cláusula

C#

from x in e

let y = f

...

se traduce en

C#

from * in ( e ) . Select ( x => new { x , y = f } )

...

Una expresión de consulta con una where cláusula

C#

from x in e

where f

...

se traduce en

C#

from x in ( e ) . Where ( x => f )

...

Expresión de consulta con una join cláusula sin un into seguido de una select
cláusula

C#

from x1 in e1

join x2 in e2 on k1 equals k2

select v

se traduce en

C#

( e1 ) . Join( e2 , x1 => k1 , x2 => k2 , ( x1 , x2 ) => v )

Expresión de consulta con una join cláusula sin un into seguido de un elemento
distinto de una select cláusula

C#

from x1 in e1

join x2 in e2 on k1 equals k2

...

se traduce en

C#

from * in ( e1 ) . Join( e2 , x1 => k1 , x2 => k2 , ( x1 , x2 ) => new { x1

, x2 })

...

Una expresión de consulta con una join cláusula con una into cláusula seguida de una
select cláusula

C#

from x1 in e1

join x2 in e2 on k1 equals k2 into g

select v

se traduce en

C#

( e1 ) . GroupJoin( e2 , x1 => k1 , x2 => k2 , ( x1 , g ) => v )

Una expresión de consulta con una join cláusula con un into seguido de un elemento
distinto de una select cláusula

C#

from x1 in e1

join x2 in e2 on k1 equals k2 into g

...

se traduce en

C#
 from * in ( e1 ) . GroupJoin( e2 , x1 => k1 , x2 => k2 , ( x1 , g ) => new {
x1 , g })

...

Expresión de consulta con una orderby cláusula

C#

from x in e

orderby k1 , k2 , ..., kn

...

se traduce en

C#

from x in ( e ) .

OrderBy ( x => k1 ) .

ThenBy ( x => k2 ) .

... .

ThenBy ( x => kn )

...

Si una cláusula de ordenación especifica un descending indicador de dirección, se

produce una invocación de OrderByDescending o ThenByDescending en su lugar.

Las siguientes traducciones suponen que no let hay where join orderby cláusulas, o,
ni más de una from cláusula inicial en cada expresión de consulta.

En el ejemplo

C#

from c in customers

from o in c.Orders

select new { c.Name, o.OrderID, o.Total }

se traduce en

C#

customers.

SelectMany(c => c.Orders,

(c,o) => new { c.Name, o.OrderID, o.Total }

En el ejemplo

C#

from c in customers

from o in c.Orders

orderby o.Total descending

select new { c.Name, o.OrderID, o.Total }

se traduce en

C#

from * in customers.

SelectMany(c => c.Orders, (c,o) => new { c, o })

orderby o.Total descending

select new { c.Name, o.OrderID, o.Total }

la traducción final que es

C#

customers.

SelectMany(c => c.Orders, (c,o) => new { c, o }).

OrderByDescending(x => x.o.Total).

Select(x => new { x.c.Name, x.o.OrderID, x.o.Total })

donde x es un identificador generado por el compilador que, de lo contrario, es

invisible e inaccesible.

En el ejemplo

C#

from o in orders

let t = o.Details.Sum(d => d.UnitPrice * d.Quantity)

where t >= 1000

select new { o.OrderID, Total = t }

se traduce en

C#

from * in orders.

Select(o => new { o, t = o.Details.Sum(d => d.UnitPrice * d.Quantity) })

where t >= 1000

select new { o.OrderID, Total = t }

la traducción final que es

C#

orders.

Select(o => new { o, t = o.Details.Sum(d => d.UnitPrice * d.Quantity) }).

Where(x => x.t >= 1000).

Select(x => new { x.o.OrderID, Total = x.t })

donde x es un identificador generado por el compilador que, de lo contrario, es

invisible e inaccesible.

En el ejemplo

C#

from c in customers

join o in orders on c.CustomerID equals o.CustomerID

select new { c.Name, o.OrderDate, o.Total }

se traduce en

C#

customers.Join(orders, c => c.CustomerID, o => o.CustomerID,

(c, o) => new { c.Name, o.OrderDate, o.Total })

En el ejemplo

C#

from c in customers

join o in orders on c.CustomerID equals o.CustomerID into co

let n = co.Count()

where n >= 10

select new { c.Name, OrderCount = n }

se traduce en

C#

from * in customers.

GroupJoin(orders, c => c.CustomerID, o => o.CustomerID,

(c, co) => new { c, co })

let n = co.Count()

where n >= 10

select new { c.Name, OrderCount = n }

la traducción final que es

C#

customers.

GroupJoin(orders, c => c.CustomerID, o => o.CustomerID,

(c, co) => new { c, co }).

Select(x => new { x, n = x.co.Count() }).

Where(y => y.n >= 10).

Select(y => new { y.x.c.Name, OrderCount = y.n)

donde x y y son identificadores generados por el compilador que, de lo contrario, son

invisibles e inaccesibles.

En el ejemplo

C#

from o in orders

orderby o.Customer.Name, o.Total descending

select o

tiene la traducción final

C#

orders.

OrderBy(o => o.Customer.Name).

ThenByDescending(o => o.Total)

Cláusulas Select
Una expresión de consulta con el formato

C#

from x in e select v

se traduce en

C#

( e ) . Select ( x => v )

excepto cuando v es el identificador x, la traducción es simplemente

 C#

( e )

Por ejemplo

C#

from c in customers.Where(c => c.City == "London")

select c

simplemente se traduce en

C#

customers.Where(c => c.City == "London")

Cláusulas GroupBy

Una expresión de consulta con el formato

C#

from x in e group v by k

se traduce en

C#

( e ) . GroupBy ( x => k , x => v )

excepto cuando v es el identificador x, la traducción es

C#

( e ) . GroupBy ( x => k )

En el ejemplo

C#

from c in customers

group c.Name by c.Country

se traduce en

C#

customers.

GroupBy(c => c.Country, c => c.Name)

Identificadores transparentes
Ciertas traducciones insertan variables de intervalo con *identificadores transparentes _
indicados por _ . Los identificadores transparentes no son una característica de lenguaje
adecuada; solo existen como un paso intermedio en el proceso de conversión de
expresiones de consulta.

Cuando una traducción de consultas inserta un identificador transparente, los pasos de

traducción adicionales propagan el identificador transparente en funciones anónimas e
inicializadores de objeto anónimos. En esos contextos, los identificadores transparentes
tienen el siguiente comportamiento:

Cuando un identificador transparente se produce como un parámetro en una

función anónima, los miembros del tipo anónimo asociado están automáticamente
en el ámbito del cuerpo de la función anónima.
Cuando un miembro con un identificador transparente está en el ámbito, los
miembros de ese miembro están también en el ámbito.
Cuando un identificador transparente se produce como un declarador de miembro
en un inicializador de objeto anónimo, introduce un miembro con un identificador
transparente.
En los pasos de traducción descritos anteriormente, los identificadores
transparentes siempre se introducen junto con los tipos anónimos, con la intención
de capturar varias variables de rango como miembros de un solo objeto. Una
implementación de C# puede usar un mecanismo diferente que los tipos
anónimos para agrupar varias variables de rango. Los siguientes ejemplos de
traducción suponen que se usan tipos anónimos y muestran cómo se pueden
traducir los identificadores transparentes.

En el ejemplo

C#

from c in customers

from o in c.Orders

orderby o.Total descending

select new { c.Name, o.Total }

se traduce en

C#

from * in customers.

SelectMany(c => c.Orders, (c,o) => new { c, o })

orderby o.Total descending

select new { c.Name, o.Total }

que se traduce en

C#

customers.

SelectMany(c => c.Orders, (c,o) => new { c, o }).

OrderByDescending(* => o.Total).

Select(* => new { c.Name, o.Total })

que, cuando se borran los identificadores transparentes, es equivalente a

C#

customers.

SelectMany(c => c.Orders, (c,o) => new { c, o }).

OrderByDescending(x => x.o.Total).

Select(x => new { x.c.Name, x.o.Total })

donde x es un identificador generado por el compilador que, de lo contrario, es

invisible e inaccesible.

En el ejemplo

C#

from c in customers

join o in orders on c.CustomerID equals o.CustomerID

join d in details on o.OrderID equals d.OrderID

join p in products on d.ProductID equals p.ProductID

select new { c.Name, o.OrderDate, p.ProductName }

se traduce en

C#

from * in customers.

Join(orders, c => c.CustomerID, o => o.CustomerID,

(c, o) => new { c, o })

join d in details on o.OrderID equals d.OrderID

 join p in products on d.ProductID equals p.ProductID

select new { c.Name, o.OrderDate, p.ProductName }

se reduce aún más a

C#

customers.

Join(orders, c => c.CustomerID, o => o.CustomerID, (c, o) => new { c, o }).

Join(details, * => o.OrderID, d => d.OrderID, (*, d) => new { *, d }).

Join(products, * => d.ProductID, p => p.ProductID, (*, p) => new { *, p }).

Select(* => new { c.Name, o.OrderDate, p.ProductName })

la traducción final que es

C#

customers.

Join(orders, c => c.CustomerID, o => o.CustomerID,

(c, o) => new { c, o }).

Join(details, x => x.o.OrderID, d => d.OrderID,

(x, d) => new { x, d }).

Join(products, y => y.d.ProductID, p => p.ProductID,

(y, p) => new { y, p }).

Select(z => new { z.y.x.c.Name, z.y.x.o.OrderDate, z.p.ProductName })

donde x , y y z son identificadores generados por el compilador que, de lo contrario,

son invisibles e inaccesibles.

Patrón de expresión de consulta

El patrón de expresión de consulta establece un patrón de métodos que los tipos
pueden implementar para admitir expresiones de consulta. Dado que las expresiones de
consulta se convierten en invocaciones de método por medio de una asignación
sintáctica, los tipos tienen una gran flexibilidad en cómo implementan el patrón de
expresión de consulta. Por ejemplo, los métodos del patrón se pueden implementar
como métodos de instancia o como métodos de extensión porque los dos tienen la
misma sintaxis de invocación y los métodos pueden solicitar delegados o árboles de
expresión porque las funciones anónimas son convertibles a ambos.

A continuación se muestra la forma recomendada de un tipo genérico C<T> que admite

el patrón de expresión de consulta. Se usa un tipo genérico para ilustrar las relaciones
apropiadas entre los tipos de parámetro y de resultado, pero también es posible
implementar el patrón para tipos no genéricos.
 C#

delegate R Func<T1,R>(T1 arg1);

delegate R Func<T1,T2,R>(T1 arg1, T2 arg2);

class C

public C<T> Cast<T>();

class C<T> : C

public C<T> Where(Func<T,bool> predicate);

public C<U> Select<U>(Func<T,U> selector);

public C<V> SelectMany<U,V>(Func<T,C<U>> selector,

Func<T,U,V> resultSelector);

public C<V> Join<U,K,V>(C<U> inner, Func<T,K> outerKeySelector,

Func<U,K> innerKeySelector, Func<T,U,V> resultSelector);

public C<V> GroupJoin<U,K,V>(C<U> inner, Func<T,K> outerKeySelector,

Func<U,K> innerKeySelector, Func<T,C<U>,V> resultSelector);

public O<T> OrderBy<K>(Func<T,K> keySelector);

public O<T> OrderByDescending<K>(Func<T,K> keySelector);

public C<G<K,T>> GroupBy<K>(Func<T,K> keySelector);

public C<G<K,E>> GroupBy<K,E>(Func<T,K> keySelector,

Func<T,E> elementSelector);

class O<T> : C<T>

public O<T> ThenBy<K>(Func<T,K> keySelector);

public O<T> ThenByDescending<K>(Func<T,K> keySelector);

class G<K,T> : C<T>

public K Key { get; }

Los métodos anteriores usan los tipos de delegado genérico Func<T1,R> y

Func<T1,T2,R> , pero también podrían haber usado otros tipos de árbol de delegado o

de expresión con las mismas relaciones en los tipos de parámetro y de resultado.

Observe la relación recomendada entre C<T> y O<T> que garantiza que los ThenBy
ThenByDescending métodos y solo están disponibles en el resultado de OrderBy o
OrderByDescending . Observe también la forma recomendada del resultado de GroupBy -

-una secuencia de secuencias, donde cada secuencia interna tiene una propiedad
adicional Key .

El System.Linq espacio de nombres proporciona una implementación del patrón de

operador de consulta para cualquier tipo que implemente la
System.Collections.Generic.IEnumerable<T> interfaz.

Operadores de asignación
Los operadores de asignación asignan un nuevo valor a una variable, una propiedad, un
evento o un elemento de indexador.

antlr

assignment

: unary_expression assignment_operator expression

assignment_operator

: '='

| '+='

| '-='

| '*='

| '/='

| '%='

| '&='

| '|='

| '^='

| '<<='

| right_shift_assignment

El operando izquierdo de una asignación debe ser una expresión clasificada como una
variable, un acceso de propiedad, un acceso de indexador o un acceso de evento.

El = operador se denomina operador de asignación simple. Asigna el valor del

operando derecho a la variable, propiedad o elemento de indexador proporcionado por
el operando izquierdo. Es posible que el operando izquierdo del operador de asignación
simple no sea un acceso a eventos (excepto como se describe en eventos similares a los
de campo). El operador de asignación simple se describe en asignación simple.
Los operadores de asignación distintos del = operador se denominan operadores de
asignación compuesta. Estos operadores realizan la operación indicada en los dos
operandos y, a continuación, asignan el valor resultante a la variable, la propiedad o el
elemento indexador proporcionado por el operando izquierdo. Los operadores de
asignación compuesta se describen en asignación compuesta.

Los += -= operadores y con una expresión de acceso a eventos como operando

izquierdo se denominan operadores de asignación de eventos. Ningún otro operador de
asignación es válido con un acceso de evento como operando izquierdo. Los
operadores de asignación de eventos se describen en asignación de eventos.

Los operadores de asignación son asociativos a la derecha, lo que significa que las
operaciones se agrupan de derecha a izquierda. Por ejemplo, una expresión con el
formato a = b = c se evalúa como a = (b = c) .

Asignación simple
El = operador se denomina operador de asignación simple.

Si el operando izquierdo de una asignación simple tiene el formato E.P o E[Ei] donde
E tiene el tipo en tiempo de compilación dynamic , la asignación está enlazada

dinámicamente (enlace dinámico). En este caso, el tipo en tiempo de compilación de la

expresión de asignación es dynamic , y la resolución que se describe a continuación se
realizará en tiempo de ejecución en función del tipo en tiempo de ejecución de E .

En una asignación simple, el operando derecho debe ser una expresión que se pueda
convertir implícitamente al tipo del operando izquierdo. La operación asigna el valor del
operando derecho a la variable, la propiedad o el elemento indexador proporcionado
por el operando izquierdo.

El resultado de una expresión de asignación simple es el valor asignado al operando

izquierdo. El resultado tiene el mismo tipo que el operando izquierdo y siempre se
clasifica como un valor.

Si el operando izquierdo es una propiedad o un indexador, la propiedad o el indexador

deben tener un set descriptor de acceso. Si no es así, se produce un error en tiempo de
enlace.

El procesamiento en tiempo de ejecución de una asignación simple del formulario x =

y consta de los siguientes pasos:

Si x se clasifica como una variable:

 x se evalúa para generar la variable.

y se evalúa y, si es necesario, se convierte al tipo de x mediante una

conversión implícita (conversiones implícitas).
Si la variable proporcionada por x es un elemento de matriz de un
reference_type, se realiza una comprobación en tiempo de ejecución para
asegurarse de que el valor calculado para y es compatible con la instancia de la
matriz de que x es un elemento. La comprobación se realiza correctamente si y
es null , o si existe una conversión de referencia implícita (conversiones de
referencia implícita) del tipo real de la instancia a la que se hace referencia en y
el tipo de elemento real de la instancia de la matriz que contiene x . De lo
contrario, se produce una excepción System.ArrayTypeMismatchException .
El valor resultante de la evaluación y la conversión de y se almacena en la
ubicación especificada por la evaluación de x .
Si x se clasifica como un acceso de propiedad o indizador:
La expresión de instancia (si x no es static ) y la lista de argumentos (si x es
un acceso de indexador) asociadas a x se evalúan, y los resultados se usan en la
set invocación del descriptor de acceso subsiguiente.
y se evalúa y, si es necesario, se convierte al tipo de x mediante una

conversión implícita (conversiones implícitas).

El set descriptor de acceso de x se invoca con el valor calculado para y como
su value argumento.

Las reglas de covarianza de matriz (covarianza de matriz) permiten que un valor de un

tipo de matriz A[] sea una referencia a una instancia de un tipo de matriz B[] , siempre
que exista una conversión de referencia implícita de B a A . Debido a estas reglas, la
asignación a un elemento de matriz de un reference_type requiere una comprobación en
tiempo de ejecución para asegurarse de que el valor que se está asignando es
compatible con la instancia de la matriz. En el ejemplo

C#

string[] sa = new string[10];

object[] oa = sa;

oa[0] = null; // Ok

oa[1] = "Hello"; // Ok

oa[2] = new ArrayList(); // ArrayTypeMismatchException

la última asignación provoca que System.ArrayTypeMismatchException se produzca una

excepción porque no se ArrayList puede almacenar una instancia de en un elemento
de string[] .
Cuando una propiedad o un indizador declarado en una struct_type es el destino de una
asignación, la expresión de instancia asociada con el acceso a la propiedad o indizador
debe estar clasificada como una variable. Si la expresión de instancia se clasifica como
un valor, se produce un error en tiempo de enlace. Debido al acceso a miembros, la
misma regla también se aplica a los campos.

Dadas las declaraciones:

C#

struct Point

int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

public int X {

get { return x; }

set { x = value; }

public int Y {

get { return y; }

set { y = value; }

struct Rectangle

Point a, b;

public Rectangle(Point a, Point b) {

this.a = a;

this.b = b;

public Point A {

get { return a; }

set { a = value; }

public Point B {

get { return b; }

set { b = value; }

en el ejemplo
 C#

Point p = new Point();

p.X = 100;

p.Y = 100;

Rectangle r = new Rectangle();

r.A = new Point(10, 10);

r.B = p;

las asignaciones a p.X , p.Y , r.A y r.B se permiten porque p y r son variables. Sin
embargo, en el ejemplo

C#

Rectangle r = new Rectangle();

r.A.X = 10;

r.A.Y = 10;

r.B.X = 100;

r.B.Y = 100;

las asignaciones no son válidas, ya que r.A y r.B no son variables.

Asignación compuesta
Si el operando izquierdo de una asignación compuesta tiene el formato E.P o E[Ei]
donde E tiene el tipo en tiempo de compilación dynamic , la asignación está enlazada
dinámicamente (enlace dinámico). En este caso, el tipo en tiempo de compilación de la
expresión de asignación es dynamic , y la resolución que se describe a continuación se
realizará en tiempo de ejecución en función del tipo en tiempo de ejecución de E .

Una operación del formulario x op= y se procesa aplicando la resolución de sobrecarga

del operador binario (resolución de sobrecarga del operador binario) como si se hubiera
escrito la operación x op y . A continuación,

Si el tipo de valor devuelto del operador seleccionado es implícitamente

convertible al tipo de x , la operación se evalúa como x = x op y , excepto que x
se evalúa solo una vez.
De lo contrario, si el operador seleccionado es un operador predefinido, si el tipo
de valor devuelto del operador seleccionado es convertible explícitamente al tipo
de x , y si y es implícitamente convertible al tipo de x o el operador es un
operador de desplazamiento, la operación se evalúa como x = (T)(x op y) ,
donde T es el tipo de x , excepto que x se evalúa solo una vez.
 De lo contrario, la asignación compuesta no es válida y se produce un error en
tiempo de enlace.

El término "evaluado solo una vez" significa que en la evaluación de x op y , los

resultados de cualquier expresión constitutiva de x se guardan temporalmente y se
reutilizan al realizar la asignación a x . Por ejemplo, en la asignación A()[B()] += C() ,
donde A es un método que devuelve int[] y B y C son métodos que devuelven int ,
los métodos se invocan solo una vez, en el orden A , B , C .

Cuando el operando izquierdo de una asignación compuesta es un acceso a propiedad

o a un indexador, la propiedad o el indexador deben tener un descriptor de acceso get
y un set descriptor de acceso. Si no es así, se produce un error en tiempo de enlace.

La segunda regla anterior permite x op= y evaluar como x = (T)(x op y) en

determinados contextos. La regla existe de forma que los operadores predefinidos se
pueden utilizar como operadores compuestos cuando el operando izquierdo es de tipo
sbyte , byte ,, short ushort o char . Incluso cuando ambos argumentos son de uno de
esos tipos, los operadores predefinidos producen un resultado de tipo int , tal y como
se describe en promociones numéricas binarias. Por lo tanto, sin una conversión, no
sería posible asignar el resultado al operando izquierdo.

El efecto intuitivo de la regla para los operadores predefinidos es simplemente que x

op= y se permite si x op y se permiten ambos tipos de y x = y . En el ejemplo

C#

byte b = 0;

char ch = '\0';

int i = 0;

b += 1; // Ok

b += 1000; // Error, b = 1000 not permitted

b += i; // Error, b = i not permitted

b += (byte)i; // Ok

ch += 1; // Error, ch = 1 not permitted

ch += (char)1; // Ok

la razón intuitiva de cada error es que una asignación simple correspondiente también
habría sido un error.

Esto también significa que las operaciones de asignación compuesta admiten

operaciones de elevación. En el ejemplo

C#
 int? i = 0;

i += 1; // Ok

se utiliza el operador de elevación +(int?,int?) .

Asignación de eventos
Si el operando izquierdo de += un -= operador Or se clasifica como un acceso de
evento, la expresión se evalúa como sigue:

Expresión de instancia, si existe, del acceso al evento que se va a evaluar.

Se evalúa el operando derecho del += -= operador OR y, si es necesario, se
convierte al tipo del operando izquierdo a través de una conversión implícita
(conversiones implícitas).
Se invoca un descriptor de acceso de eventos del evento, con la lista de
argumentos que consiste en el operando derecho, después de la evaluación y, si es
necesario, conversión. Si el operador era += , add se invoca al descriptor de
acceso; si el operador era -= , remove se invoca al descriptor de acceso.

Una expresión de asignación de eventos no produce un valor. Por lo tanto, una

expresión de asignación de eventos solo es válida en el contexto de una
statement_expression (instrucciones de expresión).

Expression
Una expresión es una non_assignment_expression o una asignación.

antlr

expression

: non_assignment_expression

| assignment

non_assignment_expression

: conditional_expression

| lambda_expression

| query_expression

Expresiones constantes
Una constant_expression es una expresión que se puede evaluar por completo en tiempo
de compilación.

antlr

constant_expression

: expression

Una expresión constante debe ser el null literal o un valor con uno de los siguientes
tipos: sbyte , byte , short , ushort , int , uint , long , ulong , char , float , double ,
decimal ,,, bool object string o cualquier tipo de enumeración. Solo se permiten las

siguientes construcciones en expresiones constantes:

Literales (incluido el null literal).

Referencias a const miembros de tipos de clase y estructura.
Referencias a miembros de tipos de enumeración.
Referencias a const parámetros o variables locales
Subexpresiones entre paréntesis, que son expresiones constantes.
Expresiones de conversión, siempre que el tipo de destino sea uno de los tipos
enumerados anteriormente.
checked``unchecked expresiones y
Expresiones de valor predeterminado
Expresiones Name
Los + - ! ~ operadores unarios predefinidos,, y.
Los operadores binarios predefinidos,,,,,,,,,,,,,,,, + - * / % << >> & | ^ && || ==
!= < > <= y >= , siempre que cada operando sea de un tipo enumerado
anteriormente.
?: Operador condicional.

Las siguientes conversiones se permiten en expresiones constantes:

Conversiones de identidad
Conversiones numéricas
Conversiones de enumeración
Conversiones de expresiones constantes
Conversiones de referencia implícitas y explícitas, siempre que el origen de las
conversiones sea una expresión constante que se evalúe como el valor null.

No se permiten otras conversiones, incluidas las conversiones Boxing, unboxing y de

referencia implícita de valores no NULL en expresiones constantes. Por ejemplo:
 C#

class C {

const object i = 5; // error: boxing conversion not permitted

const object str = "hello"; // error: implicit reference conversion

la inicialización de i es un error porque se requiere una conversión boxing. La

inicialización de Str es un error porque se requiere una conversión de referencia
implícita de un valor distinto de NULL.

Siempre que una expresión cumple los requisitos mencionados anteriormente, la

expresión se evalúa en tiempo de compilación. Esto es así incluso si la expresión es una
subexpresión de una expresión mayor que contiene construcciones que no son
constantes.

La evaluación en tiempo de compilación de las expresiones constantes utiliza las mismas

reglas que la evaluación en tiempo de ejecución de expresiones no constantes, salvo
que, en el caso de que la evaluación en tiempo de ejecución hubiera producido una
excepción, la evaluación en tiempo de compilación provoca un error en tiempo de
compilación.

A menos que una expresión constante se coloque explícitamente en un unchecked

contexto, los desbordamientos que se producen en operaciones aritméticas de tipo
entero y en las conversiones durante la evaluación en tiempo de compilación de la
expresión siempre producen errores en tiempo de compilación (expresiones
constantes).

Las expresiones constantes se producen en los contextos que se enumeran a

continuación. En estos contextos, se produce un error en tiempo de compilación si una
expresión no se puede evaluar por completo en tiempo de compilación.

Declaraciones de constantes (constantes).

Declaraciones de miembros de enumeración (miembros de enumeración).
Argumentos predeterminados de las listas de parámetros formales (parámetros de
método)
case Etiquetas de una switch instrucción (la instrucción switch).
goto case instrucciones (instrucción Goto).

Longitudes de dimensión en una expresión de creación de matriz (expresiones de

creación de matrices) que incluye un inicializador.
Attributes (atributos).
Una conversión de expresión constante implícita (conversiones de expresión constante
implícita) permite convertir una expresión constante de tipo en int sbyte ,, byte ,
short ushort , uint o ulong , siempre que el valor de la expresión constante esté

dentro del intervalo del tipo de destino.

Expresiones booleanas
Un Boolean_expression es una expresión que produce un resultado de tipo bool , ya sea
directamente o a través de operator true la aplicación de en determinados contextos,
tal y como se especifica en el siguiente.

antlr

boolean_expression

: expression

La expresión condicional de control de una if_statement (la instrucción if),

while_statement (la instrucción while) , do_statement (la instrucción do) o for_Statement
(la instrucción for) es una Boolean_expression. La expresión condicional de control del
?: operador (operador condicional) sigue las mismas reglas que una

Boolean_expression, pero por razones de precedencia de operadores se clasifica como

conditional_or_expression.

Un Boolean_expression E es necesario para poder generar un valor de tipo bool , como

se indica a continuación:

Si E se pueden convertir implícitamente a bool , en tiempo de ejecución, se aplica

la conversión implícita.
De lo contrario, se utiliza la resolución de sobrecargas de operador unario
(resolución de sobrecarga de operadores unarios) para encontrar una
implementación óptima única de operador true en E y esa implementación se
aplica en tiempo de ejecución.
Si no se encuentra ningún operador de este tipo, se produce un error en tiempo
de enlace.

El tipo de DBBool estructura de tipo Boolean de base de datos proporciona un ejemplo

de un tipo que implementa operator true y operator false .
Instrucciones
Artículo • 16/09/2021 • Tiempo de lectura: 53 minutos

C# proporciona diversas instrucciones. La mayoría de estas instrucciones serán

familiares para los desarrolladores que han programado en C y C++.

antlr

statement

: labeled_statement

| declaration_statement

| embedded_statement

embedded_statement

: block

| empty_statement

| expression_statement

| selection_statement

| iteration_statement

| jump_statement

| try_statement

| checked_statement

| unchecked_statement

| lock_statement

| using_statement

| yield_statement

| embedded_statement_unsafe

El embedded_statement nonterminal se utiliza para las instrucciones que aparecen

dentro de otras instrucciones. El uso de embedded_statement en lugar de Statement
excluye el uso de las instrucciones de declaración y las instrucciones con etiquetas en
estos contextos. En el ejemplo

C#

void F(bool b) {

if (b)

int i = 44;

genera un error en tiempo de compilación porque una if instrucción requiere una

embedded_statement en lugar de una instrucción para su bifurcación if. Si se permitía
este código, la variable i se declararía, pero nunca se podía usar. Tenga en cuenta, sin
embargo, que si coloca i la declaración de en un bloque, el ejemplo es válido.
Puntos finales y alcance
Cada instrucción tiene un punto final. En términos intuitivos, el punto final de una
instrucción es la ubicación que sigue inmediatamente a la instrucción. Las reglas de
ejecución para las instrucciones compuestas (instrucciones que contienen instrucciones
incrustadas) especifican la acción que se realiza cuando el control alcanza el punto final
de una instrucción incrustada. Por ejemplo, cuando el control alcanza el punto final de
una instrucción en un bloque, el control se transfiere a la siguiente instrucción del
bloque.

Si la ejecución puede alcanzar una instrucción, se dice que la instrucción es *accesible _.

Por el contrario, si no hay ninguna posibilidad de que se ejecute una instrucción, se dice
que la instrucción es _ inaccesible *.

En el ejemplo

C#

void F() {

Console.WriteLine("reachable");

goto Label;

Console.WriteLine("unreachable");

Label:

Console.WriteLine("reachable");

la segunda invocación de Console.WriteLine es inaccesible porque no existe ninguna

posibilidad de que se ejecute la instrucción.

Se genera una advertencia si el compilador determina que no se puede tener acceso a

una instrucción. No se trata de un error específico para que no se pueda tener acceso a
una instrucción.

Para determinar si una instrucción o un extremo concreto es accesible, el compilador

realiza el análisis de flujo según las reglas de disponibilidad definidas para cada
instrucción. El análisis de flujo tiene en cuenta los valores de expresiones constantes
(expresiones constantes) que controlan el comportamiento de las instrucciones, pero no
se tienen en cuenta los valores posibles de las expresiones que no son constantes. En
otras palabras, a efectos del análisis de flujo de control, se considera que una expresión
no constante de un tipo determinado tiene cualquier valor posible de ese tipo.

En el ejemplo

C#
 void F() {

const int i = 1;

if (i == 2) Console.WriteLine("unreachable");

la expresión booleana de la if instrucción es una expresión constante porque ambos

operandos del == operador son constantes. Como la expresión constante se evalúa en
tiempo de compilación, lo que genera el valor false , Console.WriteLine se considera
que la invocación no es accesible. Sin embargo, si i se cambia para ser una variable
local

C#

void F() {

int i = 1;

if (i == 2) Console.WriteLine("reachable");

la Console.WriteLine invocación se considera accesible, aunque, en realidad, nunca se

ejecutará.

El bloque de un miembro de función siempre se considera alcanzable. Al evaluar

sucesivamente las reglas de disponibilidad de cada instrucción en un bloque, se puede
determinar la disponibilidad de cualquier instrucción determinada.

En el ejemplo

C#

void F(int x) {

Console.WriteLine("start");

if (x < 0) Console.WriteLine("negative");

la disponibilidad de la segunda Console.WriteLine se determina de la siguiente manera:

La primera Console.WriteLine instrucción de expresión es accesible porque el

bloque del F método es accesible.
El punto final de la primera Console.WriteLine instrucción de expresión es
accesible porque esa instrucción es accesible.
La if instrucción es accesible porque el punto final de la primera
Console.WriteLine instrucción de expresión es accesible.
 La segunda Console.WriteLine instrucción de expresión es accesible porque la
expresión booleana de la if instrucción no tiene el valor constante false .

Hay dos situaciones en las que se trata de un error en tiempo de compilación para que
el punto final de una instrucción sea alcanzable:

Dado que la switch instrucción no permite que una sección switch pase a la
siguiente sección switch, se trata de un error en tiempo de compilación para que el
punto final de la lista de instrucciones de una sección switch sea accesible. Si se
produce este error, normalmente es una indicación de que break falta una
instrucción.
Es un error en tiempo de compilación el punto final del bloque de un miembro de
función que calcula un valor al que se puede tener acceso. Si se produce este error,
normalmente es una indicación de que return falta una instrucción.

Blocks
Un bloque permite que se escriban varias instrucciones en contextos donde se permite
una única instrucción.

antlr

block

: '{' statement_list? '}'

Un bloque consta de un statement_list opcional (listas de instrucciones), entre llaves. Si

se omite la lista de instrucciones, se dice que el bloque está vacío.

Un bloque puede contener instrucciones de declaración (instrucciones de declaración).

El ámbito de una variable local o constante declarada en un bloque es el bloque.

Un bloque se ejecuta de la siguiente manera:

Si el bloque está vacío, el control se transfiere al punto final del bloque.

Si el bloque no está vacío, el control se transfiere a la lista de instrucciones.
Cuando y si el control alcanza el punto final de la lista de instrucciones, el control
se transfiere al punto final del bloque.

La lista de instrucciones de un bloque es accesible si el propio bloque es accesible.

El punto final de un bloque es accesible si el bloque está vacío o si el punto final de la

lista de instrucciones es accesible.
Un bloque que contiene una o más yield instrucciones (la instrucción yield) se
denomina bloque de iteradores. Los bloques de iterador se usan para implementar
miembros de función como iteradores (iteradores). Se aplican algunas restricciones
adicionales a los bloques de iteradores:

Se trata de un error en tiempo de compilación para return que una instrucción

aparezca en un bloque de iteradores (pero yield return se permiten las
instrucciones).
Es un error en tiempo de compilación que un bloque de iteradores contenga un
contexto no seguro (contextos no seguros). Un bloque de iterador siempre define
un contexto seguro, incluso cuando su declaración está anidada en un contexto no
seguro.

Listas de instrucciones
Una *lista de instrucciones _ consta de una o varias instrucciones escritas en secuencia.
Las listas de instrucciones se producen en _block * s (bloques) y en Switch_block s (la
instrucción switch).

antlr

statement_list

: statement+

Una lista de instrucciones se ejecuta mediante la transferencia de control a la primera

instrucción. Cuando y si el control alcanza el punto final de una instrucción, el control se
transfiere a la siguiente instrucción. Cuando el control alcanza el punto final de la última
instrucción, se transfiere el control al punto final de la lista de instrucciones.

Se puede tener acceso a una instrucción de una lista de instrucciones si se cumple al

menos una de las siguientes condiciones:

La instrucción es la primera instrucción y la propia lista de instrucciones es

accesible.
El punto final de la instrucción anterior es accesible.
La instrucción es una instrucción con etiqueta y una instrucción accesible hace
referencia a la etiqueta goto .

El punto final de una lista de instrucciones es accesible si el punto final de la última

instrucción de la lista es accesible.
Instrucción vacía
Un empty_statement no hace nada.

antlr

empty_statement

: ';'

Se utiliza una instrucción vacía cuando no hay ninguna operación que realizar en un
contexto donde se requiere una instrucción.

La ejecución de una instrucción vacía simplemente transfiere el control al punto final de

la instrucción. Por lo tanto, el punto final de una instrucción vacía es accesible si la
instrucción vacía es accesible.

Se puede usar una instrucción vacía al escribir una while instrucción con un cuerpo
nulo:

C#

bool ProcessMessage() {...}

void ProcessMessages() {

while (ProcessMessage())

Además, se puede usar una instrucción vacía para declarar una etiqueta justo antes del
cierre " } " de un bloque:

C#

void F() {

...

if (done) goto exit;

...

exit: ;

Instrucciones con etiqueta

Un labeled_statement permite a una instrucción ir precedida por una etiqueta. Las
instrucciones con etiqueta se permiten en bloques, pero no se permiten como
instrucciones incrustadas.

antlr

labeled_statement

: identifier ':' statement

Una instrucción con etiqueta declara una etiqueta con el nombre proporcionado por el
identificador. El ámbito de una etiqueta es el bloque entero en el que se declara la
etiqueta, incluidos los bloques anidados. Es un error en tiempo de compilación que dos
etiquetas con el mismo nombre tienen ámbitos superpuestos.

Se puede hacer referencia a una etiqueta desde goto instrucciones (instrucción Goto)
dentro del ámbito de la etiqueta. Esto significa que las goto instrucciones pueden
transferir el control dentro de los bloques y fuera de los bloques, pero nunca a los
bloques.

Las etiquetas tienen su propio espacio de declaración y no interfieren con otros

identificadores. En el ejemplo

C#

int F(int x) {

if (x >= 0) goto x;

x = -x;

x: return x;

es válido y usa el nombre x como un parámetro y una etiqueta.

La ejecución de una instrucción con etiqueta corresponde exactamente a la ejecución de

la instrucción que sigue a la etiqueta.

Además de la disponibilidad proporcionada por el flujo de control normal, se puede

tener acceso a una instrucción con etiqueta si se hace referencia a la etiqueta mediante
una goto instrucción alcanzable. (Excepción: Si una goto instrucción está dentro de un
try que incluye un finally bloque y la instrucción con etiqueta está fuera de try , y el

punto final del finally bloque es inaccesible, la instrucción con etiqueta no es accesible
desde esa goto instrucción).

Instrucciones de declaración
Un declaration_statement declara una variable o constante local. Las instrucciones de
declaración se permiten en bloques, pero no se permiten como instrucciones
incrustadas.

antlr

declaration_statement

: local_variable_declaration ';'

| local_constant_declaration ';'

Declaraciones de variables locales

Un local_variable_declaration declara una o más variables locales.

antlr

local_variable_declaration

: local_variable_type local_variable_declarators

local_variable_type

: type

| 'var'

local_variable_declarators

: local_variable_declarator

| local_variable_declarators ',' local_variable_declarator

local_variable_declarator

: identifier

| identifier '=' local_variable_initializer

local_variable_initializer

: expression

| array_initializer

| local_variable_initializer_unsafe

El local_variable_type de una local_variable_declaration especifica directamente el tipo

de las variables introducidas por la declaración, o indica con el identificador var que el
tipo se debe inferir en función de un inicializador. El tipo va seguido de una lista de
local_variable_declarator s, cada uno de los cuales introduce una nueva variable. Un
local_variable_declarator consta de un identificador que asigna un nombre a la variable,
seguido opcionalmente por un = token "" y un local_variable_initializer que proporciona
el valor inicial de la variable.

En el contexto de una declaración de variable local, el identificador var actúa como una
palabra clave contextual (palabras clave). Cuando el local_variable_type se especifica
como var y ningún tipo denominado var está en el ámbito, la declaración es una
declaración de variable local con tipo implícito, cuyo tipo se deduce del tipo de la
expresión de inicializador asociada. Las declaraciones de variables locales con tipo
implícito están sujetas a las siguientes restricciones:

El local_variable_declaration no puede incluir varios local_variable_declarator s.

El local_variable_declarator debe incluir un local_variable_initializer.
El local_variable_initializer debe ser una expresión.
La expresión de inicializador debe tener un tipo en tiempo de compilación.
La expresión de inicializador no puede hacer referencia a la variable declarada en sí
misma

A continuación se muestran ejemplos de declaraciones de variables locales con tipo

implícito incorrectas:

C#

var x; // Error, no initializer to infer type from

var y = {1, 2, 3}; // Error, array initializer not permitted

var z = null; // Error, null does not have a type

var u = x => x + 1; // Error, anonymous functions do not have a type

var v = v++; // Error, initializer cannot refer to variable itself

El valor de una variable local se obtiene en una expresión usando un simple_name

(nombres simples) y el valor de una variable local se modifica mediante una asignación
(operadores de asignación). Una variable local debe estar asignada definitivamente
(asignación definitiva) en cada ubicación donde se obtiene su valor.

El ámbito de una variable local declarada en un local_variable_declaration es el bloque

en el que se produce la declaración. Es un error hacer referencia a una variable local en
una posición textual que precede al local_variable_declarator de la variable local. Dentro
del ámbito de una variable local, se trata de un error en tiempo de compilación para
declarar otra variable o constante local con el mismo nombre.

Una declaración de variable local que declara varias variables es equivalente a varias
declaraciones de variables únicas con el mismo tipo. Además, un inicializador de
variable en una declaración de variable local se corresponde exactamente con una
instrucción de asignación que se inserta inmediatamente después de la declaración.
En el ejemplo

C#

void F() {

int x = 1, y, z = x * 2;

corresponde exactamente a

C#

void F() {

int x; x = 1;

int y;

int z; z = x * 2;

En una declaración de variable local con tipo implícito, el tipo de la variable local que se
está declarando se toma como el mismo tipo de la expresión que se usa para inicializar
la variable. Por ejemplo:

C#

var i = 5;

var s = "Hello";

var d = 1.0;

var numbers = new int[] {1, 2, 3};

var orders = new Dictionary<int,Order>();

Las declaraciones de variables locales con tipo implícito anterior son exactamente
equivalentes a las siguientes declaraciones con tipo explícito:

C#

int i = 5;

string s = "Hello";

double d = 1.0;

int[] numbers = new int[] {1, 2, 3};

Dictionary<int,Order> orders = new Dictionary<int,Order>();

Declaraciones de constantes locales

Un local_constant_declaration declara una o más constantes locales.

antlr
 local_constant_declaration

: 'const' type constant_declarators

constant_declarators

: constant_declarator (',' constant_declarator)*

constant_declarator

: identifier '=' constant_expression

El tipo de un local_constant_declaration especifica el tipo de las constantes introducidas

por la declaración. El tipo va seguido de una lista de constant_declarator s, cada uno de
los cuales introduce una nueva constante. Un constant_declarator consta de un
identificador que nombra la constante, seguido de un token " = ", seguido de un
constant_expression (expresiones constantes) que proporciona el valor de la constante.

El tipo y la constant_expression de una declaración de constante local deben seguir las

mismas reglas que las de una declaración de miembro constante (constantes).

El valor de una constante local se obtiene en una expresión usando un simple_name

(nombres simples).

El ámbito de una constante local es el bloque en el que se produce la declaración. Es un

error hacer referencia a una constante local en una posición textual que precede a su
constant_declarator. Dentro del ámbito de una constante local, es un error en tiempo de
compilación declarar otra variable o constante local con el mismo nombre.

Una declaración de constante local que declara varias constantes es equivalente a varias
declaraciones de constantes únicas con el mismo tipo.

Instrucciones de expresión
Un expression_statement evalúa una expresión determinada. El valor calculado por la
expresión, si existe, se descarta.

antlr

expression_statement

: statement_expression ';'

statement_expression

: invocation_expression

| null_conditional_invocation_expression

 | object_creation_expression

| assignment

| post_increment_expression

| post_decrement_expression

| pre_increment_expression

| pre_decrement_expression

| await_expression

No todas las expresiones se permiten como instrucciones. En concreto, las expresiones

como x + y y x == 1 que simplemente calculan un valor (que se descartarán) no se
permiten como instrucciones.

La ejecución de una expression_statement evalúa la expresión contenida y, a

continuación, transfiere el control al punto final de la expression_statement. El punto
final de una expression_statement es accesible si ese expression_statement es accesible.

Instrucciones de selección
Las instrucciones de selección seleccionan una de varias instrucciones posibles para su
ejecución según el valor de alguna expresión.

antlr

selection_statement

: if_statement

| switch_statement

Instrucción If
La if instrucción selecciona una instrucción para su ejecución basada en el valor de una
expresión booleana.

antlr

if_statement

: 'if' '(' boolean_expression ')' embedded_statement

| 'if' '(' boolean_expression ')' embedded_statement 'else'

embedded_statement

Un else elemento está asociado a la parte anterior léxicamente más cercana if

permitida por la sintaxis. Por lo tanto, una if instrucción con el formato
 C#

if (x) if (y) F(); else G();

es equivalente a

C#

if (x) {

if (y) {

F();

else {

G();

Una if instrucción se ejecuta de la siguiente manera:

Se evalúa el Boolean_expression (Expresiones booleanas).

Si la expresión booleana produce true , el control se transfiere a la primera
instrucción incrustada. Cuando y si el control alcanza el punto final de la
instrucción, el control se transfiere al punto final de la if instrucción.
Si la expresión booleana produce false y si un else elemento está presente, el
control se transfiere a la segunda instrucción incrustada. Cuando y si el control
alcanza el punto final de la instrucción, el control se transfiere al punto final de la
if instrucción.
Si la expresión booleana produce false y si un else elemento no está presente, el
control se transfiere al punto final de la if instrucción.

La primera instrucción incrustada de una if instrucción es accesible si la if instrucción

es accesible y la expresión booleana no tiene el valor constante false .

La segunda instrucción incrustada de una if instrucción, si está presente, es accesible si

la if instrucción es accesible y la expresión booleana no tiene el valor constante true .

El punto final de una if instrucción es accesible si el punto final de al menos una de sus
instrucciones incrustadas es accesible. Además, el punto final de una if instrucción sin
ninguna else parte es accesible si la if instrucción es accesible y la expresión booleana
no tiene el valor constante true .

La instrucción switch
La instrucción switch selecciona la ejecución de una lista de instrucciones que tiene una
etiqueta de conmutador asociada que corresponde al valor de la expresión switch.

antlr

switch_statement

: 'switch' '(' expression ')' switch_block

switch_block

: '{' switch_section* '}'

switch_section

: switch_label+ statement_list

switch_label

: 'case' constant_expression ':'

| 'default' ':'

Un switch_statement se compone de la palabra clave switch , seguida de una expresión

entre paréntesis (denominada expresión switch), seguida de un switch_block. El
switch_block consta de cero o más switch_section s, entre llaves. Cada switch_section
consta de uno o varios switch_label s seguidos de un statement_list (listas de
instrucciones).

El tipo de control de una switch instrucción se establece mediante la expresión switch.

Si el tipo de la expresión switch es sbyte , byte , short , ushort , int , uint ,

long , ulong , bool , char , string o un enum_type, o si es el tipo que acepta

valores NULL correspondiente a uno de estos tipos, es el tipo de control de la

switch instrucción.

De lo contrario, debe existir exactamente una conversión implícita definida por el

usuario (conversiones definidas por el usuario) del tipo de la expresión switch a
uno de los siguientes tipos de control posibles: sbyte , byte , short , ushort , int
, uint , long , ulong ,, char string o, un tipo que acepta valores NULL
correspondiente a uno de esos tipos.
De lo contrario, si no existe ninguna conversión implícita, o si existe más de una
conversión implícita de este tipo, se produce un error en tiempo de compilación.

La expresión constante de cada case etiqueta debe indicar un valor que se pueda
convertir implícitamente (conversiones implícitas) en el tipo aplicable de la switch
instrucción. Se produce un error en tiempo de compilación si dos o más case etiquetas
de la misma switch instrucción especifican el mismo valor constante.

Puede haber como máximo una default etiqueta en una instrucción switch.

Una switch instrucción se ejecuta de la siguiente manera:

La expresión switch se evalúa y se convierte al tipo aplicable.

Si una de las constantes especificadas en una case etiqueta en la misma switch
instrucción es igual al valor de la expresión switch, el control se transfiere a la lista
de instrucciones que sigue a la case etiqueta coincidente.
Si ninguna de las constantes especificadas en case las etiquetas de la misma
switch instrucción es igual al valor de la expresión switch y, si hay una default

etiqueta, el control se transfiere a la lista de instrucciones que sigue a la default

etiqueta.
Si ninguna de las constantes especificadas en case las etiquetas de la misma
switch instrucción es igual al valor de la expresión switch y no hay ninguna
default etiqueta, el control se transfiere al punto final de la switch instrucción.

Si el punto final de la lista de instrucciones de una sección switch es accesible, se

producirá un error en tiempo de compilación. Esto se conoce como la regla "no pasar
de un paso". En el ejemplo

C#

switch (i) {

case 0:

CaseZero();

break;

case 1:

CaseOne();

break;

default:

CaseOthers();

break;

es válido porque ninguna sección del modificador tiene un punto final alcanzable. A
diferencia de C y C++, no se permite la ejecución de una sección switch a la siguiente
sección switch y el ejemplo

C#

switch (i) {

case 0:

 CaseZero();

case 1:

CaseZeroOrOne();

default:

CaseAny();

produce un error en tiempo de compilación. Cuando la ejecución de una sección switch

va seguida de la ejecución de otra sección switch, goto case goto default se debe usar
una instrucción or explícita:

C#

switch (i) {

case 0:

CaseZero();

goto case 1;

case 1:

CaseZeroOrOne();

goto default;

default:

CaseAny();

break;

En un switch_section se permiten varias etiquetas. En el ejemplo

C#

switch (i) {

case 0:

CaseZero();

break;

case 1:

CaseOne();

break;

case 2:

default:

CaseTwo();

break;

es válido. En el ejemplo no se infringe la regla "no hay que pasar" porque las etiquetas
case 2: y default: forman parte del mismo switch_section.

La regla "no pasar" evita una clase común de errores que se producen en C y C++
cuando las break instrucciones se omiten accidentalmente. Además, debido a esta
regla, las secciones switch de una switch instrucción se pueden reorganizar
arbitrariamente sin afectar al comportamiento de la instrucción. Por ejemplo, las
secciones de la switch instrucción anterior se pueden revertir sin afectar al
comportamiento de la instrucción:

C#

switch (i) {

default:

CaseAny();

break;

case 1:

CaseZeroOrOne();

goto default;

case 0:

CaseZero();

goto case 1;

La lista de instrucciones de una sección switch normalmente finaliza en break una goto
case instrucción, o goto default , pero se permite cualquier construcción que

representa el punto final de la lista de instrucciones inaccesible. Por ejemplo, while se

sabe que una instrucción controlada por la expresión booleana true nunca alcanza su
punto final. Del mismo modo, una throw return instrucción o siempre transfiere el
control en otro lugar y nunca alcanza su punto final. Por lo tanto, el ejemplo siguiente es
válido:

C#

switch (i) {

case 0:

while (true) F();

case 1:

throw new ArgumentException();

case 2:

return;

El tipo de control de una switch instrucción puede ser el tipo string . Por ejemplo:

C#

void DoCommand(string command) {

switch (command.ToLower()) {

case "run":

DoRun();

break;

case "save":

DoSave();

 break;

case "quit":

DoQuit();

break;

default:

InvalidCommand(command);

break;

Al igual que los operadores de igualdad de cadena (operadores de igualdad de cadena),

la instrucción distingue switch entre mayúsculas y minúsculas y ejecutará una sección
de modificador determinada solo si la cadena de expresión de modificador coincide
exactamente con una case constante de etiqueta.

Cuando el tipo de control de una switch instrucción es string , null se permite el

valor como una constante de etiqueta de caso.

Los statement_list s de un switch_block pueden contener instrucciones de declaración

(instrucciones de declaración). El ámbito de una variable local o constante declarada en
un bloque switch es el bloque switch.

La lista de instrucciones de una sección de modificador determinada es accesible si la

switch instrucción es accesible y se cumple al menos una de las siguientes condiciones:

La expresión switch es un valor que no es constante.

La expresión switch es un valor constante que coincide con una case etiqueta en
la sección switch.
La expresión switch es un valor constante que no coincide con ninguna case
etiqueta y la sección switch contiene la default etiqueta.
Se hace referencia a una etiqueta switch de la sección switch mediante una goto
case instrucción o alcanzable goto default .

El punto final de una switch instrucción es accesible si se cumple al menos una de las
siguientes condiciones:

La switch instrucción contiene una instrucción accesible break que sale de la

switch instrucción.

La switch instrucción es accesible, la expresión switch es un valor no constante y

no hay ninguna default etiqueta.
La switch instrucción es accesible, la expresión switch es un valor constante que
no coincide con ninguna case etiqueta y no hay ninguna default etiqueta.
Instrucciones de iteración
Las instrucciones de iteración ejecutan repetidamente una instrucción incrustada.

antlr

iteration_statement

: while_statement

| do_statement

| for_statement

| foreach_statement

La instrucción while
La while instrucción ejecuta condicionalmente una instrucción incrustada cero o más
veces.

antlr

while_statement

: 'while' '(' boolean_expression ')' embedded_statement

Una while instrucción se ejecuta de la siguiente manera:

Se evalúa el Boolean_expression (Expresiones booleanas).

Si la expresión booleana produce true , el control se transfiere a la instrucción
incrustada. Cuando el control alcanza el punto final de la instrucción incrustada
(posiblemente desde la ejecución de una continue instrucción), el control se
transfiere al principio de la while instrucción.
Si la expresión booleana produce false , el control se transfiere al punto final de
la while instrucción.

Dentro de la instrucción incrustada de una while instrucción, break se puede usar una
instrucción (la instrucción break) para transferir el control al punto final de la while
instrucción (por lo tanto, finalizar la iteración de la instrucción incrustada) y continue se
puede usar una instrucción (la instrucción continue) para transferir el control al punto
final de la instrucción incrustada (por lo que se realiza otra iteración de la while
instrucción

La instrucción incrustada de una while instrucción es accesible si la while instrucción es

accesible y la expresión booleana no tiene el valor constante false .
El punto final de una while instrucción es accesible si se cumple al menos una de las
siguientes condiciones:

La while instrucción contiene una instrucción accesible break que sale de la while
instrucción.
La while instrucción es accesible y la expresión booleana no tiene el valor
constante true .

La instrucción do
La do instrucción ejecuta condicionalmente una instrucción incrustada una o varias
veces.

antlr

do_statement

: 'do' embedded_statement 'while' '(' boolean_expression ')' ';'

Una do instrucción se ejecuta de la siguiente manera:

El control se transfiere a la instrucción insertada.

Cuando el control alcanza el punto final de la instrucción incrustada (posiblemente
desde la ejecución de una continue instrucción), se evalúa el Boolean_expression
(Expresiones booleanas). Si la expresión booleana produce true , el control se
transfiere al principio de la do instrucción. De lo contrario, el control se transfiere
al punto final de la do instrucción.

Dentro de la instrucción incrustada de una do instrucción, break se puede usar una

instrucción (la instrucción break) para transferir el control al punto final de la do
instrucción (por lo tanto, finalizar la iteración de la instrucción incrustada) y continue se
puede usar una instrucción (la instrucción continue) para transferir el control al punto
final de la instrucción incrustada.

La instrucción insertada de una do instrucción es accesible si la do instrucción es

accesible.

El punto final de una do instrucción es accesible si se cumple al menos una de las

siguientes condiciones:

La do instrucción contiene una instrucción accesible break que sale de la do

instrucción.
 El punto final de la instrucción incrustada es accesible y la expresión booleana no
tiene el valor constante true .

La instrucción for
La for instrucción evalúa una secuencia de expresiones de inicialización y, a
continuación, mientras una condición es true, ejecuta repetidamente una instrucción
incrustada y evalúa una secuencia de expresiones de iteración.

antlr

for_statement

: 'for' '(' for_initializer? ';' for_condition? ';' for_iterator? ')'

embedded_statement

for_initializer

: local_variable_declaration

| statement_expression_list

for_condition

: boolean_expression

for_iterator

: statement_expression_list

statement_expression_list

: statement_expression (',' statement_expression)*

El for_initializer, si está presente, consta de un local_variable_declaration (declaraciones

de variables locales) o una lista de statement_expression s (instrucciones de expresión)
separadas por comas. El ámbito de una variable local declarada por una for_initializer
comienza en el local_variable_declarator de la variable y se extiende hasta el final de la
instrucción incrustada. El ámbito incluye el for_condition y el for_iterator.

El for_condition, si está presente, debe ser un Boolean_expression (Expresiones

booleanas).

El for_iterator, si está presente, consta de una lista de statement_expression s

(instrucciones de expresión) separadas por comas.

Una instrucción for se ejecuta de la siguiente manera:

 Si hay un for_initializer , los inicializadores variables o las expresiones de
instrucción se ejecutan en el orden en que se escriben. Este paso solo se realiza
una vez.
Si hay un for_condition , se evalúa.
Si el for_condition no está presente o si la evaluación produce true , el control se
transfiere a la instrucción insertada. Cuando el control alcanza el punto final de la
instrucción incrustada (posiblemente desde la ejecución de una continue
instrucción), las expresiones del for_iterator, si las hubiera, se evalúan en secuencia
y, a continuación, se realiza otra iteración, comenzando por la evaluación de la
for_condition en el paso anterior.
Si el for_condition está presente y la evaluación produce false , el control se
transfiere al punto final de la for instrucción.

Dentro de la instrucción incrustada de una for instrucción, break se puede usar una
instrucción (la instrucción break) para transferir el control al punto final de la for
instrucción (con lo que finaliza la iteración de la instrucción incrustada) y continue se
puede usar una instrucción (la instrucción continue) para transferir el control al punto
final de la instrucción incrustada (de modo que se ejecute el for_iterator y realice otra
iteración de la for instrucción, empezando por el for_condition)

La instrucción insertada de una for instrucción es accesible si se cumple una de las

siguientes condiciones:

La for instrucción es accesible y no hay ningún for_condition presente.

La for instrucción es accesible y hay un for_condition presente y no tiene el valor
constante false .

El punto final de una for instrucción es accesible si se cumple al menos una de las
siguientes condiciones:

La for instrucción contiene una instrucción accesible break que sale de la for
instrucción.
La for instrucción es accesible y hay un for_condition presente y no tiene el valor
constante true .

La instrucción foreach
La foreach instrucción enumera los elementos de una colección y ejecuta una
instrucción incrustada para cada elemento de la colección.

antlr
 foreach_statement

: 'foreach' '(' local_variable_type identifier 'in' expression ')'

embedded_statement

El tipo y el identificador de una foreach instrucción declaran la variable de iteración* _

de la instrucción. Si el var identificador se proporciona como _local_variable_type *, y
no hay ningún tipo denominado var en el ámbito, se dice que la variable de iteración
es una variable de iteración con tipo implícito y se considera que su tipo es el tipo de
elemento de la foreach instrucción, tal y como se especifica a continuación. La variable
de iteración corresponde a una variable local de solo lectura con un ámbito que se
extiende a través de la instrucción incrustada. Durante la ejecución de una foreach
instrucción, la variable de iteración representa el elemento de colección para el que se
está realizando actualmente una iteración. Se produce un error en tiempo de
compilación si la instrucción incrustada intenta modificar la variable de iteración (a
través de la asignación o los ++ -- operadores y) o pasar la variable de iteración como
un ref out parámetro o.

En el siguiente, por motivos de brevedad, IEnumerable , IEnumerator IEnumerable<T> y

IEnumerator<T> hacen referencia a los tipos correspondientes de los espacios de

nombres System.Collections y System.Collections.Generic .

El procesamiento en tiempo de compilación de una instrucción foreach primero

determina el tipo de colección _, el tipo de _enumerador_ y el tipo de elemento de la
expresión. Esta determinación se realiza de la siguiente manera:

Si el tipo X de expresión es un tipo de matriz, hay una conversión de referencia

implícita de X a la IEnumerable interfaz (puesto que System.Array implementa
esta interfaz). * El tipo de colección _ es la IEnumerable interfaz, el tipo de
enumerador es la IEnumerator interfaz y el tipo de elemento _ * es el tipo de
elemento del tipo de matriz X .

Si el tipo X de expresión es dynamic , hay una conversión implícita de la expresión a

la IEnumerable interfaz (conversiones dinámicas implícitas). * El tipo de colección _
es la IEnumerable interfaz y el tipo de enumerador es la IEnumerator interfaz. Si el
var identificador se proporciona como _local_variable_type *, el tipo de elemento
es dynamic , de lo contrario, es object .

De lo contrario, determine si el tipo X tiene un GetEnumerator método adecuado:

Realiza la búsqueda de miembros en el tipo X con el identificador
GetEnumerator y ningún argumento de tipo. Si la búsqueda de miembros no
 produce una coincidencia, o produce una ambigüedad, o produce una
coincidencia que no es un grupo de métodos, busque una interfaz enumerable
como se describe a continuación. Se recomienda emitir una advertencia si la
búsqueda de miembros produce cualquier cosa, excepto un grupo de métodos
o ninguna coincidencia.
Realizar la resolución de sobrecarga utilizando el grupo de métodos resultante y
una lista de argumentos vacía. Si la resolución de sobrecarga da como resultado
ningún método aplicable, da como resultado una ambigüedad o tiene como
resultado un único método mejor pero ese método es estático o no público,
busque una interfaz enumerable como se describe a continuación. Se
recomienda emitir una advertencia si la resolución de sobrecarga produce todo
excepto un método de instancia pública inequívoco o ningún método aplicable.
Si el tipo de valor devuelto E del GetEnumerator método no es una clase, una
estructura o un tipo de interfaz, se genera un error y no se realiza ningún otro
paso.
La búsqueda de miembros se realiza en E con el identificador Current y sin
argumentos de tipo. Si la búsqueda de miembros no produce ninguna
coincidencia, el resultado es un error o el resultado es cualquier cosa excepto
una propiedad de instancia pública que permita la lectura, se genera un error y
no se realiza ningún paso más.
La búsqueda de miembros se realiza en E con el identificador MoveNext y sin
argumentos de tipo. Si la búsqueda de miembros no produce ninguna
coincidencia, el resultado es un error o el resultado es cualquier cosa excepto
un grupo de métodos, se genera un error y no se realiza ningún paso más.
La resolución de sobrecarga se realiza en el grupo de métodos con una lista de
argumentos vacía. Si la resolución de sobrecarga da como resultado ningún
método aplicable, da como resultado una ambigüedad o tiene como resultado
un único método mejor pero ese método es estático o no público, o su tipo de
valor devuelto no es bool , se genera un error y no se realiza ningún otro paso.
El tipo de colección* es X , el tipo de enumerador es E y el tipo de elemento _ *
es el tipo de la Current propiedad.

De lo contrario, compruebe si hay una interfaz enumerable:

Si entre todos los tipos Ti para los que hay una conversión implícita de X a
IEnumerable<Ti> , hay un tipo único T , de modo que T no es dynamic y para
todos los demás Ti hay una conversión implícita de IEnumerable<T> a
IEnumerable<Ti> , entonces el tipo de colección _ es la interfaz IEnumerable<T> ,
el tipo de _enumerador*_ es la interfaz IEnumerator<T> y el tipo de elemento _ *
es T .
 De lo contrario, si hay más de un tipo de este tipo T , se genera un error y no se
realiza ningún paso más.
De lo contrario, si hay una conversión implícita de X en la
System.Collections.IEnumerable interfaz, el tipo de colección* _ es esta
interfaz, el tipo de enumerador es la interfaz System.Collections.IEnumerator y
el tipo de elemento _ * es object .
De lo contrario, se genera un error y no se realiza ningún paso más.

Los pasos anteriores, si son correctos, producen de forma inequívoca un tipo de

colección, un tipo C de enumerador E y un tipo de elemento T . Una instrucción
foreach con el formato

C#

foreach (V v in x) embedded_statement

se expande a continuación hasta:

C#

E e = ((C)(x)).GetEnumerator();

try {

while (e.MoveNext()) {

V v = (V)(T)e.Current;

embedded_statement

finally {

... // Dispose e

La variable e no es visible o accesible para la expresión x o la instrucción incrustada ni

cualquier otro código fuente del programa. La variable v es de solo lectura en la
instrucción insertada. Si no hay una conversión explícita (conversiones explícitas) de T
(el tipo de elemento) en V (el local_variable_type en la instrucción foreach), se genera un
error y no se realiza ningún paso más. Si x tiene el valor null ,
System.NullReferenceException se produce una excepción en tiempo de ejecución.

Una implementación puede implementar una instrucción foreach determinada de forma

diferente, por ejemplo, por motivos de rendimiento, siempre que el comportamiento
sea coherente con la expansión anterior.
La colocación de v dentro del bucle while es importante para que lo Capture cualquier
función anónima que se produzca en el embedded_statement.

Por ejemplo:

C#

int[] values = { 7, 9, 13 };

Action f = null;

foreach (var value in values)

if (f == null) f = () => Console.WriteLine("First value: " + value);

f();

Si v se declaró fuera del bucle while, se compartirá entre todas las iteraciones y su valor
después del bucle for sería el valor final, 13 , que es lo que la invocación de f
imprimiría. En su lugar, dado que cada iteración tiene su propia variable v , la f que
captura en la primera iteración seguirá conservando el valor 7 , que es lo que se va a
imprimir. (Nota: versiones anteriores de C# declaradas v fuera del bucle while).

El cuerpo del bloque finally se construye según los pasos siguientes:

Si hay una conversión implícita de E en la System.IDisposable interfaz,

Si E es un tipo de valor que no acepta valores NULL, la cláusula finally se

expande al equivalente semántico de:

C#

finally {

((System.IDisposable)e).Dispose();

En caso contrario, la cláusula finally se expande al equivalente semántico de:

C#

finally {

if (e != null) ((System.IDisposable)e).Dispose();

salvo que si E es un tipo de valor o un parámetro de tipo al que se ha creado una

instancia de un tipo de valor, la conversión de e a System.IDisposable no hará
 que se produzca la conversión boxing.

De lo contrario, si E es un tipo sellado, la cláusula finally se expande a un bloque

vacío:

C#

finally {

De lo contrario, la cláusula finally se expande a:

C#

finally {

System.IDisposable d = e as System.IDisposable;

if (d != null) d.Dispose();

La variable local d no es visible o accesible para cualquier código de usuario. En

concreto, no entra en conflicto con ninguna otra variable cuyo ámbito incluya el
bloque Finally.

El orden en el que se foreach recorren los elementos de una matriz es el siguiente: en el

caso de las matrices unidimensionales, los elementos se recorren en orden creciente de
índice, empezando por el índice   0 y terminando por el índice Length - 1 . En el caso
de las matrices multidimensionales, los elementos se recorren de forma que los índices
de la dimensión situada más a la derecha aumenten primero, la dimensión izquierda
siguiente y así sucesivamente hacia la izquierda.

En el ejemplo siguiente se imprime cada valor en una matriz bidimensional, en el orden

de los elementos:

C#

using System;

class Test

static void Main() {

double[,] values = {

{1.2, 2.3, 3.4, 4.5},

{5.6, 6.7, 7.8, 8.9}

};

foreach (double elementValue in values)

Console.Write("{0} ", elementValue);

 Console.WriteLine();

La salida generada es la siguiente:

Consola

1.2 2.3 3.4 4.5 5.6 6.7 7.8 8.9

En el ejemplo

C#

int[] numbers = { 1, 3, 5, 7, 9 };

foreach (var n in numbers) Console.WriteLine(n);

el tipo de n se deduce como int , el tipo de elemento de numbers .

Instrucciones de salto
Las instrucciones de salto transfieren el control incondicionalmente.

antlr

jump_statement

: break_statement

| continue_statement

| goto_statement

| return_statement

| throw_statement

La ubicación a la que una instrucción de salto transfiere el control se denomina destino

de la instrucción de salto.

Cuando una instrucción de salto se produce dentro de un bloque y el destino de la

instrucción de salto está fuera del bloque, se dice que la instrucción de salto sale del
bloque. Aunque una instrucción de salto puede transferir el control fuera de un bloque,
nunca puede transferir el control a un bloque.

La ejecución de instrucciones de salto es complicada por la presencia de instrucciones

intermedias try . En ausencia de estas try instrucciones, una instrucción de salto
transfiere incondicionalmente el control de la instrucción de salto a su destino. En
presencia de dichas instrucciones intermedias try , la ejecución es más compleja. Si la
instrucción de salto sale de uno o más try bloques con finally bloques asociados, el
control se transfiere inicialmente al finally bloque de la try instrucción más interna.
Cuando y si el control alcanza el punto final de un finally bloque, el control se
transfiere al finally bloque de la siguiente instrucción de inclusión try . Este proceso
se repite hasta que finally se hayan ejecutado los bloques de todas las instrucciones
que intervienen try .

En el ejemplo

C#

using System;

class Test

static void Main() {

while (true) {

try {

try {

Console.WriteLine("Before break");

break;

finally {

Console.WriteLine("Innermost finally block");

finally {

Console.WriteLine("Outermost finally block");

Console.WriteLine("After break");

los finally bloques asociados a dos try instrucciones se ejecutan antes de que el
control se transfiera al destino de la instrucción de salto.

La salida generada es la siguiente:

Consola

Before break

Innermost finally block

Outermost finally block

After break

Instrucción break
La break instrucción sale de la instrucción de inclusión,,, o más cercana switch while
do for foreach .

antlr

break_statement

: 'break' ';'

El destino de una break instrucción es el punto final de la switch instrucción

envolvente,,, o más cercana while do for foreach . Si una break instrucción no está
delimitada por switch una while instrucción,, do , for o foreach , se produce un error
en tiempo de compilación.

Cuando varias switch instrucciones,,, while do for o foreach se anidan entre sí, una
break instrucción solo se aplica a la instrucción más interna. Para transferir el control

entre varios niveles de anidamiento, goto se debe usar una instrucción (instrucción
Goto).

Una break instrucción no puede salir de un finally bloque (la instrucción try). Cuando
una break instrucción aparece dentro de un finally bloque, el destino de la break
instrucción debe estar dentro del mismo finally bloque; de lo contrario, se produce un
error en tiempo de compilación.

Una break instrucción se ejecuta de la siguiente manera:

Si la break instrucción sale de uno o más try bloques con finally bloques
asociados, el control se transfiere inicialmente al finally bloque de la instrucción
más interna try . Cuando y si el control alcanza el punto final de un finally
bloque, el control se transfiere al finally bloque de la siguiente instrucción de
inclusión try . Este proceso se repite hasta que finally se hayan ejecutado los
bloques de todas las instrucciones que intervienen try .
El control se transfiere al destino de la break instrucción.

Dado break que una instrucción transfiere el control incondicionalmente a otra parte, el
punto final de una break instrucción nunca es accesible.

La instrucción continue
La continue instrucción inicia una nueva iteración de la instrucción envolvente while ,
do , for o más cercana foreach .

antlr

continue_statement

: 'continue' ';'

El destino de una continue instrucción es el punto final de la instrucción incrustada de

la instrucción envolvente while , do , for o más cercana foreach . Si una continue
instrucción no está delimitada por while una do instrucción,, for o foreach , se
produce un error en tiempo de compilación.

Cuando varias while do instrucciones,, for o foreach se anidan entre sí, una continue
instrucción solo se aplica a la instrucción más interna. Para transferir el control entre
varios niveles de anidamiento, goto se debe usar una instrucción (instrucción Goto).

Una continue instrucción no puede salir de un finally bloque (la instrucción try).
Cuando una continue instrucción aparece dentro de un finally bloque, el destino de la
continue instrucción debe estar dentro del mismo finally bloque; de lo contrario, se

produce un error en tiempo de compilación.

Una continue instrucción se ejecuta de la siguiente manera:

Si la continue instrucción sale de uno o más try bloques con finally bloques
asociados, el control se transfiere inicialmente al finally bloque de la instrucción
más interna try . Cuando y si el control alcanza el punto final de un finally
bloque, el control se transfiere al finally bloque de la siguiente instrucción de
inclusión try . Este proceso se repite hasta que finally se hayan ejecutado los
bloques de todas las instrucciones que intervienen try .
El control se transfiere al destino de la continue instrucción.

Dado continue que una instrucción transfiere el control incondicionalmente a otra

parte, el punto final de una continue instrucción nunca es accesible.

La instrucción goto
La goto instrucción transfiere el control a una instrucción marcada por una etiqueta.

antlr
 goto_statement

: 'goto' identifier ';'

| 'goto' 'case' constant_expression ';'

| 'goto' 'default' ';'

El destino de una goto instrucción Identifier es la instrucción con etiqueta con la

etiqueta especificada. Si no existe una etiqueta con el nombre especificado en el
miembro de función actual, o si la goto instrucción no está dentro del ámbito de la
etiqueta, se produce un error en tiempo de compilación. Esta regla permite el uso de
una goto instrucción para transferir el control fuera de un ámbito anidado, pero no a un
ámbito anidado. En el ejemplo

C#

using System;

class Test

static void Main(string[] args) {

string[,] table = {

{"Red", "Blue", "Green"},

{"Monday", "Wednesday", "Friday"}

};

foreach (string str in args) {

int row, colm;

for (row = 0; row <= 1; ++row)

for (colm = 0; colm <= 2; ++colm)

if (str == table[row,colm])

goto done;

Console.WriteLine("{0} not found", str);

continue;

done:

Console.WriteLine("Found {0} at [{1}][{2}]", str, row, colm);

una goto instrucción se usa para transferir el control fuera de un ámbito anidado.

El destino de una goto case instrucción es la lista de instrucciones de la instrucción de

inclusión inmediata switch (la instrucción switch), que contiene una case etiqueta con
el valor constante especificado. Si la goto case instrucción no está delimitada por una
switch instrucción, si el constant_expression no es implícitamente convertible

(conversiones implícitas) al tipo aplicable de la instrucción de inclusión más cercana

switch , o si la instrucción de inclusión más cercana no switch contiene una case

etiqueta con el valor constante especificado, se produce un error en tiempo de

compilación.

El destino de una goto default instrucción es la lista de instrucciones de la instrucción

de inclusión inmediata switch (la instrucción switch), que contiene una default
etiqueta. Si la goto default instrucción no está delimitada por una switch instrucción, o
si la instrucción de inclusión más cercana no switch contiene una default etiqueta, se
produce un error en tiempo de compilación.

Una goto instrucción no puede salir de un finally bloque (la instrucción try). Cuando
una goto instrucción aparece dentro de un finally bloque, el destino de la goto
instrucción debe estar dentro del mismo finally bloque o, de lo contrario, se producirá
un error en tiempo de compilación.

Una goto instrucción se ejecuta de la siguiente manera:

Si la goto instrucción sale de uno o más try bloques con finally bloques
asociados, el control se transfiere inicialmente al finally bloque de la instrucción
más interna try . Cuando y si el control alcanza el punto final de un finally
bloque, el control se transfiere al finally bloque de la siguiente instrucción de
inclusión try . Este proceso se repite hasta que finally se hayan ejecutado los
bloques de todas las instrucciones que intervienen try .
El control se transfiere al destino de la goto instrucción.

Dado goto que una instrucción transfiere el control incondicionalmente a otra parte, el
punto final de una goto instrucción nunca es accesible.

La instrucción return
La return instrucción devuelve el control al llamador actual de la función en la que
return aparece la instrucción.

antlr

return_statement

: 'return' expression? ';'

Una return instrucción sin expresión solo se puede usar en un miembro de función que
no calcule un valor, es decir, un método con el tipo de resultado (cuerpo del método)
void , el set descriptor de acceso de una propiedad o un indizador, y descriptores add
remove de acceso de un evento, un constructor de instancia, un constructor estático o

un destructor.

Una return instrucción con una expresión solo se puede usar en un miembro de
función que calcula un valor, es decir, un método con un tipo de resultado no void, el
get descriptor de acceso de una propiedad o un indizador, o un operador definido por

el usuario. Debe existir una conversión implícita (conversiones implícitas) del tipo de la
expresión al tipo de valor devuelto del miembro de función contenedora.

Las instrucciones Return también se pueden utilizar en el cuerpo de expresiones de

función anónimas (expresiones de función anónimas) y participar en la determinación
de las conversiones que existen para esas funciones.

Se trata de un error en tiempo de compilación para return que una instrucción

aparezca en un finally bloque (la instrucción try).

Una return instrucción se ejecuta de la siguiente manera:

Si la return instrucción especifica una expresión, se evalúa la expresión y el valor

resultante se convierte al tipo de valor devuelto de la función que la contiene
mediante una conversión implícita. El resultado de la conversión se convierte en el
valor de resultado producido por la función.
Si la return instrucción está incluida en uno o varios try catch bloques o con
finally bloques asociados, el control se transfiere inicialmente al finally bloque
de la instrucción más interna try . Cuando y si el control alcanza el punto final de
un finally bloque, el control se transfiere al finally bloque de la siguiente
instrucción de inclusión try . Este proceso se repite hasta que finally se hayan
ejecutado los bloques de todas las instrucciones envolventes try .
Si la función contenedora no es una función asincrónica, el control se devuelve al
autor de la llamada de la función contenedora junto con el valor del resultado, si
existe.
Si la función contenedora es una función asincrónica, el control se devuelve al
llamador actual y el valor del resultado, si existe, se registra en la tarea devuelta tal
y como se describe en (interfaces del enumerador).

Dado return que una instrucción transfiere el control incondicionalmente a otra parte,
el punto final de una return instrucción nunca es accesible.

La instrucción throw
La instrucción throw genera una excepción.
 antlr

throw_statement

: 'throw' expression? ';'

Una throw instrucción con una expresión inicia el valor generado al evaluar la expresión.
La expresión debe indicar un valor del tipo de clase System.Exception , de un tipo de
clase que se deriva de System.Exception o de un tipo de parámetro de tipo que tiene
System.Exception (o una subclase de ella) como su clase base efectiva. Si la evaluación

de la expresión produce null , System.NullReferenceException se produce una

excepción en su lugar.

Una throw instrucción sin expresión solo se puede usar en un catch bloque, en cuyo
caso la instrucción vuelve a iniciar la excepción que está controlando actualmente ese
catch bloque.

Dado throw que una instrucción transfiere el control incondicionalmente a otra parte, el
punto final de una throw instrucción nunca es accesible.

Cuando se produce una excepción, el control se transfiere a la primera catch cláusula

de una instrucción de inclusión try que puede controlar la excepción. El proceso que
tiene lugar desde el punto de la excepción que se está iniciando hasta el punto de
transferir el control a un controlador de excepciones adecuado se conoce como
*propagación de excepciones _. La propagación de una excepción consiste en evaluar
repetidamente los siguientes pasos hasta que catch se encuentre una cláusula que
coincida con la excepción. En esta descripción, el punto _ Throw* es inicialmente la
ubicación en la que se produce la excepción.

En el miembro de función actual, try se examina cada instrucción que incluye el

punto de inicio. Para cada instrucción S , empezando por la instrucción más
interna try y finalizando con la try instrucción externa, se evalúan los pasos
siguientes:

Si el try bloque de incluye S el punto de inicio y si S tiene una o más catch

cláusulas, las catch cláusulas se examinan en orden de aparición para encontrar
un controlador adecuado para la excepción, de acuerdo con las reglas
especificadas en la sección instrucción try. Si catch se encuentra una cláusula
coincidente, la propagación de excepciones se completa mediante la
transferencia del control al bloque de esa catch cláusula.
 De lo contrario, si el try bloque o un catch bloque de incluye S el punto de
inicio y si S tiene un finally bloque, el control se transfiere al finally bloque.
Si el finally bloque produce otra excepción, finaliza el procesamiento de la
excepción actual. De lo contrario, cuando el control alcanza el punto final del
finally bloque, continúa el procesamiento de la excepción actual.

Si no se encuentra un controlador de excepciones en la invocación de función

actual, se termina la invocación de la función y se produce uno de los siguientes
casos:

Si la función actual no es asincrónica, los pasos anteriores se repiten para el

llamador de la función con un punto de inicio correspondiente a la instrucción
de la que se invocó el miembro de función.

Si la función actual es asincrónica y devuelve la tarea, la excepción se registra en

la tarea devuelta, que se coloca en un estado de error o cancelado, tal y como
se describe en interfaces de enumerador.

Si la función actual es asincrónica y devuelve void, el contexto de sincronización

del subproceso actual se notifica como se describe en interfaces enumerables.

Si el procesamiento de excepciones finaliza todas las invocaciones de miembros de

función en el subproceso actual, lo que indica que el subproceso no tiene ningún
controlador para la excepción, el subproceso se termina. El impacto de dicha
terminación está definido por la implementación.

Instrucción try
La try instrucción proporciona un mecanismo para detectar las excepciones que se
producen durante la ejecución de un bloque. Además, la try instrucción proporciona la
capacidad de especificar un bloque de código que siempre se ejecuta cuando el control
sale de la try instrucción.

antlr

try_statement

: 'try' block catch_clause+

| 'try' block finally_clause

| 'try' block catch_clause+ finally_clause

catch_clause

: 'catch' exception_specifier? exception_filter? block

 exception_specifier

: '(' type identifier? ')'

exception_filter

: 'when' '(' expression ')'

finally_clause

: 'finally' block

Hay tres formas posibles de try instrucciones:

Un try bloque seguido de uno o varios catch bloques.

Un try bloque seguido de un finally bloque.
Un try bloque seguido de uno o varios catch bloques seguidos de un finally
bloque.

Cuando una catch cláusula especifica un exception_specifier, el tipo debe ser

System.Exception , un tipo que se deriva de System.Exception o un tipo de parámetro

de tipo que tiene System.Exception (o una subclase de ella) como su clase base efectiva.

Cuando una catch cláusula especifica un exception_specifier con un identificador, se

declara una variable de excepción* _ del nombre y tipo especificados. La variable de
excepción corresponde a una variable local con un ámbito que se extiende por encima
de la catch cláusula. Durante la ejecución del _exception_filter * y el bloque, la variable
de excepción representa la excepción que se está controlando actualmente. A efectos
de la comprobación de asignación definitiva, la variable de excepción se considera
asignada definitivamente en todo el ámbito.

A menos que una catch cláusula incluya un nombre de variable de excepción, no es

posible tener acceso al objeto de excepción en el filtro y catch bloque.

Una catch cláusula que no especifica un exception_specifier se denomina catch cláusula

general.

Algunos lenguajes de programación pueden admitir excepciones que no pueden

representarse como un objeto derivado de System.Exception , aunque estas
excepciones nunca podrían generarse en el código de C#. catch Se puede usar una
cláusula general para detectar tales excepciones. Por lo tanto, una catch cláusula
general es semánticamente diferente de una que especifica el tipo System.Exception ,
en que la primera también puede detectar excepciones de otros lenguajes.
Para buscar un controlador de una excepción, las catch cláusulas se examinan en orden
léxico. Si una catch cláusula especifica un tipo pero no un filtro de excepción, se trata
de un error en tiempo de compilación para una catch cláusula posterior en la misma
try instrucción para especificar un tipo que sea igual o derivado de ese tipo. Si una
catch cláusula no especifica ningún tipo y no hay ningún filtro, debe ser la última catch

cláusula para esa try instrucción.

Dentro de un catch bloque, throw se puede usar una instrucción (instrucción throw) sin
expresión para volver a producir la excepción detectada por el catch bloque. Las
asignaciones a una variable de excepción no modifican la excepción que se vuelve a
iniciar.

En el ejemplo

C#

using System;

class Test

static void F() {

try {

G();

catch (Exception e) {

Console.WriteLine("Exception in F: " + e.Message);

e = new Exception("F");

throw; // re-throw

static void G() {

throw new Exception("G");

static void Main() {

try {

F();

catch (Exception e) {

Console.WriteLine("Exception in Main: " + e.Message);

el método F detecta una excepción, escribe información de diagnóstico en la consola,

modifica la variable de excepción y vuelve a producir la excepción. La excepción que se
vuelve a producir es la excepción original, por lo que la salida generada es:
 Consola

Exception in F: G

Exception in Main: G

Si se produjo el primer bloque catch e en lugar de volver a producir la excepción actual,

la salida generada sería la siguiente:

Consola

Exception in F: G

Exception in Main: F

Es un error en tiempo de compilación para una break continue instrucción, o goto para
transferir el control fuera de un finally bloque. Cuando una break continue
instrucción, o goto aparece en un finally bloque, el destino de la instrucción debe
estar dentro del mismo finally bloque o, de lo contrario, se produce un error en
tiempo de compilación.

Se trata de un error en tiempo de compilación para return que una instrucción se

produzca en un finally bloque.

Una try instrucción se ejecuta de la siguiente manera:

El control se transfiere al try bloque.

When y si el control alcanza el punto final del try bloque:

Si la try instrucción tiene un finally bloque, finally se ejecuta el bloque.
El control se transfiere al punto final de la try instrucción.

Si una excepción se propaga a la try instrucción durante la ejecución del try

bloque:
Las catch cláusulas, si las hay, se examinan en orden de aparición para
encontrar un controlador adecuado para la excepción. Si una catch cláusula no
especifica un tipo, o especifica el tipo de excepción o un tipo base del tipo de
excepción:
Si la catch cláusula declara una variable de excepción, el objeto de
excepción se asigna a la variable de excepción.
Si la catch cláusula declara un filtro de excepción, se evalúa el filtro. Si se
evalúa como false , la cláusula catch no es una coincidencia y la búsqueda
continúa a través catch de las cláusulas posteriores de un controlador
adecuado.
 De lo contrario, la catch cláusula se considera una coincidencia y el control
se transfiere al catch bloque coincidente.
When y si el control alcanza el punto final del catch bloque:
Si la try instrucción tiene un finally bloque, finally se ejecuta el
bloque.
El control se transfiere al punto final de la try instrucción.
Si una excepción se propaga a la try instrucción durante la ejecución del
catch bloque:

Si la try instrucción tiene un finally bloque, finally se ejecuta el

bloque.
La excepción se propaga a la siguiente instrucción de inclusión try .
Si la try instrucción no tiene catch cláusulas o si ninguna catch cláusula
coincide con la excepción:
Si la try instrucción tiene un finally bloque, finally se ejecuta el bloque.
La excepción se propaga a la siguiente instrucción de inclusión try .

Las instrucciones de un finally bloque siempre se ejecutan cuando el control sale de

una try instrucción. Esto es cierto si la transferencia de control se produce como
resultado de la ejecución normal, como resultado de la ejecución de una break
continue instrucción,, goto o return , o como resultado de propagar una excepción
fuera de la try instrucción.

Si se produce una excepción durante la ejecución de un finally bloque y no se detecta

en el mismo bloque Finally, la excepción se propaga a la siguiente instrucción
envolvente try . Si hay otra excepción en el proceso de propagación, se perderá esa
excepción. El proceso de propagación de una excepción se describe con más detalle en
la descripción de la throw instrucción (la instrucción throw).

El try bloque de una try instrucción es accesible si la try instrucción es accesible.

catch Se puede tener acceso a un bloque de una try instrucción si la try instrucción es

accesible.

El finally bloque de una try instrucción es accesible si la try instrucción es accesible.

El punto final de una try instrucción es accesible si se cumplen las dos condiciones
siguientes:

El punto final del try bloque es accesible o catch se puede tener acceso al punto
final de al menos un bloque.
 Si finally hay un bloque, finally se puede tener acceso al punto final del
bloque.

Instrucciones checked y unchecked

Las checked unchecked instrucciones y se utilizan para controlar el contexto de
comprobación de desbordamiento para conversiones y operaciones aritméticas de tipo
entero.

antlr

checked_statement

: 'checked' block

unchecked_statement

: 'unchecked' block
;

La checked instrucción hace que todas las expresiones del bloque se evalúen en un
contexto comprobado, y la unchecked instrucción hace que todas las expresiones del
bloque se evalúen en un contexto no comprobado.

Las checked unchecked instrucciones y son exactamente equivalentes a checked los

unchecked operadores y (los operadores Checked y unchecked), salvo que operan en
bloques en lugar de en expresiones.

lock (instrucción)
La lock instrucción obtiene el bloqueo de exclusión mutua para un objeto determinado,
ejecuta una instrucción y, a continuación, libera el bloqueo.

antlr

lock_statement

: 'lock' '(' expression ')' embedded_statement

La expresión de una lock instrucción debe indicar un valor de un tipo conocido como
reference_type. No se realiza ninguna conversión boxing implícita (conversiones boxing)
en la expresión de una lock instrucción y, por lo tanto, es un error en tiempo de
compilación para que la expresión denote un valor de un value_type.
Una lock instrucción con el formato

C#

lock (x) ...

donde x es una expresión de un reference_type, es precisamente equivalente a

C#

bool __lockWasTaken = false;

try {

System.Threading.Monitor.Enter(x, ref __lockWasTaken);

...

finally {

if (__lockWasTaken) System.Threading.Monitor.Exit(x);

salvo que x solo se evalúa una vez.

Mientras se mantiene un bloqueo de exclusión mutua, el código que se ejecuta en el

mismo subproceso de ejecución también puede obtener y liberar el bloqueo. Sin
embargo, el código que se ejecuta en otros subprocesos no obtiene el bloqueo hasta
que se libera el bloqueo.

System.Type No se recomienda el bloqueo de objetos para sincronizar el acceso a los

datos estáticos. Otro código podría bloquearse en el mismo tipo, lo que puede provocar
un interbloqueo. Un mejor enfoque es sincronizar el acceso a los datos estáticos
bloqueando un objeto estático privado. Por ejemplo:

C#

class Cache

private static readonly object synchronizationObject = new object();

public static void Add(object x) {

lock (Cache.synchronizationObject) {

...

public static void Remove(object x) {

lock (Cache.synchronizationObject) {

...

La instrucción using
La using instrucción obtiene uno o más recursos, ejecuta una instrucción y, a
continuación, desecha el recurso.

antlr

using_statement

: 'using' '(' resource_acquisition ')' embedded_statement

resource_acquisition

: local_variable_declaration

| expression

Un recurso es una clase o estructura que implementa System.IDisposable , que incluye

un único método sin parámetros denominado Dispose . El código que usa un recurso
puede llamar Dispose a para indicar que el recurso ya no es necesario. Si Dispose no se
llama a, la eliminación automática se produce finalmente como consecuencia de la
recolección de elementos no utilizados.

Si el formato de resource_acquisition es local_variable_declaration , el tipo de la

local_variable_declaration debe ser dynamic o un tipo que se pueda convertir
implícitamente en System.IDisposable . Si el formato de resource_acquisition es
Expression , esta expresión debe poder convertirse implícitamente en
System.IDisposable .

Las variables locales declaradas en un resource_acquisition son de solo lectura y deben

incluir un inicializador. Se produce un error en tiempo de compilación si la instrucción
incrustada intenta modificar estas variables locales (a través de la asignación o los ++ -
- operadores y), tomar la dirección de ellas o pasarlas como ref out parámetros o.

Una using instrucción se traduce en tres partes: adquisición, uso y eliminación. El uso
del recurso se adjunta implícitamente en una try instrucción que incluye una finally
cláusula. Esta finally cláusula desecha el recurso. Si null se adquiere un recurso, no se
realiza ninguna llamada a Dispose y no se produce ninguna excepción. Si el recurso es
de tipo dynamic , se convierte dinámicamente a través de una conversión dinámica
implícita (conversiones dinámicas implícitas) en IDisposable durante la adquisición para
asegurarse de que la conversión se realiza correctamente antes del uso y la eliminación.

Una using instrucción con el formato

C#

using (ResourceType resource = expression) statement

corresponde a una de las tres expansiones posibles. Cuando ResourceType es un tipo de

valor que no acepta valores NULL, la expansión es

C#

ResourceType resource = expression;

try {

statement;

finally {

((IDisposable)resource).Dispose();

De lo contrario, cuando ResourceType es un tipo de valor que acepta valores NULL o un

tipo de referencia distinto de dynamic , la expansión es

C#

ResourceType resource = expression;

try {

statement;

finally {

if (resource != null) ((IDisposable)resource).Dispose();

De lo contrario, cuando ResourceType es dynamic , la expansión es

C#

ResourceType resource = expression;

IDisposable d = (IDisposable)resource;

try {

statement;

finally {

if (d != null) d.Dispose();

En cualquier expansión, la resource variable es de solo lectura en la instrucción

incrustada, y d no se puede obtener acceso a la variable en la instrucción incrustada y
no es visible para ella.

Una implementación puede implementar una instrucción using determinada de forma

diferente, por ejemplo, por motivos de rendimiento, siempre que el comportamiento
sea coherente con la expansión anterior.

Una using instrucción con el formato

C#

using (expression) statement

tiene las mismas tres expansiones posibles. En este caso ResourceType , es

implícitamente el tipo en tiempo de compilación de expression , si tiene uno. En caso
contrario, la IDisposable propia interfaz se utiliza como ResourceType . resource No se
puede obtener acceso a la variable en y no es visible para la instrucción incrustada.

Cuando un resource_acquisition adopta la forma de un local_variable_declaration, es

posible adquirir varios recursos de un tipo determinado. Una using instrucción con el
formato

C#

using (ResourceType r1 = e1, r2 = e2, ..., rN = eN) statement

es exactamente equivalente a una secuencia de instrucciones anidadas using :

C#

using (ResourceType r1 = e1)

using (ResourceType r2 = e2)

...

using (ResourceType rN = eN)

statement

En el ejemplo siguiente se crea un archivo denominado log.txt y se escriben dos líneas

de texto en el archivo. A continuación, el ejemplo abre el mismo archivo para leer y
copia las líneas de texto contenidas en la consola.

C#

using System;

using System.IO;

class Test

static void Main() {

using (TextWriter w = File.CreateText("log.txt")) {

w.WriteLine("This is line one");

w.WriteLine("This is line two");

using (TextReader r = File.OpenText("log.txt")) {

string s;

while ((s = r.ReadLine()) != null) {

Console.WriteLine(s);

Dado que TextWriter las TextReader clases y implementan la IDisposable interfaz, el

ejemplo puede utilizar using instrucciones para asegurarse de que el archivo
subyacente está cerrado correctamente después de las operaciones de escritura o
lectura.

Yield (instrucción)
La yield instrucción se usa en un bloque de iteradores (bloques) para obtener un valor
para el objeto enumerador (objetos enumerador) o el objeto enumerable (objetos
enumerables) de un iterador o para señalar el final de la iteración.

antlr

yield_statement

: 'yield' 'return' expression ';'

| 'yield' 'break' ';'

yield no es una palabra reservada; tiene un significado especial solo cuando se usa

inmediatamente antes de una return break palabra clave o. En otros contextos, yield
se puede usar como identificador.

Hay varias restricciones sobre dónde yield puede aparecer una instrucción, tal y como
se describe a continuación.

Es un error en tiempo de compilación que una yield instrucción (de cualquier

forma) aparezca fuera de un method_body, operator_body o accessor_body
Es un error en tiempo de compilación para una yield instrucción (de cualquier
forma) que aparezca dentro de una función anónima.
Es un error en tiempo de compilación para una yield instrucción (de cualquier
forma) que aparezca en la finally cláusula de una try instrucción.
Se trata de un error en tiempo de compilación para yield return que una
instrucción aparezca en cualquier parte de una try instrucción que contenga
catch cláusulas.

En el ejemplo siguiente se muestran algunos usos válidos y no válidos de las yield

instrucciones.

C#

delegate IEnumerable<int> D();

IEnumerator<int> GetEnumerator() {

try {

yield return 1; // Ok

yield break; // Ok

finally {

yield return 2; // Error, yield in finally

yield break; // Error, yield in finally

try {

yield return 3; // Error, yield return in try...catch

yield break; // Ok

catch {

yield return 4; // Error, yield return in try...catch

yield break; // Ok

D d = delegate {

yield return 5; // Error, yield in an anonymous function

};

 int MyMethod() {

yield return 1; // Error, wrong return type for an iterator

block

Debe existir una conversión implícita (conversiones implícitas) del tipo de la expresión
en la yield return instrucción al tipo yield (yield Type) del iterador.

Una yield return instrucción se ejecuta de la siguiente manera:

La expresión dada en la instrucción se evalúa, se convierte implícitamente al tipo

Yield y se asigna a la Current propiedad del objeto enumerador.
La ejecución del bloque de iterador está suspendida. Si la yield return instrucción
está dentro de uno o más try bloques, los finally bloques asociados no se
ejecutan en este momento.
El MoveNext método del objeto de enumerador vuelve true a su llamador, lo que
indica que el objeto de enumerador avanzó correctamente al siguiente elemento.

La siguiente llamada al método del objeto de enumerador MoveNext reanuda la

ejecución del bloque de iterador desde donde se suspendió por última vez.

Una yield break instrucción se ejecuta de la siguiente manera:

Si la yield break instrucción está delimitada por uno o más try bloques con
finally bloques asociados, el control se transfiere inicialmente al finally bloque

de la try instrucción más interna. Cuando y si el control alcanza el punto final de

un finally bloque, el control se transfiere al finally bloque de la siguiente
instrucción de inclusión try . Este proceso se repite hasta que finally se hayan
ejecutado los bloques de todas las instrucciones envolventes try .
El control se devuelve al llamador del bloque de iteradores. Este es el MoveNext
método o el Dispose método del objeto de enumerador.

Dado yield break que una instrucción transfiere el control incondicionalmente a otra
parte, el punto final de una yield break instrucción nunca es accesible.
Espacios de nombres
Artículo • 16/09/2021 • Tiempo de lectura: 18 minutos

Los programas de C# se organizan mediante espacios de nombres. Los espacios de

nombres se usan como un sistema de organización "interno" para un programa, y como
un sistema de organización "externo", una manera de presentar los elementos de
programa que se exponen a otros programas.

Las directivas Using (directivas Using) se proporcionan para facilitar el uso de espacios
de nombres.

Unidades de compilación
Un compilation_unit define la estructura global de un archivo de código fuente. Una
unidad de compilación consta de cero o más using_directive s seguidos de cero o más
global_attributes seguidos de cero o más namespace_member_declaration s.

antlr

compilation_unit

: extern_alias_directive* using_directive* global_attributes?

namespace_member_declaration*

Un programa de C# se compone de una o varias unidades de compilación, cada una de

ellas en un archivo de código fuente independiente. Cuando se compila un programa de
C#, todas las unidades de compilación se procesan juntas. Por lo tanto, las unidades de
compilación pueden depender entre sí, posiblemente de manera circular.

Los using_directive de una unidad de compilación afectan al global_attributes y

namespace_member_declaration s de esa unidad de compilación, pero no tienen ningún
efecto en otras unidades de compilación.

Los global_attributes (atributos) de una unidad de compilación permiten la

especificación de atributos para el ensamblado y el módulo de destino. Los
ensamblados y los módulos actúan como contenedores físicos para los tipos. Un
ensamblado puede constar de varios módulos físicamente separados.

El namespace_member_declaration s de cada unidad de compilación de un programa

contribuye a los miembros a un solo espacio de declaración denominado espacio de
nombres global. Por ejemplo:
Archivo A.cs :

C#

class A {}

Archivo B.cs :

C#

class B {}

Las dos unidades de compilación contribuyen al espacio de nombres global único; en

este caso, se declaran dos clases con los nombres completos A y B . Dado que las dos
unidades de compilación contribuyen al mismo espacio de declaración, habría sido un
error si cada una de ellas contenía una declaración de un miembro con el mismo
nombre.

Declaraciones de espacios de nombres

Un namespace_declaration consta de la palabra clave namespace , seguido de un nombre
de espacio de nombres y un cuerpo, seguido opcionalmente de un punto y coma.

antlr

namespace_declaration

: 'namespace' qualified_identifier namespace_body ';'?

qualified_identifier

: identifier ('.' identifier)*

namespace_body

: '{' extern_alias_directive* using_directive*

namespace_member_declaration* '}'

Un namespace_declaration puede producirse como una declaración de nivel superior en

un compilation_unit o como una declaración de miembro dentro de otra
namespace_declaration. Cuando se produce un namespace_declaration como una
declaración de nivel superior en una compilation_unit, el espacio de nombres se
convierte en un miembro del espacio de nombres global. Cuando se produce un
namespace_declaration dentro de otro namespace_declaration, el espacio de nombres
interno se convierte en un miembro del espacio de nombres exterior. En cualquier caso,
el nombre de un espacio de nombres debe ser único dentro del espacio de nombres
que lo contiene.

Los espacios de nombres son implícitamente public y la declaración de un espacio de

nombres no puede incluir modificadores de acceso.

Dentro de un namespace_body, los using_directive s opcionales importan los nombres de

otros espacios de nombres, tipos y miembros, lo que permite hacer referencia a ellos
directamente en lugar de a través de nombres completos. El
namespace_member_declaration s opcional contribuye al espacio de declaración del
espacio de nombres. Tenga en cuenta que todos los using_directive s deben aparecer
antes de cualquier declaración de miembro.

El qualified_identifier de un namespace_declaration puede ser un identificador único o

una secuencia de identificadores separados por " . " tokens. El último formulario
permite a un programa definir un espacio de nombres anidado sin anidar léxicamente
varias declaraciones de espacios de nombres. Por ejemplo,

C#

namespace N1.N2

class A {}

class B {}

es semánticamente equivalente a

C#

namespace N1

namespace N2

class A {}

class B {}

Los espacios de nombres están abiertos y dos declaraciones de espacios de nombres

con el mismo nombre completo contribuyen al mismo espacio de declaración
(declaraciones). En el ejemplo
 C#

namespace N1.N2

class A {}

namespace N1.N2

class B {}

las dos declaraciones de espacio de nombres anteriores contribuyen al mismo espacio

de declaración; en este caso, se declaran dos clases con los nombres completos N1.N2.A
y N1.N2.B . Dado que las dos declaraciones contribuyen al mismo espacio de
declaración, se habría producido un error si cada una de ellas contenía una declaración
de un miembro con el mismo nombre.

Alias externos
Una extern_alias_directive introduce un identificador que actúa como un alias para un
espacio de nombres. La especificación del espacio de nombres con alias es externa al
código fuente del programa y se aplica también a los espacios de nombres anidados del
espacio de nombres con alias.

antlr

extern_alias_directive

: 'extern' 'alias' identifier ';'

El ámbito de un extern_alias_directive se extiende por las using_directive s,

global_attributes y namespace_member_declaration s de su unidad de compilación o
cuerpo de espacio de nombres que contiene inmediatamente.

Dentro de una unidad de compilación o un cuerpo de espacio de nombres que contiene

un extern_alias_directive, el identificador introducido por el extern_alias_directive se
puede usar para hacer referencia al espacio de nombres con alias. Se trata de un error
en tiempo de compilación para que el identificador sea la palabra global .

Un extern_alias_directive hace que un alias esté disponible dentro de una unidad de

compilación o un cuerpo de espacio de nombres concretos, pero no aporta ningún
miembro nuevo al espacio de declaración subyacente. En otras palabras, una
extern_alias_directive no es transitiva, sino que afecta solo a la unidad de compilación o
al cuerpo del espacio de nombres en el que se produce.

El programa siguiente declara y usa dos alias extern, X y Y , cada uno de los cuales
representa la raíz de una jerarquía de espacios de nombres distinta:

C#

extern alias X;

extern alias Y;

class Test

X::N.A a;

X::N.B b1;

Y::N.B b2;

Y::N.C c;

El programa declara la existencia de los alias extern X y Y , pero las definiciones reales
de los alias son externas al programa. N.B Ahora se puede hacer referencia a las clases
con el mismo nombre como X.N.B y Y.N.B , o mediante el calificador de alias del
espacio de nombres, X::N.B y Y::N.B . Se produce un error si un programa declara un
alias extern para el que no se proporciona ninguna definición externa.

Directivas Using
*El uso de directivas _ facilita el uso de espacios de nombres y tipos definidos en otros
espacios de nombres. Las directivas de uso afectan al proceso de resolución de nombres
de _namespace_or_type_name * s (nombres de espacio de nombres y tipos) y
simple_name s (nombres simples), pero a diferencia de las declaraciones, las directivas
Using no aportan nuevos miembros a los espacios de declaración subyacentes de las
unidades de compilación o los espacios de nombres en los que se utilizan.

antlr

using_directive

: using_alias_directive

| using_namespace_directive

| using_static_directive

Un using_alias_directive (mediante directivas de alias) introduce un alias para un espacio

de nombres o un tipo.
Un using_namespace_directive (mediante directivas de espacio de nombres) importa los
miembros de tipo de un espacio de nombres.

Un using_static_directive (mediante directivas estáticas) importa los tipos anidados y los

miembros estáticos de un tipo.

El ámbito de una using_directive amplía el namespace_member_declaration s de la

unidad de compilación o el cuerpo del espacio de nombres que contiene
inmediatamente. El ámbito de un using_directive no incluye específicamente sus
using_directive s del mismo nivel. Por lo tanto, los using_directive del mismo nivel no
afectan entre sí y el orden en el que se escriben es insignificante.

Usar directivas de alias

Una using_alias_directive introduce un identificador que actúa como alias para un
espacio de nombres o tipo dentro de la unidad de compilación o el cuerpo del espacio
de nombres que se encuentra inmediatamente.

antlr

using_alias_directive

: 'using' identifier '=' namespace_or_type_name ';'

Dentro de las declaraciones de miembros de una unidad de compilación o un cuerpo de

espacio de nombres que contiene un using_alias_directive, el identificador introducido
por el using_alias_directive se puede usar para hacer referencia al espacio de nombres o
tipo especificado. Por ejemplo:

C#

namespace N1.N2

class A {}

namespace N3

using A = N1.N2.A;

class B: A {}

Anteriormente, dentro de las declaraciones de miembros del N3 espacio de nombres, A

es un alias para N1.N2.A y, por lo tanto, la clase N3.B deriva de la clase N1.N2.A . Se
puede obtener el mismo efecto si se crea un alias R para N1.N2 y, a continuación, se
hace referencia a R.A :

C#

namespace N3

using R = N1.N2;

class B: R.A {}

El identificador de un using_alias_directive debe ser único en el espacio de declaración

de la unidad de compilación o espacio de nombres que contiene inmediatamente el
using_alias_directive. Por ejemplo:

C#

namespace N3

class A {}

namespace N3

using A = N1.N2.A; // Error, A already exists

Anteriormente, N3 ya contiene un miembro A , por lo que es un error en tiempo de

compilación para que un using_alias_directive use ese identificador. Del mismo modo, se
trata de un error en tiempo de compilación para dos o más using_alias_directive s en la
misma unidad de compilación o cuerpo del espacio de nombres para declarar alias con
el mismo nombre.

Un using_alias_directive hace que un alias esté disponible dentro de una unidad de

compilación o un cuerpo de espacio de nombres concretos, pero no aporta ningún
miembro nuevo al espacio de declaración subyacente. En otras palabras, una
using_alias_directive no es transitiva sino que solo afecta a la unidad de compilación o al
cuerpo del espacio de nombres en el que se produce. En el ejemplo

C#

namespace N3

using R = N1.N2;

 namespace N3

class B: R.A {} // Error, R unknown

el ámbito de la using_alias_directive que introduce R solo se extiende a las declaraciones

de miembros en el cuerpo del espacio de nombres en el que está contenido, por lo que
R se desconoce en la segunda declaración de espacio de nombres. Sin embargo,

colocar el using_alias_directive en la unidad de compilación contenedora hace que el

alias esté disponible en ambas declaraciones de espacio de nombres:

C#

using R = N1.N2;

namespace N3

class B: R.A {}

namespace N3

class C: R.A {}

Al igual que los miembros normales, los nombres introducidos por using_alias_directive
s están ocultos por miembros con el mismo nombre en ámbitos anidados. En el ejemplo

C#

using R = N1.N2;

namespace N3

class R {}

class B: R.A {} // Error, R has no member A

la referencia a R.A en la declaración de B produce un error en tiempo de compilación

porque R hace referencia a N3.R , no a N1.N2 .

El orden en el que se escriben using_alias_directive s no tiene importancia y la resolución

de los namespace_or_type_name a los que hace referencia un using_alias_directive no se
ve afectada por la using_alias_directive misma o por otras using_directive en la unidad de
compilación o el cuerpo del espacio de nombres que contiene inmediatamente. En otras
palabras, el namespace_or_type_name de una using_alias_directive se resuelve como si la
unidad de compilación o el cuerpo del espacio de nombres que contiene no tengan
using_directive s. No obstante, un using_alias_directive puede verse afectado por
extern_alias_directive s en la unidad de compilación o el cuerpo del espacio de nombres
que contiene inmediatamente. En el ejemplo

C#

namespace N1.N2 {}

namespace N3

extern alias E;

using R1 = E.N; // OK

using R2 = N1; // OK

using R3 = N1.N2; // OK

using R4 = R2.N2; // Error, R2 unknown

el último using_alias_directive produce un error en tiempo de compilación porque no se

ve afectado por la primera using_alias_directive. La primera using_alias_directive no
produce un error, puesto que el ámbito del alias extern E incluye el using_alias_directive.

Un using_alias_directive puede crear un alias para cualquier espacio de nombres o tipo,

incluido el espacio de nombres en el que aparece y cualquier espacio de nombres o tipo
anidado dentro de ese espacio de nombres.

El acceso a un espacio de nombres o a un tipo a través de un alias produce exactamente

el mismo resultado que el acceso a ese espacio de nombres o el tipo a través de su
nombre declarado. Por ejemplo, dado

C#

namespace N1.N2

class A {}

namespace N3

using R1 = N1;

using R2 = N1.N2;

class B

N1.N2.A a; // refers to N1.N2.A

 R1.N2.A b; // refers to N1.N2.A

R2.A c; // refers to N1.N2.A

los nombres N1.N2.A , R1.N2.A y R2.A son equivalentes y todos hacen referencia a la
clase cuyo nombre completo es N1.N2.A .

El uso de alias puede asignar un nombre a un tipo construido cerrado, pero no puede
asignar un nombre a una declaración de tipo genérico sin enlazar sin proporcionar
argumentos de tipo. Por ejemplo:

C#

namespace N1

class A<T>

class B {}

namespace N2

using W = N1.A; // Error, cannot name unbound generic type

using X = N1.A.B; // Error, cannot name unbound generic type

using Y = N1.A<int>; // Ok, can name closed constructed type

using Z<T> = N1.A<T>; // Error, using alias cannot have type

parameters

Usar directivas de espacio de nombres

Un using_namespace_directive importa los tipos contenidos en un espacio de nombres
en la unidad de compilación o el cuerpo del espacio de nombres que se encuentran
inmediatamente, lo que permite usar el identificador de cada tipo sin calificación.

antlr

using_namespace_directive

: 'using' namespace_name ';'

Dentro de las declaraciones de miembros de una unidad de compilación o un cuerpo de

espacio de nombres que contiene un using_namespace_directive, se puede hacer
referencia a los tipos contenidos en el espacio de nombres especificado directamente.
Por ejemplo:

C#

namespace N1.N2

class A {}

namespace N3

using N1.N2;

class B: A {}

Anteriormente, dentro de las declaraciones de miembros del N3 espacio de nombres,

los miembros de tipo de N1.N2 están directamente disponibles y, por lo tanto, la clase
N3.B deriva de la clase N1.N2.A .

Un using_namespace_directive importa los tipos contenidos en el espacio de nombres

especificado, pero específicamente no importa espacios de nombres anidados. En el
ejemplo

C#

namespace N1.N2

class A {}

namespace N3

using N1;

class B: N2.A {} // Error, N2 unknown

el using_namespace_directive importa los tipos incluidos en N1 , pero no los espacios de

nombres anidados en N1 . Por lo tanto, la referencia a N2.A en la declaración de B
genera un error en tiempo de compilación porque ningún miembro denominado N2
está en el ámbito.
A diferencia de un using_alias_directive, un using_namespace_directive puede importar
tipos cuyos identificadores ya estén definidos dentro de la unidad de compilación o el
cuerpo del espacio de nombres envolvente. En efecto, los nombres importados por un
using_namespace_directive están ocultos por miembros con el mismo nombre en la
unidad de compilación o el cuerpo del espacio de nombres envolvente. Por ejemplo:

C#

namespace N1.N2

class A {}

class B {}

namespace N3

using N1.N2;

class A {}

Aquí, dentro de las declaraciones de miembro del N3 espacio de nombres, A hace

referencia a en N3.A lugar de a N1.N2.A .

Cuando más de un espacio de nombres o tipo importado por using_namespace_directive

s o using_static_directive s en la misma unidad de compilación o cuerpo de espacio de
nombres contienen tipos con el mismo nombre, las referencias a ese nombre como un
type_name se consideran ambiguas. En el ejemplo

C#

namespace N1

class A {}

namespace N2

class A {}

namespace N3

using N1;

using N2;

 class B: A {} // Error, A is ambiguous

N1 y N2 contienen un miembro A , y dado que las N3 importaciones, que hacen

referencia a A en, N3 es un error en tiempo de compilación. En esta situación, el

conflicto se puede resolver a través de la calificación de referencias a A o mediante la
introducción de una using_alias_directive que elige un determinado A . Por ejemplo:

C#

namespace N3

using N1;

using N2;

using A = N1.A;

class B: A {} // A means N1.A

Además, cuando más de un espacio de nombres o tipo importado por

using_namespace_directive s o using_static_directive s en la misma unidad de
compilación o cuerpo de espacio de nombres contienen tipos o miembros con el mismo
nombre, las referencias a ese nombre como un simple_name se consideran ambiguas.
En el ejemplo

C#

namespace N1

class A {}

class C

public static int A;

namespace N2

using N1;

using static C;

class B

void M()

A a = new A(); // Ok, A is unambiguous as a type-name

 A.Equals(2); // Error, A is ambiguous as a simple-name

N1 contiene un miembro de tipo A y C contiene un campo estático A , y dado N2 que

importa ambos, hacer referencia A a como simple_name es ambiguo y un error en

tiempo de compilación.

Al igual que una using_alias_directive, un using_namespace_directive no aporta ningún

miembro nuevo al espacio de declaración subyacente de la unidad de compilación o
espacio de nombres, sino que afecta solo a la unidad de compilación o al cuerpo del
espacio de nombres en el que aparece.

Los namespace_name a los que hace referencia un using_namespace_directive se

resuelven de la misma manera que el namespace_or_type_name al que hace referencia
una using_alias_directive. Por lo tanto, using_namespace_directive s en la misma unidad
de compilación o el cuerpo del espacio de nombres no se ven afectados entre sí y se
pueden escribir en cualquier orden.

Usar directivas estáticas

Un using_static_directive importa los tipos anidados y los miembros estáticos contenidos
directamente en una declaración de tipos en la unidad de compilación o el cuerpo del
espacio de nombres que se encuentra inmediatamente, lo que permite usar el
identificador de cada miembro y tipo sin calificación.

antlr

using_static_directive

: 'using' 'static' type_name ';'

Dentro de las declaraciones de miembros de una unidad de compilación o un cuerpo de

espacio de nombres que contiene un using_static_directive, se puede hacer referencia a
los tipos anidados y miembros estáticos accesibles (excepto los métodos de extensión)
contenidos directamente en la declaración del tipo dado. Por ejemplo:

C#

namespace N1

class A

public class B{}

 public static B M(){ return new B(); }

namespace N2

using static N1.A;

class C

void N() { B b = M(); }

Anteriormente, dentro de las declaraciones de miembros del N2 espacio de nombres,

los miembros estáticos y los tipos anidados de N1.A están disponibles directamente y,
por tanto, el método N puede hacer referencia a los B M miembros y de N1.A .

Un using_static_directive específicamente no importa los métodos de extensión

directamente como métodos estáticos, pero los pone a disposición de la invocación de
métodos de extensión (invocacionesde métodos de extensión). En el ejemplo

C#

namespace N1

static class A

public static void M(this string s){}

namespace N2

using static N1.A;

class B

void N()

M("A"); // Error, M unknown

"B".M(); // Ok, M known as extension method

N1.A.M("C"); // Ok, fully qualified

el using_static_directive importa el método M de extensión contenido en N1.A , pero

solo como un método de extensión. Por lo tanto, la primera referencia a M en el cuerpo
de B.N produce un error en tiempo de compilación porque ningún miembro
denominado M está en el ámbito.

Un using_static_directive solo importa miembros y tipos declarados directamente en el

tipo dado, no miembros y tipos declarados en clases base.

TODO: ejemplo

En el uso de las directivas de espacio de nombresse describen las ambigüedades entre

varios using_namespace_directives y using_static_directives .

Miembros del espacio de nombres

Un namespace_member_declaration es un namespace_declaration (declaraciones de
espacio de nombres) o un type_declaration (declaraciones de tipos).

antlr

namespace_member_declaration

: namespace_declaration

| type_declaration

Una unidad de compilación o un cuerpo de espacio de nombres puede contener

namespace_member_declaration s y tales declaraciones aportan nuevos miembros al
espacio de declaración subyacente de la unidad de compilación o el cuerpo del espacio
de nombres que lo contiene.

Declaraciones de tipos
Una type_declaration es una class_declaration (declaraciones de clase), una
struct_declaration (declaraciones de struct), una interface_declaration (declaraciones de
interfaz), una enum_declaration (declaraciones de enumeración) o una
delegate_declaration (declaraciones de delegado).

antlr

type_declaration

: class_declaration

| struct_declaration

| interface_declaration

| enum_declaration

| delegate_declaration

Un type_declaration puede producirse como una declaración de nivel superior en una

unidad de compilación o como una declaración de miembro dentro de un espacio de
nombres, una clase o un struct.

Cuando una declaración de tipos para un tipo T se produce como una declaración de
nivel superior en una unidad de compilación, el nombre completo del tipo recién
declarado es simplemente T . Cuando se produce una declaración de tipos para un tipo
T dentro de un espacio de nombres, clase o struct, el nombre completo del tipo recién
declarado es N.T , donde N es el nombre completo del espacio de nombres, la clase o
el struct que lo contiene.

Un tipo declarado dentro de una clase o struct se denomina tipo anidado (tipos
anidados).

Los modificadores de acceso permitidos y el acceso predeterminado de una declaración

de tipo dependen del contexto en el que tiene lugar la declaración (declarada
accesibilidad):

Los tipos declarados en unidades de compilación o espacios de nombres pueden

tener public internal acceso o. El valor predeterminado es internal Access.
Los tipos declarados en las clases pueden tener public protected internal
acceso,,, protected internal o private . El valor predeterminado es private
Access.
Los tipos declarados en Structs pueden tener public internal acceso, o private .
El valor predeterminado es private Access.

Calificadores de alias de espacio de nombres

El calificador de alias de espacio de nombres :: hace posible garantizar que las
búsquedas de nombres de tipo no se ven afectadas por la introducción de nuevos tipos
y miembros. El calificador de alias de espacio de nombres siempre aparece entre dos
identificadores denominados identificadores a la izquierda y a la derecha. A diferencia
del . calificador normal, el identificador de la parte izquierda del :: calificador solo se
busca como un alias extern o using.

Un qualified_alias_member se define de la siguiente manera:

antlr

qualified_alias_member

: identifier '::' identifier type_argument_list?

Un qualified_alias_member se puede usar como namespace_or_type_name (espacio de

nombres y nombres de tipo) o como operando izquierdo en un member_access (acceso
a miembros).

Una qualified_alias_member tiene una de las dos formas siguientes:

N::I<A1, ..., Ak> , donde N y I representan los identificadores, y <A1, ..., Ak>

es una lista de argumentos de tipo. ( K siempre es al menos uno).

N::I , donde N y I representan los identificadores. (En este caso, K se considera
cero).

Con esta notación, el significado de un qualified_alias_member se determina de la

manera siguiente:

Si N es el identificador global , se busca en el espacio de nombres global I :

Si el espacio de nombres global contiene un espacio de nombres denominado
  I y K es cero, el qualified_alias_member hace referencia a ese espacio de
nombres.
De lo contrario, si el espacio de nombres global contiene un tipo no genérico
denominado   I y K es cero, el qualified_alias_member hace referencia a ese
tipo.
De lo contrario, si el espacio de nombres global contiene un tipo denominado
  I que tiene K   parámetros de tipo, el qualified_alias_member hace referencia a
ese tipo construido con los argumentos de tipo especificados.
De lo contrario, el qualified_alias_member es indefinido y se produce un error en
tiempo de compilación.

De lo contrario, empezando por la declaración de espacio de nombres

(declaraciones de espacio de nombres) que contiene inmediatamente el
qualified_alias_member (si existe), continuando con cada declaración de espacio de
nombres envolvente (si existe) y finalizando con la unidad de compilación que
contiene la qualified_alias_member, se evalúan los pasos siguientes hasta que se
encuentra una entidad:
Si la declaración de espacio de nombres o la unidad de compilación contiene un
using_alias_directive que N se asocia a un tipo, el qualified_alias_member no
está definido y se produce un error en tiempo de compilación.
De lo contrario, si la declaración de espacio de nombres o la unidad de
compilación contiene un extern_alias_directive o using_alias_directive que se
asocia N con un espacio de nombres, entonces:
Si el espacio de nombres asociado a N contiene un espacio de nombres
denominado   I y K es cero, el qualified_alias_member hace referencia a ese
espacio de nombres.
 De lo contrario, si el espacio de nombres asociado a N contiene un tipo no
genérico denominado   I y K es cero, el qualified_alias_member hace
referencia a ese tipo.
De lo contrario, si el espacio de nombres asociado a N contiene un tipo
denominado   I que tiene K   parámetros de tipo, el qualified_alias_member
hace referencia a ese tipo construido con los argumentos de tipo
especificados.
De lo contrario, el qualified_alias_member es indefinido y se produce un error
en tiempo de compilación.

De lo contrario, el qualified_alias_member es indefinido y se produce un error en

tiempo de compilación.

Tenga en cuenta que si se usa el calificador de alias de espacio de nombres con un alias
que hace referencia a un tipo, se produce un error en tiempo de compilación. Tenga en
cuenta también que si el identificador   N es global , la búsqueda se realiza en el
espacio de nombres global, incluso si hay un alias Using que se asocia global con un
tipo o un espacio de nombres.

Unicidad de alias
Cada unidad de compilación y cuerpo del espacio de nombres tiene un espacio de
declaración independiente para los alias extern y el uso de alias. Por lo tanto, si bien el
nombre de un alias extern o de uso de alias debe ser único en el conjunto de alias
extern y usar alias declarados en la unidad de compilación o el cuerpo del espacio de
nombres que contiene inmediatamente, se permite que un alias tenga el mismo nombre
que un tipo o un espacio de nombres, siempre y cuando se use solo con el ::
calificador.

En el ejemplo

C#

namespace N

public class A {}

public class B {}

namespace N

using A = System.IO;

class X

A.Stream s1; // Error, A is ambiguous

A::Stream s2; // Ok

el nombre A tiene dos significados posibles en el segundo cuerpo del espacio de

nombres porque tanto la clase A como el alias using A están en el ámbito. Por esta
razón, el uso de A en el nombre completo A.Stream es ambiguo y provoca que se
produzca un error en tiempo de compilación. Sin embargo, el uso de A con el ::
calificador no es un error porque A solo se busca como un alias de espacio de nombres.
Clases
Artículo • 16/09/2021 • Tiempo de lectura: 163 minutos

Una clase es una estructura de datos que puede contener miembros de datos
(constantes y campos), miembros de función (métodos, propiedades, eventos,
indizadores, operadores, constructores de instancias, destructores y constructores
estáticos) y tipos anidados. Los tipos de clase admiten la herencia, un mecanismo
mediante el cual una clase derivada puede extender y especializar una clase base.

Declaraciones de clase
Una class_declaration es una type_declaration (declaraciones de tipos) que declara una
nueva clase.

antlr

class_declaration

: attributes? class_modifier* 'partial'? 'class' identifier

type_parameter_list?

class_base? type_parameter_constraints_clause* class_body ';'?

Un class_declaration consta de un conjunto opcional de atributos (atributos), seguido de

un conjunto opcional de class_modifier s (modificadores de clase). seguido de un
partial modificador opcional, seguido de la palabra clave class y un identificador que

nombra la clase, seguido de un type_parameter_list opcional (parámetros de tipo),

seguido de una especificación de class_base opcional (especificación de clase base),
seguida de un conjunto opcional de type_parameter_constraints_clause s (restricciones
de parámetro de tipo), seguido de un class_body (cuerpo de clase), opcionalmente
seguido de un punto y coma

Una declaración de clase no puede proporcionar type_parameter_constraints_clause s a

menos que también proporcione un type_parameter_list.

Una declaración de clase que proporciona un type_parameter_list es una declaración de

clase genérica. Además, cualquier clase anidada dentro de una declaración de clase
genérica o una declaración de estructura genérica es una declaración de clase genérica,
ya que se deben proporcionar los parámetros de tipo para el tipo contenedor para crear
un tipo construido.

Modificadores de clase
Un class_declaration puede incluir opcionalmente una secuencia de modificadores de
clase:

antlr

class_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| 'abstract'

| 'sealed'

| 'static'

| class_modifier_unsafe

Es un error en tiempo de compilación que el mismo modificador aparezca varias veces

en una declaración de clase.

El new modificador se permite en las clases anidadas. Especifica que la clase oculta un
miembro heredado con el mismo nombre, tal y como se describe en el modificador
New. Se trata de un error en tiempo de compilación para new que el modificador
aparezca en una declaración de clase que no es una declaración de clase anidada.

Los public protected internal modificadores,, y private controlan la accesibilidad de

la clase. Dependiendo del contexto en el que se produce la declaración de clase, es
posible que algunos de estos modificadores no estén permitidos (sedeclare
accesibilidad).

Los abstract sealed static modificadores, y se describen en las secciones siguientes.

Clases abstractas
El abstract modificador se usa para indicar que una clase está incompleta y que está
destinada a usarse solo como una clase base. Una clase abstracta es distinta de una
clase no abstracta de las siguientes maneras:

No se puede crear una instancia de una clase abstracta directamente y es un error

en tiempo de compilación utilizar el new operador en una clase abstracta. Aunque
es posible tener variables y valores cuyos tipos en tiempo de compilación sean
abstractos, tales variables y valores serán necesariamente null o contendrán
referencias a instancias de clases no abstractas derivadas de los tipos abstractos.
 Se permite que una clase abstracta contenga miembros abstractos (aunque no es
necesario).
Una clase abstracta no puede ser sellada.

Cuando una clase no abstracta se deriva de una clase abstracta, la clase no abstracta
debe incluir las implementaciones reales de todos los miembros abstractos heredados,
con lo que se reemplazan los miembros abstractos. En el ejemplo

C#

abstract class A

public abstract void F();

abstract class B: A

public void G() {}

class C: B

public override void F() {

// actual implementation of F

la clase abstracta A presenta un método abstracto F . La clase B introduce un método

adicional G , pero como no proporciona una implementación de F , B también debe
declararse como Abstract. La clase C invalida F y proporciona una implementación real.
Dado que no hay miembros abstractos en C , C se permite (pero no es necesario) que
no sea abstracto.

Clases selladas

El sealed modificador se usa para evitar la derivación de una clase. Se produce un error
en tiempo de compilación si se especifica una clase sellada como la clase base de otra
clase.

Una clase sellada no puede ser también una clase abstracta.

El sealed modificador se usa principalmente para evitar la derivación no deseada, pero

también permite ciertas optimizaciones en tiempo de ejecución. En concreto, dado que
se sabe que una clase sellada nunca tiene clases derivadas, es posible transformar las
invocaciones de miembros de función virtual en instancias de clase selladas en
invocaciones no virtuales.

Clases estáticas

El static modificador se usa para marcar la clase que se declara como una clase
estática. No se puede crear una instancia de una clase estática, no se puede usar como
un tipo y solo puede contener miembros estáticos. Solo una clase estática puede
contener declaraciones de métodos de extensión (métodos de extensión).

Una declaración de clase estática está sujeta a las siguientes restricciones:

Una clase estática no puede incluir un sealed abstract modificador o. Sin

embargo, tenga en cuenta que, puesto que no se pueden crear instancias de una
clase estática ni derivarse de, se comporta como si fuera Sealed y Abstract.
Una clase estática no puede incluir una especificación de class_base (clase base
Specification) y no puede especificar explícitamente una clase base o una lista de
interfaces implementadas. Una clase estática hereda implícitamente del tipo
object .

Una clase estática solo puede contener miembros estáticos (miembros estáticos y
de instancia). Tenga en cuenta que las constantes y los tipos anidados se clasifican
como miembros estáticos.
Una clase estática no puede tener miembros con protected o protected internal
declarar accesibilidad.

Es un error en tiempo de compilación infringir cualquiera de estas restricciones.

Una clase estática no tiene ningún constructor de instancia. No es posible declarar un

constructor de instancia en una clase estática, y no se proporciona ningún constructor
de instancia predeterminado (constructores predeterminados) para una clase estática.

Los miembros de una clase estática no son estáticos automáticamente y las

declaraciones de miembros deben incluir explícitamente un static modificador
(excepto para las constantes y los tipos anidados). Cuando una clase está anidada
dentro de una clase externa estática, la clase anidada no es una clase estática a menos
que incluya explícitamente un static modificador.

Referencia a tipos de clase estáticos

Se permite que un namespace_or_type_name (espacio de nombres y nombres de tipo)

haga referencia a una clase estática Si
 La namespace_or_type_name es T en un namespace_or_type_name del formulario
T.I , o
El namespace_or_type_name es T en un typeof_expression (listas de argumentos1)
del formulario typeof(T) .

Se permite que un primary_expression (miembros de función) haga referencia a una

clase estática Si

La primary_expression es E en un member_access (comprobación en tiempo de

compilación de la resolución dinámica de sobrecarga) del formulario E.I .

En cualquier otro contexto, se trata de un error en tiempo de compilación para hacer

referencia a una clase estática. Por ejemplo, es un error que una clase estática se use
como una clase base, un tipo constituyente (tipos anidados) de un miembro, un
argumento de tipo genérico o una restricción de parámetro de tipo. Del mismo modo,
una clase estática no se puede usar en un tipo de matriz, un tipo de puntero, una
expresión, una expresión de conversión, una expresión, una expresión, new is una
expresión as sizeof o una expresión de valor predeterminado.

Unmodifier (modificador)
El partial modificador se usa para indicar que este class_declaration es una declaración
de tipos parciales. Varias declaraciones de tipos parciales con el mismo nombre dentro
de una declaración de tipo o espacio de nombres envolvente se combinan para formar
una declaración de tipos, siguiendo las reglas especificadas en tipos parciales.

Tener la declaración de una clase distribuida sobre segmentos independientes del texto
del programa puede ser útil si estos segmentos se producen o mantienen en contextos
diferentes. Por ejemplo, una parte de una declaración de clase puede ser generada por
el equipo, mientras que la otra se crea manualmente. La separación textual de los dos
impide que las actualizaciones se realicen en conflicto con las actualizaciones del otro.

Parámetros de tipo
Un parámetro de tipo es un identificador simple que denota un marcador de posición
para un argumento de tipo proporcionado para crear un tipo construido. Un parámetro
de tipo es un marcador de posición formal para un tipo que se proporcionará más
adelante. Por el contrario, un argumento de tipo (argumentos de tipo) es el tipo real que
se sustituye por el parámetro de tipo cuando se crea un tipo construido.

antlr
 type_parameter_list

: '<' type_parameters '>'

type_parameters

: attributes? type_parameter

| type_parameters ',' attributes? type_parameter

type_parameter

: identifier

Cada parámetro de tipo de una declaración de clase define un nombre en el espacio de

declaración (declaraciones) de esa clase. Por lo tanto, no puede tener el mismo nombre
que otro parámetro de tipo o un miembro declarado en esa clase. Un parámetro de tipo
no puede tener el mismo nombre que el propio tipo.

Especificación de clase base

Una declaración de clase puede incluir una especificación de class_base , que define la
clase base directa de la clase y las interfaces (interfaces) implementadas directamente
por la clase.

antlr

class_base

: ':' class_type

| ':' interface_type_list

| ':' class_type ',' interface_type_list

interface_type_list

: interface_type (',' interface_type)*

La clase base especificada en una declaración de clase puede ser un tipo de clase
construido (tipos construidos). Una clase base no puede ser un parámetro de tipo por su
cuenta, aunque puede incluir los parámetros de tipo que se encuentran en el ámbito.

C#

class Extend<V>: V {} // Error, type parameter used as base class

Clases base
Cuando se incluye un class_type en el class_base, especifica la clase base directa de la
clase que se está declarando. Si una declaración de clase no tiene class_base, o si el
class_base solo enumera los tipos de interfaz, se supone que la clase base directa es
object . Una clase hereda los miembros de su clase base directa, como se describe en
herencia.

En el ejemplo

C#

class A {}

class B: A {}

A se dice que la clase es la clase base directa de B y B se dice que se deriva de A .

Puesto que no A especifica explícitamente una clase base directa, su clase base directa
es implícitamente object .

Para un tipo de clase construido, si se especifica una clase base en la declaración de

clase genérica, la clase base del tipo construido se obtiene sustituyendo, por cada
type_parameter en la declaración de clase base, el type_argument correspondiente del
tipo construido. Dadas las declaraciones de clase genéricas

C#

class B<U,V> {...}

class G<T>: B<string,T[]> {...}

la clase base del tipo construido G<int> sería B<string,int[]> .

La clase base directa de un tipo de clase debe ser al menos igual de accesible que el
propio tipo de clase (dominios de accesibilidad). Por ejemplo, se trata de un error en
tiempo de compilación para public que una clase se derive de una private internal
clase o.

La clase base directa de un tipo de clase no debe ser ninguno de los siguientes tipos:
System.Array , System.Delegate , System.MulticastDelegate , System.Enum o

System.ValueType . Además, una declaración de clase genérica no puede usar

System.Attribute como una clase base directa o indirecta.

A la hora de determinar el significado de la especificación de clase base directa A de

una clase B , se supone que la clase base directa de B es object . Intuitivamente esto
garantiza que el significado de una especificación de clase base no puede depender
recursivamente. El ejemplo:

C#

class A<T> {

public class B {}

class C : A<C.B> {}

es un error porque, en la especificación de clase base A<C.B> , la clase base directa de C

se considera object y, por lo tanto, las reglas de nombres de espacio de nombres y de
tipo C no se consideran miembros B .

Las clases base de un tipo de clase son la clase base directa y sus clases base. En otras
palabras, el conjunto de clases base es el cierre transitivo de la relación de clase base
directa. En el ejemplo anterior, las clases base de B son A y object . En el ejemplo

C#

class A {...}

class B<T>: A {...}

class C<T>: B<IComparable<T>> {...}

class D<T>: C<T[]> {...}

las clases base de D<int> son C<int[]> , B<IComparable<int[]>> , A y object .

A excepción de la clase object , cada tipo de clase tiene exactamente una clase base
directa. La object clase no tiene ninguna clase base directa y es la última clase base de
todas las demás clases.

Cuando una clase B se deriva de una clase A , es un error en tiempo de compilación

para A que dependa de B . Una clase depende directamente de la clase base directa (si
existe) y _depende directamente de*_ la clase en la que se anida inmediatamente (si
existe). Dada esta definición, el conjunto completo de clases de las que depende una
clase es el cierre reflexivo y transitivo de que depende directamente de * relación.

En el ejemplo

C#

class A: A {}

es erróneo porque la clase depende de sí misma. Del mismo modo, el ejemplo

C#

class A: B {}

class B: C {}

class C: A {}

es un error porque las clases dependen circularmente por sí mismas. Por último, el
ejemplo

C#

class A: B.C {}

class B: A

public class C {}

produce un error en tiempo de compilación porque A depende de B.C (su clase base
directa), que depende de B (su clase envolvente inmediata), que depende circularmente
de A .

Tenga en cuenta que una clase no depende de las clases anidadas en ella. En el ejemplo

C#

class A

class B: A {}

B depende de A (porque A es tanto su clase base directa como su clase envolvente

inmediata), pero A no depende de B (puesto que no B es una clase base ni una clase
envolvente de A ). Por lo tanto, el ejemplo es válido.

No se puede derivar de una sealed clase. En el ejemplo

C#

sealed class A {}

class B: A {} // Error, cannot derive from a sealed class

B la clase tiene un error porque intenta derivar de la sealed clase A .

Implementaciones de interfaces
Una especificación de class_base puede incluir una lista de tipos de interfaz, en cuyo
caso se dice que la clase implementa directamente los tipos de interfaz especificados.
Las implementaciones de interfaz se tratan en las implementaciones de interfaz.

Restricciones de parámetros de tipo

Las declaraciones de tipos y métodos genéricos pueden especificar opcionalmente
restricciones de parámetros de tipo incluyendo type_parameter_constraints_clause s.

antlr

type_parameter_constraints_clause
: 'where' type_parameter ':' type_parameter_constraints

type_parameter_constraints

: primary_constraint

| secondary_constraints

| constructor_constraint

| primary_constraint ',' secondary_constraints

| primary_constraint ',' constructor_constraint

| secondary_constraints ',' constructor_constraint

| primary_constraint ',' secondary_constraints ','

constructor_constraint

primary_constraint

: class_type

| 'class'

| 'struct'

secondary_constraints

: interface_type

| type_parameter

| secondary_constraints ',' interface_type

| secondary_constraints ',' type_parameter

constructor_constraint

: 'new' '(' ')'

Cada type_parameter_constraints_clause consta del token where , seguido del nombre de

un parámetro de tipo, seguido de dos puntos y la lista de restricciones para ese
parámetro de tipo. Puede haber como máximo una where cláusula para cada parámetro
de tipo y las where cláusulas se pueden enumerar en cualquier orden. Al igual que los
get set tokens y en un descriptor de acceso de propiedad, el where token no es una

palabra clave.

La lista de restricciones dadas en una where cláusula puede incluir cualquiera de los
componentes siguientes, en este orden: una restricción Primary única, una o más
restricciones secundarias y la restricción de constructor, new() .

Una restricción Primary puede ser un tipo de clase o una restricción de tipo de
referencia* class o la restricción de tipo de valor struct . Una restricción secundaria
puede ser una _type_parameter * o interface_type.

La restricción de tipo de referencia especifica que un argumento de tipo usado para el

parámetro de tipo debe ser un tipo de referencia. Todos los tipos de clase, tipos de
interfaz, tipos de delegado, tipos de matriz y parámetros de tipo que se sabe que son
un tipo de referencia (como se define a continuación) satisfacen esta restricción.

La restricción de tipo de valor especifica que un argumento de tipo usado para el

parámetro de tipo debe ser un tipo de valor que no acepta valores NULL. Todos los
tipos de struct que no aceptan valores NULL, tipos de enumeración y parámetros de
tipo con la restricción de tipo de valor cumplen esta restricción. Tenga en cuenta que
aunque se clasifique como un tipo de valor, un tipo que acepta valores NULL (tipos que
aceptan valores NULL) no satisface la restricción de tipo de valor. Un parámetro de tipo
que tiene la restricción de tipo de valor no puede tener también el
constructor_constraint.

Los tipos de puntero nunca pueden ser argumentos de tipo y no se tienen en cuenta
para satisfacer las restricciones de tipo de valor o tipo de referencia.

Si una restricción es un tipo de clase, un tipo de interfaz o un parámetro de tipo, ese

tipo especifica un "tipo base" mínimo que cada argumento de tipo utilizado para ese
parámetro de tipo debe admitir. Siempre que se usa un tipo construido o un método
genérico, el argumento de tipo se compara con las restricciones del parámetro de tipo
en tiempo de compilación. El argumento de tipo proporcionado debe cumplir las
condiciones descritas en satisfacción de las restricciones.

Una restricción class_type debe cumplir las siguientes reglas:

El tipo debe ser un tipo de clase.

El tipo no debe ser sealed .
 El tipo no debe ser uno de los tipos siguientes: System.Array , System.Delegate ,
System.Enum o System.ValueType .
El tipo no debe ser object . Dado que todos los tipos se derivan de object , este
tipo de restricción no tendría ningún efecto si se permitiera.
Como máximo, una restricción para un parámetro de tipo determinado puede ser
un tipo de clase.

Un tipo especificado como restricción interface_type debe cumplir las siguientes reglas:

El tipo debe ser un tipo de interfaz.

Un tipo no debe especificarse más de una vez en una where cláusula determinada.

En cualquier caso, la restricción puede incluir cualquiera de los parámetros de tipo del
tipo o la declaración de método asociados como parte de un tipo construido, y puede
implicar el tipo que se declara.

Cualquier tipo de clase o interfaz especificado como restricción de parámetro de tipo

debe ser al menos igual de accesible (restricciones de accesibilidad) que el tipo o
método genérico que se está declarando.

Un tipo especificado como restricción type_parameter debe cumplir las siguientes reglas:

El tipo debe ser un parámetro de tipo.

Un tipo no debe especificarse más de una vez en una where cláusula determinada.

Además, no debe haber ningún ciclo en el gráfico de dependencias de los parámetros

de tipo, donde Dependency es una relación transitiva definida por:

Si T se usa un parámetro de tipo como una restricción para el parámetro de tipo

S , S depende de T .

Si un parámetro de tipo S depende de un parámetro de tipo T y T depende de

un parámetro de tipo U , S depende de U .

Dada esta relación, se trata de un error en tiempo de compilación para que un

parámetro de tipo dependa de sí mismo (directa o indirectamente).

Cualquier restricción debe ser coherente entre los parámetros de tipo dependiente. Si el
parámetro S de tipo depende del parámetro de tipo T , entonces:

T no debe tener la restricción de tipo de valor. De lo contrario, se sella de forma

eficaz, de modo que se T S forzaría que sea del mismo tipo que, lo que T elimina
la necesidad de dos parámetros de tipo.
Si S tiene la restricción de tipo de valor, entonces T no debe tener una restricción
class_type .
 Si S tiene una restricción class_type A y T tiene una restricción class_type B , debe
haber una conversión de identidad o una conversión de referencia implícita de A a
B o una conversión de referencia implícita de a B A .

Si S también depende del parámetro de tipo U y U tiene una restricción class_type

A y T tiene una restricción class_type , debe haber una conversión de B identidad

o una conversión de referencia implícita de A a B o una conversión de referencia

implícita de B a A .

Es válido para S que tenga la restricción de tipo de valor y T para que tenga la
restricción de tipo de referencia. De hecho, esto limita T a los tipos System.Object ,, y a
System.ValueType System.Enum cualquier tipo de interfaz.

Si la where cláusula de un parámetro de tipo incluye una restricción de constructor (que

tiene el formato new() ), es posible utilizar el new operador para crear instancias del tipo
(expresiones de creación de objetos). Cualquier argumento de tipo utilizado para un
parámetro de tipo con una restricción de constructor debe tener un constructor sin
parámetros público (este constructor existe implícitamente para cualquier tipo de valor)
o ser un parámetro de tipo con la restricción de tipo de valor o la restricción de
constructor (vea restricciones de parámetro de tipo para obtener más detalles).

A continuación se muestran ejemplos de restricciones:

C#

interface IPrintable

void Print();

interface IComparable<T>

int CompareTo(T value);

interface IKeyProvider<T>

T GetKey();

class Printer<T> where T: IPrintable {...}

class SortedList<T> where T: IComparable<T> {...}

class Dictionary<K,V>

where K: IComparable<K>

where V: IPrintable, IKeyProvider<K>, new()

 ...

El ejemplo siguiente es erróneo porque provoca una circularidad en el gráfico de

dependencias de los parámetros de tipo:

C#

class Circular<S,T>

where S: T

where T: S // Error, circularity in dependency graph

...

En los siguientes ejemplos se muestran situaciones no válidas adicionales:

C#

class Sealed<S,T>

where S: T

where T: struct // Error, T is sealed

...

class A {...}

class B {...}

class Incompat<S,T>

where S: A, T

where T: B // Error, incompatible class-type constraints

...

class StructWithClass<S,T,U>

where S: struct, T

where T: U

where U: A // Error, A incompatible with struct

...

La clase base efectiva de un parámetro de tipo T se define de la siguiente manera:

Si T no tiene restricciones PRIMARY o restricciones de parámetro de tipo, su clase

base efectiva es object .
 Si T tiene la restricción de tipo de valor, su clase base efectiva es System.ValueType
.
Si T tiene una restricción class_type C pero no type_parameter restricciones, su
clase base efectiva es C .
Si T no tiene ninguna restricción class_type pero tiene una o varias restricciones
type_parameter , su clase base efectiva es el tipo más abarcado (operadores de
conversión elevada) en el conjunto de clases base eficaces de sus restricciones
type_parameter . Las reglas de coherencia garantizan que exista un tipo más
abarcado.
Si T tiene una restricción class_type y una o varias restricciones type_parameter , su
clase base efectiva es el tipo más abarcado (operadores de conversión elevación)
en el conjunto que consta de la class_type restricción de T y las clases base
eficaces de sus restricciones de type_parameter . Las reglas de coherencia
garantizan que exista un tipo más abarcado.
Si T tiene la restricción de tipo de referencia pero no class_type restricciones, su
clase base efectiva es object .

En el caso de estas reglas, si T tiene una restricción V que es un value_type, use en su

lugar el tipo base más específico de V que sea un class_type. Esto nunca puede ocurrir
en una restricción explícitamente especificada, pero puede producirse cuando las
restricciones de un método genérico se heredan implícitamente mediante una
declaración de método de reemplazo o una implementación explícita de un método de
interfaz.

Estas reglas garantizan que la clase base efectiva siempre sea una class_type.

El conjunto de interfaces efectivo de un parámetro de tipo T se define de la siguiente

manera:

Si T no tiene secondary_constraints, su conjunto de interfaces efectivo está vacío.

Si T tiene restricciones de interface_type pero no type_parameter restricciones, su
conjunto de interfaces efectivo es su conjunto de restricciones de interface_type .
Si T no tiene restricciones de interface_type pero tiene type_parameter
restricciones, su conjunto de interfaces efectivo es la Unión de los conjuntos de
interfaces eficaces de sus restricciones de type_parameter .
Si T tiene tanto restricciones interface_type como restricciones de type_parameter ,
su conjunto de interfaces efectivo es la Unión de su conjunto de restricciones
interface_type y los conjuntos de interfaces eficaces de sus restricciones de
type_parameter .
Se sabe que un parámetro de tipo es un tipo de referencia si tiene la restricción de tipo
de referencia o su clase base efectiva no es object o System.ValueType .

Los valores de un tipo de parámetro de tipo restringido se pueden utilizar para tener
acceso a los miembros de instancia que implican las restricciones. En el ejemplo

C#

interface IPrintable

void Print();

class Printer<T> where T: IPrintable

void PrintOne(T x) {

x.Print();

los métodos de IPrintable se pueden invocar directamente en x porque T está

restringido a implementar siempre IPrintable .

Cuerpo de clase
El class_body de una clase define los miembros de esa clase.

antlr

class_body

: '{' class_member_declaration* '}'

Tipos parciales
Una declaración de tipos se puede dividir en varias declaraciones de tipos parciales. La
declaración de tipos se construye a partir de sus elementos siguiendo las reglas de esta
sección, en la que se trata como una única declaración durante el resto del
procesamiento en tiempo de compilación y en tiempo de ejecución del programa.

Un class_declaration, struct_declaration o interface_declaration representa una

declaración de tipos parciales si incluye un partial modificador. partial no es una
palabra clave y solo actúa como modificador si aparece inmediatamente antes de una
de las palabras clave class , struct o interface en una declaración de tipo o antes del
tipo void en una declaración de método. En otros contextos, se puede usar como un
identificador normal.

Cada parte de una declaración de tipo parcial debe incluir un partial modificador.
Debe tener el mismo nombre y estar declarado en el mismo espacio de nombres o
declaración de tipos que las demás partes. El partial modificador indica que pueden
existir partes adicionales de la declaración de tipos en otro lugar, pero la existencia de
tales partes adicionales no es un requisito; es válido para un tipo con una sola
declaración que incluya el partial modificador.

Todas las partes de un tipo parcial se deben compilar de forma que se puedan combinar
las partes en tiempo de compilación en una única declaración de tipo. Los tipos
parciales no permiten que se extiendan los tipos ya compilados.

Los tipos anidados se pueden declarar en varias partes mediante el partial

modificador. Normalmente, el tipo contenedor se declara utilizando partial también y
cada parte del tipo anidado se declara en una parte diferente del tipo contenedor.

partial No se permite el modificador en las declaraciones de delegado o enumeración.

Atributos
Los atributos de un tipo parcial se determinan mediante la combinación, en un orden no
especificado, con los atributos de cada uno de los elementos. Si un atributo se coloca en
varias partes, es equivalente a especificar el atributo varias veces en el tipo. Por ejemplo,
las dos partes:

C#

[Attr1, Attr2("hello")]
partial class A {}

[Attr3, Attr2("goodbye")]

partial class A {}

son equivalentes a una declaración como:

C#

[Attr1, Attr2("hello"), Attr3, Attr2("goodbye")]

class A {}

Los atributos de los parámetros de tipo se combinan de manera similar.

Modificadores
Cuando una declaración de tipos parciales incluye una especificación de accesibilidad
(los public protected modificadores,, internal y private ), debe coincidir con todas
las demás partes que incluyen una especificación de accesibilidad. Si ninguna parte de
un tipo parcial incluye una especificación de accesibilidad, se proporciona al tipo la
accesibilidad predeterminada adecuada (laaccesibilidad declarada).

Si una o varias declaraciones parciales de un tipo anidado incluyen un new modificador,

no se genera ninguna advertencia si el tipo anidado oculta un miembro heredado
(ocultando a travésde la herencia).

Si una o varias declaraciones parciales de una clase incluyen un abstract modificador, la

clase se considera abstracta (clases abstractas). De lo contrario, la clase se considera no
abstracta.

Si una o varias declaraciones parciales de una clase incluyen un sealed modificador, la

clase se considera Sealed (clases selladas). De lo contrario, se considera que la clase no
está sellada.

Tenga en cuenta que una clase no puede ser Abstract y Sealed.

Cuando el unsafe modificador se usa en una declaración de tipo parcial, solo esa parte
concreta se considera un contexto no seguro (contextos no seguros).

Parámetros de tipo y restricciones

Si un tipo genérico se declara en varias partes, cada elemento debe indicar los
parámetros de tipo. Cada elemento debe tener el mismo número de parámetros de tipo
y el mismo nombre para cada parámetro de tipo, en orden.

Cuando una declaración de tipos genéricos parciales incluye restricciones ( where

cláusulas), las restricciones deben coincidir con todas las demás partes que incluyen
restricciones. En concreto, cada parte que incluye restricciones debe tener restricciones
para el mismo conjunto de parámetros de tipo y, para cada parámetro de tipo, los
conjuntos de restricciones PRIMARY, Secondary y constructor deben ser equivalentes.
Dos conjuntos de restricciones son equivalentes si contienen los mismos miembros. Si
ninguna parte de un tipo genérico parcial especifica las restricciones de parámetro de
tipo, los parámetros de tipo se consideran no restringidos.

En el ejemplo

C#
 partial class Dictionary<K,V>

where K: IComparable<K>

where V: IKeyProvider<K>, IPersistable

...

partial class Dictionary<K,V>

where V: IPersistable, IKeyProvider<K>

where K: IComparable<K>

...

partial class Dictionary<K,V>

...

es correcto porque las partes que incluyen restricciones (las dos primeras) especifican de
forma eficaz el mismo conjunto de restricciones principales, secundarias y constructores
para el mismo conjunto de parámetros de tipo, respectivamente.

Clase base
Cuando una declaración de clase parcial incluye una especificación de clase base, debe
coincidir con todas las demás partes que incluyen una especificación de clase base. Si
ninguna parte de una clase parcial incluye una especificación de clase base, la clase base
se convierte en System.Object (clases base).

Interfaces base
El conjunto de interfaces base para un tipo declarado en varias partes es la Unión de las
interfaces base especificadas en cada parte. Solo se puede asignar un nombre a una
interfaz base determinada una vez en cada parte, pero se permite que varias partes
denominen a las mismas interfaces base. Solo debe haber una implementación de los
miembros de una interfaz base determinada.

En el ejemplo

C#

partial class C: IA, IB {...}

partial class C: IC {...}

 partial class C: IA, IB {...}

el conjunto de interfaces base para la clase C es IA , IB y IC .

Normalmente, cada elemento proporciona una implementación de las interfaces

declaradas en esa parte; sin embargo, esto no es un requisito. Un elemento puede
proporcionar la implementación de una interfaz declarada en una parte diferente:

C#

partial class X

int IComparable.CompareTo(object o) {...}

partial class X: IComparable

...

Miembros
A excepción de los métodos parciales (métodos parciales), el conjunto de miembros de
un tipo declarado en varias partes es simplemente la Unión del conjunto de miembros
declarado en cada parte. Los cuerpos de todas las partes de la declaración de tipos
comparten el mismo espacio de declaración (declaraciones), y el ámbito de cada
miembro (ámbitos) se extiende a los cuerpos de todas las partes. El dominio de
accesibilidad de cualquier miembro siempre incluye todas las partes del tipo envolvente;
un private miembro declarado en una parte está disponible libremente desde otra
parte. Es un error en tiempo de compilación declarar el mismo miembro en más de una
parte del tipo, a menos que ese miembro sea un tipo con el partial modificador.

C#

partial class A

int x; // Error, cannot declare x more than once

partial class Inner // Ok, Inner is a partial type

int y;

partial class A

 int x; // Error, cannot declare x more than once

partial class Inner // Ok, Inner is a partial type

int z;

El orden de los miembros dentro de un tipo rara vez es significativo para el código de
C#, pero puede ser importante al interactuar con otros lenguajes y entornos. En estos
casos, el orden de los miembros dentro de un tipo declarado en varias partes es
indefinido.

Métodos parciales
Los métodos parciales se pueden definir en una parte de una declaración de tipos e
implementarse en otro. La implementación es opcional. Si ninguna parte implementa el
método parcial, la declaración de método parcial y todas las llamadas a ella se quitan de
la declaración de tipos resultante de la combinación de los elementos.

Los métodos parciales no pueden definir modificadores de acceso, pero son

implícitamente private . Su tipo de valor devuelto debe ser void , y sus parámetros no
pueden tener el out modificador. El identificador partial se reconoce como una
palabra clave especial en una declaración de método solo si aparece justo antes del
void tipo; en caso contrario, se puede usar como un identificador normal. Un método
parcial no puede implementar explícitamente métodos de interfaz.

Hay dos tipos de declaraciones de método parcial: Si el cuerpo de la declaración del

método es un punto y coma, se dice que la declaración es una * que define una
declaración de método parcial _. Si el cuerpo se proporciona como _block *, se dice que
la declaración es una declaración de método parcial de implementación. En las partes
de una declaración de tipos solo puede haber una declaración de método parcial de
definición con una firma determinada, y solo puede haber una declaración de método
parcial de implementación con una firma determinada. Si se proporciona una
declaración de método parcial de implementación, debe existir una declaración de
método parcial de definición correspondiente, y las declaraciones deben coincidir como
se especifica en lo siguiente:

Las declaraciones deben tener los mismos modificadores (aunque no

necesariamente en el mismo orden), el nombre del método, el número de
parámetros de tipo y el número de parámetros.
Los parámetros correspondientes en las declaraciones deben tener los mismos
modificadores (aunque no necesariamente en el mismo orden) y los mismos tipos
 (diferencias de módulo en los nombres de parámetros de tipo).
Los parámetros de tipo correspondientes en las declaraciones deben tener las
mismas restricciones (diferencias de módulo en los nombres de parámetros de
tipo).

Una declaración de método parcial de implementación puede aparecer en la misma

parte que la declaración de método parcial de definición correspondiente.

Solo un método parcial de definición participa en la resolución de sobrecarga. Por lo

tanto, tanto si se proporciona una declaración de implementación como si no, las
expresiones de invocación pueden resolverse en invocaciones del método parcial. Dado
que un método parcial siempre devuelve void , estas expresiones de invocación
siempre serán instrucciones de expresión. Además, dado que un método parcial es
implícitamente private , estas instrucciones siempre se producirán dentro de una de las
partes de la declaración de tipos en la que se declara el método parcial.

Si ninguna parte de una declaración de tipo parcial contiene una declaración de

implementación para un método parcial determinado, cualquier instrucción de
expresión que lo invoque simplemente se quita de la declaración de tipos combinados.
Por lo tanto, la expresión de invocación, incluidas las expresiones constituyentes, no
tiene ningún efecto en tiempo de ejecución. También se quita el método parcial en sí y
no será miembro de la declaración de tipos combinados.

Si existe una declaración de implementación para un método parcial determinado, se

conservan las invocaciones de los métodos parciales. El método parcial da lugar a una
declaración de método similar a la declaración de método parcial de implementación,
excepto para lo siguiente:

El partial modificador no está incluido

Los atributos de la declaración del método resultante son los atributos
combinados de la definición de y la declaración de método parcial de
implementación en un orden no especificado. No se quitan los duplicados.
Los atributos de los parámetros de la declaración de método resultante son los
atributos combinados de los parámetros correspondientes de la definición de y la
declaración de método parcial de implementación en un orden no especificado.
No se quitan los duplicados.

Si se proporciona una declaración de definición pero no una declaración de

implementación para un método parcial M, se aplican las restricciones siguientes:

Es un error en tiempo de compilación crear un delegado para el método

(expresiones de creación de delegado).
 Es un error en tiempo de compilación hacer referencia a M dentro de una función
anónima que se convierte en un tipo de árbolde expresión (evaluación de
conversiones de funciones anónimas a tipos de árbol de expresión).
Las expresiones que se producen como parte de una invocación de no M afectan al
estado de asignación definitiva (asignación definitiva), lo que puede provocar
errores en tiempo de compilación.
M no puede ser el punto de entrada de una aplicación (inicio de laaplicación).

Los métodos parciales son útiles para permitir que una parte de una declaración de
tipos Personalice el comportamiento de otra parte, por ejemplo, una generada por una
herramienta. Considere la siguiente declaración de clase parcial:

C#

partial class Customer

string name;

public string Name {

get { return name; }

set {

OnNameChanging(value);

name = value;

OnNameChanged();

partial void OnNameChanging(string newName);

partial void OnNameChanged();

Si esta clase se compila sin ningún otro elemento, se quitarán las declaraciones de
método parcial de definición y sus invocaciones, y la declaración de clase combinada
resultante será equivalente a la siguiente:

C#

class Customer

string name;

public string Name {

get { return name; }

set { name = value; }

No obstante, supongamos que se proporciona otra parte, que proporciona

declaraciones de implementación de los métodos parciales:

C#

partial class Customer

partial void OnNameChanging(string newName)

Console.WriteLine("Changing " + name + " to " + newName);

partial void OnNameChanged()

Console.WriteLine("Changed to " + name);

A continuación, la declaración de clase combinada resultante será equivalente a la

siguiente:

C#

class Customer

string name;

public string Name {

get { return name; }

set {

OnNameChanging(value);

name = value;

OnNameChanged();

void OnNameChanging(string newName)

Console.WriteLine("Changing " + name + " to " + newName);

void OnNameChanged()

Console.WriteLine("Changed to " + name);

Enlace de nombre
Aunque cada parte de un tipo extensible se debe declarar dentro del mismo espacio de
nombres, las partes se escriben normalmente en diferentes declaraciones de espacio de
nombres. Por lo tanto, using pueden estar presentes directivas diferentes (mediante
directivas) para cada parte. Al interpretar nombres simples (inferencia de tipos) dentro
de una parte, solo using se tienen en cuenta las directivas de las declaraciones de
espacio de nombres que la forman. Esto puede dar lugar a que el mismo identificador
tenga significados diferentes en distintas partes:

C#

namespace N

using List = System.Collections.ArrayList;

partial class A

List x; // x has type System.Collections.ArrayList

namespace N

using List = Widgets.LinkedList;

partial class A

List y; // y has type Widgets.LinkedList

Miembros de clase
Los miembros de una clase se componen de los miembros introducidos por su
class_member_declaration s y los miembros heredados de la clase base directa.

antlr

class_member_declaration

: constant_declaration

| field_declaration

| method_declaration

| property_declaration

| event_declaration

| indexer_declaration

| operator_declaration

| constructor_declaration

| destructor_declaration

| static_constructor_declaration

 | type_declaration

Los miembros de un tipo de clase se dividen en las siguientes categorías:

Constantes, que representan valores constantes asociados a la clase (constantes).

Campos, que son las variables de la clase (campos).
Los métodos, que implementan los cálculos y las acciones que puede realizar la
clase (métodos).
Propiedades, que definen las características con nombre y las acciones asociadas a
la lectura y escritura de esas características (propiedades).
Eventos, que definen las notificaciones que puede generar la clase (eventos).
Indexadores, que permiten indizar las instancias de la clase de la misma manera
(sintácticamente) que las matrices (indizadores).
Operadores, que definen los operadores de expresión que se pueden aplicar a las
instancias de la clase (operadores).
Constructores de instancias, que implementan las acciones necesarias para
inicializar las instancias de la clase (constructores de instancia)
Destructores, que implementan las acciones que se deben realizar antes de que las
instancias de la clase se descartan de forma permanente (destructores).
Constructores estáticos, que implementan las acciones necesarias para inicializar la
propia clase (constructores estáticos).
Tipos, que representan los tipos locales de la clase (tipos anidados).

Los miembros que pueden contener código ejecutable se conocen colectivamente

como miembros de función del tipo de clase. Los miembros de función de un tipo de
clase son los métodos, propiedades, eventos, indizadores, operadores, constructores de
instancias, destructores y constructores estáticos de ese tipo de clase.

Un class_declaration crea un nuevo espacio de declaración (declaraciones) y el

class_member_declaration s que contiene inmediatamente el class_declaration introduce
nuevos miembros en este espacio de declaración. Las siguientes reglas se aplican a
class_member_declaration s:

Los constructores de instancias, destructores y constructores estáticos deben tener

el mismo nombre que la clase de inclusión inmediata. Todos los demás miembros
deben tener nombres distintos del nombre de la clase de inclusión inmediata.
El nombre de una constante, un campo, una propiedad, un evento o un tipo debe
ser distinto de los nombres de todos los demás miembros declarados en la misma
clase.
El nombre de un método debe ser distinto de los nombres de todos los demás
métodos que no se declaran en la misma clase. Además, la firma (firmas y
 sobrecarga) de un método debe ser diferente de las firmas de todos los demás
métodos declarados en la misma clase y dos métodos declarados en la misma
clase no pueden tener firmas que solo difieran ref en out y.
La firma de un constructor de instancia debe ser diferente de las firmas de todos
los demás constructores de instancia declaradas en la misma clase y dos
constructores declarados en la misma clase no pueden tener firmas que solo
difieran en ref y out .
La firma de un indizador debe ser diferente de las firmas de todos los demás
indexadores declarados en la misma clase.
La firma de un operador debe ser diferente de las firmas de todos los demás
operadores declarados en la misma clase.

Los miembros heredados de un tipo de clase (herencia) no forman parte del espacio de
declaración de una clase. Por lo tanto, una clase derivada puede declarar un miembro
con el mismo nombre o signatura que un miembro heredado (que en efecto oculta el
miembro heredado).

El tipo de instancia
Cada declaración de clase tiene un tipo enlazado asociado (tipos enlazados y sin
enlazar), el tipo de instancia. En el caso de una declaración de clase genérica, el tipo de
instancia se forma creando un tipo construido (tipos construidos) a partir de la
declaración de tipos, y cada uno de los argumentos de tipo proporcionados es el
parámetro de tipo correspondiente. Dado que el tipo de instancia utiliza los parámetros
de tipo, solo se puede usar cuando los parámetros de tipo están en el ámbito; es decir,
dentro de la declaración de clase. El tipo de instancia es el tipo de this para el código
escrito dentro de la declaración de clase. En el caso de las clases no genéricas, el tipo de
instancia es simplemente la clase declarada. A continuación se muestran varias
declaraciones de clase junto con sus tipos de instancia:

C#

class A<T> // instance type: A<T>

class B {} // instance type: A<T>.B

class C<U> {} // instance type: A<T>.C<U>

class D {} // instance type: D

Miembros de tipos construidos

Los miembros no heredados de un tipo construido se obtienen sustituyendo, por cada
type_parameter en la declaración de miembro, el type_argument correspondiente del
tipo construido. El proceso de sustitución se basa en el significado semántico de las
declaraciones de tipos y no es simplemente una sustitución textual.

Por ejemplo, dada la declaración de clase genérica

C#

class Gen<T,U>

public T[,] a;

public void G(int i, T t, Gen<U,T> gt) {...}

public U Prop { get {...} set {...} }

public int H(double d) {...}

el tipo construido Gen<int[],IComparable<string>> tiene los siguientes miembros:

C#

public int[,][] a;

public void G(int i, int[] t, Gen<IComparable<string>,int[]> gt) {...}

public IComparable<string> Prop { get {...} set {...} }

public int H(double d) {...}

El tipo del miembro a en la declaración de clase genérica Gen es la "matriz

bidimensional de T ", por lo que el tipo del miembro a en el tipo construido anterior es
la "matriz bidimensional de una matriz unidimensional de int ", o int[,][] .

Dentro de los miembros de la función de instancia, el tipo de this es el tipo de

instancia (el tipo de instancia) de la declaración contenedora.

Todos los miembros de una clase genérica pueden usar parámetros de tipo de cualquier
clase envolvente, ya sea directamente o como parte de un tipo construido. Cuando se
usa un tipo construido cerrado determinado (tipos abiertos y cerrados) en tiempo de
ejecución, cada uso de un parámetro de tipo se reemplaza por el argumento de tipo
real proporcionado al tipo construido. Por ejemplo:

C#

class C<V>

public V f1;

public C<V> f2 = null;

public C(V x) {

 this.f1 = x;

this.f2 = this;
}

class Application

static void Main() {

C<int> x1 = new C<int>(1);

Console.WriteLine(x1.f1); // Prints 1

C<double> x2 = new C<double>(3.1415);

Console.WriteLine(x2.f1); // Prints 3.1415

Herencia
Una clase hereda los miembros de su tipo de clase base directa. La herencia significa
que una clase contiene implícitamente todos los miembros de su tipo de clase base
directa, a excepción de los constructores de instancias, destructores y constructores
estáticos de la clase base. Algunos aspectos importantes de la herencia son:

La herencia es transitiva. Si C se deriva de B y B se deriva de A , C hereda los

miembros declarados en, así B como los miembros declarados en A .
Una clase derivada extiende su clase base directa. Una clase derivada puede
agregar nuevos miembros a aquellos de los que hereda, pero no puede quitar la
definición de un miembro heredado.
Los constructores de instancias, destructores y constructores estáticos no se
heredan, pero todos los demás miembros son, independientemente de su
accesibilidad declarada (acceso a miembros). Sin embargo, en función de la
accesibilidad declarada, es posible que los miembros heredados no estén
accesibles en una clase derivada.
Una clase derivada puede ocultar (ocultar a travésde la herencia) los miembros
heredados declarando nuevos miembros con el mismo nombre o signatura. Sin
embargo, tenga en cuenta que ocultar un miembro heredado no quita ese
miembro; simplemente hace que ese miembro no sea accesible directamente a
través de la clase derivada.
Una instancia de una clase contiene un conjunto de todos los campos de instancia
declarados en la clase y sus clases base, y existe una conversión implícita
(conversiones de referencia implícita) de un tipo de clase derivada a cualquiera de
sus tipos de clase base. Por lo tanto, una referencia a una instancia de alguna clase
derivada se puede tratar como una referencia a una instancia de cualquiera de sus
clases base.
 Una clase puede declarar métodos virtuales, propiedades e indizadores, y las clases
derivadas pueden invalidar la implementación de estos miembros de función. Esto
permite que las clases muestren un comportamiento polimórfico en el que las
acciones realizadas por una invocación de miembro de función varían en función
del tipo en tiempo de ejecución de la instancia a través de la cual se invoca a ese
miembro de función.

El miembro heredado de un tipo de clase construido son los miembros del tipo de clase
base inmediato (clases base), que se encuentra sustituyendo los argumentos de tipo del
tipo construido por cada aparición de los parámetros de tipo correspondientes en la
especificación class_base . Estos miembros, a su vez, se transforman sustituyendo, por
cada type_parameter en la declaración de miembro, el type_argument correspondiente
de la especificación de class_base .

C#

class B<U>

public U F(long index) {...}

class D<T>: B<T[]>

public T G(string s) {...}

En el ejemplo anterior, el tipo construido D<int> tiene un miembro no heredado que se

public int G(string s) obtiene sustituyendo el argumento int de tipo para el
parámetro de tipo T . D<int> también tiene un miembro heredado de la declaración de
clase B . Este miembro heredado se determina determinando en primer lugar el tipo de
clase base B<int[]> de D<int> sustituyendo int por T en la especificación de clase
base B<T[]> . A continuación, como un argumento de tipo en B , int[] se sustituye por
U en, lo que public U F(long index) produce el miembro heredado public int[]
F(long index) .

El nuevo modificador
Un class_member_declaration puede declarar un miembro con el mismo nombre o
signatura que un miembro heredado. Cuando esto ocurre, se dice que el miembro de la
clase derivada oculta el miembro de la clase base. Ocultar un miembro heredado no se
considera un error, pero hace que el compilador emita una advertencia. Para suprimir la
advertencia, la declaración del miembro de la clase derivada puede incluir un new
modificador para indicar que el miembro derivado está pensado para ocultar el
miembro base. Este tema se describe con más detalle en ocultarse a travésde la
herencia.

Si new se incluye un modificador en una declaración que no oculta un miembro

heredado, se emite una advertencia para ese efecto. Esta advertencia se suprime
quitando el new modificador.

Modificadores de acceso
Un class_member_declaration puede tener cualquiera de los cinco tipos posibles de
accesibilidad declarada (accesibilidad declarada): public , protected internal ,
protected , internal o private . A excepción de la protected internal combinación,

se trata de un error en tiempo de compilación para especificar más de un modificador

de acceso. Cuando una class_member_declaration no incluye modificadores de acceso,
private se supone.

Tipos constituyentes
Los tipos que se usan en la declaración de un miembro se denominan tipos
constituyentes de ese miembro. Los tipos constituyentes posibles son el tipo de una
constante, un campo, una propiedad, un evento o un indizador, el tipo de valor devuelto
de un método o un operador, y los tipos de parámetro de un método, indizador,
operador o constructor de instancia. Los tipos constituyentes de un miembro deben ser
al menos tan accesibles como el propio miembro (restricciones de accesibilidad).

Miembros estáticos y de instancia

Los miembros de una clase son *miembros estáticos _ o _ miembros de instancia *. En
general, resulta útil pensar en que los miembros estáticos pertenecen a los tipos de
clase y a los miembros de instancia como pertenecientes a objetos (instancias de tipos
de clase).

Cuando un campo, método, propiedad, evento, operador o declaración de constructor

incluye un static modificador, declara un miembro estático. Además, una declaración
de constante o de tipo declara implícitamente un miembro estático. Los miembros
estáticos tienen las siguientes características:

Cuando se hace referencia a un miembro estático M en un member_access (acceso

a miembros) del formulario E.M , E debe indicar un tipo que contiene M . Se trata
de un error en tiempo de compilación para E que denote una instancia.
 Un campo estático identifica exactamente una ubicación de almacenamiento que
compartirán todas las instancias de un tipo de clase cerrada determinado.
Independientemente del número de instancias de un tipo de clase cerrada
determinado que se creen, solo hay una copia de un campo estático.
Un miembro de función estático (método, propiedad, evento, operador o
constructor) no funciona en una instancia específica y es un error en tiempo de
compilación para hacer referencia a this en este tipo de miembro de función.

Cuando un campo, un método, una propiedad, un evento, un indexador, un constructor

o una declaración de destructor no incluye un static modificador, declara un miembro
de instancia. (Un miembro de instancia se denomina a veces miembro no estático). Los
miembros de instancia tienen las siguientes características:

Cuando M se hace referencia a un miembro de instancia en un member_access

(acceso a miembros) del formulario E.M , E debe indicar una instancia de un tipo
que contenga M . Es un error en tiempo de enlace para E que denote un tipo.
Cada instancia de una clase contiene un conjunto independiente de todos los
campos de instancia de la clase.
Un miembro de función de instancia (método, propiedad, indizador, constructor
de instancia o destructor) opera en una instancia determinada de la clase y se
puede tener acceso a esta instancia como this (este acceso).

En el ejemplo siguiente se muestran las reglas para tener acceso a los miembros
estáticos y de instancia:

C#

class Test

int x;

static int y;

void F() {

x = 1; // Ok, same as this.x = 1

y = 1; // Ok, same as Test.y = 1

static void G() {

x = 1; // Error, cannot access this.x

y = 1; // Ok, same as Test.y = 1

static void Main() {

Test t = new Test();

t.x = 1; // Ok

t.y = 1; // Error, cannot access static member through

instance

 Test.x = 1; // Error, cannot access instance member through

type

Test.y = 1; // Ok

El F método muestra que en un miembro de función de instancia, se puede usar un

simple_name (nombres simples) para tener acceso a los miembros de instancia y a los
miembros estáticos. El G método muestra que en un miembro de función estático, es un
error en tiempo de compilación para tener acceso a un miembro de instancia a través
de un simple_name. El Main método muestra que en un member_access (acceso a
miembros), se debe tener acceso a los miembros de instancia a través de instancias de y
se debe tener acceso a los miembros estáticos a través de los tipos.

Tipos anidados
Un tipo declarado dentro de una declaración de clase o struct se denomina *tipo
anidado _. Un tipo que se declara dentro de una unidad de compilación o espacio de
nombres se denomina un tipo no anidado* *.

En el ejemplo

C#

using System;

class A

class B

static void F() {

Console.WriteLine("A.B.F");

B la clase es un tipo anidado porque se declara dentro de la clase A y A la clase es un

tipo no anidado porque se declara dentro de una unidad de compilación.

Nombre completo

El nombre completo (nombrescompletos) de un tipo anidado es, S.N donde S es el

nombre completo del tipo en el que N se declara el tipo.
Accesibilidad declarada
Los tipos no anidados pueden tener public o internal declarar accesibilidad y
internal declarar accesibilidad de forma predeterminada. Los tipos anidados también

pueden tener estas formas de accesibilidad declarada, además de una o varias formas
adicionales de accesibilidad declarada, dependiendo de si el tipo contenedor es una
clase o un struct:

Un tipo anidado que se declara en una clase puede tener cualquiera de las cinco
formas de accesibilidad declarada ( public , protected internal , protected ,
internal o private ) y, al igual que otros miembros de clase, tiene como valor
predeterminado la private accesibilidad declarada.
Un tipo anidado que se declara en un struct puede tener cualquiera de las tres
formas de accesibilidad declarada ( public , internal o private ) y, al igual que
otros miembros de struct, tiene como valor predeterminado la private
accesibilidad declarada.

En el ejemplo

C#

public class List

// Private data structure

private class Node

public object Data;

public Node Next;

public Node(object data, Node next) {

this.Data = data;

this.Next = next;

private Node first = null;

private Node last = null;

// Public interface

public void AddToFront(object o) {...}

public void AddToBack(object o) {...}

public object RemoveFromFront() {...}

public object RemoveFromBack() {...}

public int Count { get {...} }

declara una clase anidada privada Node .

Conde
Un tipo anidado puede ocultar (ocultar nombres) un miembro base. new Se permite el
modificador en las declaraciones de tipos anidados para que la ocultación se pueda
expresar explícitamente. En el ejemplo

C#

using System;

class Base

public static void M() {

Console.WriteLine("Base.M");

class Derived: Base

new public class M

public static void F() {

Console.WriteLine("Derived.M.F");

class Test

static void Main() {

Derived.M.F();

muestra una clase anidada M que oculta el método M definido en Base .

este acceso

Un tipo anidado y su tipo contenedor no tienen una relación especial con respecto a
this_access (este acceso). En concreto, this dentro de un tipo anidado no se puede usar
para hacer referencia a los miembros de instancia del tipo contenedor. En los casos en
los que un tipo anidado necesite tener acceso a los miembros de instancia de su tipo
contenedor, se puede proporcionar acceso proporcionando this para la instancia del
tipo contenedor como argumento de constructor para el tipo anidado. El ejemplo
siguiente

C#
 using System;

class C

int i = 123;

public void F() {

Nested n = new Nested(this);

n.G();

public class Nested

C this_c;

public Nested(C c) {

this_c = c;

public void G() {

Console.WriteLine(this_c.i);

class Test

static void Main() {

C c = new C();

c.F();

muestra esta técnica. Una instancia de C crea una instancia de Nested y pasa su propia
this al Nested constructor de para proporcionar el acceso posterior a C los miembros

de instancia de.

Acceso a los miembros privados y protegidos del tipo contenedor.

Un tipo anidado tiene acceso a todos los miembros a los que se puede tener acceso a
su tipo contenedor, incluidos los miembros del tipo contenedor que tienen private y
protected declaran la accesibilidad. En el ejemplo

C#

using System;

class C

 private static void F() {

Console.WriteLine("C.F");
}

public class Nested

public static void G() {

F();

class Test

static void Main() {

C.Nested.G();

muestra una clase C que contiene una clase anidada Nested . Dentro de Nested , el
método G llama al método estático F definido en C y F tiene una accesibilidad
declarada privada.

Un tipo anidado también puede tener acceso a los miembros protegidos definidos en
un tipo base de su tipo contenedor. En el ejemplo

C#

using System;

class Base

protected void F() {

Console.WriteLine("Base.F");

class Derived: Base

public class Nested

public void G() {

Derived d = new Derived();

d.F(); // ok

class Test

static void Main() {

Derived.Nested n = new Derived.Nested();

 n.G();

la clase anidada Derived.Nested tiene acceso al método protegido F definido en la

Derived clase base, Base , llamando a a través de una instancia de Derived .

Tipos anidados en clases genéricas

Una declaración de clase genérica puede contener declaraciones de tipos anidados. Los
parámetros de tipo de la clase envolvente se pueden usar dentro de los tipos anidados.
Una declaración de tipos anidados puede contener parámetros de tipo adicionales que
solo se aplican al tipo anidado.

Cada declaración de tipos contenida dentro de una declaración de clase genérica es

implícitamente una declaración de tipos genéricos. Al escribir una referencia a un tipo
anidado dentro de un tipo genérico, el tipo que contiene el tipo construido, incluidos
sus argumentos de tipo, debe denominarse. Sin embargo, desde dentro de la clase
externa, el tipo anidado se puede usar sin calificación; el tipo de instancia de la clase
externa se puede usar implícitamente al construir el tipo anidado. En el ejemplo
siguiente se muestran tres formas correctas de hacer referencia a un tipo construido
creado desde Inner ; los dos primeros son equivalentes:

C#

class Outer<T>

class Inner<U>

public static void F(T t, U u) {...}

static void F(T t) {

Outer<T>.Inner<string>.F(t, "abc"); // These two statements

have

Inner<string>.F(t, "abc"); // the same effect

Outer<int>.Inner<string>.F(3, "abc"); // This type is different

Outer.Inner<string>.F(t, "abc"); // Error, Outer needs type

arg

Aunque el estilo de programación es incorrecto, un parámetro de tipo de un tipo

anidado puede ocultar un miembro o un parámetro de tipo declarado en el tipo
externo:

C#

class Outer<T>

class Inner<T> // Valid, hides Outer's T

public T t; // Refers to Inner's T

Nombres de miembros reservados

Para facilitar la implementación subyacente en tiempo de ejecución de C#, para cada
declaración de miembro de origen que sea una propiedad, un evento o un indexador, la
implementación debe reservar dos firmas de método basadas en el tipo de declaración
de miembro, su nombre y su tipo. Se trata de un error en tiempo de compilación para
que un programa declare un miembro cuya firma coincide con una de estas firmas
reservadas, aunque la implementación de tiempo de ejecución subyacente no use estas
reservas.

Los nombres reservados no presentan declaraciones, por lo que no participan en la

búsqueda de miembros. Sin embargo, las signaturas de método reservado asociadas a
una declaración participan en la herencia (herencia) y se pueden ocultar con el new
modificador (el nuevo modificador).

La reserva de estos nombres sirve para tres propósitos:

Para permitir que la implementación subyacente use un identificador ordinario

como un nombre de método para obtener o establecer el acceso a la característica
del lenguaje C#.
Para permitir que otros lenguajes interoperen usando un identificador ordinario
como un nombre de método para obtener o establecer el acceso a la característica
del lenguaje C#.
Para asegurarse de que el origen aceptado por un compilador compatible lo
acepta otro, haciendo que los detalles de los nombres de miembro reservados
sean coherentes en todas las implementaciones de C#.

La declaración de un destructor (destructores) tambiénhace que se Reserve una firma

(los nombres de miembro están reservados para los destructores).

Nombres de miembro reservados para propiedades

En el caso de una propiedad P (propiedades) de tipo T , se reservan las siguientes
firmas:

C#

T get_P();

void set_P(T value);

Ambas firmas están reservadas, aunque la propiedad sea de solo lectura o de solo
escritura.

En el ejemplo

C#

using System;

class A

public int P {

get { return 123; }

class B: A

new public int get_P() {

return 456;

new public void set_P(int value) {

class Test

static void Main() {

B b = new B();

A a = b;

Console.WriteLine(a.P);

Console.WriteLine(b.P);

Console.WriteLine(b.get_P());

una clase A define una propiedad de solo lectura P , de modo que se reservan firmas
para get_P set_P los métodos y. Una clase se B deriva de A y oculta ambas firmas
reservadas. En el ejemplo se genera el resultado:
 Consola

123

123

456

Nombres de miembro reservados para eventos

Para un evento E (eventos) de tipo delegado T , se reservan las siguientes firmas:

C#

void add_E(T handler);

void remove_E(T handler);

Nombres de miembro reservados para los indizadores

En el caso de un indexador (indexadores) de tipo T con la lista de parámetros L , se
reservan las siguientes firmas:

C#

T get_Item(L);

void set_Item(L, T value);

Ambas firmas están reservadas, aunque el indizador sea de solo lectura o de solo
escritura.

Además, el nombre del miembro Item está reservado.

Nombres de miembro reservados para destructores

Para una clase que contiene un destructor(destructores), se reserva la firma siguiente:

C#

void Finalize();

Constantes
*Constant _ es un miembro de clase que representa un valor constante: un valor que se
puede calcular en tiempo de compilación. Un _constant_declaration * introduce una o
más constantes de un tipo determinado.

antlr

constant_declaration

: attributes? constant_modifier* 'const' type constant_declarators ';'

constant_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

constant_declarators

: constant_declarator (',' constant_declarator)*

constant_declarator

: identifier '=' constant_expression

Un constant_declaration puede incluir un conjunto de atributos (atributos), un new

modificador (el nuevo modificador) y una combinación válida de los cuatro
modificadores de acceso (modificadores de acceso). Los atributos y modificadores se
aplican a todos los miembros declarados por el constant_declaration. Aunque las
constantes se consideran miembros estáticos, una constant_declaration no requiere ni
permite un static modificador. Es un error que el mismo modificador aparezca varias
veces en una declaración de constante.

El tipo de un constant_declaration especifica el tipo de los miembros introducidos por la

declaración. El tipo va seguido de una lista de constant_declarator s, cada uno de los
cuales incorpora un nuevo miembro. Un constant_declarator consta de un identificador
que denomina al miembro, seguido de un token " = ", seguido de un
constant_expression (expresiones constantes) que proporciona el valor del miembro.

El tipo especificado en una declaración de constante debe ser sbyte , byte , short ,
ushort , int , uint , long , ulong , char , float , double , decimal , bool , string , un

enum_type o un reference_type. Cada constant_expression debe producir un valor del tipo

de destino o de un tipo que se pueda convertir al tipo de destino mediante una
conversión implícita (conversiones implícitas).

El tipo de una constante debe ser al menos tan accesible como la propia constante
(restricciones de accesibilidad).
El valor de una constante se obtiene en una expresión usando un simple_name
(nombres simples) o un member_access (acceso a miembros).

Una constante puede participar en una constant_expression. Por lo tanto, se puede

utilizar una constante en cualquier construcción que requiera una constant_expression.
Entre los ejemplos de estas construcciones se incluyen case etiquetas, goto case
instrucciones, enum declaraciones de miembros, atributos y otras declaraciones de
constantes.

Como se describe en expresiones constantes, una constant_expression es una expresión

que se puede evaluar por completo en tiempo de compilación. Dado que la única forma
de crear un valor que no sea NULL de un reference_type distinto de string es aplicar el
new operador, y dado que new no se permite el operador en un constant_expression, el

único valor posible para las constantes de reference_type s no string es null .

Cuando se desea un nombre simbólico para un valor constante, pero cuando el tipo de
ese valor no se permite en una declaración de constante, o cuando el valor no se puede
calcular en tiempo de compilación mediante un constant_expression, readonly se puede
usar en su lugar un campo (campos de solo lectura).

Una declaración de constante que declara varias constantes es equivalente a varias

declaraciones de constantes únicas con los mismos atributos, modificadores y tipo. Por
ejemplo

C#

class A

public const double X = 1.0, Y = 2.0, Z = 3.0;

es equivalente a

C#

class A

public const double X = 1.0;

public const double Y = 2.0;

public const double Z = 3.0;

Las constantes pueden depender de otras constantes en el mismo programa, siempre

que las dependencias no sean de naturaleza circular. El compilador se organiza
automáticamente para evaluar las declaraciones de constantes en el orden adecuado. En
el ejemplo

C#

class A

public const int X = B.Z + 1;

public const int Y = 10;

class B

public const int Z = A.Y + 1;

en primer lugar, el compilador evalúa A.Y , evalúa B.Z y, por último, evalúa y A.X
genera los valores 10 , 11 y 12 . Las declaraciones de constantes pueden depender de
constantes de otros programas, pero dichas dependencias solo son posibles en una
dirección. Tomando como referencia el ejemplo anterior, si A y B se declararon en
programas independientes, sería posible A.X que dependa de B.Z , pero B.Z no puede
depender simultáneamente A.Y .

Campos
Un *campo _ es un miembro que representa una variable asociada con un objeto o una
clase. Un _field_declaration * introduce uno o más campos de un tipo determinado.

antlr

field_declaration

: attributes? field_modifier* type variable_declarators ';'

field_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| 'static'

| 'readonly'

| 'volatile'

| field_modifier_unsafe

variable_declarators

: variable_declarator (',' variable_declarator)*

variable_declarator

: identifier ('=' variable_initializer)?

variable_initializer

: expression

| array_initializer

Un field_declaration puede incluir un conjunto de atributos (atributos), un new

modificador (el nuevo modificador), una combinación válida de los cuatro
modificadores de acceso (modificadores de acceso) y un static modificador (campos
estáticos y de instancia). Además, un field_declaration puede incluir un readonly
modificador (campos de solo lectura) o un volatile modificador (campos volátiles),
pero no ambos. Los atributos y modificadores se aplican a todos los miembros
declarados por el field_declaration. Es un error que el mismo modificador aparezca
varias veces en una declaración de campo.

El tipo de un field_declaration especifica el tipo de los miembros introducidos por la

declaración. El tipo va seguido de una lista de variable_declarator s, cada uno de los
cuales incorpora un nuevo miembro. Un variable_declarator consta de un identificador
que asigna un nombre a ese miembro, seguido opcionalmente por un = token "" y un
variable_initializer (inicializadores de variables) que proporciona el valor inicial de ese
miembro.

El tipo de un campo debe ser al menos igual de accesible que el propio campo
(restricciones de accesibilidad).

El valor de un campo se obtiene en una expresión usando un simple_name (nombres

simples) o un member_access (acceso a miembros). El valor de un campo que no es de
solo lectura se modifica mediante una asignación (operadores de asignación). El valor de
un campo que no es de solo lectura se puede obtener y modificar mediante operadores
de incremento y decremento postfijos (operadores de incremento y
decrementopostfijo) y operadores de incremento y decremento prefijos (operadores de
incremento y decremento de prefijo).

Una declaración de campo que declara varios campos es equivalente a varias

declaraciones de campos únicos con los mismos atributos, modificadores y tipo. Por
ejemplo

C#
 class A

public static int X = 1, Y, Z = 100;

es equivalente a

C#

class A

public static int X = 1;

public static int Y;

public static int Z = 100;

Campos estáticos y de instancia

Cuando una declaración de campo incluye un static modificador, los campos
introducidos por la declaración son *campos estáticos _. Cuando no hay ningún static
modificador, los campos introducidos por la declaración son campos de instancia. Los
campos estáticos y los campos de instancia son dos de los diversos tipos de variables
(variables) admitidos por C# y, en ocasiones, se hace referencia a ellas como variables
estáticas y _ variables de instancia *, respectivamente.

Los campos estáticos no forman parte de una instancia específica; en su lugar, se

comparte entre todas las instancias de un tipo cerrado (tipos abiertos y cerrados).
Independientemente del número de instancias de un tipo de clase cerrada, solo hay una
copia de un campo estático para el dominio de aplicación asociado.

Por ejemplo:

C#

class C<V>

static int count = 0;

public C() {

count++;

public static int Count {

get { return count; }

 class Application

static void Main() {

C<int> x1 = new C<int>();

Console.WriteLine(C<int>.Count); // Prints 1

C<double> x2 = new C<double>();

Console.WriteLine(C<int>.Count); // Prints 1

C<int> x3 = new C<int>();

Console.WriteLine(C<int>.Count); // Prints 2

Un campo de instancia pertenece a una instancia de. En concreto, cada instancia de una
clase contiene un conjunto independiente de todos los campos de instancia de esa
clase.

Cuando se hace referencia a un campo en un member_access (acceso a miembros) del

formulario E.M , si M es un campo estático, E debe indicar un tipo que contiene M y si
M es un campo de instancia, E debe denotar una instancia de un tipo que contenga M .

Las diferencias entre los miembros estáticos y de instancia se tratan más adelante en
miembros estáticos y de instancia.

Campos de solo lectura

Cuando una field_declaration incluye un readonly modificador, los campos introducidos
por la declaración son campos de solo lectura. Las asignaciones directas a campos de
solo lectura solo se pueden producir como parte de la declaración o en un constructor
de instancia o en un constructor estático de la misma clase. (Un campo de solo lectura
se puede asignar a varias veces en estos contextos). En concreto, las asignaciones
directas a un readonly campo solo se permiten en los contextos siguientes:

En el variable_declarator que presenta el campo (incluyendo un variable_initializer

en la declaración).
Para un campo de instancia, en los constructores de instancia de la clase que
contiene la declaración de campo; para un campo estático, en el constructor
estático de la clase que contiene la declaración de campo. Estos son también los
únicos contextos en los que es válido pasar un readonly campo como un out
parámetro o ref .

Si se intenta asignar a un readonly campo o pasarlo como un out ref parámetro o en

cualquier otro contexto, se trata de un error en tiempo de compilación.
Usar campos de solo lectura estáticos para constantes
Un static readonly campo es útil cuando se desea un nombre simbólico para un valor
constante, pero cuando no se permite el tipo del valor en una const declaración, o
cuando el valor no se puede calcular en tiempo de compilación. En el ejemplo

C#

public class Color

public static readonly Color Black = new Color(0, 0, 0);

public static readonly Color White = new Color(255, 255, 255);

public static readonly Color Red = new Color(255, 0, 0);

public static readonly Color Green = new Color(0, 255, 0);

public static readonly Color Blue = new Color(0, 0, 255);

private byte red, green, blue;

public Color(byte r, byte g, byte b) {

red = r;

green = g;

blue = b;

los Black miembros,, White Red , Green y Blue no se pueden declarar como const
miembros porque sus valores no se pueden calcular en tiempo de compilación. Sin
embargo, si se declaran static readonly en su lugar, se produce el mismo efecto.

Control de versiones de constantes y campos de solo lectura

estáticos

Las constantes y los campos de solo lectura tienen una semántica de versiones binaria
diferente. Cuando una expresión hace referencia a una constante, el valor de la
constante se obtiene en tiempo de compilación, pero cuando una expresión hace
referencia a un campo de solo lectura, el valor del campo no se obtiene hasta el tiempo
de ejecución. Considere una aplicación que consta de dos programas independientes:

C#

using System;

namespace Program1

public class Utils

public static readonly int X = 1;

namespace Program2

class Test

static void Main() {

Console.WriteLine(Program1.Utils.X);

Los Program1 Program2 espacios de nombres y denotan dos programas que se compilan
por separado. Dado Program1.Utils.X que se declara como un campo estático de solo
lectura, la salida del valor de la Console.WriteLine instrucción no se conoce en tiempo
de compilación, sino que se obtiene en tiempo de ejecución. Por lo tanto, si el valor de
X se cambia y Program1 se vuelve a compilar, la Console.WriteLine instrucción generará

el nuevo valor aunque no se vuelva a Program2 compilar. Sin embargo, había X sido una
constante, el valor de X se habría obtenido en el momento en Program2 que se compiló
y no se vería afectado por los cambios en Program1 hasta que se vuelva a Program2
compilar.

Campos volátiles
Cuando una field_declaration incluye un volatile modificador, los campos introducidos
por esa declaración son campos volátiles.

En el caso de los campos no volátiles, las técnicas de optimización que reordenan las
instrucciones pueden provocar resultados inesperados e imprevisibles en programas
multiproceso que tienen acceso a campos sin sincronización, como los que proporciona
el lock_statement (la instrucción lock). Estas optimizaciones las puede realizar el
compilador, el sistema en tiempo de ejecución o el hardware. En el caso de los campos
volátiles, las optimizaciones de reordenación están restringidas:

Una lectura de un campo volátil se denomina lectura volátil. Una lectura volátil
tiene la "semántica de adquisición"; es decir, se garantiza que se produce antes de
las referencias a la memoria que se producen después de ella en la secuencia de
instrucciones.
La escritura de un campo volátil se denomina escritura volátil. Una escritura volátil
tiene "semántica de versión"; es decir, se garantiza que se produce después de
cualquier referencia de memoria antes de la instrucción de escritura en la
secuencia de instrucciones.
Estas restricciones aseguran que todos los subprocesos observarán las operaciones de
escritura volátiles realizadas por cualquier otro subproceso en el orden en que se
realizaron. No se requiere una implementación compatible para proporcionar una
ordenación total única de escrituras volátiles, como se aprecia en todos los subprocesos
de ejecución. El tipo de un campo volátil debe ser uno de los siguientes:

Reference_type.
Tipo byte , sbyte , short , ushort , int , uint , char ,,, float bool
System.IntPtr o System.UIntPtr .

Enum_type que tiene un tipo base enum de byte , sbyte , short , ushort , int o
uint .

En el ejemplo

C#

using System;

using System.Threading;

class Test

public static int result;

public static volatile bool finished;

static void Thread2() {

result = 143;

finished = true;

static void Main() {

finished = false;

// Run Thread2() in a new thread

new Thread(new ThreadStart(Thread2)).Start();

// Wait for Thread2 to signal that it has a result by setting

// finished to true.

for (;;) {

if (finished) {

Console.WriteLine("result = {0}", result);

return;

genera el resultado:

Consola
 result = 143

En este ejemplo, el método Main inicia un nuevo subproceso que ejecuta el método
Thread2 . Este método almacena un valor en un campo no volátil denominado result y,

a continuación, almacena true en el campo volatile finished . El subproceso principal

espera a que el campo finished se establezca en true y, a continuación, lee el campo
result . Dado que se ha finished declarado volatile , el subproceso principal debe

leer el valor 143 del campo result . Si finished no se ha declarado el campo volatile
, se permite que el almacén result sea visible para el subproceso principal después del
almacén en finished y, por lo tanto, para que el subproceso principal Lea el valor 0 del
campo result . Declarar finished como un volatile campo evita cualquier
incoherencia.

Inicialización de campos
El valor inicial de un campo, ya sea un campo estático o un campo de instancia, es el
valor predeterminado (valores predeterminados) del tipo de campo. No es posible
observar el valor de un campo antes de que se haya producido esta inicialización
predeterminada y, por tanto, un campo nunca es "no inicializado". En el ejemplo

C#

using System;

class Test

static bool b;

int i;

static void Main() {

Test t = new Test();

Console.WriteLine("b = {0}, i = {1}", b, t.i);

genera el resultado

Consola

b = False, i = 0

dado b i que y se inicializan automáticamente en los valores predeterminados.

Inicializadores de variables
Las declaraciones de campo pueden incluir variable_initializer s. En los campos estáticos,
los inicializadores de variables corresponden a las instrucciones de asignación que se
ejecutan durante la inicialización de la clase. En el caso de los campos de instancia, los
inicializadores de variables corresponden a las instrucciones de asignación que se
ejecutan cuando se crea una instancia de la clase.

En el ejemplo

C#

using System;

class Test

static double x = Math.Sqrt(2.0);

int i = 100;

string s = "Hello";

static void Main() {

Test a = new Test();

Console.WriteLine("x = {0}, i = {1}, s = {2}", x, a.i, a.s);

genera el resultado

Consola

x = 1.4142135623731, i = 100, s = Hello

Dado que una asignación x tiene lugar cuando los inicializadores de campo estáticos
ejecutan y se asignan a i y s se producen cuando se ejecutan los inicializadores de
campo de instancia.

La inicialización del valor predeterminado que se describe en inicialización de campos se

produce para todos los campos, incluidos los campos que tienen inicializadores
variables. Por lo tanto, cuando se inicializa una clase, todos los campos estáticos de esa
clase se inicializan primero a sus valores predeterminados y, a continuación, los
inicializadores de campo estáticos se ejecutan en orden textual. Del mismo modo,
cuando se crea una instancia de una clase, todos los campos de instancia de esa
instancia se inicializan por primera vez con sus valores predeterminados y, a
continuación, los inicializadores de campo de instancia se ejecutan en orden textual.
Es posible que se respeten los campos estáticos con inicializadores variables en su
estado de valor predeterminado. Sin embargo, esto no se recomienda como cuestión de
estilo. En el ejemplo

C#

using System;

class Test

static int a = b + 1;

static int b = a + 1;

static void Main() {

Console.WriteLine("a = {0}, b = {1}", a, b);

exhibe este comportamiento. A pesar de las definiciones circulares de a y b, el programa

es válido. Da como resultado la salida

Consola

a = 1, b = 2

Dado que los campos estáticos a y b se inicializan en 0 (el valor predeterminado para
int ) antes de que se ejecuten sus inicializadores. Cuando se ejecuta el inicializador de

a , el valor de b es cero y, por tanto, a se inicializa en 1 . Cuando el inicializador de b

se ejecuta, el valor de a ya es 1 y b se inicializa en 2 .

Inicialización de campos estáticos

Los inicializadores de variables de campo estáticos de una clase corresponden a una

secuencia de asignaciones que se ejecutan en el orden textual en el que aparecen en la
declaración de clase. Si un constructor estático (constructores estáticos) existe en la
clase, la ejecución de los inicializadores de campo estáticos se produce inmediatamente
antes de ejecutar ese constructor estático. De lo contrario, los inicializadores de campo
estáticos se ejecutan en un momento dependiente de la implementación antes del
primer uso de un campo estático de esa clase. En el ejemplo

C#

using System;

class Test

static void Main() {

Console.WriteLine("{0} {1}", B.Y, A.X);

public static int F(string s) {

Console.WriteLine(s);

return 1;

class A

public static int X = Test.F("Init A");

class B

public static int Y = Test.F("Init B");

puede producir la salida:

Consola

Init A

Init B

1 1

o la salida:

Consola

Init B

Init A

1 1

Dado que la ejecución del X inicializador de y Y del inicializador de se puede producir

en cualquier orden; solo se restringen para que se hagan referencia a esos campos. Sin
embargo, en el ejemplo:

C#

using System;

class Test

static void Main() {

Console.WriteLine("{0} {1}", B.Y, A.X);

 public static int F(string s) {

Console.WriteLine(s);

return 1;

class A

static A() {}

public static int X = Test.F("Init A");

class B

static B() {}

public static int Y = Test.F("Init B");

la salida debe ser:

Consola

Init B

Init A

1 1

Dado que las reglas para cuando los constructores estáticos se ejecutan (como se
definen en constructores estáticos), proporcionan el B constructor estático de (y, por
tanto, los B inicializadores de campo estáticos) que se deben ejecutar antes que los A
inicializadores de campo y constructores estáticos de.

Inicialización de campos de instancia

Los inicializadores de variable de campo de instancia de una clase corresponden a una
secuencia de asignaciones que se ejecutan inmediatamente después de la entrada a
cualquiera de los constructores de instancia (inicializadores de constructor) de esa clase.
Los inicializadores de variable se ejecutan en el orden textual en el que aparecen en la
declaración de clase. El proceso de creación e inicialización de instancias de clase se
describe con más detalle en constructores de instancias.

Un inicializador de variable para un campo de instancia no puede hacer referencia a la

instancia que se está creando. Por lo tanto, se trata de un error en tiempo de
compilación para hacer referencia a this un inicializador de variable, ya que se trata de
un error en tiempo de compilación para que un inicializador de variable haga referencia
a un miembro de instancia a través de un simple_name. En el ejemplo

C#

class A

int x = 1;

int y = x + 1; // Error, reference to instance member of this

el inicializador de variable para y genera un error en tiempo de compilación porque

hace referencia a un miembro de la instancia que se va a crear.

Métodos
Un *método _ es un miembro que implementa un cálculo o una acción que puede
realizar un objeto o una clase. Los métodos se declaran mediante _method_declaration *
s:

antlr

method_declaration

: method_header method_body

method_header

: attributes? method_modifier* 'partial'? return_type member_name

type_parameter_list?

'(' formal_parameter_list? ')' type_parameter_constraints_clause*

method_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| 'static'

| 'virtual'

| 'sealed'

| 'override'

| 'abstract'

| 'extern'

| 'async'

| method_modifier_unsafe

return_type

 : type

| 'void'

member_name

: identifier

| interface_type '.' identifier

method_body

: block

| '=>' expression ';'

| ';'

Un method_declaration puede incluir un conjunto de atributos (atributos) y una

combinación válida de los cuatro modificadores de acceso (modificadores de acceso), el
new (el nuevo modificador), static (métodos estáticos y de instancia), virtual

(métodos virtuales), override (métodos de invalidación), (métodos sellados), (métodos

sealed abstract abstractos) y extern Modificadores (métodos externos).

Una declaración tiene una combinación válida de modificadores si se cumplen todas las
condiciones siguientes:

La Declaración incluye una combinación válida de modificadores de acceso

(modificadores de acceso).
La declaración no incluye el mismo modificador varias veces.
La Declaración incluye como máximo uno de los siguientes modificadores: static ,
virtual y override .

La Declaración incluye como máximo uno de los siguientes modificadores: new y

override .
Si la Declaración incluye el abstract modificador, la declaración no incluye
ninguno de los modificadores siguientes: static , virtual sealed o extern .
Si la Declaración incluye el private modificador, la declaración no incluye ninguno
de los modificadores siguientes: virtual , override o abstract .
Si la Declaración incluye el sealed modificador, la Declaración también incluye el
override modificador.

Si la Declaración incluye el partial modificador, no incluye ninguno de los

siguientes modificadores: new , public , protected , internal , private , virtual ,
sealed ,, override abstract o extern .

Un método que tiene el async modificador es una función asincrónica y sigue las reglas
descritas en funciones asincrónicas.
El return_type de una declaración de método especifica el tipo del valor calculado y
devuelto por el método. El return_type es void si el método no devuelve un valor. Si la
Declaración incluye el partial modificador, el tipo de valor devuelto debe ser void .

El member_name especifica el nombre del método. A menos que el método sea una
implementación explícita de un miembro de interfaz (implementaciones explícitas de
miembros de interfaz), el member_name es simplemente un identificador. En el caso de
una implementación explícita de un miembro de interfaz, el member_name se compone
de un interface_type seguido de un " . " y un identificador.

El type_parameter_list opcional especifica los parámetros de tipo del método

(parámetros de tipo). Si se especifica un type_parameter_list el método es un *método
genérico _. Si el método tiene un extern modificador, no se puede especificar un
_type_parameter_list *.

El formal_parameter_list opcional especifica los parámetros del método (parámetros de

método).

Los type_parameter_constraints_clause opcionales especifican restricciones en

parámetros de tipo individuales (restricciones de parámetro de tipo) y solo se pueden
especificar si también se proporciona un type_parameter_list y el método no tiene un
override modificador.

El return_type y cada uno de los tipos a los que se hace referencia en el

formal_parameter_list de un método deben ser al menos tan accesibles como el propio
método (restricciones de accesibilidad).

La method_body es un punto y coma, un cuerpo de instrucción* o un cuerpo de

expresión. Un cuerpo de instrucción consta de un _block *, que especifica las
instrucciones que se ejecutarán cuando se invoque el método. Un cuerpo de expresión
consta de => seguido de una expresión y un punto y coma, y denota una expresión
única que se debe realizar cuando se invoca el método.

Para abstract extern los métodos y, el method_body consta simplemente de un punto

y coma. En el caso de los partial métodos, el method_body puede constar de un punto
y coma, un cuerpo de bloque o un cuerpo de expresión. En el caso de todos los demás
métodos, el method_body es un cuerpo de bloque o un cuerpo de expresión.

Si el method_body consta de un punto y coma, la declaración no puede incluir el async

modificador.

El nombre, la lista de parámetros de tipo y la lista de parámetros formales de un

método definen la firma (firmas y sobrecarga) del método. En concreto, la firma de un
método consta de su nombre, el número de parámetros de tipo y el número,
modificadores y tipos de sus parámetros formales. Para estos propósitos, cualquier
parámetro de tipo del método que se produce en el tipo de un parámetro formal se
identifica no por su nombre, sino por su posición ordinal en la lista de argumentos de
tipo del método. El tipo de valor devuelto no forma parte de la signatura de un método,
ni tampoco los nombres de los parámetros de tipo o los parámetros formales.

El nombre de un método debe ser distinto de los nombres de todos los demás métodos
que no se declaran en la misma clase. Además, la firma de un método debe ser
diferente de las firmas de todos los demás métodos declarados en la misma clase y dos
métodos declarados en la misma clase no pueden tener firmas que solo difieran en ref
y out .

Los type_parameter s del método están en el ámbito de la method_declaration y se

pueden usar para formar tipos en ese ámbito en return_type, method_body y
type_parameter_constraints_clause s, pero no en atributos.

Todos los parámetros formales y los parámetros de tipo deben tener nombres
diferentes.

Parámetros de método
Los parámetros de un método, si los hay, se declaran mediante el formal_parameter_list
del método.

antlr

formal_parameter_list

: fixed_parameters

| fixed_parameters ',' parameter_array

| parameter_array

fixed_parameters

: fixed_parameter (',' fixed_parameter)*

fixed_parameter

: attributes? parameter_modifier? type identifier default_argument?

default_argument

: '=' expression

parameter_modifier

: 'ref'

 | 'out'

| 'this'

parameter_array

: attributes? 'params' array_type identifier

La lista de parámetros formales está formada por uno o varios parámetros separados
por comas, de los cuales solo el último puede ser un parameter_array.

Un fixed_parameter consta de un conjunto opcional de atributos (atributos), un ref

modificador opcional, out o this , un tipo, un identificador y un default_argument
opcional. Cada fixed_parameter declara un parámetro del tipo especificado con el
nombre especificado. El this modificador designa el método como un método de
extensión y solo se permite en el primer parámetro de un método estático. Los métodos
de extensión se describen con más detalle en métodos de extensión.

Un fixed_parameter con un default_argument se conoce como un *parámetro opcional ,

mientras que un fixed_parameter * sin default_argument es un parámetro obligatorio*..
Es posible que un parámetro necesario no aparezca después de un parámetro opcional
en un _formal_parameter_list *.

Un ref out parámetro o no puede tener un default_argument. La expresión de un

default_argument debe ser una de las siguientes:

a constant_expression
una expresión con el formato, new S() donde S es un tipo de valor.
una expresión con el formato, default(S) donde S es un tipo de valor.

La expresión debe poder convertirse implícitamente mediante una identidad o una

conversión que acepte valores NULL en el tipo del parámetro.

Si se producen parámetros opcionales en una declaración de método parcial de

implementación (métodos parciales), una implementación explícita de un miembro de
interfaz (implementaciones de miembros de interfaz explícitos) o en una declaración de
indexador de un solo parámetro (indizadores), el compilador debe proporcionar una
advertencia, ya que estos miembros nunca se pueden invocar de forma que permita
omitir los argumentos.

Un parameter_array consta de un conjunto opcional de atributos (atributos), un params

modificador, un array_type y un identificador. Una matriz de parámetros declara un
parámetro único del tipo de matriz especificado con el nombre especificado. El
array_type de una matriz de parámetros debe ser un tipo de matriz unidimensional
(tipos de matriz). En una invocación de método, una matriz de parámetros permite
especificar un único argumento del tipo de matriz especificado o permite que se
especifiquen cero o más argumentos del tipo de elemento de matriz. Las matrices de
parámetros se describen con más detalle en matrices de parámetros.

Una parameter_array puede producirse después de un parámetro opcional, pero no

puede tener un valor predeterminado, la omisión de los argumentos de un
parameter_array daría lugar a la creación de una matriz vacía.

En el ejemplo siguiente se muestran diferentes tipos de parámetros:

C#

public void M(

ref int i,

decimal d,

bool b = false,

bool? n = false,

string s = "Hello",

object o = null,

T t = default(T),

params int[] a

) { }

En el formal_parameter_list de M , i es un parámetro ref necesario, d es un parámetro

de valor necesario b , s , o y t son parámetros de valor opcionales y a es una matriz
de parámetros.

Una declaración de método crea un espacio de declaración independiente para los

parámetros, los parámetros de tipo y las variables locales. Los nombres se introducen en
este espacio de declaración mediante la lista de parámetros de tipo y la lista de
parámetros formales del método y las declaraciones de variables locales en el bloque del
método. Es un error que dos miembros de un espacio de declaración de método tengan
el mismo nombre. Es un error que el espacio de declaración de método y el espacio de
declaración de variable local de un espacio de declaración anidado contengan
elementos con el mismo nombre.

Una invocación de método (invocaciones de método) crea una copia, específica de

dicha invocación, de los parámetros formales y las variables locales del método, y la lista
de argumentos de la invocación asigna valores o referencias a variables a los
parámetros formales recién creados. Dentro del bloque de un método, se puede hacer
referencia a los parámetros formales por sus identificadores en expresiones de
Simple_name (nombres simples).

Hay cuatro tipos de parámetros formales:

 Parámetros de valor, que se declaran sin ningún modificador.
Parámetros de referencia, que se declaran con el ref modificador.
Parámetros de salida, que se declaran con el out modificador.
Matrices de parámetros, que se declaran con el params modificador.

Como se describe en firmas y sobrecarga, los ref out modificadores y forman parte de
la firma de un método, pero el params modificador no es.

Parámetros de valor
Un parámetro declarado sin modificadores es un parámetro de valor. Un parámetro de
valor corresponde a una variable local que obtiene su valor inicial del argumento
correspondiente proporcionado en la invocación del método.

Cuando un parámetro formal es un parámetro de valor, el argumento correspondiente

en una invocación de método debe ser una expresión que se pueda convertir
implícitamente (conversiones implícitas) en el tipo de parámetro formal.

Un método puede asignar nuevos valores a un parámetro de valor. Dichas asignaciones

solo afectan a la ubicación de almacenamiento local representada por el parámetro de
valor; no tienen ningún efecto en el argumento real proporcionado en la invocación del
método.

Parámetros de referencia
Un parámetro declarado con un ref modificador es un parámetro de referencia. A
diferencia de un parámetro de valor, un parámetro de referencia no crea una nueva
ubicación de almacenamiento. En su lugar, un parámetro de referencia representa la
misma ubicación de almacenamiento que la variable proporcionada como argumento
en la invocación del método.

Cuando un parámetro formal es un parámetro de referencia, el argumento

correspondiente en una invocación de método debe constar de la palabra clave ref
seguida de un variable_reference (reglas precisas para determinar la asignación
definitiva) del mismo tipo que el parámetro formal. Una variable debe estar asignada
definitivamente antes de que se pueda pasar como parámetro de referencia.

Dentro de un método, un parámetro de referencia se considera siempre asignado

definitivamente.

Un método declarado como iterador (iteradores) no puede tener parámetros de

referencia.
En el ejemplo

C#

using System;

class Test

static void Swap(ref int x, ref int y) {

int temp = x;

x = y;

y = temp;

static void Main() {

int i = 1, j = 2;

Swap(ref i, ref j);

Console.WriteLine("i = {0}, j = {1}", i, j);

genera el resultado

Consola

i = 2, j = 1

Para la invocación de Swap en Main , x representa i y y representa j . Por lo tanto, la

invocación tiene el efecto de intercambiar los valores de i y j .

En un método que toma parámetros de referencia, es posible que varios nombres

representen la misma ubicación de almacenamiento. En el ejemplo

C#

class A

string s;

void F(ref string a, ref string b) {

s = "One";

a = "Two";

b = "Three";

void G() {

F(ref s, ref s);

la invocación de F en G pasa una referencia a s para a y b . Por lo tanto, para esa

invocación, los nombres s , a y b hacen referencia a la misma ubicación de
almacenamiento, y las tres asignaciones modifican el campo de instancia s .

Parámetros de salida
Un parámetro declarado con un out modificador es un parámetro de salida. De forma
similar a un parámetro de referencia, un parámetro de salida no crea una nueva
ubicación de almacenamiento. En su lugar, un parámetro de salida representa la misma
ubicación de almacenamiento que la variable proporcionada como argumento en la
invocación del método.

Cuando un parámetro formal es un parámetro de salida, el argumento correspondiente

en una invocación de método debe constar de la palabra clave out seguida de un
variable_reference (reglas precisas para determinar la asignación definitiva) del mismo
tipo que el parámetro formal. No es necesario asignar definitivamente una variable
antes de que se pueda pasar como parámetro de salida, pero después de una
invocación en la que se pasó una variable como parámetro de salida, la variable se
considera definitivamente asignada.

Dentro de un método, al igual que una variable local, un parámetro de salida se

considera inicialmente sin asignar y debe asignarse definitivamente antes de usar su
valor.

Todos los parámetros de salida de un método se deben asignar definitivamente antes

de que el método devuelva.

Un método declarado como método parcial (métodos parciales) o un iterador

(iteradores) no puede tener parámetros de salida.

Los parámetros de salida se usan normalmente en métodos que producen varios valores
devueltos. Por ejemplo:

C#

using System;

class Test

static void SplitPath(string path, out string dir, out string name) {

int i = path.Length;

while (i > 0) {
char ch = path[i - 1];

if (ch == '\\' || ch == '/' || ch == ':') break;

i--;

dir = path.Substring(0, i);

name = path.Substring(i);
}

static void Main() {

string dir, name;

SplitPath("c:\\Windows\\System\\hello.txt", out dir, out name);

Console.WriteLine(dir);

Console.WriteLine(name);

En el ejemplo se genera el resultado:

Consola

c:\Windows\System\

hello.txt

Tenga en cuenta que las dir name variables y se pueden desasignar antes de que se
pasen a SplitPath , y que se consideran definitivamente asignadas después de la
llamada.

Matrices de parámetros

Un parámetro declarado con un params modificador es una matriz de parámetros. Si

una lista de parámetros formales incluye una matriz de parámetros, debe ser el último
parámetro de la lista y debe ser de un tipo de matriz unidimensional. Por ejemplo, los
tipos string[] y string[][] se pueden utilizar como el tipo de una matriz de
parámetros, pero el tipo string[,] no puede. No es posible combinar el params
modificador con los modificadores ref y out .

Una matriz de parámetros permite especificar argumentos de una de estas dos maneras
en una invocación de método:

El argumento dado para una matriz de parámetros puede ser una expresión única
que se pueda convertir implícitamente (conversiones implícitas) en el tipo de
matriz de parámetros. En este caso, la matriz de parámetros actúa exactamente
como un parámetro de valor.
Como alternativa, la invocación puede especificar cero o más argumentos para la
matriz de parámetros, donde cada argumento es una expresión que se puede
convertir implícitamente (conversiones implícitas) en el tipo de elemento de la
matriz de parámetros. En este caso, la invocación crea una instancia del tipo de
 matriz de parámetros con una longitud correspondiente al número de
argumentos, inicializa los elementos de la instancia de la matriz con los valores de
argumento especificados y utiliza la instancia de matriz recién creada como
argumento real.

A excepción de permitir un número variable de argumentos en una invocación, una

matriz de parámetros es exactamente equivalente a un parámetro de valor (parámetros
de valor) del mismo tipo.

En el ejemplo

C#

using System;

class Test

static void F(params int[] args) {

Console.Write("Array contains {0} elements:", args.Length);

foreach (int i in args)

Console.Write(" {0}", i);

Console.WriteLine();

static void Main() {

int[] arr = {1, 2, 3};

F(arr);

F(10, 20, 30, 40);

F();

genera el resultado

Consola

Array contains 3 elements: 1 2 3

Array contains 4 elements: 10 20 30 40

Array contains 0 elements:

La primera invocación de F simplemente pasa la matriz a como un parámetro de valor.

La segunda invocación de F crea automáticamente un elemento de cuatro elementos
int[] con los valores de elemento especificados y pasa esa instancia de la matriz como

un parámetro de valor. Del mismo modo, la tercera invocación de F crea un elemento

de cero int[] y pasa esa instancia como un parámetro de valor. Las invocaciones
segunda y tercera son exactamente equivalentes a la escritura:
 C#

F(new int[] {10, 20, 30, 40});

F(new int[] {});

Al realizar la resolución de sobrecarga, un método con una matriz de parámetros puede

ser aplicable en su forma normal o en su forma expandida (miembro de función
aplicable). La forma expandida de un método solo está disponible si la forma normal del
método no es aplicable y solo si un método aplicable con la misma signatura que la
forma expandida no se ha declarado en el mismo tipo.

En el ejemplo

C#

using System;

class Test

static void F(params object[] a) {

Console.WriteLine("F(object[])");

static void F() {

Console.WriteLine("F()");
}

static void F(object a0, object a1) {

Console.WriteLine("F(object,object)");

static void Main() {

F();

F(1);

F(1, 2);

F(1, 2, 3);

F(1, 2, 3, 4);

genera el resultado

Consola

F();

F(object[]);

F(object,object);

F(object[]);

F(object[]);

En el ejemplo, dos de las formas expandidas posibles del método con una matriz de
parámetros ya están incluidas en la clase como métodos normales. Por lo tanto, estos
formularios expandidos no se tienen en cuenta al realizar la resolución de sobrecarga, y
las invocaciones del método primero y tercer, por tanto, seleccionan los métodos
normales. Cuando una clase declara un método con una matriz de parámetros, no es
raro incluir también algunos de los formularios expandidos como métodos normales. Al
hacerlo, es posible evitar la asignación de una instancia de matriz que se produce
cuando se invoca una forma expandida de un método con una matriz de parámetros.

Cuando el tipo de una matriz de parámetros es object[] , se produce una ambigüedad

potencial entre la forma normal del método y la forma empleada para un solo object
parámetro. La razón de la ambigüedad es que, object[] a su vez, se pueda convertir
implícitamente al tipo object . Sin embargo, la ambigüedad no presenta ningún
problema, ya que se puede resolver mediante la inserción de una conversión si es
necesario.

En el ejemplo

C#

using System;

class Test

static void F(params object[] args) {

foreach (object o in args) {

Console.Write(o.GetType().FullName);

Console.Write(" ");

Console.WriteLine();

static void Main() {

object[] a = {1, "Hello", 123.456};

object o = a;

F(a);

F((object)a);

F(o);

F((object[])o);
}

genera el resultado

Consola

System.Int32 System.String System.Double

System.Object[]

 System.Object[]

System.Int32 System.String System.Double

En la primera y última invocación de F , la forma normal de F es aplicable porque existe

una conversión implícita desde el tipo de argumento al tipo de parámetro (ambos son
del tipo object[] ). Por lo tanto, la resolución de sobrecarga selecciona la forma normal
de F y el argumento se pasa como un parámetro de valor normal. En la segunda y
tercera invocación, la forma normal de F no es aplicable porque no existe ninguna
conversión implícita desde el tipo de argumento al tipo de parámetro (el tipo object no
se puede convertir implícitamente al tipo object[] ). Sin embargo, la forma expandida
de F es aplicable, por lo que está seleccionada por la resolución de sobrecarga. Como
resultado, object[] la invocación crea un elemento, y el único elemento de la matriz se
inicializa con el valor de argumento dado (que a su vez es una referencia a un object[]
).

Métodos estáticos y de instancia

Cuando una declaración de método incluye un static modificador, se dice que se trata
de un método estático. Cuando no static existe ningún modificador, se dice que el
método es un método de instancia.

Un método estático no funciona en una instancia específica y es un error en tiempo de

compilación para hacer referencia a this en un método estático.

Un método de instancia funciona en una instancia determinada de una clase y se puede

tener acceso a esa instancia como this (este acceso).

Cuando se hace referencia a un método en un member_access (acceso a miembros) del

formulario E.M , si M es un método estático, E debe indicar un tipo que contiene M y si
M es un método de instancia, E debe denotar una instancia de un tipo que contenga M
.

Las diferencias entre los miembros estáticos y de instancia se tratan más adelante en
miembros estáticos y de instancia.

Métodos virtuales
Cuando una declaración de método de instancia incluye un virtual modificador, se
dice que se trata de un método virtual. Cuando no virtual existe ningún modificador,
se dice que el método es un método no virtual.
La implementación de un método no virtual es invariable: la implementación es la
misma si se invoca el método en una instancia de la clase en la que se declara o una
instancia de una clase derivada. Por el contrario, las clases derivadas pueden reemplazar
la implementación de un método virtual. El proceso de reemplazar la implementación
de un método virtual heredado se conoce como invalidar ese método (métodos de
invalidación).

En una invocación de método virtual, el *tipo en tiempo de ejecución _ de la instancia

para la que se realiza la invocación determina la implementación de método real que se
va a invocar. En una invocación de método no virtual, el tipo de tiempo de compilación*
de la instancia es el factor determinante. En términos precisos, cuando se invoca un
método denominado N con una lista de argumentos A en una instancia de con un tipo
en tiempo de compilación C y un tipo en tiempo de ejecución R (donde R es C o una
clase derivada de C ), la invocación se procesa de la siguiente manera:

En primer lugar, la resolución de sobrecarga se aplica a C , N y A , para seleccionar

un método específico M del conjunto de métodos declarados en y heredados por
C . Esto se describe en las invocaciones de método.

Después, si M es un método no virtual, M se invoca.

De lo contrario, M es un método virtual y se invoca la implementación más
derivada de M con respecto a R .

Para cada método virtual declarado en o heredado por una clase, existe una
implementación más derivada del método con respecto a esa clase. La implementación
más derivada de un método virtual M con respecto a una clase R se determina de la
manera siguiente:

Si R contiene la virtual declaración de introducción de M , ésta es la

implementación más derivada de M .
De lo contrario, si R contiene una override de M , esta es la implementación más
derivada de M .
De lo contrario, la implementación más derivada de M con respecto a R es la
misma que la implementación más derivada de M con respecto a la clase base
directa de R .

En el ejemplo siguiente se muestran las diferencias entre los métodos virtuales y los no
virtuales:

C#

using System;

 class A

public void F() { Console.WriteLine("A.F"); }

public virtual void G() { Console.WriteLine("A.G"); }

class B: A

new public void F() { Console.WriteLine("B.F"); }

public override void G() { Console.WriteLine("B.G"); }

class Test

static void Main() {

B b = new B();

A a = b;

a.F();

b.F();

a.G();

b.G();

En el ejemplo, A introduce un método no virtual F y un método virtual G . La clase B

introduce un nuevo método no virtual F , lo que oculta el heredado F , y también
invalida el método heredado G . En el ejemplo se genera el resultado:

Consola

A.F

B.F

B.G

B.G

Observe que la instrucción a.G() invoca B.G , no A.G . Esto se debe a que el tipo en
tiempo de ejecución de la instancia (que es B ), y no el tipo en tiempo de compilación
de la instancia (que es A ), determina la implementación de método real que se va a
invocar.

Dado que los métodos pueden ocultar métodos heredados, es posible que una clase
contenga varios métodos virtuales con la misma firma. Esto no presenta un problema de
ambigüedad, ya que todo menos el método más derivado está oculto. En el ejemplo

C#
 using System;

class A

public virtual void F() { Console.WriteLine("A.F"); }

class B: A

public override void F() { Console.WriteLine("B.F"); }

class C: B

new public virtual void F() { Console.WriteLine("C.F"); }

class D: C

public override void F() { Console.WriteLine("D.F"); }

class Test

static void Main() {

D d = new D();

A a = d;

B b = d;

C c = d;

a.F();

b.F();

c.F();

d.F();

las C D clases y contienen dos métodos virtuales con la misma firma: los introducidos
por A y los introducidos por C . El método introducido por C oculta el método
heredado de A . Por lo tanto, la declaración de invalidación en D invalida el método
introducido por C , y no es posible D que invalide el método introducido por A . En el
ejemplo se genera el resultado:

Consola

B.F

B.F

D.F

D.F

Tenga en cuenta que es posible invocar el método virtual oculto mediante el acceso a
una instancia de D a través de un tipo menos derivado en el que el método no está
oculto.

Métodos de invalidación
Cuando una declaración de método de instancia incluye un override modificador, se
dice que el método es un método de invalidación. Un método de invalidación invalida
un método virtual heredado con la misma firma. Mientras que una declaración de
método virtual introduce un método nuevo, una declaración de método de reemplazo
especializa un método virtual heredado existente proporcionando una nueva
implementación de ese método.

El método invalidado por una override declaración se conoce como el método base
invalidado. Para un método de invalidación M declarado en una clase C , el método
base invalidado se determina examinando cada tipo de clase base de C , empezando
por el tipo de clase base directa de C y continuando con cada tipo de clase base directo
sucesivo, hasta que en un tipo de clase base determinado se encuentra un método
accesible que tiene la misma firma que M después de la sustitución de los argumentos
de tipo. Con el fin de localizar el método base invalidado, se considera que un método
es accesible si es, si es, si es, public protected protected internal o si es y se internal
declara en el mismo programa que C .

Se produce un error en tiempo de compilación a menos que se cumplan todas las

condiciones siguientes para una declaración de invalidación:

Un método base invalidado se puede encontrar como se describió anteriormente.

Hay exactamente un método base invalidado de este tipo. Esta restricción solo
tiene efecto si el tipo de clase base es un tipo construido en el que la sustitución
de los argumentos de tipo hace que la firma de dos métodos sea la misma.
El método base invalidado es un método virtual, abstracto o de invalidación. En
otras palabras, el método base invalidado no puede ser estático o no virtual.
El método base invalidado no es un método sellado.
El método de invalidación y el método base invalidado tienen el mismo tipo de
valor devuelto.
La declaración de invalidación y el método base invalidado tienen la misma
accesibilidad declarada. En otras palabras, una declaración de invalidación no
puede cambiar la accesibilidad del método virtual. Sin embargo, si el método base
invalidado es interno protegido y se declara en un ensamblado diferente al del
ensamblado que contiene el método de invalidación, se debe proteger la
accesibilidad declarada del método de invalidación.
 La declaración de invalidación no especifica las cláusulas-de-parámetros de tipo.
En su lugar, las restricciones se heredan del método base invalidado. Tenga en
cuenta que las restricciones que son parámetros de tipo en el método invalidado
se pueden reemplazar por argumentos de tipo en la restricción heredada. Esto
puede dar lugar a restricciones que no son válidas cuando se especifican
explícitamente, como tipos de valor o tipos sellados.

En el ejemplo siguiente se muestra cómo funcionan las reglas de reemplazo para las
clases genéricas:

C#

abstract class C<T>

public virtual T F() {...}

public virtual C<T> G() {...}

public virtual void H(C<T> x) {...}

class D: C<string>

public override string F() {...} // Ok

public override C<string> G() {...} // Ok

public override void H(C<T> x) {...} // Error, should be

C<string>

class E<T,U>: C<U>

public override U F() {...} // Ok

public override C<U> G() {...} // Ok

public override void H(C<T> x) {...} // Error, should be C<U>

Una declaración de invalidación puede tener acceso al método base invalidado

mediante un base_access (acceso base). En el ejemplo

C#

class A

int x;

public virtual void PrintFields() {

Console.WriteLine("x = {0}", x);

class B: A

 int y;

public override void PrintFields() {

base.PrintFields();

Console.WriteLine("y = {0}", y);

la base.PrintFields() invocación de B invoca el PrintFields método declarado en A .

Un base_access deshabilita el mecanismo de invocación virtual y simplemente trata el
método base como un método no virtual. B Una vez escrita la invocación
((A)this).PrintFields() , invocaría de forma recursiva el PrintFields método
declarado en B , no el declarado en A , puesto que PrintFields es virtual y el tipo en
tiempo de ejecución de ((A)this) es B .

Solo si se incluye un override modificador, un método puede reemplazar a otro

método. En todos los demás casos, un método con la misma signatura que un método
heredado simplemente oculta el método heredado. En el ejemplo

C#

class A

public virtual void F() {}

class B: A

public virtual void F() {} // Warning, hiding inherited F()

el F método de no B incluye un override modificador y, por tanto, no invalida el F

método en A . En su lugar, el F método en B oculta el método en A y se genera una
advertencia porque la declaración no incluye un new modificador.

En el ejemplo

C#

class A

public virtual void F() {}

class B: A

new private void F() {} // Hides A.F within body of B

class C: B

public override void F() {} // Ok, overrides A.F

el F método en B oculta el método virtual F heredado de A . Dado que el nuevo F en

B tiene acceso privado, su ámbito solo incluye el cuerpo de clase de B y no se extiende
a C . Por consiguiente, la declaración de F en puede C invalidar el F heredado de A .

Métodos sellados
Cuando una declaración de método de instancia incluye un sealed modificador, se dice
que se trata de un método sellado. Si una declaración de método de instancia incluye el
sealed modificador, también debe incluir el override modificador. El uso del sealed
modificador impide que una clase derivada Reemplace el método.

En el ejemplo

C#

using System;

class A

public virtual void F() {

Console.WriteLine("A.F");
}

public virtual void G() {

Console.WriteLine("A.G");
}

class B: A

sealed override public void F() {

Console.WriteLine("B.F");
}

override public void G() {

Console.WriteLine("B.G");
}

class C: B

override public void G() {

 Console.WriteLine("C.G");
}

la clase B proporciona dos métodos de invalidación: un F método que tiene el sealed

modificador y un G método que no lo hace. B el uso del sellado modifier evita que se
C invalide más F .

Métodos abstractos
Cuando una declaración de método de instancia incluye un abstract modificador, se
dice que el método es un método abstracto. Aunque un método abstracto también es
implícitamente un método virtual, no puede tener el modificador virtual .

Una declaración de método abstracto presenta un nuevo método virtual, pero no

proporciona una implementación de ese método. En su lugar, las clases derivadas no
abstractas deben proporcionar su propia implementación mediante la invalidación de
ese método. Dado que un método abstracto no proporciona ninguna implementación
real, el method_body de un método abstracto simplemente consiste en un punto y
coma.

Las declaraciones de método abstracto solo se permiten en clases abstractas (clases

abstractas).

En el ejemplo

C#

public abstract class Shape

public abstract void Paint(Graphics g, Rectangle r);

public class Ellipse: Shape

public override void Paint(Graphics g, Rectangle r) {

g.DrawEllipse(r);

public class Box: Shape

public override void Paint(Graphics g, Rectangle r) {

g.DrawRect(r);

la Shape clase define la noción abstracta de un objeto de forma geométrica que puede
dibujarse a sí mismo. El Paint método es abstracto porque no hay ninguna
implementación predeterminada significativa. Las Ellipse Box clases y son Shape
implementaciones concretas. Dado que estas clases no son abstractas, son necesarias
para invalidar el Paint método y proporcionar una implementación real.

Se trata de un error en tiempo de compilación para que un base_access (acceso base)

haga referencia a un método abstracto. En el ejemplo

C#

abstract class A

public abstract void F();

class B: A

public override void F() {

base.F(); // Error, base.F is abstract

se ha detectado un error en tiempo de compilación para la base.F() invocación porque

hace referencia a un método abstracto.

Se permite que una declaración de método abstracto invalide un método virtual. Esto
permite a una clase abstracta forzar la reimplementación del método en las clases
derivadas y hace que la implementación original del método no esté disponible. En el
ejemplo

C#

using System;

class A

public virtual void F() {

Console.WriteLine("A.F");
}

abstract class B: A

public abstract override void F();

class C: B

 public override void F() {

Console.WriteLine("C.F");
}

A la clase declara un método virtual, B la clase invalida este método con un método

abstracto y la clase C invalida el método abstracto para proporcionar su propia

implementación.

Métodos externos
Cuando una declaración de método incluye un extern modificador, se dice que el
método es un *método externo _. Los métodos externos se implementan externamente,
normalmente con un lenguaje distinto de C#. Dado que una declaración de método
externo no proporciona ninguna implementación real, el _method_body * de un método
externo consiste simplemente en un punto y coma. Es posible que un método externo
no sea genérico.

El extern modificador se usa normalmente junto con un DllImport atributo

(interoperación con componentes com y Win32), lo que permite que los métodos
externos se implementen mediante archivos DLL (bibliotecas de vínculos dinámicos). El
entorno de ejecución puede admitir otros mecanismos en los que se puedan
proporcionar implementaciones de métodos externos.

Cuando un método externo incluye un DllImport atributo, la declaración del método

también debe incluir un static modificador. En este ejemplo se muestra el uso del
extern modificador y el DllImport atributo:

C#

using System.Text;

using System.Security.Permissions;

using System.Runtime.InteropServices;

class Path

[DllImport("kernel32", SetLastError=true)]

static extern bool CreateDirectory(string name, SecurityAttribute sa);

[DllImport("kernel32", SetLastError=true)]

static extern bool RemoveDirectory(string name);

[DllImport("kernel32", SetLastError=true)]

static extern int GetCurrentDirectory(int bufSize, StringBuilder buf);

[DllImport("kernel32", SetLastError=true)]

 static extern bool SetCurrentDirectory(string name);

Métodos parciales (Resumen)

Cuando una declaración de método incluye un partial modificador, se dice que el
método es un método parcial. Los métodos parciales solo se pueden declarar como
miembros de tipos parciales (tipos parciales) y están sujetos a una serie de restricciones.
Los métodos parciales se describen con más detalle en métodos parciales.

Métodos de extensión
Cuando el primer parámetro de un método incluye el this modificador, se dice que se
trata de un método de extensión. Los métodos de extensión solo se pueden declarar en
clases estáticas no anidadas no genéricas. El primer parámetro de un método de
extensión no puede tener modificadores distintos de this y el tipo de parámetro no
puede ser un tipo de puntero.

El siguiente es un ejemplo de una clase estática que declara dos métodos de extensión:

C#

public static class Extensions

public static int ToInt32(this string s) {

return Int32.Parse(s);

public static T[] Slice<T>(this T[] source, int index, int count) {

if (index < 0 || count < 0 || source.Length - index < count)

throw new ArgumentException();

T[] result = new T[count];

Array.Copy(source, index, result, 0, count);

return result;

Un método de extensión es un método estático normal. Además, cuando la clase

estática envolvente está en el ámbito, se puede invocar un método de extensión
mediante la sintaxis de invocación de método de instancia (invocaciones de método de
extensión), mediante la expresión de receptor como primer argumento.

El programa siguiente utiliza los métodos de extensión declarados anteriormente:

C#
 static class Program

static void Main() {

string[] strings = { "1", "22", "333", "4444" };

foreach (string s in strings.Slice(1, 2)) {

Console.WriteLine(s.ToInt32());

El Slice método está disponible en string[] , y el ToInt32 método está disponible en

string , porque se han declarado como métodos de extensión. El significado del
programa es el mismo que el que se indica a continuación, mediante llamadas
ordinarias al método estático:

C#

static class Program

static void Main() {

string[] strings = { "1", "22", "333", "4444" };

foreach (string s in Extensions.Slice(strings, 1, 2)) {

Console.WriteLine(Extensions.ToInt32(s));

Cuerpo del método

El method_body de una declaración de método consta de un cuerpo de bloque, un
cuerpo de expresión o un punto y coma.

El tipo de resultado de un método es void si el tipo de valor devuelto es void , o si el

método es Async y el tipo de valor devuelto es System.Threading.Tasks.Task . De lo
contrario, el tipo de resultado de un método no asincrónico es el tipo de valor devuelto
y el tipo de resultado de un método asincrónico con el tipo de valor devuelto
System.Threading.Tasks.Task<T> es T .

Cuando un método tiene un void tipo de resultado y un cuerpo de bloque, las return
instrucciones (la instrucción return) del bloque no pueden especificar una expresión. Si
la ejecución del bloque de un método void se completa normalmente (es decir, el
control fluye fuera del final del cuerpo del método), ese método simplemente vuelve a
su llamador actual.
Cuando un método tiene un void resultado y un cuerpo de expresión, la expresión E
debe ser una statement_expression y el cuerpo es exactamente equivalente a un cuerpo
de bloque del formulario { E; } .

Cuando un método tiene un tipo de resultado no void y un cuerpo de bloque, cada

return instrucción del bloque debe especificar una expresión que se pueda convertir

implícitamente al tipo de resultado. No se puede tener acceso al extremo de un cuerpo

de bloque de un método que devuelve un valor. Es decir, en un método que devuelve
valores con un cuerpo de bloque, el control no puede fluir fuera del final del cuerpo del
método.

Cuando un método tiene un tipo de resultado no void y un cuerpo de expresión, la

expresión se debe poder convertir implícitamente al tipo de resultado y el cuerpo es
exactamente equivalente a un cuerpo de bloque del formulario { return E; } .

En el ejemplo

C#

class A

public int F() {} // Error, return value required

public int G() {

return 1;

public int H(bool b) {

if (b) {

return 1;

else {

return 0;

public int I(bool b) => b ? 1 : 0;

el método que devuelve el valor F produce un error en tiempo de compilación porque

el control puede fluir fuera del final del cuerpo del método. Los G H métodos y son
correctos porque todas las rutas de acceso de ejecución posibles terminan en una
instrucción return que especifica un valor devuelto. El I método es correcto porque su
cuerpo es equivalente a un bloque de instrucciones con solo una única instrucción
return en él.
Sobrecarga de métodos
Las reglas de resolución de sobrecarga de método se describen en inferencia de tipos.

Propiedades
Una *propiedad _ es un miembro que proporciona acceso a una característica de un
objeto o una clase. Entre los ejemplos de propiedades se incluyen la longitud de una
cadena, el tamaño de una fuente, el título de una ventana, el nombre de un cliente, etc.
Las propiedades son una extensión natural de los campos: ambos son miembros con
nombre con tipos asociados y la sintaxis para tener acceso a campos y propiedades es la
misma. Sin embargo, a diferencia de los campos, las propiedades no denotan
ubicaciones de almacenamiento. En su lugar, las propiedades tienen _ descriptores de
acceso* que especifican las instrucciones que se ejecutarán cuando se lean o escriban
sus valores. Por tanto, las propiedades proporcionan un mecanismo para asociar
acciones con la lectura y escritura de los atributos de un objeto; Además, permiten
calcular tales atributos.

Las propiedades se declaran mediante property_declaration s:

antlr

property_declaration

: attributes? property_modifier* type member_name property_body

property_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| 'static'

| 'virtual'

| 'sealed'

| 'override'

| 'abstract'

| 'extern'

| property_modifier_unsafe

property_body

: '{' accessor_declarations '}' property_initializer?

| '=>' expression ';'

property_initializer

 : '=' variable_initializer ';'

Un property_declaration puede incluir un conjunto de atributos (atributos) y una

combinación válida de los cuatro modificadores de acceso (modificadores de acceso), el
new (el nuevo modificador), static (métodos estáticos y de instancia), virtual

(métodos virtuales), override (métodos de invalidación), (métodos sellados), (métodos

sealed abstract abstractos) y extern Modificadores (métodos externos).

Las declaraciones de propiedad están sujetas a las mismas reglas que las declaraciones
de método (métodos) con respecto a las combinaciones válidas de modificadores.

El tipo de una declaración de propiedad especifica el tipo de la propiedad introducida

por la declaración y el member_name especifica el nombre de la propiedad. A menos
que la propiedad sea una implementación explícita de un miembro de interfaz, el
member_name es simplemente un identificador. En el caso de una implementación
explícita de un miembro de interfaz (implementaciones de miembros de interfaz
explícitos), el member_name consta de un interface_type seguido de un " . " y un
identificador.

El tipo de una propiedad debe ser al menos igual de accesible que la propiedad en sí
(restricciones de accesibilidad).

Un property_body puede consistir en un "*cuerpo del descriptor de acceso***" o un

_cuerpo de expresión*.. En el cuerpo de un descriptor de acceso, _accessor_declarations
*, que debe incluirse en los { tokens "" y "" } , declare los descriptores de acceso
(descriptores de acceso) de la propiedad. Los descriptores de acceso especifican las
instrucciones ejecutables asociadas a la lectura y la escritura de la propiedad.

Un cuerpo de expresión que consta de => seguido de una expresión E y un punto y

coma es exactamente equivalente al cuerpo de la instrucción { get { return E; } } y,
por lo tanto, solo se puede usar para especificar propiedades de solo captador donde el
resultado del captador se proporciona mediante una sola expresión.

Solo se puede proporcionar un property_initializer para una propiedad implementada

automáticamente (propiedades implementadas automáticamente) y provoca la
inicialización del campo subyacente de dichas propiedades con el valor especificado por
la expresión.

Aunque la sintaxis para tener acceso a una propiedad es la misma que la de un campo,
una propiedad no se clasifica como una variable. Por lo tanto, no es posible pasar una
propiedad como ref argumento o out .
Cuando una declaración de propiedad incluye un extern modificador, se dice que la
propiedad es una *propiedad externa _. Dado que una declaración de propiedad
externa no proporciona ninguna implementación real, cada una de sus
_accessor_declarations * consta de un punto y coma.

Propiedades estáticas y de instancia

Cuando una declaración de propiedad incluye un static modificador, se dice que la
propiedad es una *propiedad estática _. Cuando no static existe ningún modificador,
se dice que la propiedad es una propiedad de instancia _ * * *.

Una propiedad estática no está asociada a una instancia específica y es un error en

tiempo de compilación para hacer referencia a this en los descriptores de acceso de
una propiedad estática.

Una propiedad de instancia está asociada a una instancia determinada de una clase y se
puede tener acceso a esa instancia como this (este acceso) en los descriptores de
acceso de esa propiedad.

Cuando se hace referencia a una propiedad en un member_access (acceso a miembros)

del formulario E.M , si M es una propiedad estática, E debe indicar un tipo que contiene
M y si M es una propiedad de instancia, E debe indicar una instancia de un tipo que
contiene M .

Las diferencias entre los miembros estáticos y de instancia se tratan más adelante en
miembros estáticos y de instancia.

Descriptores de acceso
El accessor_declarations de una propiedad especifica las instrucciones ejecutables
asociadas a la lectura y escritura de esa propiedad.

antlr

accessor_declarations

: get_accessor_declaration set_accessor_declaration?

| set_accessor_declaration get_accessor_declaration?

get_accessor_declaration

: attributes? accessor_modifier? 'get' accessor_body

set_accessor_declaration

: attributes? accessor_modifier? 'set' accessor_body

accessor_modifier

: 'protected'

| 'internal'

| 'private'

| 'protected' 'internal'

| 'internal' 'protected'

accessor_body

: block

| ';'

Las declaraciones de descriptor de acceso constan de un get_accessor_declaration, un

set_accessor_declaration o ambos. Cada declaración de descriptor de acceso está
compuesta del token get o set va seguida de un accessor_modifier opcional y un
accessor_body.

El uso de accessor_modifier s se rige por las siguientes restricciones:

Un accessor_modifier no se puede usar en una interfaz o en una implementación

explícita de un miembro de interfaz.
En el caso de una propiedad o un indizador que no tiene ningún override
modificador, solo se permite una accessor_modifier si la propiedad o indizador
tiene tanto un get set descriptor de acceso como un y, a continuación, solo se
permite en uno de estos descriptores de acceso.
En el caso de una propiedad o un indizador que incluya un override modificador,
un descriptor de acceso debe coincidir con el accessor_modifier, si existe, del
descriptor de acceso que se va a invalidar.
El accessor_modifier debe declarar una accesibilidad que sea estrictamente más
restrictiva que la accesibilidad declarada de la propiedad o el propio indexador.
Para ser precisos:
Si la propiedad o indizador tiene una accesibilidad declarada de public , el
accessor_modifier puede ser protected internal , internal , protected o
private .

Si la propiedad o indizador tiene una accesibilidad declarada de protected

internal , el accessor_modifier puede ser internal , protected o private .

Si la propiedad o indizador tiene una accesibilidad declarada de internal o

protected , el accessor_modifier debe ser private .

Si la propiedad o indizador tiene una accesibilidad declarada de private , no se

puede usar ningún accessor_modifier .
Para abstract extern las propiedades y, el accessor_body para cada descriptor de
acceso especificado es simplemente un punto y coma. Una propiedad no abstracta y no
externa puede tener cada accessor_body ser un punto y coma, en cuyo caso es una
propiedad * implementada automáticamente _ (propiedades implementadas
automáticamente). Una propiedad implementada automáticamente debe tener al
menos un descriptor de acceso get. En el caso de los descriptores de acceso de
cualquier otra propiedad no abstracta y no externa, el _accessor_body * es un bloque
que especifica las instrucciones que se ejecutarán cuando se invoque el descriptor de
acceso correspondiente.

Un get descriptor de acceso corresponde a un método sin parámetros con un valor

devuelto del tipo de propiedad. Excepto como destino de una asignación, cuando se
hace referencia a una propiedad en una expresión, el get descriptor de acceso de la
propiedad se invoca para calcular el valor de la propiedad (valores de las expresiones).
El cuerpo de un get descriptor de acceso debe cumplir las reglas de los métodos que
devuelven valores descritos en el cuerpo del método. En concreto, todas las return
instrucciones del cuerpo de un get descriptor de acceso deben especificar una
expresión que se pueda convertir implícitamente al tipo de propiedad. Además, el punto
de conexión de un get descriptor de acceso no debe ser accesible.

Un set descriptor de acceso corresponde a un método con un parámetro de valor

único del tipo de propiedad y un void tipo de valor devuelto. El parámetro implícito de
un set descriptor de acceso siempre se denomina value . Cuando se hace referencia a
una propiedad como el destino de una asignación (operadores de asignación) o como
operando de ++ o -- (operadores deincremento y decremento postfijo, operadores de
incremento y decremento de prefijo), el set descriptor de acceso se invoca con un
argumento (cuyo valor es el del lado derecho de la asignación o el operando del ++ --
operador o)que proporciona el nuevo valor El cuerpo de un set descriptor de acceso
debe cumplir las reglas de void los métodos descritos en cuerpo del método. En
concreto, return las instrucciones del set cuerpo del descriptor de acceso no pueden
especificar una expresión. Dado que un set descriptor de acceso tiene implícitamente
un parámetro denominado value , se trata de un error en tiempo de compilación para
una variable local o una declaración de constante en un set descriptor de acceso que
tiene ese nombre.

En función de la presencia o ausencia de get los set descriptores de acceso y, una

propiedad se clasifica de la manera siguiente:

Se dice que una propiedad que incluye tanto un descriptor de get acceso como
un set descriptor de acceso es una propiedad de lectura y escritura .
 Se dice que una propiedad que solo tiene un get descriptor de acceso es una
propiedad de solo lectura . Es un error en tiempo de compilación que una
propiedad de solo lectura sea el destino de una asignación.
Se dice que una propiedad que solo tiene un set descriptor de acceso es una
propiedad de solo escritura . Excepto como destino de una asignación, se trata de
un error en tiempo de compilación para hacer referencia a una propiedad de solo
escritura en una expresión.

En el ejemplo

C#

public class Button: Control

private string caption;

public string Caption {

get {

return caption;

set {

if (caption != value) {

caption = value;

Repaint();

public override void Paint(Graphics g, Rectangle r) {

// Painting code goes here

el Button control declara una propiedad pública Caption . El get descriptor de acceso
de la Caption propiedad devuelve la cadena almacenada en el caption campo privado.
El set descriptor de acceso comprueba si el nuevo valor es diferente del valor actual y,
en ese caso, almacena el nuevo valor y vuelve a dibujar el control. Las propiedades
suelen seguir el patrón mostrado anteriormente: el get descriptor de acceso devuelve
simplemente un valor almacenado en un campo privado y el set descriptor de acceso
modifica ese campo privado y, a continuación, realiza las acciones adicionales necesarias
para actualizar completamente el estado del objeto.

Dada la Button clase anterior, el siguiente es un ejemplo de uso de la Caption

propiedad:

C#
 Button okButton = new Button();

okButton.Caption = "OK"; // Invokes set accessor

string s = okButton.Caption; // Invokes get accessor

Aquí, el set descriptor de acceso se invoca mediante la asignación de un valor a la

propiedad, y el get descriptor de acceso se invoca mediante la referencia a la propiedad
en una expresión.

Los get set descriptores de acceso y de una propiedad no son miembros distintos y no
es posible declarar los descriptores de acceso de una propiedad por separado. Como
tal, no es posible que los dos descriptores de acceso de una propiedad de lectura y
escritura tengan una accesibilidad diferente. En el ejemplo

C#

class A

private string name;

public string Name { // Error, duplicate member name

get { return name; }

public string Name { // Error, duplicate member name

set { name = value; }

no declara una única propiedad de lectura y escritura. En su lugar, declara dos

propiedades con el mismo nombre, una de solo lectura y otra de solo escritura. Dado
que dos miembros declarados en la misma clase no pueden tener el mismo nombre, en
el ejemplo se produce un error en tiempo de compilación.

Cuando una clase derivada declara una propiedad con el mismo nombre que una
propiedad heredada, la propiedad derivada oculta la propiedad heredada con respecto
a la lectura y la escritura. En el ejemplo

C#

class A

public int P {

set {...}

class B: A

 new public int P {

get {...}

la P propiedad de B oculta la P propiedad en A con respecto a la lectura y la escritura.

Por lo tanto, en las instrucciones

C#

B b = new B();

b.P = 1; // Error, B.P is read-only

((A)b).P = 1; // Ok, reference to A.P

la asignación a b.P produce un error en tiempo de compilación, ya que la propiedad de

solo lectura P de B oculta la propiedad de solo escritura P en A . Sin embargo, tenga
en cuenta que se puede usar una conversión para tener acceso a la P propiedad
Hidden.

A diferencia de los campos públicos, las propiedades proporcionan una separación

entre el estado interno de un objeto y su interfaz pública. Observe el ejemplo:

C#

class Label

private int x, y;

private string caption;

public Label(int x, int y, string caption) {

this.x = x;

this.y = y;

this.caption = caption;

public int X {

get { return x; }

public int Y {

get { return y; }

public Point Location {

get { return new Point(x, y); }

public string Caption {

get { return caption; }

En este caso, la Label clase usa dos int campos, x y y , para almacenar su ubicación.
La ubicación se expone públicamente como X y una Y propiedad y como Location
propiedad de tipo Point . Si, en una versión futura de Label , resulta más cómodo
almacenar la ubicación Point internamente, el cambio se puede realizar sin que afecte a
la interfaz pública de la clase:

C#

class Label

private Point location;

private string caption;

public Label(int x, int y, string caption) {

this.location = new Point(x, y);

this.caption = caption;

public int X {

get { return location.x; }

public int Y {

get { return location.y; }

public Point Location {

get { return location; }

public string Caption {

get { return caption; }

x y Los campos tenían y en su lugar public readonly , habría sido imposible realizar
este cambio en la Label clase.

Exponer el estado a través de las propiedades no es necesariamente menos eficaz que

exponer los campos directamente. En concreto, cuando una propiedad no es virtual y
contiene solo una pequeña cantidad de código, el entorno de ejecución puede
reemplazar las llamadas a los descriptores de acceso con el código real de los
descriptores de acceso. Este proceso se conoce como inserción y hace que el acceso a la
propiedad sea tan eficaz como el acceso al campo, pero conserva la mayor flexibilidad
de las propiedades.
Dado que la invocación get de un descriptor de acceso es conceptualmente
equivalente a leer el valor de un campo, se considera un estilo de programación
incorrecto para que los get descriptores de acceso tengan efectos secundarios
observables. En el ejemplo

C#

class Counter

private int next;

public int Next {

get { return next++; }

el valor de la Next propiedad depende del número de veces que se ha accedido

previamente a la propiedad. Por lo tanto, el acceso a la propiedad produce un efecto
secundario observable y la propiedad debe implementarse como un método en su
lugar.

La Convención "sin efectos secundarios" para los get descriptores de acceso no

significa que los get descriptores de acceso siempre se deben escribir para devolver los
valores almacenados en los campos. En realidad, get los descriptores de acceso suelen
calcular el valor de una propiedad mediante el acceso a varios campos o la invocación
de métodos. Sin embargo, un get descriptor de acceso diseñado correctamente no
realiza ninguna acción que produzca cambios observables en el estado del objeto.

Las propiedades se pueden usar para retrasar la inicialización de un recurso hasta el

momento en el que se hace referencia a él por primera vez. Por ejemplo:

C#

using System.IO;

public class Console

private static TextReader reader;

private static TextWriter writer;

private static TextWriter error;

public static TextReader In {

get {

if (reader == null) {

reader = new StreamReader(Console.OpenStandardInput());

return reader;

public static TextWriter Out {

get {

if (writer == null) {

writer = new StreamWriter(Console.OpenStandardOutput());

return writer;

public static TextWriter Error {

get {

if (error == null) {

error = new StreamWriter(Console.OpenStandardError());

return error;

La Console clase contiene tres propiedades, In , Out y Error , que representan los
dispositivos de entrada, salida y error estándar, respectivamente. Al exponer estos
miembros como propiedades, la Console clase puede retrasar su inicialización hasta que
se usen realmente. Por ejemplo, al hacer referencia por primera vez a la Out propiedad,
como en

C#

Console.Out.WriteLine("hello, world");

TextWriter se crea el subyacente para el dispositivo de salida. Pero si la aplicación no

hace referencia a las In Error propiedades y, no se crea ningún objeto para esos
dispositivos.

Propiedades implementadas automáticamente

Una propiedad implementada automáticamente (o propiedad automática para abreviar)
es una propiedad no abstracta no abstracta con cuerpos de descriptor de acceso solo
de punto y coma. Las propiedades automáticas deben tener un descriptor de acceso get
y, opcionalmente, tener un descriptor de acceso set.

Cuando se especifica una propiedad como una propiedad implementada

automáticamente, un campo de respaldo oculto está disponible automáticamente para
la propiedad y los descriptores de acceso se implementan para leer y escribir en ese
campo de respaldo. Si la propiedad automática no tiene ningún descriptor de acceso
set, se considera el campo de respaldo readonly (campos de solo lectura). Al igual
readonly que un campo, una propiedad automática de solo captador también se puede

asignar a en el cuerpo de un constructor de la clase envolvente. Este tipo de asignación

asigna directamente al campo de respaldo de solo lectura de la propiedad.

Una propiedad automática puede tener opcionalmente un property_initializer, que se

aplica directamente al campo de respaldo como un variable_initializer (inicializadores de
variables).

En el ejemplo siguiente:

C#

public class Point {

public int X { get; set; } = 0;

public int Y { get; set; } = 0;

es equivalente a la siguiente declaración:

C#

public class Point {

private int __x = 0;

private int __y = 0;

public int X { get { return __x; } set { __x = value; } }

public int Y { get { return __y; } set { __y = value; } }

En el ejemplo siguiente:

C#

public class ReadOnlyPoint

public int X { get; }

public int Y { get; }

public ReadOnlyPoint(int x, int y) { X = x; Y = y; }

es equivalente a la siguiente declaración:

C#

public class ReadOnlyPoint

 private readonly int __x;

private readonly int __y;

public int X { get { return __x; } }

public int Y { get { return __y; } }

public ReadOnlyPoint(int x, int y) { __x = x; __y = y; }

Observe que las asignaciones al campo de solo lectura son válidas, ya que se producen
dentro del constructor.

Accesibilidad
Si un descriptor de acceso tiene un accessor_modifier, el dominio de accesibilidad
(dominios de accesibilidad) del descriptor de acceso se determina mediante la
accesibilidad declarada de la accessor_modifier. Si un descriptor de acceso no tiene un
accessor_modifier, el dominio de accesibilidad del descriptor de acceso se determina a
partir de la accesibilidad declarada de la propiedad o del indizador.

La presencia de un accessor_modifier nunca afecta a la búsqueda de miembros

(operadores) o a la resolución de sobrecarga (resolución de sobrecarga). Los
modificadores de la propiedad o el indizador siempre determinan la propiedad o el
indizador que está enlazado, independientemente del contexto del acceso.

Una vez que se ha seleccionado una propiedad o un indizador determinados, se usan

los dominios de accesibilidad de los descriptores de acceso específicos implicados para
determinar si ese uso es válido:

Si el uso es como un valor (valores de expresiones), el get descriptor de acceso

debe existir y ser accesible.
Si el uso es como el destino de una asignación simple (asignación simple), el set
descriptor de acceso debe existir y ser accesible.
Si el uso es como destino de la asignación compuesta (asignación compuesta), o
como destino de los ++ operadores o -- (miembros de función0,9, expresiones de
invocación), los get descriptores de acceso y el set descriptor de acceso deben
existir y ser accesibles.

En el ejemplo siguiente, la propiedad A.Text oculta la propiedad B.Text , incluso en

contextos donde solo set se llama al descriptor de acceso. En cambio, la propiedad
B.Count no es accesible a la clase M , por lo que en A.Count su lugar se usa la

propiedad accesible.

C#
 class A

public string Text {

get { return "hello"; }

set { }

public int Count {

get { return 5; }

set { }

class B: A

private string text = "goodbye";

private int count = 0;

new public string Text {

get { return text; }

protected set { text = value; }

new protected int Count {

get { return count; }

set { count = value; }

class M

static void Main() {

B b = new B();

b.Count = 12; // Calls A.Count set accessor

int i = b.Count; // Calls A.Count get accessor

b.Text = "howdy"; // Error, B.Text set accessor not

accessible

string s = b.Text; // Calls B.Text get accessor

Un descriptor de acceso que se utiliza para implementar una interfaz no puede tener un
accessor_modifier. Si solo se usa un descriptor de acceso para implementar una interfaz,
el otro descriptor de acceso se puede declarar con un accessor_modifier:

C#

public interface I

string Prop { get; }

 public class C: I

public string Prop {

get { return "April"; } // Must not have a modifier here

internal set {...} // Ok, because I.Prop has no set

accessor

Descriptores de acceso de propiedad virtual, Sealed,

override y Abstract
Una virtual declaración de propiedad especifica que los descriptores de acceso de la
propiedad son virtuales. El virtual modificador se aplica a ambos descriptores de
acceso de una propiedad de lectura y escritura, no es posible que solo un descriptor de
acceso de una propiedad de lectura y escritura sea virtual.

Una abstract declaración de propiedad especifica que los descriptores de acceso de la

propiedad son virtuales, pero no proporciona una implementación real de los
descriptores de acceso. En su lugar, se requiere que las clases derivadas no abstractas
proporcionen su propia implementación para los descriptores de acceso mediante la
invalidación de la propiedad. Dado que un descriptor de acceso de una declaración de
propiedad abstracta no proporciona ninguna implementación real, su accessor_body
simplemente consta de un punto y coma.

Una declaración de propiedad que incluye los abstract override modificadores y

especifica que la propiedad es abstracta e invalida una propiedad base. Los descriptores
de acceso de dicha propiedad también son abstractos.

Las declaraciones de propiedad abstracta solo se permiten en clases abstractas (clases

abstractas). Los descriptores de acceso de una propiedad virtual heredada se pueden
invalidar en una clase derivada mediante la inclusión de una declaración de propiedad
que especifica una override Directiva. Esto se conoce como una declaración de
propiedad de reemplazo. Una declaración de propiedad de reemplazo no declara una
nueva propiedad. En su lugar, simplemente especializa las implementaciones de los
descriptores de acceso de una propiedad virtual existente.

Una declaración de propiedad de reemplazo debe especificar exactamente los mismos

modificadores de accesibilidad, tipo y nombre que la propiedad heredada. Si la
propiedad heredada solo tiene un descriptor de acceso (es decir, si la propiedad
heredada es de solo lectura o de solo escritura), la propiedad de reemplazo solo debe
incluir ese descriptor de acceso. Si la propiedad heredada incluye ambos descriptores de
acceso (es decir, si la propiedad heredada es de lectura y escritura), la propiedad de
reemplazo puede incluir un solo descriptor de acceso o ambos.

Una declaración de propiedad de reemplazo puede incluir el sealed modificador. El uso

de este modificador evita que una clase derivada Reemplace la propiedad. Los
descriptores de acceso de una propiedad sellada también están sellados.

A excepción de las diferencias en la sintaxis de declaración e invocación, los descriptores

de acceso virtual, sellado, invalidación y Abstract se comportan exactamente igual que
los métodos virtuales, sellados, de invalidación y abstractos. En concreto, las reglas
descritas en métodos virtuales, métodos de invalidación, métodos selladosy métodos
abstractos se aplican como si los descriptores de acceso fueran métodos de una forma
correspondiente:

Un get descriptor de acceso corresponde a un método sin parámetros con un

valor devuelto del tipo de propiedad y los mismos modificadores que la propiedad
que lo contiene.
Un set descriptor de acceso corresponde a un método con un parámetro de valor
único del tipo de propiedad, un void tipo de valor devuelto y los mismos
modificadores que la propiedad que lo contiene.

En el ejemplo

C#

abstract class A

int y;

public virtual int X {

get { return 0; }

public virtual int Y {

get { return y; }

set { y = value; }

public abstract int Z { get; set; }

X es una propiedad virtual de solo lectura, Y es una propiedad de lectura y escritura

virtual y Z es una propiedad de lectura y escritura abstracta. Dado Z que es abstracto,

la clase contenedora A también debe declararse como abstracta.

Una clase que deriva de A se muestra a continuación:

 C#

class B: A

int z;

public override int X {

get { return base.X + 1; }

public override int Y {

set { base.Y = value < 0? 0: value; }

public override int Z {

get { return z; }

set { z = value; }

Aquí, las declaraciones de X , Y y son las Z declaraciones de propiedad de reemplazo.

Cada declaración de propiedad coincide exactamente con los modificadores de
accesibilidad, el tipo y el nombre de la propiedad heredada correspondiente. El get
descriptor de acceso de X y el set descriptor de acceso de Y utilizan la base palabra
clave para tener acceso a los descriptores de acceso La declaración de Z invalida ambos
descriptores de acceso abstractos; por tanto, no hay miembros de función abstracta
pendientes en y B B se permite que sea una clase no abstracta.

Cuando una propiedad se declara como override , cualquier descriptor de acceso

invalidado debe ser accesible para el código de invalidación. Además, la accesibilidad
declarada de la propiedad o del indexador, y de los descriptores de acceso, debe
coincidir con la del miembro y los descriptores de acceso invalidados. Por ejemplo:

C#

public class B

public virtual int P {

protected set {...}

get {...}

public class D: B

public override int P {

protected set {...} // Must specify protected here

get {...} // Must not have a modifier here

Events
Un *evento _ es un miembro que permite a un objeto o una clase proporcionar
notificaciones. Los clientes pueden adjuntar código ejecutable para eventos
proporcionando _ controladores de eventos *.

Los eventos se declaran mediante event_declaration s:

antlr

event_declaration

: attributes? event_modifier* 'event' type variable_declarators ';'

| attributes? event_modifier* 'event' type member_name '{'

event_accessor_declarations '}'

event_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| 'static'

| 'virtual'

| 'sealed'

| 'override'

| 'abstract'

| 'extern'

| event_modifier_unsafe

event_accessor_declarations

: add_accessor_declaration remove_accessor_declaration

| remove_accessor_declaration add_accessor_declaration

add_accessor_declaration

: attributes? 'add' block

remove_accessor_declaration

: attributes? 'remove' block

Un event_declaration puede incluir un conjunto de atributos (atributos) y una

combinación válida de los cuatro modificadores de acceso (modificadores de acceso), el
new (el nuevo modificador), static (métodos estáticos y de instancia), virtual

(métodos virtuales), override (métodos de invalidación), (métodos sellados), (métodos

sealed abstract abstractos) y extern Modificadores (métodos externos).

Las declaraciones de eventos están sujetas a las mismas reglas que las declaraciones de
método (métodos) con respecto a las combinaciones válidas de modificadores.

El tipo de una declaración de evento debe ser un delegate_type (tipos de referencia) y

ese delegate_type debe ser al menos igual de accesible que el propio evento
(restricciones de accesibilidad).

Una declaración de evento puede incluir event_accessor_declarations. Sin embargo, si no,

para los eventos no abstractos y no externos, el compilador los proporciona
automáticamente (eventos similares a los campos); en el caso de los eventos extern, los
descriptores de acceso se proporcionan externamente.

Una declaración de evento que omite event_accessor_declarations define uno o más

eventos, uno para cada una de las variable_declarator s. Los atributos y modificadores se
aplican a todos los miembros declarados por este tipo de event_declaration.

Se trata de un error en tiempo de compilación para que una event_declaration incluya

tanto el abstract modificador como el event_accessor_declarations delimitado por
llaves.

Cuando una declaración de evento incluye un extern modificador, se dice que el evento
es un *evento externo. Dado que una declaración de evento externo no proporciona
ninguna implementación real, es un error que incluya tanto el extern modificador como
el _event_accessor_declarations *.

Se trata de un error en tiempo de compilación para una variable_declarator de una

declaración de evento con un abstract external modificador o para incluir un
variable_initializer.

Un evento se puede usar como operando izquierdo de los += -= operadores y

(asignación deeventos). Estos operadores se utilizan, respectivamente, para adjuntar
controladores de eventos a o para quitar controladores de eventos de un evento, y los
modificadores de acceso del evento controlan los contextos en los que se permiten esas
operaciones.

Puesto que += y -= son las únicas operaciones que se permiten en un evento fuera del
tipo que declara el evento, el código externo puede Agregar y quitar controladores para
un evento, pero no puede obtener o modificar la lista subyacente de controladores de
eventos.
En una operación de la forma x += y o x -= y , cuando x es un evento y la referencia
tiene lugar fuera del tipo que contiene la declaración de x , el resultado de la operación
tiene el tipo void (en lugar de tener el tipo de x , con el valor de x después de la
asignación). Esta regla prohíbe que el código externo examine indirectamente el
delegado subyacente de un evento.

En el ejemplo siguiente se muestra cómo se adjuntan los controladores de eventos a las

instancias de la Button clase:

C#

public delegate void EventHandler(object sender, EventArgs e);

public class Button: Control

public event EventHandler Click;

public class LoginDialog: Form

Button OkButton;

Button CancelButton;

public LoginDialog() {

OkButton = new Button(...);

OkButton.Click += new EventHandler(OkButtonClick);

CancelButton = new Button(...);

CancelButton.Click += new EventHandler(CancelButtonClick);

void OkButtonClick(object sender, EventArgs e) {

// Handle OkButton.Click event

void CancelButtonClick(object sender, EventArgs e) {

// Handle CancelButton.Click event

En este caso, el LoginDialog constructor de instancia crea dos Button instancias y asocia
los controladores de eventos a los Click eventos.

Eventos similares a campos

En el texto del programa de la clase o el struct que contiene la declaración de un
evento, se pueden usar determinados eventos como campos. Para usar de esta manera,
un evento no debe ser abstract o extern y no debe incluir explícitamente
event_accessor_declarations. Este tipo de evento se puede utilizar en cualquier contexto
que permita un campo. El campo contiene un delegado (delegados) que hace referencia
a la lista de controladores de eventos que se han agregado al evento. Si no se ha
agregado ningún controlador de eventos, el campo contiene null .

En el ejemplo

C#

public delegate void EventHandler(object sender, EventArgs e);

public class Button: Control

public event EventHandler Click;

protected void OnClick(EventArgs e) {

if (Click != null) Click(this, e);

public void Reset() {

Click = null;

Click se usa como un campo dentro de la Button clase. Como muestra el ejemplo, el
campo se puede examinar, modificar y usar en expresiones de invocación de delegado.
El OnClick método de la Button clase "genera" el Click evento. La noción de generar
un evento es equivalente exactamente a invocar el delegado representado por el
evento; por lo tanto, no hay ninguna construcción especial de lenguaje para generar
eventos. Tenga en cuenta que la invocación del delegado está precedida por una
comprobación que garantiza que el delegado no es NULL.

Fuera de la declaración de la Button clase, el Click miembro solo se puede usar en el

lado izquierdo de los += operadores y -= , como en

C#

b.Click += new EventHandler(...);

que anexa un delegado a la lista de invocaciones del Click evento, y

C#

b.Click -= new EventHandler(...);

que quita un delegado de la lista de invocación del Click evento.

Al compilar un evento como un campo, el compilador crea automáticamente el

almacenamiento para contener el delegado y crea los descriptores de acceso para el
evento que agregan o quitan controladores de eventos para el campo delegado. Las
operaciones de adición y eliminación son seguras para subprocesos y puede (pero no es
necesario que) se realicen mientras se mantiene el bloqueo (la instrucción lock) en el
objeto contenedor para un evento de instancia o el objeto de tipo (expresiones de
creación de objetos anónimos) para un evento estático.

Por lo tanto, una declaración de evento de instancia con el formato:

C#

class X

public event D Ev;

se compilará en algo equivalente a:

C#

class X

private D __Ev; // field to hold the delegate

public event D Ev {
add {

/* add the delegate in a thread safe way */

remove {

/* remove the delegate in a thread safe way */

Dentro de la clase X , las referencias a Ev en el lado izquierdo de los += -= operadores

y hacen que se invoquen los descriptores de acceso add y Remove. Todas las demás
referencias a Ev se compilan para hacer referencia al campo oculto en __Ev su lugar
(acceso a miembros). El nombre " __Ev " es arbitrario; el campo oculto puede tener
cualquier nombre o ningún nombre.

Descriptores de acceso de un evento

Las declaraciones de evento normalmente omiten event_accessor_declarations, como en
el Button ejemplo anterior. Una situación para hacerlo implica el caso en el que el costo
de almacenamiento de un campo por evento no es aceptable. En tales casos, una clase
puede incluir event_accessor_declarations y utilizar un mecanismo privado para
almacenar la lista de controladores de eventos.

En el event_accessor_declarations de un evento se especifican las instrucciones

ejecutables asociadas a la adición y eliminación de controladores de eventos.

Las declaraciones de descriptor de acceso constan de un add_accessor_declaration y un

remove_accessor_declaration. Cada declaración de descriptor de acceso consta del token
add o remove va seguido de un bloque. El bloque asociado a un add_accessor_declaration

especifica las instrucciones que se ejecutarán cuando se agregue un controlador de

eventos y el bloque asociado a un remove_accessor_declaration especifica las
instrucciones que se ejecutarán cuando se quite un controlador de eventos.

Cada add_accessor_declaration y remove_accessor_declaration corresponde a un método

con un parámetro de valor único del tipo de evento y un tipo de valor void devuelto. El
parámetro implícito de un descriptor de acceso de eventos se denomina value .
Cuando se utiliza un evento en una asignación de eventos, se usa el descriptor de
acceso de eventos adecuado. En concreto, si el operador de asignación es += , se usa el
descriptor de acceso add y, si el operador de asignación es -= , se usa el descriptor de
acceso Remove. En cualquier caso, el operando derecho del operador de asignación se
utiliza como argumento para el descriptor de acceso de eventos. El bloque de una
add_accessor_declaration o un remove_accessor_declaration debe ajustarse a las reglas de
void los métodos descritos en el cuerpo del método. En concreto, las return

instrucciones de un bloque de este tipo no pueden especificar una expresión.

Dado que un descriptor de acceso de eventos tiene implícitamente un parámetro

denominado value , se trata de un error en tiempo de compilación para una variable
local o una constante declarada en un descriptor de acceso de eventos para que tenga
ese nombre.

En el ejemplo

C#

class Control: Component

// Unique keys for events

static readonly object mouseDownEventKey = new object();

static readonly object mouseUpEventKey = new object();

// Return event handler associated with key

 protected Delegate GetEventHandler(object key) {...}

// Add event handler associated with key

protected void AddEventHandler(object key, Delegate handler) {...}

// Remove event handler associated with key

protected void RemoveEventHandler(object key, Delegate handler) {...}

// MouseDown event

public event MouseEventHandler MouseDown {

add { AddEventHandler(mouseDownEventKey, value); }

remove { RemoveEventHandler(mouseDownEventKey, value); }

// MouseUp event

public event MouseEventHandler MouseUp {

add { AddEventHandler(mouseUpEventKey, value); }

remove { RemoveEventHandler(mouseUpEventKey, value); }

// Invoke the MouseUp event

protected void OnMouseUp(MouseEventArgs args) {

MouseEventHandler handler;

handler = (MouseEventHandler)GetEventHandler(mouseUpEventKey);

if (handler != null)

handler(this, args);

la Control clase implementa un mecanismo de almacenamiento interno para los

eventos. El AddEventHandler método asocia un valor de delegado a una clave, el
GetEventHandler método devuelve el delegado asociado actualmente a una clave y el
RemoveEventHandler método quita un delegado como controlador de eventos para el

evento especificado. Presumiblemente, el mecanismo de almacenamiento subyacente

está diseñado de forma que no hay ningún costo por asociar un null valor de delegado
con una clave y, por lo tanto, los eventos no controlados no consumen almacenamiento.

Eventos estáticos y de instancia

Cuando una declaración de evento incluye un static modificador, se dice que el evento
es un *evento estático _. Cuando no static existe ningún modificador, se dice que el
evento es un evento de instancia _ * * *.

Un evento estático no está asociado a una instancia específica de y es un error en

tiempo de compilación para hacer referencia a this en los descriptores de acceso de un
evento estático.
Un evento de instancia está asociado a una instancia determinada de una clase y se
puede tener acceso a esta instancia como this (este acceso) en los descriptores de
acceso de ese evento.

Cuando se hace referencia a un evento en un member_access (acceso a miembros) del

formulario E.M , si M es un evento estático, E debe indicar un tipo que contiene M y si
M es un evento de instancia, E debe indicar una instancia de un tipo que contiene M .

Las diferencias entre los miembros estáticos y de instancia se tratan más adelante en
miembros estáticos y de instancia.

Descriptores de acceso de eventos virtuales, sellados, de

invalidación y abstractos
Una virtual declaración de evento especifica que los descriptores de acceso de ese
evento son virtuales. El virtual modificador se aplica a ambos descriptores de acceso
de un evento.

Una abstract declaración de evento especifica que los descriptores de acceso del
evento son virtuales, pero no proporciona una implementación real de los descriptores
de acceso. En su lugar, las clases derivadas no abstractas deben proporcionar su propia
implementación para los descriptores de acceso invalidando el evento. Dado que una
declaración de evento abstracto no proporciona ninguna implementación real, no
puede proporcionar event_accessor_declarations delimitados por llaves.

Una declaración de evento que incluye los abstract override modificadores y

especifica que el evento es abstracto e invalida un evento base. Los descriptores de
acceso de este tipo de evento también son abstractos.

Las declaraciones de eventos abstractos solo se permiten en clases abstractas (clases

abstractas).

Los descriptores de acceso de un evento virtual heredado se pueden invalidar en una

clase derivada mediante la inclusión de una declaración de evento que especifique un
override modificador. Esto se conoce como una declaración de evento de reemplazo.

Una declaración de evento de reemplazo no declara un nuevo evento. En su lugar,

simplemente especializa las implementaciones de los descriptores de acceso de un
evento virtual existente.

Una declaración de evento de reemplazo debe especificar exactamente los mismos

modificadores de accesibilidad, tipo y nombre que el evento invalidado.
Una declaración de evento de reemplazo puede incluir el sealed modificador. El uso de
este modificador evita que una clase derivada Reemplace el evento. Los descriptores de
acceso de un evento sellado también están sellados.

Es un error en tiempo de compilación que una declaración de evento de reemplazo

incluya un new modificador.

A excepción de las diferencias en la sintaxis de declaración e invocación, los descriptores

de acceso virtual, sellado, invalidación y Abstract se comportan exactamente igual que
los métodos virtuales, sellados, de invalidación y abstractos. En concreto, las reglas
descritas en métodos virtuales, métodos de invalidación, métodos selladosy métodos
abstractos se aplican como si los descriptores de acceso fueran métodos de un
formulario correspondiente. Cada descriptor de acceso corresponde a un método con
un parámetro de valor único del tipo de evento, un void tipo de valor devuelto y los
mismos modificadores que el evento que lo contiene.

Indizadores
*Indexer _ es un miembro que permite indizar un objeto de la misma manera que una
matriz. Los indexadores se declaran mediante _indexer_declaration * s:

antlr

indexer_declaration

: attributes? indexer_modifier* indexer_declarator indexer_body

indexer_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| 'virtual'

| 'sealed'

| 'override'

| 'abstract'

| 'extern'

| indexer_modifier_unsafe

indexer_declarator

: type 'this' '[' formal_parameter_list ']'

| type interface_type '.' 'this' '[' formal_parameter_list ']'

indexer_body

: '{' accessor_declarations '}'

 | '=>' expression ';'

Un indexer_declaration puede incluir un conjunto de atributos (atributos) y una

combinación válida de los cuatro modificadores de acceso (modificadores de acceso),
los new Modificadores (los nuevos modificadores), virtual (métodos virtuales),
(métodos de override invalidación), sealed (métodos sellados), abstract (métodos
abstractos) y extern (métodos externos).

Las declaraciones de indexador están sujetas a las mismas reglas que las declaraciones
de método (métodos) con respecto a las combinaciones válidas de modificadores, con
la única excepción de que el modificador static no se permite en una declaración de
indexador.

Los modificadores virtual , override y abstract se excluyen mutuamente, excepto en

un caso. Los abstract override modificadores y se pueden usar juntos para que un
indexador abstracto pueda reemplazar a uno virtual.

El tipo de una declaración de indexador especifica el tipo de elemento del indizador

introducido por la declaración. A menos que el indizador sea una implementación
explícita de un miembro de interfaz, el tipo va seguido de la palabra clave this . Para
una implementación explícita de un miembro de interfaz, el tipo va seguido de un
interface_type, un " . " y la palabra clave this . A diferencia de otros miembros, los
indizadores no tienen nombres definidos por el usuario.

En el formal_parameter_list se especifican los parámetros del indexador. La lista de

parámetros formales de un indizador corresponde a la de un método (parámetros de
método), salvo que se debe especificar al menos un parámetro y ref que out no se
permiten los modificadores de parámetro y.

El tipo de un indexador y cada uno de los tipos a los que se hace referencia en el
formal_parameter_list deben ser al menos tan accesibles como el propio indizador
(restricciones de accesibilidad).

Un indexer_body puede consistir en un "*cuerpo del descriptor de acceso***" o un _cuerpo

de expresión*.. En el cuerpo de un descriptor de acceso, _accessor_declarations *, que
debe incluirse en los { tokens "" y "" } , declare los descriptores de acceso (descriptores
de acceso) de la propiedad. Los descriptores de acceso especifican las instrucciones
ejecutables asociadas a la lectura y la escritura de la propiedad.

Un cuerpo de expresión que consta de " => " seguido de una expresión E y un punto y
coma es exactamente equivalente al cuerpo de la instrucción { get { return E; } } y,
por tanto, solo se puede usar para especificar indizadores de solo captador en los que
una sola expresión proporciona el resultado del captador.

Aunque la sintaxis para tener acceso a un elemento de indexador es la misma que para
un elemento de matriz, un elemento de indexador no se clasifica como una variable. Por
lo tanto, no es posible pasar un elemento indexador como ref argumento o out .

La lista de parámetros formales de un indexador define la firma (firmas y sobrecarga) del

indexador. En concreto, la firma de un indexador consta del número y los tipos de sus
parámetros formales. El tipo de elemento y los nombres de los parámetros formales no
forman parte de la firma de un indexador.

La firma de un indizador debe ser diferente de las firmas de todos los demás
indexadores declarados en la misma clase.

Los indexadores y las propiedades son muy similares en concepto, pero difieren de las
siguientes maneras:

Una propiedad se identifica por su nombre, mientras que un indexador se

identifica mediante su firma.
Se tiene acceso a una propiedad a través de un simple_name (nombres simples) o
un member_access (acceso a miembros), mientras que se tiene acceso a un
elemento de indexador a través de un element_access (acceso a indexador).
Una propiedad puede ser un static miembro, mientras que un indexador siempre
es un miembro de instancia.
Un get descriptor de acceso de una propiedad corresponde a un método sin
parámetros, mientras que un get descriptor de acceso de un indizador
corresponde a un método con la misma lista de parámetros formales que el
indexador.
Un set descriptor de acceso de una propiedad corresponde a un método con un
único parámetro denominado value , mientras que un set descriptor de acceso
de un indizador corresponde a un método con la misma lista de parámetros
formales que el indexador, además de un parámetro adicional denominado value .
Es un error en tiempo de compilación que un descriptor de acceso de indexador
declare una variable local con el mismo nombre que un parámetro de indizador.
En una declaración de propiedad de reemplazo, se tiene acceso a la propiedad
heredada mediante la sintaxis base.P , donde P es el nombre de la propiedad. En
una declaración de indizador de reemplazo, se tiene acceso al indizador heredado
mediante la sintaxis base[E] , donde E es una lista de expresiones separadas por
comas.
No hay ningún concepto de "indexador implementado automáticamente". Es un
error tener un indexador no externo no abstracto con descriptores de acceso de
 punto y coma.

Aparte de estas diferencias, todas las reglas definidas en los descriptores de acceso y las
propiedades implementadas automáticamente se aplican a los descriptores de acceso
del indizador y a los descriptores de acceso de propiedades.

Cuando una declaración de indexador incluye un extern modificador, el indizador se

dice que es un *indexador externo. Dado que una declaración de indexador externa no
proporciona ninguna implementación real, cada una de sus _accessor_declarations *
consta de un punto y coma.

En el ejemplo siguiente se declara una BitArray clase que implementa un indizador

para tener acceso a los bits individuales de la matriz de bits.

C#

using System;

class BitArray

int[] bits;

int length;

public BitArray(int length) {

if (length < 0) throw new ArgumentException();

bits = new int[((length - 1) >> 5) + 1];

this.length = length;

public int Length {

get { return length; }

public bool this[int index] {

get {

if (index < 0 || index >= length) {

throw new IndexOutOfRangeException();

return (bits[index >> 5] & 1 << index) != 0;

set {

if (index < 0 || index >= length) {

throw new IndexOutOfRangeException();

if (value) {

bits[index >> 5] |= 1 << index;

else {

bits[index >> 5] &= ~(1 << index);

Una instancia de la BitArray clase consume bastante menos memoria que un

correspondiente bool[] (puesto que cada valor de la antigua solo ocupa un bit en lugar
de un byte), pero permite las mismas operaciones que bool[] .

La CountPrimes clase siguiente usa un BitArray y el algoritmo clásico "criba" para

calcular el número de primos entre 1 y un máximo determinado:

C#

class CountPrimes

static int Count(int max) {

BitArray flags = new BitArray(max + 1);

int count = 1;

for (int i = 2; i <= max; i++) {

if (!flags[i]) {

for (int j = i * 2; j <= max; j += i) flags[j] = true;

count++;

return count;

static void Main(string[] args) {

int max = int.Parse(args[0]);

int count = Count(max);

Console.WriteLine("Found {0} primes between 1 and {1}", count, max);

Tenga en cuenta que la sintaxis para tener acceso a los elementos de BitArray es
exactamente igual que para bool[] .

En el ejemplo siguiente se muestra una clase de cuadrícula de 26 * 10 que tiene un

indizador con dos parámetros. El primer parámetro debe ser una letra mayúscula o
minúscula en el intervalo A-Z, y el segundo debe ser un entero en el intervalo 0-9.

C#

using System;

class Grid

const int NumRows = 26;

const int NumCols = 10;

 int[,] cells = new int[NumRows, NumCols];

public int this[char c, int col] {

get {

c = Char.ToUpper(c);

if (c < 'A' || c > 'Z') {

throw new ArgumentException();

if (col < 0 || col >= NumCols) {

throw new IndexOutOfRangeException();

return cells[c - 'A', col];

set {

c = Char.ToUpper(c);

if (c < 'A' || c > 'Z') {

throw new ArgumentException();

if (col < 0 || col >= NumCols) {

throw new IndexOutOfRangeException();

cells[c - 'A', col] = value;

Sobrecarga del indexador

Las reglas de resolución de sobrecarga de indexador se describen en inferencia de tipos.

Operadores
Un *operador _ es un miembro que define el significado de un operador de expresión
que se puede aplicar a las instancias de la clase. Los operadores se declaran mediante
_operator_declaration * s:

antlr

operator_declaration

: attributes? operator_modifier+ operator_declarator operator_body

operator_modifier

: 'public'

| 'static'

| 'extern'

| operator_modifier_unsafe

 operator_declarator

: unary_operator_declarator

| binary_operator_declarator

| conversion_operator_declarator

unary_operator_declarator

: type 'operator' overloadable_unary_operator '(' type identifier ')'

overloadable_unary_operator

: '+' | '-' | '!' | '~' | '++' | '--' | 'true' | 'false'

binary_operator_declarator

: type 'operator' overloadable_binary_operator '(' type identifier ','

type identifier ')'

overloadable_binary_operator

: '+' | '-' | '*' | '/' | '%' | '&' | '|' | '^' | '<<'

| right_shift | '==' | '!=' | '>' | '<' | '>=' | '<='

conversion_operator_declarator

: 'implicit' 'operator' type '(' type identifier ')'

| 'explicit' 'operator' type '(' type identifier ')'

operator_body

: block

| '=>' expression ';'

| ';'

Hay tres categorías de Operadores sobrecargables: operadores unarios (operadores

unarios), operadores binarios (operadores binarios) y operadores de conversión
(operadores de conversión).

La operator_body es un punto y coma, un cuerpo de instrucción* o un cuerpo de

expresión. Un cuerpo de instrucción consta de un _block *, que especifica las
instrucciones que se ejecutarán cuando se invoque el operador. El bloque debe cumplir
las reglas de los métodos que devuelven valores descritos en el cuerpo del método. Un
cuerpo de expresión consta de => seguido de una expresión y un punto y coma, y
denota una expresión única que se debe realizar cuando se invoca el operador.

En extern el caso de los operadores, el operator_body consta simplemente de un punto

y coma. En el caso de todos los demás operadores, el operator_body es un cuerpo de
bloque o un cuerpo de expresión.
Las siguientes reglas se aplican a todas las declaraciones de operador:

Una declaración de operador debe incluir tanto un public static modificador

como un modificador.
Los parámetros de un operador deben ser parámetros de valor (parámetros
devalor). Se trata de un error en tiempo de compilación para que una declaración
de operador especifique ref out parámetros o.
La firma de un operador (operadores unarios, operadores binariosy operadores de
conversión) debe ser diferente de las firmas de todos los demás operadores
declarados en la misma clase.
Todos los tipos a los que se hace referencia en una declaración de operador deben
ser al menos tan accesibles como el propio operador (restricciones de
accesibilidad).
Es un error que el mismo modificador aparezca varias veces en una declaración de
operador.

Cada categoría de operador impone restricciones adicionales, tal y como se describe en

las secciones siguientes.

Al igual que otros miembros, las clases derivadas heredan los operadores declarados en
una clase base. Dado que las declaraciones de operador siempre requieren la clase o
estructura en la que se declara que el operador participa en la firma del operador, no es
posible que un operador declarado en una clase derivada oculte un operador declarado
en una clase base. Por lo tanto, el new modificador nunca es necesario y, por lo tanto,
nunca se permite en una declaración de operador.

Puede encontrar información adicional sobre operadores unarios y binarios en

operadores.

Puede encontrar información adicional sobre los operadores de conversión en

conversiones definidas por el usuario.

Operadores unarios
Las siguientes reglas se aplican a las declaraciones de operadores unarios, donde T
denota el tipo de instancia de la clase o el struct que contiene la declaración de
operador:

Un operador unario + , - , ! o ~ debe tomar un parámetro único de tipo T o T?

y puede devolver cualquier tipo.
Un operador unario ++ or -- debe tomar un único parámetro de tipo T o T? y
debe devolver el mismo tipo o un tipo derivado de él.
 Un operador unario true or false debe tomar un parámetro único de tipo T o
T? y debe devolver el tipo bool .

La firma de un operador unario está formada por el token del operador ( + , - , ! , ~ ,

++ , -- , true o false ) y el tipo del único parámetro formal. El tipo de valor devuelto
no forma parte de la firma de un operador unario, ni tampoco el nombre del parámetro
formal.

Los true false operadores unarios y requieren la declaración de pares. Se produce un

error en tiempo de compilación si una clase declara uno de estos operadores sin
declarar también el otro. Los true false operadores y se describen con más detalle en
operadores lógicos condicionales definidos por el usuario y en Expresiones booleanas.

En el ejemplo siguiente se muestra una implementación y el uso posterior de operator

++ para una clase de vector entero:

C#

public class IntVector

public IntVector(int length) {...}

public int Length {...} // read-only property

public int this[int index] {...} // read-write indexer

public static IntVector operator ++(IntVector iv) {

IntVector temp = new IntVector(iv.Length);

for (int i = 0; i < iv.Length; i++)

temp[i] = iv[i] + 1;

return temp;

class Test

static void Main() {

IntVector iv1 = new IntVector(4); // vector of 4 x 0

IntVector iv2;

iv2 = iv1++; // iv2 contains 4 x 0, iv1 contains 4 x 1

iv2 = ++iv1; // iv2 contains 4 x 2, iv1 contains 4 x 2

Observe cómo el método de operador devuelve el valor generado agregando 1 al

operando, al igual que los operadores de incremento y decremento de
postfijo(operadores de incremento ydecremento postfijo) y los operadores de
incremento y decremento de prefijo (operadores de incremento y decremento
deprefijo). A diferencia de C++, este método no necesita modificar directamente el valor
de su operando. De hecho, la modificación del valor de operando infringiría la
semántica estándar del operador de incremento de postfijo.

Operadores binarios
Las siguientes reglas se aplican a las declaraciones de operadores binarios, donde T
denota el tipo de instancia de la clase o el struct que contiene la declaración de
operador:

Un operador binario sin desplazamiento debe tomar dos parámetros, al menos

uno de los cuales debe tener el tipo T o y T? puede devolver cualquier tipo.
Un << operador OR binario >> debe tomar dos parámetros, el primero debe tener
el tipo T o T? y el segundo de los cuales debe tener el tipo int o int? , y puede
devolver cualquier tipo.

La firma de un operador binario consta del token de operador ( + , - , * , / , % , & , | ,

^ , << , >> ,,,,, == != > < >= o <= ) y los tipos de los dos parámetros formales. El tipo
de valor devuelto y los nombres de los parámetros formales no forman parte de la firma
de un operador binario.

Ciertos operadores binarios requieren la declaración de pares. Para cada declaración de

cualquiera de los operadores de un par, debe haber una declaración coincidente del
otro operador del par. Dos declaraciones de operador coinciden cuando tienen el
mismo tipo de valor devuelto y el mismo tipo para cada parámetro. Los operadores
siguientes requieren una declaración de pares:

operator == y operator !=

operator > y operator <

operator >= y operator <=

Operadores de conversión
Una declaración de operador de conversión introduce una conversión definida por el
usuario (conversiones definidas por el usuario) que aumenta las conversiones implícitas
y explícitas predefinidas.

Una declaración de operador de conversión que incluye la implicit palabra clave

presenta una conversión implícita definida por el usuario. Las conversiones implícitas
pueden producirse en diversas situaciones, incluidas las invocaciones de miembros de
función, las expresiones de conversión y las asignaciones. Esto se describe con más
detalle en conversiones implícitas.

Una declaración de operador de conversión que incluye la explicit palabra clave

presenta una conversión explícita definida por el usuario. Las conversiones explícitas
pueden producirse en expresiones de conversión y se describen con más detalle en
conversiones explícitas.

Un operador de conversión convierte de un tipo de origen, indicado por el tipo de

parámetro del operador de conversión, en un tipo de destino, indicado por el tipo de
valor devuelto del operador de conversión.

Para un tipo de origen S y tipo de destino determinados, T si S o T son tipos que

aceptan valores NULL, permiten S0 y T0 hacen referencia a sus tipos subyacentes, de lo
contrario, S0 y T0 son iguales a S y T respectivamente. Una clase o struct puede
declarar una conversión de un tipo de origen S a un tipo de destino T solo si se
cumplen todas las condiciones siguientes:

S0 y T0 son tipos diferentes.

S0 O T0 es el tipo de clase o estructura en el que tiene lugar la declaración del

operador.
Ni S0 ni T0 es un interface_type.
Sin incluir las conversiones definidas por el usuario, no existe una conversión de S
a T o de T a S .

En el caso de estas reglas, los parámetros de tipo asociados a S o T se consideran tipos

únicos que no tienen ninguna relación de herencia con otros tipos y se omiten las
restricciones en esos parámetros de tipo.

En el ejemplo

C#

class C<T> {...}

class D<T>: C<T>

public static implicit operator C<int>(D<T> value) {...} // Ok

public static implicit operator C<string>(D<T> value) {...} // Ok

public static implicit operator C<T>(D<T> value) {...} // Error

las dos primeras declaraciones de operador se permiten porque, para los fines de los
indizadores. 3, T y int y string respectivamente se consideran tipos únicos sin
relación. Sin embargo, el tercer operador es un error porque C<T> es la clase base de
D<T> .

En la segunda regla, se sigue que un operador de conversión debe convertir a o desde

el tipo de clase o estructura en el que se declara el operador. Por ejemplo, es posible
que un tipo de clase o estructura C defina una conversión de C a int y de int a C ,
pero no de int a bool .

No es posible volver a definir directamente una conversión predefinida. Por lo tanto, no

se permite que los operadores de conversión se conviertan de o a object porque ya
existen conversiones implícitas y explícitas entre object y todos los demás tipos. Del
mismo modo, ni los tipos de origen ni de destino de una conversión pueden ser un tipo
base del otro, ya que una conversión ya existirá.

Sin embargo, es posible declarar operadores en tipos genéricos que, para argumentos
de tipo concretos, especifiquen conversiones que ya existan como conversiones
predefinidas. En el ejemplo

C#

struct Convertible<T>

public static implicit operator Convertible<T>(T value) {...}

public static explicit operator T(Convertible<T> value) {...}

Cuando object el tipo se especifica como un argumento de tipo para T , el segundo

operador declara una conversión que ya existe (una conversión implícita y, por tanto,
también una conversión explícita de cualquier tipo al tipo object ).

En los casos en los que existe una conversión predefinida entre dos tipos, se omiten las
conversiones definidas por el usuario entre esos tipos. Concretamente:

Si existe una conversión implícita predefinida (conversiones implícitas) del tipo S

al tipo T , S se omiten todas las conversiones definidas por el usuario (implícitas o
explícitas) de a T .
Si existe una conversión explícita predefinida (conversiones explícitas) del tipo S al
tipo T , S se omiten las conversiones explícitas definidas por el usuario de a T .
Asimismo,

Si T es un tipo de interfaz, S se omiten las conversiones implícitas definidas por el

usuario de a T .
De lo contrario, las conversiones implícitas definidas por el usuario de S a T se siguen
teniendo en cuenta.

En todos los tipos object , pero los operadores declarados por el Convertible<T> tipo
anterior no entran en conflicto con las conversiones predefinidas. Por ejemplo:

C#

void F(int i, Convertible<int> n) {

i = n; // Error

i = (int)n; // User-defined explicit conversion

n = i; // User-defined implicit conversion

n = (Convertible<int>)i; // User-defined implicit conversion

Sin embargo, para object el tipo, las conversiones predefinidas ocultan las conversiones
definidas por el usuario en todos los casos, pero una:

C#

void F(object o, Convertible<object> n) {

o = n; // Pre-defined boxing conversion

o = (object)n; // Pre-defined boxing conversion

n = o; // User-defined implicit conversion

n = (Convertible<object>)o; // Pre-defined unboxing conversion

No se permiten conversiones definidas por el usuario para convertir de o a

interface_type s. En concreto, esta restricción garantiza que no se produzcan
transformaciones definidas por el usuario al realizar la conversión a un interface_type y
que una conversión a una interface_type se realice correctamente solo si el objeto que
se está convirtiendo implementa realmente el interface_type especificado.

La firma de un operador de conversión está formada por el tipo de origen y el tipo de

destino. (Tenga en cuenta que esta es la única forma de miembro para la que participa
el tipo de valor devuelto en la firma.) La implicit explicit clasificación o de un
operador de conversión no forma parte de la firma del operador. Por lo tanto, una clase
o struct no puede declarar un implicit explicit operador de conversión y con los
mismos tipos de origen y de destino.

En general, las conversiones implícitas definidas por el usuario deben diseñarse para
que nunca se produzcan excepciones y nunca se pierda información. Si una conversión
definida por el usuario puede dar lugar a excepciones (por ejemplo, porque el
argumento de origen está fuera del intervalo) o la pérdida de información (como
descartar los bits de orden superior), esa conversión debe definirse como una
conversión explícita.

En el ejemplo

C#

using System;

public struct Digit

byte value;

public Digit(byte value) {

if (value < 0 || value > 9) throw new ArgumentException();

this.value = value;

public static implicit operator byte(Digit d) {

return d.value;
}

public static explicit operator Digit(byte b) {

return new Digit(b);

la conversión de Digit a byte es implícita porque nunca produce excepciones o pierde

información, pero la conversión de byte a Digit es explícita, ya que Digit solo puede
representar un subconjunto de los valores posibles de byte .

Constructores de instancias
Un *constructor de instancia _ es un miembro que implementa las acciones necesarias
para inicializar una instancia de una clase. Los constructores de instancias se declaran
mediante _constructor_declaration * s:

antlr

constructor_declaration

: attributes? constructor_modifier* constructor_declarator

constructor_body

constructor_modifier

: 'public'

| 'protected'

| 'internal'

 | 'private'

| 'extern'

| constructor_modifier_unsafe
;

constructor_declarator

: identifier '(' formal_parameter_list? ')' constructor_initializer?

constructor_initializer

: ':' 'base' '(' argument_list? ')'

| ':' 'this' '(' argument_list? ')'

constructor_body

: block

| ';'

Un constructor_declaration puede incluir un conjunto de atributos (atributos), una

combinación válida de los cuatro modificadores de acceso (modificadores de acceso) y
un extern modificador (métodos externos). No se permite que una declaración de
constructor incluya el mismo modificador varias veces.

El identificador de un constructor_declarator debe nombrar la clase en la que se declara

el constructor de instancia. Si se especifica cualquier otro nombre, se produce un error
en tiempo de compilación.

El formal_parameter_list opcional de un constructor de instancia está sujeto a las mismas

reglas que la formal_parameter_list de un método (métodos). La lista de parámetros
formales define la firma (firmas y sobrecarga) de un constructor de instancia y rige el
proceso por el cual la resolución de sobrecarga (inferencia de tipos) selecciona un
constructor de instancia determinado en una invocación.

Cada uno de los tipos a los que se hace referencia en el formal_parameter_list de un

constructor de instancia debe ser al menos igual de accesible que el propio constructor
(restricciones de accesibilidad).

El constructor_initializer opcional especifica otro constructor de instancia que se va a

invocar antes de ejecutar las instrucciones proporcionadas en el constructor_body de
este constructor de instancia. Esto se describe con más detalle en inicializadores de
constructor.

Cuando una declaración de constructor incluye un extern modificador, se dice que el

constructor es un *constructor externo _. Dado que una declaración de constructor
externo no proporciona ninguna implementación real, su _constructor_body * consta de
un punto y coma. En el caso de todos los demás constructores, el constructor_body se
compone de un bloque que especifica las instrucciones para inicializar una nueva
instancia de la clase. Esto corresponde exactamente al bloque de un método de
instancia con un void tipo de valor devuelto (cuerpo del método).

No se heredan los constructores de instancia. Por lo tanto, una clase no tiene ningún
constructor de instancia que no sea el declarado realmente en la clase. Si una clase no
contiene ninguna declaración de constructor de instancia, se proporciona
automáticamente un constructor de instancia predeterminado (constructores
predeterminados).

Los constructores de instancias se invocan mediante object_creation_expression s

(expresiones de creación de objetos) y a través de constructor_initializer s.

Inicializadores del constructor

Todos los constructores de instancia (excepto los de la clase object ) incluyen
implícitamente una invocación de otro constructor de instancia inmediatamente antes
de la constructor_body. El constructor para invocar implícitamente está determinado por
el constructor_initializer:

Un inicializador de constructor de instancia con el formato base(argument_list) o

base() hace que se invoque un constructor de instancia de la clase base directa.
Ese constructor se selecciona utilizando argument_list , si está presente y las reglas
de resolución de sobrecarga de la resolución de sobrecarga. El conjunto de
constructores de instancias candidatas consta de todos los constructores de
instancia accesibles contenidos en la clase base directa, o el constructor
predeterminado (constructores predeterminados), si no se declara ningún
constructor de instancia en la clase base directa. Si este conjunto está vacío, o si no
se puede identificar un único constructor de instancia mejor, se produce un error
en tiempo de compilación.
Un inicializador de constructor de instancia con el formato this(argument-list) o
this() hace que se invoque un constructor de instancia de la propia clase. El
constructor se selecciona utilizando argument_list , si está presente y las reglas de
resolución de sobrecarga de la resolución de sobrecarga. El conjunto de
constructores de instancias candidatas se compone de todos los constructores de
instancia accesibles declarados en la propia clase. Si este conjunto está vacío, o si
no se puede identificar un único constructor de instancia mejor, se produce un
error en tiempo de compilación. Si una declaración de constructor de instancia
incluye un inicializador de constructor que invoca al propio constructor, se
produce un error en tiempo de compilación.
Si un constructor de instancia no tiene ningún inicializador de constructor, base() se
proporciona implícitamente un inicializador de constructor con el formato. Por lo tanto,
una declaración de constructor de instancia con el formato

C#

C(...) {...}

es exactamente equivalente a

C#

C(...): base() {...}

El ámbito de los parámetros proporcionados por la formal_parameter_list de una

declaración de constructor de instancia incluye el inicializador de constructor de esa
declaración. Por lo tanto, se permite a un inicializador de constructor tener acceso a los
parámetros del constructor. Por ejemplo:

C#

class A

public A(int x, int y) {}

class B: A

public B(int x, int y): base(x + y, x - y) {}

Un inicializador de constructor de instancia no puede tener acceso a la instancia que se

está creando. Por lo tanto, es un error en tiempo de compilación hacer referencia a this
una expresión de argumento del inicializador de constructor, como es un error en
tiempo de compilación para que una expresión de argumento haga referencia a un
miembro de instancia a través de un simple_name.

Inicializadores de variables de instancia

Cuando un constructor de instancia no tiene ningún inicializador de constructor o tiene
un inicializador de constructor con el formato base(...) , ese constructor realiza
implícitamente las inicializaciones especificadas por los variable_initializer s de los
campos de instancia declarados en su clase. Esto corresponde a una secuencia de
asignaciones que se ejecutan inmediatamente después de la entrada al constructor y
antes de la invocación implícita del constructor de clase base directo. Los inicializadores
de variable se ejecutan en el orden textual en el que aparecen en la declaración de clase.

Ejecución del constructor

Los inicializadores de variables se transforman en instrucciones de asignación, y estas
instrucciones de asignación se ejecutan antes de la invocación del constructor de
instancia de clase base. Este orden garantiza que todos los campos de instancia se
inicializan mediante sus inicializadores de variable antes de que se ejecute cualquier
instrucción que tenga acceso a esa instancia.

Dado el ejemplo

C#

using System;

class A

public A() {

PrintFields();

public virtual void PrintFields() {}

class B: A

int x = 1;

int y;

public B() {

y = -1;

public override void PrintFields() {

Console.WriteLine("x = {0}, y = {1}", x, y);

Cuando new B() se utiliza para crear una instancia de B , se genera el siguiente
resultado:

Consola

x = 1, y = 0

El valor de x es 1 porque el inicializador de variable se ejecuta antes de que se invoque

el constructor de instancia de clase base. Sin embargo, el valor de y es 0 (el valor
predeterminado de int ) porque la asignación a y no se ejecuta hasta que el
constructor de clase base devuelve.

Resulta útil pensar en los inicializadores de variables de instancia y en los inicializadores

de constructor como instrucciones que se insertan automáticamente antes de la
constructor_body. En el ejemplo

C#

using System;

using System.Collections;

class A

int x = 1, y = -1, count;

public A() {

count = 0;

public A(int n) {

count = n;

class B: A

double sqrt2 = Math.Sqrt(2.0);

ArrayList items = new ArrayList(100);

int max;

public B(): this(100) {

items.Add("default");

public B(int n): base(n - 1) {

max = n;

contiene varios inicializadores variables; también contiene inicializadores de constructor

de ambos formularios ( base y this ). El ejemplo corresponde al código que se muestra
a continuación, donde cada comentario indica una instrucción insertada
automáticamente (la sintaxis utilizada para las invocaciones de constructor insertadas
automáticamente no es válida, pero simplemente sirve para ilustrar el mecanismo).

C#
 using System.Collections;

class A

int x, y, count;

public A() {

x = 1; // Variable initializer

y = -1; // Variable initializer

object(); // Invoke object() constructor

count = 0;

public A(int n) {

x = 1; // Variable initializer

y = -1; // Variable initializer

object(); // Invoke object() constructor

count = n;

class B: A

double sqrt2;

ArrayList items;

int max;

public B(): this(100) {

B(100); // Invoke B(int) constructor

items.Add("default");

public B(int n): base(n - 1) {

sqrt2 = Math.Sqrt(2.0); // Variable initializer

items = new ArrayList(100); // Variable initializer

A(n - 1); // Invoke A(int) constructor

max = n;

Constructores predeterminados
Si una clase no contiene ninguna declaración de constructor de instancia, se
proporciona automáticamente un constructor de instancia predeterminado. Ese
constructor predeterminado simplemente invoca el constructor sin parámetros de la
clase base directa. Si la clase es abstracta, se protege la accesibilidad declarada para el
constructor predeterminado. De lo contrario, la accesibilidad declarada para el
constructor predeterminado es Public. Por lo tanto, el constructor predeterminado
siempre tiene el formato
 C#

protected C(): base() {}

or

C#

public C(): base() {}

donde C es el nombre de la clase. Si la resolución de sobrecarga no puede determinar

un mejor candidato único para el inicializador de constructor de clase base, se produce
un error en tiempo de compilación.

En el ejemplo

C#

class Message

object sender;

string text;

se proporciona un constructor predeterminado porque la clase no contiene ninguna

declaración de constructor de instancia. Por lo tanto, el ejemplo es exactamente
equivalente a

C#

class Message

object sender;

string text;

public Message(): base() {}

Constructores privados
Cuando una clase T declara solo constructores de instancia privados, no es posible que
las clases fuera del texto del programa de T deriven de T o creen directamente
instancias de T . Por lo tanto, si una clase solo contiene miembros estáticos y no está
pensado para que se creen instancias, agregar un constructor de instancia privado vacío
impedirá la creación de instancias. Por ejemplo:

C#

public class Trig

private Trig() {} // Prevent instantiation

public const double PI = 3.14159265358979323846;

public static double Sin(double x) {...}

public static double Cos(double x) {...}

public static double Tan(double x) {...}

La Trig clase agrupa los métodos relacionados y las constantes, pero no está previsto
que se creen instancias de ellos. Por lo tanto, declara un único constructor de instancia
privado vacío. Se debe declarar al menos un constructor de instancia para suprimir la
generación automática de un constructor predeterminado.

Parámetros de constructor de instancia opcionales

La this(...) forma de inicializador de constructor se utiliza normalmente junto con la
sobrecarga para implementar parámetros de constructor de instancia opcionales. En el
ejemplo

C#

class Text

public Text(): this(0, 0, null) {}

public Text(int x, int y): this(x, y, null) {}

public Text(int x, int y, string s) {

// Actual constructor implementation

los dos primeros constructores de instancia simplemente proporcionan los valores

predeterminados para los argumentos que faltan. Ambos usan un this(...)
inicializador de constructor para invocar el tercer constructor de instancia, que
realmente realiza el trabajo de inicializar la nueva instancia. El efecto es el de los
parámetros de constructor opcionales:
 C#

Text t1 = new Text(); // Same as Text(0, 0, null)

Text t2 = new Text(5, 10); // Same as Text(5, 10, null)

Text t3 = new Text(5, 20, "Hello");

Constructores estáticos
Un *constructor estático _ es un miembro que implementa las acciones necesarias para
inicializar un tipo de clase cerrada. Los constructores estáticos se declaran mediante
_static_constructor_declaration * s:

antlr

static_constructor_declaration

: attributes? static_constructor_modifiers identifier '(' ')'

static_constructor_body

static_constructor_modifiers

: 'extern'? 'static'

| 'static' 'extern'?

| static_constructor_modifiers_unsafe

static_constructor_body

: block

| ';'

Un static_constructor_declaration puede incluir un conjunto de atributos (atributos) y un

extern modificador (métodos externos).

El identificador de un static_constructor_declaration debe nombrar la clase en la que se

declara el constructor estático. Si se especifica cualquier otro nombre, se produce un
error en tiempo de compilación.

Cuando una declaración de constructor estático incluye un extern modificador, se dice

que el constructor estático es un *constructor estático externo _. Dado que una
declaración de constructor estático externo no proporciona ninguna implementación
real, su _static_constructor_body * consta de un punto y coma. Para todas las demás
declaraciones de constructores estáticos, la static_constructor_body está formada por un
bloque que especifica las instrucciones que se ejecutan para inicializar la clase. Esto se
corresponde exactamente con la method_body de un método estático con un void tipo
de valor devuelto (cuerpo del método).
Los constructores estáticos no se heredan y no se pueden llamar directamente.

El constructor estático de un tipo de clase cerrada se ejecuta como máximo una vez en
un dominio de aplicación determinado. La ejecución de un constructor estático lo
desencadena el primero de los siguientes eventos para que se produzca dentro de un
dominio de aplicación:

Se crea una instancia del tipo de clase.

Se hace referencia a cualquiera de los miembros estáticos del tipo de clase.

Si una clase contiene el Main método (Iniciode la aplicación) en el que comienza la

ejecución, el constructor estático de esa clase se ejecuta antes de que Main se llame al
método.

Para inicializar un nuevo tipo de clase cerrada, primero se crea un nuevo conjunto de
campos estáticos (campos estáticos y de instancia) para ese tipo cerrado en particular.
Cada uno de los campos estáticos se inicializa en su valor predeterminado (valores
predeterminados). A continuación, se ejecutan los inicializadores de campo estáticos
(inicialización de campos estáticos) para esos campos estáticos. Por último, se ejecuta el
constructor estático.

En el ejemplo

C#

using System;

class Test

static void Main() {

A.F();

B.F();

class A

static A() {

Console.WriteLine("Init A");

public static void F() {

Console.WriteLine("A.F");
}

class B

static B() {

Console.WriteLine("Init B");

public static void F() {

Console.WriteLine("B.F");
}

debe generar la salida:

Consola

Init A

A.F

Init B

B.F

Dado que la A llamada a desencadena la ejecución del constructor estático de A.F , y la

B llamada a desencadena la ejecución del constructor estático de B.F .

Es posible crear dependencias circulares que permitan observar los campos estáticos
con inicializadores variables en su estado de valor predeterminado.

En el ejemplo

C#

using System;

class A

public static int X;

static A() {

X = B.Y + 1;

class B

public static int Y = A.X + 1;

static B() {}

static void Main() {

Console.WriteLine("X = {0}, Y = {1}", A.X, B.Y);

genera el resultado
 Consola

X = 1, Y = 2

Para ejecutar el Main método, el sistema primero ejecuta el inicializador para B.Y , antes
B del constructor estático de la clase. Y el inicializador de hace que A el constructor

estático de se ejecute porque A.X se hace referencia al valor de. El constructor estático
de   A a su vez continúa para calcular el valor de   X y, al hacerlo, recupera el valor
predeterminado de   Y , que es cero. A.X por tanto, se inicializa en 1. El proceso de
ejecución de los A inicializadores de campo estáticos y del constructor estático se
completa y vuelve al cálculo del valor inicial   Y de, cuyo resultado es 2.

Dado que el constructor estático se ejecuta exactamente una vez para cada tipo de clase
construido cerrado, es un lugar cómodo para aplicar comprobaciones en tiempo de
ejecución en el parámetro de tipo que no se puede comprobar en tiempo de
compilación a través de restricciones (restricciones de parámetros de tipo). Por ejemplo,
el tipo siguiente usa un constructor estático para exigir que el argumento de tipo sea
una enumeración:

C#

class Gen<T> where T: struct

static Gen() {

if (!typeof(T).IsEnum) {

throw new ArgumentException("T must be an enum");

Destructores
Un *destructor _ es un miembro que implementa las acciones necesarias para destruir
una instancia de una clase. Un destructor se declara mediante una
_destructor_declaration *:

antlr

destructor_declaration

: attributes? 'extern'? '~' identifier '(' ')' destructor_body

| destructor_declaration_unsafe

destructor_body

 : block

| ';'

Un destructor_declaration puede incluir un conjunto de atributos (atributos).

El identificador de un destructor_declaration debe nombrar la clase en la que se declara

el destructor. Si se especifica cualquier otro nombre, se produce un error en tiempo de
compilación.

Cuando una declaración de destructor incluye un extern modificador, el destructor se

dice que es un *destructor externo _. Dado que una declaración de destructor externo
no proporciona ninguna implementación real, su _destructor_body * consta de un punto
y coma. En el caso de todos los demás destructores, el destructor_body consta de un
bloque que especifica las instrucciones que se van a ejecutar para destruir una instancia
de la clase. Un destructor_body corresponde exactamente al method_body de un método
de instancia con un void tipo de valor devuelto (cuerpo del método).

Los destructores no se heredan. Por lo tanto, una clase no tiene ningún destructor que
no sea el que se puede declarar en esa clase.

Dado que un destructor debe tener ningún parámetro, no se puede sobrecargar, por lo
que una clase puede tener, como máximo, un destructor.

Los destructores se invocan automáticamente y no se pueden invocar explícitamente.

Una instancia pasa a ser válida para su destrucción cuando ya no es posible para
cualquier código utilizar esa instancia. La ejecución del destructor para la instancia
puede producirse en cualquier momento después de que la instancia sea válida para la
destrucción. Cuando se destruye una instancia, se llama a los destructores de la cadena
de herencia de la instancia, en orden, de la más derivada a la menos derivada. Se puede
ejecutar un destructor en cualquier subproceso. Para obtener más información sobre las
reglas que rigen cuándo y cómo se ejecuta un destructor, consulte Administración
automáticade la memoria.

La salida del ejemplo

C#

using System;

class A

~A() {

Console.WriteLine("A's destructor");

 class B: A

~B() {

Console.WriteLine("B's destructor");

class Test

static void Main() {

B b = new B();

b = null;

GC.Collect();

GC.WaitForPendingFinalizers();

is

B's destructor

A's destructor

Dado que se llama a los destructores en una cadena de herencia en orden, desde la más
derivada hasta la menos derivada.

Los destructores se implementan invalidando el método virtual Finalize en

System.Object . Los programas de C# no pueden invalidar este método ni llamarlo (o

invalidarlo) directamente. Por ejemplo, el programa

C#

class A

override protected void Finalize() {} // error

public void F() {

this.Finalize(); // error

contiene dos errores.

El compilador se comporta como si este método, y los reemplaza, no existen en

absoluto. Por lo tanto, este programa:
 C#

class A

void Finalize() {} // permitted

es válido y el método mostrado oculta el System.Object método de Finalize .

Para obtener una explicación del comportamiento cuando se produce una excepción
desde un destructor, vea cómo se controlan las excepciones.

Iterators
Un miembro de función (miembros de función) implementado mediante un bloque de
iteradores (bloques) se denomina iterador.

Un bloque de iterador se puede usar como cuerpo de un miembro de función siempre

que el tipo de valor devuelto del miembro de función correspondiente sea una de las
interfaces de enumerador (interfaces de enumerador) o una de las interfaces
enumerables (interfaces enumerables). Puede producirse como method_body,
operator_body o accessor_body, mientras que los eventos, constructores de instancias,
constructores estáticos y destructores no se pueden implementar como iteradores.

Cuando un miembro de función se implementa mediante un bloque de iteradores, se

trata de un error en tiempo de compilación para que la lista de parámetros formales del
miembro de función especifique cualquier ref out parámetro o.

Interfaces de enumerador
Las interfaces de enumerador son la interfaz no genérica
System.Collections.IEnumerator y todas las creaciones de instancias de la interfaz
genérica System.Collections.Generic.IEnumerator<T> . Por motivos de brevedad, en
este capítulo se hace referencia a estas interfaces como IEnumerator y IEnumerator<T> ,
respectivamente.

Interfaces enumerables
Las interfaces enumerables son la interfaz no genérica System.Collections.IEnumerable
y todas las creaciones de instancias de la interfaz genérica
System.Collections.Generic.IEnumerable<T> . Por motivos de brevedad, en este capítulo
se hace referencia a estas interfaces como IEnumerable y IEnumerable<T> ,
respectivamente.

Tipo yield
Un iterador genera una secuencia de valores, todo el mismo tipo. Este tipo se denomina
tipo yield del iterador.

El tipo yield de un iterador que devuelve IEnumerator o IEnumerable es object .

El tipo yield de un iterador que devuelve IEnumerator<T> o IEnumerable<T> es T .

Objetos Enumerator
Cuando un miembro de función que devuelve un tipo de interfaz de enumerador se
implementa mediante un bloque de iteradores, al invocar al miembro de función no se
ejecuta inmediatamente el código en el bloque de iteradores. En su lugar, se crea y se
devuelve un objeto de enumerador . Este objeto encapsula el código especificado en el
bloque de iteradores y la ejecución del código en el bloque de iterador se produce
cuando se invoca el método del objeto de enumerador MoveNext . Un objeto de
enumerador tiene las siguientes características:

Implementa IEnumerator y IEnumerator<T> , donde T es el tipo yield del iterador.

Implementa System.IDisposable .
Se inicializa con una copia de los valores de argumento (si existen) y el valor de
instancia pasado al miembro de función.
Tiene cuatro Estados posibles: *Before, Running, Suspended y After, y se encuentra
inicialmente en el estado _ *Before**.

Un objeto de enumerador suele ser una instancia de una clase de enumerador generada
por el compilador que encapsula el código en el bloque de iteradores e implementa las
interfaces del enumerador, pero otros métodos de implementación son posibles. Si el
compilador genera una clase de enumerador, esa clase se anidará, directa o
indirectamente, en la clase que contiene el miembro de función, tendrá accesibilidad
privada y tendrá un nombre reservado para uso del compilador (identificadores).

Un objeto de enumerador puede implementar más interfaces de las especificadas

anteriormente.

En las secciones siguientes se describe el comportamiento exacto de los MoveNext

Current miembros, y Dispose de IEnumerable las IEnumerable<T> implementaciones de

la interfaz y que proporciona un objeto de enumerador.

Tenga en cuenta que los objetos de enumerador no admiten el IEnumerator.Reset
método. Al invocar este método, System.NotSupportedException se produce una
excepción.

El método MoveNext
El MoveNext método de un objeto de enumerador encapsula el código de un bloque de
iteradores. Al invocar el MoveNext método, se ejecuta código en el bloque de iterador y
se establece la Current propiedad del objeto de enumerador según corresponda. La
acción precisa realizada por MoveNext depende del estado del objeto de enumerador
cuando MoveNext se invoca:

Si el estado del objeto de enumerador es anterior, al invocar MoveNext :

Cambia el estado a en ejecución.
Inicializa los parámetros (incluido this ) del bloque de iteradores en los valores
de argumento y el valor de instancia guardados cuando se inicializó el objeto
de enumerador.
Ejecuta el bloque de iterador desde el principio hasta que se interrumpe la
ejecución (como se describe a continuación).
Si el estado del objeto de enumerador se está ejecutando, no se especifica el
resultado de la invocación MoveNext .
Si el estado del objeto de enumerador es suspendido, al invocar MoveNext :
Cambia el estado a en ejecución.
Restaura los valores de todas las variables locales y los parámetros (incluido
este) en los valores guardados cuando la ejecución del bloque de iterador se
suspendió por última vez. Tenga en cuenta que el contenido de los objetos a los
que hacen referencia estas variables puede haber cambiado desde la llamada
anterior a MoveNext.
Reanuda la ejecución del bloque de iterador inmediatamente después de la
yield return instrucción que provocó la suspensión de la ejecución y continúa

hasta que se interrumpe la ejecución (como se describe a continuación).

Si el estado del objeto de enumerador es después de, la llamada a MoveNext
devuelve false .

Cuando MoveNext ejecuta el bloque de iterador, la ejecución se puede interrumpir de

cuatro maneras: mediante una yield return instrucción, mediante una yield break
instrucción, al encontrar el final del bloque de iterador y una excepción que se produce
y se propaga fuera del bloque de iterador.

Cuando yield return se encuentra una instrucción (la instrucción yield):

 La expresión dada en la instrucción se evalúa, se convierte implícitamente al
tipo Yield y se asigna a la Current propiedad del objeto enumerador.
Se suspende la ejecución del cuerpo del iterador. Se guardan los valores de
todas las variables locales y los parámetros (incluido this ), tal y como se
encuentra en la ubicación de esta yield return instrucción. Si la yield return
instrucción está dentro de uno o más try bloques, los finally bloques
asociados no se ejecutan en este momento.
El estado del objeto de enumerador se cambia a Suspended.
El MoveNext método vuelve true a su llamador, lo que indica que la iteración se
ha avanzado correctamente al valor siguiente.
Cuando yield break se encuentra una instrucción (la instrucción yield):
Si la yield break instrucción está dentro de uno o más try bloques, finally se
ejecutan los bloques asociados.
El estado del objeto de enumerador se cambia a después de.
El MoveNext método vuelve false a su llamador, lo que indica que la iteración
ha finalizado.
Cuando se encuentra el final del cuerpo del iterador:
El estado del objeto de enumerador se cambia a después de.
El MoveNext método vuelve false a su llamador, lo que indica que la iteración
ha finalizado.
Cuando se produce una excepción y se propaga fuera del bloque de iteradores:
finally La propagación de excepciones habrá ejecutado los bloques adecuados

en el cuerpo del iterador.

El estado del objeto de enumerador se cambia a después de.
La propagación de excepciones continúa hasta el autor de la llamada del
MoveNext método.

Propiedad actual

La propiedad de un objeto de enumerador Current se ve afectada por yield return las

instrucciones del bloque de iteradores.

Cuando un objeto de enumerador está en el estado *Suspended _, el valor de Current

es el valor establecido por la llamada anterior a MoveNext . Cuando un objeto de
enumerador está en los Estados Before, Running o _ *After**, el resultado del acceso
Current no se especifica.

En el caso de un iterador con un tipo de Yield distinto de object , el resultado del

acceso Current a través de la implementación del objeto de enumerador IEnumerable
se corresponde con Current el acceso a través de la implementación del objeto de
enumerador IEnumerator<T> y la conversión del resultado a object .

El método Dispose

El Dispose método se usa para limpiar la iteración y el objeto de enumerador se coloca

en el estado después .

Si el estado del objeto de enumerador es *Before _, al invocar se Dispose cambia

el estado a _ *después de * *.
Si el estado del objeto de enumerador se está ejecutando, no se especifica el
resultado de la invocación Dispose .
Si el estado del objeto de enumerador es suspendido, al invocar Dispose :
Cambia el estado a en ejecución.
Ejecuta cualquier bloque Finally como si la última instrucción ejecutada yield
return fuera una yield break instrucción. Si esto hace que se produzca una

excepción y se propague fuera del cuerpo del iterador, el estado del objeto de
enumerador se establece en después de y la excepción se propaga al llamador
del Dispose método.
Cambia el estado a después de.
Si el estado del objeto de enumerador es After, la invocación de Dispose no tiene
ningún efecto.

Objetos enumerables
Cuando un miembro de función que devuelve un tipo de interfaz enumerable se
implementa mediante un bloque de iteradores, al invocar al miembro de función no se
ejecuta inmediatamente el código en el bloque de iteradores. En su lugar, se crea y se
devuelve un objeto enumerable . El método del objeto enumerable GetEnumerator
devuelve un objeto de enumerador que encapsula el código especificado en el bloque
de iterador y la ejecución del código en el bloque de iterador se produce cuando se
invoca el método del objeto de enumerador MoveNext . Un objeto enumerable tiene las
siguientes características:

Implementa IEnumerable y IEnumerable<T> , donde T es el tipo yield del iterador.

Se inicializa con una copia de los valores de argumento (si existen) y el valor de
instancia pasado al miembro de función.

Un objeto enumerable es normalmente una instancia de una clase Enumerable

generada por el compilador que encapsula el código en el bloque de iteradores e
implementa las interfaces enumerables, pero otros métodos de implementación son
posibles. Si el compilador genera una clase Enumerable, esa clase se anidará, directa o
indirectamente, en la clase que contiene el miembro de función, tendrá accesibilidad
privada y tendrá un nombre reservado para uso del compilador (identificadores).

Un objeto enumerable puede implementar más interfaces de las especificadas

anteriormente. En concreto, un objeto enumerable también puede implementar
IEnumerator y IEnumerator<T> , lo que permite que sirva como un enumerador y un
enumerador. En ese tipo de implementación, la primera vez que se invoca el método de
un objeto enumerable GetEnumerator , se devuelve el propio objeto Enumerable. Las
siguientes invocaciones de la del objeto enumerable GetEnumerator , si las hay,
devuelven una copia del objeto Enumerable. Por lo tanto, cada enumerador devuelto
tiene su propio estado y los cambios en un enumerador no afectarán a otro.

El método GetEnumerator

Un objeto enumerable proporciona una implementación de los GetEnumerator métodos

de IEnumerable las IEnumerable<T> interfaces y. Los dos GetEnumerator métodos
comparten una implementación común que adquiere y devuelve un objeto de
enumerador disponible. El objeto de enumerador se inicializa con los valores de
argumento y el valor de instancia guardados cuando se inicializó el objeto enumerable,
pero de lo contrario el objeto de enumerador funciona como se describe en objetos de
enumerador.

Ejemplo de implementación
En esta sección se describe una posible implementación de iteradores en términos de
construcciones estándar de C#. La implementación que se describe aquí se basa en los
mismos principios utilizados por el compilador de Microsoft C#, pero no es una
implementación asignada o la única posible.

La Stack<T> clase siguiente implementa su GetEnumerator método mediante un

iterador. El iterador enumera los elementos de la pila en orden descendente.

C#

using System;

using System.Collections;

using System.Collections.Generic;

class Stack<T>: IEnumerable<T>

T[] items;

 int count;

public void Push(T item) {

if (items == null) {

items = new T[4];

else if (items.Length == count) {

T[] newItems = new T[count * 2];

Array.Copy(items, 0, newItems, 0, count);

items = newItems;

items[count++] = item;

public T Pop() {

T result = items[--count];

items[count] = default(T);

return result;

public IEnumerator<T> GetEnumerator() {

for (int i = count - 1; i >= 0; --i) yield return items[i];

El GetEnumerator método se puede traducir en una instancia de una clase de

enumerador generada por el compilador que encapsula el código en el bloque de
iteradores, como se muestra a continuación.

C#

class Stack<T>: IEnumerable<T>

...

public IEnumerator<T> GetEnumerator() {

return new __Enumerator1(this);

class __Enumerator1: IEnumerator<T>, IEnumerator

int __state;

T __current;

Stack<T> __this;

int i;

public __Enumerator1(Stack<T> __this) {

this.__this = __this;

public T Current {

get { return __current; }

object IEnumerator.Current {

get { return __current; }

public bool MoveNext() {

switch (__state) {

case 1: goto __state1;

case 2: goto __state2;

i = __this.count - 1;

__loop:

if (i < 0) goto __state2;

__current = __this.items[i];

__state = 1;

return true;

__state1:

--i;

goto __loop;

__state2:

__state = 2;

return false;

public void Dispose() {

__state = 2;

void IEnumerator.Reset() {

throw new NotSupportedException();

En la traducción anterior, el código del bloque de iterador se convierte en una máquina

de Estados y se coloca en el MoveNext método de la clase de enumerador. Además, la
variable local i se convierte en un campo en el objeto de enumerador para que pueda
seguir existiendo en las invocaciones de MoveNext .

En el ejemplo siguiente se imprime una tabla de multiplicación simple de los enteros

comprendidos entre 1 y 10. El FromTo método en el ejemplo devuelve un objeto
enumerable y se implementa mediante un iterador.

C#

using System;

using System.Collections.Generic;

class Test

 static IEnumerable<int> FromTo(int from, int to) {

while (from <= to) yield return from++;

static void Main() {

IEnumerable<int> e = FromTo(1, 10);

foreach (int x in e) {

foreach (int y in e) {

Console.Write("{0,3} ", x * y);

Console.WriteLine();

El FromTo método se puede traducir en una instancia de una clase Enumerable generada
por el compilador que encapsula el código en el bloque de iteradores, como se muestra
a continuación.

C#

using System;

using System.Threading;

using System.Collections;

using System.Collections.Generic;

class Test

...

static IEnumerable<int> FromTo(int from, int to) {

return new __Enumerable1(from, to);

class __Enumerable1:

IEnumerable<int>, IEnumerable,

IEnumerator<int>, IEnumerator

int __state;

int __current;

int __from;

int from;

int to;

int i;

public __Enumerable1(int __from, int to) {

this.__from = __from;

this.to = to;

public IEnumerator<int> GetEnumerator() {

__Enumerable1 result = this;

 if (Interlocked.CompareExchange(ref __state, 1, 0) != 0) {

result = new __Enumerable1(__from, to);

result.__state = 1;

result.from = result.__from;

return result;

IEnumerator IEnumerable.GetEnumerator() {

return (IEnumerator)GetEnumerator();

public int Current {

get { return __current; }

object IEnumerator.Current {

get { return __current; }

public bool MoveNext() {

switch (__state) {

case 1:

if (from > to) goto case 2;

__current = from++;

__state = 1;

return true;

case 2:

__state = 2;

return false;

default:

throw new InvalidOperationException();

public void Dispose() {

__state = 2;

void IEnumerator.Reset() {

throw new NotSupportedException();

La clase Enumerable implementa las interfaces enumerables y las interfaces de

enumerador, lo que permite que sirva como un enumerador y un enumerador. La
primera vez que GetEnumerator se invoca el método, se devuelve el propio objeto
Enumerable. Las siguientes invocaciones de la del objeto enumerable GetEnumerator , si
las hay, devuelven una copia del objeto Enumerable. Por lo tanto, cada enumerador
devuelto tiene su propio estado y los cambios en un enumerador no afectarán a otro. El
Interlocked.CompareExchange método se usa para garantizar la operación segura para

subprocesos.

Los from to parámetros y se convierten en campos en la clase Enumerable. Dado from

que se modifica en el bloque de iterador, __from se introduce un campo adicional para
contener el valor inicial dado a from en cada enumerador.

El MoveNext método produce una excepción InvalidOperationException si se llama

cuando __state es 0 . Esto protege contra el uso del objeto enumerable como un
objeto de enumerador sin llamar primero a GetEnumerator .

En el ejemplo siguiente se muestra una clase de árbol simple. La Tree<T> clase

implementa su GetEnumerator método mediante un iterador. El iterador enumera los
elementos del árbol en orden infijo.

C#

using System;

using System.Collections.Generic;

class Tree<T>: IEnumerable<T>

T value;

Tree<T> left;

Tree<T> right;

public Tree(T value, Tree<T> left, Tree<T> right) {

this.value = value;

this.left = left;

this.right = right;

public IEnumerator<T> GetEnumerator() {

if (left != null) foreach (T x in left) yield x;

yield value;

if (right != null) foreach (T x in right) yield x;

class Program

static Tree<T> MakeTree<T>(T[] items, int left, int right) {

if (left > right) return null;

int i = (left + right) / 2;

return new Tree<T>(items[i],

MakeTree(items, left, i - 1),

MakeTree(items, i + 1, right));

static Tree<T> MakeTree<T>(params T[] items) {

 return MakeTree(items, 0, items.Length - 1);

// The output of the program is:

// 1 2 3 4 5 6 7 8 9

// Mon Tue Wed Thu Fri Sat Sun

static void Main() {

Tree<int> ints = MakeTree(1, 2, 3, 4, 5, 6, 7, 8, 9);

foreach (int i in ints) Console.Write("{0} ", i);

Console.WriteLine();

Tree<string> strings = MakeTree(

"Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun");

foreach (string s in strings) Console.Write("{0} ", s);

Console.WriteLine();

El GetEnumerator método se puede traducir en una instancia de una clase de

enumerador generada por el compilador que encapsula el código en el bloque de
iteradores, como se muestra a continuación.

C#

class Tree<T>: IEnumerable<T>

...

public IEnumerator<T> GetEnumerator() {

return new __Enumerator1(this);

class __Enumerator1 : IEnumerator<T>, IEnumerator

Node<T> __this;

IEnumerator<T> __left, __right;

int __state;

T __current;

public __Enumerator1(Node<T> __this) {

this.__this = __this;

public T Current {

get { return __current; }

object IEnumerator.Current {

get { return __current; }

public bool MoveNext() {

try {

switch (__state) {

case 0:
__state = -1;

if (__this.left == null) goto __yield_value;

__left = __this.left.GetEnumerator();

goto case 1;

case 1:
__state = -2;

if (!__left.MoveNext()) goto __left_dispose;

__current = __left.Current;

__state = 1;

return true;

__left_dispose:

__state = -1;

__left.Dispose();

__yield_value:

__current = __this.value;

__state = 2;

return true;

case 2:
__state = -1;

if (__this.right == null) goto __end;

__right = __this.right.GetEnumerator();

goto case 3;

case 3:
__state = -3;

if (!__right.MoveNext()) goto __right_dispose;

__current = __right.Current;

__state = 3;

return true;

__right_dispose:

__state = -1;

__right.Dispose();

__end:

__state = 4;

break;

finally {

if (__state < 0) Dispose();

return false;

 public void Dispose() {

try {

switch (__state) {

case 1:
case -2:

__left.Dispose();

break;

case 3:
case -3:

__right.Dispose();

break;

finally {

__state = 4;

void IEnumerator.Reset() {

throw new NotSupportedException();

El compilador generado objetos temporales utilizado en las foreach instrucciones se

eleva en __left los __right campos y del objeto de enumerador. El __state campo del
objeto de enumerador se actualiza cuidadosamente para que se Dispose() llame
correctamente al método correcto si se produce una excepción. Tenga en cuenta que no
es posible escribir el código traducido con foreach instrucciones sencillas.

Funciones asincrónicas
Un método (métodos) o una función anónima (expresiones de función anónima) con el
async modificador se denomina *Async function _. En general, el término _ Async* se
usa para describir cualquier tipo de función que tenga el async modificador.

Es un error en tiempo de compilación para que la lista de parámetros formales de una

función asincrónica especifique cualquier ref out parámetro o.

El return_type de un método asincrónico debe ser void o un tipo de tarea. Los tipos de
tarea son System.Threading.Tasks.Task y los tipos construidos a partir de
System.Threading.Tasks.Task<T> . Por motivos de brevedad, en este capítulo se hace
referencia a estos tipos como Task y Task<T> , respectivamente. Se dice que un método
asincrónico que devuelve un tipo de tarea es el que devuelve la tarea.

La definición exacta de los tipos de tarea es la implementación definida, pero desde el

punto de vista del idioma, un tipo de tarea se encuentra en uno de los Estados
incompleto, correcto o erróneo. Una tarea con errores registra una excepción
pertinente. Una correcta Task<T> registra un resultado de tipo T . Los tipos de tarea son
de espera y, por tanto, pueden ser los operandos de las expresiones Await (expresiones
Await).

Una invocación de función asincrónica tiene la capacidad de suspender la evaluación

por medio de expresiones Await (expresiones Await) en su cuerpo. La evaluación se
puede reanudar más adelante en el punto de la expresión Await de suspensión a través
de un delegado * reanudación _. El delegado de reanudación es de tipo System.Action
y, cuando se invoca, la evaluación de la invocación de la función asincrónica se
reanudará desde la expresión Await en la que se quedó. La llamada al llamador actual*
de una invocación de función asincrónica es el autor de la llamada original si la
invocación de la función nunca se ha suspendido o el autor de la llamada más reciente
del delegado de reanudación en caso contrario.

Evaluación de una función asincrónica que devuelve una

tarea
La invocación de una función asincrónica que devuelve una tarea hace que se genere
una instancia del tipo de tarea devuelto. Esto se denomina la tarea devuelta de la
función Async. La tarea está inicialmente en un estado incompleto.

A continuación, se evalúa el cuerpo de la función asincrónica hasta que se suspenda (al

llegar a una expresión Await) o finalice, donde el control de punto se devuelve al autor
de la llamada, junto con la tarea devuelta.

Cuando finaliza el cuerpo de la función asincrónica, la tarea devuelta se saca del estado
incompleto:

Si el cuerpo de la función finaliza como resultado de alcanzar una instrucción

return o el final del cuerpo, se registra cualquier valor de resultado en la tarea
devuelta, que se pone en un estado correcto.
Si el cuerpo de la función finaliza como resultado de una excepción no detectada
(la instrucción throw), la excepción se registra en la tarea devuelta que se coloca en
un estado de error.
Evaluación de una función asincrónica que devuelve void
Si el tipo de valor devuelto de la función Async es void , la evaluación difiere de la
anterior de la siguiente manera: dado que no se devuelve ninguna tarea, la función
comunica en su lugar la finalización y las excepciones al contexto de sincronización del
subproceso actual. La definición exacta del contexto de sincronización depende de la
implementación, pero es una representación de "Dónde" se está ejecutando el
subproceso actual. El contexto de sincronización se notifica cuando se inicia la
evaluación de una función asincrónica que devuelve void, se completa correctamente o
provoca que se produzca una excepción no detectada.

Esto permite que el contexto realice un seguimiento del número de funciones

asincrónicas que devuelven void que se están ejecutando en él y de decidir cómo
propagar las excepciones que salen de ellas.
Estructuras
Artículo • 16/09/2021 • Tiempo de lectura: 16 minutos

Las estructuras son similares a las clases en que representan las estructuras de datos
que pueden contener miembros de datos y miembros de función. Sin embargo, a
diferencia de las clases, las estructuras son tipos de valor y no requieren la asignación
del montón. Una variable de un tipo de estructura contiene directamente los datos del
struct, mientras que una variable de un tipo de clase contiene una referencia a los datos,
la última conocida como un objeto.

Los structs son particularmente útiles para estructuras de datos pequeñas que tengan
semánticas de valor. Los números complejos, los puntos de un sistema de coordenadas
o los pares clave-valor de un diccionario son buenos ejemplos de structs. La clave de
estas estructuras de datos es que tienen pocos miembros de datos, que no requieren el
uso de la herencia o la identidad referencial, y que se pueden implementar de forma
cómoda mediante la semántica de valores donde la asignación copia el valor en lugar
de la referencia.

Como se describe en tipos simples, los tipos simples proporcionados por C#, como int
, double y bool , son en realidad todos los tipos de estructura. Del mismo modo que
estos tipos predefinidos son Structs, también es posible usar estructuras y sobrecarga
de operadores para implementar nuevos tipos "primitivos" en el lenguaje C#. Al final de
este capítulo (ejemplos de struct) se proporcionan dos ejemplos de estos tipos.

Declaraciones de estructuras
Una struct_declaration es una type_declaration (declaraciones de tipos) que declara un
nuevo struct:

antlr

struct_declaration

: attributes? struct_modifier* 'partial'? 'struct' identifier

type_parameter_list?

struct_interfaces? type_parameter_constraints_clause* struct_body ';'?

Un struct_declaration consta de un conjunto opcional de atributos (atributos), seguido

de un conjunto opcional de struct_modifier s (modificadores de struct). seguido de un
partial modificador opcional, seguido de la palabra clave struct y un identificador que

nombra el struct, seguido de una especificación de type_parameter_list opcional

(parámetros de tipo), seguida de una especificación de struct_interfaces opcional
(modificador parcial)), seguida de una especificación de
type_parameter_constraints_clause s opcional (restricciones de parámetro de tipo),
seguida de un struct_body (cuerpo de estructura), opcionalmente seguido de un punto y

Modificadores de struct
Un struct_declaration puede incluir opcionalmente una secuencia de modificadores de
struct:

antlr

struct_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| struct_modifier_unsafe

Es un error en tiempo de compilación que el mismo modificador aparezca varias veces

en una declaración de estructura.

Los modificadores de una declaración de struct tienen el mismo significado que los de
una declaración de clase (declaraciones de clase).

Unmodifier (modificador)
El partial modificador indica que este struct_declaration es una declaración de tipos
parciales. Varias declaraciones de struct parciales con el mismo nombre dentro de una
declaración de tipo o espacio de nombres envolvente se combinan para formar una
declaración de struct, siguiendo las reglas especificadas en tipos parciales.

Interfaces de struct
Una declaración de estructura puede incluir una especificación de struct_interfaces , en
cuyo caso se dice que el struct implementa directamente los tipos de interfaz
especificados.

antlr

struct_interfaces

: ':' interface_type_list

Las implementaciones de interfaz se tratan en las implementaciones de interfaz.

Cuerpo del struct

El struct_body de un struct define los miembros del struct.

antlr

struct_body

: '{' struct_member_declaration* '}'

Miembros de estructuras
Los miembros de una estructura se componen de los miembros introducidos por su
struct_member_declaration s y los miembros heredados del tipo System.ValueType .

antlr

struct_member_declaration

: constant_declaration

| field_declaration

| method_declaration

| property_declaration

| event_declaration

| indexer_declaration

| operator_declaration

| constructor_declaration

| static_constructor_declaration

| type_declaration

| struct_member_declaration_unsafe

A excepción de las diferencias que se indican en diferencias entre clases y estructuras,

las descripciones de los miembros de clase proporcionados en miembros de clase a
través de funciones asincrónicas también se aplican a los miembros de estructura.

Diferencias entre clases y estructuras

Los Structs difieren de las clases de varias maneras importantes:

Los Structs son tipos de valor (semántica de valores).

 Todos los tipos de struct se heredan implícitamente de la clase System.ValueType
(herencia).
La asignación a una variable de un tipo de struct crea una copia del valor que se
asigna (asignación).
El valor predeterminado de un struct es el valor generado al establecer todos los
campos de tipo de valor en sus valores predeterminados y todos los campos de
tipo de referencia en null (valores predeterminados).
Las operaciones de conversión boxing y unboxing se utilizan para realizar la
conversión entre un tipo de estructura y object (conversión boxing y conversión
unboxing).
El significado de this es diferente para los Structs (este acceso).
Las declaraciones de campo de instancia de un struct no pueden incluir
inicializadores variables (inicializadores de campo).
Un struct no puede declarar un constructor de instancia sin parámetros
(constructores).
Un struct no puede declarar undestructor (destructores).

Semántica de valores
Los Structs son tipos de valor (tipos de valor) y se dice que tienen semántica de valor.
Por otro lado, las clases son tipos de referencia (tipos de referencia) y se dice que tienen
semántica de referencia.

Una variable de un tipo de estructura contiene directamente los datos del struct,
mientras que una variable de un tipo de clase contiene una referencia a los datos, la
última conocida como un objeto. Cuando un struct B contiene un campo de instancia
de tipo A y A es un tipo de estructura, es un error en tiempo de compilación para A
que dependa de B o un tipo construido a partir de B . Un struct X * depende
directamente de _ un struct Y si X contiene un campo de instancia de tipo Y . Dada
esta definición, el conjunto completo de estructuras de las que depende un struct es el
cierre transitivo de la *función _ depende directamente de**. Por ejemplo

C#

struct Node

int data;

Node next; // error, Node directly depends on itself

es un error porque Node contiene un campo de instancia de su propio tipo. Otro ejemplo
 C#

struct A { B b; }

struct B { C c; }

struct C { A a; }

es un error porque cada uno de los tipos A , B y C dependen entre sí.

Con las clases, es posible que dos variables hagan referencia al mismo objeto y, por lo
tanto, las operaciones en una variable afecten al objeto al que hace referencia la otra
variable. Con las estructuras, cada variable tiene su propia copia de los datos (excepto
en el caso de ref out las variables de parámetro y), y no es posible que las operaciones
en una afecten a la otra. Además, dado que los Structs no son tipos de referencia, no es
posible que los valores de un tipo struct sea null .

Dada la declaración

C#

struct Point

public int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

fragmento de código

C#

Point a = new Point(10, 10);

Point b = a;

a.x = 100;

System.Console.WriteLine(b.x);

genera el valor 10 . La asignación de a para b crea una copia del valor y, b por tanto,
no se ve afectada por la asignación a a.x . Point En su lugar se ha declarado como una
clase, el resultado sería 100 porque a y b haría referencia al mismo objeto.

Herencia
Todos los tipos de struct se heredan implícitamente de la clase System.ValueType , que,
a su vez, hereda de la clase object . Una declaración de estructura puede especificar
una lista de interfaces implementadas, pero no es posible que una declaración de struct
especifique una clase base.

Los tipos de struct nunca son abstractos y siempre están sellados implícitamente.
abstract sealed Por lo tanto, los modificadores y no se permiten en una declaración de

estructura.

Puesto que no se admite la herencia para los Structs, la accesibilidad declarada de un

miembro de struct no puede ser protected ni protected internal .

Los miembros de función de un struct no pueden ser abstract o virtual , y el

override modificador solo se permite para invalidar métodos heredados de

System.ValueType .

Asignación
La asignación a una variable de un tipo de struct crea una copia del valor que se va a
asignar. Esto difiere de la asignación a una variable de un tipo de clase, que copia la
referencia pero no el objeto identificado por la referencia.

De forma similar a una asignación, cuando se pasa un struct como parámetro de valor o
se devuelve como resultado de un miembro de función, se crea una copia de la
estructura. Un struct se puede pasar por referencia a un miembro de función mediante
ref un out parámetro o.

Cuando una propiedad o un indizador de una estructura es el destino de una

asignación, la expresión de instancia asociada con el acceso a la propiedad o indizador
debe estar clasificada como una variable. Si la expresión de instancia se clasifica como
un valor, se produce un error en tiempo de compilación. Esto se describe con más
detalle en asignación simple.

Valores predeterminados
Tal y como se describe en valores predeterminados, varios tipos de variables se
inicializan automáticamente en su valor predeterminado cuando se crean. En el caso de
las variables de tipos de clase y otros tipos de referencia, este valor predeterminado es
null . Sin embargo, dado que los Structs son tipos de valor que no pueden ser null , el
valor predeterminado de un struct es el valor generado al establecer todos los campos
de tipo de valor en sus valores predeterminados y todos los campos de tipo de
referencia en null .

En el ejemplo se hace referencia al Point struct declarado anteriormente.

C#

Point[] a = new Point[100];

Inicializa cada Point de la matriz con el valor generado al establecer los x campos y y
en cero.

El valor predeterminado de un struct corresponde al valor devuelto por el constructor

predeterminado de la estructura (constructores predeterminados). A diferencia de una
clase, un struct no puede declarar un constructor de instancia sin parámetros. En su
lugar, cada struct tiene implícitamente un constructor de instancia sin parámetros que
siempre devuelve el valor que se obtiene al establecer todos los campos de tipo de
valor en sus valores predeterminados y todos los campos de tipo de referencia en null .

Los Structs se deben diseñar para considerar el estado de inicialización predeterminado

como un estado válido. En el ejemplo

C#

using System;

struct KeyValuePair

string key;

string value;

public KeyValuePair(string key, string value) {

if (key == null || value == null) throw new ArgumentException();

this.key = key;

this.value = value;

el constructor de instancia definido por el usuario protege solo los valores NULL cuando
se llama explícitamente. En los casos en KeyValuePair los que una variable está sujeta a
la inicialización de valores predeterminados, los key campos y serán value null y el
struct debe estar preparado para controlar este estado.

Conversiones boxing y unboxing

Un valor de un tipo de clase se puede convertir al tipo object o a un tipo de interfaz
implementado por la clase simplemente tratando la referencia como otro tipo en
tiempo de compilación. Del mismo modo, un valor de tipo object o un valor de un tipo
de interfaz se puede volver a convertir a un tipo de clase sin cambiar la referencia (pero,
por supuesto, se requiere una comprobación de tipo en tiempo de ejecución en este
caso).

Dado que los Structs no son tipos de referencia, estas operaciones se implementan de
forma diferente para los tipos de struct. Cuando un valor de un tipo de estructura se
convierte al tipo object o a un tipo de interfaz implementado por el struct, se produce
una operación de conversión boxing. Del mismo modo, cuando un valor de tipo object
o un valor de un tipo de interfaz se vuelve a convertir a un tipo de estructura, se
produce una operación de conversión unboxing. Una diferencia clave de las mismas
operaciones en los tipos de clase es que la conversión boxing y la conversión unboxing
copia el valor de la estructura dentro o fuera de la instancia de conversión boxing. Por lo
tanto, después de una operación de conversión boxing o unboxing, los cambios
realizados en la estructura desempaquetada no se reflejan en la estructura con
conversión boxing.

Cuando un tipo de struct invalida un método virtual heredado de System.Object (como

Equals , GetHashCode o ToString ), la invocación del método virtual a través de una
instancia del tipo struct no provoca la conversión boxing. Esto es así incluso cuando el
struct se utiliza como parámetro de tipo y la invocación se produce a través de una
instancia del tipo de parámetro de tipo. Por ejemplo:

C#

using System;

struct Counter

int value;

public override string ToString() {

value++;

return value.ToString();

class Program

static void Test<T>() where T: new() {

T x = new T();

Console.WriteLine(x.ToString());

Console.WriteLine(x.ToString());

Console.WriteLine(x.ToString());

static void Main() {

Test<Counter>();

La salida del programa es:

Consola

Aunque el estilo no válido para ToString tiene efectos secundarios, en el ejemplo se

muestra que no se ha producido ninguna conversión boxing para las tres invocaciones
de x.ToString() .

Del mismo modo, la conversión boxing nunca se produce implícitamente cuando se

obtiene acceso a un miembro en un parámetro de tipo restringido. Por ejemplo,
supongamos ICounter que una interfaz contiene un método Increment que se puede
utilizar para modificar un valor. Si ICounter se utiliza como una restricción, Increment se
llama a la implementación del método con una referencia a la variable a la que
Increment se llamó, nunca a una copia con conversión boxing.

C#

using System;

interface ICounter

void Increment();

struct Counter: ICounter

int value;

public override string ToString() {

return value.ToString();

void ICounter.Increment() {

value++;

class Program

static void Test<T>() where T: ICounter, new() {

T x = new T();

Console.WriteLine(x);

x.Increment(); // Modify x

Console.WriteLine(x);

((ICounter)x).Increment(); // Modify boxed copy of x

Console.WriteLine(x);

static void Main() {

Test<Counter>();

La primera llamada a Increment modifica el valor de la variable x . Esto no es

equivalente a la segunda llamada a Increment , que modifica el valor de una copia con
conversión boxing de x . Por lo tanto, la salida del programa es:

Consola

Para obtener más información sobre las conversiones boxing y unboxing, consulte
Boxing y unboxing.

Significado de este
Dentro de un constructor de instancia o un miembro de función de instancia de una
clase, this se clasifica como un valor. Por lo tanto, aunque se this puede usar para
hacer referencia a la instancia de a la que se invocó el miembro de función, no es
posible asignar a this en un miembro de función de una clase.

Dentro de un constructor de instancia de un struct, this corresponde a un out

parámetro del tipo de estructura y dentro de un miembro de función de instancia de un
struct, this corresponde a un ref parámetro del tipo de estructura. En ambos casos,
this se clasifica como una variable y es posible modificar la estructura completa para la
que se invocó el miembro de la función mediante la asignación a this o pasando esto
como un ref out parámetro o.

Inicializadores de campo
Como se describe en valores predeterminados, el valor predeterminado de un struct
consta del valor que se obtiene al establecer todos los campos de tipo de valor en sus
valores predeterminados y todos los campos de tipo de referencia en null . Por esta
razón, un struct no permite que las declaraciones de campo de instancia incluyan
inicializadores variables. Esta restricción solo se aplica a los campos de instancia. Los
campos estáticos de un struct pueden incluir inicializadores variables.

En el ejemplo

C#

struct Point

public int x = 1; // Error, initializer not permitted

public int y = 1; // Error, initializer not permitted

es un error porque las declaraciones de campo de instancia incluyen inicializadores

variables.

Constructores
A diferencia de una clase, un struct no puede declarar un constructor de instancia sin
parámetros. En su lugar, cada struct tiene implícitamente un constructor de instancia sin
parámetros que siempre devuelve el valor que se obtiene al establecer todos los
campos de tipo de valor en sus valores predeterminados y todos los campos de tipo de
referencia en null (constructores predeterminados). Un struct puede declarar
constructores de instancia que tengan parámetros. Por ejemplo

C#

struct Point

int x, y;

public Point(int x, int y) {

this.x = x;

this.y = y;

Dada la declaración anterior, las instrucciones

C#
 Point p1 = new Point();
Point p2 = new Point(0, 0);

ambos crean un Point con x y y se inicializan en cero.

Un constructor de instancia de struct no puede incluir un inicializador de constructor

con el formato base(...) .

Si el constructor de instancia de struct no especifica un inicializador de constructor, la

this variable corresponde a un out parámetro del tipo de estructura y, de forma similar

a un out parámetro, this se debe asignar definitivamente (asignación definitiva) en

cada ubicación en la que el constructor vuelva. Si el constructor de instancia de struct
especifica un inicializador de constructor, la this variable corresponde a un ref
parámetro del tipo de estructura, y similar a un ref parámetro, this se considera que
se asigna definitivamente en la entrada al cuerpo del constructor. Considere la
implementación del constructor de instancia a continuación:

C#

struct Point

int x, y;

public int X {

set { x = value; }

public int Y {

set { y = value; }

public Point(int x, int y) {

X = x; // error, this is not yet definitely assigned

Y = y; // error, this is not yet definitely assigned

No se puede llamar a ninguna función miembro de instancia (incluidos los descriptores

de acceso set para las propiedades X y Y ) hasta que todos los campos del struct que
se está construyendo se hayan asignado definitivamente. La única excepción implica las
propiedades implementadas automáticamente (propiedades implementadas
automáticamente). Las reglas de asignación definitiva (expresiones de asignación
simple) excluyen específicamente la asignación a una propiedad automática de un tipo
de estructura dentro de un constructor de instancia de ese tipo de estructura: una
asignación se considera una asignación definitiva del campo oculto de respaldo de la
propiedad automática. Por lo tanto, se permite lo siguiente:

C#

struct Point

public int X { get; set; }

public int Y { get; set; }

public Point(int x, int y) {

X = x; // allowed, definitely assigns backing field

Y = y; // allowed, definitely assigns backing field

Destructores
Un struct no puede declarar un destructor.

Constructores estáticos
Los constructores estáticos para Structs siguen la mayoría de las mismas reglas que para
las clases. La ejecución de un constructor estático para un tipo de struct lo desencadena
el primero de los siguientes eventos para que se produzca dentro de un dominio de
aplicación:

Se hace referencia A un miembro estático del tipo struct.

Se llama a un constructor declarado explícitamente del tipo de estructura.

La creación de valores predeterminados (valores predeterminados) de tipos struct no

desencadena el constructor estático. (Un ejemplo de esto es el valor inicial de los
elementos de una matriz).

Ejemplos de estructuras
A continuación se muestran dos ejemplos importantes del uso de struct tipos para
crear tipos que se pueden usar de forma similar a los tipos predefinidos del lenguaje,
pero con semántica modificada.

Tipo entero de base de datos

El DBInt struct siguiente implementa un tipo entero que puede representar el conjunto
completo de valores del int tipo, además de un estado adicional que indica un valor
desconocido. Un tipo con estas características se utiliza normalmente en las bases de
datos.

C#

using System;

public struct DBInt

// The Null member represents an unknown DBInt value.

public static readonly DBInt Null = new DBInt();

// When the defined field is true, this DBInt represents a known value

// which is stored in the value field. When the defined field is false,

// this DBInt represents an unknown value, and the value field is 0.

int value;

bool defined;

// Private instance constructor. Creates a DBInt with a known value.

DBInt(int value) {

this.value = value;

this.defined = true;

// The IsNull property is true if this DBInt represents an unknown

value.

public bool IsNull { get { return !defined; } }

// The Value property is the known value of this DBInt, or 0 if this

// DBInt represents an unknown value.

public int Value { get { return value; } }

// Implicit conversion from int to DBInt.

public static implicit operator DBInt(int x) {

return new DBInt(x);

// Explicit conversion from DBInt to int. Throws an exception if the

// given DBInt represents an unknown value.

public static explicit operator int(DBInt x) {

if (!x.defined) throw new InvalidOperationException();

return x.value;
}

public static DBInt operator +(DBInt x) {

return x;

public static DBInt operator -(DBInt x) {

return x.defined ? -x.value : Null;

public static DBInt operator +(DBInt x, DBInt y) {

return x.defined && y.defined? x.value + y.value: Null;

public static DBInt operator -(DBInt x, DBInt y) {

return x.defined && y.defined? x.value - y.value: Null;

public static DBInt operator *(DBInt x, DBInt y) {

return x.defined && y.defined? x.value * y.value: Null;

public static DBInt operator /(DBInt x, DBInt y) {

return x.defined && y.defined? x.value / y.value: Null;

public static DBInt operator %(DBInt x, DBInt y) {

return x.defined && y.defined? x.value % y.value: Null;

public static DBBool operator ==(DBInt x, DBInt y) {

return x.defined && y.defined? x.value == y.value: DBBool.Null;

public static DBBool operator !=(DBInt x, DBInt y) {

return x.defined && y.defined? x.value != y.value: DBBool.Null;

public static DBBool operator >(DBInt x, DBInt y) {

return x.defined && y.defined? x.value > y.value: DBBool.Null;

public static DBBool operator <(DBInt x, DBInt y) {

return x.defined && y.defined? x.value < y.value: DBBool.Null;

public static DBBool operator >=(DBInt x, DBInt y) {

return x.defined && y.defined? x.value >= y.value: DBBool.Null;

public static DBBool operator <=(DBInt x, DBInt y) {

return x.defined && y.defined? x.value <= y.value: DBBool.Null;

public override bool Equals(object obj) {

if (!(obj is DBInt)) return false;

DBInt x = (DBInt)obj;

return value == x.value && defined == x.defined;

}

 public override int GetHashCode() {

return value;

public override string ToString() {

return defined? value.ToString(): "DBInt.Null";

Tipo booleano de base de datos

El DBBool struct siguiente implementa un tipo lógico de tres valores. Los valores
posibles de este tipo son DBBool.True , DBBool.False y DBBool.Null , donde el Null
miembro indica un valor desconocido. Estos tipos lógicos de tres valores se utilizan
normalmente en las bases de datos de.

C#

using System;

public struct DBBool

// The three possible DBBool values.

public static readonly DBBool Null = new DBBool(0);

public static readonly DBBool False = new DBBool(-1);

public static readonly DBBool True = new DBBool(1);

// Private field that stores -1, 0, 1 for False, Null, True.

sbyte value;

// Private instance constructor. The value parameter must be -1, 0, or

1.

DBBool(int value) {

this.value = (sbyte)value;

// Properties to examine the value of a DBBool. Return true if this

// DBBool has the given value, false otherwise.

public bool IsNull { get { return value == 0; } }

public bool IsFalse { get { return value < 0; } }

public bool IsTrue { get { return value > 0; } }

// Implicit conversion from bool to DBBool. Maps true to DBBool.True and

// false to DBBool.False.

 public static implicit operator DBBool(bool x) {

return x? True: False;

// Explicit conversion from DBBool to bool. Throws an exception if the

// given DBBool is Null, otherwise returns true or false.

public static explicit operator bool(DBBool x) {

if (x.value == 0) throw new InvalidOperationException();

return x.value > 0;

// Equality operator. Returns Null if either operand is Null, otherwise

// returns True or False.

public static DBBool operator ==(DBBool x, DBBool y) {

if (x.value == 0 || y.value == 0) return Null;

return x.value == y.value? True: False;

// Inequality operator. Returns Null if either operand is Null,

otherwise

// returns True or False.

public static DBBool operator !=(DBBool x, DBBool y) {

if (x.value == 0 || y.value == 0) return Null;

return x.value != y.value? True: False;

// Logical negation operator. Returns True if the operand is False, Null

// if the operand is Null, or False if the operand is True.

public static DBBool operator !(DBBool x) {

return new DBBool(-x.value);

// Logical AND operator. Returns False if either operand is False,

// otherwise Null if either operand is Null, otherwise True.

public static DBBool operator &(DBBool x, DBBool y) {

return new DBBool(x.value < y.value? x.value: y.value);

// Logical OR operator. Returns True if either operand is True,

otherwise

// Null if either operand is Null, otherwise False.

public static DBBool operator |(DBBool x, DBBool y) {

return new DBBool(x.value > y.value? x.value: y.value);

// Definitely true operator. Returns true if the operand is True, false

// otherwise.

public static bool operator true(DBBool x) {

 return x.value > 0;

// Definitely false operator. Returns true if the operand is False,

false

// otherwise.

public static bool operator false(DBBool x) {

return x.value < 0;

public override bool Equals(object obj) {

if (!(obj is DBBool)) return false;

return value == ((DBBool)obj).value;

public override int GetHashCode() {

return value;

public override string ToString() {

if (value > 0) return "DBBool.True";

if (value < 0) return "DBBool.False";

return "DBBool.Null";

Matrices
Artículo • 16/09/2021 • Tiempo de lectura: 9 minutos

Una matriz es una estructura de datos que contiene un número de variables a las que se
tiene acceso a través de índices calculados. Las variables contenidas en una matriz,
denominadas también elementos de la matriz, son todas del mismo tipo y este tipo se
conoce como tipo de elemento de la matriz.

Una matriz tiene un rango que determina el número de índices asociados a cada
elemento de la matriz. El rango de una matriz también se conoce como las dimensiones
de la matriz. Una matriz con un rango de uno se denomina *matriz unidimensional _.
Una matriz con un rango mayor que uno se denomina matriz multidimensional* *. Las
matrices multidimensionales de tamaño específico se suelen denominar matrices
bidimensionales, matrices tridimensionales, etc.

Cada dimensión de una matriz tiene una longitud asociada que es un número entero
mayor o igual que cero. Las longitudes de las dimensiones no forman parte del tipo de
la matriz, sino que se establecen cuando se crea una instancia del tipo de matriz en
tiempo de ejecución. La longitud de una dimensión determina el intervalo válido de
índices de esa dimensión: para una dimensión de longitud, los N índices pueden oscilar
entre 0 y N - 1 ambos inclusive. El número total de elementos de una matriz es el
producto de las longitudes de cada dimensión de la matriz. Si una o varias de las
dimensiones de una matriz tienen una longitud de cero, se dice que la matriz está vacía.

El tipo de elemento de una matriz puede ser cualquiera, incluido un tipo de matriz.

Tipos de matriz
Un tipo de matriz se escribe como un non_array_type seguido de uno o varios
rank_specifier s:

array_type

: non_array_type rank_specifier+

non_array_type

: type

rank_specifier

: '[' dim_separator* ']'

dim_separator

: ','

Un non_array_type es cualquier tipo que no sea en sí mismo un array_type.

El rango de un tipo de matriz viene determinado por el rank_specifier situado más a la

izquierda en el array_type: un rank_specifier indica que la matriz es una matriz con un
rango de uno más el número de , tokens "" del rank_specifier.

El tipo de elemento de un tipo de matriz es el tipo que se obtiene al eliminar el

rank_specifier situado más a la izquierda:

Un tipo de matriz con el formato T[R] es una matriz con rango R y un tipo de
elemento que no es de matriz T .
Un tipo de matriz con el formato T[R][R1]...[Rn] es una matriz con rango R y un
tipo de elemento T[R1]...[Rn] .

En efecto, los rank_specifier s se leen de izquierda a derecha antes del tipo de elemento
final que no es de matriz. El tipo int[][,,][,] es una matriz unidimensional de matrices
tridimensionales de matrices bidimensionales de int .

En tiempo de ejecución, un valor de un tipo de matriz puede ser null o una referencia a
una instancia de ese tipo de matriz.

Tipo System. Array

El tipo System.Array es el tipo base abstracto de todos los tipos de matriz. Existe una
conversión de referencia implícita (conversiones de referencia implícita) de cualquier
tipo de matriz a System.Array , y existe una conversión de referencia explícita
(conversiones de referencia explícita) de System.Array a cualquier tipo de matriz. Tenga
en cuenta que System.Array no es un array_type. En su lugar, es una class_type de la que
se derivan todos los array_type s.

En tiempo de ejecución, un valor de tipo System.Array puede ser null o una referencia
a una instancia de cualquier tipo de matriz.

Matrices y la interfaz IList genérica

Una matriz unidimensional T[] implementa la interfaz
System.Collections.Generic.IList<T> ( IList<T> para abreviar) y sus interfaces base. En
consecuencia, hay una conversión implícita de T[] a IList<T> y sus interfaces base.
Además, si hay una conversión de referencia implícita de S a T , entonces S[]
implementa IList<T> y existe una conversión de referencia implícita de S[] a IList<T>
y sus interfaces base (conversiones de referencia implícitas). Si hay una conversión de
referencia explícita de S a T , se produce una conversión de referencia explícita de S[]
a IList<T> y sus interfaces base (conversiones de referencia explícitas). Por ejemplo:

using System.Collections.Generic;

class Test

static void Main() {

string[] sa = new string[5];

object[] oa1 = new object[5];

object[] oa2 = sa;

IList<string> lst1 = sa; // Ok

IList<string> lst2 = oa1; // Error, cast needed

IList<object> lst3 = sa; // Ok

IList<object> lst4 = oa1; // Ok

IList<string> lst5 = (IList<string>)oa1; // Exception

IList<string> lst6 = (IList<string>)oa2; // Ok

La asignación lst2 = oa1 genera un error en tiempo de compilación, ya que la

conversión de object[] a IList<string> es una conversión explícita, no implícita. La
conversión hará que se (IList<string>)oa1 produzca una excepción en tiempo de
ejecución, ya que oa1 hace referencia a object[] y no a string[] . Sin embargo, la
conversión (IList<string>)oa2 no provocará que se produzca una excepción, ya que
oa2 hace referencia a string[] .

Siempre que hay una conversión de referencia implícita o explícita de S[] a IList<T> ,
también hay una conversión de referencia explícita desde IList<T> y sus interfaces base
a S[] (conversiones de referencia explícitas).

Cuando un tipo de matriz S[] implementa IList<T> , algunos de los miembros de la

interfaz implementada pueden producir excepciones. El comportamiento preciso de la
implementación de la interfaz está fuera del ámbito de esta especificación.
creación de matriz
Las instancias de matriz se crean mediante array_creation_expression(expresiones de
creación de matrices) o mediante declaraciones de variables locales o de campo que
incluyen un array_initializer (inicializadores de matriz).

Cuando se crea una instancia de matriz, se establecen el rango y la longitud de cada

dimensión y, a continuación, permanecen constantes para toda la duración de la
instancia. En otras palabras, no es posible cambiar el rango de una instancia de matriz
existente, ni tampoco es posible cambiar el tamaño de sus dimensiones.

Una instancia de matriz siempre es de un tipo de matriz. El System.Array tipo es un tipo

Abstract en el que no se pueden crear instancias.

Los elementos de las matrices creadas por array_creation_expression s siempre se

inicializan en su valor predeterminado (valores predeterminados).

Acceso a elementos de matriz

Se obtiene acceso a los elementos de matriz mediante expresiones element_access
(acceso a la matriz) del formulario A[I1, I2, ..., In] , donde A es una expresión de
un tipo de matriz y cada Ix una de ellas es una expresión de tipo int , uint , long ,
ulong o se puede convertir implícitamente a uno o varios de estos tipos. El resultado de

un acceso de elemento de matriz es una variable, es decir, el elemento de matriz

seleccionado por los índices.

Los elementos de una matriz se pueden enumerar mediante una foreach instrucción (la
instrucción foreach).

Miembros de la matriz
Cada tipo de matriz hereda los miembros declarados por el System.Array tipo.

Covarianza de matrices
Para dos reference_type s A y B , si una conversión de referencia implícita (conversiones
de referencia implícita) o una conversión de referencia explícita (conversiones de
referencia explícita) existen de A a B , la misma conversión de referencia también existe
desde el tipo de matriz A[R] al tipo de matriz B[R] , donde R es cualquier rank_specifier
determinado (pero lo mismo para ambos tipos de matriz). Esta relación se conoce como
covarianza de matriz. En particular, la covarianza de matrices significa que un valor de
un tipo de matriz A[R] puede ser realmente una referencia a una instancia de un tipo de
matriz B[R] , siempre que exista una conversión de referencia implícita de B a A .

Debido a la covarianza de matriz, las asignaciones a los elementos de las matrices de

tipos de referencia incluyen una comprobación en tiempo de ejecución que garantiza
que el valor que se asigna al elemento de matriz es realmente un tipo permitido
(asignación simple). Por ejemplo:

class Test

static void Fill(object[] array, int index, int count, object value) {

for (int i = index; i < index + count; i++) array[i] = value;

static void Main() {

string[] strings = new string[100];

Fill(strings, 0, 100, "Undefined");

Fill(strings, 0, 10, null);

Fill(strings, 90, 10, 0);

}

La asignación a array[i] en el Fill método incluye implícitamente una comprobación

en tiempo de ejecución, lo que garantiza que el objeto al que hace referencia value sea
null o una instancia de que sea compatible con el tipo de elemento real de array . En

Main , las dos primeras invocaciones de Fill se realizan correctamente, pero la tercera
invocación hace System.ArrayTypeMismatchException que se produzca una excepción al
ejecutar la primera asignación a array[i] . La excepción se produce porque int no se
puede almacenar una conversión boxing en una string matriz.

La covarianza de la matriz no se extiende específicamente a las matrices de value_type s.

Por ejemplo, no existe ninguna conversión que permita que un int[] se trate como un
object[] .

Inicializadores de matriz
Los inicializadores de matriz se pueden especificar en declaraciones de campo (campos),
declaraciones de variables locales (declaraciones de variables locales) y expresiones de
creación de matrices (expresiones de creación de matrices):
 array_initializer

: '{' variable_initializer_list? '}'

| '{' variable_initializer_list ',' '}'

variable_initializer_list

: variable_initializer (',' variable_initializer)*

variable_initializer

: expression

| array_initializer

Un inicializador de matriz consta de una secuencia de inicializadores de variables, que se

incluyen entre " { " y "" } tokens y separados por " , " tokens. Cada inicializador de
variable es una expresión o, en el caso de una matriz multidimensional, un inicializador
de matriz anidada.

El contexto en el que se usa un inicializador de matriz determina el tipo de la matriz que

se va a inicializar. En una expresión de creación de matriz, el tipo de matriz precede
inmediatamente al inicializador o se deduce de las expresiones del inicializador de
matriz. En una declaración de campo o variable, el tipo de matriz es el tipo del campo o
la variable que se declara. Cuando se usa un inicializador de matriz en una declaración
de campo o variable, como:

int[] a = {0, 2, 4, 6, 8};

es simplemente una abreviatura para una expresión de creación de matriz equivalente:

int[] a = new int[] {0, 2, 4, 6, 8};

En el caso de una matriz unidimensional, el inicializador de matriz debe constar de una

secuencia de expresiones que son compatibles con la asignación con el tipo de
elemento de la matriz. Las expresiones inicializan los elementos de matriz en orden
ascendente, empezando por el elemento en el índice cero. El número de expresiones del
inicializador de matriz determina la longitud de la instancia de la matriz que se va a
crear. Por ejemplo, el inicializador de matriz anterior crea una int[] instancia de la
longitud 5 y, a continuación, inicializa la instancia con los valores siguientes:
 a[0] = 0; a[1] = 2; a[2] = 4; a[3] = 6; a[4] = 8;

En el caso de una matriz multidimensional, el inicializador de matriz debe tener tantos

niveles de anidamiento como dimensiones haya en la matriz. El nivel de anidamiento
más externo corresponde a la dimensión situada más a la izquierda y el nivel de
anidamiento más interno corresponde a la dimensión situada más a la derecha. La
longitud de cada dimensión de la matriz viene determinada por el número de
elementos en el nivel de anidamiento correspondiente en el inicializador de matriz. Para
cada inicializador de matriz anidada, el número de elementos debe ser el mismo que el
de los demás inicializadores de matriz del mismo nivel. El ejemplo:

int[,] b = {{0, 1}, {2, 3}, {4, 5}, {6, 7}, {8, 9}};

crea una matriz bidimensional con una longitud de cinco para la dimensión situada más
a la izquierda y una longitud de dos para la dimensión situada más a la derecha:

int[,] b = new int[5, 2];

y, a continuación, inicializa la instancia de la matriz con los siguientes valores:

b[0, 0] = 0; b[0, 1] = 1;

b[1, 0] = 2; b[1, 1] = 3;

b[2, 0] = 4; b[2, 1] = 5;

b[3, 0] = 6; b[3, 1] = 7;

b[4, 0] = 8; b[4, 1] = 9;

Si una dimensión distinta de la derecha se proporciona con una longitud de cero, se

supone que las dimensiones subsiguientes también tienen la longitud cero. El ejemplo:

int[,] c = {};

crea una matriz bidimensional con una longitud de cero para la dimensión situada más
a la izquierda y la derecha:
 int[,] c = new int[0, 0];

Cuando una expresión de creación de matriz incluye longitudes de dimensión explícitas

y un inicializador de matriz, las longitudes deben ser expresiones constantes y el
número de elementos de cada nivel de anidamiento debe coincidir con la longitud de
dimensión correspondiente. Estos son algunos ejemplos:

int i = 3;

int[] x = new int[3] {0, 1, 2}; // OK

int[] y = new int[i] {0, 1, 2}; // Error, i not a constant

int[] z = new int[3] {0, 1, 2, 3}; // Error, length/initializer mismatch

Aquí, el inicializador de y genera un error en tiempo de compilación porque la

expresión de longitud de dimensión no es una constante y el inicializador de z genera
un error en tiempo de compilación porque la longitud y el número de elementos del
inicializador no coinciden.
Interfaces
Artículo • 16/09/2021 • Tiempo de lectura: 28 minutos

Una interfaz define un contrato. Una clase o estructura que implementa una interfaz
debe adherirse a su contrato. Una interfaz puede heredar de varias interfaces base, y
una clase o estructura puede implementar varias interfaces.

Las interfaces pueden contener métodos, propiedades, eventos e indizadores. La propia

interfaz no proporciona implementaciones para los miembros que define. La interfaz
simplemente especifica los miembros que deben ser proporcionados por clases o
Structs que implementan la interfaz.

Declaraciones de interfaz
Una interface_declaration es una type_declaration (declaraciones de tipos) que declara
un nuevo tipo de interfaz.

antlr

interface_declaration

: attributes? interface_modifier* 'partial'? 'interface'

identifier variant_type_parameter_list? interface_base?

type_parameter_constraints_clause* interface_body ';'?

Un interface_declaration consta de un conjunto opcional de atributos (atributos),

seguido de un conjunto opcional de interface_modifier s (modificadores de interfaz),
seguido de un partial modificador opcional, seguido de la palabra clave interface y
un identificador que asigna un nombre a la interfaz, seguido de una especificación de
variant_type_parameter_list opcional (listas de parámetros de tipo variante), seguida de
una especificación de interface_base opcional (interfaces base), seguida de una
especificación de type_parameter_constraints_clause s opcional (restricciones de
parámetro de tipo), seguida de un interface_body (cuerpo de la interfaz), opcionalmente

Modificadores de interfaz
Un interface_declaration puede incluir opcionalmente una secuencia de modificadores
de interfaz:

antlr
 interface_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

| interface_modifier_unsafe

Es un error en tiempo de compilación que el mismo modificador aparezca varias veces

en una declaración de interfaz.

El new modificador solo se permite en interfaces definidas dentro de una clase.

Especifica que la interfaz oculta un miembro heredado con el mismo nombre, tal y
como se describe en el modificador New.

Los public protected internal modificadores,, y private controlan la accesibilidad de

la interfaz. Dependiendo del contexto en el que se produce la declaración de la interfaz,
solo se pueden permitir algunos de estos modificadores (sedeclarará la accesibilidad).

Unmodifier (modificador)
El partial modificador indica que este interface_declaration es una declaración de tipos
parciales. Varias declaraciones de interfaz parcial con el mismo nombre dentro de una
declaración de tipo o espacio de nombres envolvente se combinan para formar una
declaración de interfaz, siguiendo las reglas especificadas en tipos parciales.

Listas de parámetros de tipo variante

Las listas de parámetros de tipo variante solo se pueden producir en tipos de interfaz y
delegado. La diferencia de los type_parameter_list normales es el variance_annotation
opcional en cada parámetro de tipo.

antlr

variant_type_parameter_list

: '<' variant_type_parameters '>'

variant_type_parameters

: attributes? variance_annotation? type_parameter

| variant_type_parameters ',' attributes? variance_annotation?

type_parameter

 variance_annotation

: 'in'

| 'out'

Si la anotación de varianza es out , se dice que el parámetro de tipo es *covariante _. Si

la anotación de varianza es in , se dice que el parámetro de tipo es contravariante. Si no
hay ninguna anotación de varianza, se dice que el parámetro de tipo es _ invariable *.

En el ejemplo

C#

interface C<out X, in Y, Z>

X M(Y y);

Z P { get; set; }

X es covariante, Y es contravariante y Z es invariable.

Seguridad de la varianza
La aparición de anotaciones de varianza en la lista de parámetros de tipo de un tipo
restringe los lugares en los que se pueden producir tipos en la declaración de tipos.

Un tipo T es Output-Unsafe si uno de los siguientes contiene:

T es un parámetro de tipo contravariante

T es un tipo de matriz con un tipo de elemento de salida no seguro

T es un tipo de interfaz o delegado S<A1,...,Ak> construido a partir de un tipo

genérico S<X1,...,Xk> en el que para al menos uno Ai de los elementos

siguientes contiene:
Xi es covariante o invariable y Ai es una salida no segura.

Xi es contravariante o invariable y Ai es seguro para la entrada.

Un tipo T es una entrada no segura si uno de los siguientes contiene:

T es un parámetro de tipo covariante

T es un tipo de matriz con un tipo de elemento no seguro de entrada

T es un tipo de interfaz o delegado S<A1,...,Ak> construido a partir de un tipo

genérico S<X1,...,Xk> en el que para al menos uno Ai de los elementos

siguientes contiene:
 Xi es covariante o invariable y Ai es de entrada no segura.

Xi es contravariante o invariable y Ai es Output-Unsafe.

De forma intuitiva, se prohíbe un tipo de salida no segura en una posición de salida y se

prohíbe un tipo de entrada no segura en una posición de entrada.

Un tipo es Output-Safe _ si no es de salida, y _ Safe-Safe si no es de entrada-no segura.

Conversión de varianza
El propósito de las anotaciones de varianza es proporcionar conversiones más flexibles
(pero todavía con seguridad de tipos) a los tipos de interfaz y delegado. Para este fin, las
definiciones de las conversiones implícitas (conversionesimplícitas) y explícitas
(conversiones explícitas) hacen uso de la noción de Variance-Convertibility, que se
define de la siguiente manera:

Un tipo T<A1,...,An> es una varianza de la conversión a un tipo T<B1,...,Bn> si T es

una interfaz o un tipo de delegado declarado con los parámetros T<X1,...,Xn> de tipo
variante y para cada parámetro Xi de tipo variante uno de los siguientes:

Xi es covariante y existe una referencia implícita o una conversión de identidad de

Ai a Bi
Xi es contravariante y existe una referencia implícita o una conversión de

identidad de Bi a Ai
Xi es invariable y existe una conversión de identidad de Ai a Bi

Interfaces base
Una interfaz puede heredar de cero o más tipos de interfaz, que se denominan
interfaces base explícitas de la interfaz. Cuando una interfaz tiene una o más interfaces
base explícitas, en la declaración de esa interfaz, el identificador de interfaz va seguido
de un signo de dos puntos y una lista separada por comas de tipos de interfaz base.

antlr

interface_base

: ':' interface_type_list

En el caso de un tipo de interfaz construido, las interfaces base explícitas se forman

tomando las declaraciones de la interfaz base explícita en la declaración de tipos
genéricos y sustituyendo por cada type_parameter en la declaración de la interfaz base,
la type_argument correspondiente del tipo construido.

Las interfaces base explícitas de una interfaz deben ser al menos tan accesibles como la
propia interfaz (restricciones de accesibilidad). Por ejemplo, se trata de un error en
tiempo de compilación para especificar una private internal interfaz o en el
interface_base de una public interfaz.

Se trata de un error en tiempo de compilación para una interfaz que hereda directa o
indirectamente de sí misma.

Las interfaces base de una interfaz son las interfaces base explícitas y sus interfaces
base. En otras palabras, el conjunto de interfaces base es el cierre transitivo completo de
las interfaces base explícitas, sus interfaces base explícitas, etc. Una interfaz hereda
todos los miembros de sus interfaces base. En el ejemplo

C#

interface IControl

void Paint();

interface ITextBox: IControl

void SetText(string text);

interface IListBox: IControl

void SetItems(string[] items);

interface IComboBox: ITextBox, IListBox {}

las interfaces base de IComboBox son IControl , ITextBox y IListBox .

En otras palabras, la IComboBox interfaz anterior hereda miembros y, así SetText

SetItems como Paint .

Cada interfaz base de una interfaz debe ser segura para la salida (seguridad de
lavarianza). Una clase o estructura que implementa una interfaz también implementa
implícitamente todas las interfaces base de la interfaz.

Cuerpo de la interfaz
El interface_body de una interfaz define los miembros de la interfaz.

antlr

interface_body

: '{' interface_member_declaration* '}'

Miembros de interfaz
Los miembros de una interfaz son los miembros heredados de las interfaces base y los
miembros declarados por la propia interfaz.

antlr

interface_member_declaration

: interface_method_declaration

| interface_property_declaration

| interface_event_declaration
| interface_indexer_declaration

Una declaración de interfaz puede declarar cero o más miembros. Los miembros de una
interfaz deben ser métodos, propiedades, eventos o indizadores. Una interfaz no puede
contener constantes, campos, operadores, constructores de instancias, destructores ni
tipos ni una interfaz puede contener miembros estáticos de cualquier tipo.

Todos los miembros de interfaz tienen acceso público de forma implícita. Se trata de un
error en tiempo de compilación para que las declaraciones de miembros de interfaz
incluyan modificadores. En concreto, los miembros de las interfaces no se pueden
declarar con los modificadores abstract ,, public protected , internal , private ,
virtual , override o static .

En el ejemplo

C#

public delegate void StringListEvent(IStringList sender);

public interface IStringList

void Add(string s);

int Count { get; }

event StringListEvent Changed;

string this[int index] { get; set; }

declara una interfaz que contiene uno de los posibles tipos de miembros: un método,
una propiedad, un evento y un indexador.

Un interface_declaration crea un nuevo espacio de declaración (declaraciones) y el

interface_member_declaration s que contiene inmediatamente el interface_declaration
introduce nuevos miembros en este espacio de declaración. Las siguientes reglas se
aplican a interface_member_declaration s:

El nombre de un método debe ser distinto de los nombres de todas las

propiedades y eventos declarados en la misma interfaz. Además, la firma (firmas y
sobrecarga) de un método debe ser diferente de las firmas de todos los demás
métodos declarados en la misma interfaz, y dos métodos declarados en la misma
interfaz no pueden tener firmas que solo difieran en ref y out .
El nombre de una propiedad o evento debe ser diferente de los nombres de todos
los demás miembros declarados en la misma interfaz.
La firma de un indexador debe ser diferente de las firmas de los demás
indexadores declarados en la misma interfaz.

Los miembros heredados de una interfaz no son específicamente parte del espacio de
declaración de la interfaz. Por lo tanto, una interfaz puede declarar un miembro con el
mismo nombre o signatura que un miembro heredado. Cuando esto ocurre, se dice que
el miembro de interfaz derivado oculta el miembro de interfaz base. Ocultar un
miembro heredado no se considera un error, pero hace que el compilador emita una
advertencia. Para suprimir la advertencia, la declaración del miembro de interfaz
derivado debe incluir un new modificador para indicar que el miembro derivado está
pensado para ocultar el miembro base. Este tema se describe con más detalle en
ocultarse a travésde la herencia.

Si new se incluye un modificador en una declaración que no oculta un miembro

heredado, se emite una advertencia para ese efecto. Esta advertencia se suprime
quitando el new modificador.

Tenga en cuenta que los miembros de la clase object no son, estrictamente hablando,
miembros de cualquier interfaz (miembros de lainterfaz). Sin embargo, los miembros de
la clase object están disponibles a través de la búsqueda de miembros en cualquier
tipo de interfaz (búsqueda de miembros).

Métodos de interfaz
Los métodos de interfaz se declaran mediante interface_method_declaration s:
 antlr

interface_method_declaration

: attributes? 'new'? return_type identifier type_parameter_list

'(' formal_parameter_list? ')' type_parameter_constraints_clause* ';'

Los atributos, return_type, identificador y formal_parameter_list de una declaración de

método de interfaz tienen el mismo significado que los de una declaración de método
en una clase (métodos). No se permite que una declaración de método de interfaz
especifique un cuerpo de método y, por tanto, la declaración termina siempre con un
punto y coma.

Cada tipo de parámetro formal de un método de interfaz debe ser seguro para la
entrada (seguridad de lavarianza) y el tipo de valor devuelto debe ser void o ser seguro
para la salida. Además, cada restricción de tipo de clase, restricción de tipo de interfaz y
restricción de parámetro de tipo en cualquier parámetro de tipo del método debe ser
de seguridad de entrada.

Estas reglas garantizan que cualquier uso de contravariante o contravariante de la

interfaz sigue siendo seguro para tipos. Por ejemplo,

C#

interface I<out T> { void M<U>() where U : T; }

no es válido porque el uso de T como una restricción de parámetro de tipo en U no es

seguro para la entrada.

Si esta restricción no estuviera en su lugar, sería posible infringir la seguridad de tipos

de la siguiente manera:

C#

class B {}

class D : B{}

class E : B {}

class C : I<D> { public void M<U>() {...} }

...

I<B> b = new C();

b.M<E>();

En realidad, se trata de una llamada a C.M<E> . Pero esa llamada requiere que E derive
de D , por lo que la seguridad de tipos se infringiría aquí.
Propiedades de la interfaz
Las propiedades de interfaz se declaran mediante interface_property_declaration s:

antlr

interface_property_declaration

: attributes? 'new'? type identifier '{' interface_accessors '}'

interface_accessors

: attributes? 'get' ';'

| attributes? 'set' ';'

| attributes? 'get' ';' attributes? 'set' ';'

| attributes? 'set' ';' attributes? 'get' ';'

Los atributos, el tipo y el identificador de una declaración de propiedad de interfaz

tienen el mismo significado que los de una declaración de propiedad en una clase
(propiedades).

Los descriptores de acceso de una declaración de propiedad de interfaz corresponden a

los descriptores de acceso de una declaración de propiedad de clase (descriptores
deacceso), salvo que el cuerpo del descriptor de acceso siempre debe ser un punto y
coma Por lo tanto, los descriptores de acceso simplemente indican si la propiedad es de
lectura y escritura, de solo lectura o de solo escritura.

El tipo de una propiedad de interfaz debe ser seguro para la salida si hay un descriptor
de acceso get y debe ser seguro para la entrada si hay un descriptor de acceso set.

Eventos de interfaz
Los eventos de interfaz se declaran mediante interface_event_declaration s:

antlr

interface_event_declaration

: attributes? 'new'? 'event' type identifier ';'

Los atributos, el tipo y el identificador de una declaración de evento de interfaz tienen el

mismo significado que los de una declaración de evento en una clase (eventos).

El tipo de un evento de interfaz debe ser seguro para la entrada.

Indexadores de interfaz
Los indizadores de interfaz se declaran mediante interface_indexer_declaration s:

antlr

interface_indexer_declaration

: attributes? 'new'? type 'this' '[' formal_parameter_list ']' '{'

interface_accessors '}'

Los atributos, el tipo y el formal_parameter_list de una declaración de indexador de

interfaz tienen el mismo significado que los de una declaración de indexador en una
clase (indizadores).

Los descriptores de acceso de una declaración de indexador de interfaz corresponden a

los descriptores de acceso de una declaración de indizador de clase (indizadores), salvo
que el cuerpo del descriptor de acceso siempre debe ser un punto y coma. Por lo tanto,
los descriptores de acceso indican simplemente si el indizador es de lectura y escritura,
de solo lectura o de solo escritura.

Todos los tipos de parámetros formales de un indizador de interfaz deben ser seguros
para la entrada. Además, cualquier out tipo de ref parámetro formal o también debe
ser seguro para la salida. Tenga en cuenta que incluso out se requiere que los
parámetros sean seguros para la entrada, debido a una limitación de la plataforma de
ejecución subyacente.

El tipo de un indizador de interfaz debe ser seguro para la salida si hay un descriptor de
acceso get y debe ser seguro para la entrada si hay un descriptor de acceso set.

Acceso a miembros de interfaz

Se tiene acceso a los miembros de interfaz a través del acceso a miembros (acceso
amiembros) y las expresiones de acceso a indizador (acceso a indizador) del formulario
I.M y I[A] , donde I es un tipo de interfaz, M es un método, propiedad o evento de

ese tipo de interfaz, y A es una lista de argumentos de indizador.

Para las interfaces que son estrictamente herencia única (cada interfaz de la cadena de
herencia tiene exactamente cero o una interfaz base directa), los efectos de las reglas de
búsqueda de miembros (búsqueda de miembros), invocación de métodos (llamadas a
métodos) e indexador (acceso a indexador) son exactamente los mismos que para las
clases y los Structs: los miembros más derivados ocultan los miembros menos derivados
con el mismo nombre o signatura. Sin embargo, en el caso de las interfaces de herencia
múltiple, pueden producirse ambigüedades cuando dos o más interfaces base no
relacionadas declaran miembros con el mismo nombre o signatura. En esta sección se
muestran varios ejemplos de esas situaciones. En todos los casos, se pueden usar
conversiones explícitas para resolver las ambigüedades.

En el ejemplo

C#

interface IList

int Count { get; set; }

interface ICounter

void Count(int i);

interface IListCounter: IList, ICounter {}

class C

void Test(IListCounter x) {

x.Count(1); // Error

x.Count = 1; // Error

((IList)x).Count = 1; // Ok, invokes IList.Count.set

((ICounter)x).Count(1); // Ok, invokes ICounter.Count

}

las dos primeras instrucciones producen errores en tiempo de compilación porque la

búsqueda de miembros (búsqueda de miembros) de Count en IListCounter es
ambigua. Como se muestra en el ejemplo, la ambigüedad se resuelve mediante la
conversión x al tipo de interfaz base adecuado. Tales conversiones no tienen ningún
costo en tiempo de ejecución, simplemente consisten en ver la instancia como un tipo
menos derivado en tiempo de compilación.

En el ejemplo

C#

interface IInteger

void Add(int i);

interface IDouble

 void Add(double d);

interface INumber: IInteger, IDouble {}

class C

void Test(INumber n) {

n.Add(1); // Invokes IInteger.Add

n.Add(1.0); // Only IDouble.Add is applicable

((IInteger)n).Add(1); // Only IInteger.Add is a candidate

((IDouble)n).Add(1); // Only IDouble.Add is a candidate

la invocación n.Add(1) selecciona IInteger.Add aplicando las reglas de resolución de

sobrecarga de la resolución de sobrecarga. De igual forma, la invocación n.Add(1.0)
selecciona IDouble.Add . Cuando se insertan conversiones explícitas, solo hay un
método candidato y, por tanto, no hay ambigüedad.

En el ejemplo

C#

interface IBase

void F(int i);

interface ILeft: IBase

new void F(int i);

interface IRight: IBase

{

void G();
}

interface IDerived: ILeft, IRight {}

class A

void Test(IDerived d) {

d.F(1); // Invokes ILeft.F

((IBase)d).F(1); // Invokes IBase.F

((ILeft)d).F(1); // Invokes ILeft.F

((IRight)d).F(1); // Invokes IBase.F

el miembro IBase.F está oculto por el ILeft.F miembro. La invocación d.F(1)

selecciona ILeft.F , aunque IBase.F parece que no está oculto en la ruta de acceso
que conduce IRight .

La regla intuitiva para ocultar en interfaces de herencia múltiple es simplemente esto: Si

un miembro está oculto en una ruta de acceso, se oculta en todas las rutas de acceso.
Dado que la ruta de acceso de IDerived a ILeft IBase oculta IBase.F , el miembro
también se oculta en la ruta de acceso de IDerived a a IRight IBase .

Nombres completos de miembros de interfaz

A veces se hace referencia a un miembro de interfaz mediante su nombre completo. El
nombre completo de un miembro de interfaz consta del nombre de la interfaz en la que
se declara el miembro, seguido de un punto, seguido del nombre del miembro. El
nombre completo de un miembro hace referencia a la interfaz en la que se declara el
miembro. Por ejemplo, dadas las declaraciones

C#

interface IControl

void Paint();

interface ITextBox: IControl

void SetText(string text);

el nombre completo de Paint es IControl.Paint y el nombre completo de SetText es

ITextBox.SetText .

En el ejemplo anterior, no es posible hacer referencia a Paint como ITextBox.Paint .

Cuando una interfaz forma parte de un espacio de nombres, el nombre completo de un

miembro de interfaz incluye el nombre del espacio de nombres. Por ejemplo

C#

namespace System

public interface ICloneable

object Clone();

Aquí, el nombre completo del Clone método es System.ICloneable.Clone .

Implementaciones de interfaces
Las interfaces pueden ser implementadas por clases y Structs. Para indicar que una clase
o estructura implementa directamente una interfaz, el identificador de interfaz se incluye
en la lista de clases base de la clase o estructura. Por ejemplo:

C#

interface ICloneable

object Clone();

interface IComparable

int CompareTo(object other);

class ListEntry: ICloneable, IComparable

public object Clone() {...}

public int CompareTo(object other) {...}

Una clase o estructura que implementa directamente una interfaz también implementa
directamente todas las interfaces base de la interfaz de forma implícita. Esto es así
incluso si la clase o estructura no enumera explícitamente todas las interfaces base de la
lista de clases base. Por ejemplo:

C#

interface IControl

void Paint();

interface ITextBox: IControl

void SetText(string text);

class TextBox: ITextBox

 public void Paint() {...}

public void SetText(string text) {...}

Aquí, la clase TextBox implementa IControl y ITextBox .

Cuando una clase C implementa directamente una interfaz, todas las clases derivadas
de C también implementan la interfaz implícitamente. Las interfaces base especificadas
en una declaración de clase pueden ser tipos de interfaz construidos (tipos construidos).
Una interfaz base no puede ser un parámetro de tipo por sí misma, aunque puede
incluir los parámetros de tipo que se encuentran en el ámbito. En el código siguiente se
muestra cómo una clase puede implementar y extender tipos construidos:

C#

class C<U,V> {}

interface I1<V> {}

class D: C<string,int>, I1<string> {}

class E<T>: C<int,T>, I1<T> {}

Las interfaces base de una declaración de clase genérica deben cumplir la regla de
unicidad descrita en singularidad de las interfaces implementadas.

Implementaciones de miembros de interfaz explícitos

A efectos de la implementación de interfaces, una clase o struct puede declarar
implementaciones de miembros de interfaz explícita. Una implementación explícita de
un miembro de interfaz es un método, una propiedad, un evento o una declaración de
indexador que hace referencia a un nombre de miembro de interfaz completo. Por
ejemplo

C#

interface IList<T>

T[] GetElements();

interface IDictionary<K,V>

V this[K key];

void Add(K key, V value);

 class List<T>: IList<T>, IDictionary<int,T>

T[] IList<T>.GetElements() {...}

T IDictionary<int,T>.this[int index] {...}

void IDictionary<int,T>.Add(int index, T value) {...}

Aquí IDictionary<int,T>.this y IDictionary<int,T>.Add son implementaciones de

miembros de interfaz explícitos.

En algunos casos, es posible que el nombre de un miembro de interfaz no sea adecuado

para la clase de implementación, en cuyo caso el miembro de interfaz se puede
implementar utilizando la implementación explícita del miembro de interfaz. Una clase
que implementa una abstracción de archivo, por ejemplo, podría implementar una
Close función miembro que tenga el efecto de liberar el recurso de archivo e

implementar el Dispose método de la IDisposable interfaz mediante la implementación

explícita del miembro de interfaz:

C#

interface IDisposable

void Dispose();

class MyFile: IDisposable

void IDisposable.Dispose() {

Close();

public void Close() {

// Do what's necessary to close the file

System.GC.SuppressFinalize(this);

No es posible tener acceso a una implementación explícita de un miembro de interfaz a

través de su nombre completo en una invocación de método, acceso a propiedades o
acceso a indexador. Solo se puede tener acceso a una implementación de miembro de
interfaz explícita a través de una instancia de interfaz y, en ese caso, se hace referencia a
ella simplemente por su nombre de miembro.

Se trata de un error en tiempo de compilación para que una implementación explícita

de un miembro de interfaz incluya modificadores de acceso, y es un error en tiempo de
compilación incluir los modificadores abstract ,, virtual override o static .
Las implementaciones explícitas de miembros de interfaz tienen distintas características
de accesibilidad que otros miembros. Dado que nunca se puede obtener acceso a las
implementaciones de miembros de interfaz explícitos mediante su nombre completo en
una invocación de método o un acceso de propiedad, se encuentran en un sentido
privado. Sin embargo, puesto que se puede tener acceso a ellos a través de una
instancia de la interfaz, también son públicos.

Las implementaciones explícitas de miembros de interfaz tienen dos propósitos

principales:

Dado que no se puede acceder a las implementaciones de miembros de interfaz

explícitos a través de instancias de clase o struct, permiten excluir las
implementaciones de interfaz de la interfaz pública de una clase o struct. Esto es
especialmente útil cuando una clase o estructura implementa una interfaz interna
que no es de interés para un consumidor de esa clase o estructura.
Las implementaciones explícitas de miembros de interfaz permiten la
desambiguación de los miembros de interfaz con la misma firma. Sin
implementaciones explícitas de miembros de interfaz, sería imposible que una
clase o struct tenga implementaciones diferentes de miembros de interfaz con la
misma signatura y el mismo tipo de valor devuelto, lo que sería imposible para que
una clase o struct tenga cualquier implementación en todos los miembros de
interfaz con la misma firma pero con distintos tipos de valor devueltos.

Para que una implementación de miembro de interfaz explícita sea válida, la clase o
estructura debe nombrar una interfaz en su lista de clases base que contenga un
miembro cuyo nombre completo, tipo y tipos de parámetro coincidan exactamente con
los de la implementación explícita del miembro de interfaz. Por lo tanto, en la clase
siguiente

C#

class Shape: ICloneable

object ICloneable.Clone() {...}

int IComparable.CompareTo(object other) {...} // invalid

la declaración de IComparable.CompareTo genera un error en tiempo de compilación

porque IComparable no aparece en la lista de clases base de Shape y no es una interfaz
base de ICloneable . Del mismo modo, en las declaraciones

C#
 class Shape: ICloneable

object ICloneable.Clone() {...}

class Ellipse: Shape

object ICloneable.Clone() {...} // invalid

la declaración de ICloneable.Clone en Ellipse produce un error en tiempo de

compilación porque ICloneable no aparece explícitamente en la lista de clases base de
Ellipse .

El nombre completo de un miembro de interfaz debe hacer referencia a la interfaz en la

que se declaró el miembro. Por lo tanto, en las declaraciones

C#

interface IControl

void Paint();

interface ITextBox: IControl

void SetText(string text);

class TextBox: ITextBox

void IControl.Paint() {...}

void ITextBox.SetText(string text) {...}

la implementación explícita del miembro de interfaz de Paint debe escribirse como

IControl.Paint .

Unicidad de interfaces implementadas

Las interfaces implementadas por una declaración de tipo genérico deben ser únicas
para todos los tipos construidos posibles. Sin esta regla, sería imposible determinar el
método correcto al que llamar para determinados tipos construidos. Por ejemplo,
supongamos que se permitía escribir una declaración de clase genérica como sigue:

C#
 interface I<T>

void F();
}

class X<U,V>: I<U>, I<V> // Error: I<U> and I<V> conflict

void I<U>.F() {...}

void I<V>.F() {...}

Si se permitiera, sería imposible determinar qué código ejecutar en el caso siguiente:

C#

I<int> x = new X<int,int>();

x.F();

Para determinar si la lista de interfaces de una declaración de tipo genérico es válida, se

llevan a cabo los siguientes pasos:

L Se trata de la lista de interfaces que se especifican directamente en una clase

genérica, struct o declaración de interfaz C .
Agregue a L cualquier interfaz base de las interfaces que ya estén en L .
Quite cualquier duplicado de L .
Si se crea un posible tipo construido a partir de C , después de que los
argumentos de tipo se sustituyen por L , hace que dos interfaces de L sean
idénticas, la declaración de C no es válida. Las declaraciones de restricciones no se
tienen en cuenta a la hora de determinar todos los tipos construidos posibles.

En la declaración de clase X anterior, la lista L de interfaces consta de I<U> y I<V> . La

declaración no es válida porque cualquier tipo construido con U y V que sea del mismo
tipo haría que estas dos interfaces sean tipos idénticos.

Es posible unificar las interfaces especificadas en diferentes niveles de herencia:

C#

interface I<T>

void F();
}

class Base<U>: I<U>

void I<U>.F() {...}

 class Derived<U,V>: Base<U>, I<V> // Ok

void I<V>.F() {...}

Este código es válido aunque Derived<U,V> implemente I<U> y I<V> . El código.

C#

I<int> x = new Derived<int,int>();

x.F();

invoca el método en Derived , puesto que se Derived<int,int> vuelve a implementar

de forma eficaz I<int> (reimplementación de la interfaz).

Implementación de métodos genéricos

Cuando un método genérico implementa implícitamente un método de interfaz, las
restricciones proporcionadas para cada parámetro de tipo de método deben ser
equivalentes en ambas declaraciones (después de que los parámetros de tipo de
interfaz se reemplacen con los argumentos de tipo adecuados), donde los parámetros
de tipo de método se identifican por posiciones ordinales, de izquierda a derecha.

Sin embargo, cuando un método genérico implementa explícitamente un método de

interfaz, no se permite ninguna restricción en el método de implementación. En su
lugar, las restricciones se heredan del método de interfaz.

C#

interface I<A,B,C>

void F<T>(T t) where T: A;

void G<T>(T t) where T: B;

void H<T>(T t) where T: C;

class C: I<object,C,string>

public void F<T>(T t) {...} // Ok

public void G<T>(T t) where T: C {...} // Ok

public void H<T>(T t) where T: string {...} // Error

El método C.F<T> implementa implícitamente I<object,C,string>.F<T> . En este caso,

C.F<T> no es necesario (ni se permite) especificar la restricción, T:object ya que object
es una restricción implícita en todos los parámetros de tipo. El método C.G<T>
implementa implícitamente I<object,C,string>.G<T> porque las restricciones coinciden
con las de la interfaz, después de que los parámetros de tipo de interfaz se reemplacen
por los argumentos de tipo correspondientes. La restricción para el método C.H<T> es
un error porque los tipos sellados ( string en este caso) no se pueden usar como
restricciones. Omitir la restricción también sería un error, ya que las restricciones de las
implementaciones de métodos de interfaz implícitas deben coincidir. Por lo tanto, es
imposible implementar implícitamente I<object,C,string>.H<T> . Este método de
interfaz solo se puede implementar mediante una implementación explícita de un
miembro de interfaz:

C#

class C: I<object,C,string>

...

public void H<U>(U u) where U: class {...}

void I<object,C,string>.H<T>(T t) {

string s = t; // Ok

H<T>(t);

En este ejemplo, la implementación de miembro de interfaz explícita invoca un método

público que tiene restricciones estrictamente más débiles. Tenga en cuenta que la
asignación de t a s es válida, ya que T hereda una restricción de T:string , aunque
esta restricción no se pueda expresar en el código fuente.

Asignación de interfaz
Una clase o estructura debe proporcionar implementaciones de todos los miembros de
las interfaces que se enumeran en la lista de clases base de la clase o estructura. El
proceso de buscar implementaciones de miembros de interfaz en una clase o struct de
implementación se conoce como asignación de interfaz.

La asignación de interfaz para una clase o struct C localiza una implementación para
cada miembro de cada interfaz especificada en la lista de clases base de C . La
implementación de un miembro de interfaz determinado I.M , donde I es la interfaz en
la que M se declara el miembro, se determina examinando cada clase o struct S ,
empezando por C y repitiendo cada clase base sucesiva de C , hasta que se encuentre
una coincidencia:
 Si S contiene una declaración de una implementación explícita de un miembro de
interfaz que coincide con I y M , este miembro es la implementación de I.M .
De lo contrario, si S contiene una declaración de un miembro público no estático
que coincide con M , este miembro es la implementación de I.M . Si hay más de
un miembro que coincide, no se especifica qué miembro es la implementación de
I.M . Esta situación solo puede producirse si S es un tipo construido en el que los

dos miembros declarados en el tipo genérico tienen firmas diferentes, pero los
argumentos de tipo hacen que sus firmas sean idénticas.

Se produce un error en tiempo de compilación si no se pueden encontrar

implementaciones para todos los miembros de todas las interfaces especificadas en la
lista de clases base de C . Tenga en cuenta que los miembros de una interfaz incluyen a
los miembros heredados de las interfaces base.

En lo que respecta a la asignación de interfaz, un miembro de clase A coincide con un

miembro de interfaz B cuando:

A y B son métodos, y el nombre, el tipo y las listas de parámetros formales de A y

B son idénticos.

A y B son propiedades, el nombre y el tipo de A y B son idénticos, y A tienen los

mismos descriptores de acceso que B ( A se permite tener descriptores de acceso
adicionales si no es una implementación de miembro de interfaz explícita).
A y B son eventos, y el nombre y el tipo de A y B son idénticos.

A y B son indizadores, las listas de parámetros de tipo y formales de A y B son

idénticas, y A tienen los mismos descriptores de acceso que B ( A se le permite
tener descriptores de acceso adicionales si no es una implementación de miembro
de interfaz explícita).

Las implicaciones importantes del algoritmo de asignación de interfaz son:

Las implementaciones de miembros de interfaz explícitos tienen prioridad sobre

otros miembros de la misma clase o estructura al determinar el miembro de clase
o de estructura que implementa un miembro de interfaz.
Ninguno de los miembros no públicos ni estáticos participan en la asignación de
interfaz.

En el ejemplo

C#

interface ICloneable

object Clone();

class C: ICloneable

object ICloneable.Clone() {...}

public object Clone() {...}

el ICloneable.Clone miembro de C se convierte en la implementación de Clone en

ICloneable porque las implementaciones explícitas de los miembros de interfaz tienen

prioridad sobre otros miembros.

Si una clase o estructura implementa dos o más interfaces que contienen un miembro
con el mismo nombre, tipo y tipos de parámetro, es posible asignar cada uno de esos
miembros de interfaz a un único miembro de clase o de estructura. Por ejemplo

C#

interface IControl

void Paint();

interface IForm

void Paint();

class Page: IControl, IForm

public void Paint() {...}

En este caso, los Paint métodos de IControl y IForm se asignan al Paint método en
Page . También es posible tener implementaciones de miembros de interfaz explícitas
independientes para los dos métodos.

Si una clase o estructura implementa una interfaz que contiene miembros ocultos,
algunos miembros deben implementarse necesariamente mediante implementaciones
explícitas de miembros de interfaz. Por ejemplo

C#

interface IBase

int P { get; }

 interface IDerived: IBase

new int P();

Una implementación de esta interfaz requeriría al menos una implementación explícita

de un miembro de interfaz y adoptaría uno de los siguientes formatos

C#

class C: IDerived

int IBase.P { get {...} }

int IDerived.P() {...}

class C: IDerived

public int P { get {...} }

int IDerived.P() {...}

class C: IDerived

int IBase.P { get {...} }

public int P() {...}

Cuando una clase implementa varias interfaces que tienen la misma interfaz base, solo
puede haber una implementación de la interfaz base. En el ejemplo

C#

interface IControl

void Paint();

interface ITextBox: IControl

void SetText(string text);

interface IListBox: IControl

void SetItems(string[] items);

class ComboBox: IControl, ITextBox, IListBox

void IControl.Paint() {...}

 void ITextBox.SetText(string text) {...}

void IListBox.SetItems(string[] items) {...}

no es posible tener implementaciones independientes para el IControl denominado en

la lista de clases base, IControl heredado por ITextBox y IControl heredado por
IListBox . En realidad, no hay ninguna noción de una identidad independiente para

estas interfaces. En su lugar, las implementaciones de ITextBox y IListBox comparten

la misma implementación de IControl y ComboBox simplemente se considera que
implementa tres interfaces,, IControl ITextBox y IListBox .

Los miembros de una clase base participan en la asignación de interfaz. En el ejemplo

C#

interface Interface1

void F();
}

class Class1

public void F() {}

public void G() {}

class Class2: Class1, Interface1

new public void G() {}

el método F de Class1 se usa en Class2 la implementación de de Interface1 .

Herencia de implementación de interfaz

Una clase hereda todas las implementaciones de interfaz proporcionadas por sus clases
base.

Sin volver a implementar explícitamente una interfaz, una clase derivada no puede
alterar de ninguna manera las asignaciones de interfaz que hereda de sus clases base.
Por ejemplo, en las declaraciones

C#

interface IControl

 void Paint();

class Control: IControl

public void Paint() {...}

class TextBox: Control

new public void Paint() {...}

el Paint método en TextBox oculta el Paint método en Control , pero no modifica la

asignación de Control.Paint en IControl.Paint , y las llamadas a a través de Paint
instancias de clase e instancias de interfaz tendrán los siguientes efectos:

C#

Control c = new Control();

TextBox t = new TextBox();

IControl ic = c;

IControl it = t;

c.Paint(); // invokes Control.Paint();

t.Paint(); // invokes TextBox.Paint();

ic.Paint(); // invokes Control.Paint();

it.Paint(); // invokes Control.Paint();

Sin embargo, cuando un método de interfaz se asigna a un método virtual en una clase,
es posible que las clases derivadas invaliden el método virtual y modifiquen la
implementación de la interfaz. Por ejemplo, volver a escribir las declaraciones anteriores
en

C#

interface IControl

void Paint();

class Control: IControl

public virtual void Paint() {...}

class TextBox: Control

public override void Paint() {...}

ahora se observarán los siguientes efectos:

C#

Control c = new Control();

TextBox t = new TextBox();

IControl ic = c;

IControl it = t;

c.Paint(); // invokes Control.Paint();

t.Paint(); // invokes TextBox.Paint();

ic.Paint(); // invokes Control.Paint();

it.Paint(); // invokes TextBox.Paint();

Dado que las implementaciones explícitas de los miembros de interfaz no se pueden

declarar como virtuales, no es posible invalidar una implementación explícita de un
miembro de interfaz. Sin embargo, es absolutamente válido que una implementación de
miembro de interfaz explícita llame a otro método, y ese otro método se puede declarar
como virtual para permitir que las clases derivadas lo invaliden. Por ejemplo

C#

interface IControl

void Paint();

class Control: IControl

void IControl.Paint() { PaintControl(); }

protected virtual void PaintControl() {...}

class TextBox: Control

protected override void PaintControl() {...}

Aquí, las clases derivadas de Control pueden especializar la implementación de

IControl.Paint invalidando el PaintControl método.

Volver a implementar la interfaz

Una clase que hereda una implementación de interfaz puede volver a implementar la
interfaz incluyéndola en la lista de clases base.

Una nueva implementación de una interfaz sigue exactamente las mismas reglas de
asignación de interfaz que una implementación inicial de una interfaz. Por lo tanto, la
asignación de interfaz heredada no tiene ningún efecto en la asignación de interfaz
establecida para la reimplementación de la interfaz. Por ejemplo, en las declaraciones

C#

interface IControl

void Paint();

class Control: IControl

void IControl.Paint() {...}

class MyControl: Control, IControl

public void Paint() {}

el hecho de que se Control asigna en IControl.Paint Control.IControl.Paint no

afecta a la reimplementación en MyControl , que se asigna a IControl.Paint
MyControl.Paint .

Las declaraciones de miembros públicos heredados y las declaraciones de miembro de

interfaz explícita heredadas participan en el proceso de asignación de interfaz para las
interfaces que se han vuelto a implementar. Por ejemplo

C#

interface IMethods

void F();
void G();
void H();
void I();
}

class Base: IMethods

void IMethods.F() {}

void IMethods.G() {}

public void H() {}

public void I() {}

class Derived: Base, IMethods

public void F() {}

 void IMethods.H() {}

Aquí, la implementación de IMethods en Derived asigna los métodos de interfaz en

Derived.F , Base.IMethods.G , Derived.IMethods.H y Base.I .

Cuando una clase implementa una interfaz, también implementa implícitamente todas
las interfaces base de esa interfaz. Del mismo modo, una nueva implementación de una
interfaz también es implícitamente una reimplementación de todas las interfaces base
de la interfaz. Por ejemplo

C#

interface IBase

void F();
}

interface IDerived: IBase

void G();
}

class C: IDerived

void IBase.F() {...}

void IDerived.G() {...}

class D: C, IDerived

public void F() {...}

public void G() {...}

En este caso, la reimplementación de IDerived también vuelve a implementar IBase , y

se asigna a IBase.F D.F .

Clases e interfaces abstractas

Al igual que una clase no abstracta, una clase abstracta debe proporcionar
implementaciones de todos los miembros de las interfaces que se enumeran en la lista
de clases base de la clase. Sin embargo, una clase abstracta puede asignar métodos de
interfaz a métodos abstractos. Por ejemplo

C#
 interface IMethods

void F();
void G();
}

abstract class C: IMethods

public abstract void F();

public abstract void G();

Aquí, la implementación de IMethods Maps F y G en métodos abstractos, que se debe

invalidar en clases no abstractas que se derivan de C .

Tenga en cuenta que las implementaciones explícitas de los miembros de interfaz no

pueden ser abstractas, pero las implementaciones de miembros de interfaz explícitas
son de curso y permiten llamar a métodos abstractos. Por ejemplo

C#

interface IMethods

void F();
void G();
}

abstract class C: IMethods

void IMethods.F() { FF(); }

void IMethods.G() { GG(); }

protected abstract void FF();

protected abstract void GG();

Aquí, las clases no abstractas que derivan de C deberían reemplazar FF y GG , lo que

proporciona la implementación real de IMethods .
Enumeraciones
Artículo • 16/09/2021 • Tiempo de lectura: 6 minutos

Un tipo de enumeración es un tipo de valor distinto (tipos de valor) que declara un

conjunto de constantes con nombre.

En el ejemplo

C#

enum Color

Red,

Green,

Blue

declara un tipo de enumeración denominado Color con miembros Red , Green y Blue .

Declaraciones de enumeración
Una declaración de enumeración declara un nuevo tipo de enumeración. Una
declaración de enumeración comienza con la palabra clave enum y define el nombre, la
accesibilidad, el tipo subyacente y los miembros de la enumeración.

antlr

enum_declaration

: attributes? enum_modifier* 'enum' identifier enum_base? enum_body ';'?

enum_base

: ':' integral_type
;

enum_body

: '{' enum_member_declarations? '}'

| '{' enum_member_declarations ',' '}'

Cada tipo de enumeración tiene un tipo entero correspondiente denominado el tipo

subyacente del tipo de enumeración. Este tipo subyacente debe ser capaz de
representar todos los valores de enumerador definidos en la enumeración. Una
declaración de enumeración puede declarar explícitamente un tipo subyacente de byte
,, sbyte short , ushort , int , uint long o ulong . Tenga en cuenta que char no se
puede utilizar como tipo subyacente. Una declaración de enumeración que no declara
explícitamente un tipo subyacente tiene un tipo subyacente de int .

En el ejemplo

C#

enum Color: long

Red,

Green,

Blue

declara una enumeración con un tipo subyacente de long . Un programador puede

optar por usar un tipo subyacente de long , como en el ejemplo, para habilitar el uso de
valores que se encuentran en el intervalo de long , pero no en el intervalo de int , o
para conservar esta opción en el futuro.

Modificadores de enumeración
Un enum_declaration puede incluir opcionalmente una secuencia de modificadores de
enumeración:

antlr

enum_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

Es un error en tiempo de compilación que el mismo modificador aparezca varias veces

en una declaración de enumeración.

Los modificadores de una declaración de enumeración tienen el mismo significado que

los de una declaración de clase (modificadores de clase). Sin embargo, tenga en cuenta
que los abstract sealed modificadores y no están permitidos en una declaración de
enumeración. Las enumeraciones no pueden ser abstractas y no permiten la derivación.
Miembros de enumeración
El cuerpo de una declaración de tipo enum define cero o más miembros de
enumeración, que son las constantes con nombre del tipo enum. Dos miembros de
enumeración no pueden tener el mismo nombre.

antlr

enum_member_declarations

: enum_member_declaration (',' enum_member_declaration)*

enum_member_declaration

: attributes? identifier ('=' constant_expression)?

Cada miembro de la enumeración tiene un valor constante asociado. El tipo de este

valor es el tipo subyacente de la enumeración contenedora. El valor constante para cada
miembro de la enumeración debe estar en el intervalo del tipo subyacente de la
enumeración. En el ejemplo

C#

enum Color: uint

Red = -1,

Green = -2,

Blue = -3

produce un error en tiempo de compilación porque los valores constantes -1 , -2 y -3

no están en el intervalo del tipo entero subyacente uint .

Varios miembros de enumeración pueden compartir el mismo valor asociado. En el

ejemplo

C#

enum Color

Red,

Green,

Blue,

Max = Blue

muestra una enumeración en la que dos miembros de enumeración ( Blue y Max )

tienen el mismo valor asociado.

El valor asociado de un miembro de enumeración se asigna de forma implícita o

explícita. Si la declaración del miembro de enumeración tiene un inicializador
constant_expression , el valor de esa expresión constante, convertido implícitamente en
el tipo subyacente de la enumeración, es el valor asociado del miembro de
enumeración. Si la declaración del miembro de enumeración no tiene inicializador, su
valor asociado se establece implícitamente, como se indica a continuación:

Si el miembro de la enumeración es el primer miembro de la enumeración

declarado en el tipo de enumeración, su valor asociado es cero.
De lo contrario, el valor asociado del miembro de enumeración se obtiene
aumentando el valor asociado del miembro de enumeración anterior textualmente
en uno. Este aumento de valor debe estar dentro del intervalo de valores que se
puede representar mediante el tipo subyacente; de lo contrario, se producirá un
error en tiempo de compilación.

En el ejemplo

C#

using System;

enum Color

Red,

Green = 10,

Blue

class Test

static void Main() {

Console.WriteLine(StringFromColor(Color.Red));

Console.WriteLine(StringFromColor(Color.Green));

Console.WriteLine(StringFromColor(Color.Blue));

static string StringFromColor(Color c) {

switch (c) {

case Color.Red:

return String.Format("Red = {0}", (int) c);

case Color.Green:

return String.Format("Green = {0}", (int) c);

case Color.Blue:

return String.Format("Blue = {0}", (int) c);

 default:

return "Invalid color";

imprime los nombres de miembro de enumeración y sus valores asociados. La salida es

la siguiente:

Consola

Red = 0

Green = 10

Blue = 11

por los siguientes motivos:

al miembro de enumeración Red se le asigna automáticamente el valor cero (ya

que no tiene inicializador y es el primer miembro de la enumeración);
el miembro de enumeración Green recibe explícitamente el valor 10 ;
Además, al miembro de enumeración Blue se le asigna automáticamente el valor
uno mayor que el miembro que lo precede textualmente.

El valor asociado de un miembro de enumeración no puede, directa ni indirectamente,

usar el valor de su propio miembro de enumeración asociado. Aparte de esta restricción
de circularidad, los inicializadores de miembros de enumeración pueden hacer
referencia libremente a otros inicializadores de miembro de enumeración,
independientemente de su posición textual. Dentro de un inicializador de miembro de
enumeración, los valores de otros miembros de enumeración siempre se tratan como si
tuvieran el tipo de su tipo subyacente, por lo que no es necesario realizar conversiones
cuando se hace referencia a otros miembros de enumeración.

En el ejemplo

C#

enum Circular

A = B,

produce un error en tiempo de compilación porque las declaraciones de A y B son

circulares. A depende de B explícitamente y B depende de A implícitamente.
Los miembros de enumeración tienen un nombre y tienen el ámbito de una manera
exactamente análoga a los campos de las clases. El ámbito de un miembro de
enumeración es el cuerpo de su tipo de enumeración contenedor. Dentro de ese
ámbito, se puede hacer referencia a los miembros de enumeración por su nombre
simple. Desde el resto del código, el nombre de un miembro de enumeración debe
estar calificado con el nombre de su tipo de enumeración. Los miembros de
enumeración no tienen ninguna accesibilidad declarada: se puede acceder a un
miembro de enumeración si se puede tener acceso a su tipo de enumeración
contenedor.

Tipo System.Enum
El tipo System.Enum es la clase base abstracta de todos los tipos de enumeración (es
distinto y diferente del tipo subyacente del tipo de enumeración) y los miembros
heredados de System.Enum están disponibles en cualquier tipo de enumeración. Existe
una conversión boxing (conversiones boxing) de cualquier tipo de enumeración a y
System.Enum existe una conversión unboxing (conversiones unboxing) de System.Enum a

cualquier tipo de enumeración.

Tenga en cuenta que System.Enum no es un enum_type. En su lugar, es una class_type de

la que se derivan todos los enum_type s. El tipo System.Enum hereda del tipo
System.ValueType (el tipo System. ValueType), que, a su vez, hereda del tipo object . En
tiempo de ejecución, un valor de tipo System.Enum puede ser null o una referencia a un
valor de conversión boxing de cualquier tipo de enumeración.

Operaciones y valores de enumeración

Cada tipo de enumeración define un tipo distinto; se requiere una conversión de
enumeración explícita (conversiones explícitas de enumeración) para realizar la
conversión entre un tipo de enumeración y un tipo entero, o entre dos tipos de
enumeración. El conjunto de valores que puede tomar un tipo de enumeración no está
limitado por sus miembros de enumeración. En concreto, cualquier valor del tipo
subyacente de una enumeración se puede convertir al tipo de enumeración y es un
valor válido distinto de ese tipo de enumeración.

Los miembros de enumeración tienen el tipo de su tipo de enumeración contenedor

(excepto en otros inicializadores de miembro de enumeración: vea miembros de
enumeración). El valor de un miembro de enumeración declarado en el tipo de
enumeración E con el valor asociado v es (E)v .
Los operadores siguientes se pueden usar en valores de tipos de enumeración: == , != ,
< , > , <= , >=   (operadores de comparación de enumeración), binario +   (operador de
suma), binario -   (operador de resta), ^ , & , |   (operadores lógicos de enumeración),
~   (operador de complemento debits) ++ --  

Cada tipo de enumeración se deriva automáticamente de la clase System.Enum (que, a su

vez, se deriva de System.ValueType y object ). Por lo tanto, los métodos y las
propiedades heredados de esta clase se pueden utilizar en los valores de un tipo de
enumeración.
Delegados
Artículo • 16/09/2021 • Tiempo de lectura: 9 minutos

Los delegados habilitan escenarios en los que otros lenguajes, como C++, Pascal y
modula, se han direccionado con punteros de función. A diferencia de los punteros de
función de C++, sin embargo, los delegados están totalmente orientados a objetos y, a
diferencia de los punteros de C++ a las funciones miembro, los delegados encapsulan
una instancia de objeto y un método.

Una declaración de delegado define una clase que se deriva de la clase System.Delegate
. Una instancia de delegado encapsula una lista de invocación, que es una lista de uno o
varios métodos, a la que se hace referencia como una entidad a la que se puede llamar.
En el caso de los métodos de instancia, una entidad a la que se puede llamar está
formada por una instancia y un método en esa instancia. En el caso de los métodos
estáticos, una entidad a la que se puede llamar consta simplemente de un método. Al
invocar una instancia de delegado con un conjunto de argumentos adecuado, se invoca
a cada una de las entidades a las que se puede llamar del delegado con el conjunto de
argumentos especificado.

Una propiedad interesante y útil de una instancia de delegado es que no sabe ni le

interesan las clases de los métodos que encapsula; lo único que importa es que esos
métodos sean compatibles (declaraciones de delegado) con el tipo de delegado. Esto
hace que los delegados sean perfectamente adecuados para la invocación "anónima".

Declaraciones de delegado
Un delegate_declaration es un type_declaration (declaraciones de tipos) que declara un
nuevo tipo de delegado.

antlr

delegate_declaration

: attributes? delegate_modifier* 'delegate' return_type

identifier variant_type_parameter_list?

'(' formal_parameter_list? ')' type_parameter_constraints_clause* ';'

delegate_modifier

: 'new'

| 'public'

| 'protected'

| 'internal'

| 'private'

 | delegate_modifier_unsafe

Es un error en tiempo de compilación que el mismo modificador aparezca varias veces

en una declaración de delegado.

El new modificador solo se permite en los delegados declarados dentro de otro tipo, en
cuyo caso especifica que dicho delegado oculte un miembro heredado con el mismo
nombre, tal y como se describe en el modificador New.

Los public protected internal modificadores,, y private controlan la accesibilidad del

tipo de delegado. En función del contexto en el que se produce la declaración de
delegado, es posible que algunos de estos modificadores no estén permitidos
(sedeclare accesibilidad).

El nombre de tipo del delegado es Identifier.

El formal_parameter_list opcional especifica los parámetros del delegado y return_type

indica el tipo de valor devuelto del delegado.

El variant_type_parameter_list opcional (listas de parámetros de tipo variante) especifica

los parámetros de tipo para el delegado.

El tipo de valor devuelto de un tipo de delegado debe ser o tener seguridad void de
salida (seguridad de lavarianza).

Todos los tipos de parámetros formales de un tipo de delegado deben ser seguros para
la entrada. Además, los out ref tipos de parámetro o también deben ser de seguridad
de salida. Tenga en cuenta que incluso out se requiere que los parámetros sean seguros
para la entrada, debido a una limitación de la plataforma de ejecución subyacente.

Los tipos de delegado en C# son equivalentes de nombre, no estructuralmente

equivalentes. En concreto, dos tipos de delegado diferentes que tienen las mismas listas
de parámetros y tipo de valor devuelto se consideran tipos de delegado distintos. Sin
embargo, las instancias de dos tipos de delegado distintos, pero estructuralmente
equivalentes, pueden compararse como iguales (operadores de igualdad de delegado).

Por ejemplo:

C#

delegate int D1(int i, double d);

class A

 public static int M1(int a, double b) {...}

class B

delegate int D2(int c, double d);

public static int M1(int f, double g) {...}

public static void M2(int k, double l) {...}

public static int M3(int g) {...}

public static void M4(int g) {...}

Los métodos A.M1 y B.M1 son compatibles con los tipos de delegado D1 y D2 , ya que
tienen el mismo tipo de valor devuelto y la misma lista de parámetros; sin embargo,
estos tipos de delegado son dos tipos diferentes, por lo que no son intercambiables. Los
métodos B.M2 , B.M3 y B.M4 son incompatibles con los tipos de delegado D1 y D2 , ya
que tienen tipos de valor devuelto o listas de parámetros diferentes.

Al igual que otras declaraciones de tipos genéricos, se deben proporcionar argumentos

de tipo para crear un tipo de delegado construido. Los tipos de parámetro y el tipo de
valor devuelto de un tipo de delegado construido se crean sustituyendo, por cada
parámetro de tipo de la declaración de delegado, el argumento de tipo correspondiente
del tipo de delegado construido. El tipo de valor devuelto y los tipos de parámetro
resultantes se usan para determinar qué métodos son compatibles con un tipo de
delegado construido. Por ejemplo:

C#

delegate bool Predicate<T>(T value);

class X

static bool F(int i) {...}

static bool G(string s) {...}

El método X.F es compatible con el tipo de delegado Predicate<int> y el método X.G

es compatible con el tipo de delegado Predicate<string> .

La única manera de declarar un tipo de delegado es a través de un delegate_declaration.

Un tipo de delegado es un tipo de clase que se deriva de System.Delegate . Los tipos de
delegado son implícitamente sealed , por lo que no se permite derivar ningún tipo de
un tipo de delegado. Tampoco se permite derivar un tipo de clase no delegado de
System.Delegate . Tenga en cuenta que System.Delegate no es un tipo de delegado,

sino que es un tipo de clase del que se derivan todos los tipos de delegado.
C# proporciona una sintaxis especial para la invocación y creación de instancias de
delegado. A excepción de la creación de instancias, cualquier operación que se puede
aplicar a una instancia de clase o clase también se puede aplicar a una clase o instancia
de delegado, respectivamente. En concreto, es posible tener acceso a los miembros del
System.Delegate tipo a través de la sintaxis de acceso a miembros habitual.

El conjunto de métodos encapsulado por una instancia de delegado se denomina lista

de invocación. Cuando se crea una instancia de delegado (compatibilidad con
delegación) desde un único método, encapsula ese método y su lista de invocación
contiene solo una entrada. Sin embargo, cuando se combinan dos instancias de
delegado que no son NULL, sus listas de invocación se concatenan, en el operando
izquierdo de orden y operando derecho, para formar una nueva lista de invocación, que
contiene dos o más entradas.

Los delegados se combinan mediante el operador binario + (operador de suma) y los

+= operadores (asignación compuesta). Un delegado se puede quitar de una
combinación de delegados, mediante - eloperadorbinario (operador de resta) y los -=
operadores (asignación compuesta). Los delegados se pueden comparar para
comprobar si son iguales (operadores de igualdad de delegado).

En el ejemplo siguiente se muestra la creación de instancias de varios delegados y sus

listas de invocación correspondientes:

C#

delegate void D(int x);

class C

public static void M1(int i) {...}

public static void M2(int i) {...}

class Test

static void Main() {

D cd1 = new D(C.M1); // M1

D cd2 = new D(C.M2); // M2

D cd3 = cd1 + cd2; // M1 + M2

D cd4 = cd3 + cd1; // M1 + M2 + M1

D cd5 = cd4 + cd3; // M1 + M2 + M1 + M1 + M2

Cuando cd1 cd2 se crean instancias de y, cada una de ellas encapsula un método.
Cuando cd3 se crea una instancia de, tiene una lista de invocaciones de dos métodos,
M1 y M2 , en ese orden. cd4 la lista de invocación de contiene M1 , M2 y M1 , en ese

orden. Por último, cd5 la lista de invocación de contiene M1 , M2 ,, M1 M1 y M2 , en ese

orden. Para obtener más ejemplos de cómo combinar (y quitar) delegados, vea
invocación de delegado.

Compatibilidad de delegado
Un método o un delegado M es compatible con un tipo D de delegado si se cumplen
todas las condiciones siguientes:

D y M tienen el mismo número de parámetros, y cada parámetro de D tiene los

mismos ref out modificadores o que el parámetro correspondiente de M .

Para cada parámetro de valor (un parámetro sin ref out modificador o), existe
una conversión de identidad (conversión de identidad) o una conversión de
referencia implícita (conversiones de referencia implícita) del tipo de parámetro en
D el tipo de parámetro correspondiente en M .

Para cada ref out parámetro o, el tipo de parámetro de D es el mismo que el tipo
de parámetro en M .
Existe una conversión de referencia implícita o de identidad del tipo de valor
devuelto de M al tipo de valor devuelto de D .

Creación de instancias de delegado

Una instancia de un delegado se crea mediante un delegate_creation_expression
(expresiones de creación de delegados) o una conversión a un tipo de delegado. La
instancia de delegado recién creada hace referencia a:

Método estático al que se hace referencia en el delegate_creation_expression, o

bien
El objeto de destino (que no puede ser null ) y el método de instancia al que se
hace referencia en el delegate_creation_expression, o bien
Otro delegado.

Por ejemplo:

C#

delegate void D(int x);

 class C

public static void M1(int i) {...}

public void M2(int i) {...}

class Test

static void Main() {

D cd1 = new D(C.M1); // static method

C t = new C();

D cd2 = new D(t.M2); // instance method

D cd3 = new D(cd2); // another delegate

Una vez creada la instancia, las instancias de delegado siempre hacen referencia al
mismo objeto y método de destino. Recuerde que, cuando se combinan dos delegados
o uno se quita de otro, se produce un nuevo delegado que tiene su propia lista de
invocación. las listas de invocaciones de los delegados combinados o quitados
permanecen sin cambios.

Invocación de delegado
C# proporciona una sintaxis especial para invocar un delegado. Cuando se invoca una
instancia de delegado que no es null cuya lista de invocación contiene una entrada,
invoca el método con los mismos argumentos en los que se ha dado y devuelve el
mismo valor que el método al que se hace referencia. (Vea invocaciones de delegado
para obtener información detallada sobre la invocación de delegado). Si se produce una
excepción durante la invocación de este tipo de delegado y esa excepción no se detecta
dentro del método que se invocó, la búsqueda de una cláusula catch de excepción
continúa en el método que llamó al delegado, como si ese método hubiera llamado
directamente al método al que el delegado hizo referencia.

La invocación de una instancia de delegado cuya lista de invocaciones contiene varias

entradas continúa invocando cada uno de los métodos de la lista de invocación, de
forma sincrónica, en orden. Cada método al que se llama se pasa el mismo conjunto de
argumentos que se asignó a la instancia del delegado. Si dicha invocación de delegado
incluye parámetros de referencia (parámetros de referencia), cada invocación de
método se producirá con una referencia a la misma variable. los cambios en esa variable
por un método en la lista de invocación serán visibles para los métodos más abajo en la
lista de invocación. Si la invocación del delegado incluye parámetros de salida o un valor
devuelto, su valor final proviene de la invocación del último delegado en la lista.
Si se produce una excepción durante el procesamiento de la invocación de este
delegado, y esa excepción no se detecta dentro del método que se invocó, la búsqueda
de una cláusula catch de excepción continúa en el método que llamó al delegado, y no
se invocan los métodos que se encuentran más abajo en la lista de invocación.

Al intentar invocar una instancia de delegado cuyo valor es null, se produce una
excepción de tipo System.NullReferenceException .

En el ejemplo siguiente se muestra cómo crear instancias, combinar, quitar e invocar

delegados:

C#

using System;

delegate void D(int x);

class C

public static void M1(int i) {

Console.WriteLine("C.M1: " + i);

public static void M2(int i) {

Console.WriteLine("C.M2: " + i);

public void M3(int i) {

Console.WriteLine("C.M3: " + i);

class Test

static void Main() {

D cd1 = new D(C.M1);

cd1(-1); // call M1

D cd2 = new D(C.M2);

cd2(-2); // call M2

D cd3 = cd1 + cd2;

cd3(10); // call M1 then M2

cd3 += cd1;

cd3(20); // call M1, M2, then M1

C c = new C();

D cd4 = new D(c.M3);

cd3 += cd4;

cd3(30); // call M1, M2, M1, then M3

 cd3 -= cd1; // remove last M1

cd3(40); // call M1, M2, then M3

cd3 -= cd4;

cd3(50); // call M1 then M2

cd3 -= cd2;

cd3(60); // call M1

cd3 -= cd2; // impossible removal is benign

cd3(60); // call M1

cd3 -= cd1; // invocation list is empty so cd3 is null

cd3(70); // System.NullReferenceException thrown

cd3 -= cd1; // impossible removal is benign

Como se muestra en la instrucción cd3 += cd1; , un delegado puede estar presente

varias veces en una lista de invocación. En este caso, simplemente se invoca una vez por
cada repetición. En una lista de invocación como esta, cuando se quita ese delegado, la
última aparición en la lista de invocación es la que realmente se quita.

Inmediatamente antes de la ejecución de la instrucción final, cd3 -= cd1; , el delegado

cd3 hace referencia a una lista de invocación vacía. El intento de quitar un delegado de
una lista vacía (o de quitar un delegado que no existe de una lista no vacía) no es un
error.

La salida generada es:

Consola

C.M1: -1

C.M2: -2

C.M1: 10

C.M2: 10

C.M1: 20

C.M2: 20

C.M1: 20

C.M1: 30

C.M2: 30

C.M1: 30

C.M3: 30

C.M1: 40

C.M2: 40

C.M3: 40

C.M1: 50

C.M2: 50

C.M1: 60

C.M1: 60

Excepciones
Artículo • 16/09/2021 • Tiempo de lectura: 4 minutos

Las excepciones en C# proporcionan una forma estructurada, uniforme y con seguridad

de tipos de controlar las condiciones de error del nivel de sistema y de la aplicación. El
mecanismo de excepción en C# es muy similar al de C++, con algunas diferencias
importantes:

En C#, todas las excepciones deben estar representadas por una instancia de un
tipo de clase derivado de System.Exception . En C++, cualquier valor de cualquier
tipo se puede utilizar para representar una excepción.
En C#, se puede usar un bloque finally (la instrucción try) para escribir el código de
finalización que se ejecuta en la ejecución normal y en condiciones excepcionales.
Este código es difícil de escribir en C++ sin duplicar el código.
En C#, las excepciones de nivel de sistema, como Overflow, división por cero y
desreferencia nula, tienen clases de excepción bien definidas y se encuentran en
un par de condiciones de error de nivel de aplicación.

Causas de las excepciones

Se puede producir una excepción de dos maneras diferentes.

Una throw instrucción (la instrucción throw) produce una excepción de inmediato
y de forma incondicional. El control nunca alcanza la instrucción inmediatamente
después de throw .
Ciertas condiciones excepcionales que surgen durante el procesamiento de
instrucciones y expresiones de C# causan una excepción en determinadas
circunstancias en las que la operación no se puede completar con normalidad. Por
ejemplo, una operación de división de enteros (operador de división) produce una
excepción System.DivideByZeroException si el denominador es cero. Vea clases de
excepción comunes para obtener una lista de las distintas excepciones que pueden
producirse de esta manera.

La clase System.Exception
La System.Exception clase es el tipo base de todas las excepciones. Esta clase tiene
algunas propiedades importantes que comparten todas las excepciones:
 Message es una propiedad de solo lectura de tipo string que contiene una

descripción inteligible de la razón de la excepción.

InnerException es una propiedad de solo lectura de tipo Exception . Si su valor no

es null, hace referencia a la excepción que provocó la excepción actual, es decir, la

excepción actual se produjo en un bloque catch que controla el InnerException .
De lo contrario, su valor es null, lo que indica que esta excepción no se produjo
por otra excepción. El número de objetos de excepción encadenados de esta
manera puede ser arbitrario.

El valor de estas propiedades se puede especificar en llamadas al constructor de

instancia para System.Exception .

Cómo se controlan las excepciones

Las excepciones se controlan mediante una try instrucción (la instrucción try).

Cuando se produce una excepción, el sistema busca la cláusula más cercana catch que
pueda controlar la excepción, según lo determinado por el tipo en tiempo de ejecución
de la excepción. En primer lugar, se busca una instrucción de inclusión léxica en el
método actual try y las cláusulas Catch asociadas de la instrucción try se consideran en
orden. Si se produce un error, se busca en el método que llamó al método actual una
instrucción de inclusión léxica try que incluye el punto de la llamada al método actual.
Esta búsqueda continúa hasta que catch se encuentra una cláusula que puede controlar
la excepción actual, mediante el nombre de una clase de excepción que es de la misma
clase o una clase base, del tipo en tiempo de ejecución de la excepción que se está
iniciando. Una catch cláusula que no denomina una clase de excepción puede controlar
cualquier excepción.

Una vez que se encuentra una cláusula catch coincidente, el sistema se prepara para
transferir el control a la primera instrucción de la cláusula catch. Antes de que comience
la ejecución de la cláusula catch, el sistema ejecuta en primer lugar, en orden, cualquier
finally cláusula que se asociara con instrucciones try más anidada que la que capturó

la excepción.

Si no se encuentra ninguna cláusula catch coincidente, se produce una de dos cosas:

Si la búsqueda de una cláusula catch coincidente alcanza un constructor estático

(constructores estáticos) o un inicializador de campo estático,
System.TypeInitializationException se produce una excepción en el punto que

desencadenó la invocación del constructor estático. La excepción interna de

 System.TypeInitializationException contiene la excepción que se produjo

originalmente.
Si la búsqueda de cláusulas Catch coincidentes alcanza el código que inició
inicialmente el subproceso, se termina la ejecución del subproceso. El impacto de
dicha terminación está definido por la implementación.

Las excepciones que se producen durante la ejecución de los destructores merecen

mención especial. Si se produce una excepción durante la ejecución del destructor y esa
excepción no se detecta, se finaliza la ejecución de ese destructor y se llama al
destructor de la clase base (si existe). Si no hay ninguna clase base (como en el caso del
object tipo) o si no hay ningún destructor de clase base, se descartará la excepción.

Clases de excepciones comunes

Ciertas operaciones de C# producen las excepciones siguientes.

System.ArithmeticException Una clase base para las excepciones que se producen

durante las operaciones aritméticas, como
System.DivideByZeroException y
System.OverflowException .

System.ArrayTypeMismatchException Se produce cuando se produce un error en un almacén de

una matriz porque el tipo real del elemento almacenado
es incompatible con el tipo real de la matriz.

System.DivideByZeroException Se produce cuando se intenta dividir un valor entero por

cero.

System.IndexOutOfRangeException Se produce cuando se intenta indexar una matriz a través

de un índice que es menor que cero o fuera de los límites
de la matriz.

System.InvalidCastException Se produce cuando se produce un error en el tiempo de

ejecución de una conversión explícita de un tipo base o
una interfaz a un tipo derivado.

System.NullReferenceException Se produce cuando null se utiliza una referencia de una

manera que hace que se requiera el objeto al que se hace
referencia.

System.OutOfMemoryException Se produce cuando se produce un error al intentar asignar

memoria (Via new ).

System.OverflowException Se inicia cuando se desborda una operación aritmética en

un contexto checked .
System.StackOverflowException Se produce cuando la pila de ejecución se agota debido a
que hay demasiadas llamadas a métodos pendientes;
normalmente indica una recursividad muy profunda o sin
enlazar.

System.TypeInitializationException Se produce cuando un constructor estático produce una

excepción y no catch existe ninguna cláusula para
detectarlo.
Atributos
Artículo • 16/09/2021 • Tiempo de lectura: 24 minutos

Gran parte del lenguaje C# permite al programador especificar información declarativa

sobre las entidades definidas en el programa. Por ejemplo, la accesibilidad de un
método en una clase se especifica al decorarlo con el method_modifier s public ,
protected , internal y private .

C# permite a los programadores inventar nuevos tipos de información declarativa,

denominados atributos. Después, los programadores pueden asociar atributos a varias
entidades de programa y recuperar información de atributos en un entorno en tiempo
de ejecución. Por ejemplo, un marco podría definir un HelpAttribute atributo que se
puede colocar en determinados elementos del programa (como clases y métodos) para
proporcionar una asignación de esos elementos de programa a su documentación.

Los atributos se definen a través de la declaración de clases de atributos (clases de

atributos), que pueden tener parámetros con nombre y de posición (parámetros
posicionales y con nombre). Los atributos se asocian a entidades en un programa de C#
mediante especificaciones de atributo (especificación de atributo) y se pueden recuperar
en tiempo de ejecución como instancias de atributo (instancias de atributo).

Clases de atributos
Una clase que deriva de la clase abstracta System.Attribute , ya sea directa o
indirectamente, es una clase * Attribute _. La declaración de una clase de atributo define
un nuevo tipo de _ Attribute* que se puede colocar en una declaración. Por Convención,
las clases de atributo se denominan con el sufijo Attribute . Los usos de un atributo
pueden incluir u omitir este sufijo.

Uso de atributos
El atributo AttributeUsage (el atributo AttributeUsage) se usa para describir cómo se
puede utilizar una clase de atributo.

AttributeUsage tiene un parámetro posicional (parámetros posicionales y con nombre)

que permite que una clase de atributo especifique los tipos de declaraciones en las que
se puede usar. En el ejemplo

C#
 using System;

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface)]

public class SimpleAttribute: Attribute

...

define una clase de atributo denominada SimpleAttribute que se puede colocar solo en
class_declaration s y interface_declaration s. En el ejemplo

C#

[Simple] class Class1 {...}

[Simple] interface Interface1 {...}

muestra varios usos del Simple atributo. Aunque este atributo se define con el nombre
SimpleAttribute , cuando se utiliza este atributo, Attribute se puede omitir el sufijo, lo
que da lugar a un nombre corto Simple . Por lo tanto, el ejemplo anterior es
semánticamente equivalente a lo siguiente:

C#

[SimpleAttribute] class Class1 {...}

[SimpleAttribute] interface Interface1 {...}

AttributeUsage tiene un parámetro con nombre (parámetros posicionales y con

nombre) denominado AllowMultiple , que indica si el atributo se puede especificar más

de una vez para una entidad determinada. Si AllowMultiple para una clase de atributo
es true, esa clase de atributo es una clase de atributo * de uso múltiple _ y se puede
especificar más de una vez en una entidad. Si AllowMultiple para una clase de atributo
es false o no se especifica, esa clase de atributo es una clase de atributo de un solo uso* *
y se puede especificar como máximo una vez en una entidad.

En el ejemplo

C#

using System;

[AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]

public class AuthorAttribute: Attribute

 private string name;

public AuthorAttribute(string name) {

this.name = name;

public string Name {

get { return name; }

define una clase de atributo de varios usos denominada AuthorAttribute . En el ejemplo

C#

[Author("Brian Kernighan"), Author("Dennis Ritchie")]

class Class1

...

muestra una declaración de clase con dos usos del Author atributo.

AttributeUsage tiene otro parámetro con nombre llamado Inherited , que indica si el

atributo, cuando se especifica en una clase base, también es heredado por las clases que
derivan de esa clase base. Si Inherited para una clase de atributo es true, se hereda ese
atributo. Si Inherited para una clase de atributo es false, ese atributo no se hereda. Si
no se especifica, su valor predeterminado es true.

Una clase de atributo que X no tiene un AttributeUsage atributo asociado, como en

C#

using System;

class X: Attribute {...}

es equivalente a lo siguiente:

C#

using System;

[AttributeUsage(

AttributeTargets.All,

AllowMultiple = false,

Inherited = true)

class X: Attribute {...}

Parámetros posicionales y con nombre

Las clases de atributos pueden tener *parámetros posicionales _ y _ parámetros con
nombre *. Cada constructor de instancia público para una clase de atributo define una
secuencia válida de parámetros posicionales para esa clase de atributo. Cada propiedad
y campo de lectura y escritura público no estático para una clase de atributo define un
parámetro con nombre para la clase de atributo.

En el ejemplo

C#

using System;

[AttributeUsage(AttributeTargets.Class)]

public class HelpAttribute: Attribute

public HelpAttribute(string url) { // Positional parameter

...

public string Topic { // Named parameter

get {...}

set {...}

public string Url {

get {...}

define una clase de atributo denominada HelpAttribute que tiene un parámetro

posicional, url , y un parámetro con nombre, Topic . Aunque no es estático y público,
la propiedad no Url define un parámetro con nombre, ya que no es de lectura y
escritura.

Esta clase de atributo se puede utilizar como sigue:

C#

[Help("http://www.mycompany.com/.../Class1.htm")]

class Class1

...

[Help("http://www.mycompany.com/.../Misc.htm", Topic = "Class2")]

class Class2

...

Tipos de parámetros de atributo

Los tipos de parámetros posicionales y con nombre para una clase de atributo se limitan
a los tipos de parámetro de atributo, que son:

Uno de los tipos siguientes: bool , byte , char , double , float , int , long ,
sbyte , short , string , uint , ulong , ushort .
El tipo object .
El tipo System.Type .
Un tipo de enumeración, siempre que tenga accesibilidad pública y los tipos en los
que está anidado (si los hubiera) también tengan accesibilidad pública
(especificación de atributo).
Matrices unidimensionales de los tipos anteriores.
Un argumento de constructor o un campo público que no tiene uno de estos
tipos, no se puede usar como un parámetro posicional o con nombre en una
especificación de atributo.

Especificación de atributo
*Especificación de atributo _ es la aplicación de un atributo definido previamente a una
declaración. Un atributo es un fragmento de información declarativa adicional que se
especifica para una declaración. Los atributos se pueden especificar en el ámbito global
(para especificar atributos en el ensamblado o módulo contenedor) y para
_type_declaration * s (declaraciones de tipos). class_member_declaration s (restricciones
de parámetros de tipo), interface_member_declaration s (miembros de interfaz),
struct_member_declaration s (miembros de struct), enum_member_declaration s
(miembros de enumeración), accessor_declarations (descriptores de acceso),
event_accessor_declarations (eventos similares a campos) y formal_parameter_list s
(parámetros de método).

Los atributos se especifican en las secciones de atributos. Una sección de atributos

consta de un par de corchetes, que rodean una lista separada por comas de uno o más
atributos. El orden en que se especifican los atributos en esta lista y el orden en el que
se organizan las secciones asociadas a la misma entidad de programa no es
significativo. Por ejemplo, las especificaciones de atributo [A][B] ,, [B][A] [A,B] y
[B,A] son equivalentes.

antlr

global_attributes

: global_attribute_section+

global_attribute_section

: '[' global_attribute_target_specifier attribute_list ']'

| '[' global_attribute_target_specifier attribute_list ',' ']'

global_attribute_target_specifier
: global_attribute_target ':'

global_attribute_target

: 'assembly'

| 'module'

attributes

: attribute_section+

attribute_section

: '[' attribute_target_specifier? attribute_list ']'

| '[' attribute_target_specifier? attribute_list ',' ']'

attribute_target_specifier

: attribute_target ':'

attribute_target

: 'field'

| 'event'

| 'method'

| 'param'

| 'property'

| 'return'

| 'type'

attribute_list

: attribute (',' attribute)*

attribute

: attribute_name attribute_arguments?

 attribute_name

: type_name

attribute_arguments

: '(' positional_argument_list? ')'

| '(' positional_argument_list ',' named_argument_list ')'

| '(' named_argument_list ')'

positional_argument_list

: positional_argument (',' positional_argument)*

positional_argument

: attribute_argument_expression

named_argument_list

: named_argument (',' named_argument)*

named_argument

: identifier '=' attribute_argument_expression

attribute_argument_expression

: expression

Un atributo consta de un attribute_name y una lista opcional de argumentos

posicionales y con nombre. Los argumentos posicionales (si existen) preceden a los
argumentos con nombre. Un argumento posicional consta de un
attribute_argument_expression; un argumento con nombre se compone de un nombre
seguido de un signo igual, seguido de una attribute_argument_expression, que, juntos,
están restringidas por las mismas reglas que la asignación simple. El orden de los
argumentos con nombre no es significativo.

El attribute_name identifica una clase de atributo. Si el formato de attribute_name es

type_name , este nombre debe hacer referencia a una clase de atributo. De lo contrario,
se produce un error en tiempo de compilación. En el ejemplo

C#

class Class1 {}

[Class1] class Class2 {} // Error

produce un error en tiempo de compilación porque intenta utilizar Class1 como una
clase de atributos cuando Class1 no es una clase de atributos.

Algunos contextos permiten la especificación de un atributo en más de un destino. Un

programa puede especificar explícitamente el destino incluyendo un
attribute_target_specifier. Cuando se coloca un atributo en el nivel global, se requiere un
global_attribute_target_specifier . En todas las demás ubicaciones, se aplica un valor
predeterminado razonable, pero se puede usar un attribute_target_specifier para
confirmar o invalidar el valor predeterminado en determinados casos ambiguos (o
simplemente se confirma el valor predeterminado en casos no ambiguos). Por lo tanto,
normalmente attribute_target_specifier s se pueden omitir, excepto en el nivel global. Los
contextos potencialmente ambiguos se resuelven de la siguiente manera:

Un atributo especificado en el ámbito global puede aplicarse al ensamblado de

destino o al módulo de destino. No existe ningún valor predeterminado para este
contexto, por lo que siempre se requiere un attribute_target_specifier en este
contexto. La presencia de la assembly attribute_target_specifier indica que el
atributo se aplica al ensamblado de destino; la presencia del module
attribute_target_specifier indica que el atributo se aplica al módulo de destino.
Un atributo especificado en una declaración de delegado se puede aplicar al
delegado que se está declarando o a su valor devuelto. En ausencia de un
attribute_target_specifier, el atributo se aplica al delegado. La presencia de la type
attribute_target_specifier indica que el atributo se aplica al delegado; la presencia
del return attribute_target_specifier indica que el atributo se aplica al valor
devuelto.
Un atributo especificado en una declaración de método se puede aplicar al
método que se declara o a su valor devuelto. En ausencia de un
attribute_target_specifier, el atributo se aplica al método. La presencia de la method
attribute_target_specifier indica que el atributo se aplica al método; la presencia del
return attribute_target_specifier indica que el atributo se aplica al valor devuelto.

Un atributo especificado en una declaración de operador puede aplicarse al

operador que se declara o a su valor devuelto. En ausencia de un
attribute_target_specifier, el atributo se aplica al operador. La presencia de la
method attribute_target_specifier indica que el atributo se aplica al operador; la

presencia del return attribute_target_specifier indica que el atributo se aplica al

valor devuelto.
Un atributo especificado en una declaración de evento que omite los descriptores
de acceso de eventos se puede aplicar al evento que se está declarando, al campo
asociado (si el evento no es abstracto) o a los métodos Add y Remove asociados.
En ausencia de un attribute_target_specifier, el atributo se aplica al evento. La
 presencia de la event attribute_target_specifier indica que el atributo se aplica al
evento; la presencia del field attribute_target_specifier indica que el atributo se
aplica al campo; y la presencia de la method attribute_target_specifier indica que el
atributo se aplica a los métodos.
Un atributo especificado en una declaración de descriptor de acceso get para una
declaración de propiedad o indizador se puede aplicar al método asociado o a su
valor devuelto. En ausencia de un attribute_target_specifier, el atributo se aplica al
método. La presencia de la method attribute_target_specifier indica que el atributo
se aplica al método; la presencia del return attribute_target_specifier indica que el
atributo se aplica al valor devuelto.
Un atributo especificado en un descriptor de acceso set para una declaración de
propiedad o indizador se puede aplicar al método asociado o a su propio
parámetro implícito. En ausencia de un attribute_target_specifier, el atributo se
aplica al método. La presencia de la method attribute_target_specifier indica que el
atributo se aplica al método; la presencia del param attribute_target_specifier indica
que el atributo se aplica al parámetro; la presencia del return
attribute_target_specifier indica que el atributo se aplica al valor devuelto.
Un atributo especificado en una declaración de descriptor de acceso Add o
Remove para una declaración de evento se puede aplicar al método asociado o a
su propio parámetro. En ausencia de un attribute_target_specifier, el atributo se
aplica al método. La presencia de la method attribute_target_specifier indica que el
atributo se aplica al método; la presencia del param attribute_target_specifier indica
que el atributo se aplica al parámetro; la presencia del return
attribute_target_specifier indica que el atributo se aplica al valor devuelto.

En otros contextos, se permite la inclusión de un attribute_target_specifier , pero no es

necesario. Por ejemplo, una declaración de clase puede incluir u omitir el especificador
type :

C#

[type: Author("Brian Kernighan")]

class Class1 {}

[Author("Dennis Ritchie")]

class Class2 {}

Es un error especificar una attribute_target_specifier no válida. Por ejemplo, el

especificador param no se puede usar en una declaración de clase:

C#
 [param: Author("Brian Kernighan")] // Error

class Class1 {}

Por Convención, las clases de atributo se denominan con el sufijo Attribute . Un

attribute_name del formulario type_name puede incluir u omitir este sufijo. Si se
encuentra una clase de atributo con y sin este sufijo, existe una ambigüedad y se
produce un error en tiempo de compilación. Si el attribute_name está escrito de modo
que su identificador situado más a la derecha sea un identificador textual
(identificadores), solo se hace coincidir un atributo sin sufijo, lo que permite resolver
este tipo de ambigüedad. En el ejemplo

C#

using System;

[AttributeUsage(AttributeTargets.All)]

public class X: Attribute

{}

[AttributeUsage(AttributeTargets.All)]

public class XAttribute: Attribute

{}

[X] // Error: ambiguity

class Class1 {}

[XAttribute] // Refers to XAttribute

class Class2 {}

[@X] // Refers to X

class Class3 {}

[@XAttribute] // Refers to XAttribute

class Class4 {}

muestra dos clases de atributos denominadas X y XAttribute . El atributo [X] es

ambiguo, ya que podría hacer referencia a X o XAttribute . El uso de un identificador
textual permite especificar la intención exacta en estos casos raros. El atributo
[XAttribute] no es ambiguo (aunque sería si hubiera una clase de atributo denominada
XAttributeAttribute !). Si se quita la declaración de la clase X , ambos atributos hacen

referencia a la clase de atributo denominada XAttribute , como se indica a

continuación:

C#
 using System;

[AttributeUsage(AttributeTargets.All)]

public class XAttribute: Attribute

{}

[X] // Refers to XAttribute

class Class1 {}

[XAttribute] // Refers to XAttribute

class Class2 {}

[@X] // Error: no attribute named "X"

class Class3 {}

Es un error en tiempo de compilación utilizar una clase de atributo de un solo uso más
de una vez en la misma entidad. En el ejemplo

C#

using System;

[AttributeUsage(AttributeTargets.Class)]

public class HelpStringAttribute: Attribute

string value;

public HelpStringAttribute(string value) {

this.value = value;

public string Value {

get {...}

[HelpString("Description of Class1")]

[HelpString("Another description of Class1")]

public class Class1 {}

produce un error en tiempo de compilación porque intenta utilizar HelpString , que es

una clase de atributo de un solo uso, más de una vez en la declaración de Class1 .

Una expresión E es una attribute_argument_expression si se cumplen todas las

instrucciones siguientes:

El tipo de E es un tipo de parámetro de atributo (tipos de parámetro de atributo).

En tiempo de compilación, el valor de E se puede resolver como uno de los
siguientes:
 Valor constante
Un objeto System.Type .
Matriz unidimensional de attribute_argument_expression s.

Por ejemplo:

C#

using System;

[AttributeUsage(AttributeTargets.Class)]

public class TestAttribute: Attribute

public int P1 {

get {...}

set {...}

public Type P2 {

get {...}

set {...}

public object P3 {

get {...}

set {...}

[Test(P1 = 1234, P3 = new int[] {1, 3, 5}, P2 = typeof(float))]

class MyClass {}

Una typeof_expression (el operador typeof) utilizada como expresión de argumento de

atributo puede hacer referencia a un tipo no genérico, un tipo construido cerrado o un
tipo genérico sin enlazar, pero no puede hacer referencia a un tipo abierto. Esto es para
asegurarse de que la expresión se puede resolver en tiempo de compilación.

C#

class A: Attribute

public A(Type t) {...}

class G<T>

[A(typeof(T))] T t; // Error, open type in attribute

class X

 [A(typeof(List<int>))] int x; // Ok, closed constructed type

[A(typeof(List<>))] int y; // Ok, unbound generic type

Instancias de atributos
Una instancia de atributo es una instancia de que representa un atributo en tiempo de
ejecución. Un atributo se define con una clase de atributo, argumentos posicionales y
argumentos con nombre. Una instancia de atributo es una instancia de la clase de
atributos que se inicializa con los argumentos posicionales y con nombre.

La recuperación de una instancia de atributo implica el procesamiento en tiempo de

compilación y en tiempo de ejecución, como se describe en las secciones siguientes.

Compilación de un atributo
La compilación de un atributo con la clase de atributo T , positional_argument_list P y
named_argument_list N , consta de los siguientes pasos:

Siga los pasos de procesamiento en tiempo de compilación para compilar un

object_creation_expression del formulario new T(P) . Estos pasos dan como
resultado un error en tiempo de compilación o determinan un constructor C de
instancia en T que se puede invocar en tiempo de ejecución.
Si no C tiene accesibilidad pública, se produce un error en tiempo de compilación.
Para cada named_argument Arg en N :
Supongamos que Name es el identificador de la named_argument Arg .
Name debe identificar una propiedad o un campo público de lectura/escritura

no estático en T . Si T no tiene este campo o propiedad, se produce un error

en tiempo de compilación.
Mantenga la siguiente información para la creación de instancias en tiempo de
ejecución del atributo: la clase de atributo T , el constructor C de instancia en T ,
el positional_argument_list P y el named_argument_list N .

Recuperación en tiempo de ejecución de una instancia de

atributo
La compilación de un atributo produce una clase de atributo T , un constructor C de
instancia en T , un positional_argument_list P y un named_argument_list N . Dada esta
información, una instancia de atributo se puede recuperar en tiempo de ejecución
mediante los pasos siguientes:
 Siga los pasos de procesamiento en tiempo de ejecución para ejecutar una
object_creation_expression del formulario new T(P) , mediante el constructor de
instancia, C tal y como se determina en tiempo de compilación. Estos pasos dan
como resultado una excepción o producen una instancia O de T .
Para cada named_argument Arg en N , en orden:
Supongamos que Name es el identificador de la named_argument Arg . Si Name
no identifica una propiedad o un campo de lectura/escritura público no estático
en O , se produce una excepción.
Supongamos Value el resultado de evaluar el attribute_argument_expression de
Arg .

Si Name identifica un campo en O , establezca este campo en Value .

De lo contrario, Name identifica una propiedad en O . Establezca esta propiedad
en Value .
El resultado es O , una instancia de la clase de atributos que se ha T inicializado
con el positional_argument_list P y el named_argument_list N .

Atributos reservados
Un pequeño número de atributos afecta al lenguaje de alguna manera. Estos atributos
incluyen lo siguiente:

System.AttributeUsageAttribute (El atributo AttributeUsage), que se usa para

describir las maneras en las que se puede usar una clase de atributo.
System.Diagnostics.ConditionalAttribute (El atributo Conditional), que se usa
para definir métodos condicionales.
System.ObsoleteAttribute (El atributo obsoleto), que se usa para marcar un

miembro como obsoleto.

System.Runtime.CompilerServices.CallerLineNumberAttribute ,

System.Runtime.CompilerServices.CallerFilePathAttribute y
System.Runtime.CompilerServices.CallerMemberNameAttribute (atributos de

información del llamador), que se usan para proporcionar información sobre el

contexto de llamada a los parámetros opcionales.

El atributo AttributeUsage
El atributo AttributeUsage se utiliza para describir la forma en que se puede usar la
clase de atributo.
Una clase que se decora con el AttributeUsage atributo debe derivarse de
System.Attribute , ya sea directa o indirectamente. De lo contrario, se produce un error
en tiempo de compilación.

C#

namespace System

[AttributeUsage(AttributeTargets.Class)]

public class AttributeUsageAttribute: Attribute

public AttributeUsageAttribute(AttributeTargets validOn) {...}

public virtual bool AllowMultiple { get {...} set {...} }

public virtual bool Inherited { get {...} set {...} }

public virtual AttributeTargets ValidOn { get {...} }

public enum AttributeTargets

Assembly = 0x0001,

Module = 0x0002,

Class = 0x0004,

Struct = 0x0008,

Enum = 0x0010,

Constructor = 0x0020,

Method = 0x0040,

Property = 0x0080,

Field = 0x0100,

Event = 0x0200,

Interface = 0x0400,

Parameter = 0x0800,

Delegate = 0x1000,

ReturnValue = 0x2000,

All = Assembly | Module | Class | Struct | Enum | Constructor |

Method | Property | Field | Event | Interface | Parameter |

Delegate | ReturnValue

El atributo Conditional
El atributo Conditional habilita la definición de *métodos condicionales _ y _ clases de
atributos condicionales *.

C#

namespace System.Diagnostics

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class,
 AllowMultiple = true)]

public class ConditionalAttribute: Attribute

public ConditionalAttribute(string conditionString) {...}

public string ConditionString { get {...} }

Métodos condicionales
Un método decorado con el Conditional atributo es un método condicional. El
Conditional atributo indica una condición mediante la prueba de un símbolo de

compilación condicional. Las llamadas a un método condicional se incluyen o se omiten

en función de si este símbolo se define en el punto de la llamada. Si se define el
símbolo, se incluye la llamada; de lo contrario, se omite la llamada (incluida la
evaluación del receptor y los parámetros de la llamada).

Un método condicional está sujeto a las siguientes restricciones:

El método condicional debe ser un método en un class_declaration o

struct_declaration. Se produce un error en tiempo de compilación si el Conditional
atributo se especifica en un método en una declaración de interfaz.
El método condicional debe tener un tipo de valor devuelto de void .
El método condicional no debe estar marcado con el override modificador. Sin
embargo, un método condicional se puede marcar con el virtual modificador. Las
invalidaciones de este tipo de método son implícitamente condicionales y no
deben marcarse explícitamente con un Conditional atributo.
El método condicional no debe ser una implementación de un método de interfaz.
De lo contrario, se produce un error en tiempo de compilación.

Además, se produce un error en tiempo de compilación si se utiliza un método

condicional en una delegate_creation_expression. En el ejemplo

C#

#define DEBUG

using System;

using System.Diagnostics;

class Class1

[Conditional("DEBUG")]

public static void M() {

Console.WriteLine("Executed Class1.M");

class Class2

public static void Test() {

Class1.M();

declara Class1.M como un método condicional. Class2``Test el método de llama a este

método. Dado que se define el símbolo de compilación condicional DEBUG , si
Class2.Test se llama a, se llamará a M . Si DEBUG no se ha definido el símbolo,

Class2.Test no llamará a Class1.M .

Es importante tener en cuenta que la inclusión o exclusión de una llamada a un método

condicional se controla mediante los símbolos de compilación condicional en el punto
de la llamada. En el ejemplo

Archivo class1.cs :

C#

using System.Diagnostics;

class Class1

[Conditional("DEBUG")]

public static void F() {

Console.WriteLine("Executed Class1.F");

Archivo class2.cs :

C#

#define DEBUG

class Class2

public static void G() {

Class1.F(); // F is called

Archivo class3.cs :
 C#

#undef DEBUG

class Class3

public static void H() {

Class1.F(); // F is not called

las clases Class2 y Class3 cada una contienen llamadas al método condicional
Class1.F , que es condicional en función de si se ha definido o no DEBUG . Puesto que

este símbolo se define en el contexto de Class2 pero no Class3 , se incluye la llamada a

F en Class2 , mientras que la llamada a F en Class3 se omite.

El uso de métodos condicionales en una cadena de herencia puede ser confuso. Las
llamadas realizadas a un método condicional a través base de, del formulario base.M ,
están sujetas a las reglas de llamada de método condicional normales. En el ejemplo

Archivo class1.cs :

C#

using System;

using System.Diagnostics;

class Class1

[Conditional("DEBUG")]

public virtual void M() {

Console.WriteLine("Class1.M executed");

Archivo class2.cs :

C#

using System;

class Class2: Class1

public override void M() {

Console.WriteLine("Class2.M executed");

base.M(); // base.M is not called!

Archivo class3.cs :

C#

#define DEBUG

using System;

class Class3

public static void Test() {

Class2 c = new Class2();

c.M(); // M is called

Class2 incluye una llamada al M definido en su clase base. Esta llamada se omite

porque el método base es condicional en función de la presencia del símbolo DEBUG ,

que no está definida. Por lo tanto, el método solo escribe en la consola " Class2.M
executed ". El uso prudente de pp_declaration s puede eliminar tales problemas.

Clases de atributos condicionales

Una clase de atributo (clases de atributos) decorada con uno o varios Conditional
atributos es una clase de atributo condicional. Por tanto, una clase de atributo
condicional está asociada a los símbolos de compilación condicional declarados en sus
Conditional atributos. En este ejemplo:

C#

using System;

using System.Diagnostics;

[Conditional("ALPHA")]

[Conditional("BETA")]

public class TestAttribute : Attribute {}

declara TestAttribute como una clase de atributo condicional asociada a los símbolos
de compilaciones condicionales ALPHA y BETA .

Las especificaciones de atributo (especificación de atributo) de un atributo condicional

se incluyen si uno o varios de sus símbolos de compilación condicional asociados se
definen en el punto de especificación; de lo contrario, se omite la especificación de
atributo.
Es importante tener en cuenta que la inclusión o exclusión de una especificación de
atributo de una clase de atributo condicional se controla mediante los símbolos de
compilación condicional en el punto de la especificación. En el ejemplo

Archivo test.cs :

C#

using System;

using System.Diagnostics;

[Conditional("DEBUG")]

public class TestAttribute : Attribute {}

Archivo class1.cs :

C#

#define DEBUG

[Test] // TestAttribute is specified

class Class1 {}

Archivo class2.cs :

C#

#undef DEBUG

[Test] // TestAttribute is not specified

class Class2 {}

cada una de las clases Class1 y Class2 se decoran con el atributo Test , que es
condicional en función de si se ha definido o no DEBUG . Puesto que este símbolo se
define en el contexto de Class1 pero no Class2 , se incluye la especificación del Test
atributo en Class1 , mientras que la especificación del Test atributo en Class2 se
omite.

El atributo Obsolete
El atributo Obsolete se usa para marcar tipos y miembros de tipos que ya no se deben
usar.
 C#

namespace System

[AttributeUsage(

AttributeTargets.Class |
AttributeTargets.Struct |
AttributeTargets.Enum |

AttributeTargets.Interface |

AttributeTargets.Delegate |

AttributeTargets.Method |

AttributeTargets.Constructor |

AttributeTargets.Property |

AttributeTargets.Field |

AttributeTargets.Event,

Inherited = false)

public class ObsoleteAttribute: Attribute

public ObsoleteAttribute() {...}

public ObsoleteAttribute(string message) {...}

public ObsoleteAttribute(string message, bool error) {...}

public string Message { get {...} }

public bool IsError { get {...} }

Si un programa utiliza un tipo o un miembro que se decora con el Obsolete atributo, el

compilador emite una advertencia o un error. En concreto, el compilador emite una
advertencia si no se proporciona ningún parámetro de error, o si se proporciona el
parámetro de error y tiene el valor false . El compilador emite un error si se especifica
el parámetro de error y tiene el valor true .

En el ejemplo

C#

[Obsolete("This class is obsolete; use class B instead")]

class A

public void F() {}

class B

public void F() {}

class Test

static void Main() {

 A a = new A(); // Warning

a.F();

la clase A se decora con el Obsolete atributo. Cada uso de A en Main genera una
advertencia que incluye el mensaje especificado, "esta clase está obsoleta; Use la clase B
en su lugar ".

Atributos de información del llamador

Para fines como registro e informes, a veces resulta útil que un miembro de función
obtenga determinada información en tiempo de compilación sobre el código de
llamada. Los atributos de información del llamador proporcionan una manera de pasar
tal información de forma transparente.

Cuando un parámetro opcional se anota con uno de los atributos de información del
llamador, la omisión del argumento correspondiente en una llamada no hace que el
valor del parámetro predeterminado se sustituya. En su lugar, si la información
especificada sobre el contexto de la llamada está disponible, esa información se pasará
como el valor del argumento.

Por ejemplo:

C#

using System.Runtime.CompilerServices

...

public void Log(

[CallerLineNumber] int line = -1,

[CallerFilePath] string path = null,

[CallerMemberName] string name = null

Console.WriteLine((line < 0) ? "No line" : "Line "+ line);

Console.WriteLine((path == null) ? "No file path" : path);

Console.WriteLine((name == null) ? "No member name" : name);

Una llamada a Log() sin argumentos imprimiría el número de línea y la ruta de acceso
del archivo de la llamada, así como el nombre del miembro en el que se produjo la
llamada.
Los atributos de información del llamador se pueden producir en parámetros opcionales
en cualquier parte, incluidas en las declaraciones de delegado. Sin embargo, los
atributos de información del llamador específico tienen restricciones en los tipos de los
parámetros que pueden atribuir, de modo que siempre habrá una conversión implícita
de un valor sustituido al tipo de parámetro.

Es un error tener el mismo atributo de información de llamador en un parámetro de la

parte de definición e implementación de una declaración de método parcial. Solo se
aplican los atributos de información de llamador en el elemento de definición, mientras
que los atributos de información de llamador que se producen solo en la parte de
implementación se omiten.

La información del llamador no afecta a la resolución de sobrecarga. Como los

parámetros opcionales con atributos se siguen omitiendo del código fuente del
llamador, la resolución de sobrecarga omite esos parámetros de la misma manera que
omite otros parámetros opcionales omitidos (resolución de sobrecarga).

La información del llamador solo se sustituye cuando una función se invoca

explícitamente en el código fuente. Las invocaciones implícitas como las llamadas a un
constructor primario implícito no tienen una ubicación de origen y no sustituyen la
información del llamador. Además, las llamadas que se enlazan dinámicamente no
sustituirán la información del llamador. Cuando se omite un parámetro con atributos de
información de llamador en estos casos, se utiliza en su lugar el valor predeterminado
especificado del parámetro.

Una excepción son las expresiones de consulta. Se consideran expansiones sintácticas y,

si las llamadas se expanden para omitir los parámetros opcionales con atributos de
información de llamador, se sustituirá la información del llamador. La ubicación usada es
la ubicación de la cláusula de consulta a partir de la cual se generó la llamada.

Si se especifica más de un atributo de información de llamador en un parámetro

determinado, se prefieren en el orden siguiente: CallerLineNumber , CallerFilePath ,
CallerMemberName .

El atributo CallerLineNumber
System.Runtime.CompilerServices.CallerLineNumberAttribute Se permite en parámetros

opcionales cuando hay una conversión implícita estándar (conversiones implícitas

estándar) del valor constante int.MaxValue al tipo del parámetro. Esto garantiza que
cualquier número de línea no negativo hasta ese valor se puede pasar sin errores.
Si una invocación de función de una ubicación en el código fuente omite un parámetro
opcional con CallerLineNumberAttribute , se usa un literal numérico que representa el
número de línea de la ubicación como argumento para la invocación en lugar del valor
de parámetro predeterminado.

Si la invocación abarca varias líneas, la línea elegida depende de la implementación.

Tenga en cuenta que el número de línea puede verse afectado por las #line directivas
(directivas de línea).

El atributo CallerFilePath

System.Runtime.CompilerServices.CallerFilePathAttribute Se permite en parámetros

opcionales cuando hay una conversión implícita estándar (conversiones implícitas
estándar) de string en el tipo del parámetro.

Si una invocación de función de una ubicación en el código fuente omite un parámetro

opcional con CallerFilePathAttribute , entonces se usa un literal de cadena que
representa la ruta de acceso del archivo de la ubicación como argumento para la
invocación en lugar del valor del parámetro predeterminado.

El formato de la ruta de acceso del archivo depende de la implementación.

Tenga en cuenta que la ruta de acceso al archivo puede verse afectada por las #line
directivas (directivas de línea).

El atributo CallerMemberName
System.Runtime.CompilerServices.CallerMemberNameAttribute Se permite en parámetros

opcionales cuando hay una conversión implícita estándar (conversiones implícitas

estándar) de string en el tipo del parámetro.

Si una invocación de función desde una ubicación dentro del cuerpo de un miembro de
función o dentro de un atributo aplicado al propio miembro de la función o a su tipo de
valor devuelto, parámetros o parámetros de tipo en el código fuente omite un
parámetro opcional con CallerMemberNameAttribute , se usa un literal de cadena que
representa el nombre de ese miembro como argumento para la invocación en lugar del
valor del parámetro predeterminado

En el caso de las invocaciones que se producen dentro de métodos genéricos, solo se

usa el nombre del método en sí, sin la lista de parámetros de tipo.
En el caso de las invocaciones que se producen dentro de implementaciones explícitas
de miembros de interfaz, solo se usa el nombre del método en sí, sin la calificación de
interfaz anterior.

En el caso de las invocaciones que se producen dentro de los descriptores de acceso de

propiedades o eventos, el nombre de miembro utilizado es el de la propiedad o el
propio evento.

En el caso de las invocaciones que se producen dentro de los descriptores de acceso del
indizador, el nombre de miembro utilizado es el proporcionado por un
IndexerNameAttribute (el atributo IndexerName) en el miembro del indexador, si está
presente, o el nombre predeterminado Item en caso contrario.

En el caso de las invocaciones que se producen dentro de las declaraciones de

constructores de instancias, constructores estáticos, destructores y operadores, el
nombre de miembro utilizado depende de la implementación.

Atributos para la interoperación

Nota: esta sección solo es aplicable a la implementación de Microsoft .NET de C#.

Interoperación con componentes COM y Win32

El tiempo de ejecución de .NET proporciona un gran número de atributos que permiten
a los programas de C# interoperar con los componentes escritos mediante archivos dll
de Win32 y COM. Por ejemplo, el DllImport atributo se puede utilizar en un static
extern método para indicar que la implementación del método se va a encontrar en un

archivo dll de Win32. Estos atributos se encuentran en el

System.Runtime.InteropServices espacio de nombres y la documentación detallada de
estos atributos se encuentra en la documentación de .net Runtime.

Interoperación con otros lenguajes .NET

El atributo IndexerName
Los indizadores se implementan en .NET mediante propiedades indizadas y tienen un
nombre en los metadatos de .NET. Si no hay ningún IndexerName atributo presente para
un indexador, se usa el nombre de Item forma predeterminada. El IndexerName atributo
permite a un desarrollador reemplazar este valor predeterminado y especificar otro
nombre.
C#

namespace System.Runtime.CompilerServices.CSharp

[AttributeUsage(AttributeTargets.Property)]

public class IndexerNameAttribute: Attribute

public IndexerNameAttribute(string indexerName) {...}

public string Value { get {...} }

Código no seguro
Artículo • 16/09/2021 • Tiempo de lectura: 37 minutos

El lenguaje C# básico, tal como se define en los capítulos anteriores, difiere

principalmente de C y C++ en su omisión de punteros como un tipo de datos. En su
lugar, C# proporciona referencias y la capacidad de crear objetos administrados por un
recolector de elementos no utilizados. Este diseño, junto con otras características, hace
que C# sea un lenguaje mucho más seguro que C o C++. En el lenguaje C# básico,
simplemente no es posible tener una variable no inicializada, un puntero "pendiente" o
una expresión que indiza una matriz más allá de sus límites. Por lo tanto, se eliminan
todas las categorías de errores que suelen plagar programas de C y C++.

Aunque prácticamente todas las construcciones de tipo de puntero en C o C++ tienen

un tipo de referencia homólogo en C#, sin embargo, hay situaciones en las que el
acceso a los tipos de puntero se convierte en una necesidad. Por ejemplo, la interacción
con el sistema operativo subyacente, el acceso a un dispositivo asignado a la memoria o
la implementación de un algoritmo crítico en el tiempo puede no ser posible ni práctico
sin acceso a los punteros. Para satisfacer esta necesidad, C# ofrece la posibilidad de
escribir código no seguro.

En código no seguro es posible declarar y operar en punteros, para realizar

conversiones entre punteros y tipos enteros, para tomar la dirección de las variables, etc.
En cierto sentido, escribir código no seguro es muy similar a escribir código de C en un
programa de C#.

En realidad, el código no seguro es una característica "segura" desde la perspectiva de

los desarrolladores y los usuarios. El código no seguro debe estar claramente marcado
con el modificador unsafe , por lo que los desarrolladores no pueden usar
características no seguras accidentalmente, y el motor de ejecución funciona para
asegurarse de que el código no seguro no se puede ejecutar en un entorno que no es
de confianza.

Contextos no seguros
Las características no seguras de C# solo están disponibles en contextos no seguros. Un
contexto no seguro se introduce mediante la inclusión de un unsafe modificador en la
declaración de un tipo o miembro, o mediante la utilización de un unsafe_statement:

Una declaración de una clase, un struct, una interfaz o un delegado puede incluir
un unsafe modificador, en cuyo caso toda la extensión textual de esa declaración
 de tipos (incluido el cuerpo de la clase, el struct o la interfaz) se considera un
contexto no seguro.
Una declaración de un campo, un método, una propiedad, un evento, un
indexador, un operador, un constructor de instancia, un destructor o un
constructor estático puede incluir un unsafe modificador, en cuyo caso toda la
extensión textual de dicha declaración de miembro se considera un contexto no
seguro.
Un unsafe_statement habilita el uso de un contexto no seguro dentro de un bloque.
Toda la extensión textual del bloque asociado se considera un contexto no seguro.

A continuación se muestran las producciones de gramática asociadas.

antlr

class_modifier_unsafe

: 'unsafe'

struct_modifier_unsafe

: 'unsafe'

interface_modifier_unsafe

: 'unsafe'

delegate_modifier_unsafe

: 'unsafe'

field_modifier_unsafe

: 'unsafe'

method_modifier_unsafe

: 'unsafe'

property_modifier_unsafe

: 'unsafe'

event_modifier_unsafe

: 'unsafe'

indexer_modifier_unsafe

: 'unsafe'

operator_modifier_unsafe

 : 'unsafe'

constructor_modifier_unsafe

: 'unsafe'

destructor_declaration_unsafe

: attributes? 'extern'? 'unsafe'? '~' identifier '(' ')' destructor_body

| attributes? 'unsafe'? 'extern'? '~' identifier '(' ')' destructor_body

static_constructor_modifiers_unsafe

: 'extern'? 'unsafe'? 'static'

| 'unsafe'? 'extern'? 'static'

| 'extern'? 'static' 'unsafe'?

| 'unsafe'? 'static' 'extern'?

| 'static' 'extern'? 'unsafe'?

| 'static' 'unsafe'? 'extern'?

embedded_statement_unsafe

: unsafe_statement

| fixed_statement

unsafe_statement

: 'unsafe' block

En el ejemplo

C#

public unsafe struct Node

public int Value;

public Node* Left;

public Node* Right;

el unsafe modificador especificado en la declaración de estructura hace que la

extensión textual completa de la declaración de estructura se convierta en un contexto
no seguro. Por lo tanto, es posible declarar los Left Right campos y para que sean de
un tipo de puntero. También se puede escribir el ejemplo anterior.

C#

public struct Node

public int Value;

 public unsafe Node* Left;

public unsafe Node* Right;

Aquí, los unsafe modificadores de las declaraciones de campo hacen que esas
declaraciones se consideren contextos no seguros.

Además de establecer un contexto no seguro, lo que permite el uso de tipos de

puntero, el unsafe modificador no tiene ningún efecto en un tipo o miembro. En el
ejemplo

C#

public class A

public unsafe virtual void F() {

char* p;

...

public class B: A

public override void F() {

base.F();

...

el unsafe modificador del F método en A simplemente hace que la extensión textual

de se F convierta en un contexto no seguro en el que se pueden usar las características
no seguras del lenguaje. En la invalidación de F en B , no es necesario volver a
especificar el unsafe modificador, a menos que, por supuesto, el F método de B sí
mismo necesite acceso a características no seguras.

La situación es ligeramente diferente cuando un tipo de puntero forma parte de la

Signatura del método.

C#

public unsafe class A

public virtual void F(char* p) {...}

public class B: A

 public unsafe override void F(char* p) {...}

Aquí, dado F que la firma de incluye un tipo de puntero, solo se puede escribir en un
contexto no seguro. Sin embargo, el contexto no seguro se puede introducir haciendo
que la clase completa sea insegura, como es el caso en A , o incluyendo un unsafe
modificador en la declaración del método, como es el caso B de.

Tipos de puntero
En un contexto no seguro, un tipo (tipos) puede ser un pointer_type , así como un
value_type o un reference_type. Sin embargo, un pointer_type también puede usarse en
una typeof expresión (expresiones de creación de objetos anónimos) fuera de un
contexto no seguro, ya que dicho uso no es seguro.

antlr

type_unsafe

: pointer_type

Un pointer_type se escribe como un unmanaged_type o la palabra clave void , seguido

de un * token:

antlr

pointer_type

: unmanaged_type '*'

| 'void' '*'

unmanaged_type

: type

El tipo especificado antes de * en un tipo de puntero se denomina tipo referente del

tipo de puntero. Representa el tipo de la variable a la que apunta un valor del tipo de
puntero.

A diferencia de las referencias (valores de tipos de referencia), el recolector de

elementos no utilizados no realiza un seguimiento de los punteros; el recolector de
elementos no utilizados no tiene conocimiento de los punteros y los datos a los que
apuntan. Por esta razón, no se permite que un puntero señale a una referencia o a un
struct que contenga referencias, y el tipo referente de un puntero debe ser un
unmanaged_type.

Un unmanaged_type es cualquier tipo que no sea un tipo reference_type o construido y

que no contenga campos de tipo reference_type o construido en ningún nivel de
anidamiento. En otras palabras, una unmanaged_type es una de las siguientes:

sbyte , byte , short , ushort , int , uint , long , ulong , char , float , double ,

decimal o bool .
Cualquier enum_type.
Cualquier pointer_type.
Cualquier struct_type definido por el usuario que no sea un tipo construido y que
contenga campos de unmanaged_type s solamente.

La regla intuitiva para la combinación de punteros y referencias es que los referentes de

referencias (objetos) pueden contener punteros, pero los referentes de punteros no
pueden contener referencias.

En la tabla siguiente se proporcionan algunos ejemplos de tipos de puntero:

Ejemplo Descripción

byte* Puntero en byte

char* Puntero en char

int** Puntero al puntero a int

int*[] Matriz unidimensional de punteros a int

void* Puntero a un tipo desconocido

Para una implementación determinada, todos los tipos de puntero deben tener el
mismo tamaño y representación.

A diferencia de C y C++, cuando se declaran varios punteros en la misma declaración,

en C# el * se escribe junto con el tipo subyacente únicamente, no como un signo de
puntuación de prefijo en cada nombre de puntero. Por ejemplo

C#

int* pi, pj; // NOT as int *pi, *pj;

El valor de un puntero que tiene un tipo T* representa la dirección de una variable de

tipo T . El operador de direccionamiento indirecto del puntero * (direccionamiento
indirecto del puntero) se puede usar para tener acceso a esta variable. Por ejemplo,
dada una variable P de tipo int* , la expresión *P denota la variable que int se
encuentra en la dirección contenida en P .

Al igual que una referencia de objeto, un puntero puede ser null . Al aplicar el
operador de direccionamiento indirecto a un null puntero, se produce un
comportamiento definido por la implementación. Un puntero con valor null se
representa mediante All-bits-cero.

El void* tipo representa un puntero a un tipo desconocido. Dado que el tipo referente
es desconocido, el operador de direccionamiento indirecto no se puede aplicar a un
puntero de tipo void* , ni se puede realizar ninguna operación aritmética en dicho
puntero. Sin embargo, un puntero de tipo void* se puede convertir a cualquier otro
tipo de puntero (y viceversa).

Los tipos de puntero son una categoría independiente de tipos. A diferencia de los tipos
de referencia y los tipos de valor, los tipos de puntero no heredan de object y no
existen conversiones entre tipos de puntero y object . En concreto, no se admiten las
conversiones boxing y unboxing (conversión boxing y unboxing) para los punteros. Sin
embargo, se permiten conversiones entre diferentes tipos de puntero y entre tipos de
puntero y tipos enteros. Esto se describe en conversiones de puntero.

No se puede usar un pointer_type como argumento de tipo (tipos construidos) y se

produce un error en la inferencia de tipos (inferencia de tipos) en llamadas a métodos
genéricos que habrían deducido un argumento de tipo para que sea un tipo de puntero.

Un pointer_type se puede usar como el tipo de un campo volátil (campos volátiles).

Aunque los punteros se pueden pasar ref como out parámetros o, esto puede
provocar un comportamiento indefinido, ya que el puntero se puede establecer para
que apunte a una variable local que ya no existe cuando el método llamado vuelve, o al
objeto fijo al que se ha usado para apuntar, ya no se ha corregido. Por ejemplo:

C#

using System;

class Test

static int value = 20;

unsafe static void F(out int* pi1, ref int* pi2) {

int i = 10;

pi1 = &i;

 fixed (int* pj = &value) {

// ...

pi2 = pj;

static void Main() {

int i = 10;

unsafe {

int* px1;

int* px2 = &i;

F(out px1, ref px2);

Console.WriteLine("*px1 = {0}, *px2 = {1}",

*px1, *px2); // undefined behavior

Un método puede devolver un valor de algún tipo y ese tipo puede ser un puntero. Por
ejemplo, cuando se proporciona un puntero a una secuencia contigua de int s, el
recuento de elementos de la secuencia y otro int valor, el método siguiente devuelve la
dirección de ese valor en esa secuencia, si se produce una coincidencia; de lo contrario,
devuelve null :

C#

unsafe static int* Find(int* pi, int size, int value) {

for (int i = 0; i < size; ++i) {

if (*pi == value)

return pi;

++pi;

return null;

En un contexto no seguro, hay varias construcciones disponibles para trabajar en

punteros:

El * operador se puede utilizar para realizar la direccionamiento indirecto del

puntero (direccionamiento indirecto del puntero).
El -> operador se puede utilizar para tener acceso a un miembro de un struct a
través de un puntero (acceso a miembros de puntero).
El [] operador se puede utilizar para indizar un puntero (acceso a elementos de
puntero).
 El & operador se puede utilizar para obtener la dirección de una variable (el
operador Address-of).
Los ++ -- operadores y se pueden usar para aumentar y disminuir punteros
(incremento y decremento del puntero).
Los + - operadores y se pueden usar para realizar operaciones aritméticas de
punteros (aritmética de puntero).
Los == != operadores,, < ,, > <= y >= se pueden usar para comparar punteros
(comparación de punteros).
El stackalloc operador se puede utilizar para asignar memoria de la pila de
llamadas (búferes de tamaño fijo).
La fixed instrucción se puede utilizar para corregir temporalmente una variable
para que se pueda obtener su dirección (la instrucción Fixed).

Variables fijas y móviles

El operador Address-of (el operador Address-of) y la fixed instrucción (instrucción
Fixed) dividen las variables en dos categorías: *variables fijas _ y _ variables móviles *.

Las variables fijas residen en ubicaciones de almacenamiento que no se ven afectadas

por el funcionamiento del recolector de elementos no utilizados. (Algunos ejemplos de
variables fijas incluyen variables locales, parámetros de valor y variables creadas
mediante punteros de desreferencia). Por otro lado, las variables móviles residen en
ubicaciones de almacenamiento que están sujetas a reubicación o eliminación por parte
del recolector de elementos no utilizados. (Ejemplos de variables móviles incluyen
campos en objetos y elementos de matrices).

El & operador (el operador Address-of) permite obtener la dirección de una variable fija
sin restricciones. Sin embargo, dado que una variable móvil está sujeta a la reubicación
o eliminación por parte del recolector de elementos no utilizados, la dirección de una
variable móvil solo se puede obtener mediante una fixed instrucción (la instrucción
Fixed) y esa dirección permanece válida solo mientras dure la fixed instrucción.

En términos precisos, una variable fija es una de las siguientes:

Variable resultante de una simple_name (nombres simples) que hace referencia a

una variable local o un parámetro de valor, a menos que una función anónima
Capture la variable.
Variable resultante de un member_access (acceso a miembros) del formulario V.I ,
donde V es una variable fija de un struct_type.
Variable que resulta de una pointer_indirection_expression (direccionamiento
indirecto del puntero) del formulario *P , un pointer_member_access (acceso a
 miembros de puntero) del formulario P->I , o un pointer_element_access (acceso a
un elemento de puntero) del formulario P[E] .

Todas las demás variables se clasifican como variables móviles.

Tenga en cuenta que un campo estático se clasifica como una variable móvil. Tenga en
cuenta también que un ref out parámetro o se clasifica como una variable móvil,
incluso si el argumento especificado para el parámetro es una variable fija. Por último,
tenga en cuenta que una variable generada al desreferenciar un puntero siempre se
clasifica como una variable fija.

Conversiones de puntero
En un contexto no seguro, el conjunto de conversiones implícitas disponibles
(conversiones implícitas) se extiende para incluir las siguientes conversiones de puntero
implícitas:

Desde cualquier pointer_type al tipo void* .

Del null literal a cualquier pointer_type.

Además, en un contexto no seguro, el conjunto de conversiones explícitas disponibles

(conversiones explícitas) se extiende para incluir las siguientes conversiones de puntero
explícitas:

Desde cualquier pointer_type a cualquier otro pointer_type.

De sbyte , byte , short , ushort , int , uint , long o ulong a cualquier
pointer_type.
Desde cualquier pointer_type a sbyte , byte , short , ushort , int , uint , long o
ulong .

Por último, en un contexto no seguro, el conjunto de conversiones implícitas estándar

(conversiones implícitas estándar) incluye la siguiente conversión de puntero:

Desde cualquier pointer_type al tipo void* .

Las conversiones entre dos tipos de puntero nunca cambian el valor del puntero real. En
otras palabras, una conversión de un tipo de puntero a otro no tiene ningún efecto en la
dirección subyacente proporcionada por el puntero.

Cuando un tipo de puntero se convierte en otro, si el puntero resultante no está

alineado correctamente para el tipo señalado, el comportamiento es indefinido si se
desreferencia el resultado. En general, el concepto "correctamente alineado" es
transitivo: Si un puntero al tipo A se alinea correctamente para un puntero al tipo B ,
que, a su vez, está alineado correctamente para un puntero al tipo C , un puntero al tipo
A se alinea correctamente para un puntero al tipo C .

Considere el siguiente caso en el que se tiene acceso a una variable con un tipo a través
de un puntero a un tipo diferente:

C#

char c = 'A';

char* pc = &c;

void* pv = pc;

int* pi = (int*)pv;

int i = *pi; // undefined

*pi = 123456; // undefined

Cuando un tipo de puntero se convierte en un puntero a byte, el resultado apunta al

byte más bajo direccionable de la variable. Los incrementos sucesivos del resultado,
hasta el tamaño de la variable, proporcionan punteros a los bytes restantes de esa
variable. Por ejemplo, el siguiente método muestra cada uno de los ocho bytes en un
tipo Double como un valor hexadecimal:

C#

using System;

class Test

unsafe static void Main() {

double d = 123.456e23;

unsafe {

byte* pb = (byte*)&d;

for (int i = 0; i < sizeof(double); ++i)

Console.Write("{0:X2} ", *pb++);

Console.WriteLine();

Por supuesto, la salida generada depende de modos endian.

Las asignaciones entre punteros y enteros están definidas por la implementación. Sin
embargo, en las arquitecturas de CPU de 32 * y 64 bits con un espacio de direcciones
lineal, las conversiones de punteros a o desde tipos enteros normalmente se comportan
exactamente igual que las conversiones de uint ulong los valores o, respectivamente, a
o desde esos tipos enteros.
Matrices de puntero
En un contexto no seguro, se pueden construir matrices de punteros. En las matrices de
puntero solo se permiten algunas de las conversiones que se aplican a otros tipos de
matriz:

La conversión de referencia implícita (conversiones de referencia implícita) de

cualquier array_type a System.Array y las interfaces que implementa también se
aplican a las matrices de punteros. Sin embargo, cualquier intento de obtener
acceso a los elementos de la matriz a través de System.Array o las interfaces que
implementa producirá una excepción en tiempo de ejecución, ya que los tipos de
puntero no se pueden convertir a object .
Las conversiones de referencia implícitas y explícitas (conversiones dereferencia
implícita, conversiones de referencia explícitas) de un tipo de matriz
unidimensional S[] a System.Collections.Generic.IList<T> y sus interfaces base
genéricas nunca se aplican a las matrices de puntero, ya que los tipos de puntero
no se pueden usar como argumentos de tipo y no hay conversiones de tipos de
puntero en tipos que no son de puntero.
La conversión de referencia explícita (conversiones de referencia explícita) de
System.Array y las interfaces que implementa en cualquier array_type se aplican a

las matrices de punteros.

Las conversiones explícitas de referencia (conversiones de referencia explícita) de
System.Collections.Generic.IList<S> y sus interfaces base a un tipo de matriz

unidimensional T[] nunca se aplican a las matrices de puntero, ya que los tipos de
puntero no se pueden usar como argumentos de tipo y no hay conversiones de
tipos de puntero en tipos que no son de puntero.

Estas restricciones implican que la expansión de la foreach instrucción sobre las

matrices descritas en la instrucción foreach no se puede aplicar a las matrices de
punteros. En su lugar, una instrucción foreach con el formato

C#

foreach (V v in x) embedded_statement

donde el tipo de x es un tipo de matriz con el formato T[,,...,] , N es el número