Trace.Assert Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Diagnostics

Zestaw:: System.Diagnostics.TraceSource.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Przeciążenia

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

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")]
public static void Assert (bool condition);

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

Public Shared Sub Assert (condition As Boolean)

Parametry

condition: Boolean

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

Atrybuty: ConditionalAttribute

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 to nieprawidłowe, Assert dane wyjściowe stosu wywołań.

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

Uwagi

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

Zazwyczaj metoda służy do identyfikowania Assert(Boolean) 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 z tej kolekcji.

Po uruchomieniu aplikacji w trybie interfejsu użytkownika zostanie wyświetlone pole komunikatu pokazujące stos 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 do kodu w debugerze, jeśli aplikacja jest uruchomiona w debugerze lub oferuje otwarcie debugera, jeśli tak nie jest. Kliknięcie pozycji Ignoruj będzie kontynuowane przy użyciu następnej instrukcji w kodzie.

Uwaga

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

W przypadku .NET Framework aplikacji można zmienić zachowanie DefaultTraceListener pliku konfiguracji odpowiadającego nazwie aplikacji. W tym pliku można włączyć i wyłączyć pole komunikatu asertywnego 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ż

Dotyczy

Assert(Boolean, String)

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

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)

Parametry

condition: Boolean

Wyrażenie warunkowe do oceny. Jeśli warunek to true, określona wiadomość nie zostanie wysłana, a pole komunikatu nie zostanie wyświetlone.

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, dane Assert wyjściowe komunikatu.

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

Uwagi

Zazwyczaj metoda służy do identyfikowania Assert(Boolean, String) 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 z tej kolekcji.

Uwaga

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

Dotyczy

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

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)

Parametry

condition: Boolean

Wyrażenie warunkowe do oceny. 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, dane Assert wyjściowe komunikatu.

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

Uwagi

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

Uwaga

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

Dotyczy

Trace.Assert Metoda

Definicja

Przeciążenia

Assert(Boolean)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, String)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, String, String)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby