String.Join メソッド (String, String , Int32, Int32)

指定した String 配列の各要素間にある指定した区切り記号 String を連結し、連結された単一の文字列を作成します。パラメータには、最初の配列要素と、使用する要素の数を指定します。

Overloads Public Shared Function Join( _
   ByVal separator As String, _   ByVal value() As String, _   ByVal startIndex As Integer, _   ByVal count As Integer _) As String
[C#]
public static string Join(stringseparator,string[] value,intstartIndex,intcount);
[C++]
public: static String* Join(String* separator,String* value __gc[],intstartIndex,intcount);
[JScript]
public static function Join(
   separator : String,value : String[],startIndex : int,count : int) : String;

パラメータ

• separator
  String 。
• value
  String の配列。
• startIndex
  使用する value の最初の配列要素。
• count
  使用する value の要素の数。

戻り値

separator で結合された value の文字列で構成される String 。

または

count が 0 である場合、value に要素がない場合、または separator と value のすべての要素が Empty である場合は、 Empty 。

例外

解説

たとえば、 separator が ", " であり、 value の要素が "apple"、"orange"、"grape"、および "pear" の場合、 Join(separator, value, 1, 2) は "orange, grape" を返します。

separator が null 参照 (Visual Basic では Nothing) の場合は、空の文字列 (Empty) が挿入されます。

使用例

 
' Sample for String.Join(String, String[], int int)
Imports System
 _

Class Sample
   
   Public Shared Sub Main()
      Dim val As [String]() =  {"apple", "orange", "grape", "pear"}
      Dim sep As [String] = ", "
      Dim result As [String]
      
      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)
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'sep = ', '
'val() = {'apple' 'orange' 'grape' 'pear'}
'String.Join(sep, val, 1, 2) = 'orange, grape'
'

[C#] 
// Sample for String.Join(String, String[], int int)
using System;

class Sample {
    public static void Main() {
    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'
*/

[C++] 
// Sample for String::Join(String, String[], int int)
#using <mscorlib.dll>

using namespace System;

int main() {
    String* val[] = {S"apple", S"orange", S"grape", S"pear"};
    String* sep   = S", ";
    String* result;

    Console::WriteLine(S"sep = '{0}'", sep);
    Console::WriteLine(S"val[] = {{'{0}' '{1}' '{2}' '{3}'}}", val[0], val[1], val[2], val[3]);
    result = String::Join(sep, val, 1, 2);
    Console::WriteLine(S"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'
*/

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

String クラス | String メンバ | System 名前空間 | String.Join オーバーロードの一覧 | Int32 | Concat