SqlParameter Sınıf

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

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.

Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

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

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

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

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Devralma

Object

MarshalByRefObject

DbParameter

SqlParameter

Özellikler

TypeConverterAttribute

Uygulamalar

IDataParameter IDbDataParameter ICloneable

Örnekler

Aşağıdaki örnek içinde SqlParameterkoleksiyonu aracılığıyla SqlParameterCollection birden çok örneği SqlDataAdapter oluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri içine DataSetyerleştirmek 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 ve Configuring Parameters and Parameter Data Types Retrieving and Modifying Data.

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.

Note

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

Veri Akışı Adı	Description
SqlParameter()	SqlParameter sınıfının yeni bir örneğini başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlParameter(String, Object)	parametre adını ve yeni değerini kullanan sınıfının yeni SqlParameterbir örneğini SqlParameter başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Parametre adını, parametrenin türünü, parametresinin boyutunu, bir SqlParameter, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütununu, kullanılacak a'yı ve parametrenin değerini kullanan sınıfın yeni bir ParameterDirection örneğini DataRowVersion başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Parametre adını, parametrenin türünü, parametrenin yönünün uzunluğunu, duyarlığı, ölçeği, kaynak sütunun adını, değerlerden biriniSqlParameter, kaynak sütun eşlemesi için Boole değerini, değeriniDataRowVersion, bu XML örneği için şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfın yeni bir örneğini SqlParameter başlatır. bu XML örneğinin şema koleksiyonunun bulunduğu sahip olan ilişkisel şema ve bu parametre için şema koleksiyonunun adı. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlParameter(String, SqlDbType, Int32, String)	parametre adını, SqlParameter, boyutunu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini SqlDbType başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlParameter(String, SqlDbType, Int32)	parametre adını, SqlParameterve boyutunu kullanan sınıfın yeni bir örneğini SqlDbType başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlParameter(String, SqlDbType)	Parametre adını ve veri türünü kullanan sınıfın yeni bir örneğini SqlParameter başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Özellikler

Veri Akışı Adı	Description
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 . Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
DbType	parametresini SqlDbType alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Direction	Parametrenin yalnızca giriş, yalnızca çıkış, çift yönlü veya saklı yordam dönüş değeri parametresi olduğunu gösteren bir değer alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ForceColumnEncryption	Always Encrypted kullanılırken parametrenin şifrelenmesini 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 istemciye yanlış şifreleme meta verileri sağlayarak verilerin açığa çıkmasına neden olabilecek güvenlik saldırılarına karşı ek koruma sağlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
IsNullable	Parametresinin 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ürken null değer gönderilmesini veya alınmasını engellemez. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
LocaleId	Belirli bir bölge için kuralları ve dili belirleyen yerel ayar tanımlayıcısını alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Offset	Özelliğin uzaklığını Value alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ParameterName	öğesinin adını SqlParameteralır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Precision	Özelliği temsil Value etmek için kullanılan en fazla basamak sayısını alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Scale	Çözülecek Value ondalık basamak sayısını alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Size	Sütundaki verilerin bayt cinsinden en büyük boyutunu alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SourceColumn	ile eşlenen ve yükleme veya döndürme için kullanılan kaynak sütunun DataSetValueadını alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
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 . Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SourceVersion	yüklerken DataRowVersionkullanılacak öğesini Value alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlDbType	parametresini SqlDbType alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlValue	Parametrenin değerini SQL türü olarak alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
TypeName	Tablo değerli bir parametrenin tür adını alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
UdtTypeName	Kullanıcı tanımlı bir türü parametre olarak temsil eden bir alır veya ayarlar string . Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Value	parametresinin değerini alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
XmlSchemaCollectionDatabase	Bu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
XmlSchemaCollectionName	Bu XML örneği için şema koleksiyonunun adını alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
XmlSchemaCollectionOwningSchema	Bu XML örneğinin şema koleksiyonunun bulunduğu sahip olan ilişkisel şema. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Yöntemler

Veri Akışı Adı	Description
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()	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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	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 Objectbasit 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. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ResetSqlDbType()	Bu SqlParameterile ilişkili türü sıfırlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ToString()	öğesini içeren ParameterNamebir dize alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Belirtik Arabirim Kullanımları

Veri Akışı Adı	Description
ICloneable.Clone()	Bu üyenin açıklaması için bkz Clone(). . Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
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)

Ayrıca bkz.

• SqlParameterCollection
• SqlCommand
• Komutlar ve Parametreler
• DataAdapter Parametreleri
• SQL Server ve ADO.NET
• ADO.NET’e Genel Bakış