Introduction to Indexed Properties

Introduction

We already know how to create an array, how to assign values to its elements, and how to get the value of each element. Here is an example:

Console.Title = "Numbers";

double[] numbers = new double[5];
        
numbers[0] = 927.93;
numbers[1] = 45.155;
numbers[2] = 2.37094;
numbers[3] = 73475.25;
numbers[4] = 186.72;
        
Console.WriteLine("Numbers");
Console.WriteLine("--------------------");
        
for (int i = 0; i < numbers.Length; i++)
    Console.WriteLine("Number {0}: {1}", i + 1, numbers[i]);
        
Console.WriteLine("=================================");

This would produce:

Numbers
--------------------
Number 1: 927.93
Number 2: 45.155
Number 3: 2.37094
Number 4: 73475.25
Number 5: 186.72
=================================
Press any key to continue . . .

In the same way, if you create an array as a field of a class, to access an element of that member, you can use an instance of the class, followed by the period operator, followed by the member variable applied with the square brackets. Instead of accessing each element through its member variable, you can create a type of property referred to as an indexer.

Creating an Indexer

An indexer, also called an indexed property, is a class's property that allows you to access a member variable of a class using the features of an array. To create an indexed property, start the class like any other. In the body of the class, create a field that is an array. Here is an example:

public class Number
{
    double[] Numbers = new double[5];
}

In the body of the class, create a property named this with its accessor(s). The this property must be the same type as the field it will refer to. The property must take a parameter as an array. This means that it must have square brackets. Inside the brackets, include the parameter you will use as index to access the members of the array.

Traditionally, and as we have seen so far, you usually access the members of an array using an integer-based index. Therefore, you can use an int type as the index of the array. Of course, the index's parameter must have a name, such as i. This would be done as follows:

public class Number
{
    double[] Numbers = new double[5];

    public double this[int i]
    {
    }
}

If you want the property to be read-only, include only a get accessor. In the get accessor, you should return an element of the array field to which the property refers, using the parameter of the property. This would be done as follows:

public class Number
{
    double[] Numbers = new double[5];

    public double this[int i]
    {
        get { return Numbers[i]; }
    }
}

If necessary, you use a member of the class to initialize the array. Here is an example:

public class Number
{
    double[] numbers = new double[5];

    public double this[int i]
    {
        get { return numbers[i]; }
    }

    public Number()
    {
        numbers = new double[5];
        numbers[0] = 927.93;
        numbers[1] = 45.155;
        numbers[2] = 2.37094;
        numbers[3] = 73475.25;
        numbers[4] = 186.72;
    }
}

Based on this, a type of formula to create a normal read-only indexed property is:

class class-name
{
    data-type[] array-name = new data-type[length];

    public data-type this[int i]
    {
        get { return array-name[i]; }
    }
}

Accessing an Element of an Indexed Property

Once you have created the indexed property, the class can be used. To start, you can declare a variable of the class. To access its arrayed field, you can apply the square brackets directly to the variable of the class. The variable would produce the value stored at that index. Here are examples:

Console.Title = "Numbers";
Console.WriteLine("Numbers");
Console.WriteLine("-----------------");

var number = new Number();

Console.WriteLine("Number: {0}", number[0]);
Console.WriteLine(string.Format("Number: {0}", number[2]));
Console.WriteLine($"Number: {number[4]}");
        
Console.WriteLine("=================================");

public class Number
{
    double[] numbers = new double[5];

    public double this[int i]
    {
        get { return numbers[i]; }
    }

    public Number()
    {
        numbers = new double[5];
        numbers[0] = 927.93;
        numbers[1] = 45.155;
        numbers[2] = 2.37094;
        numbers[3] = 73475.25;
        numbers[4] = 186.72;
    }
}

This would produce:

Numbers
-----------------
Number: 927.93
Number: 2.37094
Number: 186.72
=================================
Press any key to continue . . .

