CS801～2000

C# コンパイラエラー CS1546 を解説：プロパティとインデクサーの正しい呼び出し方法

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

CS1546はC#で発生するコンパイラエラーで、インデクサーやプロパティの使用方法が正しくない場合に表示されます。

特に、C++で定義されたインデックス付きプロパティをC#で呼び出す際、インデックス構文ではなく、直接アクセサーメソッドを呼び出す必要があります。

解決には、例えばget_Propのように明示的にメソッドを指定して利用します。

目次から探す

エラー発生の背景
エラーメッセージの詳細解析
- エラーメッセージの構造
- コード例に見るエラーの具体例
C# におけるプロパティとインデクサーの扱い
- プロパティの基本的な使用方法
- インデクサーの仕様と違い
正しい呼び出し方法の解説
- アクセサーメソッドの呼び出し手順
- 修正コード例と変更ポイント
開発環境での実装時の注意点
- エラー発生時の確認項目
- 利用環境別の留意点
まとめ

エラー発生の背景

CS1546 の概要

CS1546 エラーは、プロパティ、インデクサー、またはイベントがサポートされていない方法で呼び出されたときに発生します。

具体的には、C++/CLI で定義されたインデックス付きプロパティに対して、C# 側でインデックス構文を用いるとこのエラーが表示されます。

エラーメッセージは「アクセサーメソッドを直接呼び出してください」と示しており、プロパティの get_メソッドや set_メソッドを直接呼ぶことが求められます。

エラー発生原因と状況

このエラーは、C++/CLI で定義されたプロパティやインデクサーを C# から利用する際に、通常のインデックス構文が使えない場合に起こります。

たとえば、.dll にコンパイルされた C++/CLI のコードが持つインデックス付きプロパティを、C# 側で単に mcpp.Prop(1,1) と呼び出すとエラー CS1546 が発生します。

C# 側ではアクセサーメソッド(例：get_Prop)を直接呼び出す必要があります。

C++/CLI におけるインデックス付きプロパティの特徴

C++/CLI では、インデックス付きプロパティを定義する際に、複数のパラメーターを取るプロパティの実装が可能です。

しかし、C# ではインデクサーとして扱う際に、通常のインデックス構文が使用できず、アクセサーメソッドの直接呼び出しを求められます。

これは、C++/CLI の機能と C# の言語設計の違いに起因しており、使用環境に応じた適切な呼び出し方法を理解することが大切です。

エラーメッセージの詳細解析

エラーメッセージの構造

エラーメッセージは次のような構造になっています。

「プロパティ、インデクサーまたはイベント ‘property’ はこの言語でサポートされていません。

アクセサーメソッドの ‘accessor’ を直接呼び出してください。」

このメッセージは、利用しようとしているプロパティやインデクサーが C# の標準的な呼び出し方法に合致しないことを示しています。

つまり、通常の呼び出し構文ではなく、特定のアクセサーメソッドを呼び出す必要があるという指摘です。

コード例に見るエラーの具体例

次のサンプルコードは、C++/CLI の .dll を C# 側から使用した場合にエラーが発生する例です。

// CS1546_ErrorSample.cs
using System;
public class Test
{
    public static void Main()
    {
        int result = 0;
        // C++/CLI で定義されたクラス MCPP のインスタンスを生成
        MCPP mcpp = new MCPP();
        // 以下の呼び出しはエラー CS1546 を発生させる
        result = mcpp.Prop(1, 1);
        System.Console.WriteLine(result);
    }
}

// コンパイル時にエラー CS1546 が発生

この例では、mcpp.Prop(1,1) と記述することでエラーが起こるため、アクセサーメソッドである get_Prop を直接呼ぶ必要があります。

C# におけるプロパティとインデクサーの扱い

プロパティの基本的な使用方法

C# では、プロパティはカプセル化のために getter および setter を提供するメソッドとして定義されます。

通常は、以下のような構文を使用してアクセスします。

// PropertySample.cs
using System;
public class PropertySample
{
    // プロパティの定義
    public int Value { get; set; }
    public static void Main()
    {
        PropertySample sample = new PropertySample();
        sample.Value = 10; // セッター呼び出し
        Console.WriteLine(sample.Value); // ゲッター呼び出し
    }
}

このように、プロパティは通常のフィールドアクセスのようにシンプルな構文で利用できます。

インデクサーの仕様と違い

C# では、インデクサーを使用することで、配列のような構文を自作クラスに適用することが可能です。

インデクサーは this[] 構文で定義され、クラス内で特別なメソッドとして扱われています。

以下はインデクサーの基本的な例です。

// IndexerSample.cs
using System;
public class IndexerSample
{
    private int[] numbers = new int[10];
    // インデクサーの定義
    public int this[int index]
    {
        get { return numbers[index]; }
        set { numbers[index] = value; }
    }
    public static void Main()
    {
        IndexerSample sample = new IndexerSample();
        sample[0] = 5; // インデクサーのセッター呼び出し
        Console.WriteLine(sample[0]); // インデクサーのゲッター呼び出し
    }
}

インデクサーはクラスの利用者に対して分かりやすい構文を提供しますが、C++/CLI で定義されたインデックス付きプロパティは C# の通常のインデクサーとして扱えない点に注意が必要です。

正しい呼び出し方法の解説

アクセサーメソッドの呼び出し手順

C++/CLI のインデックス付きプロパティにアクセスする際は、直接アクセサーメソッドを呼び出す必要があります。

たとえば、プロパティ名が Prop であれば、ゲッターは get_Prop として実装されています。

そのため、C# 側で呼び出すときは mcpp.get_Prop(引数…) の形式でアクセスします。

修正コード例と変更ポイント

以下は、エラーが発生するコードを正しい呼び出し方法に変更したサンプルです。

// CS1546_FixSample.cs
using System;
public class Test
{
    public static void Main()
    {
        int result = 0;
        // C++/CLI のクラス MCPP のインスタンスを生成
        MCPP mcpp = new MCPP();
        // 正しいアクセサーメソッド get_Prop を呼び出す
        result = mcpp.get_Prop(1, 1);
        Console.WriteLine(result);
    }
}

コード修正の具体的ポイント

修正の際は、以下の点を確認してください。

インデックス付きプロパティの呼び出しに対して、通常のインデックス構文(例：mcpp.Prop(1,1))ではなく、アクセサーメソッド(例：mcpp.get_Prop(1,1))を使用する。
アクセサーメソッドの名前は、プロパティ名の前に get_ または set_ が付く形式であるため、対象のメソッド名を正確に把握する。

開発環境での実装時の注意点

エラー発生時の確認項目

実装中に同様のエラーが発生した場合は、以下の点を確認してください。

対象のプロパティまたはインデクサーがどのように宣言されているか。
利用しているライブラリや DLL のバージョンが最新であるか。
C++/CLI 側のクラスの仕様書やドキュメントを再確認し、アクセサーメソッドの名前や使い方が正しいかチェックする。

利用環境別の留意点

各利用環境において、注意すべき点は次の通りです。

.NET フレームワークのバージョンや C# コンパイラの仕様により、アクセス方法に違いが出る可能性がある。
複数の言語間でライブラリを共有する場合、相互運用性に配慮して、アクセサーメソッドの利用方法を統一する。
開発環境でのビルド設定やコンパイラのオプションが、エラーに影響を与える場合があるため、設定を見直すとともにエラーメッセージを正確に把握することが大切です。

まとめ

本記事では、C++/CLI で定義されたインデックス付きプロパティを C# で利用する際に発生するエラー CS1546 の原因と対応方法について解説しました。

エラー発生時はインデックス構文ではなく、アクセサーメソッドを直接呼ぶ必要がある点、また C# 側のプロパティやインデクサーの違いを確認することで、正しい呼び出し方法が理解できるようになります。

さらに、具体例や修正コードを通して正確な対処法を学ぶことができる内容になっています。