다음을 통해 공유


HttpContentHeaderCollection 클래스

정의

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
상속
Object Platform::Object IInspectable HttpContentHeaderCollection
특성
구현
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, HttpStreamContentHttpStringContent, 클래스 및 IHttpContent 인터페이스의 속성에서도 반환됩니다.

C# 또는 Microsoft Visual Basic에서 컬렉션 열거

C# 또는 Microsoft Visual Basic에서 HttpContentHeaderCollection 개체를 반복할 수 있습니다. foreach 구문 사용과 같은 대부분의 경우 컴파일러는 이 캐스팅을 수행하므로 명시적으로 캐스팅 IEnumerable 할 필요가 없습니다. 예를 들어 GetEnumerator를 호출하려는 경우 명시적으로 캐스팅해야 하는 경우 String 및 StringKeyValuePair를 제약 조건으로 사용하여 컬렉션 개체를 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 에 지정된 항목을 추가해 보세요.

적용 대상

추가 정보