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 a los usuarios finales cuando, por algún motivo, se produce un error al intentar cargar o crear un control 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
Parámetros
- originalID
- String
Cadena que es el id. del control que ha causado el error. Si un control GenericWebPart está relacionado con el error, el id. será el id. de su control de servidor secundario.
- originalTypeName
- String
Cadena que es el nombre Type del control que presentó el error. Si un control GenericWebPart está relacionado con el error, el nombre de tipo será el tipo de su control de servidor secundario.
- originalPath
- String
Cadena que contiene la ruta de acceso a un control de usuario si un control GenericWebPart que contiene un control de usuario secundario está relacionado con el error.
- genericWebPartID
- String
Cadena que devuelve el id. de un control GenericWebPart si ese tipo de control estuviera relacionado con el error al cargar o crear un control.
- errorMessage
- String
Cadena que contiene el mensaje de error para mostrar en la página.
Devoluciones
Objeto ErrorWebPart que 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 método directamente desde el CreateErrorWebPart 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 Notes for Inheritors (Notas para heredadores).
Los usuarios finales pueden trabajar con un ErrorWebPart control en una página de forma muy parecida a lo que harían con un control normal WebPart . Para quitar el mensaje de error, pueden cerrar el control haciendo clic en el verbo close, momento en el que el control se agregará 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 .