HttpCacheDirectiveHeaderValueCollection 클래스

정의

네임스페이스:

Windows.Web.Http.Headers

HTTP 요청 또는 응답과 연결된 HTTP 콘텐츠의 Cache-Control HTTP 헤더 값을 나타냅니다.

public ref class HttpCacheDirectiveHeaderValueCollection sealed : IIterable<HttpNameValueHeaderValue ^>, IVector<HttpNameValueHeaderValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpCacheDirectiveHeaderValueCollection final : IIterable<HttpNameValueHeaderValue>, IVector<HttpNameValueHeaderValue>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpCacheDirectiveHeaderValueCollection : IEnumerable<HttpNameValueHeaderValue>, IList<HttpNameValueHeaderValue>, IStringable

Public NotInheritable Class HttpCacheDirectiveHeaderValueCollection
Implements IEnumerable(Of HttpNameValueHeaderValue), IList(Of HttpNameValueHeaderValue), IStringable

상속

Object Platform::Object IInspectable HttpCacheDirectiveHeaderValueCollection

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IIterable<T> IEnumerable<T> IIterable<HttpNameValueHeaderValue> IEnumerable<HttpNameValueHeaderValue> IVector<HttpNameValueHeaderValue> IList<HttpNameValueHeaderValue> IStringable

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 샘플 코드에서는 HttpCacheDirectiveHeaderValueCollection 클래스의 속성과 메서드를 사용하여 HttpRequestMessage 개체에서 Cache-Control HTTP 헤더를 가져와서 설정하는 방법을 보여 줍니다.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderRequestCacheControl() {
            var request = new HttpRequestMessage();
            bool parsedOk = false;

            // Set the header with a string.
            parsedOk = request.Headers.CacheControl.TryParseAdd("no-store");

            // Set the header with a strong type.
            request.Headers.CacheControl.Add(new HttpNameValueHeaderValue("max-age", "10"));

            // Get the strong type out
            foreach (var value in request.Headers.CacheControl) {
                System.Diagnostics.Debug.WriteLine("One of the CacheControl values: {0}={1}", value.Name, value.Value);
            }

            // The ToString() is useful for diagnostics, too.
            System.Diagnostics.Debug.WriteLine("The CacheControl ToString() results: {0}", request.Headers.CacheControl.ToString());
        }

다음 샘플 코드에서는 HttpCacheDirectiveHeaderValueCollection 클래스의 속성과 메서드를 사용하여 HttpResponseMessage 개체에서 Cache-Control HTTP 헤더를 가져와서 설정하는 방법을 보여 줍니다.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderResponseCacheControl() {
            var response = new HttpResponseMessage();

            // Set the header with a string
            response.Headers.CacheControl.TryParseAdd("public");

            // Set the header with a strong type
            response.Headers.CacheControl.Add(new HttpNameValueHeaderValue("max-age", "30"));

            // Get the strong type out
            foreach (var value in response.Headers.CacheControl) {
                System.Diagnostics.Debug.WriteLine("CacheControl {0}={1}", value.Name, value.Value);
            }

            // The ToString() is useful for diagnostics, too.
            System.Diagnostics.Debug.WriteLine("The CacheControl ToString() results: {0}", response.Headers.CacheControl.ToString());
        }

설명

HttpCacheDirectiveHeaderValueCollection 클래스는 HTTP 요청 또는 HTTP 응답과 연결된 HTTP 콘텐츠의 Cache-Control HTTP 헤더 값을 나타냅니다.

HttpRequestHeaderCollection의 CacheControl 속성은 HttpCacheDirectiveHeaderValueCollection을 반환합니다. HttpResponseHeaderCollection의 CacheControl 속성은 HttpCacheDirectiveHeaderValueCollection을 반환합니다.

컬렉션 멤버 목록

JavaScript의 경우 HttpCacheDirectiveHeaderValueCollection에는 멤버 목록에 표시된 멤버가 있습니다. 또한 HttpCacheDirectiveHeaderValueCollection은 Array.prototype 의 멤버를 지원하고 인덱스를 사용하여 항목에 액세스합니다.

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

C# 또는 Microsoft Visual Basic에서 HttpCacheDirectiveHeaderValueCollection 개체를 반복할 수 있습니다. foreach 구문 사용과 같은 대부분의 경우 컴파일러는 이 캐스팅을 수행하므로 명시적으로 캐스팅 IEnumerable<HttpNameValueHeaderValue> 할 필요가 없습니다. 예를 들어 GetEnumerator를 호출하려는 경우 명시적으로 캐스팅해야 하는 경우 HttpNameValueHeaderValue 제약 조건을 사용하여 컬렉션 개체를 IEnumerable<T>로 캐스팅합니다.

속성

MaxAge	Cache-Control HTTP 헤더에서 max-age 지시문의 값을 가져오거나 설정합니다.
MaxStale	Cache-Control HTTP 헤더에서 max-stale 지시문의 값을 가져오거나 설정합니다.
MinFresh	Cache-Control HTTP 헤더에서 min-fresh 지시문의 값을 가져오거나 설정합니다.
SharedMaxAge	Cache-Control HTTP 헤더에서 s-maxage 지시문의 값을 가져오거나 설정합니다.
Size	컬렉션의 HttpNameValueHeaderValue 개체 수를 가져옵니다.

메서드

Append(HttpNameValueHeaderValue)	컬렉션의 끝에 새 HttpNameValueHeaderValue 항목을 추가합니다.
Clear()	컬렉션에서 모든 개체를 제거합니다.
First()	컬렉션의 첫 번째 HttpNameValueHeaderValue 항목에 대한 반복기를 검색합니다.
GetAt(UInt32)	컬렉션의 지정된 인덱스에서 HttpNameValueHeaderValue 를 반환합니다.
GetMany(UInt32, HttpNameValueHeaderValue[])	컬렉션의 지정된 인덱스에서 시작하는 HttpNameValueHeaderValue 항목을 검색합니다.
GetView()	HttpCacheDirectiveHeaderValueCollection의 변경할 수 없는 보기를 반환합니다.
IndexOf(HttpNameValueHeaderValue, UInt32)	컬렉션에서 HttpNameValueHeaderValue 의 인덱스를 검색합니다.
InsertAt(UInt32, HttpNameValueHeaderValue)	지정된 인덱스의 컬렉션에 HttpNameValueHeaderValue 를 삽입합니다.
ParseAdd(String)	HttpCacheDirectiveHeaderValueCollection에 항목을 구문 분석하고 추가합니다.
RemoveAt(UInt32)	HttpCacheDirectiveHeaderValueCollection에서 지정된 인덱스의 항목을 제거합니다.
RemoveAtEnd()	컬렉션에서 마지막 HttpNameValueHeaderValue 항목을 제거합니다.
ReplaceAll(HttpNameValueHeaderValue[])	컬렉션의 모든 HttpNameValueHeaderValue 항목을 지정된 HttpNameValueHeaderValue 항목으로 바꿉니다.
SetAt(UInt32, HttpNameValueHeaderValue)	컬렉션의 지정된 인덱스에서 HttpNameValueHeaderValue 를 설정합니다.
ToString()	현재 HttpCacheDirectiveHeaderValueCollection 개체를 나타내는 문자열을 반환합니다.
TryParseAdd(String)	HttpCacheDirectiveHeaderValueCollection에 지정된 항목을 구문 분석하고 추가하려고 시도합니다.

추가 정보

• HttpResponseHeaderCollection
• CacheControl
• HttpRequestHeaderCollection
• CacheControl
• HttpResponseMessage
• IIterable<T>
• IStringable
• IVector<T>