WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
머리글과 바닥글을 제외한 컨트롤의 WebPart 기본 콘텐츠 영역을 렌더링합니다.
protected:
virtual void RenderPartContents(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::WebControls::WebParts::WebPart ^ webPart);
protected virtual void RenderPartContents(System.Web.UI.HtmlTextWriter writer, System.Web.UI.WebControls.WebParts.WebPart webPart);
abstract member RenderPartContents : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.RenderPartContents : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebParts.WebPart -> unit
Protected Overridable Sub RenderPartContents (writer As HtmlTextWriter, webPart As WebPart)
매개 변수
- writer
- HtmlTextWriter
HtmlTextWriter 콘텐츠를 받는 대상입니다webPart.
- webPart
- WebPart
현재 렌더링 중인 컨트롤입니다.
예제
다음 코드 예제에서는 메서드의 사용을 보여 줍니다 RenderPartContents . 예제를 실행하는 데 필요한 전체 코드는 클래스 개요 항목의 예제 섹션을 WebPartChrome 참조하세요.
코드 예제의 다음 섹션에서는 메서드를 재정의하는 방법을 보여 줍니다 RenderPartContents . 재정의된 메서드는 컨트롤 본 WebPart 문에 대한 렌더링을 사용자 지정하기 위해 두 가지 작업을 수행합니다. 먼저 컨트롤이 현재 선택되어 있는지 여부를 확인하고, 선택되어 있으면 문자열을 작성하고 내용을 렌더링하지 않습니다. 둘째, 컨트롤이 선택되지 않은 경우 컨트롤의 영역이 형식 MyZone이면 메서드가 컨트롤을 렌더링합니다. 사용자 지정 WebPartChrome 클래스를 개체를 포함 WebPart 하도록 설계된 특정 유형의 WebPartZone 영역에서 컨트롤을 렌더링 WebPartChrome 하는 데만 사용할 수 있도록 하려면 이 후자의 검사를 사용할 수 있습니다.
protected override void RenderPartContents(HtmlTextWriter writer,
WebPart part)
{
if (part == this.WebPartManager.SelectedWebPart)
HttpContext.Current.Response.Write("<span>Not rendered</span>");
else
if(this.Zone.GetType() == typeof(MyZone))
part.RenderControl(writer);
}
Protected Overrides Sub RenderPartContents _
(ByVal writer As HtmlTextWriter, ByVal part As WebPart)
If part Is Me.WebPartManager.SelectedWebPart Then
HttpContext.Current.Response.Write("<span>Not rendered</span>")
Else
If (Me.Zone.GetType() Is GetType(MyZone)) Then
part.RenderControl(writer)
End If
End If
End Sub
브라우저에서 웹 페이지를 로드하는 경우 각 컨트롤의 콘텐츠가 정상적으로 렌더링되는 것을 볼 수 있습니다.
표시 모드 드롭다운 목록 컨트롤에서 디자인을 선택하여 페이지를 디자인 모드로 전환하고 컨트롤 중 하나를 WebPartZone2라는 빈 영역으로 끌어 놓으면 사용자 지정 WebPartChrome 개체가 표준 영역의 렌더링에 사용되지 않으므로 컨트롤의 내용이 다르게 렌더링됩니다. 이는 이전 소스 코드로 인해 클래스 외 WebPartChrome 에 다른 영역과 함께 사용자 지정 MyZone 클래스를 사용하려고 하면 얻을 수 있는 것과 동일한 효과입니다.
설명
이 RenderPartContents 메서드를 사용하면 머리글 및 바닥글의 렌더링을 기본 렌더링으로 유지하면서 본문 영역 webPart의 렌더링을 재정의할 수 있습니다.
상속자 참고
필요에 따라 메서드를 재정의할 RenderPartContents(HtmlTextWriter, WebPart) 수 있습니다. 이 경우 원하는 webPart렌더링 사용자 지정을 수행한 다음 해당 RenderControl(HtmlTextWriter) 메서드를 호출할 수 있습니다. 연결 오류 발생 시 기본 렌더링을 사용하려는 경우 먼저 기본 메서드를 호출한 다음 기본 메서드에서 반환되는 메서드를 사용자 지정 writer 합니다.