OleDbParameterCollection Classe

Definição

Representa uma coleção de parâmetros relevantes para um OleDbCommand bem como as respetivas correspondências para colunas em um DataSet.

public ref class OleDbParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class OleDbParameterCollection sealed : System::Data::Common::DbParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class OleDbParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class OleDbParameterCollection : System.Data.Common.DbParameterCollection
[<System.ComponentModel.ListBindable(false)>]
type OleDbParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
[<System.ComponentModel.ListBindable(false)>]
type OleDbParameterCollection = class
    inherit DbParameterCollection
Public NotInheritable Class OleDbParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class OleDbParameterCollection
Inherits DbParameterCollection
Herança
OleDbParameterCollection
Herança
Atributos
Implementações

Exemplos

O exemplo seguinte cria múltiplas instâncias de OleDbParameter através da OleDbParameterCollection coleção dentro do OleDbDataAdapter. Estes parâmetros são usados para selecionar dados dentro da fonte de dados e colocar os dados no DataSet. Este exemplo assume que a DataSet e an OleDbDataAdapter já foram criados com o esquema, comandos e ligação apropriados.

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

Observações

O número de parâmetros na coleção deve ser igual ao número de marcadores de parâmetros dentro do texto do comando, caso contrário o .NET Framework Data Provider para OLE DB pode gerar um erro.

Propriedades

Name Description
Count

Devolve um inteiro que contém o número de elementos no OleDbParameterCollection. Somente leitura.

IsFixedSize

Obtém um valor que indica se o OleDbParameterCollection tem um tamanho fixo. Somente leitura.

IsReadOnly

Obtém um valor que indica se o OleDbParameterCollection é apenas de leitura.

IsSynchronized

Obtém um valor que indica se o OleDbParameterCollection está sincronizado. Somente leitura.

Item[Int32]

Obtém ou define o OleDbParameter no índice especificado.

Item[String]

Recebe ou define o OleDbParameter com o nome especificado.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao OleDbParameterCollection. Somente leitura.

Métodos

Name Description
Add(Object)

Adiciona o objeto especificado OleDbParameter ao OleDbParameterCollection.

Add(OleDbParameter)

Adiciona o especificado OleDbParameter ao OleDbParameterCollection.

Add(String, Object)
Obsoleto.

Adiciona um OleDbParameter ao OleDbParameterCollection nome e valor do parâmetro atribuído.

Add(String, OleDbType, Int32, String)

Adiciona um OleDbParameter ao OleDbParameterCollection nome do parâmetro, tipo de dado, comprimento da coluna e nome da coluna de origem.

Add(String, OleDbType, Int32)

Adiciona an OleDbParameter ao OleDbParameterCollection nome do parâmetro, tipo de dado e comprimento da coluna.

Add(String, OleDbType)

Adiciona um OleDbParameter ao OleDbParameterCollection, dado o nome do parâmetro e o tipo de dado.

AddRange(Array)

Adiciona um array de valores ao final do OleDbParameterCollection.

AddRange(OleDbParameter[])

Adiciona um array de OleDbParameter valores ao final do OleDbParameterCollection.

AddWithValue(String, Object)

Adiciona um valor ao final do OleDbParameterCollection.

Clear()

Remove todos OleDbParameter os objetos do OleDbParameterCollection.

Contains(Object)

Determina se o especificado Object pertence a este OleDbParameterCollection.

Contains(OleDbParameter)

Determina se o especificado OleDbParameter pertence a este OleDbParameterCollection.

Contains(String)

Determina se o especificado String pertence a este OleDbParameterCollection.

CopyTo(Array, Int32)

Copia todos os elementos da corrente OleDbParameterCollection para a unidimensional Array especificada, começando no índice de destino Array especificado.

CopyTo(OleDbParameter[], Int32)

Copia todos os elementos da corrente OleDbParameterCollection para o índice de destino especificado OleDbParameterCollection .

CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEnumerator()

Devolve um enumerador que itera através do OleDbParameterCollection.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetParameter(Int32)

Devolve o DbParameter objeto no índice especificado na coleção.

(Herdado de DbParameterCollection)
GetParameter(String)

Devolve DbParameter o objeto com o nome especificado.

(Herdado de DbParameterCollection)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Object)

A localização do especificado Object dentro da coleção.

IndexOf(OleDbParameter)

Obtém a localização do especificado OleDbParameter dentro da coleção.

IndexOf(String)

Obtém a localização do especificado OleDbParameter com o nome especificado.

InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
Insert(Int32, Object)

Insere a Object no OleDbParameterCollection índice especificado.

Insert(Int32, OleDbParameter)

Insere um OleDbParameter objeto no OleDbParameterCollection índice especificado.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
Remove(Object)

Remove o Object objeto do OleDbParameterCollection.

Remove(OleDbParameter)

Remove o OleDbParameter do OleDbParameterCollection.

RemoveAt(Int32)

Remove o OleDbParameter de no OleDbParameterCollection índice especificado.

RemoveAt(String)

Remove o OleDbParameter do OleDbParameterCollection no nome do parâmetro especificado.

SetParameter(Int32, DbParameter)

Define o DbParameter objeto no índice especificado para um novo valor.

(Herdado de DbParameterCollection)
SetParameter(String, DbParameter)

Define o DbParameter objeto com o nome especificado para um novo valor.

(Herdado de DbParameterCollection)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
IDataParameterCollection.Item[String]

Obtém ou define o parâmetro no índice especificado.

(Herdado de DbParameterCollection)
IList.Item[Int32]

Obtém ou define o elemento no índice especificado.

(Herdado de DbParameterCollection)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.

Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também