Debug.Assert Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Diagnostics

Zestaw:: System.Diagnostics.Debug.dll

Zestaw:: System.Runtime.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, Debug+AssertInterpolatedStringHandler)	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)	Sprawdza warunek; jeśli warunek to `false`, zwraca określony komunikat i wyświetla pole komunikatu, które pokazuje stos wywołań.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	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, String, String, Object[])	Sprawdza warunek; Jeśli warunek to `false`, generuje dwa komunikaty (proste i sformatowane) i wyświetla pole komunikatu, które pokazuje stos wywołań.

Assert(Boolean)

Źródło:: Debug.cs

Źródło:: Debug.cs

Źródło:: Debug.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("DEBUG")]
public static void Assert (bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
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, wykonuje pewną akcję, aby ustawić wartość indeksu, a następnie wywołuje polecenie Assert w celu potwierdzenia, że wartość indeksu jest prawidłowa. Jeśli jest on nieprawidłowy, Assert wyprowadza stos wywołań.

// Create a local value.
int index;

// Perform some action that sets the local value.
index = -40;

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif

// Create an index for an array.
int index;

// Perform some action that sets the index.
index = -40;

// Test that the index value is valid.
Debug.Assert(index > -1);

' Create an index for an array.
Dim index As Integer

' Perform some action that sets the index.
index = -40

' Test that the index value is valid. 
Debug.Assert((index > - 1))

Uwagi

Domyślnie Debug.Assert metoda działa tylko w kompilacjach debugowania. Użyj metody , Trace.Assert jeśli chcesz wykonywać asercji w kompilacjach wydania. 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 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

aplikacje Windows 8.x nie obsługują modalnych okien dialogowych, dlatego zachowują się tak samo w trybie interfejsu użytkownika i w trybie interfejsu innego niż użytkownik. Komunikat jest zapisywany w aktywnych odbiornikach śledzenia w trybie debugowania lub żaden komunikat nie jest zapisywany w trybie wydania.

Uwaga

Wyświetlanie pola komunikatu zależy od obecności obiektu DefaultTraceListener. Jeśli obiekt DefaultTraceListener nie znajduje się w kolekcji Listeners , okno komunikatu 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ć <wyczyść> elementu i <elementu remove> 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Zobacz też

Dotyczy

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Źródło:: Debug.cs

Źródło:: Debug.cs

Źródło:: Debug.cs

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::Diagnostics::Debug::AssertInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message);

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

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler)

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: Debug.AssertInterpolatedStringHandler

Komunikat do wysłania do kolekcji Listeners .

Atrybuty: ConditionalAttribute

Uwagi

To przeciążenie zostało wprowadzone na platformie .NET 6 w celu zwiększenia wydajności. W porównaniu z przeciążeniami, które przyjmują String parametr, to przeciążenie ocenia tylko wszystkie interpolowane elementy formatowania ciągów, jeśli komunikat jest wymagany.

Zazwyczaj metoda służy do identyfikowania Assert błędów logiki podczas opracowywania programu. Assert 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Zobacz też

Dotyczy

Assert(Boolean, String)

Źródło:: Debug.cs

Źródło:: Debug.cs

Źródło:: Debug.cs

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

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
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 type jest to null, Assert zwraca komunikat.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}

public static void MyMethod(Type type, Type baseType)
{
    Debug.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Debug.Assert(Not (type Is Nothing), "Type parameter is null")
End Sub

Uwagi

Uwaga

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Zobacz też

Dotyczy

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Źródło:: Debug.cs

Źródło:: Debug.cs

Źródło:: Debug.cs

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::Diagnostics::Debug::AssertInterpolatedStringHandler % message, System::Diagnostics::Debug::AssertInterpolatedStringHandler % detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler detailMessage);

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

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler, ByRef detailMessage As Debug.AssertInterpolatedStringHandler)

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: Debug.AssertInterpolatedStringHandler

Komunikat do wysłania do kolekcji Listeners .

detailMessage: Debug.AssertInterpolatedStringHandler

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

Atrybuty: ConditionalAttribute

Uwagi

Uwaga

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Zobacz też

Dotyczy

Assert(Boolean, String, String)

Źródło:: Debug.cs

Źródło:: Debug.cs

Źródło:: Debug.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("DEBUG")]
public static void Assert (bool condition, string message, string detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string? detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
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 type jest to null, Assert zwraca dwa komunikaty.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}

public static void MyMethod(Type type, Type baseType)
{
    Debug.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)
    Debug.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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Zobacz też

Dotyczy

Assert(Boolean, String, String, Object[])

Źródło:: Debug.cs

Źródło:: Debug.cs

Źródło:: Debug.cs

Sprawdza warunek; Jeśli warunek to false, generuje dwa komunikaty (proste i sformatowane) i wyświetla pole komunikatu, które pokazuje stos wywołań.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessageFormat, params object[] args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string detailMessageFormat, params object?[] args);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string * string * obj[] -> unit

Public Shared Sub Assert (condition As Boolean, message As String, detailMessageFormat As String, ParamArray args As Object())

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 .

detailMessageFormat: String

Ciąg formatu złożonego do wysłania do kolekcji Listeners . Ten komunikat zawiera tekst mieszany z elementami o zerowym lub większym formacie, które odpowiadają obiektom w tablicy args .

args: Object[]

Tablica obiektów zawiera zero lub więcej obiektów do sformatowania.

Atrybuty: ConditionalAttribute

Uwagi

Ta metoda używa funkcji formatowania złożonego platformy .NET , aby przekonwertować wartość obiektu na jej reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest wysyłany do kolekcji Listeners .

Zazwyczaj metoda służy do identyfikowania Assert(Boolean, String, String, Object[]) błędów logiki podczas opracowywania programu. Assert oblicza warunek. Jeśli wynik to false, String.Format(String, Object[]) metoda jest wywoływana, a detailMessageFormat ciąg i args tablica są przekazywane jako parametry. Assert(Boolean, String, String, Object[]) następnie wysyła określony komunikat tekstowy i sformatowany komunikat tekstowy Listeners do kolekcji. To zachowanie można dostosować, dodając element TraceListener do kolekcji Listeners lub usuwając go z tej kolekcji.

Uwaga

Wyświetlanie pola komunikatu zależy od obecności elementu DefaultTraceListener. Jeśli obiekt DefaultTraceListener nie znajduje się w kolekcji Listeners , okno komunikatu 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ć <wyczyść> elementu i <elementu remove> w pliku konfiguracji aplikacji.

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Dotyczy

Debug.Assert Metoda

Definicja

Przeciążenia

Assert(Boolean)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parametry

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, String)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Parametry

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, String, String)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Assert(Boolean, String, String, Object[])

Parametry

Uwagi

Dotyczy

Opinia

Dodatkowe zasoby