IFormCollection.Item[String] プロパティ

定義

名前空間:

Microsoft.AspNetCore.Http

アセンブリ:

Microsoft.AspNetCore.Http.Features.dll

パッケージ:

Microsoft.AspNetCore.App.Ref v8.0.0

指定したキーを持つ値を取得します。

public:
 property Microsoft::Extensions::Primitives::StringValues default[System::String ^] { Microsoft::Extensions::Primitives::StringValues get(System::String ^ key); };

public Microsoft.Extensions.Primitives.StringValues this[string key] { get; }

member this.Item(string) : Microsoft.Extensions.Primitives.StringValues

Default Public ReadOnly Property Item(key As String) As StringValues

パラメーター

key

String

取得する値のキー。

プロパティ値

StringValues

指定したキーを持つ要素。キー StringValues.Empty が存在しない場合は 。

例外

ArgumentNullException

key が null です。

InvalidOperationException

コンテンツ タイプが正しくありません。

注釈

IFormCollection には とは異なるインデクサー コントラクト IDictionary<TKey,TValue>があります。例外をスローするのではなく、不足しているエントリに対して が返 StringValues.Empty されるためです。

このインデクサーは POST 要求でのみ使用できます。 それ以外の場合は、型 InvalidOperationException の例外がスローされます。

このプロパティを呼び出すと、非同期実装をラップしているため、スレッドが枯渇する可能性があります。 メソッドは HttpRequest.ReadFormAsync(CancellationToken) 、ブロックせずにフォームを取得できます。 詳細については、「https://aka.ms/aspnet/forms-async」を参照してください。