Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String::Join Method (String, array<String>, Int32, Int32)

Concatenates the specified elements of a string array, using the specified separator between each element.

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

public:
static String^ Join(
	String^ separator, 
	array<String^>^ value, 
	int startIndex, 
	int count
)

Parameters

separator
Type: System::String

The string to use as a separator. separator is included in the returned string only if value has more than one element.

value
Type: array<System::String>

An array that contains the elements to concatenate.

startIndex
Type: System::Int32

The first element in value to use.

count
Type: System::Int32

The number of elements of value to use.

Return Value

Type: System::String
A string that consists of the strings in value delimited by the separator string.
-or-
String::Empty if count is zero, value has no elements, or separator and all the elements of value are String::Empty.

ExceptionCondition
ArgumentNullException

value is nullptr.

ArgumentOutOfRangeException

startIndex or count is less than 0.

-or-

startIndex plus count is greater than the number of elements in value.

OutOfMemoryException

Out of memory.

For example, if separator is ", " and the elements of value are "apple", "orange", "grape", and "pear", Join(separator, value, 1, 2) returns "orange, grape".

If separator is nullptr, an empty string (String::Empty) is used instead. If any element in value is nullptr, an empty string is used instead.

The following example concatenates two elements from an array of names of fruit.

// Sample for String::Join(String, String[], int int) 
using namespace System;
int main()
{
   array<String^>^val = {"apple","orange","grape","pear"};
   String^ sep = ", ";
   String^ result;
   Console::WriteLine( "sep = '{0}'", sep );
   Console::WriteLine( "val[] = {{'{0}' '{1}' '{2}' '{3}'}}", val[ 0 ], val[ 1 ], val[ 2 ], val[ 3 ] );
   result = String::Join( sep, val, 1, 2 );
   Console::WriteLine( "String::Join(sep, val, 1, 2) = '{0}'", result );
}

/*
This example produces the following results:
sep = ', '
val[] = {'apple' 'orange' 'grape' 'pear'}
String::Join(sep, val, 1, 2) = 'orange, grape'
*/

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Show:
© 2015 Microsoft