SqlErrorCollection Classe

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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)]
public sealed class SqlErrorCollection : System.Collections.ICollection

[<System.ComponentModel.ListBindable(false)>]
type SqlErrorCollection = class
    interface ICollection
    interface IEnumerable

Public NotInheritable Class SqlErrorCollection
Implements ICollection

Herança

Object

SqlErrorCollection

Atributos

ListBindableAttribute

Implementações

ICollection IEnumerable

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.

Confira também

• SqlError
• SqlException