SqlErrorCollection-Klasse

Artikel
08/20/2007

Sammelt alle Fehler, die vom .NET Framework-Datenprovider für SQL Server generiert wurden. Diese Klasse kann nicht geerbt werden.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public NotInheritable Class SqlErrorCollection
    Implements ICollection, IEnumerable
'Usage
Dim instance As SqlErrorCollection

[SerializableAttribute] 
public sealed class SqlErrorCollection : ICollection, IEnumerable

[SerializableAttribute] 
public ref class SqlErrorCollection sealed : ICollection, IEnumerable

/** @attribute SerializableAttribute() */ 
public final class SqlErrorCollection implements ICollection, IEnumerable

SerializableAttribute 
public final class SqlErrorCollection implements ICollection, IEnumerable

Hinweise

Diese Klasse wird von SqlException erstellt, um Instanzen der SqlError-Klasse zu sammeln. SqlErrorCollection enthält immer mindestens eine Instanz der SqlError-Klasse.

Beispiel

Im folgenden Beispiel wird jeder SqlError in der SqlErrorCollection-Auflistung angezeigt.

Public Sub ShowSqlException(ByVal connectionString As String)
    Dim queryString As String = "EXECUTE NonExistantStoredProcedure"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        Try
            command.Connection.Open()
            command.ExecuteNonQuery()

        Catch ex As SqlException
            DisplaySqlErrors(ex)
        End Try
    End Using
End Sub

Private Sub DisplaySqlErrors(ByVal exception As SqlException)
    Dim i As Integer

    For i = 0 To exception.Errors.Count - 1
        Console.WriteLine("Index #" & i & ControlChars.NewLine & _
            "Error: " & exception.Errors(i).ToString() & ControlChars.NewLine)
    Next i
    Console.ReadLine()
End Sub

public static void ShowSqlException(string connectionString)
{
    string queryString = "EXECUTE NonExistantStoredProcedure";
    
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        try
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
        catch (SqlException ex)
        {
            DisplaySqlErrors(ex);
        }
    }
}

private static void DisplaySqlErrors(SqlException exception)
{
    for (int i = 0; i < exception.Errors.Count; i++)
    {
        Console.WriteLine("Index #" + i + "\n" +
            "Error: " + exception.Errors[i].ToString() + "\n");
    }
    Console.ReadLine();
}

Vererbungshierarchie

System.Object
System.Data.SqlClient.SqlErrorCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlErrorCollection-Member
System.Data.SqlClient-Namespace
SqlError-Klasse
SqlException

Freigeben über