SqlParameter Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacchetto:: System.Data.SqlClient v4.8.6

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

ArgumentException

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

ArgumentException

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

ArgumentException

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

ArgumentException

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

Vedi anche

Si applica a

SqlParameter Costruttori

Definizione

Overload

SqlParameter()

Esempio

Vedi anche

Si applica a

SqlParameter(String, SqlDbType)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

SqlParameter(String, Object)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

SqlParameter(String, SqlDbType, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

SqlParameter(String, SqlDbType, Int32, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive