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.Substring (Int32)

 

Recupera una subcadena de la instancia. La subcadena empieza en una posición de caracteres especificada y continúa hasta el final de la cadena.

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

public string Substring(
	int startIndex
)

Parámetros

startIndex
Type: System.Int32

Posición de carácter inicial de base cero de una subcadena en la instancia.

Valor devuelto

Type: System.String

Cadena equivalente a la subcadena que comienza en el valor de startIndex de esta instancia, o bien, Empty si el valor de startIndex es igual a la longitud de esta instancia.

Exception Condition
ArgumentOutOfRangeException

startIndex es menor que cero o mayor que la longitud de esta instancia.

Se llama a la Substring método para extraer una subcadena de una cadena que comienza en una posición de carácter especificado y termina al final de la cadena. La posición de carácter inicial está basado en cero; en otras palabras, el primer carácter de la cadena está en el índice 0, no el índice 1. Para extraer una subcadena que comienza en una posición de carácter especificado y termina antes de que el final de la cadena, llame a la Substring método.

System_CAPS_noteNota

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena que comienza en la startIndex posición en la cadena actual.

Para extraer una subcadena que comienza con un determinado carácter o secuencia de caracteres, llamar a un método como IndexOf o IndexOf para obtener el valor de startIndex. El segundo ejemplo ilustra esto. extrae un valor de clave que se inicia una posición de carácter después del carácter "=".

Si startIndex es igual a cero, el método devuelve la cadena original sin cambios.

En el ejemplo siguiente se muestra cómo obtener una subcadena de una cadena.

using System;

public class SubStringTest {
    public static void Main() {
        string [] info = { "Name: Felica Walker", "Title: Mz.", 
                           "Age: 47", "Location: Paris", "Gender: F"};
        int found = 0;

        Console.WriteLine("The initial values in the array are:");
        foreach (string s in info)
            Console.WriteLine(s);

        Console.WriteLine("\nWe want to retrieve only the key information. That is:");        
        foreach (string s in info) {
            found = s.IndexOf(": ");
            Console.WriteLine("   {0}", s.Substring(found + 2));
        }
    }
}
// The example displays the following output:
//       The initial values in the array are:
//       Name: Felica Walker
//       Title: Mz.
//       Age: 47
//       Location: Paris
//       Gender: F
//       
//       We want to retrieve only the key information. That is:
//          Felica Walker
//          Mz.
//          47
//          Paris
//          F

En el ejemplo siguiente se usa el Substring método para separar los pares clave/valor que están delimitadas por es igual a carácter ("=").

using System;

public class Example
{
   public static void Main()
   {
      String[] pairs = { "Color1=red", "Color2=green", "Color3=blue",
                         "Title=Code Repository" };
      foreach (var pair in pairs) {
         int position = pair.IndexOf("=");
         if (position < 0)
            continue;
         Console.WriteLine("Key: {0}, Value: '{1}'", 
                           pair.Substring(0, position),
                           pair.Substring(position + 1));
      }                          
   }
}
// The example displays the following output:
//     Key: Color1, Value: 'red'
//     Key: Color2, Value: 'green'
//     Key: Color3, Value: 'blue'
//     Key: Title, Value: 'Code Repository'

The M:System.String.IndexOf(System.String) method is used to get the position of the equals character in the string.. The call to the M:System.String.Substring(System.Int32,System.Int32) method extracts the key name., which starts from the first character in the string and extends for the number of characters returned by the call to the M:System.String.IndexOf(System.String) method. The call to the M:System.String.Substring(System.Int32) method then extracts the value assigned to the key. It starts at one character position beyond the equals character and extends to the end of the string.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
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: