ApiBehaviorOptions クラス

定義

ApiControllerAttribute注釈が付けられた型の動作を構成するために使用されるオプション。

public ref class ApiBehaviorOptions
public ref class ApiBehaviorOptions : System::Collections::Generic::IEnumerable<Microsoft::AspNetCore::Mvc::Infrastructure::ICompatibilitySwitch ^>
public class ApiBehaviorOptions
public class ApiBehaviorOptions : System.Collections.Generic.IEnumerable<Microsoft.AspNetCore.Mvc.Infrastructure.ICompatibilitySwitch>
type ApiBehaviorOptions = class
type ApiBehaviorOptions = class
    interface seq<ICompatibilitySwitch>
    interface IEnumerable
Public Class ApiBehaviorOptions
Public Class ApiBehaviorOptions
Implements IEnumerable(Of ICompatibilitySwitch)
継承
ApiBehaviorOptions
実装

コンストラクター

ApiBehaviorOptions()

ApiBehaviorOptions の新しいインスタンスを作成します。

プロパティ

AllowInferringBindingSourceForCollectionTypesAsFromQuery

コレクション型 (IsCollectionType) のかどうかをBindingSource決定する値を取得または設定します。

の場合 true、コレクション型のバインディング ソースは として Query推論されます。 それ以外の場合 Body は 推論されます。

ClientErrorMapping

HTTP 状態コードの マップを に ClientErrorData取得します。 構成された値は、 が ValueProblemDetailsObjectResultインスタンスに変換IClientErrorActionResultするために使用されます。

この機能の使用は、 をリセット SuppressMapClientErrorsすることで無効にすることができます。

DisableImplicitFromServicesParameters

サービスからのパラメーターが推論されるかどうかを決定する値を取得または設定します。 このプロパティは SuppressInferBindingSourcesForParametersfalse の場合にのみ適用されます。

InvalidModelStateResponseFactory

無効な ModelStateDictionary を に変換するために、 でApiControllerAttribute注釈が付けられたアクションに対して呼び出されたデリゲートIActionResult

SuppressConsumesConstraintForFormFileParameters

消費アクション制約が、フォーム データからバインドされたパラメーターに追加されるかどうかを multipart/form-data 決定する値を取得または設定します。

SuppressInferBindingSourcesForParameters

注釈が付けられたコントローラーのアクション パラメーターに対してモデル バインド ソースが推論されるかどうかを決定する値を ApiControllerAttribute 取得または設定します。

有効にすると、次のソースが推論されます。ルート値として表示されるパラメーターは、パス (Path) からバインドされていると見なされます。 型 IFormFileIFormFileCollection のパラメーターは、フォームからバインドされているものと見なされます。 複雑で 、DI コンテナーIServiceCollection (IsComplexType) に登録されているパラメーターは、このオプションが明示的に無効DisableImplicitFromServicesParametersになっていない限り、サービスServicesからバインドされているものと見なされます。 複雑な () パラメーターは、本文 (IsComplexTypeBody) からバインドされているものと見なされます。 他のすべてのパラメーターは、クエリからバインドされているものと見なされます。

SuppressMapClientErrors

コントローラーが特定のクライアント エラーを変換するかどうかを決定する値を ApiControllerAttribute 取得または設定します。

の場合 false、 を変換 IClientErrorActionResultする API コントローラー アクションに結果フィルターが追加されます。 それ以外の場合、フィルターは抑制されます。

既定では、 ClientErrorMapping は インスタンスにProblemDetailsマップIClientErrorActionResultするために使用されます (の値ObjectResultとして返されます)。

フィルターの出力をカスタマイズするには (たとえば、別のエラーの種類を返す場合)、 のカスタム実装 IClientErrorFactory をサービス コレクションに登録します。

SuppressModelStateInvalidFilter

が無効な場合ModelStateに を返すフィルターが抑制されているかどうかを決定する値をBadRequestObjectResult取得または設定します。 .

SuppressUseValidationProblemDetailsForInvalidModelStateResponses

で を使用して注釈が付けられたApiControllerAttributeコントローラーが を使用して応答するかどうかを決定する値をValidationProblemDetailsInvalidModelStateResponseFactory取得または設定します。

SuppressModelStateInvalidFilter場合true、 で エラーModelStateDictionaryValidationProblemDetailsとして返されます。 それ以外の場合は、 SuppressModelStateInvalidFilter によって SerializableError決定された形式でエラーが返されます。

明示的なインターフェイスの実装

IEnumerable.GetEnumerator()

ApiControllerAttribute注釈が付けられた型の動作を構成するために使用されるオプション。

IEnumerable<ICompatibilitySwitch>.GetEnumerator()

ApiControllerAttribute注釈が付けられた型の動作を構成するために使用されるオプション。

適用対象