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 value
com o String
tipo.
O Contains()
método retorna true
se uma string value
estiver presente na string atual. Se a string value
nã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); // True
Linguagem de código: C# ( cs )
Como esperado, ele retorna true
.
O programa a seguir é gerado false
porque 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); // False
Linguagem 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); // True
Linguagem de código: C# ( cs )
Neste exemplo, o Contains()
método retorna true
porque 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 StringComparison
enum, que especifica as regras de comparação.
O exemplo a seguir ilustra como usar o Contains()
método com dois StringComparison
valores 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); // True
Linguagem de código: C# ( cs )
Resumo
- Use o método String
Contains()
para verificar se uma string ou caractere está presente na string atual.