Enumerate in C#: Detailed Explanation

Juan España
ByteHide
Published in
9 min readJun 7, 2024

--

Desperate to decode the mystery that is enumeration in C#? Is the C# Enumerator giving you sleepless nights? Fear not, my fellow code enthusiast! We are going to embark on an exciting journey, unraveling the layers and complexities of enumeration in C#, one byte at a time.

Enumerate in C#: Detailed Explanation

Understanding Enumeration in C#

Right, before we embark on this enlightening journey, let’s warm up by grasping some basics.

What is Enumeration in C#

An Enumerator, in the most simplistic terms, is a read-only, forward-only cursor over a sequence in C#. Exciting, isn’t it? But hold onto your PCs, we’ve only just begun!

In the code snippet below, we’re defining an enumerator for the days of the week. It’s a classic example that decodes the essence of enumeration like a boss.

public enum Days { Sun, Mon, Tue, Wed, Thur, Fri, Sat };

Ah, look at that art. Remember, enumeration in C# provides us with easy handling of a set of values. So only the deepest dungeons of your codebase will know about Sun, Mon and the rest of the enumerated values.

How to Use Enumeration in C#

Ever tried running before learning how to walk? In the world of development, understanding-the-use usually beats defining-the-use. Let’s turn that principle into action with our next example.

Suppose we have an enumeration for different user statuses:

public enum UserStatus { Registered, Unregistered };

No rocket science so far. But how do we use this enumeration in C#, you ask? Here we go:

UserStatus status = UserStatus.Registered;

Now, whenever we need to check the status of our users, we can simply refer to the status variable. It’s so clean and smooth, you’d think you were coding in a sterile environment!

C# Enumerator — An Overview

Enumerators in C# are no different from your bookmarker, gently guiding you to the next list. The glorious difference? While bookmarks are busy managing your storytelling, the C# Enumerator is efficiently managing your data sequence. By now, you should be so pumped that you feel your fingers shouting, “Let’s code already!” Well, here’s how:

IEnumerable<int> list = Enumerable.Range(0, 5);
IEnumerator<int> enumerator = list.GetEnumerator();
while (enumerator.MoveNext())
{
Console.WriteLine(enumerator.Current);
}

In this example, GetEnumerator() returns an enumerator that iterates over the IEnumerable<int>. Remember, an IEnumerator is the heart of enumeration, and GetEnumerator() is like its ECG, showing us what’s happening inside!

Practical Applications of Enumerators in C#

So far, it’s all been fun and code. But, how does an enumerator dance to the tunes of C# in practical scenarios? Let’s explore!

C# Enumerator Example

The code is the soul of a developer. A classic C# Enumerator example would show you how each item in your collection can have their moment under the sun.

List<string> superheroes = new List<string> { "Ironman", "Batman", "Wonderwoman" };
IEnumerator<string> enumerator = superheroes.GetEnumerator();
while (enumerator.MoveNext())
{
Console.WriteLine(enumerator.Current);
}

Each time we call MoveNext(), it advances the enumerator to the next element of the collection. You see, even in a superhero team, everyone gets their share of spotlight!

C# Enumerable Range

Ever tried creating a sequence of numbers in C#? You’d be amazed how using Enumerable.Range can make your code not just neat but downright debonair!

var numbers = Enumerable.Range(1, 10)

This line of code will generate an IEnumerable<int> with numbers from 1 to 10. Isn’t it fantastic? Instead of manually entering all ten numbers, Enumerable.Range does it all in one smooth operation!

C# Foreach Enumerator

Remember the good old foreach loop? It seems it’s had a facelift and is now called Foreach Enumerator.

List<string> fruits = new List<string> { "apple", "banana", "cherry" };
foreach (string fruit in fruits)
{
Console.WriteLine(fruit);
}

In this code snippet, fruit is our enumerator object. Each time we dive into the loop, the foreach enumerator automatically moves to the next item. And guess what, it does this without a care in the world about indices!

C# List Enumerator

Imagine bridging the gap between your list and the desired output using an Enumerator. Sounds fancy? The C# List Enumerator champions this cause like a pro!

List<int> numbers = new List<int> { 1, 2, 3 };
foreach (int number in numbers)
{
Console.WriteLine(number);
}

Bam! There you have it. You just used List Enumerator like a true C# Crusader.

Creating Enumerators in C#

So, by now you’re probably thinking, “I love using Enumerators, but can I create and customize them?” Oh, absolutely! Let me show you how.

C# Create Enumerator

Creating enumerators in C# can be quite exhilarating! Not the adrenaline-rushing, extreme-sport kind of way, but in the squeal-inducing, first-hello-world-program kind of way.

Here, we create our IEnumerator in a classic string collection class:

public class ClassicStringCollection : IEnumerable<string>
{
private List<string> _strings = new List<string>();

public void Add(string str)
{
_strings.Add(str);
}
public IEnumerator<string> GetEnumerator()
{
return _strings.GetEnumerator();
}
//The non-generic version of GetEnumerator, required by the IEnumerable interface.
IEnumerator IEnumerable.GetEnumerator()
{
return this.GetEnumerator();
}
}

Personalize your enumeration! Create your IEnumerator and march ahead!

C# Custom Enumerator

Your very own, made-to-measure, fit-like-a-glove enumerator. Sounds enticing, doesn’t it? Well, inch closer, because this is your golden chance to create a custom Enumerator in C#.

C# Custom Enumerator

Your very own, made-to-measure, fit-like-a-glove enumerator. Sounds enticing, doesn’t it? Well, inch closer, because this is your golden chance to create a custom Enumerator in C#.

public class AnimalEnumerator : IEnumerator<Animal>
{
private List<Animal> animals;
int position = -1;

public AnimalEnumerator(List<Animal> animals)
{
this.animals = animals;
}

public Animal Current
{
get
{
return animals[position];
}
}

object IEnumerator.Current
{
get
{
return animals[position];
}
}

public bool MoveNext()
{
position++;
return (position < animals.Count);
}

public void Reset()
{
position = -1;
}

public void Dispose()
{
}
}

Build the enumerator just the way you want. Define MoveNext, Reset, and Current to meet your exact needs. C# throws all the doors open for you, why not step in?

Build the enumerator just the way you want. Define MoveNext, Reset, and Current to meet your exact needs. C# throws all the doors open for you, why not step in?

Multiple Enumeration in C#

Multiples, in general, always spice up the recipe! Multiple Enumeration in C# brings out the gourmet chef in our code, creating some code-crushing delicacies worth savoring!

C# Multiple Enumeration

Highlighting the subtleties of multiple enumeration, we have sculpted an example that will help you marvel at its capabilities:

IEnumerable<int> numbers = Enumerable.Range(1, 10);
foreach (int number in numbers)
{
Console.WriteLine(number);
}

foreach (int number in numbers)
{
Console.WriteLine(number);
}

In this example, numbers is enumerated twice. The takeaway? We can enumerate as many times as we like! That’s like an all-you-can-eat buffet, but for enumerations!

C# Possible Multiple Enumeration

Now, before you start over-indulging, keep in mind that multiple enumerations could trigger redundancy and performance issues.

Consider this:

IEnumerable<int> numbers = GetExpensiveNumbers();
int sum = numbers.Sum();
int count = numbers.Count();

Now, if GetExpensiveNumbers() is a costly operation, it’s carried out twice. This is a reasonable price to pay for buffet as elaborate as enumerable, won’t you say?

Different Types of Enumerables

Enumerables are like tributaries flowing into the mighty river of enumeration! Learning about them will strengthen our voyage further.

C# Enumerable.range

We already used this bad boy, remember? But hey, we can crack open the champagne again. Enumerable.Range() allows us to create a sequence in range.

var numbers = Enumerable.Range(1, 5);

Here, we’ve created a sequence from 1 to 5. Five lines of code in one. Talk about being succinct!

C# Dictionary Enumerator

Have you ever sensed an uncanny similarity between dictionaries and wine cellars? Both store treasures, just different kinds. Let’s see how the C# Dictionary Enumerator helps us sort through these treasures.

Dictionary<int, string> dictionary = new Dictionary<int, string>() {
{ 1, "one" }, { 2, "two" }, { 3, "three" }
};

foreach (KeyValuePair<int, string> pair in dictionary)
{
Console.WriteLine($"{pair.Key}: {pair.Value}");
}

Here pair becomes our Enumerator. And like a true Enumerator, it lets us peruse our dictionary one pair at a time.

C# Combine Two Enumerables

Ever thought of a party where our Enumerable friends merge and mingle? This is your lucky day! With Enumerable.Concat, we can achieve just that! Take a look.

var numbers1 = Enumerable.Range(1, 3);
var numbers2 = Enumerable.Range(4, 3);
var mergedNumbers = numbers1.Concat(numbers2);

Each number found its pair in this union of two Enumerables! ‘MergedNumbers’ is the Cinderella of this ball, stitching our ranges together into a single sequence!

C# Empty Enumerable

Want to create an Enumerable with no elements? Sounds weird, right? But in the world of coding, even such bizarre wishes come true. Behold the power of Enumerable.Empty()!

var empty = Enumerable.Empty<int>();

What if I told you that one line just created an empty Enumerator which can be used to avoid null exceptions? Now that’s what I call a magic trick!

C# Enumerable Aggregate

Avid fans of the SQL ‘Aggregate’ function, brace yourselves! ‘Enumerable.Aggregate’ is here to sweep you off your feet.

List<int> integers = new List<int> { 1, 2, 3 };
int sum = integers.Aggregate((a, b) => a + b);

I’m floored too! Turns out, adding elements from a list is a no-brainer with ‘Aggregate’!

Exploring Extended Features of Enumerable

Just when you though Enumerable had no more surprises left to offer, it pulls another rabbit out of its hat!

C# Enumerable Range Long

We’ve been playing around with Enumerable.Range a while now. But what if you want a range of long values? Unfortunately, Enumerable.Range only takes int as input. It has its disadvantages, but hey, no toolbox can hold all the tools!

C# Enumerable Repeat

Ever wished to create a sequence that just repeats a value? Enter ‘Enumerable.Repeat’!

var repeatedNumbers = Enumerable.Repeat(1, 10);

Looping to land those 1s in there? So last century! With Enumerable.Repeat, we can create a set of repeating values seamlessly.

C# Enumerable Select

The Select function is not just for your SQL queries anymore! We can use it to create a sequence that is a projection from the source! Intrigued enough to check it out?

var numbers = Enumerable.Range(1, 5);
var squares = numbers.Select(n => n * n);

Want the squares of integers from 1 to 5? With Enumerable.Select, it becomes just another day at the park!

Enumerable in File and Class Properties Management

Thought Enumerables were only for lists and collections? Think again!

C# Enumerate Files

Navigating through files can be smoother than ever using Enumerate. Leverage the Directory.EnumerateFiles method and outsource the heavy lifting to Enumerate!

foreach (string file in Directory.EnumerateFiles("myDirectory"))
{
Console.WriteLine(file);
}

Enumerate your way through files as if you are strolling in the park!

C# Enumerate Class Properties

Ever thought you could sneak through the class properties with Enumerate watching your back? It’s possible!

public class User
{
public string Name { get; set; }
public string Email { get; set; }
}

foreach (var prop in typeof(User).GetProperties())
{
Console.WriteLine(prop.Name);
}

With reflection, you can enumerate through properties like a phantom thief sneaking through laser sensors. Don’t worry, your secret’s safe with us!

Advanced Enumeration Techniques

Artifact hunting, aren’t we? Embarking deeper into the realm of enumeration in C#, we are bound to stumble upon techniques truly capable of leaving us in awe. From methods like MoveNext to practices like Fast Directory Enumeration, we’ll leave no stone unturned.

C# Enumerator Movenext

The MoveNext method, as we’ve seen, plays a quintessential role in the functioning of the enum system in C#. It works like a compass guiding us through the wilderness of our collections.

List<int> numbers = new List<int> { 1, 2, 3, 4, 5 };
IEnumerator<int> numEnum = numbers.GetEnumerator();
while (numEnum.MoveNext())
{
Console.WriteLine(numEnum.Current);
}

In this example, the MoveNext method is leading the enumeration of our list, guiding us from one element to the next. It’s as if you’re hiking through a forest trail, and MoveNext is your faithful guide ensuring that you safely reach and appreciate every scenic spot (list element).

C# Fast Directory Enumeration

While working with files and directories, we often need to list all files. Directory.GetFiles is at our service for this task. But, there is a cheetah in the race of snails, Directory.EnumerateFiles.

foreach (string file in Directory.EnumerateFiles("C: \\ TestFolder"))
{
Console.WriteLine(file);
}

Here’s a real-life scenario where you have a massive directory, let’s say, with more than a hundred thousand files. It will take certain amount of time to get all file names using GetFiles method since it would return an array of strings once it has completed the fetching. Until then, you must wait.

In contrast, EnumerateFiles returns an enumerable collection of file names (strings). So somehow, if you need to stop after finding the first few files (let’s say some specific file), you can do that without waiting for EnumerateFiles to scan the entire directory.

How LINQ Uses Enumerable

LINQ takes Enumerable and launches it straight to the moon. The LINQ operators that you love? They use the Enumerable class behind the scenes.

var numbers = new List<int> { 1, 2, 3, 4, 5 };
var evenNumbers = numbers.Where(n => n % 2 == 0);

So, you see, LINQ and Enumerables are two peas in a pod. Now, isn’t that a neat little secret to round off our fascinating journey through the world of Enumerables in C#?

Having traversed the terrain of C# Enumerable, don’t you agree it’s like a magic wand, making our programming lives so much easier, cleaner, and elegant? Whether you’re dispatching data sequence, managing files, or creating those customized solutions with LINQ, Enumerate is the trusty sidekick you’ll never want to code without. But always remember, with great power, comes great responsibility.

Use it wisely!

--

--

Juan España
ByteHide

CEO at ByteHide🔐, passionate about highly scalable technology businesses and .NET content creator 👨‍💻