String C# contém

Resumo : neste tutorial, você aprenderá como usar o Contains()método C# String para verificar se uma substring está presente em uma determinada string.

Introdução ao método C# String Contém

O método C# String Contains()permite verificar se uma string está presente em outra string. Aqui está a sintaxe do Contains()método:

public bool Contains(string value)Linguagem de código:  C#  ( cs )

O Contains()método aceita um parâmetro valuecom o Stringtipo.

O Contains()método retorna truese uma string valueestiver presente na string atual. Se a string valuenão estiver presente na string atual, o Contains()método retornará false.

Por exemplo, o programa a seguir usa o Contains()método para verificar se a string "awesome"ocorre na string "C# is awesome":

using static System.Console;

var message = "C# is awesome";
var result = message.Contains("awesome");

WriteLine(result); // TrueLinguagem de código:  C#  ( cs )

Como esperado, ele retorna true.

O programa a seguir é gerado falseporque a string "C# is awesome"não possui a substring "cool":

using static System.Console;

var message = "C# is awesome";
var result = message.Contains("cool");
WriteLine(result); // FalseLinguagem de código:  C#  ( cs )

Além de aceitar uma string, o Contains()método possui uma sobrecarga que aceita um caractere como parâmetro:

public bool Contains (char value);Linguagem de código:  C#  ( cs )

Por exemplo:

using static System.Console;

var message = "C# is awesome";
var result = message.Contains('#');

WriteLine(result); // TrueLinguagem de código:  C#  ( cs )

Neste exemplo, o Contains()método retorna trueporque a mensagem "C# is awesome"contém o caractere '#'.

Por padrão, o Contains()método compara strings usando uma comparação ordinal , o que significa que ele considera a distinção entre maiúsculas e minúsculas e a insensibilidade à cultura.

Para realizar uma comparação sensível à cultura, use a seguinte versão de sobrecarga do Contains()método:

public bool Contains (
    string value, 
    StringComparison comparisonType
);Linguagem de código:  C#  ( cs )

Nesta sintaxe, the comparisonTypeé um dos valores de enumeração do StringComparisonenum, que especifica as regras de comparação.

O exemplo a seguir ilustra como usar o Contains()método com dois StringComparisonvalores enum diferentes que comparam strings com e sem distinção entre maiúsculas e minúsculas:

using static System.Console;

var message = "C# is awesome";

var result = message.Contains("c",StringComparison.Ordinal);
WriteLine(result); // False

result = message.Contains("c", StringComparison.OrdinalIgnoreCase);
WriteLine(result); // TrueLinguagem de código:  C#  ( cs )

Resumo

• Use o método String Contains()para verificar se uma string ou caractere está presente na string atual.