SqlParameter Costruttori
Definizione
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.
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()
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à.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType)Parametri
- parameterName
- String
Nome del parametro di cui eseguire il mapping.
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à.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Commenti
Il tipo di dati e, se appropriato, Size e Precision vengono dedotti dal valore del dbType parametro .
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 Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameterPublic 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à.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
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.
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer)Parametri
- parameterName
- String
Nome del parametro di cui eseguire il mapping.
- 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à.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Commenti
La proprietà Size viene dedotta dal valore del dbType parametro se non è impostata in modo esplicito nel size parametro .
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameterPublic 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.
- size
- Int32
Lunghezza del parametro.
- sourceColumn
- String
Nome della colonna di origine (SourceColumn) se viene SqlParameter usato in una chiamata a Update(DataSet)>.
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à.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Commenti
La proprietà Size viene dedotta dal valore del dbType parametro se non è impostata in modo esplicito nel size parametro .
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.Data.SqlClient.SqlParameterPublic 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.
- 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.
- sourceColumn
- String
Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update(DataSet).
- 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à.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
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 .
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.Data.SqlClient.SqlParameterPublic 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.
- 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.
- sourceColumn
- String
Nome della colonna di origine (SourceColumn) se viene SqlParameter usato in una chiamata a Update(DataSet)>.
- 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 .