Based on the known number of items of the array, you can use a loop (while, do...while or for) to access each element from its indexed property. Here is an example:

int i = 0;
var number = new Number();

while (i < 3)
{
    Console.WriteLine("Number {0}: {1}", i + 1, number[i]);
        
    i++;
}
        
Console.WriteLine("=================================");

public class Number
{
    double[] numbers = new double[5];

    public double this[int i]
    {
        get { return numbers[i]; }
    }

    public Number()
    {
        numbers = new double[5];
        numbers[0] = 927.93;
        numbers[1] = 45.155;
        numbers[2] = 2.37094;
        numbers[3] = 73475.25;
        numbers[4] = 186.72;
    }
}

You can also use a foreach loop to visit each member of the property.

Remember, as we have already seen, that if you are providing the values of the array, you should make it read-only. This can be donbe as follows:

var number = new Number();

Console.WriteLine("Number: {0}", number[0]);
Console.WriteLine(string.Format("Number: {0}", number[2]));
Console.WriteLine($"Number: {number[4]}");

Console.WriteLine("=================================");

public class Number
{
    readonly double[] numbers = new double[5];

    public double this[int i]
    {
        get { return numbers[i]; }
    }

    public Number()
    {
        numbers = new double[5] { 927.93, 45.155, 2.37094, 73475.25, 186.72 };
    }
}

A String-Based Indexed Property

Introduction to String-Based Indexed Properties

Usually when you create an array, to access an item, you use its index, which is normally based on an integer. When it comes to indexed properties, you can specify that the members of its array will be accessed through a string.

To create an indexed property where the members of its array can be accessed by a string, in the square brackets of the this property, pass the string as data type followed by a name for the parameter. Here is an example:

public class StudentAge
{
    public float this[string name]
    {
    }
}

When defining the indexed property, there are two rules you must follow and you are aware of them already because an indexed property is like a method that takes a parameter and doesn't return void. When defining the indexed property, make sure you return the type of value that was used to declare the array. Here is an example:

public class StudentAge
{
    public float this[string name]
    {
        get
        {
            if(  name == "Ernestine Jonas" )
                return 14.50f;
            else if( name == "Paul Bertrand Yamaguchi" )
                return 12.50f;
            else if( name == "Helene Jonas" )
                return 16.00f;
            else if( name == "Chrissie Hanson" )
                return 14.00f;
            else if( name == "Bernard Hallo" )
                return 15.50f;
            else
                return 12.00f;
        }
    }
}

Accessing a String-Based Indexed Property

Once you have defined the property, you can use it. To access any of its elements, you must pass a string to the square brackets as index. You can then do whatever you want with the value produced by the property. For example, you can display it to a visitor. Here is an example:

using static System.Console;

WriteLine("Students");
        
StudentAge sa = new StudentAge();
        
float age = sa["Paul Bertrand Yamaguchi"];

WriteLine("Student Age: {0}", age);
        
WriteLine("=================================");

public class StudentAge
{
    public float this[string name]
    {
        get
        {
            if (name == "Ernestine Jonas")
                return 14.50f;
            else if (name == "Paul Bertrand Yamaguchi")
                return 12.50f;
            else if (name == "Helene Jonas")
                return 16.00f;
            else if (name == "Chrissie Hanson")
                return 14.00f;
            else if (name == "Bernard Hallo")
                return 15.50f;
            else
                return 12.00f;
        }
    }
}

This would produce:

Students
Student Age: 12.5
=================================
Press any key to continue . . .

Indexed Properties of Other Types

Introduction

When creating an indexed property, you will decide what type of value the property must produce or the type it can have. As opposed to an int or a double, you can also create a property that takes or produces a string. Here is an example:

public class Philosopher
{
    string[] phil = new string[8];

    public string this[int i]
    {
        get { return phil[i]; }
    }

