C#のstring.Join完全ガイド｜配列・リストを区切り文字で結合する使い方と実例

はじめに

C#で配列やリストの要素を1つの文字列にまとめたいときは、string.Joinを使うのが定番です。

たとえば、次のような場面です。

C#
var names = new[] { "Alice", "Bob", "Charlie" };

string result = string.Join(", ", names);

Console.WriteLine(result);

実行結果は次のようになります。

Alice, Bob, Charlie

string.Joinを使うと、配列・List<string>・List<int>・LINQの結果などを、カンマ区切り、スペース区切り、改行区切りなどの文字列に簡単に変換できます。

この記事では、C#のstring.Joinについて、基本構文から配列・リストでの使い方、nullや空文字の扱い、よくあるエラー、実務で使えるサンプルまで詳しく解説します。

1. C#のstring.Joinとは？配列・リストを区切り文字で結合する基本

1-1. string.Joinでできること

string.Joinは、複数の要素を指定した区切り文字でつなげて、1つの文字列にするメソッドです。

たとえば、配列の中身をカンマ区切りで結合できます。

C#
string[] fruits = { "Apple", "Banana", "Orange" };

string result = string.Join(", ", fruits);

Console.WriteLine(result);

実行結果は次のとおりです。

Apple, Banana, Orange

このように、string.Joinを使うと、要素と要素の間にだけ区切り文字を入れて文字列を作れます。

重要なのは、最後の要素の後ろには区切り文字が付かないことです。

C#
string[] values = { "A", "B", "C" };

Console.WriteLine(string.Join(",", values));

実行結果は次のようになります。

A,B,C

A,B,C,のように、末尾に余計なカンマは付きません。

1-2. 「c# join string」で検索する人が知りたい結論

C#で文字列を結合したい場合、目的によって使うメソッドが変わります。

配列やリストを区切り文字付きで結合したいなら、基本的にはstring.Joinを使います。

C#
var list = new List<string> { "red", "green", "blue" };

string result = string.Join(" / ", list);

Console.WriteLine(result);

実行結果は次のとおりです。

red / green / blue

つまり、「c# join string」で検索している人がまず覚えるべき結論は次のとおりです。

配列やリストをカンマ区切りなどで1つの文字列にしたい場合は、string.Join(区切り文字, 結合対象)を使います。

C#
string result = string.Join(", ", values);

この形を覚えておけば、多くのケースに対応できます。

1-3. string.Joinを使うべきケース

string.Joinは、複数の値を区切り文字付きで表示・出力したいときに向いています。

代表的なケースは次のようなものです。

C#
string[] names = { "田中", "佐藤", "鈴木" };

string displayText = string.Join("、", names);

Console.WriteLine(displayText);

実行結果は次のとおりです。

田中、佐藤、鈴木

ログ出力にもよく使われます。

C#
int[] ids = { 101, 102, 103 };

Console.WriteLine($"対象ID: {string.Join(", ", ids)}");

実行結果は次のとおりです。

対象ID: 101, 102, 103

エラーメッセージを改行区切りで表示する場合にも便利です。

C#
var errors = new List<string>
{
    "名前を入力してください。",
    "メールアドレスを入力してください。",
    "パスワードは8文字以上にしてください。"
};

string message = string.Join(Environment.NewLine, errors);

Console.WriteLine(message);

実行結果は次のようになります。

名前を入力してください。
メールアドレスを入力してください。
パスワードは8文字以上にしてください。

string.Joinは、次のような場面で特に便利です。

配列の中身を表示したいとき、リストをカンマ区切りにしたいとき、ログに複数の値を出したいとき、画面表示用の文字列を作りたいとき、改行区切りのメッセージを作りたいときなどです。

1-4. 文字列連結の「+」「StringBuilder」「Concat」との違い

C#には文字列を結合する方法が複数あります。

たとえば、+演算子を使う方法です。

C#
string firstName = "Taro";
string lastName = "Yamada";

string fullName = lastName + " " + firstName;

Console.WriteLine(fullName);

実行結果は次のとおりです。

Yamada Taro

+は、少数の文字列を直接つなげる場合に読みやすいです。

一方で、配列やリストの要素を区切り文字付きで結合する場合は、+よりもstring.Joinのほうが適しています。

C#
var items = new[] { "A", "B", "C" };

string result = string.Join(",", items);

StringBuilderは、ループの中で何度も文字列を追加していくような処理に向いています。

C#
var builder = new System.Text.StringBuilder();

builder.Append("Hello");
builder.Append(" ");
builder.Append("World");

string result = builder.ToString();

Console.WriteLine(result);

実行結果は次のとおりです。

Hello World

string.Concatは、区切り文字を入れずに文字列を連結するメソッドです。

C#
string[] values = { "A", "B", "C" };

string result = string.Concat(values);

Console.WriteLine(result);

実行結果は次のとおりです。

ABC

違いをまとめると、次のようになります。

C#
string[] values = { "A", "B", "C" };

Console.WriteLine(string.Join(",", values));  // A,B,C
Console.WriteLine(string.Concat(values));     // ABC

区切り文字を入れたいならstring.Join、区切り文字なしで単純につなげたいならstring.Concat、少数の文字列なら+や文字列補間、複雑な組み立てならStringBuilderを使うと考えると分かりやすいです。

2. string.Joinの基本構文と引数の意味

2-1. 基本構文：string.Join(区切り文字, 結合対象)

string.Joinの基本構文は次のとおりです。

C#
string result = string.Join(区切り文字, 結合対象);

実際のコードでは、次のように書きます。

C#
string[] values = { "A", "B", "C" };

string result = string.Join(",", values);

Console.WriteLine(result);

実行結果は次のとおりです。

A,B,C

第1引数には区切り文字を指定します。

第2引数には、結合したい配列やリストを指定します。

C#
var numbers = new List<int> { 1, 2, 3 };

string result = string.Join(" - ", numbers);

Console.WriteLine(result);

実行結果は次のとおりです。

1 - 2 - 3

string.Joinは、文字列配列だけでなく、数値のリストなどにも使えます。

2-2. 第1引数：区切り文字の指定方法

第1引数には、要素と要素の間に入れる文字列を指定します。

カンマ区切りにする場合は、次のように書きます。

C#
string result = string.Join(",", values);

カンマの後にスペースを入れたい場合は、次のようにします。

C#
string result = string.Join(", ", values);

スペース区切りにする場合は、次のように書きます。

C#
string result = string.Join(" ", values);

改行区切りにする場合は、Environment.NewLineを使うと環境に合った改行コードを使えます。

C#
string result = string.Join(Environment.NewLine, values);

スラッシュ区切りも可能です。

C#
string result = string.Join("/", values);

区切り文字には、任意の文字列を指定できます。

C#
string[] words = { "C#", "Java", "Python" };

Console.WriteLine(string.Join(" | ", words));

実行結果は次のとおりです。

C# | Java | Python

2-3. 第2引数：配列・List・IEnumerableの指定方法

第2引数には、結合したい要素の集合を指定します。

文字列配列を渡す例です。

C#
string[] names = { "Alice", "Bob", "Charlie" };

string result = string.Join(", ", names);

List<string>を渡す例です。

C#
List<string> names = new List<string> { "Alice", "Bob", "Charlie" };

string result = string.Join(", ", names);

List<int>のような数値リストも渡せます。

C#
List<int> scores = new List<int> { 80, 90, 100 };

string result = string.Join(", ", scores);

Console.WriteLine(result);

実行結果は次のとおりです。

80, 90, 100

LINQの結果も渡せます。

C#
var users = new List<string> { "alice", "bob", "charlie" };

string result = string.Join(", ", users.Select(x => x.ToUpper()));

Console.WriteLine(result);

実行結果は次のとおりです。

ALICE, BOB, CHARLIE

このように、string.JoinはIEnumerable<T>を扱えるため、配列・リスト・LINQの結果と相性がよいです。

2-4. 戻り値として返される文字列

string.Joinは、結合した結果を新しい文字列として返します。

元の配列やリストが変更されるわけではありません。

C#
string[] values = { "A", "B", "C" };

string result = string.Join(",", values);

Console.WriteLine(result);
Console.WriteLine(values[0]);

実行結果は次のとおりです。

A,B,C
A

string.Joinの戻り値はstring型です。

そのため、変数に代入したり、Console.WriteLineに直接渡したり、文字列補間の中で使ったりできます。

C#
var ids = new[] { 10, 20, 30 };

Console.WriteLine($"ID一覧: {string.Join(", ", ids)}");

実行結果は次のとおりです。

ID一覧: 10, 20, 30

2-5. よく使うオーバーロード一覧

string.Joinには複数のオーバーロードがあります。

よく使う形は次のとおりです。

C#
string.Join(string separator, string[] value)

文字列配列を結合する基本的な形です。

C#
string[] values = { "A", "B", "C" };

string result = string.Join(",", values);

次のように、List<string>などのIEnumerable<string>も結合できます。

C#
string.Join(string separator, IEnumerable<string> values)

使用例です。

C#
List<string> values = new List<string> { "A", "B", "C" };

string result = string.Join(",", values);

ジェネリックなIEnumerable<T>を結合する形もよく使います。

C#
string.Join<T>(string separator, IEnumerable<T> values)

たとえば、List<int>をそのまま結合できます。

C#
List<int> numbers = new List<int> { 1, 2, 3 };

string result = string.Join(",", numbers);

Console.WriteLine(result);

実行結果は次のとおりです。

1,2,3

配列の一部だけを結合するオーバーロードもあります。

C#
string.Join(string separator, string[] value, int startIndex, int count)

使用例です。

C#
string[] values = { "A", "B", "C", "D" };

string result = string.Join(",", values, 1, 2);

Console.WriteLine(result);

実行結果は次のとおりです。

B,C

startIndexは開始位置、countは結合する要素数です。

3. 配列をstring.Joinで結合する使い方

3-1. string配列をカンマ区切りで結合する

もっとも基本的な使い方は、string配列をカンマ区切りで結合する方法です。

C#
string[] languages = { "C#", "Java", "Python" };

string result = string.Join(", ", languages);

Console.WriteLine(result);

実行結果は次のとおりです。

C#, Java, Python

カンマの後にスペースを入れると、人が読みやすい文字列になります。

スペースなしにしたい場合は、区切り文字を,にします。

C#
string result = string.Join(",", languages);

Console.WriteLine(result);

実行結果は次のとおりです。

C#,Java,Python

CSV風の文字列やログ出力では,を使い、画面表示では, を使うなど、用途に応じて使い分けるとよいです。

3-2. スペース区切り・改行区切りで結合する

スペース区切りで結合したい場合は、区切り文字に" "を指定します。

C#
string[] words = { "Hello", "C#", "World" };

string result = string.Join(" ", words);

Console.WriteLine(result);

実行結果は次のとおりです。

Hello C# World

改行区切りで結合したい場合は、Environment.NewLineを使います。

C#
string[] lines =
{
    "1行目",
    "2行目",
    "3行目"
};

string result = string.Join(Environment.NewLine, lines);

Console.WriteLine(result);

実行結果は次のようになります。

1行目
2行目
3行目

\nを直接指定することもできます。

C#
string result = string.Join("\n", lines);

ただし、WindowsやLinuxなどの環境差を考慮するなら、通常はEnvironment.NewLineを使うほうが安全です。

3-3. 区切り文字なしで配列を結合する

区切り文字なしで結合したい場合は、第1引数に空文字""を指定します。

C#
string[] values = { "A", "B", "C" };

string result = string.Join("", values);

Console.WriteLine(result);

実行結果は次のとおりです。

ABC

このケースでは、string.Concatを使っても同じような結果になります。

C#
string result = string.Concat(values);

Console.WriteLine(result);

実行結果は次のとおりです。

ABC

区切り文字が必要ならstring.Join、単純に全部つなげるだけならstring.Concatも選択肢になります。

3-4. 配列の一部だけを結合する方法

配列の一部だけを結合したい場合は、startIndexとcountを指定できるオーバーロードを使います。

C#
string[] values = { "A", "B", "C", "D", "E" };

string result = string.Join(",", values, 1, 3);

Console.WriteLine(result);

実行結果は次のとおりです。

B,C,D

この例では、インデックス1のBから始めて、3個の要素を結合しています。

startIndexは0始まりです。

C#
string[] values = { "A", "B", "C", "D", "E" };
// index:           0    1    2    3    4

LINQを使って一部だけを取り出してから結合する方法もあります。

C#
string[] values = { "A", "B", "C", "D", "E" };

string result = string.Join(",", values.Skip(1).Take(3));

Console.WriteLine(result);

実行結果は次のとおりです。

B,C,D

配列専用の範囲指定ならstring.Join(",", values, 1, 3)、LINQで柔軟に絞り込みたいならSkipやTakeを使うとよいです。

3-5. 空の配列を渡した場合の結果

空の配列をstring.Joinに渡すと、結果は空文字になります。

C#
string[] values = Array.Empty<string>();

string result = string.Join(",", values);

Console.WriteLine($"結果: [{result}]");

実行結果は次のとおりです。

結果: []

エラーにはならず、空文字""が返ります。

そのため、要素が0件の可能性がある場合でも、結合対象がnullでなければ安全に使えます。

C#
var values = new List<string>();

string result = string.Join(", ", values);

Console.WriteLine(string.IsNullOrEmpty(result));

実行結果は次のとおりです。

True

ただし、配列そのものがnullの場合は例外になるため注意が必要です。

C#
string[]? values = null;

// ArgumentNullException
string result = string.Join(",", values);

空の配列とnullの配列は挙動が違います。

4. Listをstring.Joinで結合する使い方

4-1. List<string>をカンマ区切りで結合する

string.Joinは、List<string>にもそのまま使えます。

C#
List<string> names = new List<string>
{
    "Alice",
    "Bob",
    "Charlie"
};

string result = string.Join(", ", names);

Console.WriteLine(result);

実行結果は次のとおりです。

Alice, Bob, Charlie

配列と同じ感覚で使えるため、リストの中身を表示したいときに便利です。

C#
var tags = new List<string> { "C#", ".NET", "LINQ" };

Console.WriteLine($"タグ: {string.Join(", ", tags)}");

実行結果は次のとおりです。

タグ: C#, .NET, LINQ

4-2. List<int>など数値リストを結合する

List<int>など、文字列以外のリストも結合できます。

C#
List<int> ids = new List<int> { 101, 102, 103 };

string result = string.Join(", ", ids);

Console.WriteLine(result);

実行結果は次のとおりです。

101, 102, 103

intの各要素は、内部的に文字列に変換されて結合されます。

doubleでも同じように使えます。

C#
List<double> prices = new List<double> { 1200.5, 980.0, 450.75 };

string result = string.Join(", ", prices);

Console.WriteLine(result);

実行結果の例は次のとおりです。

1200.5, 980, 450.75

表示形式を細かく制御したい場合は、LINQのSelectで文字列に変換してから結合します。

C#
List<double> prices = new List<double> { 1200.5, 980.0, 450.75 };

string result = string.Join(", ", prices.Select(x => x.ToString("F2")));

Console.WriteLine(result);

実行結果は次のとおりです。

1200.50, 980.00, 450.75

4-3. List<object>や独自クラスを結合する場合

List<object>や独自クラスのリストもstring.Joinで結合できます。

ただし、その場合は各要素のToString()の結果が使われます。

C#
List<object> values = new List<object>
{
    123,
    "ABC",
    DateTime.Today
};

string result = string.Join(", ", values);

Console.WriteLine(result);

日付の表示は環境やカルチャによって変わる場合があります。

独自クラスの場合も確認してみましょう。

C#
class User
{
    public string Name { get; set; } = "";
}

このクラスのリストをそのまま結合すると、期待した表示にならないことがあります。

