Debug.Assert Metod

Definition

Namnområde:: System.Diagnostics

Sammansättningar:: System.dll, System.Diagnostics.Debug.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Diagnostics.Debug.dll

Sammansättning:: System.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Söker efter ett villkor. om villkoret är falsematar ut meddelanden och visar en meddelanderuta som visar anropsstacken.

Överlagringar

Name	Description
Assert(Boolean)	Söker efter ett villkor. om villkoret är `false`visar en meddelanderuta som visar anropsstacken.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Söker efter ett villkor. om villkoret är `false`matar ut ett angivet meddelande och visar en meddelanderuta som visar anropsstacken.
Assert(Boolean, String)	Söker efter ett villkor. om villkoret är `false`matar ut ett angivet meddelande och visar en meddelanderuta som visar anropsstacken.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Söker efter ett villkor. om villkoret är `false`matar ut ett angivet meddelande och visar en meddelanderuta som visar anropsstacken.
Assert(Boolean, String, String)	Söker efter ett villkor. om villkoret är `false`matar ut två angivna meddelanden och visar en meddelanderuta som visar anropsstacken.
Assert(Boolean, String, String, Object[])	Söker efter ett villkor. om villkoret är `false`matar ut två meddelanden (enkla och formaterade) och visar en meddelanderuta som visar anropsstacken.

Assert(Boolean)

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Söker efter ett villkor. om villkoret är falsevisar en meddelanderuta som visar anropsstacken.

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)

Parametrar

condition: Boolean

Villkorsuttrycket som ska utvärderas. Om villkoret är trueskickas inte ett felmeddelande och meddelanderutan visas inte.

Attribut: ConditionalAttribute OverloadResolutionPriorityAttribute

Exempel

I följande exempel skapas ett index för en matris, utför en åtgärd för att ange indexets värde och anropar Assert sedan för att bekräfta att indexvärdet är giltigt. Om den inte är giltig matar Assert du ut anropsstacken.

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

Kommentarer

Som standard Debug.Assert fungerar metoden endast i felsökningsversioner. Trace.Assert Använd metoden om du vill göra kontroller i versionsversioner. Mer information finns i Kontroller i Hanterad kod.

Vanligtvis Assert(Boolean) används metoden för att identifiera logikfel under programutvecklingen. Assert utvärderar villkoret. Om resultatet är falseskickar det ett felmeddelande till Listeners samlingen. Du kan anpassa det här beteendet genom att lägga till en TraceListener i eller ta bort en från Listeners samlingen.

När programmet körs i användargränssnittsläge visas en meddelanderuta som visar anropsstacken med fil- och radnummer. Meddelanderutan innehåller tre knappar: Avbryt, Försök igen och Ignorera. Om du klickar på knappen Avbryt avslutas programmet. Om du klickar på Försök igen skickas du till koden i felsökningsprogrammet om programmet körs i ett felsökningsprogram eller erbjuder sig att öppna ett felsökningsprogram om det inte är det. Om du klickar på Ignorera fortsätter nästa instruktion i koden.

Note

Windows 8.x-appar stöder inte modala dialogrutor, så de beter sig likadant i användargränssnittsläge och icke-användargränssnittsläge. Meddelandet skrivs till aktiva spårningslyssnare i felsökningsläge, eller så skrivs inget meddelande i versionsläge.

Note

Meddelanderutans visning beror på förekomsten av DefaultTraceListener. Om inte DefaultTraceListener finns i Listeners samlingen visas inte meddelanderutan. DefaultTraceListener Kan tas bort genom att anropa Clear metoden för Listeners egenskapen (System.Diagnostics.Trace.Listeners.Clear()). För .NET Framework-appar kan du också använda elementet <clear> och <remove> element i appens konfigurationsfil.

För .NET Framework-appar kan du ändra beteendet för DefaultTraceListener i konfigurationsfilen som motsvarar namnet på ditt program. I den här filen kan du aktivera och inaktivera rutan För kontrollmeddelande eller ange egenskapen DefaultTraceListener.LogFileName . Konfigurationsfilen ska formateras på följande sätt:

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

Se även

Gäller för

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Söker efter ett villkor. om villkoret är falsematar ut ett angivet meddelande och visar en meddelanderuta som visar anropsstacken.

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)

Parametrar

condition: Boolean

Villkorsuttrycket som ska utvärderas. Om villkoret är trueskickas inte det angivna meddelandet och meddelanderutan visas inte.

message: Debug.AssertInterpolatedStringHandler

Meddelandet som ska skickas Listeners till samlingen.

Attribut: ConditionalAttribute

Kommentarer

Den här överbelastningen introducerades i .NET 6 för att förbättra prestandan. I jämförelse med de överlagringar som tar en String parameter utvärderar den här överlagringen endast eventuella interpolerade strängformateringsobjekt om meddelandet krävs.

Vanligtvis Assert används metoden för att identifiera logikfel under programutvecklingen. Assert utvärderar villkoret. Om resultatet är falseskickar det det angivna diagnostikmeddelandet till Listeners samlingen. Du kan anpassa det här beteendet genom att lägga till en TraceListener i eller ta bort en från Listeners samlingen.

Note

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

Se även

Gäller för

Assert(Boolean, String)

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Söker efter ett villkor. om villkoret är falsematar ut ett angivet meddelande och visar en meddelanderuta som visar anropsstacken.

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)

Parametrar

condition: Boolean

Villkorsuttrycket som ska utvärderas. Om villkoret är trueskickas inte det angivna meddelandet och meddelanderutan visas inte.

message: String

Meddelandet som ska skickas Listeners till samlingen.

Attribut: ConditionalAttribute

Exempel

I följande exempel kontrolleras om parametern type är giltig. Om type är nullmatar Assert ut ett meddelande.

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

Kommentarer

Note

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

Se även

Gäller för

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

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Söker efter ett villkor. om villkoret är falsematar ut ett angivet meddelande och visar en meddelanderuta som visar anropsstacken.

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)

Parametrar

condition: Boolean

Villkorsuttrycket som ska utvärderas. Om villkoret är trueskickas inte det angivna meddelandet och meddelanderutan visas inte.

message: Debug.AssertInterpolatedStringHandler

Meddelandet som ska skickas Listeners till samlingen.

detailMessage: Debug.AssertInterpolatedStringHandler

Det detaljerade meddelandet som ska skickas Listeners till samlingen.

Attribut: ConditionalAttribute

Kommentarer

Note

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

Se även

Gäller för

Assert(Boolean, String, String)

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Söker efter ett villkor. om villkoret är falsematar ut två angivna meddelanden och visar en meddelanderuta som visar anropsstacken.

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)

Parametrar

condition: Boolean

Villkorsuttrycket som ska utvärderas. Om villkoret är trueskickas inte de angivna meddelandena och meddelanderutan visas inte.

message: String

Meddelandet som ska skickas Listeners till samlingen.

detailMessage: String

Det detaljerade meddelandet som ska skickas Listeners till samlingen.

Attribut: ConditionalAttribute

Exempel

I följande exempel kontrolleras om parametern type är giltig. Om type är nullmatar Assert ut två meddelanden.

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

Kommentarer

Vanligtvis Assert(Boolean, String, String) används metoden för att identifiera logikfel under programutvecklingen. Assert utvärderar villkoret. Om resultatet är falseskickar det det angivna diagnostikmeddelandet och det detaljerade meddelandet till Listeners samlingen. Du kan anpassa det här beteendet genom att lägga till en TraceListener i eller ta bort en från Listeners samlingen.

Note

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

Se även

Gäller för

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

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Källa:: Debug.cs

Söker efter ett villkor. om villkoret är falsematar ut två meddelanden (enkla och formaterade) och visar en meddelanderuta som visar anropsstacken.

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

Parametrar

condition: Boolean

Villkorsuttrycket som ska utvärderas. Om villkoret är trueskickas inte de angivna meddelandena och meddelanderutan visas inte.

message: String

Meddelandet som ska skickas Listeners till samlingen.

detailMessageFormat: String

Den sammansatta formatsträng som ska skickas Listeners till samlingen. Det här meddelandet innehåller text som blandas med noll eller fler formatobjekt, vilket motsvarar objekt i matrisen args .

args: Object[]

En objektmatris som innehåller noll eller fler objekt att formatera.

Attribut: ConditionalAttribute

Kommentarer

Den här metoden använder funktionen .NET sammansatt formatering för att konvertera värdet för ett objekt till dess textrepresentation och bädda in representationen i en sträng. Den resulterande strängen Listeners skickas till samlingen.

Vanligtvis Assert(Boolean, String, String, Object[]) används metoden för att identifiera logikfel under programutvecklingen. Assert utvärderar villkoret. Om resultatet är falseString.Format(String, Object[]) anropas metoden och strängen och detailMessageFormat matrisen args skickas som parametrar. Assert(Boolean, String, String, Object[]) skickar sedan det angivna textmeddelandet och det formaterade textmeddelandet till Listeners samlingen. Du kan anpassa det här beteendet genom att lägga till en TraceListener i eller ta bort en från Listeners samlingen.

Note

Visningen av meddelanderutan är beroende av förekomsten av DefaultTraceListener. Om inte DefaultTraceListener finns i Listeners samlingen visas inte meddelanderutan. DefaultTraceListener Kan tas bort genom att anropa Clear metoden för Listeners egenskapen (System.Diagnostics.Trace.Listeners.Clear()). För .NET Framework-appar kan du också använda elementet <clear> och <remove> element i appens konfigurationsfil.

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

Gäller för

Feedback

Var den här sidan till hjälp?