Compartilhar via

IDataParameter Interface

Definição

Namespace:
System.Data
Assemblies:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Origem:
IDataParameter.cs
Origem:
IDataParameter.cs

Representa um parâmetro para um objeto Command e, opcionalmente, seu mapeamento para DataSet colunas; e é implementado por provedores de dados .NET que acessam fontes de dados.

public interface class IDataParameter
public interface IDataParameter
type IDataParameter = interface
Public Interface IDataParameter
Derivado

Exemplos

O exemplo a seguir cria várias instâncias da classe derivada, SqlParameterpor meio da SqlParameterCollection coleção dentro da SqlDataAdapter. Esses parâmetros são usados para selecionar dados da fonte de dados e colocar os dados no DataSet. Este exemplo pressupõe que um DataSet e um SqlDataAdapter já foram criados com o esquema, os comandos e a conexão apropriados.

public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);
}

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub

Comentários

A IDataParameter interface permite que uma classe herdada implemente uma classe Parameter, que representa um parâmetro para um objeto Command. Para obter mais informações sobre classes de parâmetro, consulte Configurando parâmetros e tipos de dados de parâmetro.

Um aplicativo não cria uma instância da IDataParameter interface diretamente, mas cria uma instância de uma classe que herda IDataParameter.

As classes herdadas IDataParameter devem implementar os membros herdados e, normalmente, definir membros adicionais para adicionar funcionalidade específica do provedor. Por exemplo, a IDataParameter interface define a DbType propriedade. Por sua vez, a OleDbParameter classe herda essa propriedade e também define a OleDbType propriedade.

Notas aos Implementadores

Para promover a consistência entre os provedores de dados do .NET Framework, nomeie a classe herdada no parâmetro de formulário Prv em que Prv está o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados do .NET Framework. Por exemplo, Sql é o prefixo da SqlCommand classe no System.Data.SqlClient namespace.

Ao herdar da IDataParameter interface, você deve implementar os seguintes construtores:

Item Descrição
PrvParameter() Inicializa uma nova instância da classe Parameter.
PrvParameter(nome da cadeia de caracteres, PrvDbType dataType) Inicializa uma nova instância da classe Parameter com o nome do parâmetro e o tipo de dados.
PrvParameter(nome da cadeia de caracteres, valor do objeto) Inicializa uma nova instância da classe Parameter com o nome do parâmetro e um objeto que é o valor do Parâmetro.
PrvParameter(nome da cadeia de caracteres, PrvDbType dataType, tamanho int) Inicializa uma nova instância da classe Parameter com o nome do parâmetro, o tipo de dados e a largura.
PrvParameter(string name, PrvDbType dataType, int size, string srcColumn) Inicializa uma nova instância da classe DbParameter com o nome do parâmetro, o tipo de dados, a largura e o nome da coluna de origem.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value) Inicializa uma nova instância da classe com o nome do parâmetro, o tipo de dados, a largura, o nome da coluna de origem, a direção do OleDbParameter parâmetro, a precisão numérica e outras propriedades.

Propriedades

Nome Description
DbType

Obtém ou define o DbType parâmetro.
Direction

Obtém ou define um valor que indica se o parâmetro é somente entrada, somente saída, bidirecional ou um parâmetro de valor de retorno de procedimento armazenado.
IsNullable

Obtém um valor que indica se o parâmetro aceita valores nulos.
ParameterName

Obtém ou define o nome do IDataParameter.
SourceColumn

Obtém ou define o nome da coluna de origem mapeada para a DataSet e usada para carregar ou retornar o Value.
SourceVersion

Obtém ou define o DataRowVersion que usar ao carregar Value.
Value

Obtém ou define o valor do parâmetro.

Aplica-se a