Makale numaras�: 306355 - Son G�zden Ge�irme: 28 A�ustos 2007 Sal� - G�zden ge�irme: 4.8

ASP.NET sayfalar�nda Visual C#. NET'i kullanarak �zel hata olu�turma hakk�nda

�ngilizce ve T�rk�e'yi yan yana g�r�nt�leme

Buraya t�klayarak �ngilizce ve T�rk�e'yi yan yana g�r�nt�leyebilirsiniz.

Otomatik terc�me makalelerin ne oldu�unu a��klayan yaz�y� okumak i�in buraya t�klay�n

Bu makalenin ge�erli oldu�u �r�nleri g�r�n.

Sistem �pucuBu makale, kulland��n�zdan farkl� bir i�letim sistemine y�neliktir. Sizinle ilgili olmayabilecek makale i�eri�i devre d�� b�rak�ld�.

Bu makalede, Visual C# .NET kodu yakalamak ve bunlar ASP.NET'te, olu�ur olu�maz hata yan�t nas�l kullan�laca�� a��klan�r. ASP.NET, <a1>Se�enekler</a1> gelen geleneksel Microsoft Active Server Pages (ASP) hata geli�tirilmi�tir. ASP.NET'te, uygulamalar�n�zda hata birka� farkl� d�zeylerde i�leyebilir.

�ste

ASP.NET'in yeni �zellikler

ASP.NET'in nas�l i�lenece�ini ve hatalar i�in yan�t birka� geli�tirmeleri sa�lar. Geleneksel ASP hatalar� ile "On Error Resume Next" (veya JScript try-catch blo�u) i�leci. Microsoft �nternet �nformation Services (IIS) 5.0 �al��t�r�yorsan�z, bunun yerine, ASPError nesnesi raporlama �zel hata sayfas� olu�turmak i�in kullan�n. Ancak, bu yakla��m, kullan�c�lar�n k�s�tlamalar� bulunmaktad�r.

ASP.NET, hangi tan�t�c� ve kullanabilirsiniz, bir ASP.NET uygulamas�n� �al��t�rd��n�zda olu�abilecek hatalar yan�t birka� d�zeyde sa�lar. ASP.NET yakalamak ve bunlar, olu�ur olu�maz hata yan�t sa�layan �� ana y�ntem sunar: Page_ErrorApplication_Error ve uygulama yap�land�rma dosyas�n�n (Web.config).

Bu makalede, bu yeni �zellikler, ASP.NET'te nas�l g�sterilmektedir uygulama. Bu makale, ASP.NET ile do�rudan ili�kili oldu�u genel hata bildirimine <a0>�zel hata sayfalar� ve</a0> sa�lamak, ancak bu makalede yakla��mlar try-catch-finally blo�unun ve Common Language Runtime (CLR) �zel durum sistem gibi di�er hata a��klanmaz.

�ste

Page_Error</a0> y�ntemini nas�l kullan�l�r?

Page_Error</a0> olay i�leyicisi, sayfa d�zeyinde ortaya ��kan hatalar�n yakalamak i�in bir yol sa�lar. (Izlemek i�in �rnek kod gibi), yaln�zca hata bilgilerini g�r�nt�leyebilirsiniz, olay g�nl��e veya ba�ka bir i�lem ger�ekle�tirmek veya.

Not Bu �rnekte, yaln�zca g�sterim amac�yla taray�c�da ayr�nt�l� hata bilgileri g�r�nt�ler. �zellikle uygulama �nternet �zerinde �al��rken g�r�nt�leme ayr�nt�l� bilgileri son kullan�c�, uygulama yaparken dikkatli olun isteyebilirsiniz. Daha uygun bir eylem, bir hata olu�tu�unu bildiren ve sonra ger�ekte �zel hata ayr�nt�lar�n� olay g�nl��nde oturum kullan�c�ya bir ileti g�r�nt�lemek i�in olacakt�r.

Bu �rnek, bo� bir �zel hata Page_Load</a1> olay i�leyicisinde yap�lmas�na zorlar atar. Page_Error</a0> olay i�leyicisi kullanarak g�steren ba�lang�� sayfas�n� olu�turmak i�in �u ad�mlar� izleyin.