    public Philosopher()
    {
        phil[0] = "Aristotle";
        phil[1] = "Emmanuel Kant";
        phil[2] = "Tom Huffman";
        phil[3] = "Judith Jarvis Thompson";
        phil[4] = "Thomas Hobbes";
        phil[5] = "Cornell West";
        phil[6] = "Jane English";
        phil[7] = "James Rachels";
    }
}

You can then use a variable of the class to access the indexed property. Here is an example:

Console.Title = "Philosophers";
Console.WriteLine("Philosophers");
        
var thinkers = new Philosopher();

Console.WriteLine("-------------------------------------");

for(int i = 0; i < 8; i++)
    Console.WriteLine("Philosopher: {0}", thinkers[i]);

Console.WriteLine("======================================");

public class Philosopher
{
    readonly string[] phil = new string[8];

    public string this[int i]
    {
        get { return phil[i]; }
    }

    public Philosopher()
    {
        phil[0] = "Aristotle";
        phil[1] = "Emmanuel Kant";
        phil[2] = "Tom Huffman";
        phil[3] = "Judith Jarvis Thompson";
        phil[4] = "Thomas Hobbes";
        phil[5] = "Cornell West";
        phil[6] = "Jane English";
        phil[7] = "James Rachels";
    }
}

This would produce:

Philosophers
-------------------------------------
Philosopher: Aristotle
Philosopher: Emmanuel Kant
Philosopher: Tom Huffman
Philosopher: Judith Jarvis Thompson
Philosopher: Thomas Hobbes
Philosopher: Cornell West
Philosopher: Jane English
Philosopher: James Rachels
======================================
Press any key to continue . . .

In the same way, you can create a Boolean-based indexed property by simply making it return a bool type. You can then use a variable of the class as an array. Here is an example:

Console.Title = "Driving Record";
Console.WriteLine("Driving Record");
        
var driving = new DrivingWhileIntoxicated();

Console.WriteLine("-------------------------------------");

for (int i = 0; i < 7; i++)
    Console.WriteLine("Driver Was Intoxicated {0}: {1}", i + 1, driving[i]);

Console.WriteLine("======================================");

public class DrivingWhileIntoxicated
{
    readonly bool[] dwi = new bool[7];

    public bool this[int i]
    {
        get { return dwi[i]; }
    }

    public DrivingWhileIntoxicated()
    {
        dwi[0] = false;
        dwi[1] = true;
        dwi[2] = true;
        dwi[3] = false;
        dwi[5] = false;
        dwi[6] = false;
    }
}

This would produce:

Driving Record
-------------------------------------
Driver Was Intoxicated 1: False
Driver Was Intoxicated 2: True
Driver Was Intoxicated 3: True
Driver Was Intoxicated 4: False
Driver Was Intoxicated 5: False
Driver Was Intoxicated 6: False
Driver Was Intoxicated 7: False
======================================
Press any key to continue . . .

An Enumeration-Based Indexed Property

You can also pass an enumeration as an index. To do this, after defining the enumeration, type its name and a parameter name in the square brackets of the this member, then define the property as you see fit. To access the property outside, apply an enumeration member to the square brackets on an instance of the class. Here is an example:

var mbr = new GolfClubMembership();

Console.WriteLine(string.Format("Membership Fee: {0}", mbr[CategoryFee.Senior]));

public enum CategoryFee
{
    Children,
    Adult,
    Senior,
    Unknown
}

public class GolfClubMembership
{
    readonly double[] fee = new double[4];

    public GolfClubMembership()
    {
        fee[0] = 150.95d;
        fee[1] = 250.75d;
        fee[2] = 85.65d;
        fee[3] = 350.00d;
    }

    public double this[CategoryFee cat]
    {
        get
        {
            if (cat == CategoryFee.Children)
                return fee[0];
            else if (cat == CategoryFee.Adult)
                return fee[1];
            else if (cat == CategoryFee.Senior)
                return fee[2];
            else
                return fee[3];
        }
    }
}

