SqlErrorCollection クラス

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.dll

.NET Framework Data Provider for SQL Server によって生成されたすべてのエラーを収集します。 このクラスは継承できません。

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

注釈

このクラスは、SqlError クラスのインスタンスを収集するために、SqlExceptionによって作成されます。 SqlErrorCollection には常に、 SqlError クラスのインスタンスが少なくとも 1 つ含まれています。

プロパティ

名前 説明
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を参照してください。

拡張メソッド

名前 説明
AsParallel(IEnumerable)

クエリの並列化を有効にします。
AsQueryable(IEnumerable)

IEnumerable を IQueryableに変換します。
Cast<TResult>(IEnumerable)

IEnumerable の要素を指定した型にキャストします。
OfType<TResult>(IEnumerable)

指定した型に基づいて、IEnumerable の要素をフィルター処理します。

適用対象

こちらもご覧ください