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。