This would produce:

Membership Fee: 85.65

Press any key to close this window . . .

Topics on Indexed Properties

Multi-Parameterized Indexed Properties

The indexed properties we have used so far were taking only one parameter. You can create an indexed property whose array uses more than one dimension. To start an indexed property that would use various parameters, first create the array. Then create a this property that takes the parameters. Here is an example for an indexed property that relates to a two-dimensional array:

public class Numbers
{
    double[,] nbr;

    public double this[int x, int y]
    {
    }
}

In the body of an accessor (get or set), use the parameter as appropriately as you see fit. At a minimum, for a get accessor, you can return the value of the array using the parameters based on the rules of a two-dimensional array. This can be done as follows:

public class Numbers
{
    double[,] nbr;

    public double this[int x, int y]
    {
        get { return nbr[x, y]; }
    }
}

You can use a method of the class to initialize the array. Here is an example:

public class Numbers
{
    readonly double[,] nbr;

    public double this[int x, int y]
    {
        get { return nbr[x, y]; }
    }

    public Numbers()
    {
        nbr = new double[2, 4];
        nbr[0, 0] = 927.93;
        nbr[0, 1] = 45.155;
        nbr[0, 2] = 2.37094;
        nbr[0, 3] = 73475.25;
        nbr[1, 0] = 186.72;
        nbr[1, 1] = 82.350;
        nbr[1, 2] = 712734.95;
        nbr[1, 3] = 3249.0057;
    }
}

After creating the property, you can access each element of the array by applying the square brackets to an instance of the class. Here is an example:

Console.WriteLine("Numbers");
        
var nbr = new Numbers();

Console.WriteLine("--------------------------");

for(int i = 0; i < 2; i++)
{
    for (int j = 0; j < 4; j++)
    {
        double value = nbr[i, j];

        Console.WriteLine("Number [{0}][{1}]: {2}", i, j, value);
    }
}

Console.WriteLine("======================================");

public class Numbers
{
    readonly double[,] nbr;

    public double this[int x, int y]
    {
        get { return nbr[x, y]; }
    }

    public Numbers()
    {
        nbr = new double[2, 4];
        nbr[0, 0] = 927.93;
        nbr[0, 1] = 45.155;
        nbr[0, 2] = 2.37094;
        nbr[0, 3] = 73475.25;
        nbr[1, 0] = 186.72;
        nbr[1, 1] = 82.350;
        nbr[1, 2] = 712734.95;
        nbr[1, 3] = 3249.0057;
    }
}

This would produce:

Numbers
--------------------------
Number [0][0]: 927.93
Number [0][1]: 45.155
Number [0][2]: 2.37094
Number [0][3]: 73475.25
Number [1][0]: 186.72
Number [1][1]: 82.35
Number [1][2]: 712734.95
Number [1][3]: 3249.0057
======================================
Press any key to continue . . .

Remember that one of the most valuable features of an indexed property is that, when creating it, you can make it return any primitive type and you can make it take any parameter of your choice. Also, the parameters of a multi-parameter indexed property don't have to be the same type. One can be a character while the other is a bool type, etc. When defining the property, you must apply the rules of both the methods and the arrays. Here is an example of a property that takes an integer and a string:

public class Catalog
{
    readonly long[] nbrs;
    readonly string[] names;

    public double this[long nbr, string name]
    {
        get
        {
            if ((nbr == nbrs[0]) && (name == names[0]))
                return 275.25;
            else if ((nbr == nbrs[1]) && (name == names[1]))
                return 18.75;
            else if ((nbr == nbrs[2]) && (name == names[2]))
                return 50.00;
            else if ((nbr == nbrs[3]) && (name == names[3]))
                return 65.35;
            else if ((nbr == nbrs[4]) && (name == names[4]))
                return 25.55;
            else
                return 0.00;
        }
    }

