SqlParameter Clase
Definición
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 para un elemento SqlCommand y, de forma opcional, su asignación a columnas DataSet. Esta clase no puede heredarse. Para más información sobre los parámetros, vea Configurar parámetros y tipos de datos de parámetros.
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
- Herencia
- Herencia
- Atributos
- Implementaciones
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 ya se ha creado un DataSet objeto 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 Recuperación y modificación de datos en ADO.NET y Configuración de parámetros y tipos de datos de parámetros.
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
En los nombres de parámetros no se distinguen mayúsculas de minúsculas.
Nota
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
SqlParameter() |
Inicializa una nueva instancia de la clase SqlParameter. |
SqlParameter(String, Object) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre de parámetro y un valor del nuevo elemento SqlParameter. |
SqlParameter(String, SqlDbType) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre de parámetro y el tipo de datos. |
SqlParameter(String, SqlDbType, Int32) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el SqlDbType y el tamaño. |
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre, el tipo y el tamaño del parámetro, una ParameterDirection, l precisión y la escala del parámetro, la columna de origen, una DataRowVersion que se usará y el valor del parámetro. |
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String) |
Inicializa una nueva instancia de la clase SqlParameter 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 valores de DataRowVersion, un valor booleano para la asignación de la columna de origen, el valor de |
SqlParameter(String, SqlDbType, Int32, String) |
Inicializa una nueva instancia de la clase SqlParameter que usa el nombre del parámetro, el SqlDbType, el tamaño y el nombre de la columna de origen. |
Propiedades
CompareInfo |
Obtiene o establece el objeto CompareInfo que define cómo se deben realizar las comparaciones de cadenas para este parámetro. |
DbType |
Obtiene o establece el SqlDbType del parámetro. |
Direction |
Obtiene o establece un valor que indica si el parámetro es sólo de entrada, sólo de salida, bidireccional, o un valor devuelto de un procedimiento almacenado. |
ForceColumnEncryption |
Aplica el cifrado de un parámetro al usar Always Encrypted. Si SQL Server indica al controlador que no hace falta cifrar el parámetro, la consulta que utilice este último generará un error. Esta propiedad confiere una protección adicional frente a ataques contra la seguridad que utilice un servidor SQL Server comprometido que proporcione metadatos de cifrado incorrectos al cliente, lo cual podría provocar la divulgación de datos. |
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 ni evita el envío o la recepción de un valor null al ejecutar un comando. |
LocaleId |
Obtiene o establece el identificador de configuración regional que determina las convenciones y el idioma de una región determinada. |
Offset |
Obtiene o establece el desplazamiento hasta la propiedad Value. |
ParameterName |
Obtiene o establece el nombre de SqlParameter. |
Precision |
Obtiene o establece el número máximo de dígitos usados para representar la propiedad Value. |
Scale |
Obtiene o establece el número de posiciones decimales con que se resuelve Value. |
Size |
Obtiene o establece el tamaño máximo, en bytes, de los datos de la columna. |
SourceColumn |
Obtiene o establece el nombre de la columna de origen asignada al objeto DataSet y utilizada para cargar o devolver la propiedad Value. |
SourceColumnNullMapping |
Obtiene o establece un valor que indica si la columna de origen admite valores NULL. Esto permite a SqlCommandBuilder generar correctamente instrucciones Update para las columnas que aceptan valores NULL. |
SourceVersion |
Obtiene o establece la enumeración DataRowVersion que se va a utilizar a la hora de cargar Value. |
SourceVersion |
Obtiene o establece la enumeración DataRowVersion que se va a utilizar a la hora de cargar Value. (Heredado de DbParameter) |
SqlDbType |
Obtiene o establece el SqlDbType del parámetro. |
SqlValue |
Obtiene o establece el valor del parámetro como tipo SQL. |
TypeName |
Obtiene o establece el nombre de tipo para un parámetro con valores de tabla. |
UdtTypeName |
Obtiene o establece un |
Value |
Obtiene o establece el valor del parámetro. |
XmlSchemaCollectionDatabase |
Obtiene el nombre de la base de datos donde se encuentra la colección de esquemas para esta instancia XML. |
XmlSchemaCollectionName |
Obtiene el nombre de la colección de esquemas para esta instancia XML. |
XmlSchemaCollectionOwningSchema |
Esquema relacional propietario donde se encuentra la colección de esquemas para esta instancia XML. |
Métodos
CreateObjRef(Type) |
Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la 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 Object actual. (Heredado de Object) |
MemberwiseClone(Boolean) |
Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject) |
ResetDbType() |
Restablece el tipo asociado a este SqlParameter. |
ResetSqlDbType() |
Restablece el tipo asociado a este SqlParameter. |
ToString() |
Obtiene una cadena que contiene la propiedad ParameterName. |
Implementaciones de interfaz explícitas
ICloneable.Clone() |
Para obtener una descripción de este miembro, vea Clone(). |
IDataParameter.SourceVersion |
Obtiene o establece DataRowVersion que se va a utilizar 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) |