C#
var users = new List<User>
{
    new User { Name = "Alice" },
    new User { Name = "Bob" }
};

string result = string.Join(", ", users);

Console.WriteLine(result);

実行結果は、クラス名のような文字列になる場合があります。

User, User

期待どおりに名前を表示したい場合は、ToString()をオーバーライドするか、Selectでプロパティを取り出します。

C#
string result = string.Join(", ", users.Select(user => user.Name));

Console.WriteLine(result);

実行結果は次のとおりです。

Alice, Bob

実務では、独自クラスをそのままstring.Joinに渡すより、表示したいプロパティを明示的に指定するほうが安全です。

4-4. LINQと組み合わせて要素を加工してから結合する

string.JoinはLINQと組み合わせると非常に便利です。

たとえば、文字列を大文字に変換してから結合できます。

C#
var names = new List<string> { "alice", "bob", "charlie" };

string result = string.Join(", ", names.Select(x => x.ToUpper()));

Console.WriteLine(result);

実行結果は次のとおりです。

ALICE, BOB, CHARLIE

数値をフォーマットしてから結合することもできます。

C#
var amounts = new List<decimal> { 1000, 2500, 30000 };

string result = string.Join(", ", amounts.Select(x => $"{x:N0}円"));

Console.WriteLine(result);

実行結果は次のとおりです。

1,000円, 2,500円, 30,000円

ただし、この例では数値の中にもカンマが含まれるため、区切り文字としてのカンマと少し紛らわしくなる場合があります。

その場合は区切り文字を変えると見やすくなります。

C#
string result = string.Join(" / ", amounts.Select(x => $"{x:N0}円"));

Console.WriteLine(result);

実行結果は次のとおりです。

1,000円 / 2,500円 / 30,000円

4-5. Selectを使ってプロパティだけを結合する

実務でよくあるのが、オブジェクトのリストから特定のプロパティだけを結合するケースです。

たとえば、ユーザー一覧から名前だけを取り出して結合します。

C#
class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
}

C#
var users = new List<User>
{
    new User { Id = 1, Name = "田中" },
    new User { Id = 2, Name = "佐藤" },
    new User { Id = 3, Name = "鈴木" }
};

string result = string.Join("、", users.Select(user => user.Name));

Console.WriteLine(result);

実行結果は次のとおりです。

田中、佐藤、鈴木

IDだけを結合することもできます。

C#
string result = string.Join(",", users.Select(user => user.Id));

Console.WriteLine(result);

実行結果は次のとおりです。

1,2,3

Selectを使うことで、必要な値だけを取り出してからstring.Joinに渡せます。

5. 区切り文字の実例パターン

5-1. カンマ区切りの文字列を作る

カンマ区切りは、string.Joinのもっともよくある使い方です。

C#
string[] values = { "A", "B", "C" };

string result = string.Join(",", values);

Console.WriteLine(result);

実行結果は次のとおりです。

A,B,C

人が読むための表示なら、カンマの後にスペースを入れると見やすくなります。

C#
string result = string.Join(", ", values);

Console.WriteLine(result);

実行結果は次のとおりです。

A, B, C

ログに出す場合もよく使います。

C#
var targetIds = new[] { 1001, 1002, 1003 };

Console.WriteLine($"処理対象ID: {string.Join(", ", targetIds)}");

実行結果は次のとおりです。

処理対象ID: 1001, 1002, 1003

5-2. CSV風の文字列を作る

簡単なCSV風の文字列なら、string.Joinで作れます。

C#
string[] row = { "1", "田中", "tanaka@example.com" };

string csvLine = string.Join(",", row);

Console.WriteLine(csvLine);

実行結果は次のとおりです。

1,田中,tanaka@example.com

ただし、値の中にカンマ、ダブルクォート、改行が含まれる場合は、単純なstring.Joinだけでは正しいCSVになりません。

C#
string[] row = { "1", "田中,太郎", "Hello \"C#\"" };

string csvLine = string.Join(",", row);

Console.WriteLine(csvLine);

実行結果は次のようになります。

1,田中,太郎,Hello "C#"

この結果では、田中,太郎が2つの列のように見えてしまいます。

簡易的にCSVエスケープするなら、次のような処理が必要です。

C#
static string EscapeCsv(string value)
{
    if (value.Contains(",") || value.Contains("\"") || value.Contains("\r") || value.Contains("\n"))
    {
        return "\"" + value.Replace("\"", "\"\"") + "\"";
    }

    return value;
}

string[] row = { "1", "田中,太郎", "Hello \"C#\"" };

string csvLine = string.Join(",", row.Select(EscapeCsv));

Console.WriteLine(csvLine);

実行結果は次のとおりです。

1,"田中,太郎","Hello ""C#"""

本格的なCSV出力では、CSVライブラリを使うことも検討しましょう。

5-3. 改行区切りの文字列を作る

複数のメッセージを改行区切りで表示したい場合は、Environment.NewLineを使います。

C#
var messages = new List<string>
{
    "入力内容を確認してください。",
    "名前は必須です。",
    "メールアドレスは必須です。"
};

string result = string.Join(Environment.NewLine, messages);

Console.WriteLine(result);

実行結果は次のとおりです。

入力内容を確認してください。
名前は必須です。
メールアドレスは必須です。

WebアプリケーションでHTMLに表示する場合は、改行コードだけではブラウザ上で改行されない場合があります。

その場合は、<br>で結合することもあります。

C#
string html = string.Join("<br>", messages);

Console.WriteLine(html);

実行結果は次のとおりです。

入力内容を確認してください。<br>名前は必須です。<br>メールアドレスは必須です。

ただし、HTMLに出力する場合は、XSS対策として値のエスケープも考慮する必要があります。

5-4. パスやURL風の文字列を作る

スラッシュ区切りでパスやURL風の文字列を作ることもできます。

C#
string[] parts = { "api", "users", "123" };

string path = string.Join("/", parts);

Console.WriteLine(path);

実行結果は次のとおりです。

api/users/123

URLのパス部分を組み立てるような簡単な用途では便利です。

C#
string baseUrl = "https://example.com";
string[] paths = { "products", "100" };

string url = baseUrl + "/" + string.Join("/", paths);

Console.WriteLine(url);

実行結果は次のとおりです。

https://example.com/products/100

ただし、ファイルパスを作る場合は、string.JoinよりもPath.Combineを使うほうが適切です。

C#
string path = Path.Combine("C:\\work", "logs", "app.txt");

Console.WriteLine(path);

URLの場合も、値にスラッシュや特殊文字が含まれる場合は、適切なエンコードやURI処理が必要です。

5-5. SQLのIN句に使う文字列を作る際の注意点

string.Joinを使うと、SQLのIN句に使うような文字列を簡単に作れます。

C#
int[] ids = { 1, 2, 3 };

string inClause = string.Join(",", ids);

Console.WriteLine(inClause);

実行結果は次のとおりです。

1,2,3

これを使って、次のようにSQLを組み立てたくなるかもしれません。

C#
string sql = $"SELECT * FROM Users WHERE Id IN ({string.Join(",", ids)})";

数値IDだけで、値が完全に信頼できる場合はまだ扱いやすいですが、ユーザー入力を含む文字列を直接SQLに埋め込むのは危険です。

悪い例です。

C#
var names = new[] { "Alice", "Bob" };

string sql = $"SELECT * FROM Users WHERE Name IN ('{string.Join("','", names)}')";

このような書き方は、SQLインジェクションのリスクがあります。

実務では、パラメータ化クエリを使うべきです。

C#
// 考え方の例
// SELECT * FROM Users WHERE Id IN (@id0, @id1, @id2)

string.Joinは、プレースホルダー名を作る用途なら使いやすいです。

C#
int[] ids = { 1, 2, 3 };

var parameterNames = ids.Select((id, index) => $"@id{index}");

string inClause = string.Join(", ", parameterNames);

Console.WriteLine(inClause);

実行結果は次のとおりです。

@id0, @id1, @id2

SQL文そのものに値を直接埋め込むのではなく、パラメータ名の結合に使うのが安全です。

