SqlParameter Costruttori

Definizione

Inizializza una nuova istanza della classe SqlParameter.Initializes a new instance of the SqlParameter class.

Overload

SqlParameter()

Inizializza una nuova istanza della classe SqlParameter.Initializes a new instance of the SqlParameter class.

SqlParameter(String, SqlDbType)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e il tipo di dati.Initializes a new instance of the SqlParameter class that uses the parameter name and the data type.

SqlParameter(String, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e un valore del nuovo oggetto SqlParameter.Initializes a new instance of the SqlParameter class that uses the parameter name and a value of the new SqlParameter.

SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType e la dimensione.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, and the size.

SqlParameter(String, SqlDbType, Int32, String)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType, le dimensioni e il nome della colonna di origine.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, the size, and the source column name.

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

Inizializza una nuova istanza della classe SqlParameter che usa il nome, il tipo e la dimensione del parametro, un oggetto ParameterDirection, la precisione e la scala del parametro, la colonna di origine, un oggetto DataRowVersion da usare e il valore del parametro.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the size of the parameter, a ParameterDirection, the precision of the parameter, the scale of the parameter, the source column, a DataRowVersion to use, and the value of the parameter.

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

Inizializza una nuova istanza della classe SqlParameter che usa il nome, il tipo e la lunghezza del parametro, la direzione, la precisione, la scala, il nome della colonna di origine, uno dei valori di DataRowVersion, un valore booleano per il mapping della colonna di origine, il valore di SqlParameter, il nome del database in cui si trova la raccolta di schemi di questa istanza XML, lo schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML e il nome della raccolta di schemi per questo parametro.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the length of the parameter the direction, the precision, the scale, the name of the source column, one of the DataRowVersion values, a Boolean for source column mapping, the value of the SqlParameter, the name of the database where the schema collection for this XML instance is located, the owning relational schema where the schema collection for this XML instance is located, and the name of the schema collection for this parameter.

SqlParameter()

Inizializza una nuova istanza della classe SqlParameter.Initializes a new instance of the SqlParameter class.

public:
 SqlParameter();
public SqlParameter ();
Public Sub New ()

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.The following example creates a SqlParameter and sets some of its properties.

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

Vedi anche

SqlParameter(String, SqlDbType)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e il tipo di dati.Initializes a new instance of the SqlParameter class that uses the parameter name and the data type.

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)

Parametri

parameterName
String

Nome del parametro di cui eseguire il mapping.The name of the parameter to map.

dbType
SqlDbType

Uno dei valori di SqlDbType.One of the SqlDbType values.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.The value supplied in the dbType parameter is an invalid back-end data type.

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.The following example creates a SqlParameter and sets some of its properties.

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

Commenti

Il tipo di dati e, se appropriato, le dimensioni e Precision vengono dedotti dal valore del parametro dbType.The data type and, if appropriate, Size and Precision are inferred from the value of the dbType parameter.

Vedi anche

SqlParameter(String, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e un valore del nuovo oggetto SqlParameter.Initializes a new instance of the SqlParameter class that uses the parameter name and a value of the new 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)

Parametri

parameterName
String

Nome del parametro di cui eseguire il mapping.The name of the parameter to map.

value
Object

Oggetto Object che rappresenta il valore di SqlParameter.An Object that is the value of the SqlParameter.

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.The following example creates a SqlParameter and sets some of its properties.

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

Commenti

Quando si specifica un Object nel parametro value, il SqlDbType viene dedotto dal tipo Microsoft .NET Framework del Object.When you specify an Object in the value parameter, the SqlDbType is inferred from the Microsoft .NET Framework type of the Object.

Prestare attenzione quando si utilizza questo overload del costruttore SqlParameter per specificare i valori dei parametri Integer.Use caution when you use this overload of the SqlParameter constructor to specify integer parameter values. Poiché l'overload accetta un value di tipo Object, è necessario convertire il valore integrale in un tipo Object, come illustrato nell'esempio C# riportato di seguito.Because this overload takes a value of type Object, you must convert the integral value to an Object type when the value is zero, as the following C# example demonstrates.

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

Se non si esegue questa conversione, il compilatore presuppone che si stia tentando di chiamare l'overload del costruttore SqlParameter(String, SqlDbType).If you do not perform this conversion, the compiler assumes that you are trying to call the SqlParameter(String, SqlDbType) constructor overload.

Vedi anche

SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType e la dimensione.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, and the size.

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)

Parametri

parameterName
String

Nome del parametro di cui eseguire il mapping.The name of the parameter to map.

dbType
SqlDbType

Uno dei valori di SqlDbType.One of the SqlDbType values.

size
Int32

Lunghezza del parametro.The length of the parameter.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.The value supplied in the dbType parameter is an invalid back-end data type.

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.The following example creates a SqlParameter and sets some of its properties.

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

Commenti

La dimensione viene dedotta dal valore del parametro dbType se non è impostata in modo esplicito nel parametro size.The Size is inferred from the value of the dbType parameter if it is not explicitly set in the size parameter.

Vedi anche

SqlParameter(String, SqlDbType, Int32, String)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType, le dimensioni e il nome della colonna di origine.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, the size, and the source column name.

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)

Parametri

parameterName
String

Nome del parametro di cui eseguire il mapping.The name of the parameter to map.

dbType
SqlDbType

Uno dei valori di SqlDbType.One of the SqlDbType values.

size
Int32

Lunghezza del parametro.The length of the parameter.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update.The name of the source column (SourceColumn) if this SqlParameter is used in a call to Update.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.The value supplied in the dbType parameter is an invalid back-end data type.

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.The following example creates a SqlParameter and sets some of its properties.

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

Commenti

La dimensione viene dedotta dal valore del parametro dbType se non è impostata in modo esplicito nel parametro size.The Size is inferred from the value of the dbType parameter if it is not explicitly set in the size parameter.

Vedi anche

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

Inizializza una nuova istanza della classe SqlParameter che usa il nome, il tipo e la dimensione del parametro, un oggetto ParameterDirection, la precisione e la scala del parametro, la colonna di origine, un oggetto DataRowVersion da usare e il valore del parametro.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the size of the parameter, a ParameterDirection, the precision of the parameter, the scale of the parameter, the source column, a DataRowVersion to use, and the value of the parameter.

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)

Parametri

parameterName
String

Nome del parametro di cui eseguire il mapping.The name of the parameter to map.

dbType
SqlDbType

Uno dei valori di SqlDbType.One of the SqlDbType values.

size
Int32

Lunghezza del parametro.The length of the parameter.

direction
ParameterDirection

Uno dei valori di ParameterDirection.One of the ParameterDirection values.

isNullable
Boolean

true se il valore del campo può essere Null; in caso contrario, false.true if the value of the field can be null; otherwise, false.

precision
Byte

Numero totale di cifre a sinistra e a destra del separatore decimale in cui viene risolto Value.The total number of digits to the left and right of the decimal point to which Value is resolved.

scale
Byte

Numero totale di posizioni decimali in cui viene risolto Value .The total number of decimal places to which Value is resolved.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update.The name of the source column (SourceColumn) if this SqlParameter is used in a call to Update.

sourceVersion
DataRowVersion

Uno dei valori di DataRowVersion.One of the DataRowVersion values.

value
Object

Oggetto Object che rappresenta il valore di SqlParameter.An Object that is the value of the SqlParameter.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.The value supplied in the dbType parameter is an invalid back-end data type.

Esempi

Nell'esempio seguente viene creata una SqlParameter e vengono impostate alcune delle relative proprietà.The following example creates a SqlParameter and sets some of its properties.

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

Commenti

Le dimensioni e la Precision vengono dedotte dal valore del parametro dbType se non sono impostate in modo esplicito nei parametri size e precision.The Size and Precision are inferred from the value of the dbType parameter if they are not explicitly set in the size and precision parameters.

Vedi anche

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

Inizializza una nuova istanza della classe SqlParameter che usa il nome, il tipo e la lunghezza del parametro, la direzione, la precisione, la scala, il nome della colonna di origine, uno dei valori di DataRowVersion, un valore booleano per il mapping della colonna di origine, il valore di SqlParameter, il nome del database in cui si trova la raccolta di schemi di questa istanza XML, lo schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML e il nome della raccolta di schemi per questo parametro.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the length of the parameter the direction, the precision, the scale, the name of the source column, one of the DataRowVersion values, a Boolean for source column mapping, the value of the SqlParameter, the name of the database where the schema collection for this XML instance is located, the owning relational schema where the schema collection for this XML instance is located, and the name of the schema collection for this parameter.

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)

Parametri

parameterName
String

Nome del parametro di cui eseguire il mapping.The name of the parameter to map.

dbType
SqlDbType

Uno dei valori di SqlDbType.One of the SqlDbType values.

xmlSchemaCollectionDatabase
String

Nome del database in cui si trova la raccolta di schemi per questa istanza XML.The name of the database where the schema collection for this XML instance is located.

xmlSchemaCollectionOwningSchema
String

Schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML.The owning relational schema where the schema collection for this XML instance is located.

xmlSchemaCollectionName
String

Nome della raccolta di schemi per questo parametro.The name of the schema collection for this parameter.

size
Int32

Lunghezza del parametro.The length of the parameter.

direction
ParameterDirection

Uno dei valori di ParameterDirection.One of the ParameterDirection values.

precision
Byte

Numero totale di cifre a sinistra e a destra del separatore decimale in cui viene risolto Value.The total number of digits to the left and right of the decimal point to which Value is resolved.

scale
Byte

Numero totale di posizioni decimali in cui viene risolto Value .The total number of decimal places to which Value is resolved.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update.The name of the source column (SourceColumn) if this SqlParameter is used in a call to Update.

sourceVersion
DataRowVersion

Uno dei valori di DataRowVersion.One of the DataRowVersion values.

sourceColumnNullMapping
Boolean

true se la colonna di origine ammette valori Null; in caso contrario, false.true if the source column is nullable; false if it is not.

value
Object

Oggetto Object che rappresenta il valore di SqlParameter.An Object that is the value of the SqlParameter.

Commenti

Il Size e il Precision vengono dedotti dal valore del parametro dbType se non sono impostati in modo esplicito nei parametri size e precision.The Size and Precision are inferred from the value of the dbType parameter if they are not explicitly set in the size and precision parameters.

Vedi anche

Si applica a