CS0～400

C#のコンパイルエラーCS0227について解説

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

CS0227エラーは、unsafeキーワードが付いたコードを/unsafeフラグなしでコンパイルした際に発生します。

アンセーフコードを利用する場合は、プロジェクト設定で「アンセーフコードの許可」を有効にするか、コマンドラインで/unsafeオプションを付与してコンパイルしてください。

目次から探す

CS0227エラーの概要
- エラーコードCS0227の意味
- unsafeキーワードとアンセーフコードの役割
エラー発生の原因と条件
- /unsafeオプション未設定による問題
- AllowUnsafeBlocksオプションの動作
コンパイル設定と対応方法
- Visual Studioでアンセーフコードを許可する設定
- コマンドラインでの/unsafeオプション指定
コード例で確認するエラー再現と対策
まとめ

CS0227エラーの概要

C#では、ポインター操作やメモリ管理のためにunsafeキーワードを使用することがあります。

エラーコードCS0227は、ソースコードにunsafeキーワードが含まれているのに、コンパイル時にアンセーフコードの許可設定が有効になっていない場合に発生するエラーです。

これにより、ポインターやメモリ操作を含むコードが安全であるかどうかをコンパイラが判断できなくなるため、ビルドエラーが発生します。

エラーコードCS0227の意味

エラーコードCS0227は、コード中にunsafeキーワードが使用されているにも関わらず、コンパイラにアンセーフコードの許可設定がされていない場合に表示されます。

「アンセーフコード」とは、メモリ操作やポインター操作など、通常の安全なコードではない領域での処理を行うための機能を指します。

C#では、これらの操作をするために特別な許可が必要であり、この許可がない状態でunsafeキーワードを使用すると、CS0227エラーが発生します。

unsafeキーワードとアンセーフコードの役割

unsafeキーワードは、一般的なC#の安全性を一部制限し、ポインター操作など低レベルの処理を可能にします。

アンセーフコードは、通常のガベージコレクションや型安全性の恩恵を受けられないため、プログラムの動作に細心の注意を払う必要があります。

使用する際は、コード内に以下のようなコメントを入れて、どの部分でアンセーフコードを利用しているかが明確になるようにすることが望ましいです。

以下は、アンセーフコードを使用する場合のサンプルコードです。

using System;
public class MyClass
{
    unsafe public static void Main()
    {
        // サンプル：整数のポインター操作
        int number = 123;
        int* pointer = &number;
        Console.WriteLine("number: " + number);
        Console.WriteLine("pointer value: " + *pointer);
    }
}

number: 123
pointer value: 123

この例では、ポインターpointerを使って整数変数numberの値を参照しています。

正しくコンパイルするには、アンセーフコードが許可されている必要があります。

エラー発生の原因と条件

CS0227エラーが発生する主な原因は、unsafeキーワードがコード内に含まれているにもかかわらず、コンパイルオプションとして/unsafeやAllowUnsafeBlocksが有効になっていないことです。

C#では、開発環境によってはデフォルトでアンセーフコードの許可が無効になっているため、自身で設定を変更する必要があります。

/unsafeオプション未設定による問題

コマンドラインやプロジェクト設定で/unsafeオプションを指定せずにアンセーフコードを含むプログラムをコンパイルしようとすると、CS0227エラーが出力されます。

例えば、以下のコードは/unsafeオプションがない場合にエラーが発生する典型的な例です。

// エラーが発生する例
public class MyClass
{
    unsafe public static void Main()
    {
        // アンセーフなコードを含む場合
    }
}

この状態でコンパイルを行うと、CS0227エラーが発生し、「アンセーフコードは /unsafe でコンパイルした場合のみ有効です」といったメッセージが表示されます。

AllowUnsafeBlocksオプションの動作

Visual StudioなどのIDEでは、プロジェクト設定内でAllowUnsafeBlocksオプションを有効にすることが可能です。

この設定を有効にすることで、ソースコード内にunsafeキーワードが含まれていても、コンパイラがアンセーフコードを許可し、CS0227エラーを回避できるようになります。

設定が反映されていない場合、同様にCS0227エラーが発生するため、プロジェクト設定を確認することが大切です。

コンパイル設定と対応方法

CS0227エラーを解消するためには、アンセーフコードの許可設定を正しく行う必要があります。

Visual Studioやコマンドラインからコンパイルする場合、それぞれ設定方法に違いがあるため、以下の手順に従ってください。

Visual Studioでアンセーフコードを許可する設定

Visual Studio環境で開発している場合は、プロジェクトのプロパティからアンセーフコードの許可設定を変更することでエラーを回避できます。

プロジェクト設定の確認手順

プロジェクトをソリューションエクスプローラーで右クリックし、「プロパティ」を選択します。
「ビルド」タブを開き、設定項目を確認します。
「アンセーフコードの許可」というチェックボックスがあるので、チェックを入れます。

これにより、プロジェクト内のunsafeキーワードが有効となり、CS0227エラーは発生しなくなります。

ビルドオプション変更の方法

プロジェクトファイル(.csproj)を直接編集して、アンセーフブロックを許可する設定を追加することもできます。

以下は、.csprojファイル内での設定例です。

<PropertyGroup>
  <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
</PropertyGroup>

この設定により、Visual Studioでプロジェクトをビルドする際に、アンセーフコードが許可されるようになります。

コマンドラインでの/unsafeオプション指定

Visual Studioを利用せずに、コマンドラインからコンパイルする場合は、/unsafeオプションを付け加える必要があります。

コンパイラーオプションの設定方法

コマンドプロンプトやターミナルからcscコマンドを使用してコンパイルする場合、以下のように/unsafeオプションを指定してください。

csc /unsafe Program.cs

このようにコンパイルすることで、アンセーフコードが有効になり、CS0227エラーを防ぐことができます。

設定時の注意点

/unsafeオプションを使用する際には、アンセーフコードがプログラムの安全性に影響を及ぼす可能性があることを理解しておく必要があります。

コード内にポインター操作など安全性の確保が難しい部分が含まれているため、実装内容の確認と十分なテストを行うことが推奨されます。

また、プロジェクト全体でアンセーフコードを使用する場合、予期しない副作用が発生する可能性もあるため、必要最小限の範囲で使用することが望ましいです。

コード例で確認するエラー再現と対策

CS0227エラーの原因となるコード例と、それを解消するための対策を具体的なサンプルコードを交えて説明します。

エラー発生のコード例紹介

以下のサンプルコードは、unsafeキーワードを使用しているにも関わらず、アンセーフコードの許可設定がされていない場合に発生するCS0227エラーを再現する例です。

using System;
public class ErrorExample
{
    // エラー発生：/unsafeオプションが付与されていない場合
    unsafe public static void Main()
    {
        int value = 456;
        int* ptr = &value; // ポインター操作
        Console.WriteLine("Value: " + *ptr);
    }
}

// コンパイルエラー: CS0227 - アンセーフコードは /unsafe でコンパイルした場合のみ有効です。

エラー解消のためのコード修正例

エラーを解消するためには、コンパイルオプションを変更するか、プロジェクト設定でアンセーフコードを許可する必要があります。

以下は、修正後のサンプルコードで、コンパイルオプションとして/unsafeを指定する方法の例です。

using System;
public class SafeExample
{
    // コンパイル時に/unsafeオプションを指定することでエラーが解消されます
    unsafe public static void Main()
    {
        int value = 456;
        int* ptr = &value; // アンセーフコードを使用
        Console.WriteLine("Value: " + *ptr);
    }
}

Value: 456

この例では、コンパイル時に/unsafeオプションを指定した状態でビルドすると、正しく実行されることが確認できます。

コンパイル結果の検証方法

修正後のコードをVisual Studioやコマンドラインからビルドし、エラーが解消されることを確認してください。

以下は、コマンドラインでの検証手順です。

SafeExample.csというファイル名でコードを保存します。
コマンドラインから以下のようにコンパイルを実行します。

csc /unsafe SafeExample.cs

生成された実行ファイルを起動し、正しい出力が得られることを確認します。

これにより、変更が有効であるかどうかを簡単に検証でき、CS0227エラーが解消されていることが分かります。

まとめ

この記事では、C#で発生するCS0227エラーの意味や原因、そしてVisual Studioやコマンドラインでのアンセーフコード許可設定方法を解説しています。

unsafeキーワードの役割やコンパイルオプションの変更方法、具体的なコード例を通してエラー解消の手順を確認できる内容となっています。