SqlErrorCollection Classe

Definição

Coleta todos os erros gerados pelo Provedor de Dados .NET Framework para SQL Server.Collects all errors generated by the .NET Framework Data Provider for SQL Server. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class SqlErrorCollection sealed : System::Collections::ICollection
public sealed class SqlErrorCollection : System.Collections.ICollection
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public sealed class SqlErrorCollection : System.Collections.ICollection
type SqlErrorCollection = class
    interface ICollection
    interface IEnumerable
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type SqlErrorCollection = class
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlErrorCollection
Implements ICollection
Herança
SqlErrorCollection
Atributos
Implementações

Exemplos

O exemplo a seguir exibe cada SqlError uma dentro da SqlErrorCollection coleção.The following example displays each SqlError within the SqlErrorCollection collection.

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

Comentários

Essa classe é criada pelo SqlException para coletar instâncias da SqlError classe.This class is created by SqlException to collect instances of the SqlError class. SqlErrorCollection sempre contém pelo menos uma instância da SqlError classe.SqlErrorCollection always contains at least one instance of the SqlError class.

Propriedades

Count

Obtém o número de erros na coleção.Gets the number of errors in the collection.

Item[Int32]

Obtém o erro no índice especificado.Gets the error at the specified index.

Métodos

CopyTo(Array, Int32)

Copia os elementos da coleção SqlErrorCollection para um Array, começando no índice especificado.Copies the elements of the SqlErrorCollection collection into an Array, starting at the specified index.

CopyTo(SqlError[], Int32)

Copia os elementos da coleção SqlErrorCollection para um SqlErrorCollection, começando no índice especificado.Copies the elements of the SqlErrorCollection collection into a SqlErrorCollection, starting at the specified index.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEnumerator()

Retorna um enumerador que itera por meio de SqlErrorCollection.Returns an enumerator that iterates through the SqlErrorCollection.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

ICollection.IsSynchronized

Para obter uma descrição desse membro, confira IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Para obter uma descrição desse membro, confira SyncRoot.For a description of this member, see SyncRoot.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Confira também