CS401～800

C#コンパイラエラーCS0647について解説

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

CS0647はC#で発生するコンパイラエラーで、属性作成時に不正なUUID形式が指定された場合に出現します。

たとえばGuid属性で誤った値を設定するとエラーが発生するため、正しい形式(例：00000000-0000-0000-0000-000000000001)を使用することで解消できます。

目次から探す

エラー発生条件と原因の解説
- 不正なUUID形式の説明
- エラーメッセージの内容解析
エラー解析とコード例の検証
- 不適切なコード記述によるエラー再現
- デバッグ時のエラー箇所特定手法
エラー修正方法と対応策
- Guid属性の正しい使用方法
- 修正後の動作確認と注意点
まとめ

エラー発生条件と原因の解説

不正なUUID形式の説明

Guid属性で求められる正しいUUID形式

Guid 属性は、正確な UUID の書式が必要です。

UUID は 32 桁の 16 進数の数字を、ハイフンで区切った形式で表記されます。

一般的な形式は

$8 - 4 - 4 - 4 - 12$

となります。

たとえば、"00000000-0000-0000-0000-000000000001" のような形式が正しいです。

これにより、属性が正しく認識され、コンパイラが内部で正しい解析を実施できるようになります。

誤ったUUID指定の具体例

誤った形式で UUID を指定すると、属性の解析時にエラーが発生します。

たとえば、下記の例では不正な Guid 属性が指定されているため、エラー CS0647 が発生します。

// SampleError.cs
using System.Runtime.InteropServices;
[Guid("z")]  // 不正なUUID形式の指定のため、エラー発生
public class MyClass
{
    public static void Main()
    {
        // プログラム内容は不要です
    }
}

// コンパイラ出力例
CS0647: 'attribute' 属性を作成時にエラーが発生しました -- 'reason'

エラーメッセージの内容解析

CS0647エラーコードの意味

エラーコード CS0647 は、属性の生成時に発生する問題を示します。

このエラーは、主に Guid 属性のように特定の形式を求める属性で、指定された値が要求される形式と一致しない場合に出現します。

コンパイラは属性のパラメータを解析し、正しい形式でない場合にエラーコードを返します。

エラー文中の各要素の解釈

エラーメッセージは、属性の生成に関する詳細な情報を提供します。

'attribute'

エラーが発生した属性の種類を指します。

エラーを作成時にエラーが発生しました

属性の初期化または解析中に不具合が見つかったことを示します。

-- 'reason'

エラーに至った具体的な理由が表示されます。

これらの要素の意味を理解することで、原因特定と修正箇所の判断が容易になります。

エラー解析とコード例の検証

不適切なコード記述によるエラー再現

実際のコード例に見るエラー発生状況

以下のサンプルコードは、誤った UUID 書式の指定によりエラーが発生する例です。

このコードは、Guid 属性に不正な文字列を渡しているため、コンパイル時にエラー CS0647 が出力されます。

// ErrorReproduction.cs
using System.Runtime.InteropServices;
[Guid("invalid-uuid")]  // 不正なUUID形式のためエラー発生
public class ExampleClass
{
    public static void Main()
    {
        // エラー再現コード
        System.Console.WriteLine("不正なGUID属性エラーを再現します");
    }
}

// コンパイラ出力例
CS0647: 'attribute' 属性を作成時にエラーが発生しました -- 指定された文字列は有効なUUID形式ではありません

コンパイラ出力の確認方法

コンパイラ出力は、使用している開発環境(Visual Studio やコマンドラインの csc コンパイラなど)で確認できます。

Visual Studio の場合、エラーリストウィンドウにエラーコードとメッセージが表示されます。
コマンドラインの場合、コンパイル実行後にターミナル上でエラーメッセージが出力されます。

正確なエラー内容を確認することで、どの属性や行に問題があるかを特定しやすくなります。

デバッグ時のエラー箇所特定手法

エラーメッセージとソースコードの対応付け

エラー修正のためには、エラーメッセージの情報と対応するソースコード部分を突き合わせることが重要です。

エラーメッセージに含まれる行番号を確認し、その行に記述された属性やコードを見直します。
エラーに表示された属性名(例：Guid)が正しい書式で記述されているか、値が正規表現に沿っているかを再確認します。

デバッグ手法の具体例

たとえば、エラーメッセージが「CS0647」と表示された場合、まず属性の指定箇所を確認し、UUID が正しい形式になっているかをチェックします。

これにより、該当箇所を効率的に特定することが可能です。

エラー修正方法と対応策

Guid属性の正しい使用方法

正しいUUID書式の例示

正しい UUID の書式は、次のような 8-4-4-4-12 の形式です。

例："00000000-0000-0000-0000-000000000001"

この形式で指定することにより、Guid 属性が正しく解析され、エラーが解消されます。

コード修正手順の詳細

以下のサンプルコードは、先ほどのエラーコードを修正したものです。

不正な文字列を正しいUUID書式へ変更することで、エラーが発生しなくなります。

// FixedCode.cs
using System;
using System.Runtime.InteropServices;
[Guid("00000000-0000-0000-0000-000000000001")]  // 正しいUUID形式に修正
public class FixedExample
{
    public static void Main()
    {
        // 修正後の動作確認用コード
        Console.WriteLine("正しいGUID属性の指定によりコンパイルエラーが解消されました");
    }
}

正しいGUID属性の指定によりコンパイルエラーが解消されました

修正後の動作確認と注意点

コンパイル再試行のポイント

修正後は、再度コンパイルを実行してエラーが解消されていることを確認してください。

Visual Studio を利用している場合、ビルドメニューから再ビルドを実施する。
コマンドラインの場合、csc FixedCode.cs のように再度コンパイルして、エラーの有無を確認する。

修正後に検討すべき関連事項

修正後は、ほかの属性にも同様の注意を払う必要があります。

他のカスタム属性でも、指定値のバリデーションが必要な場合があるため、仕様を確認する。
プロジェクト全体で一貫した属性の使用方法を採用することで、将来的なエラー発生を予防できます。

まとめ

本記事では、C# コンパイラエラー CS0647 の発生条件と原因を分かりやすく解説しています。

正しいUUIDの書式と、誤った指定方法によりエラーが発生する具体例を提示。

また、コンパイラメッセージの各要素の意味や、エラー箇所の特定方法についても説明し、正確な修正手順とコードサンプルを通じて、エラー修正後の動作確認のポイントを紹介しました。