IFormCollection.Item[String] 속성

정의

네임스페이스:

Microsoft.AspNetCore.Http

어셈블리:

Microsoft.AspNetCore.Http.Features.dll

패키지:

Microsoft.AspNetCore.App.Ref v8.0.0

Source:

IFormCollection.cs

지정된 키를 사용하여 값을 가져옵니다.

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에는 예외를 throw하는 대신 누락된 항목에 대해 반환 StringValues.Empty 되므로 와 다른 인덱서 계약이 IDictionary<TKey,TValue>있습니다.

이 인덱서는 POST 요청에만 사용할 수 있습니다. 그렇지 않으면 형식 InvalidOperationException 의 예외가 throw됩니다.

이 속성을 호출하면 비동기 구현을 래핑하므로 스레드가 소모됩니다. 메서드는 HttpRequest.ReadFormAsync(CancellationToken) 차단 없이 폼을 가져올 수 있습니다. 자세한 내용은 https://aka.ms/aspnet/forms-async를 참조하세요.