Udostępnij za pośrednictwem


Trace.Assert Metoda

Definicja

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

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

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

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

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

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

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

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