Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String.Contains Method

Note: This method is new in the .NET Framework version 2.0.

Returns a value indicating whether the specified String object occurs within this string.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public bool Contains (
	string value
)
public boolean Contains (
	String value
)
public function Contains (
	value : String
) : boolean

Parameters

value

The String object to seek.

Return Value

true if the value parameter occurs within this string, or if value is the empty string (""); otherwise, false.

Exception typeCondition

ArgumentNullException

value is a null reference (Nothing in Visual Basic).

This method performs a word (case-sensitive and culture-sensitive) search using the current culture. The search begins at the first character position of this string and continues through the last character position.

The following code example determines whether the string "fox" is a substring of a familiar quotation.

// This example demonstrates the String.Contains() method
using System;

class Sample 
{
    public static void Main() 
    {
    string s1 = "The quick brown fox jumps over the lazy dog";
    string s2 = "fox";
    bool b;
    b = s1.Contains(s2);
    Console.WriteLine("Is the string, s2, in the string, s1?: {0}", b);
    }
}
/*
This example produces the following results:

Is the string, s2, in the string, s1?: True
*/

// This example demonstrates the String.Contains() method
import System.*;

class Sample
{
    public static void main(String[] args)
    {
        String s1 = "The quick brown fox jumps over the lazy dog";
        String s2 = "fox";
        boolean b;
        b = s1.Contains(s2);
        Console.WriteLine("Is the string, s2, in the string, s1?: {0}", 
            (System.Boolean)b);
    } //main
} //Sample
/*
This example produces the following results:

Is the string, s2, in the string, s1?: True
*/

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

Show:
© 2014 Microsoft