5-6. ログ出力用に配列やリストの中身を見やすく表示する

ログ出力では、配列やリストの中身を見やすく表示したいことがよくあります。

C#
var ids = new List<int> { 101, 205, 309 };

Console.WriteLine($"ids=[{string.Join(", ", ids)}]");

実行結果は次のとおりです。

ids=[101, 205, 309]

文字列のリストも同じです。

C#
var roles = new List<string> { "Admin", "Editor", "Viewer" };

Console.WriteLine($"roles=[{string.Join(", ", roles)}]");

実行結果は次のとおりです。

roles=[Admin, Editor, Viewer]

ログで値の境界を分かりやすくしたい場合は、各要素を引用符で囲むこともあります。

C#
var names = new List<string> { "Alice", "Bob", "Charlie" };

string result = string.Join(", ", names.Select(x => $"\"{x}\""));

Console.WriteLine($"names=[{result}]");

実行結果は次のとおりです。

names=["Alice", "Bob", "Charlie"]

6. null・空文字・空白を含む場合の挙動

6-1. 要素にnullが含まれる場合

string.Joinでは、要素にnullが含まれている場合、その要素は空文字として扱われます。

C#
string?[] values = { "A", null, "C" };

string result = string.Join(",", values);

Console.WriteLine(result);

実行結果は次のとおりです。

A,,C

nullの位置には文字が入りませんが、区切り文字は入ります。

カンマ区切りの場合、A,,Cのように連続したカンマになります。

画面表示やログ出力でこれが分かりにくい場合は、nullを除外するか、別の文字に置き換えるとよいです。

C#
string?[] values = { "A", null, "C" };

string result = string.Join(",", values.Select(x => x ?? "(null)"));

Console.WriteLine(result);

実行結果は次のとおりです。

A,(null),C

6-2. 要素に空文字が含まれる場合

要素に空文字""が含まれる場合も、その位置には文字が入りません。

C#
string[] values = { "A", "", "C" };

string result = string.Join(",", values);

Console.WriteLine(result);

実行結果は次のとおりです。

A,,C

nullと同じように見えますが、意味は異なります。

空文字を除外したい場合は、Whereとstring.IsNullOrEmptyを使います。

C#
string[] values = { "A", "", "C" };

string result = string.Join(",", values.Where(x => !string.IsNullOrEmpty(x)));

Console.WriteLine(result);

実行結果は次のとおりです。

A,C

6-3. 区切り文字にnullを指定した場合

区切り文字にnullを指定した場合、区切り文字は空文字として扱われます。

C#
string[] values = { "A", "B", "C" };

string result = string.Join(null, values);

Console.WriteLine(result);

実行結果は次のとおりです。

ABC

つまり、次のコードと同じような結果になります。

C#
string result = string.Join("", values);

ただし、読みやすさの観点では、区切り文字なしで結合したいなら明示的に""を指定するほうが分かりやすいです。

C#
string result = string.Join("", values);

nullを区切り文字として使う意図は伝わりにくいため、通常は避けたほうがよいでしょう。

6-4. 結合対象そのものがnullの場合

結合対象そのものがnullの場合、ArgumentNullExceptionが発生します。

C#
string[]? values = null;

string result = string.Join(",", values);

このコードは例外になります。

空の配列であればエラーにはなりません。

C#
string[] values = Array.Empty<string>();

string result = string.Join(",", values);

Console.WriteLine(result == "");

実行結果は次のとおりです。

True

つまり、次の2つは違います。

C#
string[]? nullArray = null;
string[] emptyArray = Array.Empty<string>();

nullArrayを渡すと例外、emptyArrayを渡すと空文字が返ります。

結合対象がnullの可能性がある場合は、Array.Empty<string>()や空のリストに置き換えてから使うと安全です。

C#
string[]? values = null;

string result = string.Join(",", values ?? Array.Empty<string>());

Console.WriteLine(result);

6-5. nullや空文字を除外して結合する方法

nullや空文字を除外して結合したい場合は、LINQのWhereを使います。

C#
string?[] values = { "A", null, "", "B", "C" };

string result = string.Join(",", values.Where(x => !string.IsNullOrEmpty(x)));

Console.WriteLine(result);

実行結果は次のとおりです。

A,B,C

空白だけの文字列も除外したい場合は、string.IsNullOrWhiteSpaceを使います。

C#
string?[] values = { "A", null, "", " ", "B", "\t", "C" };

string result = string.Join(",", values.Where(x => !string.IsNullOrWhiteSpace(x)));

Console.WriteLine(result);

実行結果は次のとおりです。

A,B,C

IsNullOrEmptyはnullと空文字を除外します。

IsNullOrWhiteSpaceは、null、空文字、スペース、タブなどの空白文字だけの文字列も除外します。

6-6. Where・IsNullOrEmpty・IsNullOrWhiteSpaceを使った実例

実務では、ユーザー入力や任意項目を結合するときに、空の値を除外したいことがあります。

たとえば、住所の各項目を結合する例です。

C#
string? prefecture = "東京都";
string? city = "渋谷区";
string? address1 = "";
string? address2 = "神南1-1-1";

var parts = new[] { prefecture, city, address1, address2 };

string address = string.Join(" ", parts.Where(x => !string.IsNullOrWhiteSpace(x)));

Console.WriteLine(address);

実行結果は次のとおりです。

東京都 渋谷区 神南1-1-1

空文字のaddress1は除外されています。

検索条件の表示にも使えます。

C#
string? keyword = "C#";
string? category = "";
string? status = "公開中";

var conditions = new[]
{
    string.IsNullOrWhiteSpace(keyword) ? null : $"キーワード: {keyword}",
    string.IsNullOrWhiteSpace(category) ? null : $"カテゴリ: {category}",
    string.IsNullOrWhiteSpace(status) ? null : $"ステータス: {status}"
};

string result = string.Join(" / ", conditions.Where(x => !string.IsNullOrWhiteSpace(x)));

Console.WriteLine(result);

実行結果は次のとおりです。

キーワード: C# / ステータス: 公開中

このように、Whereと組み合わせることで、余計な区切り文字のないきれいな文字列を作れます。

7. string.Joinでよくあるエラーと解決方法

7-1. ArgumentNullExceptionが発生する原因

string.JoinでArgumentNullExceptionが発生する代表的な原因は、結合対象そのものがnullであることです。

C#
List<string>? names = null;

string result = string.Join(", ", names);

このコードは例外になります。

解決するには、nullの場合に空のコレクションを使います。

C#
List<string>? names = null;

string result = string.Join(", ", names ?? Enumerable.Empty<string>());

Console.WriteLine(result);

結果は空文字です。

配列の場合は、次のように書けます。

C#
string[]? values = null;

string result = string.Join(", ", values ?? Array.Empty<string>());

メソッド化しておくと便利です。

C#
static string JoinSafe(IEnumerable<string>? values)
{
    return string.Join(", ", values ?? Enumerable.Empty<string>());
}

使用例です。

C#
List<string>? names = null;

Console.WriteLine(JoinSafe(names));

7-2. 余計なカンマや区切り文字が入る原因

string.Join自体は、最後に余計な区切り文字を付けません。

それでも余計なカンマが入る場合、要素の中にnullや空文字が含まれている可能性があります。

C#
string?[] values = { "A", "", "C" };

string result = string.Join(",", values);

Console.WriteLine(result);

実行結果は次のとおりです。

A,,C

これは、空文字の要素があるためです。

空文字を除外すれば、余計なカンマのように見える部分をなくせます。

C#
string?[] values = { "A", "", "C" };

string result = string.Join(",", values.Where(x => !string.IsNullOrEmpty(x)));

Console.WriteLine(result);

実行結果は次のとおりです。

A,C

空白だけの値も除外したい場合は、次のようにします。

C#
string?[] values = { "A", " ", "C" };

string result = string.Join(",", values.Where(x => !string.IsNullOrWhiteSpace(x)));

Console.WriteLine(result);