SqlParameterCollection Sınıf

Tanım

Bir ile ilişkili bir parametre koleksiyonunu SqlCommand ve içindeki sütunlarla ilgili eşlemelerinizi temsil eder DataSet .Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Bu sınıf devralınamaz.This class cannot be inherited.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection
public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
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
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
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
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Devralma
SqlParameterCollection
Devralma
Devralma
SqlParameterCollection
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki örnek, koleksiyonu aracılığıyla birden çok örneği oluşturur SqlParameter SqlParameterCollection .The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Parametreler, veri kaynağı içindeki verileri seçmek ve doldurmak için kullanılır DataSet .The parameters are used to select data within the data source and populate the DataSet. Bu kod, bir DataSet ve ' nin SqlDataAdapter zaten uygun şema, komutlar ve bağlantıyla oluşturulmuş olduğunu varsayar.This code assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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 bildirisi içeriyorsa, koleksiyondaki parametrelerin sayısı, komut metninde parametre yer tutucuları sayısına eşit olmalıdır veya SQL Server bir hata oluşturur.If the command contains an ad hoc SQL statement, as opposed to a stored-procedure name, the number of the parameters in the collection must be equal to the number of parameter placeholders within the command text, or SQL Server raises an error. Saklı yordamla, saklı yordamda belirtilen tüm parametrelerin varsayılan değer olmadan sağlanması gerekir.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. Varsayılan bir değerle belirtilen parametreler isteğe bağlıdır.Parameters declared with a default value are optional. Bu, varsayılan değer dışında bir değer belirtmenizi sağlar.This lets you specify a value other than the default.

Parametrelerin nasıl kullanılacağını gösteren ek örnek kod hakkında daha fazla bilgi için bkz. Komutlar ve parametreler.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Özellikler

Count

İçindeki öğe sayısını içeren bir tamsayı döndürür SqlParameterCollection .Returns an Integer that contains the number of elements in the SqlParameterCollection. Salt okunur.Read-only.

IsFixedSize

Değerinin sabit boyutta olup olmadığını gösteren bir değer alır SqlParameterCollection .Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsFixedSize

Koleksiyonun sabit bir boyut olup olmadığını belirtir.Specifies whether the collection is a fixed size.

(Devralındığı yer: DbParameterCollection)
IsReadOnly

Salt okunurdur olduğunu gösteren bir değer alır SqlParameterCollection .Gets a value that indicates whether the SqlParameterCollection is read-only.

IsReadOnly

Koleksiyonun salt okunurdur.Specifies whether the collection is read-only.

(Devralındığı yer: DbParameterCollection)
IsSynchronized

' SqlParameterCollection Nin eşitlenip eşitlenmediğini gösteren bir değer alır.Gets a value that indicates whether the SqlParameterCollection is synchronized.

IsSynchronized

Koleksiyonun eşitlenip eşitlenmeyeceğini belirtir.Specifies whether the collection is synchronized.

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

SqlParameterBelirtilen dizini alır.Gets the SqlParameter at the specified index.

Item[String]

SqlParameterBelirtilen ada sahip öğesini alır.Gets the SqlParameter with the specified name.

SyncRoot

Erişimini eşitlemede kullanılabilecek bir nesne alır SqlParameterCollection .Gets an object that can be used to synchronize access to the SqlParameterCollection.

Yöntemler

Add(Object)

Belirtilen SqlParameter nesnesini öğesine ekler SqlParameterCollection .Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

Belirtilen SqlParameter nesnesini öğesine ekler SqlParameterCollection .Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object)
Kullanımdan kalktı.
Kullanımdan kalktı.

Belirtilen SqlParameter nesnesini öğesine ekler SqlParameterCollection .Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType)

SqlParameter SqlParameterCollection Verilen parametre adına ve veri türüne bir öğesine ekler.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32)

SqlParameter SqlParameterCollection Belirtilen parametre adı ve boyutu verildiğinde öğesine öğesine ekler SqlDbType .Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String)

Parametresi, SqlParameter SqlParameterCollection parametre adı, veri türü ve sütun uzunluğu ile öğesine ekler.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array)

Sonuna bir değer dizisi ekler SqlParameterCollection .Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[])

Sonuna bir değer dizisi ekler SqlParameter SqlParameterCollection .Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object)

Sonuna bir değer ekler SqlParameterCollection .Adds a value to the end of the SqlParameterCollection.

Clear()

Tüm SqlParameter nesneleri öğesinden kaldırır SqlParameterCollection .Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

Belirtilen bunun içinde olup olmadığını belirler Object SqlParameterCollection .Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

Belirtilen bunun içinde olup olmadığını belirler SqlParameter SqlParameterCollection .Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

Belirtilen parametre adının bunun içinde olup olmadığını belirler SqlParameterCollection .Determines whether the specified parameter name is in this SqlParameterCollection.

CopyTo(Array, Int32)

