SqlErrorCollection 類別

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

收集 .NET Framework Data Provider for SQL Server 所產生的所有錯誤。 此類別無法獲得繼承。

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

繼承

Object

SqlErrorCollection

屬性

ListBindableAttribute

實作

ICollection IEnumerable

範例

下列範例會顯示集合內的每一個 SqlErrorSqlErrorCollection 。

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";
    }
}

備註

這個類別是由 建立 SqlException 來收集 類別的 SqlError 實例。 SqlErrorCollection 一律包含至少一個 類別的 SqlError 實例。

屬性

Count	取得集合中的錯誤數目。
Item[Int32]	取得在指定之索引處的錯誤。

方法

CopyTo(Array, Int32)	從指定的索引開始，將 SqlErrorCollection 集合的項目複製到 Array。
CopyTo(SqlError[], Int32)	從指定的索引開始，將 SqlErrorCollection 集合的項目複製到 SqlErrorCollection。
GetEnumerator()	傳回在 SqlErrorCollection 中逐一查看的列舉值。

明確介面實作

ICollection.IsSynchronized	如需這個成員的說明，請參閱 IsSynchronized。
ICollection.SyncRoot	如需這個成員的說明，請參閱 SyncRoot。

另請參閱

• SqlError
• SqlException