Makale numaras�: 815788 - Son G�zden Ge�irme: 13 Mart 2008 Per�embe - G�zden ge�irme: 4.3

Izleme ve Visual C# ile hata ay�klama 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 makalenin Microsoft Visual Basic .NET s�r�m� i�in bkz: 313417 � (http://support.microsoft.com/kb/313417/EN-US/ ) .

Bu makalede, hata ay�klama ve izleme s�n�flar�n�n nas�l kullan�laca��n� a��klar. Bu s�n�flar, Microsoft .NET ile kullan�labilir Framework. Bu s�n�flar, uygulama geli�tirme s�ras�nda veya �retim i�in da��t�m sonra uygulama performans� hakk�nda bilgi sa�lamak i�in kullanabilirsiniz. Bu s�n�flar .NET Framework ara�lar� �zellikleri yaln�zca bir par�as�d�r.

�ste

Gereksinimler

A�a��daki listede, gereksinim duyaca��n�z donan�m, yaz�l�m, a� altyap�s� ve hizmet paketleri �nerilmektedir:

Microsoft Windows 2000 veya Microsoft Windows XP veya Microsoft Windows Server 2003
Microsoft Visual C#

Bu makalede ayr�ca, programda hata ay�klama ile bildi�inizi varsayar.

�ste

Teknik of a��klamas�

Create a Sample with the Debug Class </a0> b�l�m�ndeki ad�mlar� Debug s�n�f� program y�r�tme hakk�nda bilgi sa�lamak �zere kulland�� bir konsol uygulamas�n�n nas�l olu�turulaca��n� g�stermektedir.

Program �al��t�rd��n�zda, program y�r�tme s�ras� performans �l��m bilgilerini sa�lamak i�in veya d�zg�n �al��mamas�na alg�lamaya izlemek i�in Yard�m iletileri �retmek i�in hata ay�klama s�n�f� y�ntemleri kullanabilirsiniz. Varsay�lan olarak, hata ay�klama s�n�f� �reten iletileri Visual Studio'nun ��kt� penceresinde g�r�n�r t�mle�ik geli�tirme ortam� (IDE).

�rnek kod, bir sat�r� Sonland�r�c� taraf�ndan izlenen bir ileti olu�turmak i�in WriteLine y�ntemi kullan�r. Bir ileti olu�turmak i�in bu y�ntemi kulland��n�zda, her iletiyi ayr� bir sat�rda <a0>��kt�</a0> penceresinde g�r�nt�lenir.

Hata ay�klama s�n�f�n�n Assert y�ntemini kulland��n�zda, yaln�zca belirtilen bir ko�ul yanl�� olarak de�erlendirilirse, ��kt� penceresi bir ileti g�r�nt�ler. Iletinin kullan�c� i�in kal�c� bir ileti�im kutusu g�r�nt�lenir. Ileti�im kutusunda, iletinin, proje ad�n� ve Debug.Assert ekstresi numaras� i�erir. Ileti�im kutusunda, a�a��daki �� komut d��meleri de i�erir:

Iptal:Uygulaman�n �al��mas�n� durdurur.
Yeniden deneme:Uygulama hata ay�klama moduna girer.
Yoksay:Uygulama devam eder.

Kullan�c� uygulama devam etmeden �nce bu d��melerden birini t�klatman�z gerekir.

Destinations (Hedefler) ��kt� penceresini farkl� s�n�f hata ay�klama ��kt�s�n� da y�nlendirebilirsiniz. Hata ay�klama s�n�f� dinleyicisi nesneleri i�eren dinleyiciler adl� sahiptir.

Her dinleyicisi nesnesi, hata ay�klama ��k�� izler ve belirli bir hedefi ��kt�s�na y�nlendirir.

Her bir Dinleyicidinleyicisi koleksiyonunda, Debug s�n�f� �retti�i herhangi bir ��kt� al�r. S�n�f olmal�d�r, Dinleyici nesneleri tan�mlamak i�in kullan�n. S�n�f olmal�d�r, Olu�turucu ile hedefi belirtebilirsiniz.

