다음을 통해 공유


SqlParameter 클래스

SqlCommand에 대한 매개 변수를 나타내고 DataSet 열에 대한 매개 변수의 매핑을 선택적으로 나타냅니다. 이 클래스는 상속될 수 없습니다.

네임스페이스: System.Data.SqlClient
어셈블리: System.Data(system.data.dll)

구문

‘선언
Public NotInheritable Class SqlParameter
    Inherits DbParameter
    Implements IDbDataParameter, IDataParameter, ICloneable
‘사용 방법
Dim instance As SqlParameter
public sealed class SqlParameter : DbParameter, IDbDataParameter, IDataParameter, ICloneable
public ref class SqlParameter sealed : public DbParameter, IDbDataParameter, IDataParameter, ICloneable
public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, 
    ICloneable
public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, 
    ICloneable

설명

매개 변수 이름은 대/소문자를 구분하지 않습니다.

예제

다음 예제에서는 SqlDataAdapter 내에 있는 SqlParameterCollection 컬렉션을 통해 SqlParameter의 여러 인스턴스를 만듭니다. 이들 매개 변수는 데이터 소스에서 선택한 데이터를 DataSet에 배치하는 데 사용됩니다. 이 예제에서는 DataSetSqlDataAdapter가 적절한 스키마, 명령 및 연결을 사용하여 이미 만들어진 것으로 가정합니다.

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub  
public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}

상속 계층 구조

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameter
      System.Data.SqlClient.SqlParameter

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

SqlParameter 멤버
System.Data.SqlClient 네임스페이스
SqlParameterCollection
SqlCommand 클래스