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

Método String.IndexOf (String, Int32, Int32, StringComparison)

 

Devuelve el índice de base cero de la primera aparición de la cadena especificada en el objeto String actual. Los parámetros indican la posición inicial de búsqueda en la cadena actual, el número de caracteres de la cadena actual en los que buscar y el tipo de búsqueda que se va a usar para la cadena especificada.

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

public int IndexOf(
	string value,
	int startIndex,
	int count,
	StringComparison comparisonType
)

Parámetros

value
Type: System.String

Cadena que se va a buscar.

startIndex
Type: System.Int32

Posición en la que comienza la búsqueda.

count
Type: System.Int32

Número de posiciones de caracteres que se van a examinar.

comparisonType
Type: System.StringComparison

Uno de los valores de enumeración que especifica las reglas de la búsqueda.

Valor devuelto

Type: System.Int32

Posición de índice de base cero del parámetro value desde el principio de la instancia actual si se encuentra esa cadena o, de lo contrario, -1. Si value es Empty, el valor devuelto es startIndex.

Exception Condition
ArgumentNullException

El valor de value es null.

ArgumentOutOfRangeException

count o startIndex es negativo.

O bien

startIndex es mayor que la longitud de esta instancia.

O bien

count es mayor que la longitud de esta cadena menos startIndex.

ArgumentException

comparisonType no es un valor System.StringComparison válido.

Numeración del índice se inicia en 0 (cero). El parámetro startIndex puede estar comprendido entre 0 y la longitud de la instancia de cadena.

La búsqueda comienza en startIndex y continúa startIndex + count -1. El carácter que ocupa startIndex + count no se incluye en la búsqueda.

El comparisonType parámetro especifica que se busquen los value parámetro usando la referencia cultural actual o invariable, mediante una búsqueda de mayúsculas y minúsculas o mayúsculas de minúsculas y con word o reglas de comparación de ordinales.

Notas para llamadores:

Los juegos de caracteres incluyen caracteres que se pueden pasar por alto, que son los caracteres que no se tienen en cuenta al realizar una comparación lingüística o en la que se tiene en cuenta la referencia cultural. En una búsqueda que tiene en cuenta la referencia cultural (es decir, si comparisonType no es StringComparison.Ordinal o StringComparison.OrdinalIgnoreCase), si value contiene un carácter que se puede pasar por alto, el resultado es equivalente a buscar sin ese carácter. Si value consta únicamente de uno o varios de los caracteres pueden pasar por alto la IndexOf(String, Int32, Int32, StringComparison) método siempre devuelve startIndex, que es la posición del carácter en el que comienza la búsqueda.

En el ejemplo siguiente, la IndexOf(String, Int32, Int32, StringComparison) método se usa para buscar la posición de un guion (00AD) seguida por una "m" a partir de la tercera y la sexta posición de carácter de dos cadenas. Solo una de las cadenas contiene la subcadena necesaria. Si se ejecuta el ejemplo la .NET Framework 4 o una versión posterior, en ambos casos, como el guion virtual es un carácter puede pasar por alto, el método devuelve el índice de "m" en la cadena cuando realiza una comparación dependiente de la referencia cultural. Cuando realiza una comparación ordinal, sin embargo, busca la subcadena solo en la primera cadena. Tenga en cuenta que en el caso de la primera cadena, que incluye el guion seguido de una "m", el método no devuelve el índice del guion pero en su lugar, devuelve el índice de la "m" cuando realiza una comparación dependiente de la referencia cultural. El método devuelve el índice del guion virtual de la primera cadena solo cuando realiza una comparación ordinal.

using System;

public class Example
{
   public static void Main()
   {
      string searchString = "\u00ADm";
      string s1 = "ani\u00ADmal" ;
      string s2 = "animal";

      Console.WriteLine(s1.IndexOf(searchString, 2, 4, StringComparison.CurrentCulture));
      Console.WriteLine(s1.IndexOf(searchString, 2, 4, StringComparison.Ordinal));
      Console.WriteLine(s2.IndexOf(searchString, 2, 4, StringComparison.CurrentCulture));
      Console.WriteLine(s2.IndexOf(searchString, 2, 4, StringComparison.Ordinal));
   }
}
// The example displays the following output:
//       4
//       3
//       3
//       -1

El siguiente exampledemonstrates tres sobrecargas de la IndexOf método que busca la primera aparición de una cadena dentro de otra cadena utilizando diferentes valores de la StringComparison enumeración.

