WebPartManager.ImportWebPart(XmlReader, String) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
WebPart 컨트롤에 대한 상태 및 속성 데이터가 들어 있는 XML 설명 파일을 가져온 다음 해당 데이터를 컨트롤에 적용합니다.
public:
virtual System::Web::UI::WebControls::WebParts::WebPart ^ ImportWebPart(System::Xml::XmlReader ^ reader, [Runtime::InteropServices::Out] System::String ^ % errorMessage);public virtual System.Web.UI.WebControls.WebParts.WebPart ImportWebPart (System.Xml.XmlReader reader, out string errorMessage);abstract member ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart
override this.ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart매개 변수
반환
가져온 XML 설명 파일에서 참조되는 WebPart(또는 GenericWebPart로 래핑되어 WebPart로 취급되는 서버 컨트롤)입니다.
예외
reader이(가) null인 경우
reader에서 파일을 읽지 못한 경우
또는
가져오기 오류 메시지를 표시하는 데 필요한 reader를 파일에서 찾지 못한 경우
또는
reader에서 내보낸 데이터가 들어 있는 XML 요소를 찾지 못하고 파일 끝에 도달한 경우
설명
메서드는 ImportWebPart 서버 컨트롤에 대 한 메서드에 의해 ExportWebPart 만들어진 XML 설명 파일을 가져옵니다. 가져오는 실제 서버 컨트롤이 아니라 컨트롤에 대한 상태 및 속성 데이터를 포함하는 설명 파일만 해당합니다. 설명 파일에서 참조되는 컨트롤 및 어셈블리는 사용자가 설명 파일을 가져오려고 시도하는 서버에서 이미 사용할 수 있어야 합니다.
컨트롤 가져오기를 사용하도록 설정하려면 개발자가 가져오기를 CatalogZone 사용하도록 설정할 페이지에 컨트롤을 추가해야 합니다. 영역 내에서 컨트롤을 ImportCatalogPart 추가해야 합니다. 이 컨트롤은 사용자가 가져올 설명 파일을 찾아 찾을 수 있는 파일 대화 상자를 제공합니다.
사용자가 설명 파일을 찾아 가져오기를 시작하면 메서드에서 설명 파일을 읽습니다 ImportWebPart . 오류가 없고 어셈블리와 컨트롤이 발견되면 서버 컨트롤이 컨트롤 내의 카탈로그에 ImportCatalogPart 추가되고 설명 파일에 지정된 다양한 속성 및 상태 데이터가 컨트롤에 적용됩니다. 그러면 사용자가 컨트롤을 선택하고 페이지에 추가할 수 있습니다.
중요
메서드 ImportWebPart 와 ExportWebPart 마찬가지로 이 메서드는 보안 위험에 대한 몇 가지 가능성을 가지고 있습니다. 웹 사이트로 데이터를 가져오는 작업이 포함되므로 악의적인 사용자가 잘못된 데이터를 삽입하거나 가져온 설명 파일에 코드를 스크립팅하려고 할 수 있습니다. 그런 다음 페이지 또는 데이터베이스에 잘못된 데이터가 표시되거나 삽입된 스크립트가 실행될 수 있습니다. 설명 파일 가져오기와 관련된 잠재적 위험 및 이러한 위험을 방지하는 방법에 대한 개요는 웹 파트 페이지 보안을 참조하세요.