WPF ComboBox の ItemsSource バインドパターンと選択値の取得方法

概要

WPF の ComboBox は ItemsSource に渡すデータ構造に応じて、表示内容の制御方法と選択値の取得方法が変わる。具体的には DisplayMemberPath、ItemTemplate、SelectedItem、SelectedValue、SelectedValuePath の組み合わせが、バインドするコレクションの型によって異なる。
本記事では代表的な実装パターンを整理し、それぞれの選択に関するプロパティの使い分けを示す。
—

前提・対象環境

• フレームワーク／言語: .NET 8 / C# 12
• 対象コントロール: WPF ComboBox
• アーキテクチャ: MVVM（DataContext 経由のバインド）
• 前提知識: WPF バインド基礎、INotifyPropertyChanged
• 検証環境: .NET 10 / Windows 11

本記事の表は、上記の環境で実際に計測したものである。
計測の条件は、それぞれの表の説明に書いた。
この環境で確認しているのは次の点である。

• SelectedValuePath の有無で、SelectedValue の中身が変わる。
• DisplayMemberPath の有無で、表示される文字列が変わる。
• 後述の「注意点」で扱う、失敗すると言われがちな設定の結果。DisplayMemberPath と ItemTemplate の同時設定、SelectedValue と SelectedValuePath のプロパティの型の違い、ItemsSource より先に SelectedValue を設定した場合である。

問題

ComboBox の ItemsSource に渡すコレクションの要素型が変わると、選択値の取得方法も変わるたとえば文字列リストを渡す場合と、ID と名称を持つオブジェクトのリストを渡す場合では、ViewModel にバインドするプロパティの型と設定が異なる。
この違いを把握していないと、選択しても値が反映されない、または初期値が表示されないといった問題が発生する。
—

原因・背景

ComboBox の選択関連プロパティは以下の 3 種類がある。

文字列リストの場合、要素そのものが文字列であるため SelectedItem は string を返す。オブジェクトのリストを使い SelectedValuePath を指定すると、SelectedValue には指定プロパティの値が返る。
どのプロパティをバインドするかはデータ構造に依存するため、構造ごとに設定を合わせる必要がある。
—

同じ選択に対して 3 つのプロパティが何を返すかは、実際に選択して読み出せば確かめられる。

.NET 10 / Windows 11 で、Id と Name を持つ 3 件のうち 2 件目を選択して測った結果。「表示」の列は、閉じた状態の ComboBox に表示されている文字列である。

SelectedValuePath を設定しないとき、SelectedValue は項目そのものを返す。 上の表では「SelectedValuePath で指定したプロパティ値」と説明したが、未設定時は SelectedItem と同じものが返る点に注意する。
SelectedValuePath=Id にすると Int32 の 20 になり、型まで変わる。ID だけを ViewModel に渡したい場合はこの設定が要る。

DisplayMemberPath は表示だけに効き、SelectedValue の中身には影響しない。この 2 つは独立している。

5 つの実装パターン

ItemsSource の要素型と、ViewModel に何を持たせたいかの組み合わせで、代表的な 5 パターンを順に見る。
要素型が同じでも、選択値の受け取り方や表示の作り方で構成が変わる。
表示が変わるものもあれば、表示は同じで SelectedValue に入る値だけが変わるもの（パターン B と C）もある。

パターン A：文字列リスト

ItemsSource が ObservableCollection<string> のとき、DisplayMemberPath は不要であり、SelectedItem に string 型のプロパティをバインドするだけで機能する。

<ComboBox ItemsSource="{Binding Regions}"
          SelectedItem="{Binding SelectedRegion}" />

対応する ViewModel 側の実装は次のとおりである。

public ObservableCollection<string> Regions { get; } = new()
{
    "東北", "関東", "中部", "近畿", "九州"
};

private string? _selectedRegion;
public string? SelectedRegion
{
    get => _selectedRegion;
    set { _selectedRegion = value; OnPropertyChanged(); }
}

SelectedItem に string 以外の型（例: int）をバインドすると型の不一致でバインドエラーとなる。

パターン B：オブジェクトリスト ＋ DisplayMemberPath ＋ SelectedItem

ItemsSource が ObservableCollection<T> で、表示する文字列と選択して取得するオブジェクトが同じ型の場合、DisplayMemberPath で表示プロパティを指定し、SelectedItem にオブジェクト全体をバインドする。

<ComboBox ItemsSource="{Binding Departments}"
          DisplayMemberPath="Name"
          SelectedItem="{Binding SelectedDepartment}" />

上記の XAML では Department オブジェクトの Name を表示しつつ、選択結果として Department オブジェクト全体を SelectedDepartment にバインドしている。
対応するモデルと ViewModel の定義例は次のとおり。

public class Department
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
}

public ObservableCollection<Department> Departments { get; } = new()
{
    new Department { Id = 1, Name = "営業部" },
    new Department { Id = 2, Name = "開発部" },
    new Department { Id = 3, Name = "総務部" },
};

private Department? _selectedDepartment;
public Department? SelectedDepartment
{
    get => _selectedDepartment;
    set { _selectedDepartment = value; OnPropertyChanged(); }
}

選択後は SelectedDepartment.Id や SelectedDepartment.Name で任意のフィールドにアクセスできるViewModel にオブジェクト全体を保持するため、後から複数フィールドを参照しやすい。

パターン C：オブジェクトリスト ＋ DisplayMemberPath ＋ SelectedValuePath

表示は Name で行い、選択値として Id（数値や文字列のキー）だけを取得したい場合に使う。
SelectedValuePath に取得したいプロパティ名を指定し、SelectedValue にそのプロパティの型でバインドする。

<ComboBox ItemsSource="{Binding Departments}"
          DisplayMemberPath="Name"
          SelectedValuePath="Id"
          SelectedValue="{Binding SelectedDepartmentId}" />

対応する ViewModel 側では、選択された Id を保持するプロパティを次のように定義する。

private int _selectedDepartmentId;
public int SelectedDepartmentId
{
    get => _selectedDepartmentId;
    set { _selectedDepartmentId = value; OnPropertyChanged(); }
}

SelectedValue の型と SelectedValuePath で指定するプロパティの型が違っても、計測では選択は反映された。Id が int で、ソースが文字列型のプロパティ（値は "20"）でも Id 20 の項目が選択され、別の項目を選ぶと文字列の "30" が書き戻された（後述の「注意点」の表）。ただし、宣言型が object のプロパティに "20" を入れた場合は、Int32 の 30 が書き戻され、値の型が変わった。ViewModel のプロパティはパスと同じ型にしておくほうが分かりやすい。
また SelectedItem と SelectedValue は同時に利用できるが、一方を変更するともう一方も自動で更新される。
—

パターン D：ItemTemplate を使ったカスタム表示

1 行の表示に複数フィールドを含めたい場合や、アイコン付きの選択肢を実装したい場合は ItemTemplate を使う。
DisplayMemberPath と ItemTemplate は同時に設定できない。両方を設定すると、コードでは InvalidOperationException、XAML では XamlParseException になった。
カスタム表示が必要なときは ItemTemplate だけを使い、DisplayMemberPath は外す。

<ComboBox ItemsSource="{Binding Employees}"
          SelectedItem="{Binding SelectedEmployee}">
    <ComboBox.ItemTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
                <TextBlock Text="{Binding Id}" Width="40" Foreground="Gray"/>
                <TextBlock Text="{Binding Name}" />
            </StackPanel>
        </DataTemplate>
    </ComboBox.ItemTemplate>
</ComboBox>

この XAML で参照する Employee モデルの定義例は次のとおりである。

public class Employee
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
}

ItemTemplate を使う場合、ドロップダウンを閉じた状態（選択済み表示）と展開した一覧で異なるレイアウトを出したいときは、ItemTemplate の代わりに ItemContainerStyle と ContentTemplate を組み合わせる。

パターン E：Enum リスト

選択肢が固定の列挙体の場合、ObjectDataProvider を使って XAML から Enum 値を列挙する方法と、ViewModel でコレクションを用意する方法がある。
保守性を考えると ViewModel でコレクションを生成する方法が安全である。
ViewModel 側で Enum.GetValues を使って選択肢を生成する。

public enum Priority { 低, 中, 高 }

public IEnumerable<Priority> Priorities { get; }
    = (Priority[])Enum.GetValues(typeof(Priority));

private Priority _selectedPriority = Priority.中;
public Priority SelectedPriority
{
    get => _selectedPriority;
    set { _selectedPriority = value; OnPropertyChanged(); }
}

この ViewModel に対して、XAML 側では ItemsSource と SelectedItem を次のようにバインドする。

<ComboBox ItemsSource="{Binding Priorities}"
          SelectedItem="{Binding SelectedPriority}" />

SelectedItem の型は Priority（Enum 型）になる。列挙型の値には数値を返すプロパティが無いため、SelectedValuePath では数値を取り出せない。SelectedValuePath="value__" としても SelectedValue は null だった。数値が必要なら (int)SelectedPriority のようにキャストする。

選択の分岐点

どのパターンを使うかは、ItemsSource の要素型と、ViewModel に何を持たせたいかで決まる。

• 要素が string や enum のような単純値なら、要素そのものを受け取る SelectedItem を使う（パターン A・E）。
• 要素がオブジェクトで、選択されたオブジェクト全体を扱いたいなら SelectedItem を使う（パターン B）。
• 要素がオブジェクトで、ID など特定の値だけを ViewModel に持たせたいなら SelectedValue と SelectedValuePath を使う（パターン C）。
• 表示用の名称と保持したい値を分けたい場合は、DisplayMemberPath と SelectedValuePath を組み合わせる。
• 1 行に複数フィールドを並べたい場合は ItemTemplate を使う（パターン D）。
• SelectedIndex は表示順そのものに意味がある場合に限って使い、通常は値やオブジェクトを直接扱う設定を優先する。

ViewModel 側のプロパティ型と ComboBox の設定が対応していれば、初期選択や選択変更の反映漏れは起きにくい。

パターン別の比較

注意点

.NET 10 / Windows 11 で、Id が 10・20・30 の 3 件を使って測った結果。

• DisplayMemberPath と ItemTemplate は併用できない
  両方を設定すると InvalidOperationException になる（XAML では XamlParseException に包まれる）。カスタム表示が必要な場合は ItemTemplate を使い、DisplayMemberPath は外す。
• SelectedValue の初期値を正しく設定する
  SelectedValuePath を使う場合、ViewModel 側の初期値が ItemsSource 内に存在しない値だと選択状態が空になる。
  設定の順序は原因にならない。SelectedValue を ItemsSource より先に設定しても、コードで設定した場合も、バインドしてウィンドウを表示した後で ItemsSource を入れた場合も、項目が入った時点で該当する項目が選択された。
• SelectedItem の一致判定は Equals を考慮する
  SelectedItem は「常に参照比較」とは限らず、Equals による一致判定が関わる。
  既定の実装では別インスタンス同士は一致しないことが多いため、同じ内容のオブジェクトを初期値として設定しても選択されない場合がある。
  値同値で一致させたい場合は、対象型で Equals と GetHashCode をオーバーライドし、必要に応じて IEquatable<T> も実装する。
  識別子やコード値のような特定プロパティで選択を管理したい場合は、SelectedValuePath と SelectedValue を使う。
• null の扱い
  選択肢として「未選択」を表す null を含める場合、ComboBox は空欄として表示する。
  ViewModel 側で null を許容する型（例: string?, int?）を使う。

まとめ

ComboBox の実装パターンは ItemsSource に渡す型によって決まる。
単純値なら SelectedItem、オブジェクトなら全体が要るか特定フィールドだけで足りるかで SelectedItem と SelectedValue を選び分ける。

初期値が反映されない問題の多くは、SelectedItem に渡した値が ItemsSource のどの項目とも Equals で一致しないことか、ItemsSource に無い値を初期値にしていることに起因する。
前者は、SelectedValuePath で ID などの値を比べるか、ItemsSource の項目と同じインスタンスを渡すよう設計することで回避できる。後者は、SelectedValuePath を使っても一致する項目が無いため選択されない。初期値は ItemsSource にある値から選ぶ。

• WPF で RadioButton を enum にバインドすると初期選択が表示されない問題と GroupName の役割
• ComboBox（WPF 標準コントロールデモアプリ）：同じ項目で Text・SelectedValue・SelectedItem が何を表すかを実測したページ