SqlErrorCollection 类

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.dll

收集用于 SQL Server 的 .NET Framework 数据提供程序生成的所有错误。 此类不能被继承。

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)>]
[<System.Serializable>]
type SqlErrorCollection = class
    interface ICollection
    interface IEnumerable

Public NotInheritable Class SqlErrorCollection
Implements ICollection

继承

Object

SqlErrorCollection

属性

ListBindableAttribute SerializableAttribute

实现

ICollection IEnumerable

示例

以下示例显示 SqlError 集合中的每个 SqlErrorCollection 。

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

注解

此类由 创建 SqlException ，用于收集类的 SqlError 实例。 SqlErrorCollection 始终至少包含类的 SqlError 一个实例。

属性

Count	获取集合中错误的数目。
Item[Int32]	获取位于指定索引处的错误。

方法

CopyTo(Array, Int32)	将 SqlErrorCollection 集合的元素复制到 Array 中，从指定索引开始。
CopyTo(SqlError[], Int32)	将 SqlErrorCollection 集合的元素复制到 SqlErrorCollection 中，从指定索引开始。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回循环访问 SqlErrorCollection 的枚举数。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.IsSynchronized	有关此成员的说明，请参见 IsSynchronized。
ICollection.SyncRoot	有关此成员的说明，请参见 SyncRoot。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

另请参阅

• SqlError
• SqlException
• ADO.NET 概述