Dil

SqlParameterCollection Sınıf

Tanım

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.

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

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
SqlParameterCollection
Devralma
Devralma
SqlParameterCollection
Özellikler
Uygulamalar

Örnekler

Aşağıdaki örnek, koleksiyonu aracılığıyla SqlParameter birden çok örneği SqlParameterCollection 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

Veri Akışı Adı Description
Count

içindeki SqlParameterCollectionöğe sayısını içeren bir Tamsayı döndürür. Read-only.

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

IsFixedSize

SqlParameterCollection sabit bir boyuta sahip olup olmadığını gösteren bir değer alır.

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

IsReadOnly

SqlParameterCollection salt okunur olup olmadığını gösteren bir değer alır.

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

IsSynchronized

öğesinin eşitlenip eşitlenmediğini SqlParameterCollection gösteren bir değer alır.

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

Item[Int32]

belirtilen dizinde alır SqlParameter .

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

Item[String]

SqlParameter Belirtilen ada sahip öğesini alır.

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

SyncRoot

SqlParameterCollectionerişimini eşitlemek için kullanılabilecek bir nesnesi alır.

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

Yöntemler

Veri Akışı Adı Description
Add(Object)

Belirtilen SqlParameter nesneyi öğesine SqlParameterCollectionekler.

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

Add(SqlParameter)

Belirtilen SqlParameter nesneyi öğesine SqlParameterCollectionekler.

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

Add(String, Object)
Geçersiz.

Belirtilen SqlParameter nesneyi öğesine SqlParameterCollectionekler.

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

Add(String, SqlDbType, Int32, String)

parametresi adı, veri türü ve sütun uzunluğu ile öğesine bir SqlParameterSqlParameterCollection ekler.

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

Add(String, SqlDbType, Int32)

Belirtilen parametre adı SqlParameter ve boyutuna göre öğesine bir SqlParameterCollectionSqlDbTypeekler.

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

Add(String, SqlDbType)

Verilen parametre adına ve veri türüne bir SqlParameterSqlParameterCollection ekler.

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

AddRange(Array)

sonuna SqlParameterCollectionbir değer dizisi ekler.

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

AddRange(SqlParameter[])

sonuna SqlParameterbir değer dizisi SqlParameterCollection ekler.

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

AddWithValue(String, Object)

sonuna SqlParameterCollectionbir değer ekler.

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

Clear()

içindeki tüm SqlParameter nesneleri SqlParameterCollectionkaldırır.

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

Contains(Object)

Belirtilen Object öğesinin bu SqlParameterCollectioniçinde olup olmadığını belirler.

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

Contains(SqlParameter)

Belirtilen SqlParameter öğesinin bu SqlParameterCollectioniçinde olup olmadığını belirler.

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

Contains(String)

Belirtilen parametre adının bu SqlParameterCollectioniçinde olup olmadığını belirler.

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

CopyTo(Array, Int32)

Geçerlinin SqlParameterCollection tüm öğelerini belirtilen hedef Array dizinden başlayarak belirtilen tek boyutluya Array kopyalar.

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

CopyTo(SqlParameter[], Int32)

Geçerlinin SqlParameterCollection tüm öğelerini belirtilen hedef dizinden başlayarak belirtilene SqlParameterCollection kopyalar.

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

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.

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

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

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

IndexOf(SqlParameter)

Belirtilen öğesinin SqlParameter koleksiyon içindeki konumunu alır.

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

IndexOf(String)

Belirtilen adıyla belirtilen SqlParameter konumu alır.

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

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 Object bir SqlParameterCollection ekler.

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

Insert(Int32, SqlParameter)

Belirtilen dizinde içine SqlParameter bir SqlParameterCollection nesne ekler.

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

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.

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

Remove(SqlParameter)

Belirtilen SqlParameter öğesini koleksiyondan kaldırır.

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

RemoveAt(Int32)

SqlParameter öğesini belirtilen dizinden SqlParameterCollection kaldırır.

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

RemoveAt(String)

SqlParameter öğesini belirtilen parametre adından SqlParameterCollection kaldırır.

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

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ı

Veri Akışı Adı Description
ICollection.IsSynchronized

'a ICollection erişimin 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

öğesinin salt okunur olup olmadığını IList belirten bir değer alır.

(Devralındığı yer: DbParameterCollection)
IList.Item[Int32]

Belirtilen dizinde öğesini alır veya ayarlar.

(Devralındığı yer: DbParameterCollection)

Uzantı Metotları

Veri Akışı Adı 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.

Şunlara uygulanır

Ayrıca bkz.