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
Paket:
System.Data.SqlClient v4.8.6

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 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.
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 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()
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

Ayrıca bkz.