Partilhar via


SqlParameter Construtores

Definição

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, 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.

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)

Parâmetros

parameterName
String

O nome do parâmetro a ser mapeado.

dbType
SqlDbType

Um dos valores de SqlDbType.

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.SqlParameter
Public 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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Parâmetros

parameterName
String

O nome do parâmetro a ser mapeado.

dbType
SqlDbType

Um dos valores de SqlDbType.

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.SqlParameter
Public 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.

dbType
SqlDbType

Um dos valores de SqlDbType.

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.SqlParameter
Public 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.

dbType
SqlDbType

Um dos valores de SqlDbType.

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.

scale
Byte

O número total de casas decimais para as quais 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.SqlParameter
Public 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.

dbType
SqlDbType

Um dos valores de SqlDbType.

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.

scale
Byte

O número total de casas decimais para as quais 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 .

Aplica-se a