OleDbParameterCollection Classe

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v8.0.0

Origem:

OleDbParameterCollection.cs

Representa uma coleção de parâmetros relevantes a um OleDbCommand, além de seus respectivos mapeamentos para colunas em um 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

Herança

Object

DbParameterCollection

OleDbParameterCollection

Exemplos

O exemplo a seguir cria várias instâncias de OleDbParameter por meio da OleDbParameterCollection coleção dentro do OleDbDataAdapter. Esses parâmetros são usados para selecionar dados na fonte de dados e colocar os dados no DataSet. Este exemplo pressupõe que um DataSet e um OleDbDataAdapter já foram criados com o esquema, os comandos e a conexã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

Comentários

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

Propriedades

Count	Retorna um inteiro que contém o número de argumentos 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 é somente leitura.
IsSynchronized	Obtém um valor que indica se o OleDbParameterCollection é sincronizado. Somente leitura.
Item[Int32]	Obtém ou define o OleDbParameter no índice especificado.
Item[String]	Obtém 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

Add(Object)	Adiciona o objeto OleDbParameter especificado ao OleDbParameterCollection.
Add(OleDbParameter)	Adiciona o OleDbParameter especificado ao OleDbParameterCollection.
Add(String, Object)	Obsoleto. Adiciona um OleDbParameter ao OleDbParameterCollection dado o nome e o valor do parâmetro.
Add(String, OleDbType)	Adiciona um OleDbParameter ao OleDbParameterCollection, dado o nome do parâmetro o tipo de dados.
Add(String, OleDbType, Int32)	Adiciona um OleDbParameter ao OleDbParameterCollection dado o nome do parâmetro, o tipo de dados e o comprimento da coluna.
Add(String, OleDbType, Int32, String)	Adiciona um OleDbParameter ao OleDbParameterCollection, considerando o nome de parâmetro, tipo de dados, tamanho da coluna e nome da coluna de origem.
AddRange(Array)	Adiciona uma matriz de valores ao final do OleDbParameterCollection.
AddRange(OleDbParameter[])	Adiciona uma matriz de valores OleDbParameter ao final do OleDbParameterCollection.
AddWithValue(String, Object)	Adiciona um valor ao final do OleDbParameterCollection.
Clear()	Remove todos os objetos OleDbParameter de OleDbParameterCollection.
Contains(Object)	Determina se o Object especificado está neste OleDbParameterCollection.
Contains(OleDbParameter)	Determina se o OleDbParameter especificado está neste OleDbParameterCollection.
Contains(String)	Determina se o String especificado está neste OleDbParameterCollection.
CopyTo(Array, Int32)	Copia todos os elementos do OleDbParameterCollection atual para o Array unidimensional especificado, começando no índice Array de destino especificado.
CopyTo(OleDbParameter[], Int32)	Copia todos os elementos do OleDbParameterCollection atual para o OleDbParameterCollection especificado, começando no índice de destino especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que itera por meio de OleDbParameterCollection.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetParameter(Int32)	Retorna o objeto DbParameter no índice especificado na coleção. (Herdado de DbParameterCollection)
GetParameter(String)	Retorna o objeto DbParameter com o nome especificado. (Herdado de DbParameterCollection)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(Object)	O local do Object especificado na coleção.
IndexOf(OleDbParameter)	Obtém o local do OleDbParameter especificado na coleção.
IndexOf(String)	Obtém o local do OleDbParameter especificado com o nome especificado.
Insert(Int32, Object)	Insere um Object no OleDbParameterCollection no índice especificado.
Insert(Int32, OleDbParameter)	Insere um objeto OleDbParameter no OleDbParameterCollection no índice especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(Object)	Remove o objeto Object do OleDbParameterCollection.
Remove(OleDbParameter)	Remove o OleDbParameter do OleDbParameterCollection.
RemoveAt(Int32)	Remove o OleDbParameter do OleDbParameterCollection no índice especificado.
RemoveAt(String)	Remove o OleDbParameter do OleDbParameterCollection no nome de parâmetro especificado.
SetParameter(Int32, DbParameter)	Define o objeto DbParameter no índice especificado para um novo valor. (Herdado de DbParameterCollection)
SetParameter(String, DbParameter)	Define o objeto DbParameter com o nome especificado para um novo valor. (Herdado de DbParameterCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Métodos de Extensão

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter