Trace.Assert Метод

Ссылка

Определение

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

Сборка:: System.Diagnostics.TraceSource.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

Assert(Boolean)

Исходный код:: Trace.cs

Исходный код:: Trace.cs

Исходный код:: Trace.cs

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

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)

Параметры

condition: Boolean

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

Атрибуты: ConditionalAttribute

Примеры

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

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

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

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

Assert(Boolean, String)

Исходный код:: Trace.cs

Исходный код:: Trace.cs

Исходный код:: Trace.cs

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

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)

Параметры

condition: Boolean

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

message: String

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

Атрибуты: ConditionalAttribute

Примеры

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

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

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

Примечание

<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)

Исходный код:: Trace.cs

Исходный код:: Trace.cs

Исходный код:: 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")]
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

Примеры

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

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

Примечание

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

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

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

Поделиться через

Trace.Assert Метод

Определение

Перегрузки

Assert(Boolean)

Параметры

Примеры

Комментарии

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

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

Assert(Boolean, String)

Параметры

Примеры

Комментарии

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

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

Assert(Boolean, String, String)

Параметры

Примеры

Комментарии

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

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

Дополнительные ресурсы