Baz� olas� ��kt� hedefi �unlard�r:

System.Console.Out �zelli�ini kullanarak konsol penceresi.
System.IO.File.CreateText("FileName.txt") deyimini kullanarak BIR metin (.txt) dosyas�.

Bir olmal�d�r nesnesi olu�turduktan sonra hata ay�klama ��k�� almaya Debug.listeners derlemesine nesneyi eklemeniz gerekir.

�ste

Ile <a2>debug</a2> s�n�f �rne�i olu�turma

Visual Studio ya da Visual C# Express Edition'� ba�lat�n.
ConInfo adl� yeni bir Visual C# Console Application projesi olu�turun. Class1, Visual Studio. NET'te olu�turulur. Visual Studio 2005'te, program.cs olu�turulur.
�st Class1 veya program.cs
using System.Diagnostics;
a�a��daki ad alan�n� ekleyin.
Bir �r�nle ilgili bilgiler i�erecek bi�imde de�i�kenlerini ba�latmak i�in <a0></a0>, Main y�ntemi i�in a�a��daki bildirim deyimleri ekleyin:
string sProdName = "Widget"; int iUnitQty = 100; double dUnitCost = 1.03;
Ileti s�n�f� �reten WriteLine y�nteminin giri� ilk parametresi olarak belirtin. Output penceresi g�r�n�r oldu�undan emin olmak i�in CTRL + ALT + S tu� birle�imine bas�n.
Debug.WriteLine("Debug Information-Product Starting ");
Okunabilir olmas� i�in sonraki iletileri <a0>��kt�</a0> penceresinde girintilemek i�in Girinti y�ntemi kullan�n:
Debug.Indent();

Se�ili de�i�kenlerinin i�eri�ini g�r�nt�lemek i�in <a0></a0>, WriteLine y�ntemi a�a��daki gibi kullan�n:

Debug.WriteLine("The product name is " + sProdName);
Debug.WriteLine("The available units on hand are" + iUnitQty.ToString());
Debug.WriteLine("The per unit cost is " + dUnitCost.ToString());

WriteLine y�ntemi, ad ve varolan bir nesnenin s�n�f ad�'n� g�r�nt�lemek i�in de kullanabilirsiniz. �rne�in, a�a��daki kodu, ��k�� penceresinde System.Xml.XmlDocument ad bo�lu�unu g�r�nt�ler:
System.Xml.XmlDocument oxml = new System.Xml.XmlDocument(); Debug.WriteLine(oxml);
��kt� d�zenlemek i�in <a0></a0>, ikinci giri� kategori olarak bir iste�e ba�l�, parametre WriteLine y�nteminin i�erebilir. Bir kategori bi�imi belirtirseniz, ��kt�s�n�, pencere iletisidir "Kategori: iletinin." �rne�in a�a��daki kodu ilk sat�r� g�r�nt�ler "alan: pencere ��esi �r�n ad� oldu�u" ��kt� penceresini:
Debug.WriteLine("The product name is " + sProdName,"Field"); Debug.WriteLine("The units on hand are" + iUnitQty,"Field"); Debug.WriteLine("The per unit cost is" + dUnitCost.ToString(),"Field"); Debug.WriteLine("Total Cost is " + (iUnitQty * dUnitCost),"Calc");
Yaln�zca belirtilen bir ko�ul do�ru olarak hata ay�klama s�n�f�n�n WriteLineIf y�ntemini kullanarak de�erlendirilirse, ��kt� penceresi iletileri g�r�nt�leyebilirsiniz. De�erlendirilecek ko�ul WriteLineIf y�nteminin ilk giri� parametresidir. Ikinci parametre WriteLineIf, yaln�zca ilk parametresinde ko�ul do�ru olarak de�erlendirilirse, g�r�nt�lenen iletisidir.
Debug.WriteLineIf(iUnitQty > 50, "This message WILL appear"); Debug.WriteLineIf(iUnitQty < 50, "This message will NOT appear");
Hata ay�klama s�n�f�n�n Assert y�ntemini kullanabilir, b�ylece yaln�zca belirtilen bir ko�ul yanl�� olarak de�erlendirilirse Output penceresi, iletiyi g�r�nt�ler:
Debug.Assert(dUnitCost > 1, "Message will NOT appear"); Debug.Assert(dUnitCost < 1, "Message will appear since dUnitcost < 1 is false");

Konsol penceresi (tr1) ve <a1>Output.txt</a1> (tr2) adl� bir metin dosyas� i�in olmal�d�r nesneleri olu�turmak ve her nesnenin Debug dinleyiciler derlemesine ekleyin:

TextWriterTraceListener tr1 = new TextWriterTraceListener(System.Console.Out);
Debug.Listeners.Add(tr1);
        
TextWriterTraceListener tr2 = new TextWriterTraceListener(System.IO.File.CreateText("Output.txt"));
Debug.Listeners.Add(tr2);

Okunabilir olmas� i�in Debug s�n�f� olu�turur, izleyen iletiler i�in girintiyi kald�rmak i�in Unindent y�ntemini kullan�n. Azalt ve Unindent y�ntemleri kulland��n�zda, okuyucu ��k�� grubunu.
Debug.Unindent(); Debug.WriteLine("Debug Information-Product Ending");
ay�rt
T�m ��kt�y� her dinleyicisi nesne almas�n� sa�lamak i�in <a0></a0>, hata ay�klama s�n�f� arabellekleri i�in Flush y�ntemi �a�r�s�:
Debug.Flush();

�ste

Izleme s�n�f'� kullanma

Izleme s�n�f� iletileri olu�turmak i�in bu uygulaman�n y�r�t�lmesi monit�r de kullan�labilir. Izleme ve hata ay�klama s�n�flar�, a�a��dakiler de dahil olmak �zere bir ��kt� olu�turmak i�in ayn� y�ntemlerin �o�u Payla�t�r:

Console.WriteLine
WriteLineIf
Girinti
Unindent
Onaylama i�lemi
Temizleme

Izleme ve hata ay�klama s�n�flar� ayr� ayr� veya birlikte ayn� uygulamada kullanabilirsiniz. Hata ay�klama Solution yap�land�rma projesinde, izleme hem de hata ay�klama ��k�� etkindir. Proje ��k�� her ikisini de bu s�n�flar�n t�m dinleyicisi nesneleri olu�turur. Ancak bir yay�n Solution yap�land�rma proje izleme bir s�n�ftan yaln�zca ��kt� olu�turur. Hata ay�klama s�n�f y�ntemi etkinle�tirilmelerinde Release Solution yap�land�rma proje yoksayar.

Trace.WriteLine("Trace Information-Product Starting ");
Trace.Indent();

Trace.WriteLine("The product name is "+sProdName);
Trace.WriteLine("The product name is"+sProdName,"Field" );
Trace.WriteLineIf(iUnitQty > 50, "This message WILL appear");
Trace.Assert(dUnitCost > 1, "Message will NOT appear");
        
Trace.Unindent();
Trace.WriteLine("Trace Information-Product Ending");

Trace.Flush();

Console.ReadLine();

�ste

It Works That do�rulay�n.

Hata ay�klama ge�erli ��z�m yap�land�rmas� oldu�undan emin olun.
Solution Explorer (��z�m Gezgini) penceresinde g�r�n�r durumda de�ilse, bu pencereyi g�r�nt�lemek i�in CTRL + ALT + N tu� birle�imine bas�n.
ConInfo ' � sa� t�klat�n ve sonra da Properties ' i t�klat�n.
ConInfo �zellik sayfas�ndaki yap�land�rma klas�r� alt�nda sol b�lmede oku, hata ay�klama i�in i�aret etti�inden emin olun.

NotDebug, Visual C# 2005 ve Visual C# 2005 Express Edition conInfo sayfay� t�klat�n.
Yap�land�rma a��lan - listesinde a�a�� yap�land�rma klas�r�n �st�nde t�klat�n Active (hata ay�klama) veya hata ay�klama ve Tamam ' � t�klat�n. Visual C# 2005 ve Visual C# 2005 Express Edition Debughata ay�klama sayfas�nda <a1>yap�land�rma</a1> a?a?? a�?lan liste kutusunda <a0><a1>Etkin</a1> (hata ay�klama) veya</a0>'� t�klat�n ve sonra Dosya men�s�nde Kaydet ' i t�klat�n.
��kt� penceresini g�r�nt�lemek i�in CTRL + ALT + O tu�lar�na bas�n.
Kodu �al��t�rmak i�in F5 tu�una bas�n. Onaylama i�lemi ba�ar�s�z ileti�im kutusu g�r�nt�lendi�inde, Yoksay ' � t�klat�n.

Konsol penceresinde, ENTER tu�una bas�n. Program biti� ve ��kt� penceresinde a�a��dakine benzer bir ��kt� g�r�nt�lemelidir

    Debug Information-Product Starting 
    The product name is Widget
    The available units on hand are100
    The per unit cost is 1.03
    System.Xml.XmlDocument
    Field: The product name is Widget
    Field: The units on hand are100
    Field: The per unit cost is1.03
    Calc: Total Cost is  103
    This message WILL appear
    ---- DEBUG ASSERTION FAILED ----
---- Assert Short Message ----
Message will appear since dUnitcost  < 1 is false
---- Assert Long Message ----


    at Class1.Main(String[] args)  <%Path%>\class1.cs(34)

    The product name is Widget
    The available units on hand are100
    The per unit cost is 1.03
Debug Information-Product Ending
Trace Information-Product Starting 
    The product name is Widget
    Field: The product name isWidget
    This message WILL appear
Trace Information-Product Ending

Konsol penceresi ve Output.txt dosyas�n� a�a��daki ��kt�y� g�r�nt�lenmelidir:

The product name is Widget
    The available units on hand are 100
    The per unit cost is 1.03
Debug Information-Product Ending
Trace Information-Product Starting 
    The product name is Widget
    Field: The product name is Widget
    This message WILL appear
Trace Information-Product Ending

Not Output.txt dosya conInfo y�r�t�lebilir (conInfo.exe) ile ayn� dizinde bulunur. Genellikle, bu projenin kaynak nerede depoland��n� \bin klas�rd�r. Varsay�lan olarak, bu, C:\Documents and Settings\ User login Documents\Microsoft Studio Projects\conInfo\bin. Visual C# 2005 ve Visual C# 2005 Express Edition Output.txt dosyas� a�a��daki klas�rde bulunur:

C:\Documents and Settings\ User login Documents\Microsoft Studio 2005\Projects\conInfo\conInfo\bin\Debug

�ste

Kod tamamlamak listesi

   using System;
   using System.Diagnostics;

   class Class1
   {
      [STAThread]
      static void Main(string[] args)
      {
         string sProdName = "Widget";
         int iUnitQty = 100;
         double  dUnitCost = 1.03;
         Debug.WriteLine("Debug Information-Product Starting ");
         Debug.Indent();
         Debug.WriteLine("The product name is "+sProdName);
         Debug.WriteLine("The available units on hand are"+iUnitQty.ToString());
         Debug.WriteLine("The per unit cost is "+ dUnitCost.ToString());

         System.Xml.XmlDocument oxml = new System.Xml.XmlDocument();
         Debug.WriteLine(oxml);

         Debug.WriteLine("The product name is "+sProdName,"Field");
         Debug.WriteLine("The units on hand are"+iUnitQty,"Field");
         Debug.WriteLine("The per unit cost is"+dUnitCost.ToString(),"Field");
         Debug.WriteLine("Total Cost is  "+(iUnitQty * dUnitCost),"Calc");

         Debug.WriteLineIf(iUnitQty > 50, "This message WILL appear");
         Debug.WriteLineIf(iUnitQty < 50, "This message will NOT appear");

         Debug.Assert(dUnitCost > 1, "Message will NOT appear");
         Debug.Assert(dUnitCost < 1, "Message will appear since dUnitcost  < 1 is false");

         TextWriterTraceListener tr1 = new TextWriterTraceListener(System.Console.Out);
         Debug.Listeners.Add(tr1);
        
         TextWriterTraceListener tr2 = new TextWriterTraceListener(System.IO.File.CreateText("Output.txt"));
         Debug.Listeners.Add(tr2);
         
 
         Debug.WriteLine("The product name is "+sProdName);
         Debug.WriteLine("The available units on hand are"+iUnitQty);
         Debug.WriteLine("The per unit cost is "+dUnitCost);
         Debug.Unindent();
         Debug.WriteLine("Debug Information-Product Ending");
         Debug.Flush();
         
         Trace.WriteLine("Trace Information-Product Starting ");
         Trace.Indent();

         Trace.WriteLine("The product name is "+sProdName);
         Trace.WriteLine("The product name is"+sProdName,"Field" );
         Trace.WriteLineIf(iUnitQty > 50, "This message WILL appear");
         Trace.Assert(dUnitCost > 1, "Message will NOT appear");
        

         Trace.Unindent();
         Trace.WriteLine("Trace Information-Product Ending");

         Trace.Flush();

         Console.ReadLine();
      }			
   }

