Evaluar y enviar comentarios
Contraer todo/Expandir todo Contraer todo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
Biblioteca de clases de .NET Framework
IDataParameter (Interfaz)

Representa un parámetro para un objeto Command y, de forma opcional, su asignación a columnas del DataSet. Lo implementan los proveedores de datos de .NET Framework que tienen acceso a los orígenes de datos.

Espacio de nombres: System.Data
Ensamblado: System.Data (en system.data.dll)

Visual Basic (Declaración)
Public Interface IDataParameter
Visual Basic (Uso)
Dim instance As IDataParameter
C#
public interface IDataParameter
C++
public interface class IDataParameter
J#
public interface IDataParameter
JScript
public interface IDataParameter

La interfaz IDataParameter permite que una clase heredada implemente una clase Parameter, que representa un parámetro para un objeto Command. Para obtener más información sobre las clases Parameter, vea Utilizar procedimientos almacenados con un comando. Para obtener más información sobre la implementación de proveedores de datos de .NET Framework, vea Implementing a .NET Framework Data Provider.

Una aplicación no crea una instancia de la interfaz IDataParameter directamente, sino que crea una instancia de una clase que hereda de IDataParameter.

Las clases que heredan de IDataParameter deben implementar los miembros heredados y suelen definir miembros adicionales para agregar la funcionalidad específica de proveedor. Por ejemplo, la interfaz IDataParameter define la propiedad DbType. A su vez, la clase OleDbParameter hereda esta propiedad y también define la propiedad OleDbType.

Notas para los implementadores Para potenciar la coherencia entre los proveedores de datos de .NET Framework, asigne a la clase heredada un nombre con el formato Prv Parameter, donde Prv es el prefijo uniforme que se asigna a todas las clases de un espacio de nombres de proveedor de datos de .NET Framework específico. Por ejemplo, Sql es el prefijo de la clase SqlCommand en el espacio de nombres System.Data.SqlClient. Al heredar de la interfaz IDataParameter, se deben implementar los siguientes constructores:

Elemento

Descripción

PrvParameter()

Inicializa una nueva instancia de la clase Parameter.

PrvParameter(string name, PrvDbType dataType)

Inicializa una nueva instancia de la clase Parameter con el nombre de parámetro y el tipo de datos.

PrvParameter(string name, object value)

Inicializa una nueva instancia de la clase Parameter con el nombre de parámetro y un objeto que es el valor de Parameter.

PrvParameter(string name, PrvDbType dataType, int size)

Inicializa una nueva instancia de la clase Parameter con el nombre de parámetro, el tipo de datos y el ancho.

PrvParameter(string name, PrvDbType dataType, int size, string srcColumn)

Inicializa una nueva instancia de la clase DbParameter con el nombre de parámetro, el tipo de datos, el ancho y el nombre de columna de origen.

PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value)

Inicializa una nueva instancia de la clase OleDbParameter con el nombre de parámetro, el tipo de datos, el ancho, el nombre de columna de origen, la dirección de parámetros, la precisión numérica y otras propiedades.

En el ejemplo siguiente se crean varias instancias de la clase derivada SqlParameter a través de la colección SqlParameterCollection dentro del SqlDataAdapter. Estos parámetros se utilizan para seleccionar datos del origen de datos y colocarlos en DataSet. En este ejemplo se supone que ya se han creado un DataSet y un SqlDataAdapter con el esquema, los comandos y la conexión adecuados.

Visual Basic
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  
C#
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);

}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
Processing
© 2012 Microsoft. Reservados todos los derechos. Términos de uso | Marcas Registradas | Privacidad
Page view tracker