Projenize PageEvent.aspx adl� yeni bir dosya eklemek i�in �u ad�mlar� izleyin:
1. Microsoft Visual Studio .NET'i ba�lat�n.
2. Solution Explorer'da (��z�m Gezgini), proje d��m�n� sa� t�klat�n, sonra da Ekle i�aret ve Web formu Ekle</a1>'� t�klat�n.
3. Ad� metin kutusuna, PageEvent.aspx yaz�n ve sonra da A� ' � t�klat�n.
PageEvent.aspx i�in a�a��daki kodu ekleyin:
<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>
Not Bu kod �rne�inde AutoEventWireup �zniteli�ini a��k�a ayarlanmam��t�r. Siz a��k olarak bir de�er AutoEventWireup �zniteli�e atamazsan�z, varsay�lan de�eri do�ru olarak kullan�l�r. Uygulamalar�n�z� geli�tirmek i�in Visual Studio. NET'i kullanarak, Web Form �ablonu kodu AutoEventWireup �znitelik de�eri a��k olarak false olarak ayarlar. Varsay�lan de�er, ASP.NET kullanan ve Visual Studio. NET'in �ablonunun kodunu bu �zniteli�e atayaca�� varsay�lan de�er aras�nda �nemli bir fark yoktur. AutoEventWireup �znitelik de�eri false olarak ayarlan�rsa, .aspx sayfas� i�inde bildirilen olay i�leyicilerini ate�lenmesine. Bu i�levsellik hakk�nda bilmiyorsan�z, kafa kar��t�r�c� olabilir.
Dosya men�s�nden PageEvent.aspx Kaydet'i t�klat�n.
Sayfay� sa� t�klat�n ve sonra sayfay� �al��t�rmak i�in View in Browser ' � t�klat�n. Hata olu�tu ve kod belirtimlerine g�re bildirdi dikkat edin.

Not Kod bir �a?r? Server.ClearError sorunlar oldu�unu fark edebilirsiniz. Bu hata, Application_Error olay i�leyicisine devam etmesini engeller.

Buna ek olarak, Not �nherits �zniteli�i da @ Page y�nergesinde katmal�d�r. Sayfaya g�zatmak i�in �nce �nherits ayarl� ise, proje olu�turmal�s�n�z. Projenin ilk olu�turdu�unuz de�il, a�a��daki hata iletisini al�rs�n�z:

'Project.PageEvent' ge�erli bir t�r de�il.

�ste

Application_Error</a0> y�ntemini nas�l kullan�l�r?

Benzer Page_Error olay i�leyicisine, Application_Error</a0> olay i�leyicisine uygulaman�zda hatalar ortaya yakalamak i�in kullanabilirsiniz. Olay uygulama genelindeki kapsam� nedeniyle uygulama hata bilgilerinin g�nl��n� veya di�er uygulama d�zeyinde hatalar ortaya ��kabilecek tan�t�c�.

�rnek izlemek i�in �nceki Page_Error kod �rne�i temel alarak ve Page_Load hata Page_Error olay i�leyicisinde yakalanan, harekete. Uygulaman�z�n Global.asax dosyas�nda Application_Error</a0> olay i�leyicisine belirtildi. Kolayl�k olmas� a��s�ndan, bu b�l�mdeki ad�mlar� �zel durum hata Application_Error olay i�leyicisini Global.asax dosyas�n� yakalamak ve hata olay g�nl��ne yazma i�in yeni bir sayfa olu�turun. A�a��daki ad�mlar Application_Error y�nteminin nas�l kullan�laca��n� g�stermektedir:

Projenize AppEvent.aspx adl� yeni bir dosya ekleyin.
AppEvent.aspx i�in a�a��daki kodu ekleyin:
<script language=C# runat="server"> void Page_Load(object sender, System.EventArgs e) { throw(new ArgumentNullException()); } </script>
NotAutoEventWireup �zniteli�i "Page_Error" b�l�m�nde anlat�lan bilgileri bu ad�mdaki �rnek kod i�in de ge�erlidir. Daha fazla bilgi i�in "Page_Error" b�l�m�ndeki bilgiler</a1> konusuna bak�n.
Dosya men�s�nden AppEvent.aspx Kaydet'i t�klat�n.

Global.asax dosyas�na AppEvent.aspx sayfa Page_Load olay i�leyicisinde durum hata yakalama Application_Error</a0> olay i�leyicisi ekleyin. Ba�ka bir ifade kullanarakSystem.Diagnostics ad alan� i�in olay g�nl��n� kullanmak i�in Global.asax eklemeniz gerekti�ini unutmay�n.

Global.asax dosyas�na a�a��daki kodu ekleyin:

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...
}

Global.asax dosyas�na kaydedin.
Visual Studio. NET'te Olu�tur) men�s�nde, Olu�tur ' u t�klat�n.
Sayfay� sa� t�klat�n ve sonra Taray�c�da G�r�nt�le ' yi t�klat�n. Bu durumda sayfa bo�, olay g�nl��nde yeni bir girdi eklendi ancak dikkat etmelidir. Bu �rnek, Olay G�r�nt�leyicisi'nden eri�ilebilen uygulama g�nl��ne bir giri� yapar. Hata g�nl�� sonra kullan�c�, yeniden y�nlendirmek i�in daha kullan��l� bir hata sayfas� ya da gerekti�inde, baz� ek eylemler ger�ekle�tirmek isteyebilirsiniz.