    public Catalog()
    {
        nbrs = new long[5];
        nbrs[0] = 273974;
        nbrs[1] = 539759;
        nbrs[2] = 710234;
        nbrs[3] = 220685;
        nbrs[4] = 192837;
        names = new string[5];
        names[0] = "Women Double-faced wool coat";
        names[1] = "Men Cotton Polo Shirt";
        names[2] = "Children Cable-knit Sweater";
        names[3] = "Women Floral Silk Tank Blouse";
        names[4] = "Girls Jeans with Heart Belt";
    }
}

Here is an example that uses some variables:

using static System.Console;

var cat = new Catalog();

var itemNumber = 539759;
var itemDescription = "Men Cotton Polo Shirt";
var price = cat[itemNumber, itemDescription];

WriteLine("Item Number: " + itemNumber.ToString());
WriteLine("Description: " + itemDescription);
WriteLine("Unit Price:  " + price.ToString("F"));

public class Catalog
{
    readonly long[] nbrs;
    readonly string[] names;

    public double this[long nbr, string name]
    {
        get
        {
            if ((nbr == nbrs[0]) && (name == names[0]))
                return 275.25;
            else if ((nbr == nbrs[1]) && (name == names[1]))
                return 18.75;
            else if ((nbr == nbrs[2]) && (name == names[2]))
                return 50.00;
            else if ((nbr == nbrs[3]) && (name == names[3]))
                return 65.35;
            else if ((nbr == nbrs[4]) && (name == names[4]))
                return 25.55;
            else
                return 0.00;
        }
    }

    public Catalog()
    {
        nbrs = new long[5];

        nbrs[0] = 273974;
        nbrs[1] = 539759;
        nbrs[2] = 710234;
        nbrs[3] = 220685;
        nbrs[4] = 192837;

        names = new string[5];

        names[0] = "Women Double-faced wool coat";
        names[1] = "Men Cotton Polo Shirt";
        names[2] = "Children Cable-knit Sweater";
        names[3] = "Women Floral Silk Tank Blouse";
        names[4] = "Girls Jeans with Heart Belt";
    }
}

This would produce:

Item Number: 539759
Description: Men Cotton Polo Shirt
Unit Price:  18.75

Press any key to close this window . . .

In the above example, we first declared the variables to be passed as parameters to the indexed property. You can pass such parameter(s) directly to a variable of the class. Here is an example:

var cat = new Catalog();

var price = cat[220685, "Women Floral Silk Tank Blouse"];;

Console.WriteLine("Unit Price:  " + price.ToString("F"));

public class Catalog
{
    readonly long[] nbrs;
    readonly string[] names;

    public double this[long nbr, string name]
    {
        get
        {
            if ((nbr == nbrs[0]) && (name == names[0]))
                return 275.25;
            else if ((nbr == nbrs[1]) && (name == names[1]))
                return 18.75;
            else if ((nbr == nbrs[2]) && (name == names[2]))
                return 50.00;
            else if ((nbr == nbrs[3]) && (name == names[3]))
                return 65.35;
            else if ((nbr == nbrs[4]) && (name == names[4]))
                return 25.55;
            else
                return 0.00;
        }
    }

    public Catalog()
    {
        nbrs = new long[5];

        nbrs[0] = 273974;
        nbrs[1] = 539759;
        nbrs[2] = 710234;
        nbrs[3] = 220685;
        nbrs[4] = 192837;

        names = new string[5];

        names[0] = "Women Double-faced wool coat";
        names[1] = "Men Cotton Polo Shirt";
        names[2] = "Children Cable-knit Sweater";
        names[3] = "Women Floral Silk Tank Blouse";
        names[4] = "Girls Jeans with Heart Belt";
    }
}

Just as you can create a two-dimensional indexed property, you can also create a property that takes more than two parameters. Once again, it is up to you to decide what type of parameter would be positioned where in the square brackets. Here is an example of an indexed property that takes three parameters:

public class Catalog
{
    public string this[long nbr, string name, double price]
    {
        get
        {
            return "Item #:     " + nbr.ToString() + ", " +
                   "Item Name:  " + name + ", " +
                   "Unit Price: " + price.ToString("C");
        }
    }
}

To access the array stored in the class, after declaring a variable from it, pass the approriate values to its square brackets. Here is an example:

using static System.Console;

Title = "Department Store";
WriteLine("Department Store");
WriteLine("=================");

var cat = new Catalog();

WriteLine("Item Description");
WriteLine("------------------------------------------");
WriteLine(cat[220685, "Women Floral Silk Tank Blouse", 50.00]);

WriteLine("==========================================");

public class Catalog
{
    public string this[long nbr, string name, double price]
    {
        get
        {
            return "Item #:     " + nbr.ToString() + "\n" +
                   "Item Name:  " + name + "\n" +
                   "Unit Price: " + price.ToString("C");
        }
    }
}

This would produce:

Department Store
=================
Item Description
------------------------------------------
Item #:     220685
Item Name:  Women Floral Silk Tank Blouse
Unit Price: $50.00
==========================================
Press any key to continue . . .

Overloading an Indexed Property

An indexer borrows various characteristics of a method. One of them is the ability to create various indexers in the same class but all of them must have the same name: this. Still, the various indexers of a class can return the same type of value. Because of this, when creating the indexers, you must find a way to distinguish them. One way you can do this, as seen with method overloading, consists of passing a different type of parameter to each indexer. This is referred to as overloading.

To overload the this property, if two indexed properties take only one parameter, each must take a different (data) type of parameter than the other. Here is an example:

public class StudentIdentifications
{
    readonly int[] studentIDs;
    readonly string[] fullnames;

    // This property takes a student ID, as an integer,
    // and it produces his/her name
    public string this[int id]
    {
        get
        {
            for (int i = 0; i < studentIDs.Length; i++)
                if (id == studentIDs[i])
                    return fullnames[i];

            return "Unknown Student";
        }
    }

    // This property takes a student name, as a string,
    // and it produces his/her student ID
    public int this[string name]
    {
        get
        {
            for (int i = 0; i < fullnames.Length; i++)
                if (name == fullnames[i])
                    return studentIDs[i];

            return 0;
        }
    }

    public StudentIdentifications()
    {
        studentIDs = new int[6];
        studentIDs[0] = 39472;
        studentIDs[1] = 13957;
        studentIDs[2] = 73957;
        studentIDs[3] = 97003;
        studentIDs[4] = 28947;
        studentIDs[5] = 97395;

        fullnames = new string[6];
        fullnames[0] = "Paul Bertrand Yamaguchi";
        fullnames[1] = "Ernestine Ngovayang";
        fullnames[2] = "Patricia L Katts";
        fullnames[3] = "Helene Mukoko";
        fullnames[4] = "Joan Ursula Hancock";
        fullnames[5] = "Arlette Mimosa";
    }
}

To access one of the properties, apply the square brackets to a variable of the class and pass the appropriate type(s) or number of properties. Here are examples:

using static System.Console;

Title = "Students Records";
WriteLine("Students Records");
WriteLine("==================================");
        
var std = new StudentIdentifications();

WriteLine("Student Identification");
WriteLine("----------------------");
WriteLine("Student ID: 39472");
WriteLine("Full Name:  {0}", std[39472]);
WriteLine("===================================");

WriteLine("Student Identification");
WriteLine("----------------------");
WriteLine("Full Name: Joan Ursula Hancock");
WriteLine(string.Format("Student ID: {0}", std["Joan Ursula Hancock"]));

WriteLine("===================================");

public class StudentIdentifications
{
    readonly int[] studentIDs;
    readonly string[] fullnames;

    // This property takes a student ID, as an integer,
    // and it produces his/her name
    public string this[int id]
    {
        get
        {
            for (int i = 0; i < studentIDs.Length; i++)
                if (id == studentIDs[i])
                    return fullnames[i];

            return "Unknown Student";
        }
    }

    // This property takes a student name, as a string,
    // and it produces his/her student ID
    public int this[string name]
    {
        get
        {
            for (int i = 0; i < fullnames.Length; i++)
                if (name == fullnames[i])
                    return studentIDs[i];

            return 0;
        }
    }

    public StudentIdentifications()
    {
        studentIDs = new int[6];
        studentIDs[0] = 39472;
        studentIDs[1] = 13957;
        studentIDs[2] = 73957;
        studentIDs[3] = 97003;
        studentIDs[4] = 28947;
        studentIDs[5] = 97395;

        fullnames = new string[6];
        fullnames[0] = "Paul Bertrand Yamaguchi";
        fullnames[1] = "Ernestine Ngovayang";
        fullnames[2] = "Patricia L Katts";
        fullnames[3] = "Helene Mukoko";
        fullnames[4] = "Joan Ursula Hancock";
        fullnames[5] = "Arlette Mimosa";
    }
}

This would produce:

Students Records
==================================
Student Identification
----------------------
Student ID: 39472
Full Name:  Paul Bertrand Yamaguchi
===================================
Student Identification
----------------------
Full Name: Joan Ursula Hancock
Student ID: 28947
===================================
Press any key to continue . . .

An indexer combines the features of an array and those of a method that takes one or more parameters. As an array, an indexer can use one or more dimensions as we have seen so far. Borrowing the features of a method, an indexer can take one or more parameters and it can return a value. Besides passing different types of parameters to various indexers, you can create some of them that take more than one parameter. To access the property, declare a variable of the class and pass the appropriate arguments to its square brackets. Here is an example:

using static System.Console;

Title = "Department Store";
WriteLine("Department Store");
WriteLine("========================================");
        
var cat = new Catalog();

WriteLine("Item Identification");
WriteLine("--------------------");
WriteLine("Item #:  539759");
WriteLine("Unit Price: {0}", cat[539759]);
WriteLine("========================================");

WriteLine("Item Identification");
WriteLine("--------------------");
WriteLine("Item #:      192837");
WriteLine("Description: Girls Jeans with Heart Belt");
WriteLine(string.Format("Unit Price: {0}", cat["Girls Jeans with Heart Belt", 192837]));

WriteLine("=========================================");

public class Catalog
{
    readonly long[] nbrs;
    readonly string[] names;
    readonly double[] prices;

    // This property produces the name of an item, as a string,
    // if it is given the item #, as a number
    public string this[long nbr]
    {
        get
        {
            for (int i = 0; i < nbrs.Length; i++)
                if (nbr == nbrs[i])
                    return names[i];

            return "Unknown Item";
        }
    }

    // This property produces the price of the item, as a number,
    // if it is given the item name and its number
    public double this[string name, long nbr]
    {
        get
        {
            for (int i = 0; i < 5; i++)
                if ((nbr == nbrs[i]) && (name == names[i]))
                    return prices[i];

            return 0.00;
        }
    }

    public Catalog()
    {
        nbrs = new long[5];
        nbrs[0] = 273974;
        nbrs[1] = 539759;
        nbrs[2] = 710234;
        nbrs[3] = 220685;
        nbrs[4] = 192837;

        names = new string[5];
        names[0] = "Women Double-faced wool coat";
        names[1] = "Men Cotton Polo Shirt";
        names[2] = "Children Cable-knit Sweater";
        names[3] = "Women Floral Silk Tank Blouse";
        names[4] = "Girls Jeans with Heart Belt";

        prices = new double[5];
        prices[0] = 275.25;
        prices[1] = 18.75;
        prices[2] = 50.00;
        prices[3] = 65.35;
        prices[4] = 25.55;
    }
}

