Compartilhar via


SqlErrorCollection Classe

Definição

Coleta todos os erros gerados pelo Provedor de Dados .NET Framework para SQL Server. Essa classe não pode ser herdada.

public ref class SqlErrorCollection sealed : System::Collections::ICollection
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public sealed class SqlErrorCollection : System.Collections.ICollection
[System.ComponentModel.ListBindable(false)]
public sealed class SqlErrorCollection : System.Collections.ICollection
public sealed class SqlErrorCollection : System.Collections.ICollection
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type SqlErrorCollection = class
    interface ICollection
    interface IEnumerable
[<System.ComponentModel.ListBindable(false)>]
type SqlErrorCollection = class
    interface ICollection
    interface IEnumerable
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 um dentro da SqlErrorCollection coleção.

using Microsoft.Data.SqlClient;
using System.Text;

class Program
{
    static void Main()
    {
        string s = GetConnectionString();
        ShowSqlException(s);
        Console.ReadLine();
    }
    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();
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
    }
}

Comentários

Essa classe é criada por SqlException para coletar instâncias da SqlError classe . SqlErrorCollection sempre contém pelo menos uma instância da SqlError classe .

Propriedades

Count

Obtém o número de erros na coleção.

Item[Int32]

Obtém o erro no índice especificado.

Métodos

CopyTo(Array, Int32)

Copia os elementos da coleção SqlErrorCollection para um Array, começando no índice especificado.

CopyTo(SqlError[], Int32)

Copia os elementos da coleção SqlErrorCollection para um SqlErrorCollection, começando no índice especificado.

GetEnumerator()

Retorna um enumerador que itera por meio de SqlErrorCollection.

Implantações explícitas de interface

ICollection.IsSynchronized

Para obter uma descrição desse membro, confira IsSynchronized.

ICollection.SyncRoot

Para obter uma descrição desse membro, confira SyncRoot.

Aplica-se a

Confira também