// This code example demonstrates the 
// System.String.IndexOf(String, ..., StringComparison) methods.

using System;
using System.Threading;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    string intro = "Find the first occurrence of a character using different " + 
                   "values of StringComparison.";
    string resultFmt = "Comparison: {0,-28} Location: {1,3}";

// Define a string to search for.
// U+00c5 = LATIN CAPITAL LETTER A WITH RING ABOVE
    string CapitalAWithRing = "\u00c5"; 

// Define a string to search. 
// The result of combining the characters LATIN SMALL LETTER A and COMBINING 
// RING ABOVE (U+0061, U+030a) is linguistically equivalent to the character 
// LATIN SMALL LETTER A WITH RING ABOVE (U+00e5).
    string cat = "A Cheshire c" + "\u0061\u030a" + "t";

    int loc = 0;
    StringComparison[] scValues = {
        StringComparison.CurrentCulture,
        StringComparison.CurrentCultureIgnoreCase,
        StringComparison.InvariantCulture,
        StringComparison.InvariantCultureIgnoreCase,
        StringComparison.Ordinal,
        StringComparison.OrdinalIgnoreCase };

// Clear the screen and display an introduction.
    Console.Clear();
    Console.WriteLine(intro);

// Display the current culture because culture affects the result. For example, 
// try this code example with the "sv-SE" (Swedish-Sweden) culture.

    Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
    Console.WriteLine("The current culture is \"{0}\" - {1}.", 
                       Thread.CurrentThread.CurrentCulture.Name,
                       Thread.CurrentThread.CurrentCulture.DisplayName);

// Display the string to search for and the string to search.
    Console.WriteLine("Search for the string \"{0}\" in the string \"{1}\"", 
                       CapitalAWithRing, cat);
    Console.WriteLine();

// Note that in each of the following searches, we look for 
// LATIN CAPITAL LETTER A WITH RING ABOVE in a string that contains 
// LATIN SMALL LETTER A WITH RING ABOVE. A result value of -1 indicates 
// the string was not found.
// Search using different values of StringComparison. Specify the start 
// index and count. 

    Console.WriteLine("Part 1: Start index and count are specified.");
    foreach (StringComparison sc in scValues)
        {
        loc = cat.IndexOf(CapitalAWithRing, 0, cat.Length, sc);
        Console.WriteLine(resultFmt, sc, loc);
        }

// Search using different values of StringComparison. Specify the 
// start index. 
    Console.WriteLine("\nPart 2: Start index is specified.");
    foreach (StringComparison sc in scValues)
        {
        loc = cat.IndexOf(CapitalAWithRing, 0, sc);
        Console.WriteLine(resultFmt, sc, loc);
        }

// Search using different values of StringComparison. 
    Console.WriteLine("\nPart 3: Neither start index nor count is specified.");
    foreach (StringComparison sc in scValues)
        {
        loc = cat.IndexOf(CapitalAWithRing, sc);
        Console.WriteLine(resultFmt, sc, loc);
        }
    }
}

/*
Note: This code example was executed on a console whose user interface 
culture is "en-US" (English-United States).

This code example produces the following results:

Find the first occurrence of a character using different values of StringComparison.
The current culture is "en-US" - English (United States).
Search for the string "Å" in the string "A Cheshire ca°t"

Part 1: Start index and count are specified.
Comparison: CurrentCulture               Location:  -1
Comparison: CurrentCultureIgnoreCase     Location:  12
Comparison: InvariantCulture             Location:  -1
Comparison: InvariantCultureIgnoreCase   Location:  12
Comparison: Ordinal                      Location:  -1
Comparison: OrdinalIgnoreCase            Location:  -1

Part 2: Start index is specified.
Comparison: CurrentCulture               Location:  -1
Comparison: CurrentCultureIgnoreCase     Location:  12
Comparison: InvariantCulture             Location:  -1
Comparison: InvariantCultureIgnoreCase   Location:  12
Comparison: Ordinal                      Location:  -1
Comparison: OrdinalIgnoreCase            Location:  -1

Part 3: Neither start index nor count is specified.
Comparison: CurrentCulture               Location:  -1
Comparison: CurrentCultureIgnoreCase     Location:  12
Comparison: InvariantCulture             Location:  -1
Comparison: InvariantCultureIgnoreCase   Location:  12
Comparison: Ordinal                      Location:  -1
Comparison: OrdinalIgnoreCase            Location:  -1

*/

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: