Condividi tramite


Classe SqlCeParameterCollection

Raccoglie tutti i parametri principali di un oggetto SqlCeCommand e i rispettivi mapping alle colonne di DataSet.

Gerarchia di ereditarietà

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

Spazio dei nomi  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
Public NotInheritable Class SqlCeParameterCollection _
    Inherits DbParameterCollection
'Utilizzo
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

Nel tipo SqlCeParameterCollection sono esposti i membri seguenti.

Proprietà

  Nome Descrizione
Proprietà pubblica Count Ottiene il numero di oggetti SqlCeParameter contenuti nella raccolta. Esegue l'override di DbParameterCollection.Count.
Proprietà pubblica IsFixedSize Infrastruttura. Esegue l'override di DbParameterCollection.IsFixedSize.
Proprietà pubblica IsReadOnly Infrastruttura. Esegue l'override di DbParameterCollection.IsReadOnly.
Proprietà pubblica IsSynchronized Infrastruttura. Esegue l'override di DbParameterCollection.IsSynchronized.
Proprietà pubblica Item[Int32] Ottiene o imposta l'oggetto SqlCeParameter in corrispondenza dell'indice specificato.
Proprietà pubblica Item[String] Ottiene o imposta l'oggetto SqlCeParameter con il nome specificato.
Proprietà pubblica SyncRoot Infrastruttura. Esegue l'override di DbParameterCollection.SyncRoot.

In alto

Metodi

  Nome Descrizione
Metodo pubblico Add(Object) Aggiunge un oggetto SqlCeParameter all'oggetto SqlCeCommand. Esegue l'override di DbParameterCollection.Add(Object).
Metodo pubblico Add(SqlCeParameter) Aggiunge l'oggetto SqlCeParameter specificato all'oggetto SqlCeParameterCollection.
Metodo pubblico Add(String, SqlDbType) Aggiunge un oggetto SqlCeParameter all'oggetto SqlCeParameterCollection in base al nome del parametro e al tipo di dati.
Metodo pubblico Add(String, Object) Obsoleto. Aggiunge un oggetto SqlCeParameter all'oggetto SqlCeParameterCollection in base al nome e al valore del parametro.
Metodo pubblico Add(String, SqlDbType, Int32) Aggiunge un oggetto SqlCeParameter all'oggetto SqlCeParameterCollection in base al nome del parametro, al tipo di dati e alla larghezza della colonna.
Metodo pubblico Add(String, SqlDbType, Int32, String) Aggiunge un oggetto SqlCeParameter all'oggetto SqlCeCommand in base al nome del parametro, al tipo di dati, alla larghezza della colonna e al nome della colonna di origine.
Metodo pubblico AddRange Aggiunge una matrice di oggetti SqlCeParameter all'oggetto SqlCeParameterCollection. Esegue l'override di DbParameterCollection.AddRange(Array).
Metodo pubblico AddWithValue Aggiunge un nuovo oggetto SqlCeParameter all'oggetto SqlCeParameterCollection e ne imposta il valore.
Metodo pubblico Clear Rimuove tutti gli elementi dalla raccolta. Esegue l'override di DbParameterCollection.Clear().
Metodo pubblico Contains(Object) Ottiene un valore che indica l'eventuale presenza di un oggetto SqlCeParameter nella raccolta. Esegue l'override di DbParameterCollection.Contains(Object).
Metodo pubblico Contains(String) Ottiene un valore che indica l'eventuale presenza nella raccolta di un oggetto SqlCeParameter con il nome di parametro specificato. Esegue l'override di DbParameterCollection.Contains(String).
Metodo pubblico CopyTo Copia gli oggetti SqlCeParameter dall'oggetto SqlCeParameterCollection nella matrice specificata. Esegue l'override di DbParameterCollection.CopyTo(Array, Int32).
Metodo pubblico CreateObjRef (ereditato da MarshalByRefObject)
Metodo pubblico Equals (ereditato da Object)
Metodo protetto Finalize (ereditato da Object)
Metodo pubblico GetEnumerator Infrastruttura. Esegue l'override di DbParameterCollection.GetEnumerator().
Metodo pubblico GetHashCode (ereditato da Object)
Metodo pubblico GetLifetimeService (ereditato da MarshalByRefObject)
Metodo protetto GetParameter(Int32) (ereditato da DbParameterCollection)
Metodo protetto GetParameter(String) (ereditato da DbParameterCollection)
Metodo pubblico GetType (ereditato da Object)
Metodo pubblico IndexOf(Object) Ottiene la posizione dell'oggetto SqlCeParameter nella raccolta. Esegue l'override di DbParameterCollection.IndexOf(Object).
Metodo pubblico IndexOf(String) Ottiene la posizione dell'oggetto SqlCeParameter nella raccolta con il nome del parametro specificato. Esegue l'override di DbParameterCollection.IndexOf(String).
Metodo pubblico InitializeLifetimeService (ereditato da MarshalByRefObject)
Metodo pubblico Insert Inserisce un oggetto SqlCeParameter nella raccolta, in corrispondenza dell'indice specificato. Esegue l'override di DbParameterCollection.Insert(Int32, Object).
Metodo protetto MemberwiseClone() (ereditato da Object)
Metodo protetto MemberwiseClone(Boolean) (ereditato da MarshalByRefObject)
Metodo pubblico Remove Rimuove l'oggetto SqlCeParameter specificato dalla raccolta. Esegue l'override di DbParameterCollection.Remove(Object).
Metodo pubblico RemoveAt(Int32) Rimuove l'oggetto SqlCeParameter in corrispondenza dell'indice specificato dalla raccolta. Esegue l'override di DbParameterCollection.RemoveAt(Int32).
Metodo pubblico RemoveAt(String) Rimuove l'oggetto SqlCeParameter con il nome specificato dalla raccolta. Esegue l'override di DbParameterCollection.RemoveAt(String).
Metodo protetto SetParameter(Int32, DbParameter) (ereditato da DbParameterCollection)
Metodo protetto SetParameter(String, DbParameter) (ereditato da DbParameterCollection)
Metodo pubblico ToString (ereditato da Object)

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaProprietà privata IList.Item (ereditato da DbParameterCollection)
Implementazione esplicita dell'interfacciaProprietà privata IDataParameterCollection.Item (ereditato da DbParameterCollection)

In alto

Osservazioni

Il numero di parametri nella raccolta deve essere uguale al numero di segnaposto di parametro all'interno del testo del comando. In caso contrario, è possibile che il provider di dati .NET Compact Framework per SQL Server Compact generi un errore.

Esempi

Nell'esempio seguente vengono create più istanze della classe SqlCeParameter mediante la raccolta SqlCeParameterCollection, all'interno della classe SqlCeDataAdapter. Questi parametri vengono utilizzati per selezionare i dati in una origine dati. I dati vengono quindi inseriti nell'oggetto DataSet. In questo esempio si presuppone che gli oggetti DataSet e SqlCeDataAdapter siano già stati creati con la connessione, i comandi e lo schema appropriati.

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

Protezione dei thread

I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe