BCL mscorlib [00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ] 1.0.5000.0 2.0.0.0 4.0.0.0 All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe. System.Object System.Collections.Generic.IEnumerator<System.Char> System.ICloneable System.Runtime.InteropServices.ComVisible(true)

A provides read-only access to the characters in a referenced object. For example, the foreach statement of the Microsoft Visual Basic and C# programming languages, which iterates through the elements of a collection, retrieves a from a object in order to iterate through the characters in that object.

There is no public constructor for . Instead, call a object's method to obtain a that is initialized to reference the string.

A maintains an internal index to the characters in the string the references. The state of the index is invalid when it references a character position logically before the first character or after the last character in the string, and valid when it references a character within the string. The index is initialized to a position logically before the first character, and is set to a position after the last character when the iteration is complete. An exception is thrown if you attempt to access a character while the index is invalid.

The method increments the index by one, so the first and subsequent characters are accessed in turn. The method sets the index to a position logically before the first character. The property retrieves the character currently referenced by index. The method creates a copy of the .

Several independent instances of across one or more threads can have access to a single instance of . This class is implemented to support the interface. For more information regarding the use of an enumerator, see the topic.

Supports iterating over a object and reading its individual characters. This class cannot be inherited.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Object

  The return value is a copy of this instance of and its current state. This is useful for saving your state while iterating through a object.

  For example, suppose your application uses an original instance of to iterate through each character in a . When some unique character is encountered, your application pauses processing and invokes the method. In effect, this saves the object's index in the .

  Your application uses the clone to navigate to another part of the String to perform some auxiliary processing. The side-effect of this navigation is the clone loses track of the position where processing stopped. However, when the auxiliary processing is complete, your application discards the clone and uses the original instance to resume working on the where the original processing stopped.

  This method is implemented to support the interface.

  Creates a copy of the current object.

  An that is a copy of the current object.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Char

  The in the over which the current instance is positioned.

  The current instance is positioned before the first element or after the last element of the .

  The class maintains an internal index to the enumerated string, and the property returns the character that is currently referenced by the index. This property should be invoked only when the index is valid; otherwise, an exception is thrown.

  The index is always invalid for an empty string (""). The index is also invalid after the or method is called. After either of these methods is called, invoke the method to adjust the index to the first character in the enumerated string. The index is valid whenever the method returns true.

  does not move the index, and consecutive calls to return the same character until , , or is called.

  Gets the currently referenced character in the string enumerated by this object.

  0
- Method
  4.0.0.0
  System.Void

  Call when you are finished using the . The method leaves the in an unusable state. After calling , you must release all references to the so the garbage collector can reclaim the memory that the was occupying.

  For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

  Always call before you release your last reference to the . Otherwise, the resources it is using will not be freed until the garbage collector calls the object's Finalize method.

  Releases all resources used by the current instance of the class.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  The class maintains an internal index to the enumerated string, and the method increments the index by one. Call after calling or to increment the current character position to the first character in the enumerated string. Check that the return value is true to determine that the current character position is valid.

  If the index is already beyond the last character of the enumerated string, the index is not changed and false is returned.

  Notice that if the enumerated string is empty (""), the state of the is always invalid. This is because the internal index for the is initially before the first character of the enumerated string and is therefore invalid. logically sets the index after the last (nonexistent) character of the enumerated string which is also invalid.

  Increments the internal index of the current object to the next character of the enumerated string.

  true if the index is successfully incremented and within the enumerated string; otherwise, false.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Void

  The class maintains an internal index to the enumerated string, and the method sets the index to the invalid state.

  Initializes the index to a position logically before the first character of the enumerated string.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Object To be added.

  This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.

  Gets the currently referenced character in the string enumerated by this object. For a description of this member, see .

- Method
  System.Void

  Call when you are finished using the class. The method leaves the class in an unusable state. After calling it, you must release all references to the class so the garbage collector can reclaim the memory that the class was occupying.

  For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

  Always call before you release your last reference to the class. Otherwise, the resources it is using will not be freed until the garbage collector calls the object's method.

  Releases all resources used by the class.

  2.0.0.0
0