Trace.Assert Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestawy:

netstandard.dll, System.Diagnostics.TraceSource.dll

Sprawdza warunek; jeśli warunek to false, generuje komunikaty i wyświetla pole komunikatu, które wyświetla stos wywołań.

Przeciążenia

Nazwa	Opis
Assert(Boolean)	Sprawdza warunek; jeśli warunek to false, wyświetla pole komunikatu, które pokazuje stos wywołań.
Assert(Boolean, String)	Sprawdza warunek; Jeśli warunek to false, zwraca określony komunikat i wyświetla pole komunikatu, które wyświetla stos wywołań.
Assert(Boolean, String, String)	Sprawdza warunek; Jeśli warunek to false, zwraca dwa określone komunikaty i wyświetla pole komunikatu, które pokazuje stos wywołań.

Assert(Boolean)

Źródło:

Trace.cs

Sprawdza warunek; jeśli warunek to false, wyświetla pole komunikatu, które pokazuje stos wywołań.

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)

Parametry

condition

Boolean

Wyrażenie warunkowe do obliczenia. Jeśli warunek to true, komunikat o niepowodzeniu nie jest wysyłany, a pole komunikatu nie jest wyświetlane.

Atrybuty

ConditionalAttribute OverloadResolutionPriorityAttribute

Przykłady

Poniższy przykład tworzy indeks dla tablicy. Następnie jest wykonywana pewna akcja, która ustawia wartość indeksu. Następnie wywołania kodu Assert w celu sprawdzenia, czy wartość indeksu jest prawidłowa. Jeśli jest on nieprawidłowy, Assert dane wyjściowe stosu wywołań.

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

Uwagi

Trace.Assert Użyj metody , jeśli chcesz wykonać asercji w kompilacjach wydania. Metoda Debug.Assert działa tylko w kompilacjach debugowania. Aby uzyskać więcej informacji, zobacz Asercje w kodzie zarządzanym.

Assert(Boolean) Zazwyczaj metoda służy do identyfikowania błędów logiki podczas opracowywania programu. Assert(Boolean) oblicza warunek. Jeśli wynik to false, wysyła komunikat o niepowodzeniu do kolekcji Listeners . To zachowanie można dostosować, dodając element TraceListener do kolekcji Listeners lub usuwając go.

Po uruchomieniu aplikacji w trybie interfejsu użytkownika zostanie wyświetlone pole komunikatu z stosem wywołań z plikami i numerami wierszy. Pole komunikatu zawiera trzy przyciski: Przerwanie, Ponów próbę i Ignoruj. Kliknięcie przycisku Przerwanie powoduje zakończenie aplikacji. Kliknięcie przycisku Ponów próbę spowoduje wysłanie cię do kodu w debugerze, jeśli aplikacja jest uruchomiona w debugerze lub oferuje otwarcie debugera, jeśli tak nie jest. Kliknięcie pozycji Ignoruj jest kontynuowane przy użyciu następnej instrukcji w kodzie.

Uwaga / Notatka

Wyświetlanie pola komunikatu zależy od obecności obiektu DefaultTraceListener. Jeśli element DefaultTraceListener nie znajduje się w Listeners kolekcji, okno komunikatu nie jest wyświetlane. Element DefaultTraceListener można usunąć, wywołując metodę ClearListeners we właściwości (System.Diagnostics.Trace.Listeners.Clear()). W przypadku aplikacji .NET Framework można również użyć <wyczyść> elementu i <elementu remove> w pliku konfiguracji aplikacji.

W przypadku aplikacji .NET Framework można zmienić zachowanie DefaultTraceListener elementu w pliku konfiguracji, który odpowiada nazwie aplikacji. W tym pliku można włączyć i wyłączyć pole komunikatu potwierdzenia lub ustawić DefaultTraceListener.LogFileName właściwość . Plik konfiguracji powinien być sformatowany w następujący sposób:

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

Zobacz też

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

Assert(Boolean, String)

Źródło:

Trace.cs

Sprawdza warunek; Jeśli warunek to false, zwraca określony komunikat i wyświetla pole komunikatu, które wyświetla stos wywołań.

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)

Parametry

condition

Boolean

Wyrażenie warunkowe do obliczenia. Jeśli warunek ma truewartość , określony komunikat nie jest wysyłany, a pole komunikatu nie jest wyświetlane.

message

String

Komunikat do wysłania do kolekcji Listeners .

Atrybuty

ConditionalAttribute

Przykłady

Poniższy przykład sprawdza, czy type parametr jest prawidłowy. Jeśli przekazana type wartość to null, Assert zwraca komunikat.

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

Uwagi

Trace.Assert Użyj metody , jeśli chcesz wykonać asercji w kompilacjach wydania. Metoda Debug.Assert działa tylko w kompilacjach debugowania. Aby uzyskać więcej informacji, zobacz Asercje w kodzie zarządzanym.

Assert(Boolean, String) Zazwyczaj metoda służy do identyfikowania błędów logiki podczas opracowywania programu. Assert(Boolean, String) oblicza warunek. Jeśli wynik to false, wysyła określony komunikat diagnostyczny do kolekcji Listeners . To zachowanie można dostosować, dodając element TraceListener do kolekcji Listeners lub usuwając go.

Po uruchomieniu aplikacji w trybie interfejsu użytkownika zostanie wyświetlone pole komunikatu z stosem wywołań z plikami i numerami wierszy. Pole komunikatu zawiera trzy przyciski: Przerwanie, Ponów próbę i Ignoruj. Kliknięcie przycisku Przerwanie powoduje zakończenie aplikacji. Kliknięcie przycisku Ponów próbę spowoduje wysłanie cię do kodu w debugerze, jeśli aplikacja jest uruchomiona w debugerze lub oferuje otwarcie debugera, jeśli tak nie jest. Kliknięcie pozycji Ignoruj jest kontynuowane przy użyciu następnej instrukcji w kodzie.

Uwaga / Notatka

Wyświetlanie pola komunikatu zależy od obecności obiektu DefaultTraceListener. Jeśli element DefaultTraceListener nie znajduje się w Listeners kolekcji, okno komunikatu nie jest wyświetlane. Element DefaultTraceListener można usunąć, wywołując metodę ClearListeners we właściwości (System.Diagnostics.Trace.Listeners.Clear()). W przypadku aplikacji .NET Framework można również użyć <wyczyść> elementu i <elementu remove> w pliku konfiguracji aplikacji.

W przypadku aplikacji .NET Framework można zmienić zachowanie DefaultTraceListener elementu w pliku konfiguracji, który odpowiada nazwie aplikacji. W tym pliku można włączyć i wyłączyć pole komunikatu potwierdzenia lub ustawić DefaultTraceListener.LogFileName właściwość . Plik konfiguracji powinien być sformatowany w następujący sposób:

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

Zobacz też

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

Assert(Boolean, String, String)

Źródło:

Trace.cs

Sprawdza warunek; Jeśli warunek to false, zwraca dwa określone komunikaty i wyświetla pole komunikatu, które pokazuje stos wywołań.

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)

Parametry

condition

Boolean

Wyrażenie warunkowe do obliczenia. Jeśli warunek to true, określone komunikaty nie są wysyłane, a pole komunikatu nie jest wyświetlane.

message

String

Komunikat do wysłania do kolekcji Listeners .

detailMessage

String

Szczegółowy komunikat do wysłania do kolekcji Listeners .

Atrybuty

ConditionalAttribute

Przykłady

Poniższy przykład sprawdza, czy type parametr jest prawidłowy. Jeśli przekazana type wartość to null, Assert zwraca komunikat.

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

Uwagi

Trace.Assert Użyj metody , jeśli chcesz wykonać asercji w kompilacjach wydania. Metoda Debug.Assert działa tylko w kompilacjach debugowania. Aby uzyskać więcej informacji, zobacz Asercje w kodzie zarządzanym.

Assert(Boolean, String, String) Zazwyczaj metoda służy do identyfikowania błędów logiki podczas opracowywania programu. Assert oblicza warunek. Jeśli wynikiem jest false, wysyła określony komunikat diagnostyczny i szczegółowy komunikat do kolekcji Listeners . To zachowanie można dostosować, dodając element TraceListener do kolekcji Listeners lub usuwając go.

Po uruchomieniu aplikacji w trybie interfejsu użytkownika zostanie wyświetlone pole komunikatu z stosem wywołań z plikami i numerami wierszy. Pole komunikatu zawiera trzy przyciski: Przerwanie, Ponów próbę i Ignoruj. Kliknięcie przycisku Przerwanie powoduje zakończenie aplikacji. Kliknięcie przycisku Ponów próbę spowoduje wysłanie cię do kodu w debugerze, jeśli aplikacja jest uruchomiona w debugerze lub oferuje otwarcie debugera, jeśli tak nie jest. Kliknięcie pozycji Ignoruj jest kontynuowane przy użyciu następnej instrukcji w kodzie.

Uwaga / Notatka

Wyświetlanie pola komunikatu zależy od obecności obiektu DefaultTraceListener. Jeśli element DefaultTraceListener nie znajduje się w Listeners kolekcji, okno komunikatu nie jest wyświetlane. Element DefaultTraceListener można usunąć, wywołując metodę ClearListeners we właściwości (System.Diagnostics.Trace.Listeners.Clear()). W przypadku aplikacji .NET Framework można również użyć <wyczyść> elementu i <elementu remove> w pliku konfiguracji aplikacji.

W przypadku aplikacji .NET Framework można zmienić zachowanie DefaultTraceListener elementu w pliku konfiguracji, który odpowiada nazwie aplikacji. W tym pliku można włączyć i wyłączyć pole komunikatu potwierdzenia lub ustawić DefaultTraceListener.LogFileName właściwość . Plik konfiguracji powinien być sformatowany w następujący sposób:

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

Zobacz też

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