다음을 통해 공유


WebPartManager.ImportWebPart(XmlReader, String) 메서드

정의

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.WebPart
Public Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart

매개 변수

reader
XmlReader

가져올 XML 설명 파일의 상태 및 속성 데이터를 읽는 XmlReader입니다.

errorMessage
String

가져오는 중에 오류가 발생할 경우 사용자에게 표시되는 String입니다.

반환

WebPart

가져온 XML 설명 파일에서 참조되는 WebPart(또는 GenericWebPart로 래핑되어 WebPart로 취급되는 서버 컨트롤)입니다.

예외

reader이(가) null인 경우

reader에서 파일을 읽지 못한 경우

또는 가져오기 오류 메시지를 표시하는 데 필요한 reader를 파일에서 찾지 못한 경우

또는 reader에서 내보낸 데이터가 들어 있는 XML 요소를 찾지 못하고 파일 끝에 도달한 경우

설명

메서드는 ImportWebPart 서버 컨트롤에 대 한 메서드에 의해 ExportWebPart 만들어진 XML 설명 파일을 가져옵니다. 가져오는 실제 서버 컨트롤이 아니라 컨트롤에 대한 상태 및 속성 데이터를 포함하는 설명 파일만 해당합니다. 설명 파일에서 참조되는 컨트롤 및 어셈블리는 사용자가 설명 파일을 가져오려고 시도하는 서버에서 이미 사용할 수 있어야 합니다.

컨트롤 가져오기를 사용하도록 설정하려면 개발자가 가져오기를 CatalogZone 사용하도록 설정할 페이지에 컨트롤을 추가해야 합니다. 영역 내에서 컨트롤을 ImportCatalogPart 추가해야 합니다. 이 컨트롤은 사용자가 가져올 설명 파일을 찾아 찾을 수 있는 파일 대화 상자를 제공합니다.

사용자가 설명 파일을 찾아 가져오기를 시작하면 메서드에서 설명 파일을 읽습니다 ImportWebPart . 오류가 없고 어셈블리와 컨트롤이 발견되면 서버 컨트롤이 컨트롤 내의 카탈로그에 ImportCatalogPart 추가되고 설명 파일에 지정된 다양한 속성 및 상태 데이터가 컨트롤에 적용됩니다. 그러면 사용자가 컨트롤을 선택하고 페이지에 추가할 수 있습니다.

중요

메서드 ImportWebPartExportWebPart 마찬가지로 이 메서드는 보안 위험에 대한 몇 가지 가능성을 가지고 있습니다. 웹 사이트로 데이터를 가져오는 작업이 포함되므로 악의적인 사용자가 잘못된 데이터를 삽입하거나 가져온 설명 파일에 코드를 스크립팅하려고 할 수 있습니다. 그런 다음 페이지 또는 데이터베이스에 잘못된 데이터가 표시되거나 삽입된 스크립트가 실행될 수 있습니다. 설명 파일 가져오기와 관련된 잠재적 위험 및 이러한 위험을 방지하는 방법에 대한 개요는 웹 파트 페이지 보안을 참조하세요.

적용 대상

추가 정보