String.Contains Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: netstandard.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Contains(Char)	Zwraca wartość wskazującą, czy określony znak występuje w tym ciągu.
Contains(String)	Zwraca wartość wskazującą, czy określony podciąg występuje w tym ciągu.
Contains(Char, StringComparison)	Zwraca wartość wskazującą, czy określony znak występuje w tym ciągu przy użyciu określonych reguł porównania.
Contains(String, StringComparison)	Zwraca wartość wskazującą, czy określony ciąg występuje w tym ciągu przy użyciu określonych reguł porównania.

Contains(Char)

Zwraca wartość wskazującą, czy określony znak występuje w tym ciągu.

public:
 bool Contains(char value);

public bool Contains (char value);

member this.Contains : char -> bool

Public Function Contains (value As Char) As Boolean

Parametry

value: Char

Znak do szukania.

Zwraca

Boolean

true Jeśli parametr value występuje w tym ciągu; w przeciwnym razie false .

Uwagi

Ta metoda wykonuje porównanie porządkowe (wielkość liter i niewrażliwość na ustawienia kulturowe).

Dotyczy

Contains(String)

Zwraca wartość wskazującą, czy określony podciąg występuje w tym ciągu.

public:
 bool Contains(System::String ^ value);

public bool Contains (string value);

member this.Contains : string -> bool

Public Function Contains (value As String) As Boolean

Parametry

value: String

Ciąg do wyszukania.

Zwraca

Boolean

true jeśli parametr value występuje w tym ciągu lub jeśli jest value pustym ciągiem (""); w przeciwnym false razie .

Wyjątki

ArgumentNullException

value to null.

Przykłady

Poniższy przykład określa, czy ciąg "fox" jest podciągiem znanego cudzysłowu. Jeśli w ciągu znajduje się "fox", wyświetlana jest również jego pozycja początkowa.

using namespace System;

int main()
{
   String^ s1 = "The quick brown fox jumps over the lazy dog";
   String^ s2 = "fox";
   bool b = s1->Contains( s2 );
   Console::WriteLine( "Is the string, s2, in the string, s1?: {0}", b );
   if (b) {
      int index = s1->IndexOf(s2);
      if (index >= 0)
         Console::WriteLine("'{0} begins at character position {1}",
                            s2, index + 1);
   }
}
// This example displays the following output:
//    'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
//    'fox begins at character position 17

string s1 = "The quick brown fox jumps over the lazy dog";
string s2 = "fox";
bool b = s1.Contains(s2);
Console.WriteLine("'{0}' is in the string '{1}': {2}",
                s2, s1, b);
if (b) {
    int index = s1.IndexOf(s2);
    if (index >= 0)
        Console.WriteLine("'{0} begins at character position {1}",
                      s2, index + 1);
}
// This example displays the following output:
//    'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
//    'fox begins at character position 17

Class Example
   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 = s1.Contains(s2)
      Console.WriteLine("'{0}' is in the string '{1}': {2}",
                        s2, s1, b)
      If b Then
          Dim index As Integer = s1.IndexOf(s2)
          If index >= 0 Then
             Console.WriteLine("'{0} begins at character position {1}",
                               s2, index + 1)
          End If
       End If
   End Sub
End Class
'
' This example displays the following output:
'    'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
'    'fox begins at character position 17

Uwagi

Ta metoda wykonuje porównanie porządkowe (wielkość liter i niewrażliwość na ustawienia kulturowe). Wyszukiwanie rozpoczyna się od pierwszego znaku w tym ciągu i jest kontynuowane do ostatniej pozycji znaku.

Aby wykonać porównanie z rozróżnianą kulturą lub porządkową bez uwzględniania wielkości liter:

Na .NET Core 2.1 i nowszych wersjach: zamiast tego Contains(Char, StringComparison) wywołaj przeciążenie.
Na .NET Framework: Utwórz metodę niestandardową. Poniższy przykład ilustruje jedno z takich podejść. Definiuje ona metodę rozszerzenia, która zawiera parametr i wskazuje, czy ciąg zawiera podciąg podczas korzystania z określonej String StringComparison formy porównywania ciągów.

String s = "This is a string.";
String sub1 = "this";
Console.WriteLine("Does '{0}' contain '{1}'?", s, sub1);
StringComparison comp = StringComparison.Ordinal;
Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp));

comp = StringComparison.OrdinalIgnoreCase;
Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp));

// The example displays the following output:
//       Does 'This is a string.' contain 'this'?
//          Ordinal: False
//          OrdinalIgnoreCase: True

Public Module Example
   Public Sub Main
      Dim s As String = "This is a string."
      Dim sub1 As String = "this"
      Console.WriteLine("Does '{0}' contain '{1}'?", s, sub1)
      Dim comp As StringComparison = StringComparison.Ordinal
      Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp))
      
      comp = StringComparison.OrdinalIgnoreCase
      Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp))
   End Sub
End Module
' The example displays the following output:
'       Does 'This is a string.' contain 'this'?
'          Ordinal: False
'          OrdinalIgnoreCase: True

Jeśli interesuje Cię pozycja podciągu w bieżącym wystąpieniu, możesz wywołać metodę , aby uzyskać pozycję początkową pierwszego wystąpienia, lub wywołać metodę , aby uzyskać pozycję początkową jego ostatniego value IndexOf LastIndexOf wystąpienia. Przykład zawiera wywołanie metody , jeśli podciąg zostanie znaleziony IndexOf(String) w wystąpieniu ciągu.

Zobacz też

Dotyczy

Contains(Char, StringComparison)

Zwraca wartość wskazującą, czy określony znak występuje w tym ciągu przy użyciu określonych reguł porównania.

public:
 bool Contains(char value, StringComparison comparisonType);

public bool Contains (char value, StringComparison comparisonType);

member this.Contains : char * StringComparison -> bool

Public Function Contains (value As Char, comparisonType As StringComparison) As Boolean

Parametry

value: Char

Znak do szukania.

comparisonType: StringComparison

Jedna z wartości wyliczenia, która określa reguły do użycia w porównaniu.

Zwraca

Boolean

true Jeśli parametr value występuje w tym ciągu; w przeciwnym razie false .

Dotyczy

Contains(String, StringComparison)

Zwraca wartość wskazującą, czy określony ciąg występuje w tym ciągu przy użyciu określonych reguł porównania.

public:
 bool Contains(System::String ^ value, StringComparison comparisonType);

public bool Contains (string value, StringComparison comparisonType);

member this.Contains : string * StringComparison -> bool

Public Function Contains (value As String, comparisonType As StringComparison) As Boolean

Parametry

value: String

Ciąg do wyszukania.

comparisonType: StringComparison

Jedna z wartości wyliczenia, która określa reguły do użycia w porównaniu.

Zwraca

Boolean

true jeśli parametr value występuje w tym ciągu lub jeśli jest value pustym ciągiem (""); w przeciwnym false razie .

Dotyczy