Clase SqlCeParameterCollection

  • Artículo

Recopila todos los parámetros relativos a SqlCeCommand, así como sus correspondientes asignaciones a columnas de DataSet.

Jerarquía de herencia

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

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
Public NotInheritable Class SqlCeParameterCollection _
    Inherits DbParameterCollection
'Uso
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

El tipo SqlCeParameterCollection expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Count Obtiene el número de objetos SqlCeParameter de la colección. (Invalida DbParameterCollection.Count.)
Propiedad pública IsFixedSize Infraestructura. (Invalida DbParameterCollection.IsFixedSize.)
Propiedad pública IsReadOnly Infraestructura. (Invalida DbParameterCollection.IsReadOnly.)
Propiedad pública IsSynchronized Infraestructura. (Invalida DbParameterCollection.IsSynchronized.)
Propiedad pública Item[Int32] Obtiene o establece la clase SqlCeParameter en el índice especificado.
Propiedad pública Item[String] Obtiene o establece el objeto SqlCeParameter con el nombre especificado.
Propiedad pública SyncRoot Infraestructura. (Invalida DbParameterCollection.SyncRoot.)

Arriba

Métodos

  Nombre Descripción
Método público Add(Object) Agrega un objeto SqlCeParameter a SqlCeCommand. (Invalida DbParameterCollection.Add(Object).)
Método público Add(SqlCeParameter) Agrega el objeto SqlCeParameter especificado al objeto SqlCeParameterCollection.
Método público Add(String, SqlDbType) Agrega SqlCeParameter a SqlCeParameterCollection si se proporciona el nombre del parámetro y el tipo de datos.
Método público Add(String, Object) Obsoleto. Agrega SqlCeParameter a SqlCeParameterCollection si se proporciona el nombre y el valor del parámetro.
Método público Add(String, SqlDbType, Int32) Agrega un objeto SqlCeParameter al objeto SqlCeParameterCollection si se proporciona el nombre del parámetro, el tipo de datos y el ancho de columna.
Método público Add(String, SqlDbType, Int32, String) Agrega un SqlCeParameter a SqlCeCommand si se proporciona el nombre de parámetro, el tipo de datos, el ancho de columna y el nombre de la columna de origen.
Método público AddRange Agrega una matriz de objetos SqlCeParameter a SqlCeParameterCollection. (Invalida DbParameterCollection.AddRange(Array).)
Método público AddWithValue Agrega un nuevo objeto SqlCeParameter a SqlCeParameterCollection y establece su valor.
Método público Clear Quita todos los elementos de la colección. (Invalida DbParameterCollection.Clear().)
Método público Contains(Object) Obtiene un valor que indica si existe un objeto SqlCeParameter en la colección o no existe. (Invalida DbParameterCollection.Contains(Object).)
Método público Contains(String) Obtiene un valor que indica si existe un objeto SqlCeParameter con el nombre de parámetro especificado en la colección. (Invalida DbParameterCollection.Contains(String).)
Método público CopyTo Copia los objetos SqlCeParameter del objeto SqlCeParameterCollection en la matriz especificada. (Invalida DbParameterCollection.CopyTo(Array, Int32).)
Método público CreateObjRef (se hereda de MarshalByRefObject)
Método público Equals (se hereda de Object)
Método protegido Finalize (se hereda de Object)
Método público GetEnumerator Infraestructura. (Invalida DbParameterCollection.GetEnumerator().)
Método público GetHashCode (se hereda de Object)
Método público GetLifetimeService (se hereda de MarshalByRefObject)
Método protegido GetParameter(Int32) (se hereda de DbParameterCollection)
Método protegido GetParameter(String) (se hereda de DbParameterCollection)
Método público GetType (se hereda de Object)
Método público IndexOf(Object) Obtiene la posición del objeto SqlCeParameter en la colección. (Invalida DbParameterCollection.IndexOf(Object).)
Método público IndexOf(String) Obtiene la ubicación de SqlCeParameter en la colección con el nombre de parámetro especificado. (Invalida DbParameterCollection.IndexOf(String).)
Método público InitializeLifetimeService (se hereda de MarshalByRefObject)
Método público Insert Inserta un SqlCeParameter en el índice especificado de la colección. (Invalida DbParameterCollection.Insert(Int32, Object).)
Método protegido MemberwiseClone() (se hereda de Object)
Método protegido MemberwiseClone(Boolean) (se hereda de MarshalByRefObject)
Método público Remove Quita el objeto SqlCeParameter especificado de la colección. (Invalida DbParameterCollection.Remove(Object).)
Método público RemoveAt(Int32) Quita el objeto SqlCeParameter de la colección en el índice especificado. (Invalida DbParameterCollection.RemoveAt(Int32).)
Método público RemoveAt(String) Quita el objeto SqlCeParameter con el nombre especificado de la colección. (Invalida DbParameterCollection.RemoveAt(String).)
Método protegido SetParameter(Int32, DbParameter) (se hereda de DbParameterCollection)
Método protegido SetParameter(String, DbParameter) (se hereda de DbParameterCollection)
Método público ToString (se hereda de Object)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasPropiedad privada IList.Item (se hereda de DbParameterCollection)
Implementación de interfaces explícitasPropiedad privada IDataParameterCollection.Item (se hereda de DbParameterCollection)

Arriba

Comentarios

El número de parámetros de la colección debe ser igual al número de marcadores de posición de parámetros del texto del comando. De lo contrario, el proveedor de datos de .NET Compact Framework para SQL Server Compact puede producir un error.

Ejemplos

En el ejemplo siguiente se crean varias instancias de SqlCeParameter mediante la colección SqlCeParameterCollection en SqlCeDataAdapter. Estos parámetros se utilizan para seleccionar los datos del origen de datos. Después los colocan en DataSet. En este ejemplo se supone que ya se han creado un DataSet y un SqlCeDataAdapter con el esquema, los comandos y la conexión adecuados.

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

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres System.Data.SqlServerCe