CS0～400

C#コンパイルエラーCS0036について解説：outパラメーターにおける[In]属性指定の注意点

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

CS0036は、C#で発生するコンパイラーエラーです。

outパラメーターに[In]属性を指定するとエラーが出ます。

コード内のメソッド定義で属性の取り扱いに注意し、正しい記法で実装することでエラーは解消されます。

目次から探す

CS0036エラーの発生要因
エラー修正方法の詳細
- 正しいパラメーター宣言の記法
- コード修正例の比較分析
開発環境でのエラー再現と検証
- 再現環境の設定方法
- 実例を通したコード解説
まとめ

CS0036エラーの発生要因

outパラメーターの基本仕様

C#におけるoutパラメーターは、メソッドから複数の値を返すための仕組みです。

outパラメーターは、必ずメソッド内部で初期化される必要があり、呼び出し元では値が未初期化の変数を引数として渡します。

具体的には、以下の点に注意が必要です。

メソッド側で必ず値を代入しないとコンパイルエラーとなる。
呼び出し側では、outキーワードを付ける必要がある。

[In]属性の役割と制約

[In]属性は、主に相互運用などでメソッドに引数を渡す際に、値が呼び出し元からメソッドに渡される一方向(入力専用)であることを示すために使用されます。

この属性は、COM連携やP/Invokeなどのシナリオで利用されることがありますが、outパラメーターに付与することはできません。

なぜなら、outパラメーターはメソッド内で値を設定し、呼び出し元へ返すため、入力専用の性質と相反するためです。

エラー発生時の具体的なメカニズム

CS0036エラーは、[In]属性がoutパラメーターに指定された場合に発生します。

このエラーは、コンパイラが属性とキーワードの組み合わせに矛盾があると判断するために発生します。

以下に詳細を示します。

属性指定時の内部処理

C#コンパイラは、パラメーターに指定された属性とキーワードが正しい組み合わせになっているか検証します。

[In]属性は、パラメーターが入力専用であることを示しており、通常の値の受け渡しやマーシャリング処理を行います。

一方、outパラメーターは、メソッド呼び出し後に値が設定されることを前提としており、入力専用の属性と衝突します。

この不整合が、コンパイラによって検出されCS0036エラーが出力される要因となります。

実例で確認する発生条件

次のコード例は、[In]属性が付いたoutパラメーターを使用した場合の一例です。

using System;
using System.Runtime.InteropServices;
public class SampleClass
{
    // ここで、[In]属性とoutが同時に使用されているためエラーが発生する
    public static void TestFunction([In] out char sampleChar)
    {
        sampleChar = 'X';
        Console.WriteLine(sampleChar);
    }
    public static void Main()
    {
        char ch; // 値が返される変数
        TestFunction(out ch);
        Console.WriteLine(ch);
    }
}

上記コードをコンパイルすると、コンパイラが[In]属性とoutパラメーターの組み合わせを認めず、CS0036エラーが発生します。

エラー修正方法の詳細

正しいパラメーター宣言の記法

CS0036エラーを解消するためには、outパラメーターに[In]属性を指定しないように宣言を修正する必要があります。

正しい記法では、単にoutキーワードを使用してパラメーターを宣言します。

たとえば、以下のように記述することでエラーを回避できます。

public static void TestFunction(out char sampleChar)
{
    sampleChar = 'Y';
    Console.WriteLine(sampleChar);
}

このように、[In]属性を削除することで、コンパイラが正しくパラメーターの役割を認識できるようになります。

コード修正例の比較分析

修正前と修正後のコード差分

修正前のコードでは、以下のように[In]属性が付与された状態でoutパラメーターが宣言されています。

// 修正前の例
public static void TestFunction([In] out char sampleChar)
{
    sampleChar = 'X';
    Console.WriteLine(sampleChar);
}

修正後は、[In]属性を削除して正しく記述された例となります。

// 修正後の例
public static void TestFunction(out char sampleChar)
{
    sampleChar = 'Y';
    Console.WriteLine(sampleChar);
}

この差分により、コンパイラの検証が正常に行われ、コンパイルが成功するようになります。

検証結果の確認ポイント

修正後のコードについては、以下のポイントを確認してください。

メソッド内部で必ずoutパラメーターに値が代入されているか。
呼び出し側で正しくoutキーワードを使用しているか。
コンパイラが警告やエラーを出さず、プログラムが実行されるか。

サンプルコードでは、修正後の関数呼び出しで変数に正しく値が設定され、Console.WriteLineで出力されることを確認できるはずです。

開発環境でのエラー再現と検証

再現環境の設定方法

開発環境としてVisual Studioや他のC#対応のIDEを利用してください。

環境設定においては、以下の項目に注意が必要です。

ターゲットフレームワークが最新または動作保証されたバージョンであること。
必要な名前空間(System.Runtime.InteropServicesなど)がインクルードされていること。
コンパイル時にエラー出力が表示される設定になっていること。

実例を通したコード解説

以下に、修正前と修正後のサンプルコードを示しながら、再現および検証の手順を解説します。

using System;
using System.Runtime.InteropServices;
public class SampleClass
{
    // 修正前のコード(コメントアウト)
    // [In]属性が付いているとCS0036エラーが発生する
    // public static void TestFunction([In] out char sampleChar)
    // {
    //     sampleChar = 'X'; // 変数に値を設定
    //     Console.WriteLine("修正前の値: " + sampleChar);
    // }
    // 修正後のコード
    public static void TestFunction(out char sampleChar)
    {
        sampleChar = 'Y'; // 正しく値を設定
        Console.WriteLine("修正後の値: " + sampleChar);
    }
    public static void Main()
    {
        char outputChar; // 出力用の変数
        TestFunction(out outputChar); // 関数呼び出し(outを使用)
        Console.WriteLine("Main内での値: " + outputChar);
    }
}

修正後の値: Y
Main内での値: Y

コンパイルエラーへの対応方法

修正前のコードでは、[In]属性が付与されたoutパラメーターによりコンパイルエラーが発生していました。

コードを修正後の状態にすることで、以下の対応が行われます。

[In]属性の除去により、コンパイラ検証が正常に通過。
メソッドの実行時に、outパラメーターに適切な値が設定される。

この手法は、同様のエラーが発生した場合に迅速に対応するための基本的な方法となります。

利用上の注意点

検証環境では、以下の点に注意してください。

他の属性との組み合わせや、異なるシナリオ(例えば、P/Invoke時)で同様の修正が必要となる可能性を考慮する。
outパラメーターの利用は、メソッドの設計意図を明確にするために適切に行うことが望まれる。
コード修正後は、必ず実行結果を検証し、意図した通りの動作を確認する。

まとめ

この記事では、C#におけるCS0036エラーの原因と解消方法について解説しています。

outパラメーターがどのように動作するか、[In]属性が指定された場合の内部処理や実際の発生条件を確認できる内容です。

また、エラー修正のための正しいパラメーター宣言方法と、修正前後のコード比較を通して検証結果の確認ポイントを明示しました。

開発環境での再現手順も紹介し、エラー対応の実践的な一例を学ぶことができます。