WebPartManager.CreateErrorWebPart Método

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls.WebParts

Ensamblado:: System.Web.dll

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

ErrorWebPart

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 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 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 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, es posible que desee invalidar su Title propiedad o AllowMinimize .

Se aplica a