SqlParameterCollection Sınıf

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

bir ve ilgili eşlemeleriyle SqlCommand ilişkili parametre koleksiyonunu bir DataSetiçindeki sütunlara 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

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 öğesini doldurmak için DataSetkullanılır. Bu kod, uygun şema, komutlar ve bağlantı ile bir DataSet ve'nin SqlDataAdapter önceden oluşturulduğunu varsayar.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    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);

    }
}

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 kodla ilgili daha fazla bilgi için bkz . Komutlar ve Parametreler.

Özellikler

Count	içindeki SqlParameterCollectionöğelerin sayısını içeren bir Tamsayı döndürür. Salt okunur.
IsFixedSize	değerinin sabit bir boyuta sahip olup olmadığını SqlParameterCollection belirten bir değer alır.
IsReadOnly	öğesinin salt okunur olup olmadığını SqlParameterCollection belirten bir değer alır.
Item[Int32]	Belirtilen dizinde değerini SqlParameter alır.
Item[String]	SqlParameter belirtilen ada sahip öğesini 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, 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)	parametresi adı, veri türü ve sütun uzunluğu ile öğesine bir SqlParameterSqlParameterCollection ekler.
AddRange(Array)	sonuna SqlParameterCollectionbir değer dizisi ekler.
AddRange(SqlParameter[])	sonuna SqlParameterCollectionbir değer dizisi 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 içinde SqlParameterCollectionolup olmadığını belirler.
Contains(SqlParameter)	Belirtilen SqlParameter öğesinin içinde SqlParameterCollectionolup 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.
GetEnumerator()	aracılığıyla SqlParameterCollectionyineleyen bir numaralandırıcı döndürür.
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 adla belirtilen SqlParameter konumu alır.
Insert(Int32, Object)	Belirtilen dizinde içine SqlParameterCollection bir Object ekler.
Insert(Int32, SqlParameter)	Belirtilen dizinde öğesine SqlParameterCollection bir SqlParameter nesne ekler.
Remove(Object)	Belirtilen SqlParameter öğesini koleksiyondan kaldırır.
Remove(SqlParameter)	Belirtilen SqlParameter öğesini koleksiyondan kaldırır.
RemoveAt(Int32)	SqlParameter belirtilen dizinden öğesini SqlParameterCollection kaldırır.
RemoveAt(String)	SqlParameter öğesini belirtilen parametre adından SqlParameterCollection kaldırır.