Try...Catch...Finally-Anweisung (Visual Basic)
Bietet eine Möglichkeit, einige oder alle möglichen Fehler zu behandeln, die in einem bestimmten Codeblock auftreten können, während weiterhin Code ausgeführt wird.
Syntax
Try
[ tryStatements ]
[ Exit Try ]
[ Catch [ exception [ As type ] ] [ When expression ]
[ catchStatements ]
[ Exit Try ] ]
[ Catch ... ]
[ Finally
[ finallyStatements ] ]
End Try
Bestandteile
Begriff | Definition |
---|---|
tryStatements |
Dies ist optional. Anweisungen, in denen ein Fehler auftreten kann. Kann eine Verbundanweisung sein. |
Catch |
Optional. Mehrere Catch Blöcke zulässig. Wenn beim Verarbeiten des Try Blocks eine Ausnahme auftritt, wird jede Catch Anweisung in Textreihenfolge untersucht, um zu bestimmen, ob sie die Ausnahme behandelt, wobei exception die ausgelöste Ausnahme dargestellt wird. |
exception |
Optional. Ein beliebiger Variablenname. Der Anfangswert von exception ist der Wert des ausgelösten Fehlers. Wird mit Catch verwendet, um den abgefangenen Fehler anzugeben. Wenn sie nicht angegeben wird, fängt die Catch Anweisung eine ausnahme ab. |
type |
Optional. Gibt den Typ des Klassenfilters an. Wenn der Wert von exception vom oder einem abgeleiteten Typ angegeben type ist, wird der Bezeichner an das Ausnahmeobjekt gebunden. |
When |
Optional. Eine Catch Anweisung mit einer When -Klausel fängt Ausnahmen nur ab, wenn expression als ausgewertet wird True . Eine When -Klausel wird nur angewendet, nachdem der Typ der Ausnahme überprüft wurde, und expression kann auf den Bezeichner verweisen, der die Ausnahme darstellt. |
expression |
Optional. Muss implizit in Boolean konvertiert werden. Jeder Ausdruck, der einen generischen Filter beschreibt. Wird in der Regel verwendet, um nach Fehlernummer zu filtern. Wird mit dem When Schlüsselwort verwendet, um Umstände anzugeben, unter denen der Fehler abgefangen wird. |
catchStatements |
Optional. Anweisungen zur Behandlung von Fehlern, die im zugeordneten Try Block auftreten. Kann eine Verbundanweisung sein. |
Exit Try |
Optional. Schlüsselwort, das aus der Try...Catch...Finally Struktur herausbricht. Die Ausführung wird mit dem Code fortgesetzt, der unmittelbar auf die End Try -Anweisung folgt. Die Finally Anweisung wird weiterhin ausgeführt. In Blöcken nicht zulässig Finally . |
Finally |
Optional. Ein Finally -Block wird immer ausgeführt, wenn die Ausführung einen Teil der Try...Catch Anweisung verlässt. |
finallyStatements |
Optional. Anweisungen, die ausgeführt werden, nachdem alle anderen Fehler verarbeitet wurden. |
End Try |
Beendet die Try...Catch...Finally -Struktur. |
Bemerkungen
Wenn Sie erwarten, dass während eines bestimmten Codeabschnitts eine bestimmte Ausnahme auftreten kann, fügen Sie den Code in einen -Block ein Try
, und verwenden Sie einen Catch
-Block, um die Kontrolle beizubehalten und die Ausnahme zu behandeln, wenn sie auftritt.
Eine Try…Catch
-Anweisung besteht aus einem Try
Block gefolgt von einer oder Catch
mehreren Klauseln, die Handler für verschiedene Ausnahmen angeben. Wenn in einem Try
Block eine Ausnahme ausgelöst wird, sucht Visual Basic nach der Anweisung, die Catch
die Ausnahme behandelt. Wenn keine übereinstimmende Catch
Anweisung gefunden wird, untersucht Visual Basic die Methode, die die aktuelle Methode aufgerufen hat, usw. in der Aufrufliste. Wenn kein Catch
Block gefunden wird, zeigt Visual Basic dem Benutzer eine Nicht behandelte Ausnahmemeldung an und beendet die Ausführung des Programms.
Sie können mehr als eine Catch
Anweisung in einer Try…Catch
-Anweisung verwenden. Wenn Sie dies tun, ist die Reihenfolge der Catch
Klauseln signifikant, da sie in der Reihenfolge untersucht werden. Fangen Sie spezifischere Ausnahmen vor den weniger spezifischen ab.
Die folgenden Catch
Anweisungsbedingungen sind die am wenigsten spezifischen und erfassen alle Ausnahmen, die von der Exception -Klasse abgeleitet werden. Sie sollten normalerweise eine dieser Variationen als letzten Catch
Block in der Try...Catch...Finally
Struktur verwenden, nachdem Sie alle erwarteten spezifischen Ausnahmen abfangen. Die Ablaufsteuerung kann niemals einen Catch
Block erreichen, der einer dieser Variationen folgt.
Ist
type
Exception
, z. B.:Catch ex As Exception
Die -Anweisung verfügt über keine
exception
Variable, z. B.:Catch
Wenn eine Anweisung in einem Try…Catch…Finally
anderen Try
Block geschachtelt ist, untersucht Visual Basic zunächst jede Catch
Anweisung im innersten Try
Block. Wenn keine übereinstimmende Catch
Anweisung gefunden wird, wird die Suche mit den Catch
Anweisungen des äußeren Try…Catch…Finally
Blocks fortgesetzt.
Lokale Variablen aus einem Try
Block sind in einem Catch
Block nicht verfügbar, da es sich um separate Blöcke handelt. Wenn Sie eine Variable in mehr als einem Block verwenden möchten, deklarieren Sie die Variable außerhalb der Try...Catch...Finally
-Struktur.
Tipp
Die Try…Catch…Finally
-Anweisung ist als IntelliSense-Codeausschnitt verfügbar. Erweitern Sie im Codeausschnitt-Manager code patterns - If, For Each, Try Catch, Property usw. und dann Error Handling (Exceptions). Weitere Informationen finden Sie unter Codeausschnitte.
Abschließender Block
Wenn Sie über eine oder mehrere Anweisungen verfügen, die ausgeführt werden müssen, bevor Sie die Try
-Struktur beenden, verwenden Sie einen Finally
-Block. Das Steuerelement wird an den Finally
Block übergeben, kurz bevor es aus der Try…Catch
-Struktur herausgeht. Dies gilt auch dann, wenn innerhalb der Try
Struktur eine Ausnahme auftritt.
Ein Finally
-Block ist nützlich für die Ausführung von Code, der auch dann ausgeführt werden muss, wenn eine Ausnahme vorliegt. Die Steuerung wird an den Finally
Block übergeben, unabhängig davon, wie der Try...Catch
Block beendet wird.
Der Code in einem Finally
-Block wird auch ausgeführt, wenn Ihr Code auf eine Return
-Anweisung in einem - oder Catch
-Try
Block trifft. Das Steuerelement wird in den folgenden Fällen nicht von einem Try
- oder Catch
-Block an den entsprechenden Finally
Block übergeben:
Eine End-Anweisung wird im
Try
- oderCatch
-Block gefunden.Ein StackOverflowException wird im
Try
-Block oderCatch
-Block ausgelöst.
Es ist nicht gültig, die Ausführung explizit in einen Finally
Block zu übertragen. Das Übertragen der Ausführung aus einem Finally
Block ist außer über eine Ausnahme ungültig.
Wenn eine Try
Anweisung nicht mindestens einen Catch
Block enthält, muss sie einen Finally
-Block enthalten.
Tipp
Wenn Sie keine bestimmten Ausnahmen abfangen müssen, verhält sich die Using
Anweisung wie ein Try…Finally
Block und garantiert die Entsorgung der Ressourcen, unabhängig davon, wie Sie den Block beenden. Dies gilt auch bei einer unbehandelten Ausnahme. Weitere Informationen finden Sie unter using-Anweisung.
Exception-Argument
Das Catch
Blockargument exception
ist eine Instanz der Exception -Klasse oder eine Klasse, die von der Exception
-Klasse abgeleitet wird. Die Exception
Klasseninstanz entspricht dem Fehler, der Try
im -Block aufgetreten ist.
Die Eigenschaften des Exception
-Objekts helfen, die Ursache und den Speicherort einer Ausnahme zu identifizieren. Die -Eigenschaft listet beispielsweise die aufgerufenen Methoden auf, StackTrace die zu der Ausnahme geführt haben, sodass Sie den Fehler im Code ermitteln können. Message gibt eine Meldung zurück, die die Ausnahme beschreibt. HelpLink gibt einen Link zu einer zugeordneten Hilfedatei zurück. InnerException gibt das Exception
Objekt zurück, das die aktuelle Ausnahme verursacht hat, oder es wird zurückgegeben Nothing
, wenn kein ursprüngliches Exception
vorhanden ist.
Überlegungen bei der Verwendung eines Try... Catch-Anweisung
Verwenden Sie eine Try…Catch
-Anweisung nur, um das Auftreten von ungewöhnlichen oder unerwarteten Programmereignissen zu signalisieren. Gründe hierfür sind u. a. die folgenden:
Das Abfangen von Ausnahmen zur Laufzeit verursacht zusätzlichen Mehraufwand und ist wahrscheinlich langsamer als die Vorabüberprüfung, um Ausnahmen zu vermeiden.
Wenn ein
Catch
Block nicht ordnungsgemäß behandelt wird, wird die Ausnahme möglicherweise nicht ordnungsgemäß an Benutzer gemeldet.Die Ausnahmebehandlung macht ein Programm komplexer.
Sie benötigen nicht immer eine Try…Catch
-Anweisung, um nach einer Bedingung zu suchen, die wahrscheinlich auftritt. Im folgenden Beispiel wird überprüft, ob eine Datei vorhanden ist, bevor Sie versuchen, sie zu öffnen. Dies reduziert die Notwendigkeit, eine von der OpenText -Methode ausgelöste Ausnahme abzufangen.
Private Sub TextFileExample(ByVal filePath As String)
' Verify that the file exists.
If System.IO.File.Exists(filePath) = False Then
Console.Write("File Not Found: " & filePath)
Else
' Open the text file and display its contents.
Dim sr As System.IO.StreamReader =
System.IO.File.OpenText(filePath)
Console.Write(sr.ReadToEnd)
sr.Close()
End If
End Sub
Stellen Sie sicher, dass Code in Catch
Blöcken Benutzern ordnungsgemäß Ausnahmen melden kann, sei es durch threadsichere Protokollierung oder entsprechende Meldungen. Andernfalls bleiben Ausnahmen möglicherweise unbekannt.
Asynchrone Methoden
Wenn Sie eine Methode mit dem Async-Modifizierer markieren, können Sie den Await-Operator in der -Methode verwenden. Eine -Anweisung mit dem -Operator hält die Await
Ausführung der -Methode an, bis die erwartete Aufgabe abgeschlossen ist. Die Aufgabe stellt derzeit ausgeführte Arbeit dar. Wenn die Dem Operator zugeordnete Await
Aufgabe abgeschlossen ist, wird die Ausführung in derselben Methode fortgesetzt. Weitere Informationen finden Sie unter Ablaufsteuerung in asynchronen Programmen.
Eine von einer Async-Methode zurückgegebene Aufgabe endet möglicherweise in einem fehlerhaften Zustand, was angibt, dass sie aufgrund einer nicht behandelten Ausnahme abgeschlossen wurde. Eine Aufgabe kann auch mit einem abgebrochenen Zustand enden, was dazu führt, dass ein OperationCanceledException
aus dem await-Ausdruck ausgelöst wird. Um beide Ausnahmetypen abzufangen, platzieren Sie den Ausdruck, der Await
der Aufgabe zugeordnet ist, in einem Try
-Block, und fangen Sie die Ausnahme im Catch
-Block ab. Ein Beispiel finden Sie weiter unten in diesem Thema.
Eine Aufgabe kann sich in einem fehlerhaften Zustand befinden, da mehrere Ausnahmen für den Fehler verantwortlich waren. Beispielsweise kann die Aufgabe das Ergebnis eines Aufrufs an Task.WhenAll sein. Wenn Sie auf eine solche Aufgabe warten, ist die abgefangene Ausnahme nur eine der Ausnahmen, und Sie können nicht vorhersagen, welche Ausnahme abgefangen wird. Ein Beispiel finden Sie weiter unten in diesem Thema.
Ein Await
Ausdruck darf sich nicht innerhalb eines Blocks oder Finally
Blocks Catch
befinden.
Iterators
Eine Iteratorfunktion oder Get
ein Accessor führt eine benutzerdefinierte Iteration über eine Sammlung aus. Ein Iterator verwendet eine Yield-Anweisung , um jedes Element der Auflistung einzeln zurückzugeben. Sie rufen eine Iteratorfunktion auf, indem Sie ein For Each... Next-Anweisung.
Eine Yield
-Anweisung kann sich innerhalb eines Try
Blocks befinden. Ein Try
Block, der eine Yield
-Anweisung enthält, kann Catch
Blöcke und einen Finally
-Block enthalten. Ein Beispiel finden Sie im Abschnitt "Testen von Blöcken in Visual Basic" von Iteratoren .
Eine Yield
-Anweisung darf sich nicht in einem Catch
-Block oder - Finally
Block befinden.
Wenn der For Each
Text (außerhalb der Iteratorfunktion) eine Ausnahme auslöst, wird kein Catch
Block in der Iteratorfunktion ausgeführt, aber ein Finally
Block in der Iteratorfunktion wird ausgeführt. Ein Catch
Block in einer Iteratorfunktion fängt nur Ausnahmen ab, die innerhalb der Iteratorfunktion auftreten.
Teilweise vertrauenswürdige Situationen
In teilweise vertrauenswürdigen Situationen, z. B. einer Anwendung, die auf einer Netzwerkfreigabe gehostet wird, werden keine Sicherheitsausnahmen abgefangen, Try...Catch...Finally
die auftreten, bevor die Methode, die den Aufruf enthält, aufgerufen wird. Im folgenden Beispiel wird der Fehler "System.Security.SecurityException: Request Failed" (System.Security.SecurityException: Anforderung fehlgeschlagen) ausgegeben, wenn Sie sie auf einer Serverfreigabe platzieren und dort ausführen. Weitere Informationen zu Sicherheitsausnahmen finden Sie in der SecurityException -Klasse.
Try
Process.Start("http://www.microsoft.com")
Catch ex As Exception
Console.WriteLine("Can't load Web page" & vbCrLf & ex.Message)
End Try
In einer solchen teilweise vertrauenswürdigen Situation müssen Sie die Process.Start
-Anweisung in einem separaten Sub
ablegen. Der anfängliche Aufruf von Sub
schlägt fehl. Dies ermöglicht Try...Catch
es, ihn abzufangen, bevor der Sub
gestartet wird, Process.Start
der enthält, und die sicherheitsrelevante Ausnahme erzeugt wird.
Beispiele
Die Struktur von Try... Fangen... Schließlich
Im folgenden Beispiel wird die Struktur der Try...Catch...Finally
-Anweisung veranschaulicht.
Public Sub TryExample()
' Declare variables.
Dim x As Integer = 5
Dim y As Integer = 0
' Set up structured error handling.
Try
' Cause a "Divide by Zero" exception.
x = x \ y
' This statement does not execute because program
' control passes to the Catch block when the
' exception occurs.
Console.WriteLine("end of Try block")
Catch ex As Exception
' Show the exception's message.
Console.WriteLine(ex.Message)
' Show the stack trace, which is a list of methods
' that are currently executing.
Console.WriteLine("Stack Trace: " & vbCrLf & ex.StackTrace)
Finally
' This line executes whether or not the exception occurs.
Console.WriteLine("in Finally block")
End Try
End Sub
Ausnahme in einer Methode, die aus einem Try-Block aufgerufen wird
Im folgenden Beispiel löst die CreateException
-Methode einen aus NullReferenceException
. Der Code, der die Ausnahme generiert, befindet sich nicht in einem Try
-Block. Daher behandelt die CreateException
-Methode die Ausnahme nicht. Die RunSample
-Methode behandelt die Ausnahme, da sich der Aufruf der CreateException
-Methode in einem Try
-Block befindet.
Das Beispiel enthält Catch
Anweisungen für verschiedene Arten von Ausnahmen, die von den spezifischsten bis zum allgemeinsten sortiert sind.
Public Sub RunSample()
Try
CreateException()
Catch ex As System.IO.IOException
' Code that reacts to IOException.
Catch ex As NullReferenceException
Console.WriteLine("NullReferenceException: " & ex.Message)
Console.WriteLine("Stack Trace: " & vbCrLf & ex.StackTrace)
Catch ex As Exception
' Code that reacts to any other exception.
End Try
End Sub
Private Sub CreateException()
' This code throws a NullReferenceException.
Dim obj = Nothing
Dim prop = obj.Name
' This code also throws a NullReferenceException.
'Throw New NullReferenceException("Something happened.")
End Sub
Die Catch When-Anweisung
Im folgenden Beispiel wird gezeigt, wie eine Catch When
-Anweisung verwendet wird, um nach einem bedingten Ausdruck zu filtern. Wenn der bedingte Ausdruck als True
ausgewertet wird, wird der Code im Catch
Block ausgeführt.
Private Sub WhenExample()
Dim i As Integer = 5
Try
Throw New ArgumentException()
Catch e As OverflowException When i = 5
Console.WriteLine("First handler")
Catch e As ArgumentException When i = 4
Console.WriteLine("Second handler")
Catch When i = 5
Console.WriteLine("Third handler")
End Try
End Sub
' Output: Third handler
Geschachtelte Try-Anweisungen
Das folgende Beispiel enthält eine Try…Catch
-Anweisung, die in einem Try
-Block enthalten ist. Der innere Catch
Block löst eine Ausnahme aus, deren InnerException
-Eigenschaft auf die ursprüngliche Ausnahme festgelegt ist. Der äußere Catch
Block meldet seine eigene Ausnahme und die innere Ausnahme.
Private Sub InnerExceptionExample()
Try
Try
' Set a reference to a StringBuilder.
' The exception below does not occur if the commented
' out statement is used instead.
Dim sb As System.Text.StringBuilder
'Dim sb As New System.Text.StringBuilder
' Cause a NullReferenceException.
sb.Append("text")
Catch ex As Exception
' Throw a new exception that has the inner exception
' set to the original exception.
Throw New ApplicationException("Something happened :(", ex)
End Try
Catch ex2 As Exception
' Show the exception.
Console.WriteLine("Exception: " & ex2.Message)
Console.WriteLine(ex2.StackTrace)
' Show the inner exception, if one is present.
If ex2.InnerException IsNot Nothing Then
Console.WriteLine("Inner Exception: " & ex2.InnerException.Message)
Console.WriteLine(ex2.StackTrace)
End If
End Try
End Sub
Ausnahmebehandlung für asynchrone Methoden
Im folgenden Beispiel wird die Ausnahmebehandlung für asynchrone Methoden veranschaulicht. Um eine Ausnahme abzufangen, die für eine asynchrone Aufgabe gilt, befindet sich der Await
Ausdruck in einem Try
Block des Aufrufers, und die Ausnahme wird im Catch
Block abgefangen.
Heben Sie die Auskommentierung der Zeile Throw New Exception
im Beispiel auf, um die Ausnahmebehandlung zu veranschaulichen. Die Ausnahme wird im Catch
-Block abgefangen, die -Eigenschaft der IsFaulted
Aufgabe ist auf True
festgelegt, und die -Eigenschaft des Exception.InnerException
Tasks wird auf die Ausnahme festgelegt.
Heben Sie die Auskommentierung der Zeile Throw New OperationCancelledException
auf, um zu veranschaulichen, was beim Abbrechen eines asynchronen Prozesses passiert. Die Ausnahme wird im Catch
-Block abgefangen, und die -Eigenschaft der IsCanceled
Aufgabe ist auf True
festgelegt. Unter einigen Bedingungen, die für dieses Beispiel nicht gelten, IsFaulted
ist jedoch auf True
und IsCanceled
auf False
festgelegt.
Public Async Function DoSomethingAsync() As Task
Dim theTask As Task(Of String) = DelayAsync()
Try
Dim result As String = Await theTask
Debug.WriteLine("Result: " & result)
Catch ex As Exception
Debug.WriteLine("Exception Message: " & ex.Message)
End Try
Debug.WriteLine("Task IsCanceled: " & theTask.IsCanceled)
Debug.WriteLine("Task IsFaulted: " & theTask.IsFaulted)
If theTask.Exception IsNot Nothing Then
Debug.WriteLine("Task Exception Message: " &
theTask.Exception.Message)
Debug.WriteLine("Task Inner Exception Message: " &
theTask.Exception.InnerException.Message)
End If
End Function
Private Async Function DelayAsync() As Task(Of String)
Await Task.Delay(100)
' Uncomment each of the following lines to
' demonstrate exception handling.
'Throw New OperationCanceledException("canceled")
'Throw New Exception("Something happened.")
Return "Done"
End Function
' Output when no exception is thrown in the awaited method:
' Result: Done
' Task IsCanceled: False
' Task IsFaulted: False
' Output when an Exception is thrown in the awaited method:
' Exception Message: Something happened.
' Task IsCanceled: False
' Task IsFaulted: True
' Task Exception Message: One or more errors occurred.
' Task Inner Exception Message: Something happened.
' Output when an OperationCanceledException or TaskCanceledException
' is thrown in the awaited method:
' Exception Message: canceled
' Task IsCanceled: True
' Task IsFaulted: False
Behandeln mehrerer Ausnahmen in asynchronen Methoden
Das folgende Beispiel veranschaulicht die Behandlung von Ausnahmen in Fällen, in denen mehrere Aufgaben zu mehreren Ausnahmen führen können. Der Try
-Block verfügt über den Await
Ausdruck für den zurückgegebenen Task Task.WhenAll . Die Aufgabe ist abgeschlossen, wenn die drei Aufgaben, auf die angewendet wird, Task.WhenAll abgeschlossen sind.
Jede der drei Aufgaben löst eine Ausnahme aus. Der Catch
-Block durchläuft die Ausnahmen, die sich in der Exception.InnerExceptions
-Eigenschaft der zurückgegebenen Aufgabe Task.WhenAll
befinden.
Public Async Function DoMultipleAsync() As Task
Dim theTask1 As Task = ExcAsync(info:="First Task")
Dim theTask2 As Task = ExcAsync(info:="Second Task")
Dim theTask3 As Task = ExcAsync(info:="Third Task")
Dim allTasks As Task = Task.WhenAll(theTask1, theTask2, theTask3)
Try
Await allTasks
Catch ex As Exception
Debug.WriteLine("Exception: " & ex.Message)
Debug.WriteLine("Task IsFaulted: " & allTasks.IsFaulted)
For Each inEx In allTasks.Exception.InnerExceptions
Debug.WriteLine("Task Inner Exception: " + inEx.Message)
Next
End Try
End Function
Private Async Function ExcAsync(info As String) As Task
Await Task.Delay(100)
Throw New Exception("Error-" & info)
End Function
' Output:
' Exception: Error-First Task
' Task IsFaulted: True
' Task Inner Exception: Error-First Task
' Task Inner Exception: Error-Second Task
' Task Inner Exception: Error-Third Task