SqlParameter Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| SqlParameter() |
Inicializa uma nova instância da classe SqlParameter. |
| SqlParameter(String, SqlDbType) |
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro e o tipo de dados. |
| SqlParameter(String, Object) |
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro e um valor do novo SqlParameter. |
| SqlParameter(String, SqlDbType, Int32) |
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o SqlDbType e o tamanho. |
| SqlParameter(String, SqlDbType, Int32, String) |
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o SqlDbType, o tamanho e o nome da coluna de origem. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, um ParameterDirection, a precisão do parâmetro, a escala do parâmetro, a coluna de origem, um DataRowVersion a ser usado e o valor do parâmetro. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String) |
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, a direção, a precisão, a escala, o nome da coluna de origem, um dos valores DataRowVersion, um booliano para o mapeamento da coluna de origem, o valor do |
SqlParameter()
Inicializa uma nova instância da classe SqlParameter.
public:
SqlParameter();public SqlParameter ();Public Sub New ()Exemplos
O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Description";
parameter.IsNullable = true;
parameter.SqlDbType = SqlDbType.VarChar;
parameter.Direction = ParameterDirection.Output;
parameter.Size = 88;
command.Parameters.Add(parameter);
}
}
Aplica-se a
SqlParameter(String, SqlDbType)
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro e o tipo de dados.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);public SqlParameter (string parameterName, System.Data.SqlDbType dbType);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType)Parâmetros
- parameterName
- String
O nome do parâmetro a ser mapeado.
Exceções
O valor fornecido no parâmetro dbType é um tipo de dados de back-end inválido.
Exemplos
O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command, string paramValue)
{
SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
parameter.Size = 88;
parameter.Value = paramValue;
command.Parameters.Add(parameter);
}
}
Comentários
O tipo de dados e, se apropriado, Tamanho e Precision são inferidos do valor do dbType parâmetro.
Aplica-se a
SqlParameter(String, Object)
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro e um valor do novo SqlParameter.
public:
SqlParameter(System::String ^ parameterName, System::Object ^ value);public SqlParameter (string parameterName, object value);new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, value As Object)Parâmetros
- parameterName
- String
O nome do parâmetro a ser mapeado.
- value
- Object
Um Object que é o valor do SqlParameter.
Exemplos
O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88, "Description");
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
command.Parameters.Add(parameter);
}
}
Comentários
Quando você especifica um Object no value parâmetro , o SqlDbType é inferido do tipo microsoft .NET Framework do Object.
Tenha cuidado ao usar essa sobrecarga do SqlParameter construtor para especificar valores de parâmetro inteiro. Como essa sobrecarga toma um value do tipo Object, você deve converter o valor integral em um tipo Object quando o valor for zero, como demonstra o exemplo C# a seguir.
Parameter = new SqlParameter("@pname", (object)0);
Se você não executar essa conversão, o compilador pressupõe que você está tentando chamar a sobrecarga do SqlParameter(String, SqlDbType) construtor.
Aplica-se a
SqlParameter(String, SqlDbType, Int32)
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o SqlDbType e o tamanho.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer)Parâmetros
- parameterName
- String
O nome do parâmetro a ser mapeado.
- size
- Int32
O tamanho do parâmetro.
Exceções
O valor fornecido no parâmetro dbType é um tipo de dados de back-end inválido.
Exemplos
O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command,
string paramValue)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88);
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
parameter.Value = paramValue;
command.Parameters.Add(parameter);
}
}
Comentários
O Tamanho será inferido do valor do dbType parâmetro se ele não estiver explicitamente definido no size parâmetro .
Aplica-se a
SqlParameter(String, SqlDbType, Int32, String)
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o SqlDbType, o tamanho e o nome da coluna de origem.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)Parâmetros
- parameterName
- String
O nome do parâmetro a ser mapeado.
- size
- Int32
O tamanho do parâmetro.
- sourceColumn
- String
O nome da coluna de origem (SourceColumn) se isso SqlParameter for usado em uma chamada para Update(DataSet)>.
Exceções
O valor fornecido no parâmetro dbType é um tipo de dados de back-end inválido.
Exemplos
O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88, "Description");
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
command.Parameters.Add(parameter);
}
}
Comentários
O Tamanho será inferido do valor do dbType parâmetro se ele não estiver explicitamente definido no size parâmetro .
Aplica-se a
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, um ParameterDirection, a precisão do parâmetro, a escala do parâmetro, a coluna de origem, um DataRowVersion a ser usado e o valor do parâmetro.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)Parâmetros
- parameterName
- String
O nome do parâmetro a ser mapeado.
- size
- Int32
O tamanho do parâmetro.
- direction
- ParameterDirection
Um dos valores de ParameterDirection.
- isNullable
- Boolean
true se o valor do campo puder ser nulo; caso contrário, false.
- precision
- Byte
O número total de dígitos à esquerda e à direita do ponto decimal para o qual o Value é resolvido.
- sourceColumn
- String
O nome da coluna de origem (SourceColumn) se este SqlParameter for usado em uma chamada a Update(DataSet).
- sourceVersion
- DataRowVersion
Um dos valores de DataRowVersion.
- value
- Object
Um Object que é o valor do SqlParameter.
Exceções
O valor fornecido no parâmetro dbType é um tipo de dados de back-end inválido.
Exemplos
O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.
using Microsoft.Data.SqlClient;
class Program
{
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 11, ParameterDirection.Input,
true, 0, 0, "Description", DataRowVersion.Current,
"garden hose");
parameter.IsNullable = true;
command.Parameters.Add(parameter);
}
}
Comentários
O Tamanho e Precision serão inferidos do valor do dbType parâmetro se eles não forem definidos explicitamente nos size parâmetros e precision .
Aplica-se a
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)
Inicializa uma nova instância da classe SqlParameter que usa o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, a direção, a precisão, a escala, o nome da coluna de origem, um dos valores DataRowVersion, um booliano para o mapeamento da coluna de origem, o valor do SqlParameter, o nome do banco de dados em que a coleção de esquemas dessa instância XML está localizada, o esquema relacional de propriedade em que a coleção de esquemas dessa instância XML está localizada e o nome da coleção de esquemas desse parâmetro.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)Parâmetros
- parameterName
- String
O nome do parâmetro a ser mapeado.
- size
- Int32
O tamanho do parâmetro.
- direction
- ParameterDirection
Um dos valores de ParameterDirection.
- precision
- Byte
O número total de dígitos à esquerda e à direita do ponto decimal para o qual o Value é resolvido.
- sourceColumn
- String
O nome da coluna de origem (SourceColumn) se isso SqlParameter for usado em uma chamada para Update(DataSet)>.
- sourceVersion
- DataRowVersion
Um dos valores de DataRowVersion.
- sourceColumnNullMapping
- Boolean
true se a coluna de origem for nula; caso contrário, false.
- value
- Object
Um Object que é o valor do SqlParameter.
- xmlSchemaCollectionDatabase
- String
O nome do banco de dados em que a coleção de esquemas dessa instância XML está localizada.
- xmlSchemaCollectionOwningSchema
- String
O esquema relacional proprietário em que a coleção de esquemas dessa instância XML está localizada.
- xmlSchemaCollectionName
- String
O nome da coleção de esquemas desse parâmetro.
Comentários
O Size e Precision serão inferidos do valor do dbType parâmetro se eles não forem definidos explicitamente nos size parâmetros e precision .