SqlParameterCollection.IndexOf 方法

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

取得集合中指定的 SqlParameter 位置。

多載

IndexOf(SqlParameter)	取得集合中指定的 SqlParameter 位置。
IndexOf(Object)	取得集合中指定的 Object 位置。
IndexOf(String)	取得集合中具有指定名稱之指定 SqlParameter 的位置。

IndexOf(SqlParameter)

取得集合中指定的 SqlParameter 位置。

public:
 int IndexOf(System::Data::SqlClient::SqlParameter ^ value);

public int IndexOf (System.Data.SqlClient.SqlParameter value);

override this.IndexOf : System.Data.SqlClient.SqlParameter -> int

Public Function IndexOf (value As SqlParameter) As Integer

參數

value

SqlParameter

要尋找的 SqlParameter。

傳回

Int32

在集合中為 SqlParameter 的指定 SqlParameter 之以零起始位置。 當物件不存在於 SqlParameterCollection 時，傳回 -1。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

IndexOf(Object)

取得集合中指定的 Object 位置。

public:
 override int IndexOf(System::Object ^ value);

public override int IndexOf (object value);

override this.IndexOf : obj -> int

Public Overrides Function IndexOf (value As Object) As Integer

參數

value

Object

要尋找的 Object。

傳回

Int32

在集合中為 Object 的指定 SqlParameter 之以零起始位置。 當物件不存在於 SqlParameterCollection 時，傳回 -1。

範例

下列範例示範介面的實作 IList ，以建立簡單的固定大小清單。 此程式代碼是介面較大範例的 IList 一部分。

class SimpleList : IList
{
    private object[] _contents = new object[8];
    private int _count;

    public SimpleList()
    {
        _count = 0;
    }

    // IList Members
    public int Add(object value)
    {
        if (_count < _contents.Length)
        {
            _contents[_count] = value;
            _count++;

            return (_count - 1);
        }

        return -1;
    }

    public void Clear()
    {
        _count = 0;
    }

    public bool Contains(object value)
    {
        for (int i = 0; i < Count; i++)
        {
            if (_contents[i] == value)
            {
                return true;
            }
        }
        return false;
    }

    public int IndexOf(object value)
    {
        for (int i = 0; i < Count; i++)
        {
            if (_contents[i] == value)
            {
                return i;
            }
        }
        return -1;
    }

    public void Insert(int index, object value)
    {
        if ((_count + 1 <= _contents.Length) && (index < Count) && (index >= 0))
        {
            _count++;

            for (int i = Count - 1; i > index; i--)
            {
                _contents[i] = _contents[i - 1];
            }
            _contents[index] = value;
        }
    }

    public bool IsFixedSize
    {
        get
        {
            return true;
        }
    }

    public bool IsReadOnly
    {
        get
        {
            return false;
        }
    }

    public void Remove(object value)
    {
        RemoveAt(IndexOf(value));
    }

    public void RemoveAt(int index)
    {
        if ((index >= 0) && (index < Count))
        {
            for (int i = index; i < Count - 1; i++)
            {
                _contents[i] = _contents[i + 1];
            }
            _count--;
        }
    }

    public object this[int index]
    {
        get
        {
            return _contents[index];
        }
        set
        {
            _contents[index] = value;
        }
    }

    // ICollection members.

    public void CopyTo(Array array, int index)
    {
        for (int i = 0; i < Count; i++)
        {
            array.SetValue(_contents[i], index++);
        }
    }

    public int Count
    {
        get
        {
            return _count;
        }
    }

    public bool IsSynchronized
    {
        get
        {
            return false;
        }
    }

    // Return the current instance since the underlying store is not
    // publicly available.
    public object SyncRoot
    {
        get
        {
            return this;
        }
    }

    // IEnumerable Members

    public IEnumerator GetEnumerator()
    {
        // Refer to the IEnumerator documentation for an example of
        // implementing an enumerator.
        throw new NotImplementedException("The method or operation is not implemented.");
    }

    public void PrintContents()
    {
        Console.WriteLine($"List has a capacity of {_contents.Length} and currently has {_count} elements.");
        Console.Write("List contents:");
        for (int i = 0; i < Count; i++)
        {
            Console.Write($" {_contents[i]}");
        }
        Console.WriteLine();
    }
}

