Compartir a través de


Utilizar indizadores (Guía de programación de C#)

Los indizadores suponen una comodidad sintáctica al permitir crear una clase, struct o interfaz a las que las aplicaciones cliente pueden tener acceso como si se tratara de una matriz. Por lo general, los indizadores se implementan en tipos cuya finalidad principal es encapsular una matriz o colección interna. Supongamos, por ejemplo, que tiene una clase denominada 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 denominada "temps" de tipo float para representar las temperaturas y un objeto DateTime que representa la fecha en la que se registraron las temperaturas. Al implementar un indizador en esta clase, los clientes pueden tener acceso a las temperaturas en una instancia de TempRecord como float temp = tr[4] y no como float temp = tr.temps[4]. La notación del indizador no sólo simplifica la sintaxis de las aplicaciones cliente, sino que también hace la clase y su finalidad más intuitivas para que otros programadores lo entiendan.

Para declarar un indizador en una clase o struct, utilice la palabra clave this, como en este ejemplo:

public int this[int index]    // Indexer declaration
{
    // get and set accessors
}

Comentarios

El tipo de un indizador y el tipo de sus parámetros deben ser por lo menos tan accesibles como el propio indizador. Para más información acerca de los niveles de accesibilidad, vea Modificadores de acceso.

Para obtener más información sobre cómo utilizar los indizadores con una interfaz, vea Indizadores en interfaces.

La firma de un indizador está formada por el número de parámetros formales y sus tipos. No incluye el tipo de indizador ni los nombres de los parámetros formales. Si se declara más de un indizador en una misma clase, cada indizador deberá tener una firma diferente.

Los valores de un indizador no se clasifican como variables; por ello, no es posible transferir un valor de indizador como un parámetro ref u out.

Para proporcionar un nombre al indizador que otros lenguajes puedan utilizar, use un atributo name en la declaración. Por ejemplo:

[System.Runtime.CompilerServices.IndexerName("TheItem")]
public int this [int index]   // Indexer declaration
{
}

Este indizador tendrá el nombre TheItem. Si no se proporciona el atributo con nombre, se le dará como nombre predeterminado Item.

Ejemplo 1

Descripción

En el ejemplo siguiente se muestra cómo declarar un campo de matriz privado, temps, y un indizador. El indizador permite tener acceso directo a la instancia tempRecord[i]. La alternativa a utilizar el indizador es declarar la matriz como miembro de tipo public y tener acceso directamente a sus miembros, tempRecord.temps[i].

Conviene tener en cuenta que cuando se evalúa el acceso de un indizador, por ejemplo, en una instrucción Console.Write se llama al descriptor de acceso get. Por ello, si no existe un descriptor de acceso get se producirá un error en tiempo de compilación.

Código

class TempRecord
{
    // Array of temperature values 
    private 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
    {
        get { return temps.Length; }
    }
    // Indexer declaration. 
    // If index is out of range, the temps array will throw the exception. 
    public float this[int index]
    {
        get
        {
            return temps[index];
        }

        set
        {
            temps[index] = value;
        }
    }
}

class MainClass
{
    static void Main()
    {
        TempRecord 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++)
        {
            System.Console.WriteLine("Element #{0} = {1}", i, tempRecord[i]);
        }

        // Keep the console window open in debug mode.
        System.Console.WriteLine("Press any key to exit.");
        System.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
    */

Indizar utilizando otros valores

C# no limita el tipo de índice al entero. Por ejemplo, puede ser útil utilizar una cadena con un indizador. Este tipo de indizador podría implementarse buscando la cadena dentro de la colección y devolviendo el valor adecuado. Como se pueden sobrecargar los descriptores de acceso, es posible la coexistencia de cadenas y enteros.

Ejemplo 2

Descripción

En este ejemplo, se declara una clase que almacena los días de la semana. Se declara un descriptor de acceso get que toma una cadena, el nombre de un día, y devuelve el entero correspondiente. Por ejemplo, Sunday devolverá 0, Monday devolverá 1, y así sucesivamente.

Código

// Using a string as an indexer value 
class DayCollection
{
    string[] days = { "Sun", "Mon", "Tues", "Wed", "Thurs", "Fri", "Sat" };

    // This method finds the day or returns -1 
    private int GetDay(string testDay)
    {

        for (int j = 0; j < days.Length; j++)
        {
            if (days[j] == testDay)
            {
                return j;
            }
        }

        throw new System.ArgumentOutOfRangeException(testDay, "testDay must be in the form \"Sun\", \"Mon\", etc");
    }

    // The get accessor returns an integer for a given string 
    public int this[string day]
    {
        get
        {
            return (GetDay(day));
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        DayCollection week = new DayCollection();
        System.Console.WriteLine(week["Fri"]);

        // Raises ArgumentOutOfRangeException
        System.Console.WriteLine(week["Made-up Day"]);

        // Keep the console window open in debug mode.
        System.Console.WriteLine("Press any key to exit.");
        System.Console.ReadKey();
    }
}
// Output: 5

Programación sólida

Fundamentalmente, hay dos maneras de mejorar la seguridad y confiabilidad de los indizadores:

  • Asegúrese de incorporar algún tipo de estrategia de control de errores para tratar 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 indizador. También puede incluir el código de control de errores en el propio indizador. No olvide documentar a los usuarios cualquier excepción que se produjera dentro de un descriptor de acceso de indizadores.

  • Establezca la accesibilidad de los descriptores de acceso get y set para que sea lo más restrictiva posible. Es importante particularmente para el descriptor de acceso set. Para obtener más información, vea Restringir la accesibilidad del descriptor de acceso (Guía de programación de C#).

Vea también

Referencia

Indizadores (Guía de programación de C#)

Propiedades (Guía de programación de C#)

Conceptos

Guía de programación de C#