Learn About Regular Expressions In C#

Regular expression is a pattern matching technique where we can check whether a given input is in a specified format or not. We have RegEx class in .Net for it. We will have to import System.Text.RegularExpression namespace to access RegEx class. RegEx class has IsMatch() method, which determines whether a given input format matches our pre-specified format or not.

Why do we need Regular expression ?

Suppose we have to save Email Id in our application. Before saving any input value we must validate its format. It's easier to validate it using regular expression than by writing our own custom logic. Similarly if we need any kind of input format validation (password validation, input restriction etc) we can use regular expression.

In order to define our own expression format, we must know the meaning of a set of predefined characters and operators in terms of regular expression. So let's begin with the logic to write a regular expression.

static void Main(string[] args)
{
string input = "test123";
string regexPattern = "[a-z]";
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched");
}
else {
Console.WriteLine("Pattern did not match");
}
Console.ReadKey();
}

Here variable "input" refers to user input, "regexPattern" refers to the pattern restriction we wish to have.

New RegEx(regexPattern) - in this piece of code , we are trying to create a RegEx object by passing our desired pattern format.

New Regex(regexPattern).IsMatch(input) - with this piece of code, we are trying to figure out whether given input format matches our desired format or not.

Output

Let's understand the meaning of "[a-z]" expression. [] is a character class that matches any one character defined inside it (that is a-z) and it's case-sensitive. We have a few more commonly used character classes as described below.

Character classes	Description
[<specific_character(s)>]	RegEx matches any single character defined in <specific_character(s)>
[^<specific_character(s)>]	RegEx matches any single character that is not defined in <specific_character(s)>
.	Matches any character except \n (new line)
\w	Matches any word character, that is any alpha numeric and underscore character.
\W	Matches any non-word character
\s	Matches white-space character like tab, space .
\S	Matches any no-white-space character like tab, space .
\d	Matches any digit character
\D	Matches any non-digit character

Let's understand this in detail.

Any Alphabet Match

Suppose we are trying to figure out whether the given input has any lower case characters (that is, any characters starting from a to z ). In that case we should use [] character class and our expression will be [a-z]. We have already tried this in the above example. Now suppose we wish to see whether the given format has either "a" or "b" or "c" character.

Then our RegEx expression should look like [abc]. Let's verify this.

static void Main()
{
Program p = new Program();
p.AnyCharacterMatch();
Console.ReadKey();
}
void AnyCharacterMatch() {
List<string> inputs = new List<string>(){
"123",
"@#$",
"test123",
"123a*@",
"cab123",
"*#c12"
};
string regexPattern = "[abc]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched");
}
else {
Console.WriteLine("Pattern did not match");
}
}
}

Output

Only those strings which have either "a" or "b" or "c" matches our pattern.

Any Number Match

Likewise if we wish to find whether a given string has any number , then our RegEx pattern will be "[0-9]".

static void Main()
{
Program p = new Program();
p.AnyNumberMatch();
Console.ReadKey();
}
void AnyNumberMatch() {
List<string> inputs = new List<string>(){
"@#$",
"test",
"test123",
"123a*@",
"123"
};
string regexPattern = "[0-9]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

AND operator Match

Similarly suppose we wish to check whether given input has at least one character and number. Our regular expression should look like "[a-z][0-9]" , meaning any character that matches with a to z and 0 to 9 . Now suppose we wish to check a pattern which must have at least one upper and lower case character and number. Our RegEx should look like "[a-z][A-Z][0-9]".

Note

The order of character classes ("[]") is important here.

Ex,

static void Main()
{
Program p = new Program();
p.MandatorySequenceMatch();
Console.ReadKey();
}
void MandatorySequenceMatch() {
List<string> inputs = new List<string>(){
"123",
"@#$",
"test123",
"test123ABC",
"TestA123",
"XYZabc0987",
"Ab1",
"test123Ab1"
};
string regexPattern = "[A-Z][a-z][0-9]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

Pattern "[A-Z][a-z][0-9]" refers to any string that has one upper character, one lower character and a number in sequence. Only one character from each. For example "Ab1", "abCd2", "abcXy7345tesT". (only highlighted sections are exact match for the regular expression)

In "123", "@#$" and "test123" input strings either number or upper or lower character is missing. Hence pattern is not matching.

In "test123ABC","TestA123", order of upper, lower case and number characters are not followed. Hence pattern is not matching.

In "XYZabc0987", we have multiple characters of upper, lower case characters and numbers but we don't have any substring which must contain consecutive upper, lower case characters and numbers, one character each. Hence pattern is not matching.

"Ab1" is the exact pattern we are expecting as per the expression.

In "test123Ab1", "Ab1" substring matches the RegEx pattern. Hence given input matches the pattern too.

Note

A combination of multiple [] character classes behaves as AND operator and strictly follows the sequence.

Start character Match

Now suppose we wish to check a pattern that must start with a number. For such a condition we start with ("^" ) pattern. "^" pattern searches given character group (0 to 9 in case of "^[0-9]") at position index 0 of the given input string. Without this pattern RegEx will try to match pattern at any position index. Let's look at the below code.

Ex,

static void Main()
{
Program p = new Program();
p.MustStartWithNumber();
Console.ReadKey();
}
//must start with 0 to 9
void MustStartWithNumber() {
List<string> inputs = new List<string>(){
"test",
"test123",
"Test123ABC",
"*1abc",
"123",
"123Test",
"7TEST"
};
string regexPattern = "^[0-9]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

In "test","test123", "Test123ABC", "*1abc" don't have numbers as start characters. Hence pattern is not matching for those.

In "123", "123Test","7TEST" has first character as number. Hence pattern is matching.

End Character Match

Similarly if we wish to check a pattern that must end with a number we have to use "$". It checks if the last character of given input string matches with the pattern character group or not. Let's look at the below code.

Ex,

static void Main()
{
Program p = new Program();
p.MustEndtWithNumber();
Console.ReadKey();
}
//must end with 0 to 9
void MustEndtWithNumber() {
List<string> inputs = new List<string>(){
"test",
"Test123A*",
"123Test",
"test123",
"123",
"*@Ab1"
};
string regexPattern = "[0-9]$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

In "test", "Test123A*" and "123Test", end character is not a number. Hence pattern is not matching.

In "test123", "123", "*@Ab1" , end character is a number. Hence pattern is matching.

OR operator Match

Now suppose we wish to match a pattern for a group of characters as either group 1 or group 2. For example, a website must end with ".com" or ".in". For such conditions, we will have to use OR pattern ("|"). Let's see it in the below example.

static void Main()
{
Program p = new Program();
p.OrPatternMatch();
Console.ReadKey();
}
void OrPatternMatch(){
List<string> inputs = new List<string>(){
"test",
"Test1.abc",
"123.comabc",
"*123.com",
"test123.in"
};
string regexPattern = @"(\.com|\.in)$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

Here our regular expression looks like @"(\.com|\.in)$" . "@" refers to verbatim identifier. We have used "\." here. It's because regular expression has "." as a pattern. In order to make it understand that we are trying to use "." character not the pattern, we should define it as "\.". so (\.com|\.in) expression refers to either ".com" or ".in" pattern. At the end we have used "$" pattern for end character group match.

In "test"and "Test1.abc", neither ".com" nor ".in" is present. Hence pattern is not matching.

In "123.comabc", it has ".com" but not at the end. Hence pattern is not matching.

In "*123.com", "test123.in", it has either ".com" or ".in" at the end. Hence pattern is matching.

Minimum Character Match

Suppose we wish to check a pattern that contains at least one special character like *,@,#,&. In this case we must use minimun character check pattern ([character_group]{n,});

Here "n" refers to a minimum number of characters expected from our given character group.

Ex,

static void Main()
{
Program p = new Program();
p.SpecialCharacterMatch();
Console.ReadKey();
}
void SpecialCharacterMatch(){
List<string> inputs = new List<string>(){
"test",
"abc%",
"*123.com",
"123@test#",
"test123##**abc"
};
string regexPattern = @"[*@#&]{1,}";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

In "test", we don't have any special character. Hence pattern is not matching.

In "abc%", we have "%" special character but it doesn't have any of our defined special characters. Hence pattern is not matching.

In "*123.com", "123@test#" and "test123##**abc", has one or more matching character(s) (marked in yellow). Hence pattern is matching.

Maximum Character Match

Likewise if we wish to restrict the maximum character count , we can define RegEx as "[character_group]{m,n}".

Ex,

regexPattern = "^[a-z]{1,5}$";

Here {1,5} refers to at least 1 character and at max 5.

Fixed Characters Match

Now suppose we wish to validate a domain Email address of an organization.

Example - all users under an organization will have email id pattern as [combination of any character,number ,"." and/or "_" special character]@domain.com .

Email Id rules,

Must start with alphabet.
At least 3 characters before @domain.com
only "." and "_" special characters are allowed.
must contain @domain.com at the end

Our RegEx will look like below.

static void Main()
{
Program p = new Program();
p.MustContainFixedCharactersMatch();
Console.ReadKey();
}
void MustContainFixedCharactersMatch(){
List<string> inputs = new List<string>(){
"test",
"abc.09@abc",
"abcdomaincom",
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]"
};
string regexPattern = @"^[a-zA-Z][a-zA-Z0-9_.]{2,}\@domain.com$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

Pattern - "^[a-zA-Z][a-zA-Z0-9_.]{2,}\@domain.com$"

Here ^[a-zA-Z]: validates whether starting character of given input is an alphabet letter or not.

[a-zA-Z0-9_.]{2,}: We have at least 3 characters before domain name validation. Earlier expression group has already considered first character. Hence we have minimum character count validation as 2. This part of email Id can have any character, number and "_","." special character(s).

\@: Simply represents character "@".

domain.com$: This is the domain identifier which is fixed and user email Id must end with it.

In "test", "abc.09@abc" and "abcdomaincom", none of them match domain validation , that is @domain.com. Hence expression is not matched.

In "[email protected]", given string first character is not alphabet. Hence expression is not matched.

In "[email protected]", minimum 3 characters before domain name validation fails. Hence expression is not matched.

In "[email protected]", "[email protected]", both are satisfying all email Id rules. Hence expression is matching.

Password Match

Now suppose we wish to validate password. Criteria of password is as follows.

Minimum length 8 characters.
Must start with alphabet
Must contain at least an upper case and a lower case character and a number
Must contain a special character out of *,#,_

Here is the code for it.

static void Main()
{
Program p = new Program();
p.PasswordMatch();
Console.ReadKey();
}
void PasswordMatch(){
List<string> inputs = new List<string>(){
"test",
"123",
"test*123",
"tesT*1",
"tesT*14fgff",
"tesT*6d6@14fgff"
};
string regexPattern = @"^(?=\S*[a-z])(?=\S*[A-Z])(?=\S*\d)(?=\S*[^\w\s])\S{8,}$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}

Output

Explanation

Regular expression pattern @"^(?=\S*[a-z])(?=\S*[A-Z])(?=\S*\d)(?=\S*[^\w\s])\S{8,}$";

Here (?=) represents positive look ahead. Meaning input must contain character(s) defined after "?=".

(?=\S*[a-z]) :- must contain a-z without whitespace

(?=\S*[A-Z]):- must contain A-Z without whitespace

(?=\S*\d):- must contain any number without whitespace

(?=\S*[^\w\s]):- must contain any character except word (alphanumeric and underscore) and whitespace

\S{8,}:- minimum character length as 8 without whitespace

In "test", "123", "test*123"- inputs don't have all types of characters that is an upper case or lower case character, number and special character. Hence expression is not matching

In "tesT*1", - Length is less than 8 characters. Hence expression is not matching.

In "tesT*14fgff" and "tesT*6d6@14fgff" , both the inputs are matching all password criteria. Hence expression is matching.

Here is the complete code that we have discussed so far.

using System.IO;
using System;
using System.Collections.Generic;
using System.Text.RegularExpressions;
class Program
{
static void Main()
{
Program p = new Program();
p.AnyCharacterMatch();
p.AnyNumberMatch();
p.MandatorySequenceMatch();
p.MustStartWithNumber();
p.MustEndtWithNumber();
p.OrPatternMatch();
p.SpecialCharacterMatch();
p.MustContainFixedCharactersMatch();
Console.ReadKey();
}
void MustContainFixedCharactersMatch(){
List<string> inputs = new List<string>(){
"test",
"abc.09@abc",
"abcdomaincom",
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]"
};
string regexPattern = @"^[a-zA-Z][a-zA-Z0-9_.]{2,}\@domain.com$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}
void SpecialCharacterMatch(){
List<string> inputs = new List<string>(){
"test",
"abc%",
"*123.com",
"123@test#",
"test123##**abc"
};
string regexPattern = @"[*@#&]{1,}";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}
void OrPatternMatch(){
List<string> inputs = new List<string>(){
"test",
"Test1.abc",
"123.comabc",
"*123.com",
"test123.in"
};
string regexPattern = @"(\.com|\.in)$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}
//must end with 0 to 9
void MustEndtWithNumber() {
List<string> inputs = new List<string>(){
"test",
"Test123A*",
"123Test",
"test123",
"123",
"*@Ab1"
};
string regexPattern = "[0-9]$";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}
//must start with 0 to 9
void MustStartWithNumber() {
List<string> inputs = new List<string>(){
"test",
"test123",
"Test123ABC",
"*1abc",
"123",
"123Test",
"7TEST"
};
string regexPattern = "^[0-9]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}
// one upper character, one lower character and a number in sequence
void MandatorySequenceMatch() {
List<string> inputs = new List<string>(){
"123",
"@#$",
"test123",
"test123ABC",
"TestA123",
"XYZabc0987",
"Ab1",
"test123Ab1"
};
string regexPattern = "[A-Z][a-z][0-9]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for "+ input);
}
}
}
void AnyNumberMatch() {
List<string> inputs = new List<string>(){
"@#$",
"test",
"test123",
"123a*@",
"123"
};
string regexPattern = "[0-9]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched for "+ input);
}
else {
Console.WriteLine("Pattern did not match for"+ input);
}
}
}
//any input that has either "a"/"b"/"c"
void AnyCharacterMatch() {
List<string> inputs = new List<string>(){
"123",
"@#$",
"test123",
"123a*@",
"cab123",
"*#c12"
};
string regexPattern = "[abc]";
foreach(string input in inputs){
if(new Regex(regexPattern).IsMatch(input)){
Console.WriteLine("Pattern matched");
}
else {
Console.WriteLine("Pattern did not match");
}
}
}
}

We can save time by using regular expressions for any kind of pattern matching, rather than going with language specific logic . It is useful in scenarios as explained above. I hope this was useful for you. Thanks for taking your valuable time to read this.