Public Class SimpleList
    Implements IList

    Private _contents(7) As Object
    Private _count As Integer

    Public Sub New()

        _count = 0
    End Sub

    ' IList members.
    Public Function Add(ByVal value As Object) As Integer Implements IList.Add
        If _count < _contents.Length Then
            _contents(_count) = value
            _count += 1

            Return _count - 1
        End If

        Return -1
    End Function

    Public Sub Clear() Implements IList.Clear
        _count = 0
    End Sub

    Public Function Contains(ByVal value As Object) As Boolean Implements IList.Contains
        For i As Integer = 0 To Count - 1
            If _contents(i) = value Then Return True
        Next

        Return False
    End Function

    Public Function IndexOf(ByVal value As Object) As Integer Implements IList.IndexOf
        For i As Integer = 0 To Count - 1
            If _contents(i) = value Then Return i
        Next
        Return -1
    End Function

    Public Sub Insert(ByVal index As Integer, ByVal value As Object) Implements IList.Insert

        If _count + 1 <= _contents.Length AndAlso index < Count AndAlso index >= 0 Then
            _count += 1

            For i As Integer = Count - 1 To index Step -1
                _contents(i) = _contents(i - 1)
            Next
            _contents(index) = value
        End If
    End Sub

    Public ReadOnly Property IsFixedSize() As Boolean Implements IList.IsFixedSize
        Get
            Return True
        End Get
    End Property

    Public ReadOnly Property IsReadOnly() As Boolean Implements IList.IsReadOnly
        Get
            Return False
        End Get
    End Property

    Public Sub Remove(ByVal value As Object) Implements IList.Remove
        RemoveAt(IndexOf(value))
    End Sub

    Public Sub RemoveAt(ByVal index As Integer) Implements IList.RemoveAt

        if index >= 0 AndAlso index < Count Then
            for i As Integer = index To Count - 2
                _contents(i) = _contents(i + 1)
            Next
            _count -= 1
        End If
    End Sub

    Public Property Item(ByVal index As Integer) As Object Implements IList.Item
        Get
            Return _contents(index)
        End Get

        Set(ByVal value As Object)
            _contents(index) = value
        End Set
    End Property

    ' ICollection members.
    Public Sub CopyTo(ByVal array As Array, ByVal index As Integer) Implements ICollection.CopyTo
        For i As Integer = 0 To Count - 1
            array.SetValue(_contents(i), index)
            index += 1
        Next
    End Sub

    Public ReadOnly Property Count() As Integer Implements ICollection.Count
        Get
            Return _count
        End Get
    End Property

    Public ReadOnly Property IsSynchronized() As Boolean Implements ICollection.IsSynchronized
        Get
            Return False
        End Get
    End Property

    ' Return the current instance since the underlying store is not
    ' publicly available.
    Public ReadOnly Property SyncRoot() As Object Implements ICollection.SyncRoot
        Get
            Return Me
        End Get
    End Property

    ' IEnumerable members.
    Public Function GetEnumerator() As IEnumerator Implements IEnumerable.GetEnumerator

        ' Refer to the IEnumerator documentation for an example of
        ' implementing an enumerator.
        Throw New NotImplementedException("The method or operation is not implemented.")
    End Function

    Public Sub PrintContents()
        Console.WriteLine($"List has a capacity of {_contents.Length} and currently has {_count} elements.")
        Console.Write("List contents:")

        For i As Integer = 0 To Count - 1
            Console.Write($" {_contents(i)}")
        Next

        Console.WriteLine()
    End Sub
End Class

備註

這個成員是明確介面成員實作， 只有在 SqlParameterCollection 執行個體轉換成 IList 介面時，才能使用這個成員。

從 .NET Framework 2.0 開始，這個方法會使用 集合的物件 Equals 和 CompareTo 方法item來判斷專案是否存在。 在舊版的 .NET Framework 中，此判斷是使用 Equals 集合中 對象上 參數的 item 和 CompareTo 方法來進行。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

IndexOf(String)

取得集合中具有指定名稱之指定 SqlParameter 的位置。

public:
 override int IndexOf(System::String ^ parameterName);

public override int IndexOf (string parameterName);

override this.IndexOf : string -> int

Public Overrides Function IndexOf (parameterName As String) As Integer

參數

parameterName

String

要尋找之 SqlParameter 的區分大小寫的名稱。

傳回

Int32

具有指定之區分大小寫名稱的指定 SqlParameter 以零為基底的位置。 當物件不存在於 SqlParameterCollection 時，傳回 -1。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)