SqlParameterCollection Sınıf

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

ile ilişkilendirilmiş SqlCommand bir parametre koleksiyonunu ve bunların bir içindeki DataSetsütunlara 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, koleksiyonu aracılığıyla SqlParameterCollection birden çok örneği SqlParameter oluşturur. parametreler, veri kaynağındaki verileri seçmek ve doldurmak için DataSetkullanılır. Bu kod, ve'nin DataSetSqlDataAdapter 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

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

Yöntemler

Name	Description
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, Int32, String)	parametresi adı, veri türü ve sütun uzunluğu ile öğesine bir SqlParameterSqlParameterCollection ekler.
Add(String, SqlDbType, Int32)	Belirtilen parametre adı SqlDbType ve boyutuna göre öğesine bir SqlParameterSqlParameterCollectionekler.
Add(String, SqlDbType)	Verilen parametre adına ve veri türüne bir SqlParameterSqlParameterCollection ekler.
AddRange(Array)	sonuna SqlParameterCollectionbir değer dizisi ekler.
AddRange(SqlParameter[])	sonuna SqlParameterbir değer dizisi SqlParameterCollection 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çerlinin SqlParameterCollection tüm öğelerini belirtilen hedef Array dizinden başlayarak belirtilen tek boyutluya Array kopyalar.
CopyTo(SqlParameter[], Int32)	Geçerlinin SqlParameterCollection 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 nesneyi döndürür. (Devralındığı yer: DbParameterCollection)
GetParameter(String)	Belirtilen ada sahip nesneyi döndürür DbParameter . (Devralındığı yer: DbParameterCollection)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IndexOf(Object)	Belirtilen öğesinin Object koleksiyon içindeki konumunu alır.
IndexOf(SqlParameter)	Belirtilen öğesinin SqlParameter koleksiyon içindeki konumunu alır.
IndexOf(String)	Belirtilen adıyla 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 SqlParameter bir SqlParameterCollection nesne ekler.
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)
Remove(Object)	Belirtilen SqlParameter öğesini koleksiyondan kaldırır.
Remove(SqlParameter)	Belirtilen SqlParameter öğesini koleksiyondan kaldırır.
RemoveAt(Int32)	SqlParameter öğesini belirtilen dizinden SqlParameterCollection kaldırır.
RemoveAt(String)	SqlParameter öğesini belirtilen parametre adından SqlParameterCollection kaldırır.
SetParameter(Int32, DbParameter)	DbParameter Belirtilen dizindeki 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 bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

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

Uzantı Metotları

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

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ış