OleDbParameterCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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. |