OleDbParameterCollection Klasse

Definition

Stellt eine Auflistung von Parametern dar, die für einen OleDbCommand relevant sind, sowie deren jeweiligen Zuordnungen zu Spalten in einem DataSet.Represents a collection of parameters relevant to an OleDbCommand as well as their respective mappings to columns in a DataSet.

public ref class OleDbParameterCollection sealed : System::Data::Common::DbParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class OleDbParameterCollection : System.Data.Common.DbParameterCollection
type OleDbParameterCollection = class
    inherit DbParameterCollection
Public NotInheritable Class OleDbParameterCollection
Inherits DbParameterCollection
Vererbung
OleDbParameterCollection
Attribute

Beispiele

Im folgenden Beispiel werden mehrere Instanzen von OleDbParameter über die OleDbParameterCollection Auflistung innerhalb des OleDbDataAdaptererstellt.The following example creates multiple instances of OleDbParameter through the OleDbParameterCollection collection within the OleDbDataAdapter. Diese Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und die Daten in der DataSetzu platzieren.These parameters are used to select data within the data source and place the data in the DataSet. In diesem Beispiel wird davon ausgegangen, dass bereits eine DataSet und ein OleDbDataAdapter mit dem entsprechenden Schema, den Befehlen und der Verbindung erstellt wurden.This example assumes that a DataSet and an OleDbDataAdapter have already been created with the appropriate schema, commands, and connection.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}
Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Hinweise

Die Anzahl der Parameter in der Auflistung muss gleich der Anzahl der Parameter Platzhalter im Befehls Text sein, andernfalls könnte der .NET Framework Datenanbieter für OLE DB einen Fehler hervorrufen.The number of parameters in the collection must equal the number of parameter placeholders within the command text, otherwise the .NET Framework Data Provider for OLE DB might raise an error.

Eigenschaften

Count

Gibt eine ganze Zahl zurück, die die Anzahl der Elemente in der OleDbParameterCollection enthält.Returns an integer that contains the number of elements in the OleDbParameterCollection. Schreibgeschützt.Read-only.

IsFixedSize

Ruft einen Wert ab, der angibt, ob die OleDbParameterCollection eine feste Größe hat.Gets a value that indicates whether the OleDbParameterCollection has a fixed size. Schreibgeschützt.Read-only.

IsReadOnly

Ruft einen Wert ab, der angibt, ob die OleDbParameterCollection schreibgeschützt ist.Gets a value that indicates whether the OleDbParameterCollection is read-only.

IsSynchronized

Ruft einen Wert ab, der angibt, ob die OleDbParameterCollection synchronisiert ist.Gets a value that indicates whether the OleDbParameterCollection is synchronized. Schreibgeschützt.Read-only.

Item[Int32]

Ruft die OleDbParameter-Klasse am angegebenen Index ab oder legt diese fest.Gets or sets the OleDbParameter at the specified index.

Item[String]

Ruft den OleDbParameter mit dem angegebenen Namen ab oder legt diesen fest.Gets or sets the OleDbParameter with the specified name.

SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf OleDbParameterCollection synchronisiert werden kann.Gets an object that can be used to synchronize access to the OleDbParameterCollection. Schreibgeschützt.Read-only.

Methoden

Add(Object)

Fügt der OleDbParameter das angegebene OleDbParameterCollection-Objekt hinzu.Adds the specified OleDbParameter object to the OleDbParameterCollection.

Add(OleDbParameter)

Fügt dem OleDbParameter die angegebene OleDbParameterCollection hinzu.Adds the specified OleDbParameter to the OleDbParameterCollection.

Add(String, Object)

Fügt der OleDbParameter einen OleDbParameterCollection mit dem angegebenen Parameternamen und -wert hinzu.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name and value.

Add(String, OleDbType)

Fügt der OleDbParameter einen OleDbParameterCollection mit dem angegebenen Parameternamen und Datentyp hinzu.Adds an OleDbParameter to the OleDbParameterCollection, given the parameter name and data type.

Add(String, OleDbType, Int32)

Fügt der OleDbParameter einen OleDbParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name, data type, and column length.

Add(String, OleDbType, Int32, String)

Fügt der OleDbParameter einen OleDbParameterCollection mit dem Parameternamen, dem Datentyp, der Spaltenlänge und dem Namen der Quellspalte hinzu.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name, data type, column length, and source column name.

AddRange(Array)

Fügt ein Array von Werten am Ende der OleDbParameterCollection hinzu.Adds an array of values to the end of the OleDbParameterCollection.

AddRange(OleDbParameter[])

Fügt ein Array von OleDbParameter-Werten am Ende der OleDbParameterCollection hinzu.Adds an array of OleDbParameter values to the end of the OleDbParameterCollection.

AddWithValue(String, Object)

Fügt am Ende der OleDbParameterCollection einen Wert hinzu.Adds a value to the end of the OleDbParameterCollection.

Clear()

Entfernt alle OleDbParameter-Objekte aus der OleDbParameterCollection.Removes all OleDbParameter objects from the OleDbParameterCollection.

Contains(Object)

Bestimmt, ob der angegebene Object in dieser OleDbParameterCollection vorhanden ist.Determines whether the specified Object is in this OleDbParameterCollection.

Contains(OleDbParameter)

Bestimmt, ob der angegebene OleDbParameter in dieser OleDbParameterCollection vorhanden ist.Determines whether the specified OleDbParameter is in this OleDbParameterCollection.

Contains(String)

Bestimmt, ob der angegebene String in dieser OleDbParameterCollection vorhanden ist.Determines whether the specified String is in this OleDbParameterCollection.

CopyTo(Array, Int32)

Kopiert alle Elemente der aktuellen OleDbParameterCollection in das angegebene eindimensionale Array, beginnend am angegebenen Index des Ziel-Array.Copies all the elements of the current OleDbParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(OleDbParameter[], Int32)

Kopiert alle Elemente der aktuellen OleDbParameterCollection in die angegebene OleDbParameterCollection, beginnend am angegebenen Zielindex.Copies all the elements of the current OleDbParameterCollection to the specified OleDbParameterCollection starting at the specified destination index.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetEnumerator()

Gibt einen Enumerator zurück, der die OleDbParameterCollection durchläuft.Returns an enumerator that iterates through the OleDbParameterCollection.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IndexOf(Object)

Die Position des angegebenen Object in der Auflistung.The location of the specified Object within the collection.

IndexOf(OleDbParameter)

Ruft die Position der angegebenen OleDbParameter in der Auflistung ab.Gets the location of the specified OleDbParameter within the collection.

IndexOf(String)

Ruft die Position des angegebenen OleDbParameter mit dem angegebenen Namen ab.Gets the location of the specified OleDbParameter with the specified name.

InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
Insert(Int32, Object)

Fügt am angegebenen Index ein Object-Element in die OleDbParameterCollection ein.Inserts a Object into the OleDbParameterCollection at the specified index.

Insert(Int32, OleDbParameter)

Fügt ein OleDbParameter-Objekt am angegebenen Index in die OleDbParameterCollection ein.Inserts a OleDbParameter object into the OleDbParameterCollection at the specified index.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
Remove(Object)

Entfernt das Object-Objekt aus der OleDbParameterCollection.Removes the Object object from the OleDbParameterCollection.

Remove(OleDbParameter)

Entfernt den OleDbParameter aus der OleDbParameterCollection.Removes the OleDbParameter from the OleDbParameterCollection.

RemoveAt(Int32)

Entfernt den OleDbParameter am angegebenen Index aus der OleDbParameterCollection.Removes the OleDbParameter from the OleDbParameterCollection at the specified index.

RemoveAt(String)

Entfernt den OleDbParameter am angegebenen Parameternamen aus der OleDbParameterCollection.Removes the OleDbParameter from the OleDbParameterCollection at the specified parameter name.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch