String.GetEnumerator Method
Retrieves an object that can iterate through the individual characters in this string.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
This method is required by programming languages that support the IEnumerator interface to iterate through members of a collection. For example, the Microsoft Visual Basic and C# programming languages' foreach statement invokes this method to return a CharEnumerator object that can provide read-only access to the characters in this instance of String.
The following example uses the GetEnumerator method to display each System.Char in the input strings.
// Example for the String.GetEnumerator( ) method. using System; using System.Collections; class GetEnumerator { public static void Main() { Console.WriteLine( "This example of String.GetEnumerator( ) " + "generates the following output." ); EnumerateAndDisplay( "Test Case" ); EnumerateAndDisplay( "Has\ttwo\ttabs" ); EnumerateAndDisplay( "Two\nnew\nlines" ); } static void EnumerateAndDisplay( String Operand ) { Console.WriteLine( "\nThe characters in the string \"{0}\" are:", Operand ); IEnumerator OperandEnum = Operand.GetEnumerator( ); int CharCount = 0; while( OperandEnum.MoveNext( ) ) { CharCount++; Console.Write( " '{0}' ", OperandEnum.Current ); } Console.WriteLine( "\n Character count: {0}", CharCount ); } } /* This example of String.GetEnumerator( ) generates the following output. The characters in the string "Test Case" are: 'T' 'e' 's' 't' ' ' 'C' 'a' 's' 'e' Character count: 9 The characters in the string "Has two tabs" are: 'H' 'a' 's' ' ' 't' 'w' 'o' ' ' 't' 'a' 'b' 's' Character count: 12 The characters in the string "Two new lines" are: 'T' 'w' 'o' ' ' 'n' 'e' 'w' ' ' 'l' 'i' 'n' 'e' 's' Character count: 13 */
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.