WebPartManager.CopyWebPart(WebPart) 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

웹 파트 컨트롤 집합에서 웹 페이지에 WebPart 또는 서버 컨트롤을 추가하기 위해 해당 컨트롤의 복사본을 만드는 데 사용됩니다.

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPart ^ CopyWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPart CopyWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart
override this.CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart

Protected Overridable Function CopyWebPart (webPart As WebPart) As WebPart

매개 변수

webPart

WebPart

복사할 WebPart 또는 서버 컨트롤입니다.

반환

WebPart

페이지에 추가할 WebPart입니다.

설명

코드에서 직접 메서드를 CopyWebPart 호출할 수 없습니다. 이 메서드는 페이지에 새 동적 WebPart 또는 서버 컨트롤을 WebPartManager 추가하는 프로세스의 일부로 컨트롤에 의해 내부적으로 호출됩니다. 동적 컨트롤은 프로그래밍 방식으로 또는 웹 파트 UI(사용자 인터페이스)를 통해 페이지에 추가됩니다. 예를 들어 사용자가 페이지의 태그에 직접 선언되는 정적 컨트롤과는 달리 컨트롤 카탈로그에서 컨트롤을 추가합니다.

참고

개발자가 메서드가 추가 컨트롤 복사 시나리오를 처리하도록 설정하려는 경우 파생 클래스에서 메서드를 재정의할 수 있습니다. 자세한 내용은 상속자에 대한 참고 사항 섹션을 참조하세요.

새 동적 컨트롤이 추가되면 컨트롤인 경우 메서드는 WebPartCopyWebPart 컨트롤의 새 인스턴스를 반환합니다. 추가되는 컨트롤이 다른 유형의 서버 컨트롤(예: 사용자 정의 컨트롤, 사용자 지정 컨트롤 또는 ASP.NET 컨트롤)인 경우 컨트롤은 이미 웹 파트 컨트롤 집합에 의해 개체로 GenericWebPart 래핑된 것입니다. 메서드가 CopyWebPart 컨트롤을 GenericWebPart 발견하면 컨트롤 내에 래핑된 자식 컨트롤의 GenericWebPart 새 인스턴스를 사용하여 컨트롤의 새 인스턴스를 반환합니다.

메서드는 CopyWebPart 반환할 컨트롤의 새 복사본을 만들 때 모든 속성의 값을 기본값으로 다시 설정합니다. 개인 설정 가능한 속성의 값을 유지하고 새 컨트롤 인스턴스에 복사하려면 메서드도 호출 CopyPersonalizationState 해야 합니다. 메서드가 CopyWebPart 수행하는 마지막 단계는 메서드를 호출하여 컨트롤에 CreateDynamicWebPartID 대한 새 ID를 가져오는 것입니다.

참고

메서드는 복사된 컨트롤에 대한 새 ID를 가져오므로 원래 ID로 페이지에 추가되는 동적 컨트롤을 참조하는 데 의존해서는 안 됩니다. 대신 메서드에서 반환된 컨트롤의 새 인스턴스를 참조해야 합니다.

상속자 참고

개발자가 클래스에서 WebPartManager 상속하고, 메서드를 재정의하고, 컨트롤 복사본을 만들 수 있는 추가 시나리오를 제공할 수 있도록 메서드가 로 선언 virtual 됩니다. 예를 들어 메서드는 필요에 따라 XML 파일로 직렬화된 컨트롤을 입력으로 받을 수 있습니다. 메서드는 XML을 역직렬화한 다음(있는 경우) 기본 메서드를 호출하여 기존 사례를 처리하고 컨트롤의 새 인스턴스를 WebPart 반환할 수 있습니다.

추가 정보

• AddWebPart(WebPart, WebPartZoneBase, Int32)
• ASP.NET 웹 파트 컨트롤