IDataParameter Arabirim

  • Başvuru

Tanım

Ad Alanı:
System.Data
Bütünleştirilmiş Kod:
System.Data.Common.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kod:
netstandard.dll

Command nesnesine ve isteğe bağlı olarak sütunlara eşlenen bir parametreyi DataSet 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ş

Örnekler

Aşağıdaki örnek, SqlParameteriçindeki koleksiyonu aracılığıyla türetilmiş sınıfının birden çok örneğini SqlParameterCollectionSqlDataAdapteroluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri öğesine DataSetyerleştirmek için kullanılır. Bu örnekte, uygun şema, komutlar ve bağlantı ile bir DataSet ve'nin SqlDataAdapter ö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 izin verir. Parametre sınıfları hakkında daha fazla bilgi için bkz. Parametreleri ve Parametre Veri Türlerini Yapılandırma.

Bir uygulama doğrudan arabirimin bir örneğini IDataParameter 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. BuradaPrv, 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

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 ve öğesini yüklemek veya döndürmek için kullanılan kaynak sütunun DataSetValueadını alır veya ayarlar.
SourceVersion

yüklenirken Valuekullanılacak öğesini DataRowVersion alır veya ayarlar.
Value

parametresinin değerini alır veya ayarlar.

Şunlara uygulanır