WebPartManager.CopyWebPart(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 페이지에 추가할 A입니다.

설명

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

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

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

상속자 참고

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

추가 정보

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