SqlParameterCollection 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 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

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

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

type SqlParameterCollection = class
    inherit DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

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

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Devralma: Object

DbParameterCollection
SqlParameterCollection

Devralma: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Devralma: Object

MarshalByRefObject
SqlParameterCollection

Öznitelikler: ListBindableAttribute

Uygulamalar: ICollection IEnumerable IList IDataParameterCollection

Ö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 DataSet SqlDataAdapter '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.
IsFixedSize	Koleksiyonun sabit bir boyut olup olmadığını belirtir. (Devralındığı yer: DbParameterCollection)
IsReadOnly	öğesinin salt okunur olup olmadığını SqlParameterCollection gösteren bir değer alır.
IsReadOnly	Koleksiyonun salt okunur olup olmadığını belirtir. (Devralındığı yer: DbParameterCollection)
IsSynchronized	öğesinin eşitlenip eşitlenmediğini SqlParameterCollection belirten bir değer alır.
IsSynchronized	Koleksiyonun eşitlenip eşitlenmediğini belirtir. (Devralındığı yer: DbParameterCollection)
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 SqlParameter SqlParameterCollection ekler.
Add(String, SqlDbType, Int32)	Belirtilen parametre adı SqlDbType ve boyutuna göre öğesine bir SqlParameter SqlParameterCollectionekler.
Add(String, SqlDbType, Int32, String)	parametre adı, veri türü ve sütun uzunluğu ile öğesine bir SqlParameter SqlParameterCollection 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()	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)
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()	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)
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ı

ICollection.IsSynchronized	erişimin ICollection eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli). (Devralındığı yer: DbParameterCollection)
IDataParameterCollection.Item[String]	Belirtilen dizinde parametresini alır veya ayarlar. (Devralındığı yer: DbParameterCollection)
IList.IsFixedSize	değerinin sabit bir boyuta sahip olup olmadığını IList belirten bir değer alır. (Devralındığı yer: DbParameterCollection)
IList.IsReadOnly	IList öğesinin salt okunur olup olmadığını belirten bir değer alır. (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.

Şunlara uygulanır

Aracılığıyla paylaş