Trace.Assert Метод

Определение

Пространство имен:

System.Diagnostics

Сборки:

netstandard.dll, System.Diagnostics.TraceSource.dll

Проверка условия; Если условие равно false, выводит сообщения и отображает окно сообщения, отображающее стек вызовов.

Перегрузки

Имя	Описание
Assert(Boolean)	Проверка условия; Если условие задано false, отображается окно сообщения, в котором показан стек вызовов.
Assert(Boolean, String)	Проверка условия; Если условие равно false, выводит указанное сообщение и отображает окно сообщения, отображающее стек вызовов.
Assert(Boolean, String, String)	Проверка условия; Если условие равно false, выводит два указанных сообщения и отображает окно сообщения, отображающее стек вызовов.

Assert(Boolean)

Исходный код:

Trace.cs

Проверка условия; Если условие задано false, отображается окно сообщения, в котором показан стек вызовов.

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("TRACE")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

Параметры

condition

Boolean

Условное выражение для вычисления. Если условие задано true, сообщение об ошибке не отправляется, а поле сообщения не отображается.

Атрибуты

ConditionalAttribute OverloadResolutionPriorityAttribute

Примеры

В следующем примере создается индекс для массива. Затем выполняется некоторое действие, которое задает значение индекса. Далее вызывается Assert код для проверки допустимого значения индекса. Если это недопустимо, Assert выходные данные стека вызовов.

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

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 если вы хотите выполнить утверждения в сборках выпуска. Метод Debug.Assert работает только в отладочных сборках. Дополнительные сведения см. в разделе "Утверждения" в управляемом коде.

Как правило, Assert(Boolean) метод используется для выявления ошибок логики во время разработки программы. Assert(Boolean) вычисляет условие. Если результат есть false, он отправляет сообщение об ошибке в коллекцию Listeners . Это поведение можно настроить, добавив его TraceListener или удалив из Listeners коллекции.

При запуске приложения в режиме пользовательского интерфейса отображается окно сообщения, в котором показан стек вызовов с номерами файлов и строк. Поле сообщения содержит три кнопки: "Прерывание", " Повтор" и "Игнорировать". Нажатие кнопки "Прерывание " завершает работу приложения. Если приложение работает в отладчике, то при нажатии кнопки "Повторить попытку " вы отправляете код в отладчик или предлагает открыть отладчик, если он отсутствует. Нажатие кнопки "Игнорировать" продолжается со следующей инструкцией в коде.

Замечание

Отображение поля сообщения зависит от наличия DefaultTraceListener. Если объект DefaultTraceListener не находится в Listeners коллекции, окно сообщения не отображается. Его DefaultTraceListener можно удалить путем вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()). Для приложений .NET Framework можно также использовать <элемент clear> и <элемент remove> в файле конфигурации приложения.

Для приложений .NET Framework можно изменить поведение DefaultTraceListener файла конфигурации, соответствующего имени приложения. В этом файле можно включить и отключить поле сообщения утверждения или задать DefaultTraceListener.LogFileName свойство. Файл конфигурации должен быть отформатирован следующим образом:

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

См. также раздел

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Assert(Boolean, String)

Исходный код:

Trace.cs

Проверка условия; Если условие равно false, выводит указанное сообщение и отображает окно сообщения, отображающее стек вызовов.

public:
 static void Assert(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message = default);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string -> unit

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

Параметры

condition

Boolean

Условное выражение для вычисления. Если условие задано true, указанное сообщение не отправляется, а поле сообщения не отображается.

message

String

Сообщение для отправки в коллекцию Listeners .

Атрибуты

ConditionalAttribute

Примеры

В следующем примере проверяется, является ли параметр допустимым type . Если передано typenullсообщение, Assert выводится сообщение.

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 если вы хотите выполнить утверждения в сборках выпуска. Метод Debug.Assert работает только в отладочных сборках. Дополнительные сведения см. в разделе "Утверждения" в управляемом коде.

