Duration (Pacific Standard Time):
To (Pacific Standard Time):
Impact:
  • None
User Action:
  • None
.NET Framework Class Library

String.Contains Method

Returns a value indicating whether a specified substring occurs within this string.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
Public Function Contains ( _
	value As String _
) As Boolean

Parameters

value
Type: System.String

The string to seek.

Return Value

Type: System.Boolean
true if the value parameter occurs within this string, or if value is the empty string (""); otherwise, false.
Exception Condition
ArgumentNullException

value is null.

This method performs an ordinal (case-sensitive and culture-insensitive) comparison. The search begins at the first character position of this string and continues through the last character position.

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

' This example demonstrates the String.Contains() method 
Imports System

Class Sample
   Public Shared Sub Main()
      Dim s1 As String = "The quick brown fox jumps over the lazy dog" 
      Dim s2 As String = "fox" 
      Dim b As Boolean
      b = s1.Contains(s2)
      Console.WriteLine("Is the string, s2, in the string, s1?: {0}", b)
   End Sub 'Main
End Class 'Sample

'This example produces the following results: 

'Is the string, s2, in the string, s1?: True 
'

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8