C#でSystem.NotSupportedExceptionが発生する原因と対処法：Specified method is not supported解決策

2026年5月28日

例外処理・デバッグ・テスト

C#でのアプリケーション開発において、実行時に「System.NotSupportedException: Specified method is not supported.」というエラーに遭遇することがあります。

この例外は、呼び出されたメソッドや操作が、現在のオブジェクトの実行状態でサポートされていない場合にスローされるものです。

コンパイル時にはエラーにならず、実行して初めて発覚するため、原因の特定に苦労する開発者も少なくありません。

本記事では、この例外が発生する代表的なシナリオを整理し、それぞれの状況に応じた具体的な回避策を詳しく解説します。

目次 [ close ]

System.NotSupportedExceptionとはどのような例外か

System.NotSupportedExceptionは、呼び出されたメソッドが実体として定義されているものの、そのインスタンスでは動作させることができないことを示す例外です。

例えば、インターフェースで定義されているメソッドを実装クラスで「あえてサポートしない」と設計した場合などに利用されます。

抽象クラスを継承した際に、特定の機能だけを制限したいという設計意図が含まれることもあります。

この例外は、「実装がまだ終わっていない（NotImplementedException）」のではなく、「意図的にサポートしていない」というニュアンスを持ちます。

プログラミングの設計思想においては、インターフェース分離の原則（ISP）に反している場合に、この例外が橋渡し役として使われることも珍しくありません。

主な発生原因と具体的なコード例

System.NotSupportedExceptionが発生するパターンは、主に「コレクションの操作」「ストリーム操作」「LINQの翻訳」「プラットフォーム依存」の4つに分類できます。

1. 読み取り専用コレクションへの書き込み操作

最も頻繁に見られるケースは、読み取り専用として作成されたリストや配列に対して、要素の追加や削除を試みた場合です。

List<T>.AsReadOnly() メソッドを使用して作成された ReadOnlyCollection は、IList インターフェースを実装していますが、Add や Remove メソッドをサポートしていません。

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Program
{
    public static void Main()
    {
        // 通常のリストを作成
        List<string> items = new List<string> { "Apple", "Banana" };

        // 読み取り専用ビューを作成
        ReadOnlyCollection<string> readOnlyItems = items.AsReadOnly();

        try
        {
            // サポートされていない追加操作を試みる
            // IListインターフェース経由での呼び出しを想定
            ((IList<string>)readOnlyItems).Add("Orange");
        }
        catch (NotSupportedException ex)
        {
            Console.WriteLine("例外が発生しました: " + ex.Message);
        }
    }
}

実行結果

例外が発生しました: Collection is read-only.

このように、インターフェース上ではメソッドが存在するものの、中身が読み取り専用であるため拒絶されるという仕組みです。

2. ストリーム（Stream）の機能制限

System.IO.Stream クラスを継承するクラスでは、ストリームの性質によって「読み取り専用」「書き込み専用」「シーク不可」といった制約があります。

例えば、File.OpenRead で開いたストリームに対して Write メソッドを呼び出すと、この例外が発生します。

using System;
using System.IO;

public class StreamExample
{
    public static void WriteToFile()
    {
        // 読み取り専用でファイルを開く
        using (Stream stream = File.OpenRead("test.txt"))
        {
            byte[] data = { 1, 2, 3 };
            
            // 書き込みを試みる
            // CanWriteプロパティがfalseの状態での操作
            stream.Write(data, 0, data.Length);
        }
    }
}

ネットワークストリーム（NetworkStream）などで Position プロパティを操作しようとしたり、Seek メソッドを呼び出したりした場合も同様です。

3. Entity Framework (EF Core) における未サポートのLINQ操作

データベースアクセスを行うEF Coreでは、LINQクエリをSQL文に翻訳して実行します。

しかし、C#のメソッドの中には、SQLに変換できないものが存在します。

自作の複雑なメソッドを Where 句や Select 句の中で使用すると、翻訳エンジンが対応できず NotSupportedException をスローします。

// このようなクエリは、MyCustomMethodをSQLに変換できないため失敗する可能性がある
var results = context.Users
    .Where(u => MyCustomMethod(u.Name))
    .ToList();

// 解決策：一度データを取得（AsEnumerable）してからメモリ上でフィルタリングする
var resultsFix = context.Users
    .AsEnumerable() 
    .Where(u => MyCustomMethod(u.Name))
    .ToList();

4. プラットフォーム依存のAPI利用

.NETはマルチプラットフォーム対応ですが、Windows固有のAPIをLinux環境などで呼び出した場合、実行時にこの例外が発生することがあります。

例えば、レジストリ操作を行う Microsoft.Win32.Registry クラスなどが代表例です。

NotSupportedExceptionとNotImplementedExceptionの違い

よく混同される例外に NotImplementedException がありますが、これらは明確に使い分ける必要があります。

例外名	意味・背景	主な用途
NotSupportedException	仕様上、そのメソッドをサポートしていない	読み取り専用クラス、特定の環境での制限
NotImplementedException	将来的に実装予定だが、まだ記述していない	開発途中のスタブ、自動生成コード

NotImplementedException は「開発者の作業漏れ」を意味することが多く、リリース時には解消されているべきものです。

対して NotSupportedException は、「そのオブジェクトの設計において、その操作は永久に許可されない」という意思表示として使われます。

解決策と回避策の詳細

エラーが発生した際、単に例外をキャッチするのではなく、発生を未然に防ぐプログラミングが推奨されます。

機能チェックプロパティを利用する

.NETの設計パターンの多くは、操作が可能かどうかを事前に確認するためのプロパティを提供しています。

Stream クラスであれば CanRead, CanWrite, CanSeek プロパティを確認しましょう。

if (stream.CanWrite)
{
    stream.Write(buffer, 0, buffer.Length);
}
else
{
    // 書き込み不可時の適切な処理
}

コレクションであれば、IsReadOnly プロパティをチェックすることで、安全に操作が可能か判断できます。

適切なコレクション型を選択する

要素を追加する必要がある場合は、AsReadOnly() や Array を IList にキャストしたものを避けるべきです。

不変（Immutable）なコレクションが必要な場合は、System.Collections.Immutable 名前空間のコレクションを検討してください。

これらの型は、要素を変更しようとすると「新しいインスタンスを返す」設計になっており、例外をスローする破壊的な操作を避けることができます。

EF Coreでのクライアント側評価

データベースクエリで例外が出る場合は、クエリの一部をメモリ上で実行するように修正します。

.AsEnumerable() や .ToList() を呼び出すことで、それ以降の処理はSQLへの変換対象から外れます。

ただし、大量のデータを一度にメモリへ展開するとパフォーマンス低下を招くため、フィルタリングは可能な限りSQL側で行うよう設計を見直すことが重要です。

独自のNotSupportedExceptionをスローする場合の設計

もし自身でライブラリを作成し、特定のメソッドをサポートしない設計にする場合、適切なメッセージと共にこの例外をスローします。

throw new NotSupportedException("このプロトコルでは書き込み操作は許可されていません。"); のように、理由を明記するのが親切です。

ただし、頻繁にこの例外が発生する設計は、利用者に混乱を招くため、「不適切なインターフェース設計になっていないか」を一度再考することをお勧めします。

まとめ

System.NotSupportedExceptionは、オブジェクトの現在の状態や性質が、要求された操作に対応していないことを示すシグナルです。

主に「読み取り専用」「ストリームの制約」「LINQの翻訳限界」「プラットフォーム制限」が原因となります。

発生を未然に防ぐには、CanWrite や IsReadOnly といった確認用プロパティを適切に使用することが不可欠です。

また、EF Coreなどの外部ライブラリを使用する際は、どのメソッドが変換可能かを把握し、必要に応じて評価タイミングを調整しましょう。

エラーメッセージから根本的な原因を正しく読み解き、適切な設計変更やチェック処理を実装することで、堅牢なC#プログラムを構築してください。