SQL Server: So behandelt man Ausnahmefehler in der Datenschicht

Im folgenden Code verwendet die als Beispiel dienende gespeicherte Prozedur diese Features zum Aktualisieren eines einzelnen Datensatzes in der Beispieldatenbank Nordwind. Sie setzt das Feld für die Telefonnummer auf einen der Prozedur übergebenen Wert, aber nur, wenn kein Fehler auftritt. Falls Probleme den Ablauf stören, wird ein negativer Rückgabewert ausgegeben – falls alles ohne Probleme ausgeführt werden kann, ein positiver.

<br /> CREATE PROCEDURE sp_UpdateCustomerPhone<br /> (<br /> @id nvarchar(5),<br /> @phone nvarchar(24),<br /> @retvalueint output<br /> ) AS<br /> BEGIN<br /> BEGIN TRANSACTION<br /> UPDATE [dbo].[Customers] SET [Phone] = @phone WHERE<br /> ([CustomerID] = @id)<br /> IF (@@ERROR 0) — ein nicht negativer Wert signalisiert einen Fehler<br /> BEGIN<br /> ROLLBACK TRANSACTION — Änderungen sind nicht permanent<br /> RAISERROR(‚Update Customers Error‘,1,1) — definiert eine selbstdefinierte Fehlermeldung<br /> — Fehlermeldung erscheint, wenn von Konsole gestartet<br /> SET @retvalue = -1 — Rückgabe eines negativen Werts signalisiert Probleme<br /> END<br /> COMMIT TRANSACTION — macht die Änderungen permanent<br /> SET @retvalue = 1 — ein positiver Rückgabewert signalisiert erfolgreiche Aktualisierung<br /> RETURN<br /> END<br />

Rückgabewerte von gespeicherten Prozeduren verwenden

Da die gespeicherte Prozedur Rückgabewerte liefert, kann man diese in seinem .NET-Code verwenden. Das Objekt SqlCommand ermöglicht ein einfaches Hinzufügen von Parametern zum Übergeben an die Prozedur sowie das Speichern von Rückgabewerten. Die Eigenschaft Direction des Parameters wird verwendet, um Rückgabewerte vom Aufruf einer gespeicherten Prozedur zu erhalten. Sie kann zwei Werte annehmen: InputOutput und Output. Im Beispiel wird Output verwendet, um den Statuswert zu erhalten.

Der Code ist eine einfache ASP.NET-Seite, die einen neuen Wert für einen bestimmten Eintrag in der Kundentabelle der Nordwind-Datenbank übergibt. Der ID-Wert wird in einem versteckten Feld gespeichert. Er könnte einfach an das Formular übergeben werden, aber das Feld funktioniert zu Demonstrationszwecken. Der in ein Textfeld eingegebene Wert wird verwendet, um das Feld mit der Telefonnummer in der Datenbanktabelle zu aktualisieren.

Die Parameter werden dem SqlCommand-Objekt hinzugefügt. Sie müssen exakt den Parameterwerten der gespeicherten Prozedur entsprechen. Der Befehl wird mithilfe der ExecuteNonQuery-Methode des SqlCommand-Objekts ausgeführt. Sobald der Befehl ausgeführt wurde, kann der Rückgabewert über diese Parameter abgerufen werden.

Der Code überprüft den Rückgabewert (-1 zeigt ein Problem an), und eine Meldung wird in einem Label-Steuerelement angezeigt. Außerdem wird ein try/catch-Block verwendet, um schwerwiegende Fehler abzufangen, die bei der Interaktion mit der Datenbank auftreten können.

</p> <p><title>ZDNet Developer – Test </title></p> <p>private SqlConnectionconn<br /> = null;<br /> private SqlCommandcmd =<br /> null;<br /> private String connString;<br /> private intrvalue;<br /> public void SubmitChanges() {<br /> connString = „data source=localhost;uid=test;pwd=test;initial catalog=Northwind“;<br /> try {<br /> conn = new SqlConnection(connString);<br /> cmd = new SqlCommand(„sp_UpdateCustomerPhone“, conn);<br /> cmd.CommandType = CommandType.StoredProcedure;<br /> cmd.Parameters.Add(„@id“, SqlDbType.NVarChar, 5);<br /> cmd.Parameters[„@id“].Value = lblID.Text;<br /> cmd.Parameters.Add(„@phone“, SqlDbType.NVarChar, 24);<br /> cmd.Parameters[„@phone“].Value = txtPhone.Text;<br /> cmd.Parameters.Add(„@retvalue“,<br /> System.Data.SqlDbType.Int);<br /> cmd.Parameters[„@retvalue“].Direction<br /> = ParameterDirection.Output;<br /> conn.Open();<br /> cmd.ExecuteNonQuery();<br /> rvalue = (int)cmd.Parameters[„@retvalue“].Value;<br /> if (rvalue == -1) {<br /> lblMessage.Text = „Datenbankfehler während des<br /> Updates.“;<br /> lblMessage.Visible = True;<br /> } else {<br /> lblMessage.Text = „Daten wurden aktualisiert.“; lblMessage.Visible = True;<br /> } conn.Close();<br /> } catch (SqlException ex) {<br /> lblMessage.Text = „Fehler beim Datenbankzugriff: “ + ex.ToString();<br /> } catch (Exception ex) {<br /> lblMessage.Text = „Ausnahme: “ + ex.ToString();<br /> } finally {<br /> if (conn.State == ConnectionState.Open)<br /> {<br /> conn.Close();<br /> }<br /> conn.Dispose();<br /> } }<br /> private void btnUpdatePhone_Click(object sender, System.EventArgs e) {<br /> SubmitChanges();<br /> }</p> <p>New Number:</p> <p>ALFKI</p> <p>