SqlCeParameterCollection-Klasse

  • Artikel

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
Öffentliche Eigenschaft Count Ruft die Anzahl der SqlCeParameter-Objekte in der Auflistung ab. (Überschreibt DbParameterCollection.Count.)
Öffentliche Eigenschaft IsFixedSize Infrastruktur (Überschreibt DbParameterCollection.IsFixedSize.)
Öffentliche Eigenschaft IsReadOnly Infrastruktur (Überschreibt DbParameterCollection.IsReadOnly.)
Öffentliche Eigenschaft IsSynchronized Infrastruktur (Überschreibt DbParameterCollection.IsSynchronized.)
Öffentliche Eigenschaft Item[Int32] Ruft den SqlCeParameter am angegebenen Index ab oder legt diesen fest.
Öffentliche Eigenschaft Item[String] Ruft den SqlCeParameter mit dem angegebenen Namen ab oder legt ihn fest.
Öffentliche Eigenschaft SyncRoot Infrastruktur (Überschreibt DbParameterCollection.SyncRoot.)

Zum Anfang

Methoden

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

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Eigenschaft IList.Item (von DbParameterCollection vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft 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