다음을 통해 공유


IDataParameter 인터페이스

정의

Command 개체에 대한 매개 변수 및 선택적으로 DataSet 열에 대한 매핑을 나타내며, 데이터 소스에 액세스하는 .NET 데이터 공급자에 의해 구현됩니다.

public interface class IDataParameter
public interface IDataParameter
type IDataParameter = interface
Public Interface IDataParameter
파생

예제

다음 예제에서는 내의 컬렉션을 통해 파생 클래스 SqlParameter의 여러 인스턴스를 SqlParameterCollectionSqlDataAdapter만듭니다. 이러한 매개 변수는 데이터 원본에서 데이터를 선택하고 에 데이터를 DataSet배치하는 데 사용됩니다. 이 예제에서는 및 가 DataSetSqlDataAdapter 적절한 스키마, 명령 및 연결을 사용하여 이미 만들어졌다고 가정합니다.

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

설명

IDataParameter 인터페이스를 사용하면 상속 클래스가 Command 개체에 대한 매개 변수를 나타내는 Parameter 클래스를 구현할 수 있습니다. 매개 변수 클래스에 대 한 자세한 내용은 참조 하세요. 구성 매개 변수 및 매개 변수 데이터 형식합니다.

애플리케이션의 인스턴스를 만들지 않습니다 합니다 IDataParameter 인터페이스를 직접 상속 된 클래스의 인스턴스를 만들고 있지만 IDataParameter합니다.

상속 된 클래스 IDataParameter 상속 된 멤버를 구현 해야 하며 일반적으로 공급자 특정 기능을 추가 하기 위한 추가 멤버를 정의 합니다. 예를 들어 합니다 IDataParameter 인터페이스를 정의 합니다 DbType 속성입니다. 차례로 합니다 OleDbParameter 클래스는이 속성을 상속 하 고도 정의 합니다 OleDbType 속성입니다.

구현자 참고

.NET Framework 데이터 공급자 간의 일관성을 높이기 위해 매개 변수 형식 Prv 의 상속 클래스 이름을 지정합니다. 여기서 Prv 는 특정 .NET Framework 데이터 공급자 네임스페이스의 모든 클래스에 지정된 균일한 접두사입니다. 예를 들어 Sql 접두사입니다 합니다 SqlCommand 클래스는 System.Data.SqlClient 네임 스페이스입니다.

상속 하는 경우는 IDataParameter 인터페이스 다음 생성자를 구현 해야 합니다.

항목 설명
PrvParameter() Parameter 클래스의 새 instance 초기화합니다.
PrvParameter(string name, PrvDbType dataType) 매개 변수 이름 및 데이터 형식을 사용하여 Parameter 클래스의 새 instance 초기화합니다.
PrvParameter(문자열 이름, 개체 값) 매개 변수 이름과 Parameter 값인 개체를 사용하여 Parameter 클래스의 새 instance 초기화합니다.
PrvParameter(string name, PrvDbType dataType, int size) 매개 변수 이름, 데이터 형식 및 너비를 사용하여 Parameter 클래스의 새 instance 초기화합니다.
PrvParameter(string name, PrvDbType dataType, int size, string srcColumn) 매개 변수 이름, 데이터 형식, 너비 및 원본 열 이름을 사용하여 DbParameter 클래스의 새 instance 초기화합니다.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value) 매개 변수 이름, 데이터 형식, 너비, 원본 열 이름, 매개 변수 방향, 숫자 정밀도 및 기타 속성을 사용하여 클래스의 OleDbParameter 새 instance 초기화합니다.

속성

DbType

매개 변수의 DbType을 가져오거나 설정합니다.

Direction

매개 변수가 입력 전용, 출력 전용, 양방향 또는 저장 프로시저 반환 값 매개 변수인지 나타내는 값을 가져오거나 설정합니다.

IsNullable

매개 변수에 null 값이 허용되는지 여부를 나타내는 값을 가져옵니다.

ParameterName

IDataParameter의 이름을 가져오거나 설정합니다.

SourceColumn

DataSet으로 매핑되고 Value를 로드하거나 반환하는 데 사용되는 소스 열의 이름을 가져오거나 설정합니다.

SourceVersion

Value를 로드할 때 사용할 DataRowVersion을 가져오거나 설정합니다.

Value

매개 변수의 값을 가져오거나 설정합니다.

적용 대상