String.Concat Method (IEnumerable<String>)

July 28, 2014

Concatenates the members of a constructed IEnumerable<T> collection of type String.

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

public static string Concat(
	IEnumerable<string> values
)

Parameters

values
Type: System.Collections.Generic.IEnumerable<String>
A collection object that implements IEnumerable<T> and whose generic type argument is String.

Return Value

Type: System.String
The concatenated strings in values.

ExceptionCondition
ArgumentNullException

values is null.

The method concatenates each object in values; it does not add any delimiters. To specify a delimiter between each member of values, call the Join(String, IEnumerable<String>) method.

An Empty string is used in place of any null argument.

Concat(IEnumerable<String>) is a convenience method that lets you concatenate each element in an IEnumerable(Of String) collection without first converting the elements to a string array. It is particularly useful with Language-Integrated Query (LINQ) query expressions. The following example passes a List(Of String) object that contains either the uppercase or lowercase letters of the alphabet to a lambda expression that selects letters that are equal to or greater than a particular letter (which, in the example, is "M"). The IEnumerable(Of String) collection that is returned by the Enumerable.Where method is passed to the Concat(IEnumerable<String>) method to display the result as a single string.

The following example uses the Sieve of Eratosthenes algorithm to calculate the prime numbers that are less than or equal to 100. It assigns the result to a List<T> object of type String, which it then passes to the Concat(IEnumerable<String>) method.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Windows Phone

Show:
© 2014 Microsoft