String.Substring Method (Int32)

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


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.


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

The index is zero-based.


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).Trim() + "\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


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.