IDataParameter Arabirim

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

IDataParameter.cs

Command nesnesine ve isteğe bağlı olarak sütunlara eşlemesine DataSet yönelik bir parametreyi temsil eder ve veri kaynaklarına erişen .NET veri sağlayıcıları tarafından uygulanır.

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

Türetilmiş

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

Örnekler

Aşağıdaki örnek, SqlParameteriçindeki SqlDataAdapterkoleksiyonu aracılığıyla türetilmiş sınıfın SqlParameterCollection birden çok örneğini oluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri öğesine DataSetyerleştirmek için kullanılır. Bu örnekte, ve'nin DataSetSqlDataAdapter uygun şema, komutlar ve bağlantıyla önceden oluşturulduğu varsayılır.

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

Açıklamalar

arabirimi, IDataParameter devralan bir sınıfın Command nesnesine bir parametreyi temsil eden bir Parameter sınıfı uygulamasına olanak tanır. Parametre sınıfları hakkında daha fazla bilgi için bkz. Parametreleri ve Parametre Veri Türlerini Yapılandırma.

Uygulama doğrudan arabirimin IDataParameter bir örneğini oluşturmaz, ancak devralan IDataParameterbir sınıfın örneğini oluşturur.

Devralan IDataParameter sınıfların devralınan üyeleri uygulaması ve genellikle sağlayıcıya özgü işlevler eklemek için ek üyeler tanımlaması gerekir. Örneğin, IDataParameter arabirimi özelliğini tanımlar DbType . Buna karşılık, OleDbParameter sınıfı bu özelliği devralır ve ayrıca özelliğini tanımlar OleDbType .

Uygulayanlara Notlar

.NET Framework veri sağlayıcıları arasında tutarlılığı artırmak için devralan sınıfı Parametre biçiminde Prv adlandırın. Burada Prv , belirli bir .NET Framework veri sağlayıcısı ad alanında tüm sınıflara verilen tekdüzen ön ektir. Örneğin, Sql ad alanında System.Data.SqlClient sınıfının ön ekidirSqlCommand.

Arabiriminden IDataParameter devraldığınızda aşağıdaki oluşturucuları uygulamanız gerekir:

Öğe	Açıklama
PrvParameter()	Parameter sınıfının yeni bir örneğini başlatır.
PrvParameter(dize adı, PrvDbType dataType)	Parametre adı ve veri türüyle Parameter sınıfının yeni bir örneğini başlatır.
PrvParameter(dize adı, nesne değeri)	Parametre adı ve Parametre değeri olan bir nesne ile Parameter sınıfının yeni bir örneğini başlatır.
PrvParameter(dize adı, PrvDbType dataType, int size)	Parametre adı, veri türü ve genişlik ile Parameter sınıfının yeni bir örneğini başlatır.
PrvParameter(dize adı, PrvDbType dataType, int size, string srcColumn)	DbParameter sınıfının yeni bir örneğini parametre adı, veri türü, genişlik ve kaynak sütun adıyla başlatır.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, nesne değeri)	Parametre adı, veri türü, genişlik, kaynak sütun adı, parametre yönü, sayısal duyarlık ve diğer özelliklerle sınıfın yeni bir örneğini OleDbParameter başlatır.

Özellikler

Name	Description
DbType	parametresini DbType alır veya ayarlar.
Direction	Parametrenin yalnızca giriş, yalnızca çıkış, çift yönlü veya saklı yordam dönüş değeri parametresi olduğunu belirten bir değer alır veya ayarlar.
IsNullable	Parametresinin null değerleri kabul edip etmediğini belirten bir değer alır.
ParameterName	öğesinin adını IDataParameteralır veya ayarlar.
SourceColumn	ile eşlenen DataSet ve yükleme veya döndürme için kullanılan kaynak sütunun Valueadını alır veya ayarlar.
SourceVersion	yüklerken Valuekullanılacak öğesini DataRowVersion alır veya ayarlar.
Value	parametresinin değerini alır veya ayarlar.