String.Concat<T> Method (IEnumerable<T>)
May 02, 2013
Concatenates the members of an IEnumerable<T> implementation.
Assembly: mscorlib (in mscorlib.dll)
Type Parameters
- T
The type of the members of values.
Parameters
- values
- Type: System.Collections.Generic.IEnumerable<T>
A collection object that implements the IEnumerable<T> interface.
| Exception | Condition |
|---|---|
| ArgumentNullException | values is null. |
The method concatenates each object in values; it does not add any delimiters.
An Empty string is used in place of any null argument.
Concat<T>(IEnumerable<T>) is a convenience method that lets you concatenate each element in an IEnumerable<T> collection without first converting the elements to strings. It is particularly useful with Language-Integrated Query (LINQ) query expressions, as the example illustrates. The string representation of each object in the IEnumerable<T> collection is derived by calling that object's ToString method.
The following example defines a very simple Animal class that contains the name of an animal and the order to which it belongs. It then defines a List<T> object to contain a number of Animal objects. The Enumerable.Where extension method is called to extract the Animal objects whose Order property equals "Rodent". The result is passed to the Concat<T>(IEnumerable<T>) method and displayed to the console.
