Debug.Fail Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir hata iletisi yayar.

Aşırı Yüklemeler

Fail(String, String)	Bir hata iletisi ve ayrıntılı bir hata iletisi görüntüler.
Fail(String)	Belirtilen hata iletisini yayar.

Fail(String, String)

Kaynak:

Debug.cs

Bir hata iletisi ve ayrıntılı bir hata iletisi görüntüler.

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);

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

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

Public Shared Sub Fail (message As String, detailMessage As String)

Parametreler

message

String

Yaymak için bir ileti.

detailMessage

String

Yaymak için ayrıntılı bir ileti.

Öznitelikler

ConditionalAttribute

Örnekler

Aşağıdaki örnek, özel durum işleme sırasında bir iletiyi yazdırmak için yöntemini kullanır Fail .

catch ( Exception^ e ) 
{
   #if defined(DEBUG)
   Debug::Fail( "Cannot find SpecialController, proceeding with StandardController", "Setting Controller to default value" );
   #endif
}

catch (Exception)
{
    Debug.Fail("Invalid value: " + value.ToString(),
       "Resetting value to newValue.");
    value = newValue;
}

Catch e As Exception
    Debug.Fail("Invalid value: " + value.ToString(), "Resetting value to newValue.")
    value = newValue
End Try

Yöntemini bir switch deyiminde de kullanabilirsiniz Fail .

   switch ( option )
   {
      case Option::First:
         result = 1.0;
         break;

      // Insert additional cases.
      
      default:
         #if defined(DEBUG)
         Debug::Fail( "Unknown Option" + option, "Result set to 1.0" );
         #endif
         result = 1.0;
         break;
   }

switch (option1)
{
    case MyOption.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option1, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

Açıklamalar

Varsayılan davranış, DefaultTraceListener uygulama kullanıcı arabirimi modunda çalışırken iletinin bir ileti kutusuna ve koleksiyondaki TraceListener örneklere çıkışıdır Listeners .

Not

İleti kutusunun görüntülenmesi, 'nin varlığına DefaultTraceListenerbağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener, clear>, remove veya özelliğinde ( yöntemi çağrılarak kaldırılabilir<.><ClearSystem.Diagnostics.Trace.Listeners.Clear()Listeners

Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Ayrıca bkz.

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Fail(String)

Kaynak:

Debug.cs

Belirtilen hata iletisini yayar.

public:
 static void Fail(System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string? message);

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

Public Shared Sub Fail (message As String)

Parametreler

message

String

Yaymak için bir ileti.

Öznitelikler

ConditionalAttribute

Örnekler

Aşağıdaki örnek, özel durum işleme sırasında bir iletiyi yazdırmak için yöntemini kullanır Fail .

catch ( Exception^ e ) 
{
   #if defined(DEBUG)
   Debug::Fail( "Unknown Option " + option + ", using the default." );
   #endif
}

catch (Exception)
{
    Debug.Fail("Unknown Option " + option + ", using the default.");
}

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", using the default.")
End Try

Yöntemini bir switch deyiminde de kullanabilirsiniz Fail .

   switch ( option )
   {
      case Option::First:
         result = 1.0;
         break;

      // Insert additional cases.
      
      default:
         #if defined(DEBUG)
         Debug::Fail( "Unknown Option" + option );
         #endif
         result = 1.0;
         break;
   }

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case myOption1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail(("Unknown Option " & myOption1.ToString))
        result = 1.0
End Select

Açıklamalar

Varsayılan davranış, DefaultTraceListener uygulama kullanıcı arabirimi modunda çalışırken iletinin bir ileti kutusuna ve koleksiyondaki TraceListener örneklere çıkışıdır Listeners .

Not

İleti kutusunun görüntülenmesi, 'nin varlığına DefaultTraceListenerbağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener, clear>, remove veya özelliğinde ( yöntemi çağrılarak kaldırılabilir<.><ClearSystem.Diagnostics.Trace.Listeners.Clear()Listeners

Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Ayrıca bkz.

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute