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。