�ste

Web.config dosyas� nas�l kullan�l�r?

Web.config dosyas�ndaki <a1><customerrors></a1> b�l�m�ndeki ayarlar Server.ClearError aray�n veya yakalama Page_Error veya Application_Error olay i�leyicisi hata, hata ele ba�l�. <customerrors></a0> B�l�m�nde, bir yeniden y�nlendirme sayfas� varsay�lan hata sayfas� (belirtebilirsinizdefaultRedirect.) veya olu�turulur, HTTP hata kodu belirli bir sayfay� belirtin. Bu y�ntem, kullan�c�n�n ald�� hata iletisinin �zelle�tirmek i�in kullanabilirsiniz.

�nceki d�zeyler uygulaman�zdaki en yakalanan bir hata olu�ursa, bu �zel bir sayfa g�r�nt�lenir. Bu b�l�m, hi�bir zaman Server.ClearError �a�r�lmas�n� Global.asax dosyas�n� de�i�tirmek g�sterilmi�tir. Sonu� olarak, hata Web.config dosyas�nda hata yakalamak i�in son nokta ele al�n�r.

�nceki �rnekte Global.asax dosyas�n�.
Hata, Web.config i�inde y�zeyler emin olmak i�in Server.ClearError sat�r� d��nda a��klama dosyas�.

De�i�iklikleri Global.asax i�in kaydedin. Kodunuz art�k a�a��dakine benzer g�r�nmelidir:

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...
}

Kullan�c� �zel bir �al��ma sayfas�na y�nlendirmek i�in <customerrors>b�l�m�ne a�a��daki kodu ekleyin:
<customErrors defaultRedirect="http://hostName/applicationName/errorStatus.htm" mode="On"> </customErrors>
Not, ilgili Web sunucusunun ve uygulama adlar� ba�vurdu�u dosya yolu defaultRedirect �zniteli�inde de�i�tirmeniz gerekir.
Bu d�zeyde yakalanan hatalar i�in varsay�lan hata sayfas� olarak g�nderildi�inden, ErrorStatus.htm adl� bir hata sayfas� olu�turman�z gerekir. Bu �rnek, hata sayfas�n�n bir .htm sayfas� kullan�r, b�ylece ne, kullan�c�ya olmad��n� denetlemek i�in bu y�ntemi kullanarak akl�n�zda bulundurun. ErrorStatus.htm i�in a�a��daki kodu ekleyin:
<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>
Kodu s�namak i�in <a0></a0>, dosyalar� kaydetmek, projeyi derleyin ve sonra da AppEvent.aspx taray�c�da g�r�nt�lemek. Hata yarat�ld��nda ErrorStatus.htm sayfaya y�nlendirilirsiniz dikkat edin.

Varsay�lan hata sayfas� <customerrors></a0> b�l�m�ndeki <a1>defaultRedirect</a1> �zniteli�inin de�eri'nda ba�vuruda bulunabilir, ancak belirli bir sayfa olu�turulur HTTP hata koduna g�re yeniden y�nlendirmek i�in de belirtebilirsiniz. <error>Alt ��e i�in bu se�ene�i sa�lar. �rne�in,:

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

Not i�inde defaultRedirect <customerrors>b�l�m�nde belirtilen sayfa bir .htm dosyas�d�r. �

Bildirim <customerrors>b�l�m� i�eren bira��k olarak ayarlanm�� olan mod �zniteli�i. Mod �zniteli�i, hata yeniden y�nlendirme, teslimin nas�l denetlemek i�in kullan�l�r. �rne�in, uygulama geli�tiriyorsan�z, b�y�k olas�l�kla ger�ek ASP.NET hata iletilerini g�rmek istedi�iniz ve daha kolay hata sayfas�na y�nlendirilmek istemiyorsan�z. Mod �zniteli�i i�in a�a��daki ayarlar� i�erir:

�zerinde: i�lenmeyen �zel durum kullan�c� belirtilen defaultRedirect sayfaya yeniden y�nlendirin. Bu mod, genellikle �retim kullan�l�r.
Kapal�: kullan�c�lar �zel durum bilgilerini almak ve defaultRedirect sayfas�na y�nlendirilirsiniz. Bu mod, �o�unlukla geli�tirmede kullan�l�r.
RemoteOnly: (localhost kullanarak) yerel bilgisayardaki site eri�en kullan�c�lar �zel durum bilgilerini almak i�in yaln�zca. Di�er t�m kullan�c�lar�n defaultRedirect sayfas�na y�nlendirilirsiniz. Bu mod, �o�unlukla hata ay�klama amac�yla kullan�l�r.

�ste

SORUN G�DERME

