Поделиться через

Класс SqlCeParameterCollection

  • Статья

Объединяет в коллекцию параметры, относящиеся к SqlCeCommand, а также соответствующие им сопоставления со столбцами DataSet.

Иерархия наследования

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbParameterCollection
      System.Data.SqlServerCe.SqlCeParameterCollection

Пространство имен:  System.Data.SqlServerCe
Сборка:  System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)

Синтаксис

'Декларация
Public NotInheritable Class SqlCeParameterCollection _
    Inherits DbParameterCollection
'Применение
Dim instance As SqlCeParameterCollection

public sealed class SqlCeParameterCollection : DbParameterCollection

public ref class SqlCeParameterCollection sealed : public DbParameterCollection

[<SealedAttribute>]
type SqlCeParameterCollection =  
    class
        inherit DbParameterCollection
    end

public final class SqlCeParameterCollection extends DbParameterCollection

Тип SqlCeParameterCollection обеспечивает доступ к следующим элементам.

Свойства

  Имя Описание
Открытое свойство Count Получает число объектов SqlCeParameter в коллекции. (Переопределяет DbParameterCollection.Count.)
Открытое свойство IsFixedSize Инфраструктура. (Переопределяет DbParameterCollection.IsFixedSize.)
Открытое свойство IsReadOnly Инфраструктура. (Переопределяет DbParameterCollection.IsReadOnly.)
Открытое свойство IsSynchronized Инфраструктура. (Переопределяет DbParameterCollection.IsSynchronized.)
Открытое свойство Item[Int32] Возвращает или задает объект SqlCeParameter по указанному индексу.
Открытое свойство Item[String] Возвращает или задает объект SqlCeParameter с указанным именем.
Открытое свойство SyncRoot Инфраструктура. (Переопределяет DbParameterCollection.SyncRoot.)

В начало

Методы

  Имя Описание
Открытый метод Add(Object) Добавляет SqlCeParameter к SqlCeCommand. (Переопределяет DbParameterCollection.Add(Object).)
Открытый метод Add(SqlCeParameter) Добавляет указанное значение SqlCeParameter к SqlCeParameterCollection.
Открытый метод Add(String, SqlDbType) Добавляет SqlCeParameter в коллекцию SqlCeParameterCollection в соответствии с заданными именем и типом данных параметра.
Открытый метод Add(String, Object) Устарело. Добавляет SqlCeParameter в коллекцию SqlCeParameterCollection в соответствии с заданными именем и значением параметра.
Открытый метод Add(String, SqlDbType, Int32) Добавляет SqlCeParameter в коллекцию SqlCeParameterCollection в соответствии с заданными именем параметра, типом данных и шириной столбца.
Открытый метод Add(String, SqlDbType, Int32, String) Добавляет SqlCeParameter в коллекцию SqlCeCommand в соответствии с заданными именем параметра, типом данных, шириной столбца и именем исходного столбца.
Открытый метод AddRange Добавляет массив объектов SqlCeParameter в коллекцию SqlCeParameterCollection. (Переопределяет DbParameterCollection.AddRange(Array).)
Открытый метод AddWithValue Добавляет новый параметр SqlCeParameter в коллекцию SqlCeParameterCollection и задает его значение.
Открытый метод Clear Удаляет все элементы из коллекции. (Переопределяет DbParameterCollection.Clear().)
Открытый метод Contains(Object) Возвращает значение, указывающее, действительно ли объект SqlCeParameter существует в коллекции. (Переопределяет DbParameterCollection.Contains(Object).)
Открытый метод Contains(String) Возвращает значение, указывающее, существует ли в коллекции свойство SqlCeParameter с указанным именем параметра. (Переопределяет DbParameterCollection.Contains(String).)
Открытый метод CopyTo Копирует объекты SqlCeParameter из коллекции SqlCeParameterCollection в заданный массив. (Переопределяет DbParameterCollection.CopyTo(Array, Int32).)
Открытый метод CreateObjRef (унаследовано из MarshalByRefObject)
Открытый метод Equals (унаследовано из Object)
Защищенный метод Finalize (унаследовано из Object)
Открытый метод GetEnumerator Инфраструктура. (Переопределяет DbParameterCollection.GetEnumerator().)
Открытый метод GetHashCode (унаследовано из Object)
Открытый метод GetLifetimeService (унаследовано из MarshalByRefObject)
Защищенный метод GetParameter(Int32) (унаследовано из DbParameterCollection)
Защищенный метод GetParameter(String) (унаследовано из DbParameterCollection)
Открытый метод GetType (унаследовано из Object)
Открытый метод IndexOf(Object) Возвращает местоположение объекта SqlCeParameter в коллекции. (Переопределяет DbParameterCollection.IndexOf(Object).)
Открытый метод IndexOf(String) Возвращает сведения о местоположении в коллекции объекта SqlCeParameter для параметра с указанным именем. (Переопределяет DbParameterCollection.IndexOf(String).)
Открытый метод InitializeLifetimeService (унаследовано из MarshalByRefObject)
Открытый метод Insert Вставляет объект SqlCeParameter в коллекцию по указанному индексу. (Переопределяет DbParameterCollection.Insert(Int32, Object).)
Защищенный метод MemberwiseClone() (унаследовано из Object)
Защищенный метод MemberwiseClone(Boolean) (унаследовано из MarshalByRefObject)
Открытый метод Remove Удаляет указанный SqlCeParameter из коллекции. (Переопределяет DbParameterCollection.Remove(Object).)
Открытый метод RemoveAt(Int32) Удаляет SqlCeParameter из коллекции по указанному индексу. (Переопределяет DbParameterCollection.RemoveAt(Int32).)
Открытый метод RemoveAt(String) Удаляет из коллекции объект SqlCeParameter с указанным именем. (Переопределяет DbParameterCollection.RemoveAt(String).)
Защищенный метод SetParameter(Int32, DbParameter) (унаследовано из DbParameterCollection)
Защищенный метод SetParameter(String, DbParameter) (унаследовано из DbParameterCollection)
Открытый метод ToString (унаследовано из Object)

В начало

Явные реализации интерфейса

  Имя Описание
Явная реализация интерфейсаЗакрытое свойство IList.Item (унаследовано из DbParameterCollection)
Явная реализация интерфейсаЗакрытое свойство IDataParameterCollection.Item (унаследовано из DbParameterCollection)

В начало

Замечания

Число параметров в коллекции должно быть равно количеству местозаполнителей параметров в тексте команды. В противном случае поставщик данных .NET Compact Framework для SQL Server Compact может выдать ошибку.

Примеры

В следующем примере создается несколько экземпляров SqlCeParameter в коллекции SqlCeParameterCollection объекта SqlCeDataAdapter. Эти параметры используются для выборки данных из источника данных. Затем данные помещаются в DataSet. В следующем примере предполагается, что уже были созданы объекты DataSet и SqlCeDataAdapter с соответствующей схемой, командами и соединением.

Dim cmd As SqlCeCommand = Nothing
Dim adp As SqlCeDataAdapter = Nothing

Try
    adp = New SqlCeDataAdapter()
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")

    ' Create the SelectCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country AND [Ship City] = @city"
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15)
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15)

    cmd.Parameters("@country").Value = "UK"
    cmd.Parameters("@city").Value = "London"

    adp.SelectCommand = cmd

    ' Create the DeleteCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID"

    Dim p As SqlCeParameter = cmd.Parameters.Add("@orderID", SqlDbType.NChar, 5, "Order ID")
    p.SourceVersion = DataRowVersion.Original

    adp.DeleteCommand = cmd

    ' Populate the dataset with the results from the SELECT statement
    '
    Dim ds As New DataSet()
    adp.Fill(ds)

    ' Modify the dataset
    '
    MessageBox.Show("Number of rows: " & ds.Tables(0).Rows.Count)

    ' Delete some rows
    '
    ds.Tables(0).Rows(3).Delete()
    ds.Tables(0).Rows(4).Delete()

    ' This will execute two DELETE statements 
    '
    adp.Update(ds.Tables(0))
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    If Not Nothing Is adp.SelectCommand Then
        adp.SelectCommand.Dispose()
    End If
    If Not Nothing Is adp.DeleteCommand Then
        adp.DeleteCommand.Dispose()
    End If
End Try

SqlCeCommand cmd = null;
SqlCeDataAdapter adp = null;

try
{
    adp = new SqlCeDataAdapter();
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");

    // Create the SelectCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country AND [Ship City] = @city";
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15);
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15);

    cmd.Parameters["@country"].Value = "UK";
    cmd.Parameters["@city"].Value = "London";

    adp.SelectCommand = cmd;

    // Create the DeleteCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID";

    SqlCeParameter p = cmd.Parameters.Add("@orderID", SqlDbType.NChar, 5, "Order ID");
    p.SourceVersion = DataRowVersion.Original;

    adp.DeleteCommand = cmd;

    // Populate the dataset with the results from the SELECT statement
    //
    DataSet ds = new DataSet();
    adp.Fill(ds);

    // Modify the dataset
    //
    MessageBox.Show("Number of rows: " + ds.Tables[0].Rows.Count);

    // Delete some rows
    //
    ds.Tables[0].Rows[3].Delete();
    ds.Tables[0].Rows[4].Delete();

    // This will execute two DELETE statements 
    //
    adp.Update(ds.Tables[0]);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    if (null != adp.SelectCommand) adp.SelectCommand.Dispose();
    if (null != adp.DeleteCommand) adp.DeleteCommand.Dispose();
}

Безопасность многопоточности

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

Пространство имен System.Data.SqlServerCe