Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo String.Contains (String)

 

Data di pubblicazione: luglio 2016

Restituisce un valore che indica se una sottostringa specificata è presente all'interno della stringa.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public bool Contains(
	string value
)

Parametri

value
Type: System.String

Stringa da cercare.

Valore restituito

Type: System.Boolean

true se il parametro value è presente all'interno della stringa o se il parametro value è la stringa vuota (""); in caso contrario, false.

Exception Condition
ArgumentNullException

value è null.

Questo metodo esegue un confronto ordinale (maiuscole/minuscole e senza distinzione di impostazioni cultura). La ricerca inizia in corrispondenza della posizione di carattere prima di questa stringa e continua fino all'ultima posizione di carattere.

Per determinare se una stringa contiene la sottostringa specificata con un valore diverso da un confronto ordinale (ad esempio, confronto con distinzione delle impostazioni cultura o un confronto ordinale tra maiuscole e minuscole), è possibile creare un metodo personalizzato. Nell'esempio seguente viene illustrato un approccio. Definisce un String metodo di estensione che include un StringComparison parametro e indica se una stringa contiene una sottostringa quando si usa il modulo di confronto di stringhe specificato.

using System;

public static class StringExtensions
{
   public static bool Contains(this String str, String substring, 
                               StringComparison comp)
   {                            
      if (substring == null)
         throw new ArgumentNullException("substring", 
                                         "substring cannot be null.");
      else if (! Enum.IsDefined(typeof(StringComparison), comp))
         throw new ArgumentException("comp is not a member of StringComparison",
                                     "comp");

      return str.IndexOf(substring, comp) >= 0;                      
   }
}

Nell'esempio seguente viene chiamato il Contains metodo di estensione per determinare se una sottostringa è presente in una stringa quando si utilizza un confronto ordinale e confronto ordinale tra maiuscole e minuscole.

using System;

public class Example
{
   public static void Main()
   {
      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

Se si è interessati nella posizione della sottostringa value nell'istanza corrente, è possibile chiamare il IndexOf metodo per ottenere la posizione iniziale della prima occorrenza, oppure è possibile chiamare il LastIndexOf metodo per ottenere la posizione iniziale della ultima occorrenza. L'esempio include una chiamata al IndexOf(String) metodo se viene trovata una sottostringa in un'istanza di stringa.

Nell'esempio seguente determina se la stringa "volpe" è una sottostringa di una frase. Se viene trovati "volpe" nella stringa, vengono inoltre visualizzate la posizione iniziale.

using System;

class Example
{
    public static void Main() 
    {
       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 display the following output:
//    'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
//    'fox begins at character position 17

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 2.0
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: