Contains Método (String)
TOC
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

String.Contains (Método) (String)

 

Devuelve un valor que indica si una subcadena especificada aparece dentro de esta cadena.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public bool Contains(
	string value
)

Parámetros

value
Type: System.String

Cadena que se va a buscar.

Valor devuelto

Type: System.Boolean

Es true si el parámetro value aparece en esta cadena o si value es la cadena vacía (""); en caso contrario, es false.

Exception Condition
ArgumentNullException

El valor de value es null.

Este método realiza una comparación ordinal (distingue mayúsculas de minúsculas y la referencia cultural). La búsqueda comienza en la posición del primer carácter de esta cadena y continúa hasta la última posición de carácter.

Para determinar si una cadena contiene una subcadena especificada utilizando un valor distinto de comparación ordinal (por ejemplo, comparación de la referencia cultural o comparación ordinal de mayúsculas y minúsculas), puede crear un método personalizado. En el ejemplo siguiente se muestra uno de estos métodos. Define un String método de extensión que incluye un StringComparison parámetro e indica si una cadena contiene una subcadena al utilizar el formulario especificado de comparación de cadenas.

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;                      
   }
}

El ejemplo siguiente llama a la Contains el método de extensión para determinar si se encuentra una subcadena de una cadena cuando se usa la comparación ordinal y comparación de ordinales entre mayúsculas y minúsculas.

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

Si está interesado en la posición de la subcadena value en la instancia actual, puede llamar a la IndexOf puede llamar al método para obtener la posición inicial de su primera aparición o el LastIndexOf método para obtener la posición inicial de la última aparición. El ejemplo incluye una llamada a la IndexOf(String) método si se encuentra una subcadena en una instancia de cadena.

En el ejemplo siguiente se determina si la cadena "fox" es una subcadena de una cita conocida. Si "fox" se encuentra en la cadena, también muestra su posición inicial.

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
Disponible desde 8
.NET Framework
Disponible desde 2.0
Portable Class Library
Compatible con: portable .NET platforms
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar:
© 2016 Microsoft