CS0～400

CS0117エラーについて解説: C#のメンバー参照エラーの原因と対策

2025-03-29更新日: 2025-03-29

CS0117は、C#プログラムで型に含まれていないメンバーを参照した際に発生するコンパイラエラーです。

たとえば、継承元のクラスに存在しないプロパティやメソッドへアクセスするとこのエラーが表示されます。

エラーメッセージに沿って、正しいメンバー名を使用しているか確認してください。

目次から探す

CS0117エラーの原因
- メンバー参照の基本ミス
- 継承に関する誤解
エラー発生の技術的背景
- C#の型システム
- エラー検知の流れ
修正方法と対策
- 正しいメンバー参照の記述
- エラー修正の手順
まとめ

CS0117エラーの原因

CS0117エラーは、存在しないメンバーへアクセスを試みた際に発生するエラーです。

エラーの原因としては、メンバー参照の基本ミスや継承に関する誤解が挙げられます。

それぞれの詳細について説明します。

メンバー参照の基本ミス

このセクションでは、定義されていないメンバーにアクセスした場合に発生するエラーについて解説します。

型に定義されていないメンバーへのアクセス

型に存在しないメンバーにアクセスしようとすると、コンパイラはその型にそのメンバーが存在しないと判断し、CS0117エラーを発生させます。

例えば、以下のコードでは、MyClassに定義されていないnonExistingMemberにアクセスしているためエラーとなります。

using System;
public class MyClass
{
    public int existingMember = 10;
}
public class Program
{
    public static void Main(string[] args)
    {
        MyClass instance = new MyClass();
        // 存在しないメンバーにアクセスしようとするためエラー
        int value = instance.nonExistingMember;
        Console.WriteLine(value);
    }
}

// コンパイルエラー: 'MyClass' に 'nonExistingMember' の定義がありません

エラーメッセージの意味と背景

CS0117エラーのメッセージは「’型’ に ‘識別子’ の定義がありません」と表示されます。

これは、指定された型があらかじめ定義したメンバー以外の名称でアクセスを試みた場合に発生するエラーです。

たとえば、前述の例ではMyClassにnonExistingMemberというプロパティやフィールドは存在しないため、このエラーが出力されます。

継承に関する誤解

継承関係にあるクラス間でのメンバーアクセスに関しても、CS0117エラーの原因となる誤解が存在します。

基底クラスと派生クラスの関係の誤認識

派生クラスで基底クラスのメンバーを利用する際、実際には基底クラスにそのメンバーが定義されている必要があります。

以下のコード例では、基底クラスBaseに定義されていないsomeMemberにアクセスしているため、派生クラスDerivedでエラーが発生します。

using System;
public class Base
{
    // 'someMember' は定義されていない
}
public class Derived : Base
{
    public void TestInt()
    {
        // 基底クラスに 'someMember' が存在しないためエラーになる
        int i = base.someMember;
        Console.WriteLine(i);
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        Derived derivedInstance = new Derived();
        derivedInstance.TestInt();
    }
}

// コンパイルエラー: 'Base' に 'someMember' の定義がありません

この例のように、正しい基底クラスのメンバーを利用できるように継承関係を見直す必要があります。

静的メンバーとインスタンスメンバーの混同

CS0117エラーは、静的メンバーとインスタンスメンバーを混同してアクセスした場合にも発生します。

たとえば、静的なメンバーはクラス名経由でアクセスする必要がありますが、インスタンス経由でアクセスしようとするとコンパイラが正しい解決を行えず、エラーにつながる場合があります。

以下の例では、静的メンバーを正しくアクセスしていないケースを示しています。

using System;
public class Example
{
    // 静的メンバーとして定義
    public static int StaticValue = 20;
    // インスタンスメンバーとして定義
    public int InstanceValue = 30;
}
public class Program
{
    public static void Main(string[] args)
    {
        Example instance = new Example();
        // 静的メンバーはクラス名でアクセスするのが正しい
        // int value = instance.StaticValue; // 混同するとエラーの可能性がある
        int value = Example.StaticValue;
        Console.WriteLine($"StaticValue: {value}");
    }
}

StaticValue: 20

正しく区別してアクセスすることで、CS0117エラーを回避できます。

エラー発生の技術的背景

次に、CS0117エラーが発生する背景について技術的な側面から解説します。

C#の型システム

C#の型システムは、各型が持つメンバーを厳密に定義しています。

コンパイラは各型のメンバー情報をもとに、コード中の識別子を解決しています。

型とメンバーの関係性

型はクラスや構造体として定義され、各型にはフィールド、プロパティ、メソッドなどのメンバーが含まれます。

たとえば、クラスMyClassが以下のように定義されている場合、

public class MyClass
{
    public int Data;
    public void Display() { Console.WriteLine(Data); }
}

MyClassはDataとDisplayというメンバーを持っているため、これらにアクセスすることができます。

型に存在しないメンバーを参照しようとすると、コンパイラはその型の定義と一致しないためエラーを出力します。

コンパイラによるメンバー解決の仕組み

コンパイラは、コード中の識別子を解決するために、定義済みの型情報を参照します。

メンバー解決は以下の数式のような流れで行われます。

$MemberLookup (T, identifier) = {\begin{cases} Defined & if identifier \in T \\ NotDefined & otherwise \end{cases}$

ここで、 $T$ は対象の型を表します。

この仕組みのもと、存在しない識別子に対するアクセスが検出された場合、CS0117エラーが発生します。

エラー検知の流れ

コンパイル時に、コンパイラは各メンバーへのアクセスをチェックし、正しい型定義がなされているかを確認します。

コンパイル時のチェックポイント

コンパイル時、以下のチェックが行われます。

・各クラスのメンバーリストの確認

・ベースクラスとの整合性の確認

・静的とインスタンスメンバーのアクセス方法の検証

これらのチェックにより、定義していないメンバーへのアクセスは直ちに検出され、CS0117エラーとして報告されます。

発生タイミングの具体例

例えば、以下のコードはコンパイル時にエラーが発生する具体例です。

using System;
public class AnotherClass
{
    public void Show() { Console.WriteLine("表示処理"); }
}
public class Program
{
    public static void Main(string[] args)
    {
        AnotherClass instance = new AnotherClass();
        // 'Hide' は AnotherClass に存在しないためエラーになる
        instance.Hide();
    }
}

// コンパイルエラー: 'AnotherClass' に 'Hide' の定義がありません

この例では、Showメソッドは定義されているにもかかわらず、存在しないHideメソッドを呼び出しているためエラーが発生します。

修正方法と対策

CS0117エラーを修正するためには、参照するメンバーが正しく定義されているかどうかを確認し、アクセス方法を見直す必要があります。

正しいメンバー参照の記述

正しいメンバー参照を行うためには、対象の型がどのメンバーを持っているかを十分に把握することが重要です。

これにより、意図しないエラーを防ぐことができます。

メンバー定義の確認方法

メンバー定義は、以下の方法で確認できます。

・Visual StudioのIntelliSenseによる候補表示

・公式ドキュメントやAPIリファレンスの参照

・クラス定義のコードを見る

これらの方法を組み合わせることで、正しいメンバーにアクセスできるようになります。

参照先の正しい指定方法

型が持つ正しいメンバーへアクセスするためには、以下の点に注意してください。

・静的メンバーはクラス名を使って直接アクセスする

・インスタンスメンバーはインスタンス経由でアクセスする

・継承関係の場合、基底クラスに定義されているか確認する

正しい指定方法を守ると、エラー発生を防ぎ、コードの可読性も向上します。

エラー修正の手順

CS0117エラーが発生した場合、次の手順でコードを修正してください。

コード例による検証手法

まずは、サンプルコードを使ってエラー箇所を特定し、正しいメンバー参照の方法に修正する手法を紹介します。

using System;
// サンプルクラス: 正しく定義されるメンバーを持つ
public class SampleClass
{
    public int ValidMember = 100; // 正しいメンバー定義
}
public class Program
{
    public static void Main(string[] args)
    {
        SampleClass sample = new SampleClass();
        // 修正前: 存在しない 'InvalidMember' にアクセスしていた
        // int result = sample.InvalidMember; // CS0117エラー
        // 修正後: 正しく定義されている 'ValidMember' にアクセス
        int result = sample.ValidMember;
        Console.WriteLine($"ValidMember: {result}");
    }
}

ValidMember: 100

このコード例により、正しいメンバー参照がどのように行われるかを理解できます。

修正後の確認プロセス

コード修正後は、以下の手順で確認を行います。

・コードを再コンパイルしエラーが解消されているかチェック

・実行して期待通りの結果が出力されているか確認

・IDEのサジェスト機能で正しいメンバーが提示されているか検証

これらのプロセスを経ることで、CS0117エラーが発生していた箇所が修正されたことを確実に確認できます。

まとめ

この記事では、CS0117エラーの原因として、存在しないメンバーへのアクセスや継承関係の誤解、静的とインスタンスメンバーの混同を詳しく解説しました。

C#の型システムにおけるメンバーの関連性やコンパイラの解決プロセスを理解し、正しいメンバー参照と修正手順を具体例を通して確認できます。

これにより、発生しやすいエラーを回避し、適切なコード記述が実現できるようになります。