JetBrains Rider 2026.3 Help

コードインスペクション: 契約アノテーション定義の問題

このインスペクションは 契約アノテーション の構文を検証します。

契約アノテーションの構文

契約アノテーションの入出力関係の依存関係を指定するには、次の構文を使用します。

[ContractAnnotation("[paramName:][input] => output [; [paramName:][input] => output]", [forceFullStates:true])]

入力 は次のいずれかです。

  • 参照型パラメーターの null/非 null

  • ブールパラメーターの 真/false

output を指定できます

  • 参照型の戻り値の null/非 null/null 可

  • ブール型の戻り値の 真/false

  • 停止 | 停止 | void 型 | なし (交換可能)は、関数が正常に戻らないことを示します。 つまり、例外をスローするか、プログラムの実行を停止します。

オプションのブール値 完全な状態を強制 パラメーターはデフォルトでは false で、null 許容性分析で 悲観的モードを強制できます。 つまり、メソッドの戻り値が契約条件で定義されていない場合、JetBrains Rider は null の可能性があると想定します。

備考:

  • パラメーターが 1 つの場合は、 パラメーター名 を省略できます(上記の例を参照)

  • パラメーターがない場合は、 パラメーター名 と 入力 の両方を省略できます:

    [ContractAnnotation("=> halt")] public void TerminationMethod()

    または、関数の出力が入力に関係なく同じである場合:

    [ContractAnnotation("=> halt")] public void TerminationMethod(object data, bool flag)
  • 同じパラメーターに対して複数の条件を追加できます。

    [ContractAnnotation("input:null => null; input:notnull=>notnull")] public object Transform(object input, bool flag)
  • 条件を反転させることもできます。つまり、 入力 => 出力 は 出力 <= 入力 と等しいことになります:

    [ContractAnnotation("null <= surname:null")] public string GetName(string surname)
  • 'out' パラメーターの期待値を指定することもできます。 同じ入力条件に対して戻り値と出力パラメーターの両方を指定する場合は、コンマを使用します。

    [ContractAnnotation("s:null => false,result:null")] public bool TryParse(string s, out object result)
2026 年 11 月 6 日