Как правило, Assert(Boolean, String) метод используется для выявления ошибок логики во время разработки программы. Assert(Boolean, String) вычисляет условие. Если результат имеет значение false, он отправляет указанное диагностическое сообщение в коллекцию Listeners . Это поведение можно настроить, добавив его TraceListener или удалив из Listeners коллекции.

При запуске приложения в режиме пользовательского интерфейса отображается окно сообщения, в котором показан стек вызовов с номерами файлов и строк. Поле сообщения содержит три кнопки: "Прерывание", " Повтор" и "Игнорировать". Нажатие кнопки "Прерывание " завершает работу приложения. Если приложение работает в отладчике, то при нажатии кнопки "Повторить попытку " вы отправляете код в отладчик или предлагает открыть отладчик, если он отсутствует. Нажатие кнопки "Игнорировать" продолжается со следующей инструкцией в коде.

Замечание

Отображение поля сообщения зависит от наличия DefaultTraceListener. Если объект DefaultTraceListener не находится в Listeners коллекции, окно сообщения не отображается. Его DefaultTraceListener можно удалить путем вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()). Для приложений .NET Framework можно также использовать <элемент clear> и <элемент remove> в файле конфигурации приложения.

Для приложений .NET Framework можно изменить поведение DefaultTraceListener файла конфигурации, соответствующего имени приложения. В этом файле можно включить и отключить поле сообщения утверждения или задать DefaultTraceListener.LogFileName свойство. Файл конфигурации должен быть отформатирован следующим образом:

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

См. также раздел

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Assert(Boolean, String, String)

Исходный код:

Trace.cs

Проверка условия; Если условие равно false, выводит два указанных сообщения и отображает окно сообщения, отображающее стек вызовов.

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")>]
static member Assert : bool * string * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Параметры

condition

Boolean

Условное выражение для вычисления. Если условие задано true, указанные сообщения не отправляются, а поле сообщения не отображается.

message

String

Сообщение для отправки в коллекцию Listeners .

detailMessage

String

Подробное сообщение для отправки в коллекцию Listeners .

Атрибуты

ConditionalAttribute

Примеры

В следующем примере проверяется, является ли параметр допустимым type . Если передано typenullсообщение, Assert выводится сообщение.

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 если вы хотите выполнить утверждения в сборках выпуска. Метод Debug.Assert работает только в отладочных сборках. Дополнительные сведения см. в разделе "Утверждения" в управляемом коде.

Как правило, Assert(Boolean, String, String) метод используется для выявления ошибок логики во время разработки программы. Assert вычисляет условие. Если результат имеет значение false, он отправляет указанное диагностическое сообщение и подробное сообщение в коллекцию Listeners . Это поведение можно настроить, добавив его TraceListener или удалив из Listeners коллекции.

При запуске приложения в режиме пользовательского интерфейса отображается окно сообщения, в котором показан стек вызовов с номерами файлов и строк. Поле сообщения содержит три кнопки: "Прерывание", " Повтор" и "Игнорировать". Нажатие кнопки "Прерывание " завершает работу приложения. Если приложение работает в отладчике, то при нажатии кнопки "Повторить попытку " вы отправляете код в отладчик или предлагает открыть отладчик, если он отсутствует. Нажатие кнопки "Игнорировать" продолжается со следующей инструкцией в коде.

Замечание

Отображение поля сообщения зависит от наличия DefaultTraceListener. Если объект DefaultTraceListener не находится в Listeners коллекции, окно сообщения не отображается. Его DefaultTraceListener можно удалить путем вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()). Для приложений .NET Framework можно также использовать <элемент clear> и <элемент remove> в файле конфигурации приложения.

Для приложений .NET Framework можно изменить поведение DefaultTraceListener файла конфигурации, соответствующего имени приложения. В этом файле можно включить и отключить поле сообщения утверждения или задать DefaultTraceListener.LogFileName свойство. Файл конфигурации должен быть отформатирован следующим образом:

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

См. также раздел

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute