String::Concat Method (array<String^>^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Concatenates the elements of a specified String array.

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

static String^ Concat(
	... array<String^>^ values


Type: array<System::String^>^

An array of string instances.

Return Value

Type: System::String^

The concatenated elements of values.

Exception Condition

values is null.


Out of memory.

The method concatenates each object in values; it does not add any delimiters.

An Empty string is used in place of any null object in the array.

The following example demonstrates the use of the Concat method with a String array.

using namespace System;

int main()

   // Make an array of strings. Note that we have included spaces.
   array<String^>^s = { "hello ", "and ", "welcome ", "to ",
                        "this ", "demo! "};

   // Put all the strings together.
   Console::WriteLine( String::Concat(s) );

   // Sort the strings, and put them together.
   Array::Sort( s );
   Console::WriteLine( String::Concat(s));
// The example displays the following output:
//       hello and welcome to this demo!
//       and demo! hello this to welcome

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top