SqlParameterCollection Sınıf

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

bir ile ilişkili SqlCommand parametre koleksiyonunu ve bir içindeki DataSetsütunlarla ilgili eşlemelerini temsil eder. Bu sınıf devralınamaz.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Devralma

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Öznitelikler

ListBindableAttribute

Örnekler

Aşağıdaki örnek, koleksiyon aracılığıyla SqlParameterCollection birden çok örneği SqlParameter oluşturur. Parametreler, veri kaynağındaki verileri seçmek ve doldurmak DataSetiçin kullanılır. Bu kod, ve DataSetSqlDataAdapter 'nin uygun şema, komutlar ve bağlantıyla önceden oluşturulduğunu varsayar.

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

Komut, saklı yordam adının aksine geçici bir SQL deyimi içeriyorsa, koleksiyondaki parametrelerin sayısı komut metnindeki parametre yer tutucularının sayısına eşit olmalıdır veya SQL Server bir hata oluşturur. Saklı yordamda, saklı yordamda varsayılan değer olmadan bildirilen tüm parametreler sağlanmalıdır. Varsayılan değerle bildirilen parametreler isteğe bağlıdır. Bu, varsayılan değer dışında bir değer belirtmenize olanak tanır.

Parametrelerin nasıl kullanılacağını gösteren ek örnek kod hakkında daha fazla bilgi için bkz . Komutlar ve Parametreler.

Özellikler

Count	içindeki SqlParameterCollectionöğe sayısını içeren bir Tamsayı döndürür. Salt okunur.
IsFixedSize	sabit bir boyuta sahip olup olmadığını SqlParameterCollection gösteren bir değer alır.
IsReadOnly	öğesinin salt okunur olup olmadığını SqlParameterCollection gösteren bir değer alır.
IsSynchronized	öğesinin eşitlenip eşitlenmediğini SqlParameterCollection belirten bir değer alır.
Item[Int32]	Belirtilen dizinde değerini SqlParameter alır.
Item[String]	Belirtilen ada sahip öğesini SqlParameter alır.
SyncRoot	erişimi SqlParameterCollectioneşitlemek için kullanılabilecek bir nesnesi alır.

Yöntemler

Add(Object)	Belirtilen SqlParameter nesneyi öğesine SqlParameterCollectionekler.
Add(SqlParameter)	Belirtilen SqlParameter nesneyi öğesine SqlParameterCollectionekler.
Add(String, Object)	Geçersiz. Belirtilen SqlParameter nesneyi öğesine SqlParameterCollectionekler.
Add(String, SqlDbType)	Verilen parametre adına ve veri türüne bir SqlParameterSqlParameterCollection ekler.
Add(String, SqlDbType, Int32)	Belirtilen parametre adı SqlDbType ve boyutuna göre öğesine bir SqlParameterSqlParameterCollectionekler.
Add(String, SqlDbType, Int32, String)	parametre adı, veri türü ve sütun uzunluğu ile öğesine bir SqlParameterSqlParameterCollection ekler.
AddRange(Array)	sonuna bir değer SqlParameterCollectiondizisi ekler.
AddRange(SqlParameter[])	sonuna bir değer SqlParameterCollectiondizisi SqlParameter ekler.
AddWithValue(String, Object)	sonuna SqlParameterCollectionbir değer ekler.
Clear()	içindeki tüm SqlParameter nesneleri SqlParameterCollectionkaldırır.
Contains(Object)	Belirtilen Object öğesinin bu SqlParameterCollectioniçinde olup olmadığını belirler.
Contains(SqlParameter)	Belirtilen SqlParameter öğesinin bu SqlParameterCollectioniçinde olup olmadığını belirler.
Contains(String)	Belirtilen parametre adının bu SqlParameterCollectioniçinde olup olmadığını belirler.
CopyTo(Array, Int32)	Geçerli SqlParameterCollection öğenin tüm öğelerini belirtilen hedef Array dizinden başlayarak belirtilen tek boyutluya Array kopyalar.
CopyTo(SqlParameter[], Int32)	Geçerli SqlParameterCollection öğenin tüm öğelerini belirtilen hedef dizinden başlayarak belirtilene SqlParameterCollection kopyalar.
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)
GetEnumerator()	aracılığıyla SqlParameterCollectionyineleyen bir numaralandırıcı döndürür.
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)
GetParameter(Int32)	Koleksiyonda DbParameter belirtilen dizindeki nesnesini döndürür. (Devralındığı yer: DbParameterCollection)
GetParameter(String)	Belirtilen ada sahip nesneyi döndürür DbParameter . (Devralındığı yer: DbParameterCollection)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IndexOf(Object)	Koleksiyon içinde belirtilen Object öğesinin konumunu alır.
IndexOf(SqlParameter)	Koleksiyon içinde belirtilen SqlParameter öğesinin konumunu alır.
IndexOf(String)	Belirtilen adla belirtilen SqlParameter konumu alır.
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)
Insert(Int32, Object)	belirtilen dizinde içine SqlParameterCollection bir Object ekler.
Insert(Int32, SqlParameter)	Belirtilen dizinde içine SqlParameterCollection bir SqlParameter nesne ekler.
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)
Remove(Object)	Belirtilen SqlParameter öğesini koleksiyondan kaldırır.
Remove(SqlParameter)	Belirtilen SqlParameter öğesini koleksiyondan kaldırır.
RemoveAt(Int32)	SqlParameter belirtilen dizindeki konumundan SqlParameterCollection öğesini kaldırır.
RemoveAt(String)	SqlParameter belirtilen parametre adındaki konumundan SqlParameterCollection öğesini kaldırır.
SetParameter(Int32, DbParameter)	Belirtilen dizindeki DbParameter nesneyi yeni bir değere ayarlar. (Devralındığı yer: DbParameterCollection)
SetParameter(String, DbParameter)	DbParameter Belirtilen ada sahip nesneyi yeni bir değere ayarlar. (Devralındığı yer: DbParameterCollection)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDataParameterCollection.Item[String]	Belirtilen dizinde parametresini alır veya ayarlar. (Devralındığı yer: DbParameterCollection)
IList.Item[Int32]	Belirtilen dizindeki öğeyi alır veya ayarlar. (Devralındığı yer: DbParameterCollection)

Uzantı Metotları

Cast<TResult>(IEnumerable)	öğesinin IEnumerable öğelerini belirtilen türe atar.
OfType<TResult>(IEnumerable)	Öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini etkinleştirir.
AsQueryable(IEnumerable)	bir IEnumerable öğesini öğesine IQueryabledönüştürür.

Ayrıca bkz.

• Komutlar ve Parametreler (ADO.NET)
• DataAdapter Parametreleri (ADO.NET)
• SQL Server için .NET Framework Veri Sağlayıcısı'nı kullanma
• ADO.NET’e Genel Bakış