WebPartManager.ExportWebPart(WebPart, XmlWriter) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
서버 컨트롤의 상태 및 속성 데이터가 들어 있는 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 -> unitPublic Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)매개 변수
- webPart
- WebPart
데이터를 내보낼 해당 컨트롤입니다.
예외
webPart가 Controls에서 참조되는 컨트롤의 컬렉션에 포함되지 않은 경우
또는
webPart의 ExportMode 속성이 webPart에서 데이터를 내보낼 수 없음을 나타내는 None 값으로 설정된 경우
설명
이 메서드는 ExportWebPart 다양한 상태 및 속성 데이터를 webPart XML 파일로 어셈블합니다. 데이터에는 해당 어셈블리, 상태 데이터 및 속성 데이터를 포함하여 컨트롤 자체에 대한 정보가 포함됩니다. 내보내기를 시작하는 사용자는 로컬 컴퓨터 또는 네트워크의 디스크에 XML 파일을 저장할 수 있습니다. 그런 다음 다른 사용자는 설명 파일을 다른 페이지 또는 웹 사이트로 가져오고 상태 및 속성 데이터를 다른 인스턴스에 webPart적용할 수 있습니다. 이는 사용자가 서버 컨트롤에서 설정을 공유하고 다시 사용할 수 있는 빠르고 편리한 메커니즘을 제공하며, 개발자에게 내보낸 컨트롤과 가져온 컨트롤의 모양과 동작을 제어할 수 있는 수단을 제공합니다.
webPart 속성은 기본적으로 내보내지지 않습니다. 속성 내보내기를 사용하도록 설정하려면 소스 코드의 [Personalizable] 특성으로 표시해야 합니다. 필요에 따라 특성의 [Personalizable] 매개 변수를 으로 설정 isSensitive 하여 내보내기 가능한 속성을 중요한 데이터를 포함하는 것으로 표시할 true수도 있습니다. 기본적으로 isSensitive 는 false합니다. 개발자는 매개 변수를 설정하여 true 데이터가 중요함을 나타낼 수 있습니다.
내보낼 수 있도록 webPart 개발자는 속성 ExportMode 값을 All 개인 설정 및 중요한 속성을 모두 포함하거나 NonSensitiveData중요한 속성을 제외한 모든 항목을 내보내도록 설정합니다.
중요
사용자가 컨트롤에서 데이터를 내보내고 다른 컨트롤로 데이터를 가져올 수 있도록 허용하면 몇 가지 보안 위험이 수반됩니다. 개발자는 위에서 설명한 접근 방식을 사용하여 중요한 데이터를 보호해야 하며, 데이터가 완전히 노출되는 위험을 방지하려면 내보내기를 전혀 사용하도록 설정 webPart 하지 않아야 합니다. 웹 파트 보안 문제에 대한 자세한 내용은 웹 파트 페이지 보안을 참조하세요.