다음을 통해 공유


SqlParameterCollection.Add 메서드

정의

SqlParameterSqlParameterCollection를 추가합니다.

오버로드

Add(SqlParameter)

SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.

Add(Object)

SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.

Add(String, SqlDbType)

매개 변수 이름과 데이터 형식을 사용하여 SqlParameterSqlParameterCollection를 추가합니다.

Add(String, Object)
사용되지 않음.

SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.

Add(String, SqlDbType, Int32)

지정된 매개 변수 이름, SqlParameter 및 크기가 제공된 경우 SqlParameterCollectionSqlDbType에 추가합니다.

Add(String, SqlDbType, Int32, String)

매개 변수 이름, 데이터 형식 및 열 길이를 사용하여 SqlParameterSqlParameterCollection를 추가합니다.

Add(SqlParameter)

SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::Data::SqlClient::SqlParameter ^ value);
public System.Data.SqlClient.SqlParameter Add (System.Data.SqlClient.SqlParameter value);
override this.Add : System.Data.SqlClient.SqlParameter -> System.Data.SqlClient.SqlParameter
member this.Add : System.Data.SqlClient.SqlParameter -> System.Data.SqlClient.SqlParameter
Public Function Add (value As SqlParameter) As SqlParameter

매개 변수

value
SqlParameter

컬렉션에 추가할 SqlParameter입니다.

반환

SqlParameter 개체입니다.

예외

value 매개 변수에 지정된 SqlParameter가 이미 현재 또는 다른 SqlParameterCollection에 추가되어 있는 경우

전달된 매개 변수가 SqlParameter가 아닌 경우

value 매개 변수가 null인 경우

예제

public void AddSqlParameter(SqlCommand command)
{
    command.Parameters.Add(new SqlParameter("Description", "Beverages"));
}
Public Sub AddSqlParameter(command As SqlCommand) 
  command.Parameters.Add(New SqlParameter("Description", "Beverages"))
End Sub

추가 정보

적용 대상

Add(Object)

SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.

public:
 override int Add(System::Object ^ value);
public:
 virtual int Add(System::Object ^ value);
public override int Add (object value);
public int Add (object value);
override this.Add : obj -> int
abstract member Add : obj -> int
override this.Add : obj -> int
Public Overrides Function Add (value As Object) As Integer
Public Function Add (value As Object) As Integer

매개 변수

value
Object

Object입니다.

반환

SqlParameter 개체의 인덱스입니다.

구현

예제

다음 예제에서는 간단한 고정 크기 목록을 만드는 인터페이스의 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 인터페이스로 캐스팅된 경우에만 사용할 수 있습니다.

추가 정보

적용 대상

Add(String, SqlDbType)

매개 변수 이름과 데이터 형식을 사용하여 SqlParameterSqlParameterCollection를 추가합니다.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);
override this.Add : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter
member this.Add : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameter

매개 변수

parameterName
String

매개 변수의 이름입니다.

sqlDbType
SqlDbType

SqlDbType 값 중 하나입니다.

반환

SqlParameter 개체입니다.

예제

public void AddSqlParameter(SqlCommand command)
{
    SqlParameter param = command.Parameters.Add(
        "@Description", SqlDbType.NVarChar);
    param.Size = 16;
    param.Value = "Beverages";
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As SqlParameter = command.Parameters.Add( _
      "@Description", SqlDbType.NVarChar)
  param.Size = 16
  param.Value = "Beverages"
End Sub

추가 정보

적용 대상

Add(String, Object)

주의

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202

SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);
public System.Data.SqlClient.SqlParameter Add (string parameterName, object value);
[System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)]
public System.Data.SqlClient.SqlParameter Add (string parameterName, object value);
member this.Add : string * obj -> System.Data.SqlClient.SqlParameter
[<System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)>]
override this.Add : string * obj -> System.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, value As Object) As SqlParameter

매개 변수

parameterName
String

컬렉션에 추가할 SqlParameter의 이름입니다.

value
Object

Object

반환

SqlParameter 개체입니다.

SqlParameterCollection.Add 메서드 오버로드를 사용하여 정수 매개 변수 값을 지정할 때는 주의해야 합니다. 이 오버로드는 Object 형식의 value를 사용하므로 다음 C# 예제와 같이 값이 0인 경우 정수 계열 값을 Object 형식으로 변환해야 합니다.

parameters.Add("@pname", Convert.ToInt32(0));

이 변환을 수행하지 않으면 컴파일러는 사용자가 SqlParameterCollection.Add(string, SqlDbType) 오버로드를 호출하는 것으로 가정합니다.

특성

예외

value 매개 변수에 지정된 SqlParameter가 이미 현재 또는 다른 SqlParameterCollection에 추가되어 있는 경우

value 매개 변수가 null인 경우

예제

public void AddSqlParameter(SqlCommand command)
{
    SqlParameter param = new SqlParameter(
        "@Description", SqlDbType.NVarChar, 16);
    param.Value = "Beverages";
    command.Parameters.Add(param);
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As New SqlParameter( _
      "@Description", SqlDbType.NVarChar, 16)
  param.Value = "Beverages"
  command.Parameters.Add(param)
End Sub

추가 정보

적용 대상

Add(String, SqlDbType, Int32)

지정된 매개 변수 이름, SqlParameter 및 크기가 제공된 경우 SqlParameterCollectionSqlDbType에 추가합니다.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);
override this.Add : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter
member this.Add : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameter

매개 변수

parameterName
String

매개 변수의 이름입니다.

sqlDbType
SqlDbType

컬렉션에 추가할 SqlParameterSqlDbType입니다.

size
Int32

Int32로 나타낸 크기입니다

반환

SqlParameter 개체입니다.

예제

public void AddSqlParameter(SqlCommand command)
{
    SqlParameter param = new SqlParameter(
        "@Description", SqlDbType.NVarChar, 16);
    param.Value = "Beverages";
    command.Parameters.Add(param);
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As New SqlParameter( _
      "@Description", SqlDbType.NVarChar, 16)
  param.Value = "Beverages"
  command.Parameters.Add(param)
End Sub

설명

이 오버로드는 또는 binary와 같은 varchar 가변 길이 데이터 형식의 매개 변수를 추가할 때 유용합니다.

추가 정보

적용 대상

Add(String, SqlDbType, Int32, String)

매개 변수 이름, 데이터 형식 및 열 길이를 사용하여 SqlParameterSqlParameterCollection를 추가합니다.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);
member this.Add : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter
override this.Add : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameter

매개 변수

parameterName
String

매개 변수의 이름입니다.

sqlDbType
SqlDbType

SqlDbType 값 중 하나입니다.

size
Int32

열 길이입니다.

sourceColumn
String

SqlParameterUpdate에 대한 호출에 사용되는 경우 소스 열(SourceColumn)의 이름입니다.

반환

SqlParameter 개체입니다.

예제

public void AddSqlParameter(SqlCommand cmd)
{
  SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
}
Public Sub AddSqlParameter(cmd As SqlCommand) 
  Dim p1 As SqlParameter = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description")
End Sub

추가 정보

적용 대상