This would produce:

Department Store
========================================
Item Identification
--------------------
Item #:  539759
Unit Price: Men Cotton Polo Shirt
========================================
Item Identification
--------------------
Item #:      192837
Description: Girls Jeans with Heart Belt
Unit Price: 25.55
=========================================
Press any key to continue . . .

Read/Write Indexed Properties

Introduction

So far, we have purposely used indexed properties that only produced a value. In some cases, you may want to be able to specify the value of an element of the array. To make this possible, you can create an indexed property that uses an array whose values you can specify or change. Other than that, remember that a property that can accept and produce values is called a read-write property.

If you want an indexed property to be read/write, besides the get accessor as we have been using it so far, you should also include a set accessor.

A Read/Write Property of a Primitive Type

To create a read/write indexed property, you should include a set accessor for the property. In the set accessor, assign the value contextual keyword to the field indexed with the this parameter. Here is an example of a read/write indexed property that includes a set accessor:

public class Number
{
    double[] Numbers;

    public double this[int i]
    {
        get { return numbers[i]; }
        set { numbers[i] = value; }
    }
}

After creating the read/write property, you can assign its values outside of the class. In other words, clients of the class can change the values of its elements. Remember that the advantage of an indexed property is that each element of the arrayed field can be accessed from the instance of the class by directly applying the square brackets and the (appropriate) index to it. Here is an example:

public class Number
{
    private double[] Numbers = new double[5];

    public double this[int i]
    {
        get { return Numbers[i]; }
        set { Numbers[i] = value; }
    }
}

To set the value of an item, access it by its index and assign the desired value to it. Here is an example:

Console.Title = "Numbers";
Console.WriteLine("Numbers");

var nbr = new Number();

nbr[2] = 2.37094;

Console.WriteLine("------------------");
    for (int i = 0; i < 5; i++)
        Console.WriteLine("Number {0}: {1}", i + 1, nbr[i]);
            
Console.WriteLine("==================================");

public class Number
{
    readonly double[] Numbers = new double[5];

    public double this[int i]
    {
        get { return Numbers[i]; }
        set { Numbers[i] = value; }
    }
}

This would produce:

Numbers
------------------
Number 1: 0
Number 2: 0
Number 3: 2.37094
Number 4: 0
Number 5: 0
==================================
Press any key to continue . . .

Based on this, a type of formula to create a regular read/write indexed property is:

class class-name
{
    data-type[] array-name = new data-type[Index];

    public data-type this[int i]
    {
        get { return array-name[i]; }
        set { array-name[i] = value; }
    }
}

We saw that the index of a property could be a value other than an integer-based. For example, we created an index that was a string type. Here is an example:

public class Philosopher
{
    private string[] phil = new string[8];

    public string this[int i]
    {
        get { return phil[i]; }
        set { phil[i] = value; }
    }
}

For such a property, if you make it read/write, you can assign its values outside of the class. Here is an example:

Console.Title = "Philosophers";
Console.WriteLine("Philosophers");
        
var thinker = new Philosopher();

thinker[5] = "Stuart Rachels";

Console.WriteLine("-----------------------------");

for (int i = 0; i < 8; i++)
    Console.WriteLine("Philosopher: {0}", thinker[i]);
        
Console.WriteLine("==================================");

public class Philosopher
{
    readonly string[] phil = new string[8];

    public string this[int i]
    {
        get { return phil[i];  }
        set { phil[i] = value; }
    }
}

This would produce:

Philosophers
-----------------------------
Philosopher:
Philosopher:
Philosopher:
Philosopher:
Philosopher:
Philosopher: Stuart Rachels
Philosopher:
Philosopher:
==================================
Press any key to continue . . .

The same rules would apply to a read/write indexed property that can receive Boolean or decimal values.


Previous Copyright © 2008-2023, FunctionX Friday 22 October 2021 Next