Como criar personalizado relato páginas ASP.NET utilizando o Visual C#. NET

Voltar ao topo

Novas funcionalidades do ASP.NET

Voltar ao topo

Como utilizar o método Page_Error

1. Siga estes passos para adicionar um novo ficheiro chamado PageEvent.aspx ao projecto:
   1. Abra o Microsoft Visual Studio .NET.
   2. No Solution Explorer, clique com o botão direito do rato no nó de projecto, aponte para Adicionar e, em seguida, clique em Adicionar formulário de Web .
   3. Na caixa de texto nome , escreva PageEvent.aspx e, em seguida, clique em Abrir .
2. Adicione o seguinte código para PageEvent.aspx:

   <script language=C# runat="server">
   void Page_Load(object sender, System.EventArgs e)
   {
   	throw(new ArgumentNullException());
   }
   
   public void Page_Error(object sender,EventArgs e)
   {
   	Exception objErr = Server.GetLastError().GetBaseException();
   	string err =	"<b>Error Caught in Page_Error event</b><hr><br>" + 
   			"<br><b>Error in: </b>" + Request.Url.ToString() +
   			"<br><b>Error Message: </b>" + objErr.Message.ToString()+
   			"<br><b>Stack Trace:</b><br>" + 
   	                  objErr.StackTrace.ToString();
   	Response.Write(err.ToString());
   	Server.ClearError();
   }
   </script> 
   					

   
   Nota Neste exemplo de código, o AutoEventWireup atributo não for explicitamente definido. Se não for explicitamente atribuído um valor ao atributo AutoEventWireup , é utilizada a predefinição valor Verdadeiro . Se utilizar o Visual Studio .NET para desenvolver as aplicações, o código de modelo de formulário Web define explicitamente o valor do atributo AutoEventWireup como false . Existe uma diferença importante entre o valor predefinido que o ASP.NET utiliza e o valor predefinido que o código de modelo do Visual Studio .NET atribui a este atributo. Se o valor do atributo AutoEventWireup estiver definido como false , os processadores de eventos são declarados na página .aspx não despoletado. Isto pode ser confuso se não tiver conhecimento sobre esta funcionalidade.
3. No menu ficheiro , clique em Guardar PageEvent.aspx .
4. Com o botão direito do rato na página e, em seguida, clique em View in browser para executar a página. Repare que o erro é accionado e comunicado de acordo com as especificações de código.

Voltar ao topo

Como utilizar o método Application_Error

1. Adicione um novo ficheiro chamado AppEvent.aspx ao projecto.
2. Adicione o seguinte código para AppEvent.aspx:

   <script language=C# runat="server">
   	void Page_Load(object sender, System.EventArgs e)
   	{
   		throw(new ArgumentNullException());
   	}
   </script>
   					

   
   Nota As informações apresentadas na secção " Page_Error " sobre o atributo AutoEventWireup aplicam-se também para o código de exemplo neste passo. Consulte as informações na secção " Page_Error " para obter mais detalhes.
3. No menu ficheiro , clique em Guardar AppEvent.aspx .
4. Adicione o processador de eventos Application_Error ao ficheiro global.asax véu o erro que accione no processador de eventos Page_Load da página AppEvent.aspx. Repare que tem de adicionar outra instrução utilizando o espaço de nomes System.Diagnostics Global.asax para utilizar o registo de eventos.
   
   Adicione o seguinte código ao ficheiro global.asax:

   using System.Diagnostics;
   
   protected void Application_Error(object sender, EventArgs e)
   {
   	Exception objErr = Server.GetLastError().GetBaseException();
   	string err =	"Error Caught in Application_Error event\n" +
   			"Error in: " + Request.Url.ToString() +
   			"\nError Message:" + objErr.Message.ToString()+ 
   			"\nStack Trace:" + objErr.StackTrace.ToString();
   	EventLog.WriteEntry("Sample_WebApp",err,EventLogEntryType.Error);
   	Server.ClearError();
   	//additional actions...
   } 
   					

5. Guarde o ficheiro global.asax.
6. No Visual Studio. NET, no menu criar , clique em criar .
7. Com o botão direito do rato na página e, em seguida, clique em View in browser . Neste caso a página serão em branco, no entanto, deve notar que foi adicionada uma nova entrada no registo de eventos. Este exemplo torna uma entrada no registo de aplicações, que é acessível a partir do Visualizador de eventos. Depois de iniciar o erro poderá redireccionar o utilizador para outra página de erro mais fácil de utilizar ou executar algumas acções adicionais se for necessário.

Voltar ao topo

Como utilizar o ficheiro Web.config

1. Abra o ficheiro global.asax do exemplo anterior.
2. Comentário sem a linha Server.ClearError para se certificar de que o erro surfaces in a Web.config ficheiro.
3. Guarde as alterações global.asax. O código deverá aparecer agora semelhante ao seguinte:

   using System.Diagnostics;
   
   protected void Application_Error(object sender, EventArgs e)
   {
   	Exception objErr = Server.GetLastError().GetBaseException();
   	string err =	"Error Caught in Application_Error event\n" +
   			"Error in: " + Request.Url.ToString() +
   			"\nError Message:" + objErr.Message.ToString() + 
   			"\nStack Trace:" + objErr.StackTrace.ToString();
   	EventLog.WriteEntry("Sample_WebApp",err,EventLogEntryType.Error);
   	//Server.ClearError();
   	//additional actions...
   } 
   					

4. Adicione o código seguinte à secção <customerrors> para redireccionar o utilizador para uma página personalizada:

   <customErrors defaultRedirect="http://hostName/applicationName/errorStatus.htm" mode="On">
   </customErrors>
   						

   Nota tem de modificar o caminho do ficheiro no atributo defaultRedirect forma a que faz referência aos nomes relevantes do servidor e aplicações Web.
5. Uma vez que os erros que são aplicados véus neste nível são enviados para uma página de erro predefinida, tem de criar uma página de erro denominada ErrorStatus.htm. Não se esqueça de que está a utilizar este método para controlar o que é apresentado ao utilizador para que este exemplo utiliza uma página .htm para a página de erro. Adicione o seguinte código para ErrorStatus.htm:

   <HTML>
   <HEAD>
   <TITLE></TITLE>
   <META NAME="GENERATOR" Content="Microsoft Visual Studio 7.0">
   </HEAD>
   <BODY>
        <b>Custom Error page!</b>
        <br>
        You have been redirected here from the <customErrors> section of the 
        Web.config file.
   </BODY>
   </HTML>
   					

6. Para testar o código, guardar os ficheiros, criar o projecto e, em seguida, visualizar AppEvent.aspx no browser. Repare que, quando o erro é accionado, é redireccionados para a página ErrorStatus.htm.

<customErrors defaultRedirect="http://hostName/applicationName/errorStatus.htm" mode="On">
	<error statusCode="404" redirect="filenotfound.htm" />
</customErrors>
				

• no : não processadas excepções redireccionar o utilizador para a página especificada defaultRedirect . Este modo é utilizado principalmente na produção.
• off : utilizadores recebem as informações de excepção e não são redireccionados para a página defaultRedirect . Este modo é utilizado principalmente em desenvolvimento.
• RemoteOnly : só os utilizadores que aceder ao site no computador local (utilizando localhost) recebem as informações de excepção. Todos os outros utilizadores são redireccionados para a página defaultRedirect . Este modo é utilizado principalmente para depuração.

Voltar ao topo

Resolução de problemas

Voltar ao topo