다음을 통해 공유


WebPartManager.CreateErrorWebPart 메서드

정의

어떤 이유로 동적 WebPart 컨트롤을 로드하거나 만드는 데 실패할 경우 페이지에 삽입되고 최종 사용자에게 표시되는 특수 컨트롤을 만듭니다.

protected:
 virtual System::Web::UI::WebControls::WebParts::ErrorWebPart ^ CreateErrorWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID, System::String ^ errorMessage);
protected virtual System.Web.UI.WebControls.WebParts.ErrorWebPart CreateErrorWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID, string errorMessage);
abstract member CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
override this.CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
Protected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPart

매개 변수

originalID
String

실패한 컨트롤의 ID를 나타내는 문자열입니다. GenericWebPart가 오류와 관련된 경우 이 ID는 자식 서버 컨트롤의 ID입니다.

originalTypeName
String

실패한 컨트롤의 Type 이름을 나타내는 문자열입니다. GenericWebPart가 오류와 관련된 경우 이 형식 이름은 자식 서버 컨트롤의 형식입니다.

originalPath
String

자식 사용자 정의 컨트롤이 포함된 GenericWebPart가 오류와 관련된 경우, 사용자 정의 컨트롤의 경로가 들어 있는 문자열입니다.

genericWebPartID
String

GenericWebPart의 형식이 컨트롤 로드 또는 생성 오류와 관련된 경우 해당 컨트롤의 ID를 반환하는 문자열입니다.

errorMessage
String

페이지에 표시할 오류 메시지가 포함된 문자열입니다.

반환

로드하거나 만드는 데 실패한 컨트롤 대신 페이지에 삽입되는 ErrorWebPart입니다.

설명

이 메서드는 CreateErrorWebPart 웹 파트 컨트롤 집합이 동적 WebPart 또는 서버 컨트롤의 인스턴스를 로드하거나 만들려고 할 때 호출되며 어떤 이유로 실패합니다. 메서드는 개체를 ErrorWebPart 만들고, 오류 메시지를 할당하고, 반환합니다. ErrorWebPart 컨트롤이 실패한 컨트롤 대신 삽입되고 해당 오류 메시지가 페이지에 표시됩니다.

코드에서 직접 메서드를 CreateErrorWebPart 호출할 수 없습니다. 그러나 클래스에서 상속하고 메서드를 WebPartManager 확장할 수 있습니다. 자세한 내용은 상속자에 대한 참고 섹션을 참조하세요.

최종 사용자는 일반 WebPart 컨트롤과 ErrorWebPart 마찬가지로 페이지의 컨트롤로 작업할 수 있습니다. 오류 메시지를 제거하려면 닫힌 동사를 클릭하여 컨트롤을 닫을 수 있습니다. 이때 다른 닫힌 컨트롤과 같이 컨트롤이 개체에 PageCatalogPart 추가됩니다. 최종 사용자가 컨트롤을 ErrorWebPart 삭제하면 로드에 실패한 서버 컨트롤도 페이지에서 삭제됩니다.

상속자 참고

컨트롤에서 ErrorWebPart 반환되는 정보를 사용자 지정하려는 경우 메서드를 재정 CreateErrorWebPart(String, String, String, String, String) 의하고, 기본 메서드를 호출하고, 기본 메서드에 전달된 매개 변수에 다른 값을 할당한 다음, 결과 컨트롤을 ErrorWebPart 반환할 수 있습니다. 예를 들어 최종 사용자가 값(사용자 컨트롤의 가상 디렉터리 경로를 표시)을 표시 originalPath 하지 않도록 하려면 기본 메서드를 호출할 때 해당 매개 변수에 대해 빈 문자열("")을 전달할 수 있습니다.

컨트롤 자체에서 상속하여 컨트롤 자체의 ErrorWebPart 동작을 사용자 지정할 수도 있습니다. 예를 들어 해당 또는 AllowMinimize 속성을 재정 Title 의할 수 있습니다.

적용 대상

추가 정보