WebPartManager.CreateErrorWebPart Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un control especial que se inserta en una página y se muestra para los usuarios finales, cuando se produce un error al intentar cargar o crear un control dinámico WebPart por algún motivo.
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 ErrorWebPartParámetros
- originalID
- String
Cadena que es el identificador del control con errores. Si se produce un GenericWebPart error, el identificador es el identificador de su control de servidor secundario.
- originalTypeName
- String
Cadena que es el nombre del Type control con errores. Si se produce un GenericWebPart error, el nombre de tipo es el tipo de su control de servidor secundario.
- originalPath
- String
Cadena que contiene la ruta de acceso a un control de usuario, si un GenericWebPart objeto que contiene un control de usuario secundario está implicado en el error.
- genericWebPartID
- String
Cadena que devuelve el identificador de un GenericWebPart, si ese tipo de control estaba implicado en el error al cargar o crear un control.
- errorMessage
- String
Cadena que contiene el mensaje de error que se va a mostrar en la página.
Devoluciones
que ErrorWebPart se inserta en una página en lugar de un control que no se pudo cargar o crear.
Comentarios
Se CreateErrorWebPart llama al método cuando el conjunto de controles de elementos web intenta cargar o crear una instancia de un control dinámico WebPart o de servidor y se produce un error por algún motivo. El método crea un ErrorWebPart objeto , le asigna un mensaje de error y lo devuelve. El ErrorWebPart control se inserta en lugar del control que produjo un error y su mensaje de error se muestra en la página.
No se puede llamar al CreateErrorWebPart método directamente desde el código. Sin embargo, puede heredar de la WebPartManager clase y extender el método . Para obtener más información, consulte la sección Notas para heredar.
Los usuarios finales pueden trabajar con un ErrorWebPart control en una página como lo harían con un control normal WebPart . Para quitar el mensaje de error, pueden cerrar el control haciendo clic en el verbo close, en cuyo punto se agregará el control a un PageCatalogPart objeto, como cualquier otro control cerrado. Si un usuario final elimina un ErrorWebPart control, el control de servidor que no se pudo cargar también se eliminará de la página.
Notas a los desarrolladores de herederos
Si desea personalizar la información que se devuelve en el ErrorWebPart control, puede invalidar el CreateErrorWebPart(String, String, String, String, String) método, llamar al método base, asignar valores diferentes a los parámetros pasados al método base y, a continuación, devolver el control resultante ErrorWebPart . Por ejemplo, si no desea que los usuarios finales vean el originalPath valor (que mostraría la ruta de acceso del directorio virtual de un control de usuario), al llamar al método base, podría pasar una cadena vacía ("") para ese parámetro.
También puede personalizar el comportamiento del ErrorWebPart propio control heredando de él. Por ejemplo, puede que desee invalidar su Title propiedad o AllowMinimize .