SqlParameter Construtores

Referência

Definição

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacote:: System.Data.SqlClient v4.8.6

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.

Inicializa uma nova instância da classe SqlParameter.

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

Confira também

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.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

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Comentários

O tipo de dados e, se apropriado, Tamanho e Precision são inferidos do valor do dbType parâmetro.

Confira também

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 System.Data.SqlClient.SqlParameter : string * obj -> System.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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

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.

Confira também

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.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

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Comentários

O Tamanho será inferido do valor do dbType parâmetro se ele não estiver explicitamente definido no size parâmetro .

Confira também

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.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 este SqlParameter for usado em uma chamada a Update.

Exceções

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Comentários

O Tamanho será inferido do valor do dbType parâmetro se ele não estiver explicitamente definido no size parâmetro .

Confira também

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.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.

sourceVersion: DataRowVersion

Um dos valores de DataRowVersion.

value: Object

Um Object que é o valor do SqlParameter.

Exceções

ArgumentException

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.

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

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 .

Confira também

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.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 este SqlParameter for usado em uma chamada a Update.

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 .

Confira também

Aplica-se a

SqlParameter Construtores

Definição

Sobrecargas

SqlParameter()

Exemplos

Confira também

Aplica-se a

SqlParameter(String, SqlDbType)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

SqlParameter(String, Object)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

SqlParameter(String, SqlDbType, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

SqlParameter(String, SqlDbType, Int32, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Parâmetros

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais