Trace.Assert Yöntem

Tanım

Bir koşulu denetler; Koşul ise false , iletiler verir ve çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

Aşırı Yüklemeler

Assert(Boolean)

Bir koşulu denetler; Koşul ise false , çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String)

Bir koşulu denetler; Koşul ise false , belirtilen bir ileti verir ve çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String)

Bir koşulu denetler; Koşul ise false , belirtilen iki iletiyi verir ve çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Assert(Boolean)

Bir koşulu denetler; Koşul ise false , çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

public:
 static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition);
[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)

Parametreler

condition
Boolean

Değerlendirilecek koşullu ifade.The conditional expression to evaluate. Koşul ise true , bir hata iletisi gönderilmez ve ileti kutusu gösterilmez.If the condition is true, a failure message is not sent and the message box is not displayed.

Öznitelikler

Örnekler

Aşağıdaki örnek, bir dizi için dizin oluşturur.The following example creates an index for an array. Sonra, dizinin değerini ayarlayan bazı eylemler gerçekleştirilir.Then some action is performed that sets the value of the index. Ardından, Assert Dizin değerini doğrulamak için kod çağrıları geçerlidir.Next the code calls Assert to verify the index value is valid. Geçerli değilse, Assert çağrı yığınını çıktı olarak verir.If it is not valid, the Assert outputs the call stack.

protected:
   // Create an index for an array.
   int index;

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }
// Create an index for an array.
 protected int index;

 protected void Method()
 {
 // Perform some action that sets the index.

 // Test that the index value is valid.
 Trace.Assert(index > -1);
 }
' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

Açıklamalar

Trace.AssertYayın Derlemeleriyle onaylama işlemleri yapmak istiyorsanız yöntemini kullanın.Use the Trace.Assert method if you want to do assertions in release builds. Debug.AssertYöntemi yalnızca hata ayıklama yapılarında işe yarar.The Debug.Assert method works only in debug builds. Daha fazla bilgi için bkz. Yönetilen koddaki Onaylamalar.For more information, see Assertions in Managed Code.

Genellikle, Assert(Boolean) yöntemi program geliştirme sırasında mantık hatalarını belirlemek için kullanılır.Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assert(Boolean) koşulu değerlendirir.Assert(Boolean) evaluates the condition. Sonuç ise false , koleksiyona bir hata iletisi gönderir Listeners .If the result is false, it sends a failure message to the Listeners collection. Bu davranışı TraceListener , koleksiyona bir öğesine bir veya öğesini kaldırarak özelleştirebilirsiniz Listeners .You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Uygulama kullanıcı arabirimi modunda çalıştığında, çağrı yığınını dosya ve satır numaralarıyla gösteren bir ileti kutusu görüntüler.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. İleti kutusu üç düğme içerir: Abort, retry ve Ignore.The message box contains three buttons: Abort, Retry, and Ignore. Durdur düğmesine tıklamak uygulamayı sonlandırır.Clicking the Abort button terminates the application. Yeniden dene ' ye tıklamak, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda sizi gönderir veya yoksa bir hata ayıklayıcı açmak için teklifleri sunar.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Yoksay öğesine tıkladığınızda koddaki sonraki yönergeyle devam edilir.Clicking Ignore continues with the next instruction in the code.

Not

İleti kutusunun görüntülenmesi, ' nin varlığına bağlıdır DefaultTraceListener .The display of the message box depends on the presence of the DefaultTraceListener. DefaultTraceListener Listeners Koleksiyonda değilse ileti kutusu görüntülenmez.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. , DefaultTraceListener < Clear > , < Remove > veya Clear Listeners Property () üzerinde yöntemi çağırarak Kaldırılabilir System.Diagnostics.Trace.Listeners.Clear() .The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

DefaultTraceListenerUygulamanızın adına karşılık gelen yapılandırma dosyasında öğesinin davranışını değiştirebilirsiniz.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Bu dosyada, onaylama ileti kutusunu etkinleştirebilir ve devre dışı bırakabilir veya DefaultTraceListener.LogFileName özelliğini ayarlayabilirsiniz.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Yapılandırma dosyası şu şekilde biçimlendirilmelidir:The configuration file should be formatted as follows:

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>  

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String)

Bir koşulu denetler; Koşul ise false , belirtilen bir ileti verir ve çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

Parametreler

condition
Boolean

Değerlendirilecek koşullu ifade.The conditional expression to evaluate. Koşul ise true , belirtilen ileti gönderilmez ve ileti kutusu görüntülenmez.If the condition is true, the specified message is not sent and the message box is not displayed.

message
String

Koleksiyona göndermek için ileti Listeners .The message to send to the Listeners collection.

Öznitelikler

Örnekler

Aşağıdaki örnek, type parametresinin geçerli olup olmadığını denetler.The following example checks to see that the type parameter is valid. Geçirilen, type ise null Assert bir ileti verir.If the type passed in is null, the Assert outputs a message.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }
public static void MyMethod(Type type, Type baseType) {
    Trace.Assert(type != null, "Type parameter is null");

   // Perform some processing.
 }

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

Açıklamalar

Trace.AssertYayın Derlemeleriyle onaylama işlemleri yapmak istiyorsanız yöntemini kullanın.Use the Trace.Assert method if you want to do assertions in release builds. Debug.AssertYöntemi yalnızca hata ayıklama yapılarında işe yarar.The Debug.Assert method works only in debug builds. Daha fazla bilgi için bkz. Yönetilen koddaki Onaylamalar.For more information, see Assertions in Managed Code.

Genellikle, Assert(Boolean, String) yöntemi program geliştirme sırasında mantık hatalarını belirlemek için kullanılır.Typically, the Assert(Boolean, String) method is used to identify logic errors during program development. Assert(Boolean, String) koşulu değerlendirir.Assert(Boolean, String) evaluates the condition. Sonuç ise false , belirtilen tanılama iletisini Listeners koleksiyona gönderir.If the result is false, it sends the specified diagnostic message to the Listeners collection. Bu davranışı TraceListener , koleksiyona bir öğesine bir veya öğesini kaldırarak özelleştirebilirsiniz Listeners .You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Uygulama kullanıcı arabirimi modunda çalıştığında, çağrı yığınını dosya ve satır numaralarıyla gösteren bir ileti kutusu görüntüler.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. İleti kutusu üç düğme içerir: Abort, retry ve Ignore.The message box contains three buttons: Abort, Retry, and Ignore. Durdur düğmesine tıklamak uygulamayı sonlandırır.Clicking the Abort button terminates the application. Yeniden dene ' ye tıklamak, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda sizi gönderir veya yoksa bir hata ayıklayıcı açmak için teklifleri sunar.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Yoksay öğesine tıkladığınızda koddaki sonraki yönergeyle devam edilir.Clicking Ignore continues with the next instruction in the code.

Not

İleti kutusunun görüntülenmesi, ' nin varlığına bağlıdır DefaultTraceListener .The display of the message box depends on the presence of the DefaultTraceListener. DefaultTraceListener Listeners Koleksiyonda değilse ileti kutusu görüntülenmez.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. , DefaultTraceListener < Clear > , < Remove > veya Clear Listeners Property () üzerinde yöntemi çağırarak Kaldırılabilir System.Diagnostics.Trace.Listeners.Clear() .The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

DefaultTraceListenerUygulamanızın adına karşılık gelen yapılandırma dosyasında öğesinin davranışını değiştirebilirsiniz.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Bu dosyada, onaylama ileti kutusunu etkinleştirebilir ve devre dışı bırakabilir veya DefaultTraceListener.LogFileName özelliğini ayarlayabilirsiniz.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Yapılandırma dosyası şu şekilde biçimlendirilmelidir:The configuration file should be formatted as follows:

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>  

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String, String)

Bir koşulu denetler; Koşul ise false , belirtilen iki iletiyi verir ve çağrı yığınını gösteren bir ileti kutusu görüntüler.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string? message, string? detailMessage);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message, string detailMessage);
[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Parametreler

condition
Boolean

Değerlendirilecek koşullu ifade.The conditional expression to evaluate. Koşul ise true , belirtilen iletiler gönderilmez ve ileti kutusu görüntülenmez.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String

Koleksiyona göndermek için ileti Listeners .The message to send to the Listeners collection.

detailMessage
String

Koleksiyona göndermek için ayrıntılı ileti Listeners .The detailed message to send to the Listeners collection.

Öznitelikler

Örnekler

Aşağıdaki örnek, type parametresinin geçerli olup olmadığını denetler.The following example checks to see that the type parameter is valid. Geçirilen, type ise null Assert bir ileti verir.If the type passed in is null, the Assert outputs a message.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }
public static void MyMethod(Type type, Type baseType) {
    Trace.Assert(type != null, "Type parameter is null",
       "Can't get object for null type");

   // Perform some processing.
 }

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null", _
        "Can't get object for null type")

    ' Perform some processing.
End Sub

Açıklamalar

Trace.AssertYayın Derlemeleriyle onaylama işlemleri yapmak istiyorsanız yöntemini kullanın.Use the Trace.Assert method if you want to do assertions in release builds. Debug.AssertYöntemi yalnızca hata ayıklama yapılarında işe yarar.The Debug.Assert method works only in debug builds. Daha fazla bilgi için bkz. Yönetilen koddaki Onaylamalar.For more information, see Assertions in Managed Code.

Genellikle, Assert(Boolean, String, String) yöntemi program geliştirme sırasında mantık hatalarını belirlemek için kullanılır.Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assert koşulu değerlendirir.Assert evaluates the condition. Sonuç ise false , belirtilen tanılama iletisini ve ayrıntılı iletiyi Listeners koleksiyona gönderir.If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. Bu davranışı TraceListener , koleksiyona bir öğesine bir veya öğesini kaldırarak özelleştirebilirsiniz Listeners .You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Uygulama kullanıcı arabirimi modunda çalıştığında, çağrı yığınını dosya ve satır numaralarıyla gösteren bir ileti kutusu görüntüler.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. İleti kutusu üç düğme içerir: Abort, retry ve Ignore.The message box contains three buttons: Abort, Retry, and Ignore. Durdur düğmesine tıklamak uygulamayı sonlandırır.Clicking the Abort button terminates the application. Yeniden dene ' ye tıklamak, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda sizi gönderir veya yoksa bir hata ayıklayıcı açmak için teklifleri sunar.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Yoksay öğesine tıkladığınızda koddaki sonraki yönergeyle devam edilir.Clicking Ignore continues with the next instruction in the code.

Not

İleti kutusunun görüntülenmesi, ' nin varlığına bağlıdır DefaultTraceListener .The display of the message box depends on the presence of the DefaultTraceListener. DefaultTraceListener Listeners Koleksiyonda değilse ileti kutusu görüntülenmez.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. , DefaultTraceListener < Clear > , < Remove > veya Clear Listeners Property () üzerinde yöntemi çağırarak Kaldırılabilir System.Diagnostics.Trace.Listeners.Clear() .The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

DefaultTraceListenerUygulamanızın adına karşılık gelen yapılandırma dosyasında öğesinin davranışını değiştirebilirsiniz.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Bu dosyada, onaylama ileti kutusunu etkinleştirebilir ve devre dışı bırakabilir veya DefaultTraceListener.LogFileName özelliğini ayarlayabilirsiniz.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Yapılandırma dosyası şu şekilde biçimlendirilmelidir:The configuration file should be formatted as follows:

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>  

Ayrıca bkz.

Şunlara uygulanır