HttpContentHeaderCollection 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
HTTP 요청 또는 응답의 콘텐츠와 연결된 HTTP 헤더의 컬렉션을 제공합니다.
public ref class HttpContentHeaderCollection sealed : IIterable<IKeyValuePair<Platform::String ^, Platform::String ^> ^>, IMap<Platform::String ^, Platform::String ^>, IStringable
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, IStringable
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, IStringable
function HttpContentHeaderCollection()
Public NotInheritable Class HttpContentHeaderCollection
Implements IDictionary(Of String, String), IEnumerable(Of KeyValuePair(Of String, String)), IStringable
- 상속
- 특성
- 구현
-
IMap<String,String> IDictionary<String,String> IMap<Platform::String,Platform::String> IMap<winrt::hstring,winrt::hstring> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IIterable<IKeyValuePair<String,String>> IEnumerable<KeyValuePair<String,String>> IIterable<IKeyValuePair<Platform::String,Platform::String>> IIterable<IKeyValuePair<winrt::hstring,winrt::hstring>> IStringable
Windows 요구 사항
디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
예제
다음 샘플 코드에서는 HttpContentHeaderCollection 개체의 속성을 사용하여 HTTP 콘텐츠에서 헤더를 가져와서 설정하는 방법을 보여 줍니다. Windows.Web.Http.Headers 네임스페이스에는 유효성 검사를 사용하여 헤더를 가져와서 설정하는 데 사용할 수 있는 특정 HTTP 헤더에 대한 강력한 형식의 헤더 컬렉션 및 값 클래스가 많이 있습니다.
using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;
public void DemonstrateContentHeader()
{
DemonstrateHeaderContentContentDisposition();
}
public void DemonstrateHeaderContentContentDisposition()
{
var content = new HttpStringContent("");
bool parsedOk = false;
// Set the header with a string.
HttpContentDispositionHeaderValue value;
parsedOk = HttpContentDispositionHeaderValue.TryParse("attachment; filename=\"fname.ext\"", out value);
content.Headers.ContentDisposition = value;
// Set the header with a strong type.
content.Headers.ContentDisposition = new HttpContentDispositionHeaderValue("attachment");
content.Headers.ContentDisposition.FileName = "myfile.exe";
// Get the strong type out
System.Diagnostics.Debug.WriteLine("ContentDisposition filename: {0}={1}",
content.Headers.ContentDisposition.DispositionType,
content.Headers.ContentDisposition.FileName);
// The ToString() is useful for diagnostics, too.
System.Diagnostics.Debug.WriteLine("The ContentDisposition ToString() results: {0}", content.Headers.ContentDisposition.ToString());
}
설명
HttpContentHeaderCollection은 HTTP 요청 또는 HTTP 응답 메시지의 HTTP 콘텐츠와 연결된 HTTP 헤더의 컬렉션입니다. HttpContentHeaderCollection 개체를 사용하여 HTTP 콘텐츠의 특정 헤더를 가져와서 설정할 수 있습니다. HttpContentHeaderCollection 개체의 대부분의 속성은 특정 HTTP 헤더에 대한 컨테이너 컬렉션에 대한 액세스를 제공합니다.
HttpContentHeaderCollection에는 생성자가 있으며 HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent 및 HttpStringContent, 클래스 및 IHttpContent 인터페이스의 속성에서도 반환됩니다.
C# 또는 Microsoft Visual Basic에서 컬렉션 열거
C# 또는 Microsoft Visual Basic에서 HttpContentHeaderCollection 개체를 반복할 수 있습니다.
foreach 구문 사용과 같은 대부분의 경우 컴파일러는 이 캐스팅을 수행하므로 명시적으로 캐스팅 IEnumerable
할 필요가 없습니다. 예를 들어 GetEnumerator를 호출하려는 경우 명시적으로 캐스팅해야 하는 경우 String 및 String의 KeyValuePair를 제약 조건으로 사용하여 컬렉션 개체를 IEnumerable<T>로 캐스팅합니다.
생성자
HttpContentHeaderCollection() |
HttpContentHeaderCollection 클래스의 새 instance 초기화합니다. |
속성
ContentDisposition |
HTTP 콘텐츠의 HTTP Content-Disposition 헤더 값을 나타내는 HttpContentDispositionHeaderValue 개체를 가져오거나 설정합니다. |
ContentEncoding |
HTTP 콘텐츠에서 HTTP Content-Encoding 헤더의 값을 나타내는 HttpContentCodingHeaderValue 개체의 HttpContentCodingHeaderValueCollection을 가져옵니다. |
ContentLanguage |
HTTP 콘텐츠에서 HTTP Content-Language 헤더의 값을 나타내는 개체의 HttpLanguageHeaderValueCollection을 가져옵니다. |
ContentLength |
HTTP 콘텐츠의 HTTP Content-Length 헤더 값을 가져오거나 설정합니다. |
ContentLocation |
HTTP 콘텐츠의 HTTP Content-Location 헤더 값을 가져오거나 설정합니다. |
ContentMD5 |
HTTP 콘텐츠에서 HTTP Content-MD5 헤더의 값을 가져오거나 설정합니다. |
ContentRange |
HTTP 콘텐츠의 HTTP Content-Range 헤더 값을 나타내는 HttpContentRangeHeaderValue 개체를 가져오거나 설정합니다. |
ContentType |
HTTP 콘텐츠의 HTTP Content-Type 헤더 값을 나타내는 HttpMediaTypeHeaderValue 개체를 가져오거나 설정합니다. |
Expires |
HTTP 콘텐츠의 HTTP Expires 헤더 값을 나타내는 DateTime 개체를 가져오거나 설정합니다. |
LastModified |
HTTP 콘텐츠의 HTTP 마지막 수정 헤더 값을 나타내는 DateTime 개체를 가져오거나 설정합니다. |
Size |
HttpContentHeaderCollection의 개체 수를 가져옵니다. |
메서드
Append(String, String) |
HttpContentHeaderCollection의 끝에 새 항목을 추가합니다. |
Clear() |
HttpContentHeaderCollection에서 모든 개체를 제거합니다. |
First() |
HttpContentHeaderCollection의 첫 번째 항목에 대한 반복기를 검색합니다. |
GetView() |
HttpContentHeaderCollection의 변경할 수 없는 보기를 반환합니다. |
HasKey(String) |
HttpContentHeaderCollection에 지정된 키가 포함되어 있는지 여부를 확인합니다. |
Insert(String, String) |
HttpContentHeaderCollection의 항목을 지정된 키 및 값으로 삽입하거나 바꿉니다. |
Lookup(String) |
있는 경우 HttpContentHeaderCollection에서 항목을 찾습니다. |
Remove(String) |
HttpContentHeaderCollection에서 특정 개체를 제거합니다. |
ToString() |
현재 HttpContentHeaderCollection 개체를 나타내는 문자열을 반환합니다. |
TryAppendWithoutValidation(String, String) |
유효성 검사 없이 HttpContentHeaderCollection 에 지정된 항목을 추가해 보세요. |
적용 대상
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기