Geçerli olan tüm öğeleri SqlParameterCollection Array belirtilen hedef dizinden başlayarak belirtilen tek boyutlu olarak kopyalar Array .Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(SqlParameter[], Int32)

Geçerli olan tüm öğeleri SqlParameterCollection SqlParameterCollection belirtilen hedef dizinden başlayarak belirtilen şekilde kopyalar.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Devralındığı yer: MarshalByRefObject)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetEnumerator()

İle yinelenen bir Numaralandırıcı döndürür SqlParameterCollection .Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetLifetimeService()

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
GetParameter(Int32)

DbParameterKoleksiyonda belirtilen dizindeki nesneyi döndürür.Returns the DbParameter object at the specified index in the collection.

(Devralındığı yer: DbParameterCollection)
GetParameter(String)

DbParameterBelirtilen ada sahip nesneyi döndürür.Returns DbParameter the object with the specified name.

(Devralındığı yer: DbParameterCollection)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
IndexOf(Object)

Koleksiyon içinde belirtilen konumunu alır Object .Gets the location of the specified Object within the collection.

IndexOf(SqlParameter)

Koleksiyon içinde belirtilen konumunu alır SqlParameter .Gets the location of the specified SqlParameter within the collection.

IndexOf(String)

Belirtilen adla belirtilen konumunu alır SqlParameter .Gets the location of the specified SqlParameter with the specified name.

InitializeLifetimeService()

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
Insert(Int32, Object)

ObjectBelirtilen dizinde içine bir ekler SqlParameterCollection .Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

SqlParameterBelirtilen dizindeki içine bir nesne ekler SqlParameterCollection .Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Devralındığı yer: MarshalByRefObject)
Remove(Object)

Belirtilen koleksiyondan kaldırır SqlParameter .Removes the specified SqlParameter from the collection.

Remove(SqlParameter)

Belirtilen koleksiyondan kaldırır SqlParameter .Removes the specified SqlParameter from the collection.

RemoveAt(Int32)

SqlParameterBelirtilen dizindeki öğesinden öğesinden kaldırır SqlParameterCollection .Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

SqlParameter SqlParameterCollection Belirtilen parametre adındaki öğesinden öğesinden kaldırır.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

SetParameter(Int32, DbParameter)

DbParameterBelirtilen dizindeki nesneyi yeni bir değere ayarlar.Sets the DbParameter object at the specified index to a new value.

(Devralındığı yer: DbParameterCollection)
SetParameter(String, DbParameter)

DbParameterBelirtilen ada sahip nesneyi yeni bir değere ayarlar.Sets the DbParameter object with the specified name to a new value.

(Devralındığı yer: DbParameterCollection)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

ICollection.IsSynchronized

Erişiminin ICollection eşitlenip eşitlenmediğini (iş parçacığı güvenli) gösteren bir değer alır.Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Devralındığı yer: DbParameterCollection)
IDataParameterCollection.Item[String]

Belirtilen dizindeki parametreyi alır veya ayarlar.Gets or sets the parameter at the specified index.

(Devralındığı yer: DbParameterCollection)
IList.Add(Object)

Bu üyenin açıklaması için bkz Add(Object) ..For a description of this member, see Add(Object).

(Devralındığı yer: DbParameterCollection)
IList.Contains(Object)

Bu üyenin açıklaması için bkz Contains(Object) ..For a description of this member, see Contains(Object).

(Devralındığı yer: DbParameterCollection)
IList.IndexOf(Object)

Bu üyenin açıklaması için bkz IndexOf(Object) ..For a description of this member, see IndexOf(Object).

(Devralındığı yer: DbParameterCollection)
IList.Insert(Int32, Object)

Bu üyenin açıklaması için bkz Insert(Int32, Object) ..For a description of this member, see Insert(Int32, Object).

(Devralındığı yer: DbParameterCollection)
IList.IsFixedSize

Değerinin sabit boyutta olup olmadığını gösteren bir değer alır IList .Gets a value indicating whether the IList has a fixed size.

(Devralındığı yer: DbParameterCollection)
IList.IsReadOnly

IList öğesinin salt okunur olup olmadığını belirten bir değer alır.Gets a value indicating whether the IList is read-only.

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

Belirtilen dizindeki öğeyi alır veya ayarlar.Gets or sets the element at the specified index.

(Devralındığı yer: DbParameterCollection)
IList.Remove(Object)

Bu üyenin açıklaması için bkz Remove(Object) ..For a description of this member, see Remove(Object).

(Devralındığı yer: DbParameterCollection)

Uzantı Metotları

Cast<TResult>(IEnumerable)

Öğesinin öğelerini IEnumerable belirtilen türe yayınlar.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Öğesinin öğelerini IEnumerable belirtilen bir türe göre filtreler.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Bir sorgunun paralelleştirilmesini mümkün hale getirme.Enables parallelization of a query.

AsQueryable(IEnumerable)

Bir IEnumerable öğesine dönüştürür IQueryable .Converts an IEnumerable to an IQueryable.

Şunlara uygulanır

Ayrıca bkz.