Trace.Assert Metoda
Definicja
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 |
Assert(Boolean, String) |
Sprawdza warunek; Jeśli warunek to |
Assert(Boolean, String, String) |
Sprawdza warunek; Jeśli warunek to |
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 true
wartość , 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.
- 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.
- 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>