Trace.Assert Trace.Assert Trace.Assert Trace.Assert Method

Определение

Проверяет условие; если условие имеет значение false, выводит сообщения и отображает окно сообщения со стеком вызовов.Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

Перегрузки

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Проверяет условие; если условие имеет значение false, выводит сообщение, отображающее стек вызовов.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

Проверяет условие. Если условие имеет значение false, выдается указанное сообщение и отображается окно сообщения со стеком вызовов.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) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

Проверяет условие; если условие имеет значение false, выводит два указанных сообщения и отображает окно сообщения со стеком вызовов.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) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Проверяет условие; если условие имеет значение false, выводит сообщение, отображающее стек вызовов.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);
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)

Параметры

condition
Boolean Boolean Boolean Boolean

Условное выражение для вычисления.The conditional expression to evaluate. Если условие имеет значение true, сообщение о сбое не отправляется и окно сообщения не отображается.If the condition is true, a failure message is not sent and the message box is not displayed.

Примеры

В следующем примере создается индекс для массива.The following example creates an index for an array. Затем выполняется какое-либо действие, которое задает значение индекса.Then some action is performed that sets the value of the index. Затем код вызывает Assert для проверки индекса значение является допустимым.Next the code calls Assert to verify the index value is valid. Если оно является недопустимым, Assert выводит стек вызовов.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

Комментарии

Используйте Trace.Assert создает метод, если вы хотите сделать утверждения в выпуске.Use the Trace.Assert method if you want to do assertions in release builds. Debug.Assert Метод работает только в отладочных сборках.The Debug.Assert method works only in debug builds. Дополнительные сведения см. в разделе Утверждения в управляемом коде.For more information, see Assertions in Managed Code.

Как правило Assert(Boolean) метод используется для выявления ошибок логики во время разработки программ.Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assert(Boolean) оценивает условие.Assert(Boolean) evaluates the condition. Если результат равен false, он отправляет сообщение о сбое для Listeners коллекции.If the result is false, it sends a failure message to the Listeners collection. Это поведение можно настроить, добавив TraceListener , или удалить одну из, Listeners коллекции.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

При выполнении приложения в режиме пользовательского интерфейса отображается окно сообщения, в котором показан стек вызовов с номерами файла и строки.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. Окно сообщения содержит три кнопки: Прервать, повторите, и игнорировать.The message box contains three buttons: Abort, Retry, and Ignore. Щелкнув прервать кнопка завершает работу приложения.Clicking the Abort button terminates the application. Щелкнув повторите отправляет вам к коду в отладчике, если приложение выполняется в отладчике, или предлагает открыть отладчик, если это не.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. Щелкнув пропустить продолжает выполняться с использованием следующей инструкции в коде.Clicking Ignore continues with the next instruction in the code.

Примечание

Отображение окна сообщения зависит от наличия DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Если DefaultTraceListener не находится в Listeners коллекция, окно сообщения не отображается.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListener Можно удалить с <снимите>, <удалить>, или путем вызова Clear метод Listeners свойство (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()).

Можно изменить поведение DefaultTraceListener в файле конфигурации, который соответствует имени приложения.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. В этом файле можно включить и отключить в окне сообщения assert или DefaultTraceListener.LogFileName свойство.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Файл конфигурации должен быть следующий формат: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>  
Дополнительно

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

Проверяет условие. Если условие имеет значение false, выдается указанное сообщение и отображается окно сообщения со стеком вызовов.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);
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

Параметры

condition
Boolean Boolean Boolean Boolean

Условное выражение для вычисления.The conditional expression to evaluate. Если условие имеет значение true, указанное сообщение не отправляется и окно сообщения не отображается.If the condition is true, the specified message is not sent and the message box is not displayed.

message
String String String String

Сообщение для отправки в коллекцию Listeners.The message to send to the Listeners collection.

Примеры

В следующем примере проверяется, чтобы убедиться, что type параметр является допустимым.The following example checks to see that the type parameter is valid. Если type переданный является null, Assert выводит сообщение.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

Комментарии

Используйте Trace.Assert создает метод, если вы хотите сделать утверждения в выпуске.Use the Trace.Assert method if you want to do assertions in release builds. Debug.Assert Метод работает только в отладочных сборках.The Debug.Assert method works only in debug builds. Дополнительные сведения см. в разделе Утверждения в управляемом коде.For more information, see Assertions in Managed Code.

Как правило Assert(Boolean, String) метод используется для выявления ошибок логики во время разработки программ.Typically, the Assert(Boolean, String) method is used to identify logic errors during program development. Assert(Boolean, String) оценивает условие.Assert(Boolean, String) evaluates the condition. Если результат равен false, он отправляет указанное сообщение диагностики для Listeners коллекции.If the result is false, it sends the specified diagnostic message to the Listeners collection. Это поведение можно настроить, добавив TraceListener , или удалить одну из, Listeners коллекции.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

При выполнении приложения в режиме пользовательского интерфейса отображается окно сообщения, в котором показан стек вызовов с номерами файла и строки.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. Окно сообщения содержит три кнопки: Прервать, повторите, и игнорировать.The message box contains three buttons: Abort, Retry, and Ignore. Щелкнув прервать кнопка завершает работу приложения.Clicking the Abort button terminates the application. Щелкнув повторите отправляет вам к коду в отладчике, если приложение выполняется в отладчике, или предлагает открыть отладчик, если это не.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. Щелкнув пропустить продолжает выполняться с использованием следующей инструкции в коде.Clicking Ignore continues with the next instruction in the code.

Примечание

Отображение окна сообщения зависит от наличия DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Если DefaultTraceListener не находится в Listeners коллекция, окно сообщения не отображается.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListener Можно удалить с <снимите>, <удалить>, или путем вызова Clear метод Listeners свойство (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()).

Можно изменить поведение DefaultTraceListener в файле конфигурации, который соответствует имени приложения.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. В этом файле можно включить и отключить в окне сообщения assert или DefaultTraceListener.LogFileName свойство.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Файл конфигурации должен быть следующий формат: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>  
Дополнительно

Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

Проверяет условие; если условие имеет значение false, выводит два указанных сообщения и отображает окно сообщения со стеком вызовов.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);
static member Assert : bool * string * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Параметры

condition
Boolean Boolean Boolean Boolean

Условное выражение для вычисления.The conditional expression to evaluate. Если условие имеет значение true, указанные сообщения не отправляются и окно сообщения не отображается.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String String String String

Сообщение для отправки в коллекцию Listeners.The message to send to the Listeners collection.

detailMessage
String String String String

Подробное сообщение, которое следует отправить в коллекцию Listeners.The detailed message to send to the Listeners collection.

Примеры

В следующем примере проверяется, чтобы убедиться, что type параметр является допустимым.The following example checks to see that the type parameter is valid. Если type переданный является null, Assert выводит сообщение.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

Комментарии

Используйте Trace.Assert создает метод, если вы хотите сделать утверждения в выпуске.Use the Trace.Assert method if you want to do assertions in release builds. Debug.Assert Метод работает только в отладочных сборках.The Debug.Assert method works only in debug builds. Дополнительные сведения см. в разделе Утверждения в управляемом коде.For more information, see Assertions in Managed Code.

Как правило Assert(Boolean, String, String) метод используется для выявления ошибок логики во время разработки программ.Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assert оценивает условие.Assert evaluates the condition. Если результат равен false, он отправляет указанный диагностическое сообщение и подробное сообщение Listeners коллекции.If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. Это поведение можно настроить, добавив TraceListener , или удалить одну из, Listeners коллекции.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

При выполнении приложения в режиме пользовательского интерфейса отображается окно сообщения, в котором показан стек вызовов с номерами файла и строки.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. Окно сообщения содержит три кнопки: Прервать, повторите, и игнорировать.The message box contains three buttons: Abort, Retry, and Ignore. Щелкнув прервать кнопка завершает работу приложения.Clicking the Abort button terminates the application. Щелкнув повторите отправляет вам к коду в отладчике, если приложение выполняется в отладчике, или предлагает открыть отладчик, если это не.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. Щелкнув пропустить продолжает выполняться с использованием следующей инструкции в коде.Clicking Ignore continues with the next instruction in the code.

Примечание

Отображение окна сообщения зависит от наличия DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Если DefaultTraceListener не находится в Listeners коллекция, окно сообщения не отображается.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListener Можно удалить с <снимите>, <удалить>, или путем вызова Clear метод Listeners свойство (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()).

Можно изменить поведение DefaultTraceListener в файле конфигурации, который соответствует имени приложения.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. В этом файле можно включить и отключить в окне сообщения assert или DefaultTraceListener.LogFileName свойство.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Файл конфигурации должен быть следующий формат: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>  
Дополнительно

Применяется к