HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) 메서드

정의

네임스페이스:

System.Web

어셈블리:

System.Web.dll

응답 대체 블록을 응답에 삽입할 수 있도록 하여 출력 캐시 응답의 지정된 응답 영역을 동적으로 생성할 수 있도록 합니다.

public:
 void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);

public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);

member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unit

Public Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)

매개 변수

callback

HttpResponseSubstitutionCallback

대체할 메서드, 사용자 정의 컨트롤 또는 개체입니다.

예외

ArgumentException

callback 매개 변수의 대상이 Control 형식인 경우

설명

출력 캐시된 WriteSubstitution 페이지에서 캐시 후 대체에 메서드를 사용할 수 있습니다. 지정된 HttpResponseSubstitutionCallback 서명을 사용하여 HttpContext 콜백 메서드에 개체를 전달하면 페이지 캐시의 지정된 위치에서 출력 캐시된 콘텐츠를 바꿀 수 있습니다. 대체를 시작하려면 메서드를 WriteSubstitution 호출하여 스레드로부터 안전해야 하며 다음 중 하나일 수 있는 콜백 메서드를 전달합니다.

• 컨테이너 페이지 또는 사용자 컨트롤의 정적 메서드입니다.
• 다른 임의 개체의 정적 또는 instance 메서드입니다.

페이지에 대한 첫 번째 요청에서 는 WriteSubstitution 대리자를 HttpResponseSubstitutionCallback 호출하여 출력을 생성합니다. 그런 다음, 응답에 대체 버퍼를 추가합니다. 이 버퍼는 향후 요청에서 호출할 대리자를 유지합니다. 마지막으로 클라이언트 쪽 캐시 가능성을 퍼블릭에서 서버 전용으로 저하시켜 클라이언트에서 캐싱하지 않음으로써 페이지에 대한 향후 요청이 대리자를 다시 호출하도록 합니다.

참고

캐시 후 대체는 출력 캐싱이 사용자 제어 수준에서 적용되는 캐시된 사용자 컨트롤에 대해 지원되지 않습니다. 이를 조각 캐싱이라고도 합니다. 자세한 내용은 ASP.NET 페이지의 부분 캐싱을 참조하세요.

추가 정보

• HttpResponseSubstitutionCallback
• Substitution
• 페이지의 캐시 가능성 설정
• ASP.NET 페이지의 부분 캐싱
• 캐시된 페이지의 일부를 동적으로 업데이트