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
	Count	Ottiene il numero di oggetti SqlCeParameter contenuti nella raccolta. Esegue l'override di DbParameterCollection.Count.
	IsFixedSize	Infrastruttura. Esegue l'override di DbParameterCollection.IsFixedSize.
	IsReadOnly	Infrastruttura. Esegue l'override di DbParameterCollection.IsReadOnly.
	IsSynchronized	Infrastruttura. Esegue l'override di DbParameterCollection.IsSynchronized.
	Item[Int32]	Ottiene o imposta l'oggetto SqlCeParameter in corrispondenza dell'indice specificato.
	Item[String]	Ottiene o imposta l'oggetto SqlCeParameter con il nome specificato.
	SyncRoot	Infrastruttura. Esegue l'override di DbParameterCollection.SyncRoot.

In alto

Metodi

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

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IList.Item	(ereditato da DbParameterCollection)
	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