SqlParameter Clase

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.SqlClient.dll

Ensamblado:: System.Data.dll

Source:: System.Data.SqlClient.notsupported.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un parámetro a y, opcionalmente, su asignación SqlCommand a DataSet columnas. Esta clase no puede heredarse. Para obtener más información sobre los parámetros, vea Configurar parámetros y tipos de datos de parámetros.

Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

public ref class SqlParameter sealed : System::Data::Common::DbParameter

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Herencia: Object

DbParameter
SqlParameter

Herencia: Object

MarshalByRefObject

DbParameter
SqlParameter

Herencia: Object

MarshalByRefObject
SqlParameter

Atributos: TypeConverterAttribute

Implementaciones: IDataParameter IDbDataParameter ICloneable

Ejemplos

En el ejemplo siguiente se crean varias instancias de a través de SqlParameter la SqlParameterCollection colección dentro de SqlDataAdapter. Estos parámetros se usan para seleccionar datos del origen de datos y colocar los datos en .DataSet En este ejemplo se supone que DataSet ya se ha creado un y SqlDataAdapter mediante el esquema, los comandos y la conexión adecuados. Para obtener más información y ejemplos adicionales sobre el uso de parámetros, vea Retrieving and Modifying Data in ADO.NET and Configuring Parameters and Parameter Types.

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

Comentarios

Los nombres de parámetro no distinguen mayúsculas de minúsculas.

Note

Sin nombre, también denominado ordinal, los parámetros no son compatibles con el proveedor de datos de .NET Framework para SQL Server.

Para obtener más información, junto con código de ejemplo adicional que muestra cómo usar parámetros, vea Comandos y parámetros.

Constructores

Nombre	Description
SqlParameter()	Inicializa una nueva instancia de la clase SqlParameter. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlParameter(String, Object)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro y un valor del nuevo SqlParameter. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro, el tipo del parámetro, el tamaño del parámetro, una ParameterDirection, la precisión del parámetro, la escala del parámetro, la columna de origen, un DataRowVersion objeto que se va a usar y el valor del parámetro. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro, el tipo del parámetro, la longitud del parámetro la dirección, la precisión, la escala, el nombre de la columna de origen, uno de los DataRowVersion valores, un valor booleano para la asignación de columnas de origen, el valor de , el nombre de `SqlParameter`la base de datos donde se encuentra la colección de esquemas para esta instancia XML, el esquema relacional propietario donde se encuentra la colección de esquemas para esta instancia XML y el nombre de la colección de esquemas para este parámetro. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, String)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro, SqlDbTypeel , el tamaño y el nombre de la columna de origen. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro, , SqlDbTypey el tamaño. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Inicializa una nueva instancia de la SqlParameter clase que usa el nombre del parámetro y el tipo de datos. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Propiedades

Nombre	Description
CompareInfo	Obtiene o establece el CompareInfo objeto que define cómo se deben realizar comparaciones de cadenas para este parámetro. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
DbType	Obtiene o establece el SqlDbType del parámetro . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Direction	Obtiene o establece un valor que indica si el parámetro es de solo entrada, solo salida, bidireccional o un parámetro de valor devuelto de procedimiento almacenado. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
ForceColumnEncryption	Aplica el cifrado de un parámetro cuando se usa Always Encrypted. Si SQL Server informa al controlador de que no es necesario cifrar el parámetro, se producirá un error en la consulta mediante el parámetro . Esta propiedad proporciona protección adicional contra ataques de seguridad que implican un SQL Server comprometido que proporciona metadatos de cifrado incorrectos al cliente, lo que puede provocar la divulgación de datos. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
IsNullable	Obtiene o establece un valor que indica si el parámetro acepta valores NULL. IsNullable no se usa para validar el valor del parámetro y no impedirá enviar ni recibir un valor NULL al ejecutar un comando. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
LocaleId	Obtiene o establece el identificador de configuración regional que determina las convenciones y el idioma de una región determinada. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Offset	Obtiene o establece el desplazamiento en la Value propiedad . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
ParameterName	Obtiene o establece el nombre de .SqlParameter Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Precision	Obtiene o establece el número máximo de dígitos utilizados para representar la Value propiedad . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Scale	Obtiene o establece el número de posiciones decimales en las que Value se resuelve. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Size	Obtiene o establece el tamaño máximo, en bytes, de los datos de la columna. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SourceColumn	Obtiene o establece el nombre de la columna de origen asignada a DataSet y utilizada para cargar o devolver .Value Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SourceColumnNullMapping	Obtiene o establece un valor que indica si la columna de origen admite valores NULL. Esto permite SqlCommandBuilder generar correctamente instrucciones Update para columnas que aceptan valores NULL. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SourceVersion	Obtiene o establece el objeto DataRowVersion que se va a usar al cargar Value. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlDbType	Obtiene o establece el SqlDbType del parámetro . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
SqlValue	Obtiene o establece el valor del parámetro como un tipo SQL. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
TypeName	Obtiene o establece el nombre de tipo de un parámetro con valores de tabla. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
UdtTypeName	Obtiene o establece un `string` objeto que representa un tipo definido por el usuario como parámetro. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Value	Obtiene o establece el valor del parámetro . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
XmlSchemaCollectionDatabase	Obtiene el nombre de la base de datos donde se encuentra la colección de esquemas para esta instancia XML. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
XmlSchemaCollectionName	Obtiene el nombre de la colección de esquemas para esta instancia XML. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Esquema relacional propietario donde se encuentra la colección de esquemas para esta instancia XML. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Métodos

Nombre	Description
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
ResetDbType()	Restablece el tipo asociado a este SqlParameter. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
ResetSqlDbType()	Restablece el tipo asociado a este SqlParameter. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
ToString()	Obtiene una cadena que contiene .ParameterName Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Para obtener una descripción de este miembro, vea Clone(). Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
IDataParameter.SourceVersion	Obtiene o establece el objeto DataRowVersion que se va a usar al cargar Value. (Heredado de DbParameter)
IDbDataParameter.Precision	Indica la precisión de los parámetros numéricos. (Heredado de DbParameter)
IDbDataParameter.Scale	Para obtener una descripción de este miembro, vea Scale. (Heredado de DbParameter)

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?