Kendi varsay�lan y�klemesinde Microsoft Windows 2000 ve Microsoft Windows XP, ASP.NET, Web uygulama kod bir alt i�lemde �al��r. Bu i�lem kimli�i, ASPNET hesab� ad� verilen bir ayr�cal�� olmayan yerel hesap i�in varsay�lan kullan�l�r. Beta s�r�mlerinde ASP.NET, i�lem kimli�i sistem, bir g��l� y�netici ayr�cal�� olan hesab�n bir�ok makinede oldu.

Kendi varsay�lan y�klemesinde Windows Server 2003'te (IIS 6), ASP.NET, Web uygulama kod bir alt i�lemde �al��r. Bu i�lem kimli�i NetworkService olarak adland�r�lan s�n�rl� hesap i�in varsay�lan olarak ayarlan�r.

Bu de�i�iklik ve onu bu makaledeki kod ve ek eri�im haklar�na gereksinim duyabilece�iniz ba�ka kod �al��t�rma efekt hakk�nda daha fazla bilgi i�in a�a��daki Web sitelerini ziyaret edin:

S�r�m Microsoft .NET Framework 1 g�venlik de�i�iklikleri
http://msdn2.microsoft.com/en-us/library/ms994923.aspx (http://msdn2.microsoft.com/en-us/library/ms994923.aspx)

�ste

Referanslar

Daha fazla bilgi i�in a�a��daki Microsoft Web sitelerini ziyaret edin:

. NET'te �zel durum y�netimi
http://msdn2.microsoft.com/en-us/library/ms954599.aspx (http://msdn2.microsoft.com/en-us/library/ms954599.aspx) HttpServerUtility.ClearError y�ntemi
http://msdn2.microsoft.com/en-us/library/system.web.httpserverutility.clearerror(vs.71).aspx (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemWebHttpServerUtilityClassClearErrorTopic.asp) MSDN .NET Geli�tirme Merkezi (ingilizce)
http://msdn2.microsoft.com/en-us/netframework/default.aspx (http://msdn2.microsoft.com/en-us/netframework/default.aspx) M�crosoft .NET giri� sayfas�
http://www.microsoft.com/net/ (http://www.microsoft.com/net/)

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft ASP.NET 1.0
Microsoft Visual C# .NET 2002 Standard Edition
Microsoft ASP.NET 1.1
Microsoft Visual C# .NET 2003 Standard Edition

�ste

kbmt kbconfig kbhowtomaster kbweb KB306355 KbMttr

�ste

Otomatik Terc�me

�NEML�: Bu makale, bir ki�i taraf�ndan �evrilmek yerine, Microsoft makine-�evirisi yaz�l�m� ile �evrilmi�tir. Microsoft size hem ki�iler taraf�ndan �evrilmi�, hem de makine-�evrisi ile �evrilmi� makaleler sunar. B�ylelikle, bilgi bankam�zdaki t�m makalelere, kendi dilinizde ula�m�� olursunuz. Bununla birlikte, makine taraf�ndan �evrilmi� makaleler m�kemmel de�ildir. Bir yabanc�n�n sizin dilinizde konu�urken yapabilece�i hatalar gibi, makale; kelime da�arc��, s�z dizim kurallar� veya dil bilgisi a��s�ndan yanl��lar i�erebilir. Microsoft, i�eri�in yanl�� evrimi veya onun m��teri taraf�ndan kullan�m�ndan do�an; kusur, hata veya zarardan sorumlu de�ildir. Microsoft ayr�ca makine �evirisi yaz�l�m�n� s�k�a g�ncellemektedir.

Makalenin �ngilizcesi a�a��daki gibidir:306355� (http://support.microsoft.com/kb/306355/en-us/ )

�ste

This site in other countries/regions:

ASP.NET sayfalar�nda Visual C#. NET'i kullanarak �zel hata olu�turma hakk�nda

Bu Sayfada

�zet

ASP.NET'in yeni �zellikler

Page_Error</a0> y�ntemini nas�l kullan�l�r?

Application_Error</a0> y�ntemini nas�l kullan�l�r?

Web.config dosyas� nas�l kullan�l�r?

SORUN G�DERME

Referanslar

Bu makaledeki bilginin uyguland�� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

This site in other countries/regions:

ASP.NET sayfalar�nda Visual C#. NET'i kullanarak �zel hata olu�turma hakk�nda

Bu Sayfada

�zet

ASP.NET'in yeni �zellikler

Page_Error</a0> y�ntemini nas�l kullan�l�r?

Application_Error</a0> y�ntemini nas�l kullan�l�r?

Web.config dosyas� nas�l kullan�l�r?

SORUN G�DERME

Referanslar

Bu makaledeki bilginin uyguland��� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

Bu makaledeki bilginin uyguland�� durum: