SqlParameter Sınıf

Başvuru

Tanım

Ad Alanı:: System.Data.SqlClient

Bütünleştirilmiş Kod:: System.Data.SqlClient.dll

Bütünleştirilmiş Kod:: System.Data.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

bir parametresini SqlCommand temsil eder ve isteğe bağlı olarak sütunlara eşler DataSet . Bu sınıf devralınamaz. Parametreler hakkında daha fazla bilgi için bkz. Parametreleri ve Parametre Veri Türlerini Yapılandırma.

public ref class SqlParameter sealed : System::Data::Common::DbParameter

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

type SqlParameter = class
    inherit DbParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Devralma: Object

DbParameter
SqlParameter

Devralma: Object

MarshalByRefObject

DbParameter
SqlParameter

Devralma: Object

MarshalByRefObject
SqlParameter

Öznitelikler: TypeConverterAttribute

Uygulamalar: IDataParameter IDbDataParameter ICloneable

Örnekler

Aşağıdaki örnek içinde SqlDataAdapterkoleksiyonu aracılığıyla SqlParameterCollection birden çok örneği SqlParameter oluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri içine DataSetkoymak için kullanılır. Bu örnekte, uygun şema, komutlar ve bağlantı kullanılarak bir DataSet ve'nin SqlDataAdapter önceden oluşturulduğu varsayılır. Parametreleri kullanma hakkında daha fazla bilgi ve ek örnekler için bkz. ADO.NET'de Verileri Alma ve Değiştirme ve Parametreleri ve Parametre Veri Türlerini Yapılandırma.

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

Parametre adları büyük/küçük harfe duyarlı değildir.

Not

Sıralı olarak da adlandırılan adsız parametreler, SQL Server için .NET Framework Veri Sağlayıcısı tarafından desteklenmez.

Parametrelerin nasıl kullanılacağını gösteren ek örnek kodun yanı sıra daha fazla bilgi için bkz . Komutlar ve Parametreler.

Oluşturucular

SqlParameter()	SqlParameter sınıfının yeni bir örneğini başlatır.
SqlParameter(String, Object)	parametre adını ve yeni değerini kullanan sınıfının yeni SqlParameterbir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType)	Parametre adını ve veri türünü kullanan sınıfının yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32)	parametre adı, SqlDbTypeve boyutunu kullanan sınıfının yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Parametre adını, parametrenin türünü, parametrenin boyutunu, bir ParameterDirection, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütunu, kullanılacak a'yı ve parametrenin değerini kullanan sınıfının yeni bir DataRowVersion örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Parametre adını, parametre türünü, parametrenin yönünün uzunluğunu, duyarlığı, ölçeği, kaynak sütunun adını, değerlerden biriniDataRowVersion, kaynak sütun eşlemesi için Boole değerini, değerini, `SqlParameter`bu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfının yeni bir örneğini SqlParameter başlatır. bu XML örneği için şema koleksiyonunun bulunduğu sahip olan ilişkisel şema ve bu parametre için şema koleksiyonunun adı.
SqlParameter(String, SqlDbType, Int32, String)	Parametre adı, SqlDbType, boyutu ve kaynak sütun adını kullanan sınıfının yeni bir örneğini SqlParameter başlatır.

Özellikler

CompareInfo	Bu parametre için dize karşılaştırmalarının nasıl gerçekleştirilmesi gerektiğini tanımlayan nesneyi alır veya ayarlar CompareInfo .
DbType	parametresini SqlDbType 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.
ForceColumnEncryption	Always Encrypted kullanılırken parametre şifrelemesini zorlar. SQL Server, sürücüye parametrenin şifrelenmesinin gerekmediğini bildirirse, parametresini kullanan sorgu başarısız olur. Bu özellik, güvenliği aşılmış bir SQL Server'ın istemciye yanlış şifreleme meta verileri sağlamasını içeren güvenlik saldırılarına karşı ek koruma sağlar ve bu da verilerin açığa çıkmasına neden olabilir.
IsNullable	Parametrenin null değerleri kabul edip etmediğini belirten bir değer alır veya ayarlar. IsNullable parametresinin değerini doğrulamak için kullanılmaz ve komut yürütülürken null değer gönderilmesini veya alınmasını engellemez.
LocaleId	Belirli bir bölge için kuralları ve dili belirleyen yerel ayar tanımlayıcısını alır veya ayarlar.
Offset	Uzaklığı özelliğine Value alır veya ayarlar.
ParameterName	adını SqlParameteralır veya ayarlar.
Precision	Özelliği temsil Value etmek için kullanılan en fazla basamak sayısını alır veya ayarlar.
Scale	Çözümlenen ondalık basamak Value sayısını alır veya ayarlar.
Size	Sütundaki verilerin bayt cinsinden en büyük boyutunu alır veya ayarlar.
SourceColumn	öğesini yüklemek veya döndürmek için kullanılan ve ile eşlenen kaynak sütunun DataSet Valueadını alır veya ayarlar.
SourceColumnNullMapping	Kaynak sütunun null atanabilir olup olmadığını gösteren bir değer alır veya ayarlar. Bu, boş değer atanabilir sütunlar için Update deyimlerinin doğru şekilde oluşturulmasını sağlar SqlCommandBuilder .
SourceVersion	yüklediğinizde Valuekullanılacak öğesini DataRowVersion alır veya ayarlar.
SourceVersion	yüklediğinizde Valuekullanılacak öğesini DataRowVersion alır veya ayarlar. (Devralındığı yer: DbParameter)
SqlDbType	parametresini SqlDbType alır veya ayarlar.
SqlValue	Parametrenin değerini SQL türü olarak alır veya ayarlar.
TypeName	Tablo değerli bir parametrenin tür adını alır veya ayarlar.
UdtTypeName	Kullanıcı tanımlı bir `string` türü parametre olarak temsil eden bir alır veya ayarlar.
Value	parametresinin değerini alır veya ayarlar.
XmlSchemaCollectionDatabase	Bu XML örneği için şema koleksiyonunun bulunduğu veritabanının adını alır.
XmlSchemaCollectionName	Bu XML örneği için şema koleksiyonunun adını alır.
XmlSchemaCollectionOwningSchema	Bu XML örneği için şema koleksiyonunun bulunduğu sahip olan ilişkisel şema.

Yöntemler

CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ResetDbType()	Bu SqlParameterile ilişkili türü sıfırlar.
ResetSqlDbType()	Bu SqlParameterile ilişkili türü sıfırlar.
ToString()	öğesini içeren ParameterNamebir dize alır.

Belirtik Arabirim Kullanımları

ICloneable.Clone()	Bu üyenin açıklaması için bkz Clone(). .
IDataParameter.SourceVersion	yüklerken Valuekullanılacak öğesini DataRowVersion alır veya ayarlar. (Devralındığı yer: DbParameter)
IDbDataParameter.Precision	Sayısal parametrelerin duyarlığı gösterir. (Devralındığı yer: DbParameter)
IDbDataParameter.Scale	Bu üyenin açıklaması için bkz Scale. . (Devralındığı yer: DbParameter)

Şunlara uygulanır

Aracılığıyla paylaş