SqlCeParameterCollection 类

项目
05/27/2011

收集与 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)	向 SqlCeCommand 添加 SqlCeParameter 对象。（覆盖 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）

页首

注释

集合中参数的数量必须与命令文本中参数占位符的数量相等。否则，SQL Server Compact 的 .NET Compact Framework 数据访问接口可能会引发错误。

示例

下面的示例通过 SqlCeDataAdapter 中的 SqlCeParameterCollection 集合创建 SqlCeParameter 的多个实例。这些参数用于选择数据源中的数据。然后它们将数据放置在 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();
}

线程安全

此类型的任何公共静态（在 Microsoft Visual Basic 中为共享）成员是线程安全的。不保证所有实例成员都对于线程安全的。

请参阅

参考

System.Data.SqlServerCe 命名空间

Share via

SqlCeParameterCollection 类

继承层次结构

语法

属性

方法

显式接口实现

注释

示例

线程安全

请参阅

参考

其他资源