String::Join Method (String^, IEnumerable<String^>^)
Concatenates the members of a constructed IEnumerable<T> collection of type String, using the specified separator between each member.
Assembly: mscorlib (in mscorlib.dll)
public: [ComVisibleAttribute(false)] static String^ Join( String^ separator, IEnumerable<String^>^ values )
Parameters
- separator
-
Type:
System::String^
The string to use as a separator.separator is included in the returned string only if values has more than one element.
- values
-
Type:
System.Collections.Generic::IEnumerable<String^>^
A collection that contains the strings to concatenate.
Return Value
Type: System::String^A string that consists of the members of values delimited by the separator string. If values has no members, the method returns String::Empty.
| Exception | Condition |
|---|---|
| ArgumentNullException | values is null. |
If separator is null, an empty string (String::Empty) is used instead. If any member of values is null, an empty string is used instead.
Join(String^, 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 returned by the Enumerable::Where<TSource> method is passed to the Join(String^, IEnumerable<String^>^) method to display the result as a single string.
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 7.1
Windows Phone
Available since 8.1