Debug.Assert Metoda

Definicja

Przestrzeń nazw:: System.Diagnostics

Zestawy:: System.dll, System.Diagnostics.Debug.dll

Zestawy:: netstandard.dll, System.Runtime.dll

Zestaw:: System.Diagnostics.Debug.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 wyświetla stos wywołań.

Przeciążenia

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

Assert(Boolean)

Źródło:: Debug.cs

Źródło:: Debug.cs

Ź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")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

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

[<System.Diagnostics.Conditional("DEBUG")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

Parametry

condition: Boolean

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

Atrybuty: ConditionalAttribute OverloadResolutionPriorityAttribute

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 generuje stos wywołań.

// 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. Trace.Assert Użyj metody , jeśli chcesz wykonać asercji w kompilacjach wydania. Aby uzyskać więcej informacji, zobacz Asercje w kodzie zarządzanym.

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

Gdy aplikacja działa w trybie interfejsu użytkownika, wyświetla okno komunikatu z stosem 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 cię 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 / Notatka

Aplikacje systemu Windows 8.x nie obsługują modalnych okien dialogowych, więc zachowują się tak samo w trybie interfejsu użytkownika i w trybie interfejsu użytkownika. Komunikat jest zapisywany do aktywnych odbiorników śledzenia w trybie debugowania lub żaden komunikat nie jest zapisywany w trybie wydania.

Uwaga / Notatka

Wyświetlanie pola komunikatu zależy od obecności obiektu 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 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 aplikacji .NET Framework można zmienić zachowanie DefaultTraceListener elementu w pliku konfiguracji, który odpowiada nazwie aplikacji. W tym pliku można włączyć i wyłączyć pole komunikatu potwierdzenia 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

Ź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 wyświetla 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 obliczenia. Jeśli warunek ma truewartość , określony komunikat nie jest wysyłany, a pole komunikatu nie jest wyświetlane.

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 oblicza tylko wszystkie elementy formatowania ciągów interpolowanych, jeśli jest wymagany komunikat.

Assert Zazwyczaj metoda służy do identyfikowania 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.

Uwaga / Notatka

<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

Ź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 wyświetla 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 = default);

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

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

Parametry

condition: Boolean

Wyrażenie warunkowe do obliczenia. Jeśli warunek ma truewartość , określony komunikat nie jest wysyłany, a pole komunikatu nie jest wyświetlane.

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 parametr ma nullwartość , Assert zwraca komunikat.

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 / Notatka

<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

Ź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 wyświetla 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 obliczenia. Jeśli warunek ma truewartość , określony komunikat nie jest wysyłany, a pole komunikatu nie jest wyświetlane.

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 / Notatka

<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

Ź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 obliczenia. 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 parametr ma nullwartość , Assert zwraca dwa komunikaty.

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

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

Uwaga / Notatka

<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

Ź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 okno komunikatu, które wyświetla 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 obliczenia. 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 formatu zero lub więcej, które odpowiadają obiektom w tablicy args .

args: Object[]

Tablica obiektów zawierająca 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 jego reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest wysyłany do kolekcji Listeners .

Assert(Boolean, String, String, Object[]) Zazwyczaj metoda służy do identyfikowania błędów logiki podczas opracowywania programu. Assert oblicza warunek. Jeśli wynikiem jest 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śloną wiadomość SMS i sformatowaną wiadomość tekstowa do kolekcji Listeners . To zachowanie można dostosować, dodając element TraceListener do kolekcji Listeners lub usuwając go.

Uwaga / Notatka

Wyświetlanie pola 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 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

Opinia

Czy ta strona była pomocna?

Udostępnij za pośrednictwem

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