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, zwraca komunikaty i wyświetla okno komunikatu, które pokazuje stos wywołań.

Przeciążenia

Assert(Boolean)	Sprawdza warunek; Jeśli warunek to `false`, wyświetla okno komunikatu, które pokazuje stos wywołań.
Assert(Boolean, String)	Sprawdza warunek; Jeśli warunek to `false`, zwraca określony komunikat i wyświetla okno 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 okno komunikatu, które pokazuje stos wywołań.

Assert(Boolean)

Źródło:: Trace.cs

Źródło:: Trace.cs

Źródło:: Trace.cs

Sprawdza warunek; Jeśli warunek to false, wyświetla okno 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 obliczenia. Jeśli warunek ma truewartość , komunikat o błędzie nie zostanie wysłany, a okno komunikatu nie zostanie wyświetlone.

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 Assert kodu w celu sprawdzenia, czy wartość indeksu jest prawidłowa. Jeśli jest on nieprawidłowy, 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

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 Asercji 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 błędzie do kolekcji Listeners . To zachowanie można dostosować, dodając TraceListener element do kolekcji lub usuwając go z kolekcji Listeners .

Gdy aplikacja działa w trybie interfejsu użytkownika, wyświetla okno komunikatu z stosem wywołań z plikami i numerami wierszy. Okno komunikatu zawiera trzy przyciski: Przerwij, Ponów próbę i Ignoruj. Kliknięcie przycisku Przerwij 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 jest kontynuowane przy użyciu następnej instrukcji w kodzie.

Uwaga

Wyświetlanie okna komunikatu zależy od obecności elementu 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ę Clear we Listeners właściwości (System.Diagnostics.Trace.Listeners.Clear()). W przypadku .NET Framework aplikacji można również użyć <clear> elementu i <elementu remove> w pliku konfiguracji aplikacji.

W przypadku .NET Framework aplikacji można zmienić zachowanie DefaultTraceListener elementu w pliku konfiguracji, który odpowiada nazwie aplikacji. W tym pliku można włączyć i wyłączyć okno 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ż

Dotyczy

Assert(Boolean, String)

Źródło:: Trace.cs

Źródło:: Trace.cs

Źródło:: Trace.cs

Sprawdza warunek; Jeśli warunek to false, zwraca określony komunikat i wyświetla okno 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 obliczenia. Jeśli warunek to true, określony komunikat nie jest wysyłany, a okno komunikatu nie jest wyświetlane.

message: String

Komunikat do wysłania do kolekcji Listeners .

Atrybuty: ConditionalAttribute

Przykłady

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

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

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 TraceListener element do kolekcji lub usuwając go z kolekcji Listeners .

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)

Źródło:: Trace.cs

Źródło:: Trace.cs

Źródło:: Trace.cs

Sprawdza warunek; Jeśli warunek to false, zwraca dwa określone komunikaty i wyświetla okno 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 obliczenia. Jeśli warunek to true, określone komunikaty nie są wysyłane, a okno 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, type czy parametr jest prawidłowy. Jeśli przekazana wartość type to null, Assert polecenie zwraca komunikat.

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

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 TraceListener element do kolekcji lub usuwając go z kolekcji Listeners .

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

Opinia

Dodatkowe zasoby