String.Substring Method (Int32)

May 11, 2014

Retrieves a substring from this instance. The substring starts at a specified character position.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public string Substring(
	int startIndex
)

Parameters

startIndex
Type: System.Int32
The zero-based starting character position of a substring in this instance.

Return Value

Type: System.String
A string that is equivalent to the substring that begins at startIndex in this instance, or Empty if startIndex is equal to the length of this instance.

ExceptionCondition
ArgumentOutOfRangeException

startIndex is less than zero or greater than the length of this instance.

The index is zero-based.

NoteNote:

This method does not modify the value of the current instance. Instead, it returns a new string that begins at the startIndex position in the current string.

The following code example demonstrates obtaining a substring from a string.


using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {

      string[] info = { "Name: Felica Walker", "Title: Mz.", "Age: 47", "Location: Paris", "Gender: F" };
      int found = 0;

      outputBlock.Text += "The initial values in the array are:" + "\n";
      foreach (string s in info)
         outputBlock.Text += s + "\n";

      outputBlock.Text += String.Format("{0}We want to retrieve only the key information. That is:", "\n") + "\n";

      foreach (string s in info)
      {
         found = s.IndexOf(":");
         outputBlock.Text += s.Substring(found + 1) + "\n";
      }
   }
}
// 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


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft