SqlCeParameterCollection-Klasse

Sammelt alle für eine SqlCeCommand-Klasse relevanten Parameter sowie ihre jeweiligen Zuordnungen zu DataSet-Spalten.

Vererbungshierarchie

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

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

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

Der SqlCeParameterCollection-Typ macht folgende Elemente verfügbar.

Eigenschaften

	Name	Beschreibung
	Count	Ruft die Anzahl der SqlCeParameter-Objekte in der Auflistung ab. (Überschreibt DbParameterCollection.Count.)
	IsFixedSize	Infrastruktur (Überschreibt DbParameterCollection.IsFixedSize.)
	IsReadOnly	Infrastruktur (Überschreibt DbParameterCollection.IsReadOnly.)
	IsSynchronized	Infrastruktur (Überschreibt DbParameterCollection.IsSynchronized.)
	Item[Int32]	Ruft den SqlCeParameter am angegebenen Index ab oder legt diesen fest.
	Item[String]	Ruft den SqlCeParameter mit dem angegebenen Namen ab oder legt ihn fest.
	SyncRoot	Infrastruktur (Überschreibt DbParameterCollection.SyncRoot.)

Zum Anfang

Methoden

	Name	Beschreibung
	Add(Object)	Fügt SqlCeCommand ein SqlCeParameter-Objekt hinzu. (Überschreibt DbParameterCollection.Add(Object).)
	Add(SqlCeParameter)	Fügt SqlCeParameterCollection den angegebenen SqlCeParameter hinzu.
	Add(String, SqlDbType)	Fügt SqlCeParameterCollection einen SqlCeParameter mit dem angegebenen Parameternamen und Datentyp hinzu.
	Add(String, Object)	Veraltet Fügt SqlCeParameterCollection einen SqlCeParameter mit dem angegebenen Parameternamen und -wert hinzu.
	Add(String, SqlDbType, Int32)	Fügt SqlCeParameterCollection einen SqlCeParameter mit dem Parameternamen, dem Datentyp und der Spaltenbreite hinzu.
	Add(String, SqlDbType, Int32, String)	Fügt SqlCeCommand einen SqlCeParameter mit dem angegebenen Parameternamen, dem Datentyp, der Spaltenbreite und dem Quellspaltennamen hinzu.
	AddRange	Fügt SqlCeParameterCollection ein Array von SqlCeParameter-Objekten hinzu. (Überschreibt DbParameterCollection.AddRange(Array).)
	AddWithValue	Fügt SqlCeParameterCollection einen neuen SqlCeParameter hinzu und legt seinen Wert fest.
	Clear	Entfernt alle Elemente aus der Auflistung. (Überschreibt DbParameterCollection.Clear().)
	Contains(Object)	Ruft einen Wert ab, der angibt, ob ein SqlCeParameter-Objekt in der Auflistung vorhanden ist. (Überschreibt DbParameterCollection.Contains(Object).)
	Contains(String)	Ruft einen Wert ab, der angibt, ob ein SqlCeParameter mit dem angegebenen Parameternamen in der Auflistung vorhanden ist. (Überschreibt DbParameterCollection.Contains(String).)
	CopyTo	Kopiert SqlCeParameter-Objekte aus SqlCeParameterCollection in das angegebene Array. (Überschreibt DbParameterCollection.CopyTo(Array, Int32).)
	CreateObjRef	(von MarshalByRefObject vererbt)
	Equals	(von Object vererbt)
	Finalize	(von Object vererbt)
	GetEnumerator	Infrastruktur (Überschreibt DbParameterCollection.GetEnumerator().)
	GetHashCode	(von Object vererbt)
	GetLifetimeService	(von MarshalByRefObject vererbt)
	GetParameter(Int32)	(von DbParameterCollection vererbt)
	GetParameter(String)	(von DbParameterCollection vererbt)
	GetType	(von Object vererbt)
	IndexOf(Object)	Ruft die Position des SqlCeParameter-Objekts in der Auflistung ab. (Überschreibt DbParameterCollection.IndexOf(Object).)
	IndexOf(String)	Ruft die Position von SqlCeParameter mit dem angegebenen Parameternamen in der Auflistung ab. (Überschreibt DbParameterCollection.IndexOf(String).)
	InitializeLifetimeService	(von MarshalByRefObject vererbt)
	Insert	Fügt SqlCeParameter am angegebenen Index in die Auflistung ein. (Überschreibt DbParameterCollection.Insert(Int32, Object).)
	MemberwiseClone()	(von Object vererbt)
	MemberwiseClone(Boolean)	(von MarshalByRefObject vererbt)
	Remove	Entfernt den angegebenen SqlCeParameter aus der Auflistung. (Überschreibt DbParameterCollection.Remove(Object).)
	RemoveAt(Int32)	Entfernt SqlCeParameter am angegebenen Index aus der Auflistung. (Überschreibt DbParameterCollection.RemoveAt(Int32).)
	RemoveAt(String)	Entfernt SqlCeParameter mit dem angegebenen Namen aus der Auflistung. (Überschreibt DbParameterCollection.RemoveAt(String).)
	SetParameter(Int32, DbParameter)	(von DbParameterCollection vererbt)
	SetParameter(String, DbParameter)	(von DbParameterCollection vererbt)
	ToString	(von Object vererbt)

Zum Anfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IList.Item	(von DbParameterCollection vererbt)
	IDataParameterCollection.Item	(von DbParameterCollection vererbt)

Zum Anfang

Hinweise

Die Anzahl der Parameter in der Auflistung muss mit der Anzahl der Parameterplatzhalter im Befehlstext übereinstimmen. Andernfalls löst der .NET Compact Framework-Datenanbieter für SQL Server Compact möglicherweise einen Fehler aus.

Beispiele

Im folgenden Beispiel werden über die SqlCeParameter-Auflistung in der SqlCeParameterCollection-Klasse mehrere Instanzen von SqlCeDataAdapter erstellt. Diese Parameter werden zum Auswählen von Daten innerhalb der Datenquelle verwendet. Danach werden die Daten in der DataSet-Klasse eingefügt. In diesem Beispiel wird davon ausgegangen, dass DataSet und SqlCeDataAdapter mit dem entsprechenden Schema, den entsprechenden Befehlen sowie der entsprechenden Verbindung bereits erstellt wurden.

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

Threadsicherheit

Alle öffentlichen statischen (in Microsoft Visual Basic freigegebenen) Elemente dieses Typs sind threadsicher. Für Instanzelemente kann nicht sichergestellt werden, dass sie threadsicher sind.

Siehe auch

Verweis

System.Data.SqlServerCe-Namespace