SqlParameter Construtores

Definição

Namespace:: System.Data.SqlClient

Assembly:: System.Data.dll

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

Nome	Description
SqlParameter()	Inicializa uma nova instância da classe SqlParameter.
SqlParameter(String, SqlDbType)	Inicializa uma nova instância da SqlParameter classe que usa o nome do parâmetro e o tipo de dados.
SqlParameter(String, Object)	Inicializa uma nova instância da SqlParameter classe que usa o nome do parâmetro e um valor do novo SqlParameter.
SqlParameter(String, SqlDbType, Int32)	Inicializa uma nova instância da SqlParameter classe que usa o nome do parâmetro, o SqlDbTypee o tamanho.
SqlParameter(String, SqlDbType, Int32, String)	Inicializa uma nova instância da SqlParameter classe que usa o nome do parâmetro, o SqlDbTypetamanho e o nome da coluna de origem.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicializa uma nova instância da SqlParameter classe que usa o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, uma ParameterDirectionprecisão do parâmetro, a escala do parâmetro, a coluna de origem, a DataRowVersion usar 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 que usa o nome do SqlParameter parâmetro, o tipo do parâmetro, o comprimento do parâmetro a direção, a precisão, a escala, o nome da coluna de origem, um dos DataRowVersion valores, um booliano para mapeamento de 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 proprietário em que a coleção de esquemas dessa instância XML está localizada e o nome da coleção de esquemas para esse 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 SqlParameter classe 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 SqlDbType valores.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é 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 SqlParameter classe 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 valor 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 parâmetro value, o SqlDbType é inferido do tipo Microsoft .NET do Object.

Tenha cuidado ao usar essa sobrecarga do SqlParameter construtor para especificar valores de parâmetro inteiros. Como essa sobrecarga usa um value tipo Object, você deve converter o valor integral em um Object tipo quando o valor for zero, como demonstra o exemplo de C# a seguir.

Parameter = new SqlParameter("@pname", (object)0);

Se você não executar essa conversão, o compilador assumirá 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 SqlParameter classe que usa o nome do parâmetro, o SqlDbTypee 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 SqlDbType valores.

size: Int32

O comprimento do parâmetro.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é 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 SqlParameter classe que usa o nome do parâmetro, o SqlDbTypetamanho 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 SqlDbType valores.

size: Int32

O comprimento do parâmetro.

sourceColumn: String

O nome da coluna de origem (SourceColumn) se isso SqlParameter for usado em uma chamada para Update.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é 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 SqlParameter classe que usa o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, uma ParameterDirectionprecisão do parâmetro, a escala do parâmetro, a coluna de origem, a DataRowVersion usar 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 SqlDbType valores.

size: Int32

O comprimento do parâmetro.

direction: ParameterDirection

Um dos ParameterDirection valores.

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 ao qual Value é resolvido.

scale: Byte

O número total de casas decimais para as quais Value é resolvido.

sourceColumn: String

O nome da coluna de origem (SourceColumn) se isso SqlParameter for usado em uma chamada para Update.

sourceVersion: DataRowVersion

Um dos DataRowVersion valores.

value: Object

Um Object valor que é o valor do SqlParameter.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é 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 são inferidos do valor do dbType parâmetro se eles não estiverem explicitamente definidos 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 que usa o nome do SqlParameter parâmetro, o tipo do parâmetro, o comprimento do parâmetro a direção, a precisão, a escala, o nome da coluna de origem, um dos DataRowVersion valores, um booliano para mapeamento de 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 proprietário em que a coleção de esquemas dessa instância XML está localizada e o nome da coleção de esquemas para esse 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 SqlDbType valores.

size: Int32

O comprimento do parâmetro.

direction: ParameterDirection

Um dos ParameterDirection valores.

precision: Byte

O número total de dígitos à esquerda e à direita do ponto decimal ao qual Value é resolvido.

scale: Byte

O número total de casas decimais para as quais Value é resolvido.

sourceColumn: String

O nome da coluna de origem (SourceColumn) se isso SqlParameter for usado em uma chamada para Update.

sourceVersion: DataRowVersion

Um dos DataRowVersion valores.

sourceColumnNullMapping: Boolean

true se a coluna de origem for anulável; false se não for.

value: Object

Um Object valor 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 para esse parâmetro.

Comentários

E Size serão inferidos do valor do dbType parâmetro se eles não estiverem explicitamente definidos nos size parâmetros eprecision.Precision

Confira também

Aplica-se a

Comentários

Esta página foi útil?