WebPartManager.CreateErrorWebPart 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
어떤 이유로 동적 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.ErrorWebPartProtected 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 동작을 사용자 지정할 수도 있습니다. 예를 들어 해당 Title 속성 또는 AllowMinimize 속성을 재정의할 수 있습니다.