Condividi tramite


SqlParameter Costruttori

Definizione

Inizializza una nuova istanza della classe SqlParameter.

Overload

SqlParameter()

Inizializza una nuova istanza della classe SqlParameter.

SqlParameter(String, SqlDbType)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e il tipo di dati.

SqlParameter(String, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e un valore del nuovo oggetto SqlParameter.

SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType e la dimensione.

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.

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.

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

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.

SqlParameter()

Inizializza una nuova istanza della classe SqlParameter.

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

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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

Si applica a

SqlParameter(String, SqlDbType)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e il tipo di dati.

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.

dbType
SqlDbType

Uno dei valori di SqlDbType.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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, Size e Precision vengono dedotti dal valore del dbType parametro .

Vedi anche

Si applica a

SqlParameter(String, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e un valore del nuovo oggetto 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.

value
Object

Oggetto Object che rappresenta il valore di SqlParameter.

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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 oggetto nel value parametro , viene SqlDbType dedotto dal tipo microsoft .NET Framework di Object.

Prestare attenzione quando si usa questo overload del SqlParameter costruttore per specificare i valori dei parametri integer. 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.

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

Se non si esegue questa conversione, il compilatore presuppone che si stia tentando di chiamare l'overload del SqlParameter(String, SqlDbType) costruttore.

Vedi anche

Si applica a

SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType e la dimensione.

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.

dbType
SqlDbType

Uno dei valori di SqlDbType.

size
Int32

Lunghezza del parametro.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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 proprietà Size viene dedotta dal valore del dbType parametro se non è impostata in modo esplicito nel size parametro .

Vedi anche

Si applica a

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.

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.

dbType
SqlDbType

Uno dei valori di SqlDbType.

size
Int32

Lunghezza del parametro.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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 proprietà Size viene dedotta dal valore del dbType parametro se non è impostata in modo esplicito nel size parametro .

Vedi anche

Si applica a

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.

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.

dbType
SqlDbType

Uno dei valori di SqlDbType.

size
Int32

Lunghezza del parametro.

direction
ParameterDirection

Uno dei valori di ParameterDirection.

isNullable
Boolean

true se il valore del campo può essere Null; in caso contrario, false.

precision
Byte

Numero totale di cifre a sinistra e a destra del separatore decimale in cui viene risolto Value.

scale
Byte

Numero totale di posizioni decimali in cui viene risolto Value.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update.

sourceVersion
DataRowVersion

Uno dei valori di DataRowVersion.

value
Object

Oggetto Object che rappresenta il valore di SqlParameter.

Eccezioni

Il valore specificato nel parametro dbType è un tipo di dati back-end non valido.

Esempio

Nell'esempio seguente viene creato un oggetto SqlParameter e vengono impostate alcune delle relative proprietà.

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 proprietà Size e Precision vengono dedotte dal valore del dbType parametro se non sono impostate in modo esplicito nei size parametri e precision .

Vedi anche

Si applica a

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

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.

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.

dbType
SqlDbType

Uno dei valori di SqlDbType.

size
Int32

Lunghezza del parametro.

direction
ParameterDirection

Uno dei valori di ParameterDirection.

precision
Byte

Numero totale di cifre a sinistra e a destra del separatore decimale in cui viene risolto Value.

scale
Byte

Numero totale di posizioni decimali in cui viene risolto Value.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update.

sourceVersion
DataRowVersion

Uno dei valori di DataRowVersion.

sourceColumnNullMapping
Boolean

true se la colonna di origine ammette valori Null; in caso contrario, false.

value
Object

Oggetto Object che rappresenta il valore di SqlParameter.

xmlSchemaCollectionDatabase
String

Nome del database in cui si trova la raccolta di schemi per questa istanza XML.

xmlSchemaCollectionOwningSchema
String

Schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML.

xmlSchemaCollectionName
String

Nome della raccolta di schemi per questo parametro.

Commenti

e SizePrecision vengono dedotti dal valore del dbType parametro se non sono impostati in modo esplicito nei size parametri e precision .

Vedi anche

Si applica a