Introduction to Indexers
Introduction to Indexers
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
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("=================================");
}
<h3>Numbers</h3>
<p>--------------------</p>
<ul>
@for(int i = 0; i < numbers.Length; i++)
{
<li>Number @(i + 1): @numbers[i]</li>
}
</ul>
<p>====================</p>
This would produce:
Numbers -------------------- Number 1: 927.93 Number 2: 45.155 Number 3: 2.37094 Number 4: 73475.25 Number 5: 186.72 ====================
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.
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:
@functions{
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:
@functions{
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:
@functions{
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:
@functions{
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
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("=================================");
}
@functions{
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 =================================
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
int i = 0;
var number = new Number();
while (i < 3)
{
Console.WriteLine("Number {0}: {1}", i + 1, number[i]);
i++;
}
Console.WriteLine("=================================");
}
@functions{
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.
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:
@functions{
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:
@functions{
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
WriteLine("Students");
StudentAge sa = new StudentAge();
float age = sa["Paul Bertrand Yamaguchi"];
WriteLine("Student Age: {0}", age);
WriteLine("=================================");
}
@functions{
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 =================================
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:
@functions{
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
WriteLine("Philosophers");
var thinkers = new Philosopher();
WriteLine("-------------------------------------");
for(int i = 0; i < 8; i++)
WriteLine("Philosopher: {0}", thinkers[i]);
WriteLine("======================================");
}
@functions{
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";
}
}
}
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 ======================================
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
WriteLine("Driving Record");
var driving = new DrivingWhileIntoxicated();
WriteLine("-------------------------------------");
for (int i = 0; i < 7; i++)
WriteLine("Driver Was Intoxicated {0}: {1}", i + 1, driving[i]);
WriteLine("======================================");
}
@functions{
public class DrivingWhileIntoxicated
{
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 ======================================
An Enumeration-Based Indexed Property
You can use an enumeration as the index of a property. 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. This can be done as follows:
using Microsoft.AspNetCore.Mvc.RazorPages;
namespace Exercises.Pages
{
public class ExerciseModel : PageModel
{
public void OnGet()
{
}
}
public enum CategoryFee
{
Children,
Adult,
Senior,
Unknown
}
public class GolfClubMembership
{
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];
}
}
}
}
To access the property, apply an enumeration member to the square brackets on an instance of the class. Here is an example:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
var mbr = new GolfClubMembership();
}
<p>Membership Fee: @mbr[CategoryFee.Senior]</p>
This would produce:
Membership Fee: 85.65
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:
@functions{
public class Numbers
{
double[,] nbr;
public double this[int x, int y]
{
}
}
}
In the body of an accessor (get, set, or init), 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:
@functions{
public class Numbers
{
double[,] nbr;
public double this[int x, int y]
{
get { return nbr[x, y]; }
}
}
}
You can use a method or a constructor of the class to initialize the array. Here is an example of the class created in a razor page:
@functions{
public class Numbers
{
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;
}
}
}
Here is an example of the class created in a code file:
using Microsoft.AspNetCore.Mvc.RazorPages;
namespace Exercises.Pages
{
public class ExerciseModel : PageModel
{
public void OnGet()
{
}
}
public class Numbers
{
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
WriteLine("Numbers");
var nbr = new Numbers();
WriteLine("--------------------------");
for(int i = 0; i < 2; i++)
{
for (int j = 0; j < 4; j++)
{
double value = nbr[i, j];
WriteLine("Number [{0}][{1}]: {2}", i, j, value);
}
}
WriteLine("======================================");
}
<p>-----------------------------</p>
<ul>
@for(int i = 0; i < 2; i++)
{
for (int j = 0; j < 4; j++)
{
double value = nbr[i, j];
<li>Number[@i][@j]: @value</li>
}
}
</ul>
<p>====================</p>
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 ===========================
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:
@functions{
public class Catalog
{
private long[] nbrs;
private 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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
var cat = new Catalog();
var itemNumber = 539759;
var itemDescription = "Men Cotton Polo Shirt";
var price = cat[itemNumber, itemDescription];
}
@functions{
public class Catalog
{
private long[] nbrs;
private 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";
}
}
}
<table style="border: 2px solid black">
<tr style="border-bottom: 1px black solid">
<td style="font-weight: 600; width: 125px">Item Number:</td>
<td>@itemNumber</td>
</tr>
<tr style="border-bottom: 1px solid black">
<td style="font-weight: 600">Description:</td>
<td>@itemDescription</td>
</tr>
<tr>
<td style="font-weight: 600">Unit Price:</td>
<td>@price.ToString("F")
</tr>
</table>
This would produce:
Item Number: 539759 Description: Men Cotton Polo Shirt Unit Price: 18.75
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
var cat = new Catalog();
var price = cat[220685, "Women Floral Silk Tank Blouse"];
}
@functions{
public class Catalog
{
private long[] nbrs;
private 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";
}
}
}
<p><span style="font-weight: 600;">Unit Price:</span> @price.ToString("F")</p>
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:
@functions{
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:
@page
@model Exercises.Pages.ExerciseModel
@using static System.Console
@{
var cat = new Catalog();
}
@functions{
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");
}
}
}
}
<pre>Department Store
==========================================
Item Description
------------------------------------------
@cat[220685, "Women Floral Silk Tank Blouse", 50.00]
==========================================</pre>
This would produce:
Department Store ========================================== Item Description ------------------------------------------ Item #: 220685 Item Name: Women Floral Silk Tank Blouse Unit Price: $50.00 ==========================================
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:
namespace Exercises.Models
{
public class StudentIdentifications
{
private int[] studentIDs;
private 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:
@page
@model Exercises.Pages.ExerciseModel
@using Exercises.Models
@{
var std = new StudentIdentifications();
}
<pre>Students Records
====================================
Student Identification
------------------------------------
Student ID: 39472
Full Name: @std[39472]
====================================
Student Identification
------------------------------------
Full Name: Joan Ursula Hancock
@string.Format("Student ID: {0}", std["Joan Ursula Hancock"])
=====================================</pre>
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 ===================================
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:
@page
@model Exercises.Pages.ExerciseModel
@{
var cat = new Catalog();
}
@functions{
public class Catalog
{
private long[] nbrs;
private string[] names;
private 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;
}
}
}
<pre>Department Store
========================================
Item Identification
----------------------------------------
Item #: 539759
Unit Price: @cat[539759]
========================================
Item Identification
----------------------------------------
Item #: 192837
Description: Girls Jeans with Heart Belt
@string.Format("Unit Price: {0}", cat["Girls Jeans with Heart Belt", 192837])
=========================================</pre>
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 =========================================
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:
@functions{
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 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:
@functions{
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:
@page
@model Exercises.Pages.ExerciseModel
@using Exercises.Models
@{
var nbr = new Number();
nbr[2] = 2.37094;
}
@functions{
public class Number
{
private double[] Numbers = new double[5];
public double this[int i]
{
get { return Numbers[i]; }
set { Numbers[i] = value; }
}
}
}
<h3>Numbers</h3>
<p>----------------------------</p>
<ul>
@for (int i = 0; i < 5; i++)
{
<li>Number @(i + 1): @nbr[i]</li>
}
</ul>
<p>================</p>
This would produce:
Numbers ---------------------------- Number 1: 0 Number 2: 0 Number 3: 2.37094 Number 4: 0 Number 5: 0 ================
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:
@functions{
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 the class. Here is an example:
@page
@model Exercises.Pages.ExerciseModel
@using Exercises.Models
@{
var thinker = new Philosopher();
thinker[5] = "Stuart Rachels";
}
@functions{
public class Philosopher
{
private string[] phil = new string[8];
public string this[int i]
{
get { return phil[i]; }
set { phil[i] = value; }
}
}
}
<h3>Philosophers</h3>
<p>----------------------------</p>
<ul>
@for (int i = 0; i < 8; i++)
{
<li>Philosopher @(i + 1): @thinker[i]</li>
}
</ul>
<p>================</p>
This would produce:
Philosophers ----------------------------- Philosopher: Philosopher: Philosopher: Philosopher: Philosopher: Philosopher: Stuart Rachels Philosopher: Philosopher: ==================================
The same rules would apply to a read/write indexed property that can receive Boolean or decimal values.
|
|
|||
| Previous | Copyright © 2008-2022, FunctionX | Saturday 05 March 2022 | Next |
|
|
|||