다음을 통해 공유


WebPartManager.ExportWebPart(WebPart, XmlWriter) 메서드

정의

서버 컨트롤의 상태 및 속성 데이터가 들어 있는 XML 설명 파일을 만듭니다.

public:
 virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);
public virtual void ExportWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);
abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

매개 변수

webPart
WebPart

데이터를 내보낼 해당 컨트롤입니다.

writer
XmlWriter

webPart에서 내보낸 데이터를 XML 설명 파일에 쓰는 XmlWriter입니다.

예외

webPart이(가) null인 경우

또는 writer이(가) null인 경우

webPartControls에서 참조되는 컨트롤의 컬렉션에 포함되지 않은 경우

또는 webPartExportMode 속성이 webPart에서 데이터를 내보낼 수 없음을 나타내는 None 값으로 설정된 경우

설명

이 메서드는 ExportWebPart 다양한 상태 및 속성 데이터를 webPart XML 파일로 어셈블합니다. 데이터에는 해당 어셈블리, 상태 데이터 및 속성 데이터를 포함하여 컨트롤 자체에 대한 정보가 포함됩니다. 내보내기를 시작하는 사용자는 로컬 컴퓨터 또는 네트워크의 디스크에 XML 파일을 저장할 수 있습니다. 그런 다음 다른 사용자는 설명 파일을 다른 페이지 또는 웹 사이트로 가져오고 상태 및 속성 데이터를 다른 인스턴스에 webPart적용할 수 있습니다. 이는 사용자가 서버 컨트롤에서 설정을 공유하고 다시 사용할 수 있는 빠르고 편리한 메커니즘을 제공하며, 개발자에게 내보낸 컨트롤과 가져온 컨트롤의 모양과 동작을 제어할 수 있는 수단을 제공합니다.

webPart 속성은 기본적으로 내보내지지 않습니다. 속성 내보내기를 사용하도록 설정하려면 소스 코드의 [Personalizable] 특성으로 표시해야 합니다. 필요에 따라 특성의 [Personalizable] 매개 변수를 으로 설정 isSensitive 하여 내보내기 가능한 속성을 중요한 데이터를 포함하는 것으로 표시할 true수도 있습니다. 기본적으로 isSensitivefalse합니다. 개발자는 매개 변수를 설정하여 true 데이터가 중요함을 나타낼 수 있습니다.

내보낼 수 있도록 webPart 개발자는 속성 ExportMode 값을 All 개인 설정 및 중요한 속성을 모두 포함하거나 NonSensitiveData중요한 속성을 제외한 모든 항목을 내보내도록 설정합니다.

중요

사용자가 컨트롤에서 데이터를 내보내고 다른 컨트롤로 데이터를 가져올 수 있도록 허용하면 몇 가지 보안 위험이 수반됩니다. 개발자는 위에서 설명한 접근 방식을 사용하여 중요한 데이터를 보호해야 하며, 데이터가 완전히 노출되는 위험을 방지하려면 내보내기를 전혀 사용하도록 설정 webPart 하지 않아야 합니다. 웹 파트 보안 문제에 대한 자세한 내용은 웹 파트 페이지 보안을 참조하세요.

적용 대상

추가 정보