---
title: IL2CPP ランタイムコードチェック
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ja-jp/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/il2cpp-runtime-checks
latest_url: https://docs.unity.com/ja-jp/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/il2cpp-runtime-checks.md
generated_at: 2026-11-17T00:13:03.655Z
locale: ja-jp
---

# IL2CPP ランタイムコードチェック

> IL2CPP の C++ 生成を設定して、null リファレンスや範囲外チェックなどのランタイム安全機能を含めることを有効または使用不可にします。

`[Il2CppSetOption]` C# 属性とその `Option` パラメーターを使用して、IL2CPP コンパイラーが生成する C++ コードに含める安全性チェックをコントロールできます。

`[Il2CppSetOption]` 属性は、標準の Unity エディターおよびエンジン public API には含まれていませんが、ソースは Unity インストールの一部として別途提供されます。`[Il2CppSetOption]` 属性を使用するには、次の手順に従います。

1. Unity バージョンがインストールされているディレクトリで、Windows の場合は `Data\il2cpp` ディレクトリ、macOS の場合は `Contents/Frameworks/il2cpp` ディレクトリに移動します。
2. `Il2CppSetOptionAttribute.cs` ソースファイルを検索します。
3. ソースファイルをプロジェクトの`Assets`フォルダーにコピーします。

属性でサポートされているオプションは以下の通りです。

| **プロパティ**     | **説明**                                                                                                                                                                                                                                                                                                | **デフォルト** |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| **null チェック** | このオプションは有効にしておくことをお勧めします。無効にすると、IL2CPP は null チェックなしで C++ を生成し、マネージ`NullReferenceException`例外をスローしません。これにより、ランタイム パフォーマンスを向上させることができますが、null 値へのアクセスの試行は防止されず、クラッシュなどの意図しない動作につながる可能性があります。                                                                                                           | 有効        |
| **配列境界チェック**  | このオプションは有効にしておくことをお勧めします。無効にすると、IL2CPP は配列境界チェックなしで C++ を生成し、マネージ`IndexOutOfRangeException`例外をスローしません。これにより、ランタイムパフォーマンスが向上する可能性がありますが、コードが無効なインデックスを持つ配列にアクセスできるようになり、メモリの任意の場所からの読み取りや書き込みなど、誤った動作が発生する可能性があります。ほとんどの場合、このようなメモリアクセスは即座の副作用なしに発生し、明白な注意喚起なしにアプリケーションのステートを破損させ、エラーのデバッグが非常に困難になります。 | 有効        |
| **ゼロチェックで割る** | ゼロによる除算チェックを実行する必要がない限り、このオプションは無効のままにします。有効にすると、IL2CPP は整数除算のゼロ除算チェックを含む C++ を生成し、必要に応じてマネージ`DivideByZeroException`例外をスローします。このオプションを無効にすると、IL2CPP は生成された C++ コードへの整数除算のゼロ除算チェックを発行しません。これらのチェックはランタイムのパフォーマンスに影響します。                                                                                | 無効        |

以下の例は、`[Il2CppSetOption]` 属性の使用方法を示しています。

```lang-cs
[Il2CppSetOption(Option.NullChecks, false)]
public static string MethodWithNullChecksDisabled()
{
    var tmp = new object();
    return tmp.ToString();
}
```

`[Il2CppSetOption]`は、アセンブリ、タイプ、メソッド、およびプロパティに適用できます。Unity は最もローカルなスコープの属性を使用します。

```lang-cs
[Il2CppSetOption(Option.NullChecks, false)]
public class TypeWithNullChecksDisabled
{
    public static string AnyMethod()
    {
        // Unity doesn’t perform null checks in this method.
        var tmp = new object();
        return tmp.ToString();
    }

    [Il2CppSetOption(Option.NullChecks, true)]
    public static string MethodWithNullChecksEnabled()
    {
        // Unity performs null checks in this method.
        var tmp = new object();
        return tmp.ToString();
    }
}

public class SomeType
{
    [Il2CppSetOption(Option.NullChecks, false)]
    public string PropertyWithNullChecksDisabled
    {
        "GET",
        {
            // Unity doesn't perform null checks here.
            var tmp = new object();
            return tmp.ToString();
        }
        set
        {
            // Unity doesn't perform null checks here.
            value.ToString();
        }
    }

    public string PropertyWithNullChecksDisabledOnGetterOnly
    {
        [Il2CppSetOption(Option.NullChecks, false)]
        "GET",
        {
            // Unity doesn’t perform null checks here.
            var tmp = new object();
            return tmp.ToString();
        }
        set
        {
            // Unity performs null checks here.
            value.ToString();
        }
    }
}
```

## 追加リソース##additional-resources

* [IL2CPP マネージスタックトレースリファレンス](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/il2cpp-managed-stack-traces.md)
* [IL2CPP 追加引数リファレンス](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/handling-il2cpp-additional-args.md)
