CookieHandler 클래스

  • 참조

정의

네임스페이스:
System.IdentityModel.Services
어셈블리:
System.IdentityModel.Services.dll

HTTP 클라이언트에서 세션 쿠기를 읽고 쓰고 삭제하기 위한 추상 기본 클래스를 제공합니다.

public ref class CookieHandler abstract
public abstract class CookieHandler
type CookieHandler = class
Public MustInherit Class CookieHandler
상속
Object
CookieHandler
파생

예제

다음 예제에서는 구성 형식의 사용자 지정 쿠키 처리기를 사용 하려면 SAM MyNamespace.MyCustomCookieHandler합니다.

<cookieHandler mode="Custom">  
    <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" />  
</cookieHandler>

설명

합니다 SessionAuthenticationModule (SAM)의 인스턴스를 사용 합니다 CookieHandler 읽고, 쓰고, 쿠키를 포함 하는 쿠키를 삭제 하는 클래스를 SessionSecurityToken HTTP 클라이언트에서. 쿠키 (또는 여러 쿠키에서 세션 토큰은 분할 하는 위치에서는 쿠키를) 포함 하는 세션 토큰은 세션 쿠키 라고 합니다.

Windows Identity Foundation (WIF)에서 구현 되는 청크 분할된 쿠키 처리기 라는 쿠키 처리기와 함께 제공 되는 ChunkedCookieHandler 클래스입니다. 지정 된 청크 크기에 따라 하나 이상의 쿠키에서 세션 토큰을 분할 하는 청크 분할된 쿠키 처리기입니다. 대부분의 브라우저에 따른 개별 쿠키 크기 제한에 맞게입니다.

파생 될 수 있습니다 CookieHandler 고유한 쿠키 처리기를 만듭니다. 이렇게 하면 재정의 해야 합니다 DeleteCore, ReadCore, 및 WriteCore 삭제, 읽기 및 세션 쿠키 작성의 실제 작업을 수행 하는 방법입니다. 이러한 메서드는 일반적으로에서 쿠키 읽기를 HttpRequest.Cookies 쿠키 컬렉션 및 쓰기 또는 삭제는 HttpResponse.Cookies 컬렉션입니다. HttpContext 개체는 요청에 액세스할 수 있으며 응답은 이러한 각 방법에 대 한 매개 변수로 제공 합니다. 필요한 메서드 외에도 필요에 따라 속성 재정의할 수 있습니다 다른 가상 메서드에 의해 노출 되는 CookieHandler 처리기의 동작을 사용자 지정 클래스입니다.

여러 속성에 의해 노출 되는 CookieHandler 기본 동작 및 세션 쿠키에 대 한 속성을 지정 하는 클래스입니다. 합니다 Name, Domain, 및 Path 속성 쿠키는 유효한 도메인 및 클라이언트에 저장 되는 경로 대 한 기본 이름을 제공 합니다. HideFromClientScript 속성 쿠키는 클라이언트 쪽 스크립트에 액세스할 수 있는지 여부를 지정 합니다. RequireSsl 속성 보안 (HTTPS) 연결을 통해서만 쿠키를 전송 해야 하는지 여부를 지정 합니다. 경우 설정 된 PersistentSessionLifetime 속성 브라우저를 닫은 후에 유효한 상태를 유지 하는 세션에 대 한 영구 세션에 대 한 만료 시간을 설정 하는 합니다. 이러한 모든 속성에 일반적으로 기본 설정 된 해당 속성이 HttpCookie 처리기의 "core" 메서드를 통해 개체 (또는 개체). 자세한 내용은 각 속성에 대 한 설명서를 참조 하세요.

SAM에서 사용하는 쿠키 처리기는 cookieHandler> 요소를 통해 구성에서< 지정할 수 있습니다. 이 요소에 의해 설정 된 쿠키 처리기에 대 한 이벤트 대리자를 수정할 수 있습니다는 FederatedAuthentication.FederationConfigurationCreated 이벤트 또는 설정 하거나 통해 직접 액세스할 수는 SessionAuthenticationModule.CookieHandler 속성입니다.

생성자

CookieHandler()

CookieHandler 클래스를 초기화하기 위해 파생 클래스의 생성자에서 호출됩니다.

속성

Domain

쿠키에 사용되는 도메인을 가져오거나 설정합니다.
HideFromClientScript

클라이언트 스크립트에서 쿠키를 숨겨야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Name

처리기에서 작성한 쿠키의 기본 이름을 가져오거나 설정합니다.
Path

처리기에서 작성한 쿠키의 가상 경로를 가져오거나 설정합니다.
PersistentSessionLifetime

영구 세션의 수명입니다. 0이면 임시 세션이 항상 사용됩니다.
RequireSsl

쿠키를 SSL에만 사용해야 하는지 여부를 지정하는 값을 가져오거나 설정합니다.

메서드

Delete()

기본 이름, 도메인 및 경로가 있는 현재 요청과 연결된 쿠키를 삭제합니다.
Delete(HttpContext)

기본 이름, 도메인 및 경로가 있는 현재 요청과 연결된 쿠키를 삭제합니다.
Delete(String)

지정된 이름과 기본 도메인 및 경로가 있는 현재 요청과 연결된 쿠키를 삭제합니다.
Delete(String, HttpContext)

지정된 이름과 기본 도메인 및 경로가 있는 지정된 요청과 연결된 쿠키를 삭제합니다.
Delete(String, String, String, HttpContext)

지정된 이름, 경로 및 도메인이 있는 지정된 요청과 연결된 쿠키를 삭제합니다.
DeleteCore(String, String, String, HttpContext)

파생된 클래스에서 재정의된 경우 지정한 이름, 도메인 및 경로가 있는 지정된 요청과 연결된 쿠키를 삭제합니다.
Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
MatchCookiePath(Uri, Uri)

대상 도메인이 쿠키 도메인 내에 있고 대상 경로가 쿠키 경로 내에 있을 경우 쿠키 경로 부분의 대/소문자를 일치시켜야 합니다.
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
Read()

기본 이름이 있는 현재 요청과 연결된 쿠키를 읽습니다.
Read(HttpContext)

기본 이름, 도메인 및 경로가 있는 현재 요청과 연결된 쿠키를 읽습니다.
Read(String)

지정된 이름이 있는 현재 요청과 연결된 쿠키를 읽습니다.
Read(String, HttpContext)

지정한 이름, 기본 도메인 및 경로가 있는 쿠키를 지정한 요청과 관련하여 읽습니다.
ReadCore(String, HttpContext)

파생된 클래스에서 재정의된 경우 지정한 이름이 있고 지정된 요청과 연결된 쿠키를 읽습니다.
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)
Write(Byte[], Boolean, DateTime)

지정한 이름, 값 및 만료 시간이 있는 지정한 요청과 관련하여 쿠키를 작성합니다.
Write(Byte[], String, DateTime)

지정한 이름, 값 및 만료 시간이 있는 지정한 요청과 관련하여 쿠키를 작성합니다.
Write(Byte[], String, DateTime, HttpContext)

지정한 이름, 값 및 만료 시간이 있는 현재 요청과 관련하여 쿠키를 작성합니다.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

지정한 이름, 값, 도메인, 경로, 만료 시간, 표시 유형이 있는 쿠키를 지정한 요청과 관련하여 작성합니다.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

파생된 클래스에서 재정의된 경우, 지정한 이름, 값, 도메인, 경로, 만료 시간, 지속성 및 표시 유형이 있는 지정된 요청과 연결된 쿠키를 작성합니다.

적용 대상

추가 정보