IDataParameter 인터페이스

정의

네임스페이스:

System.Data

어셈블리:

netstandard.dll, System.Data.Common.dll

Source:

IDataParameter.cs

Command 개체에 대한 매개 변수를 나타내고 필요에 따라 열에 매핑 DataSet 하며 데이터 원본에 액세스하는 .NET 데이터 공급자에 의해 구현됩니다.

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

파생

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

예제

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

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

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

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

속성

Name	Description
DbType	매개 변수의 값을 DbType 가져오거나 설정합니다.
Direction	매개 변수가 입력 전용, 출력 전용, 양방향 또는 저장 프로시저 반환 값 매개 변수인지 여부를 나타내는 값을 가져오거나 설정합니다.
IsNullable	매개 변수가 null 값을 허용하는지 여부를 나타내는 값을 가져옵니다.
ParameterName	의 이름을 IDataParameter가져오거나 설정합니다.
SourceColumn	에 매핑 DataSet 되고 로드 또는 반환에 사용되는 원본 열의 Value이름을 가져오거나 설정합니다.
SourceVersion	를 로드Value할 때 사용할 값을 가져오거나 설정합니다DataRowVersion.
Value	매개 변수의 값을 가져오거나 설정합니다.