�ste

Sorun Giderme

��z�m yap�land�rma t�r� Release ise, Debug s�n�f� ��k�� g�z ard� edilir.
Belirli bir hedef i�in bir olmal�d�r s�n�f� olu�turduktan sonra izleme ve hata ay�klama s�n�flar� olmal�d�r ��k�� al�r. Bu, izleme veya hata ay�klama s�n�f�, <a2>Add</a2> y�ntemini olmal�d�rdinleyiciler s�n�f�na eklemek i�in kullan�p ba��ms�z olarak ger�ekle�ir.

Izleme ve hata ay�klama s�n�flar� i�in ayn� hedef bir dinleyiciler nesnesi eklerseniz, olup hata ay�klama veya izleme ��k�� olu�turur ba��ms�z olarak her ��kt� sat�r�n�n yineleniyor.

         TextWriterTraceListener myWriter = new TextWriterTraceListener(System.Console.Out);
         Debug.Listeners.Add(myWriter);
        
         TextWriterTraceListener myCreator = new TextWriterTraceListener(System.Console.Out);
         Trace.Listeners.Add(myCreator);

�ste

Referanslar

Daha fazla bilgi i�in bkz: a�a��daki konular, .NET Framework s�n�f kitapl�� belgeler:

S�n�f izleme
http://msdn2.microsoft.com/en-us/library/system.diagnostics.trace(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.diagnostics.trace(vs.71).aspx)

S�n�f hata ay�klama
http://msdn2.microsoft.com/en-us/library/system.diagnostics.debug(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.diagnostics.debug(vs.71).aspx)

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft Visual C# 2008 Express Edition
Microsoft Visual C# 2005 Express Edition
Microsoft Visual C# 2005
Microsoft Visual C# .NET 2003 Standard Edition
Microsoft Visual C# .NET 2002 Standard Edition

�ste

kbmt kbprogramming kbdebug kbnamespace kbhowtomaster KB815788 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:815788� (http://support.microsoft.com/kb/815788/en-us/ )

�ste

This site in other countries/regions:

Izleme ve Visual C# ile hata ay�klama hakk�nda

Bu Sayfada

�zet

Gereksinimler

Teknik of a��klamas�

Ile <a2>debug</a2> s�n�f �rne�i olu�turma

Izleme s�n�f'� kullanma

It Works That do�rulay�n.

Kod tamamlamak listesi

Sorun Giderme

Referanslar

Bu makaledeki bilginin uyguland�� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

�lgili Destek Merkezleri

This site in other countries/regions:

Izleme ve Visual C# ile hata ay�klama hakk�nda

Bu Sayfada

�zet

Gereksinimler

Teknik of a��klamas�

Ile <a2>debug</a2> s�n�f �rne�i olu�turma

Izleme s�n�f'� kullanma

It Works That do�rulay�n.

Kod tamamlamak listesi

Sorun Giderme

Referanslar

Bu makaledeki bilginin uyguland��� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

�lgili Destek Merkezleri

Bu makaledeki bilginin uyguland�� durum: