SqlParameter Construtores

Definição

Espaço de Nomes:: System.Data.SqlClient

Assemblagem:: System.Data.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da SqlParameter classe.

Sobrecargas

Name	Description
SqlParameter()	Inicializa uma nova instância da SqlParameter classe.
SqlParameter(String, SqlDbType)	Inicializa uma nova instância da SqlParameter classe que utiliza o nome do parâmetro e o tipo de dado.
SqlParameter(String, Object)	Inicializa uma nova instância da SqlParameter classe que utiliza o nome do parâmetro e um valor do novo SqlParameter.
SqlParameter(String, SqlDbType, Int32)	Inicializa uma nova instância da SqlParameter classe que utiliza o nome do parâmetro, o SqlDbType, e o tamanho.
SqlParameter(String, SqlDbType, Int32, String)	Inicializa uma nova instância da SqlParameter classe que utiliza 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 SqlParameter classe que utiliza o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, a ParameterDirection, a precisão do parâmetro, a escala do parâmetro, a coluna de origem, a DataRowVersion a para 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 SqlParameter classe que usa o nome do 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 Booleano para mapeamento de colunas de origem, o valor de , `SqlParameter`o nome da base de dados onde está localizada a coleção de esquemas desta instância XML, o esquema relacional proprietário onde está localizada a coleção de esquemas para esta instância XML, e o nome da coleção de esquemas para este parâmetro.

SqlParameter()

Inicializa uma nova instância da SqlParameter classe.

public:
 SqlParameter();

public SqlParameter();

Public Sub New ()

Exemplos

O exemplo seguinte cria um SqlParameter e define algumas das 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

Ver também

Aplica-se a

SqlParameter(String, SqlDbType)

Inicializa uma nova instância da SqlParameter classe que utiliza o nome do parâmetro e o tipo de dado.

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

dbType: SqlDbType

Um dos SqlDbType valores.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é um tipo de dado back-end inválido.

Exemplos

O exemplo seguinte cria um SqlParameter e define algumas das 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

Observações

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

Ver também

Aplica-se a

SqlParameter(String, Object)

Inicializa uma nova instância da SqlParameter classe que utiliza 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 mapear.

value: Object

E Object que é o valor do SqlParameter.

Exemplos

O exemplo seguinte cria um SqlParameter e define algumas das 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

Observações

Quando especifica um Object no parâmetro value, o SqlDbType é inferido a partir do tipo Microsoft .NET do Object.

Tenha cuidado ao usar esta sobrecarga do SqlParameter construtor para especificar valores inteiros dos parâmetros. Como esta sobrecarga toma um value de tipo Object, deve converter o valor integral para um Object tipo quando o valor é zero, como demonstra o exemplo seguinte em C#.

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

Se não realizar esta conversão, o compilador assume que está a tentar chamar a SqlParameter(String, SqlDbType) sobrecarga do construtor.

Ver também

Aplica-se a

SqlParameter(String, SqlDbType, Int32)

Inicializa uma nova instância da SqlParameter classe que utiliza 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 mapear.

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 dado back-end inválido.

Exemplos

O exemplo seguinte cria um SqlParameter e define algumas das 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

Observações

O Tamanho é inferido a partir do valor do dbType parâmetro se não estiver explicitamente definido no size parâmetro.

Ver também

Aplica-se a

SqlParameter(String, SqlDbType, Int32, String)

Inicializa uma nova instância da SqlParameter classe que utiliza 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 mapear.

dbType: SqlDbType

Um dos SqlDbType valores.

size: Int32

O comprimento do parâmetro.

sourceColumn: String

O nome da coluna fonte (SourceColumn) se isto SqlParameter for usado numa chamada para Update.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é um tipo de dado back-end inválido.

Exemplos

O exemplo seguinte cria um SqlParameter e define algumas das 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

Observações

O Tamanho é inferido a partir do valor do dbType parâmetro se não estiver explicitamente definido no size parâmetro.

Ver 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 utiliza o nome do parâmetro, o tipo do parâmetro, o tamanho do parâmetro, a ParameterDirection, a precisão do parâmetro, a escala do parâmetro, a coluna de origem, a DataRowVersion a para 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 mapear.

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 pode ser nulo; caso contrário, false.

precision: Byte

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

scale: Byte

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

sourceColumn: String

O nome da coluna fonte (SourceColumn) se isto SqlParameter for usado numa chamada para Update.

sourceVersion: DataRowVersion

Um dos DataRowVersion valores.

value: Object

E Object que é o valor do SqlParameter.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é um tipo de dado back-end inválido.

Exemplos

O exemplo seguinte cria um SqlParameter e define algumas das 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

Observações

Os Size e Precision são inferidos a partir do valor do dbType parâmetro se não estiverem explicitamente definidos nos size parâmetros eprecision.

Ver 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 SqlParameter classe que usa o nome do 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 Booleano para mapeamento de colunas de origem, o valor de , SqlParametero nome da base de dados onde está localizada a coleção de esquemas desta instância XML, o esquema relacional proprietário onde está localizada a coleção de esquemas para esta instância XML, e o nome da coleção de esquemas para este 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 mapear.

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

scale: Byte

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

sourceColumn: String

O nome da coluna fonte (SourceColumn) se isto SqlParameter for usado numa 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

E Object que é o valor do SqlParameter.

xmlSchemaCollectionDatabase: String

O nome da base de dados onde se encontra a coleção de esquemas desta instância XML.

xmlSchemaCollectionOwningSchema: String

O esquema relacional proprietário onde se encontra a coleção de esquemas para esta instância XML.

xmlSchemaCollectionName: String

O nome da coleção de esquemas para este parâmetro.

Observações

Os Size e Precision são inferidos a partir do valor do dbType parâmetro se não estiverem explicitamente definidos nos size parâmetros e precision .

Ver também

Aplica-se a

Comentários

Esta página foi útil?