.NET Array Dictionary List String 2D Async DataTable Dates DateTime Enum File For Foreach Format IEnumerable If IndexOf Lambda LINQ Parse Path Process Property Regex Replace Sort Split Static StringBuilder Substring Switch Tuple

C#: String

Contains. Like IndexOf, Contains searches strings. It checks if one substring is contained in another. It also provides a case-sensitive ordinal method for checking string contents. Contains returns true or false, not an index.

Method call

Example. Contains is an instance method on the string type, which means you can call it on a specific string in your program. It has a bool result, which is true if the parameter is found, and false if it is not found.


Next: The example program shows that Contains is case-sensitive. It shows how to test the result of Contains.

C# program that uses Contains

using System;

class Program
    static void Main()
	Test("Dot Net Perls");
	Test("dot net perls");

    static void Test(string input)
	Console.Write("--- ");
	Console.WriteLine(" ---");
	// See if the string contains 'Net'
	bool contains = input.Contains("Net");
	// Write the result
	Console.Write("Contains 'Net': ");
	// See if the string contains 'perls' lowercase
	if (input.Contains("perls"))
	    Console.WriteLine("Contains 'perls'");
	// See if the string contains 'Dot'
	if (!input.Contains("Dot"))
	    Console.WriteLine("Doesn't Contain 'Dot'");


--- Dot Net Perls ---
Contains 'Net': True
--- dot net perls ---
Contains 'Net': False
Contains 'perls'
Doesn't Contain 'Dot'
Main method

In this example, we call twice the Test method. In that method, the output is printed the console. The string "Net" is first tested with Contains. We show that Contains is case-sensitive.

Testing the result of Contains. The Test method checks Contains in if-conditionals. It shows how to test it for true and false. You also can store the result of Contains in a bool variable.

True, FalseIf
Framework: NET

Internals. Contains is actually just a wrapper for IndexOf. When IndexOf returns -1, the string was not found. When Contains cannot find the string, it returns false instead. Contains has no performance advantage over calling IndexOf.

Tip: In IL Disassembler, we see how Contains is implemented. Please check the detailed article.

IL Disassembler TutorialQuestion

Ordinal refers to a position number. When used with strings, it means that the characters are treated as numbers, not symbols. With StringComparison.Ordinal, all language characters are treated the same—regardless of the system locale.

Performance. I have found that ordinal comparisons on strings are much faster than culture-dependent comparisons. This makes sense because it is easier for the system to compare numbers than symbols.

C# programming language

Summary. The simplest method to perform a task is often the best one. Contains is a simplified version of IndexOf. It allows you to easily check whether a string is contained in another. This is useful.

Also: Contains is not affected by the system locale, so it is reliable on all systems.