String.Concat Method (IEnumerable<String>)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Concatenates the members of a constructed IEnumerable<T> collection of type String.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<ComVisibleAttribute(False)> _
Public Shared Function Concat ( _
values As IEnumerable(Of String) _
) As String
[ComVisibleAttribute(false)]
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.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | values is nulla null reference (Nothing in Visual Basic). |
Remarks
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.
Examples
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.
Version Information
Silverlight
Supported in: 5, 4
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.