OleDbParameterCollection Класс

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v8.0.0

Исходный код:

OleDbParameterCollection.cs

Представляет коллекцию параметров, относящихся к OleDbCommand, а также соответствующие им сопоставления со столбцами в DataSet.

public ref class OleDbParameterCollection sealed : System::Data::Common::DbParameterCollection

public sealed class OleDbParameterCollection : System.Data.Common.DbParameterCollection

type OleDbParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class OleDbParameterCollection
Inherits DbParameterCollection

Наследование

Object

DbParameterCollection

OleDbParameterCollection

Примеры

В следующем примере создается несколько экземпляров OleDbParameter с помощью OleDbParameterCollection коллекции в OleDbDataAdapter. Эти параметры используются для выбора данных в источнике данных и их размещения в DataSet. В этом примере предполагается DataSet , что и уже созданы с соответствующей схемой, командами и подключением OleDbDataAdapter .

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

Комментарии

Количество параметров в коллекции должно равняться количеству заполнителей параметров в тексте команды, в противном случае поставщик данных платформа .NET Framework для OLE DB может вызвать ошибку.

Свойства

Count	Возвращает целое число, которое содержит количество элементов в OleDbParameterCollection. Только для чтения.
IsFixedSize	Получает значение, показывающее, имеет ли объект OleDbParameterCollection фиксированный размер. Только для чтения.
IsReadOnly	Получает значение, указывающее, доступен ли объект OleDbParameterCollection только для чтения.
IsSynchronized	Возвращает значение, которое определяет, является ли коллекция OleDbParameterCollection синхронизированной. Только для чтения.
Item[Int32]	Возвращает или задает объект OleDbParameter с заданным индексом.
Item[String]	Возвращает или задает объект OleDbParameter с заданным именем.
SyncRoot	Получает объект, с помощью которого можно синхронизировать доступ к коллекции OleDbParameterCollection. Только для чтения.

Методы

Add(Object)	Добавляет указанный объект OleDbParameter к объекту OleDbParameterCollection.
Add(OleDbParameter)	Добавляет заданный объект OleDbParameter в OleDbParameterCollection.
Add(String, Object)	Устаревшие.. Добавляет объект OleDbParameter с заданным именем параметра и значением в OleDbParameterCollection.
Add(String, OleDbType)	Добавляет OleDbParameter с заданным именем параметра и типом данных в коллекцию OleDbParameterCollection.
Add(String, OleDbType, Int32)	Добавляет OleDbParameter с заданным именем, типом данных и длиной столбца в OleDbParameterCollection.
Add(String, OleDbType, Int32, String)	Добавляет объект OleDbParameter с заданным именем параметра, типом данных, длиной столбца и именем столбца источника в OleDbParameterCollection.
AddRange(Array)	Добавляет массив значений в конец коллекции OleDbParameterCollection.
AddRange(OleDbParameter[])	Добавляет массив значений OleDbParameter в конец коллекции OleDbParameterCollection.
AddWithValue(String, Object)	Добавляет значение в конец коллекции OleDbParameterCollection.
Clear()	Удаляет все объекты OleDbParameter из коллекции OleDbParameterCollection.
Contains(Object)	Определяет, находится ли заданный объект Object в этой коллекции OleDbParameterCollection.
Contains(OleDbParameter)	Определяет, находится ли заданный объект OleDbParameter в этой коллекции OleDbParameterCollection.
Contains(String)	Определяет, находится ли заданный объект String в этой коллекции OleDbParameterCollection.
CopyTo(Array, Int32)	Копирует все элементы текущей коллекции OleDbParameterCollection в указанный одномерный массив Array, начиная с указанного индекса в массиве Array.
CopyTo(OleDbParameter[], Int32)	Копирует все элементы текущей коллекции OleDbParameterCollection в указанную коллекцию OleDbParameterCollection, начиная с указанного индекса в коллекции назначения.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	Возвращает перечислитель, осуществляющий перебор элементов списка OleDbParameterCollection.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetParameter(Int32)	Возвращает объект DbParameter по указанному индексу в коллекции. (Унаследовано от DbParameterCollection)
GetParameter(String)	Возвращает объект DbParameter с заданным именем. (Унаследовано от DbParameterCollection)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(Object)	Местоположение указанного объекта Object в коллекции.
IndexOf(OleDbParameter)	Возвращает положение указанного объекта OleDbParameter в коллекции.
IndexOf(String)	Возвращает положение заданного объекта OleDbParameter с указанным именем.
Insert(Int32, Object)	Вставляет Object в OleDbParameterCollection по указанному индексу.
Insert(Int32, OleDbParameter)	Вставляет объект OleDbParameter в коллекцию OleDbParameterCollection по указанному индексу.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove(Object)	Удаляет объект Object из коллекции OleDbParameterCollection.
Remove(OleDbParameter)	Удаляет объект OleDbParameter из коллекции OleDbParameterCollection.
RemoveAt(Int32)	Удаляет объект OleDbParameter с указанным индексом из коллекции OleDbParameterCollection.
RemoveAt(String)	Удаляет объект OleDbParameter с указанным именем из коллекции OleDbParameterCollection.
SetParameter(Int32, DbParameter)	Задает новое значение для объекта DbParameter по указанному индексу. (Унаследовано от DbParameterCollection)
SetParameter(String, DbParameter)	Назначает новое значение объекту DbParameter с указанным именем. (Унаследовано от DbParameterCollection)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Методы расширения

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter