SqlParameter Costruttori

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.dll

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

Nome	Descrizione
SqlParameter()	Inizializza una nuova istanza della classe SqlParameter.
SqlParameter(String, SqlDbType)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro e il tipo di dati.
SqlParameter(String, Object)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro e un valore del nuovo SqlParameteroggetto .
SqlParameter(String, SqlDbType, Int32)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro, l'oggetto SqlDbTypee le dimensioni.
SqlParameter(String, SqlDbType, Int32, String)	Inizializza una nuova istanza della SqlParameter classe che usa il nome del parametro, le SqlDbTypedimensioni e il nome della colonna di origine.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro, il tipo del parametro, le dimensioni del parametro, un ParameterDirection, la precisione del parametro, la scala del parametro, la colonna di origine, un DataRowVersion oggetto 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 SqlParameter classe che utilizza il nome del parametro, il tipo del parametro, la lunghezza del parametro, la direzione, la precisione, la scala, il nome della colonna di origine, uno dei DataRowVersion valori, un valore Boolean per il mapping delle colonne di origine, il valore di `SqlParameter`, il nome del database in cui si trova l'insieme di schemi per questa istanza XML, 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 SqlParameter oggetto 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 SqlParameter classe che utilizza 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 da mappare.

dbType: SqlDbType

Uno dei SqlDbType valori.

Eccezioni

ArgumentException

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

Esempio

Nell'esempio seguente viene creato un SqlParameter oggetto 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 SqlParameter classe che utilizza il nome del parametro e un valore del nuovo SqlParameteroggetto .

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 da mappare.

value: Object

Oggetto Object che rappresenta il valore dell'oggetto SqlParameter.

Esempio

Nell'esempio seguente viene creato un SqlParameter oggetto 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 nel parametro value, il SqlDbType viene dedotto dal tipo di Microsoft .NET del Object.

Prestare attenzione quando si usa questo overload del SqlParameter costruttore per specificare i valori dei parametri integer. Poiché questo overload accetta un value tipo Object, è necessario convertire il valore integrale in un Object tipo quando il valore è zero, come illustrato nell'esempio C# seguente.

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 SqlParameter classe che utilizza il nome del parametro, l'oggetto SqlDbTypee le dimensioni.

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 da mappare.

dbType: SqlDbType

Uno dei SqlDbType valori.

size: Int32

Lunghezza del parametro.

Eccezioni

ArgumentException

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

Esempio

Nell'esempio seguente viene creato un SqlParameter oggetto 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

Size viene dedotto dal valore del dbType parametro se non è impostato in modo esplicito nel size parametro .

Vedi anche

Si applica a

SqlParameter(String, SqlDbType, Int32, String)

Inizializza una nuova istanza della SqlParameter classe che usa il nome del parametro, le SqlDbTypedimensioni 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 da mappare.

dbType: SqlDbType

Uno dei SqlDbType valori.

size: Int32

Lunghezza del parametro.

sourceColumn: String

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

Eccezioni

ArgumentException

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

Esempio

Nell'esempio seguente viene creato un SqlParameter oggetto 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

Size viene dedotto dal valore del dbType parametro se non è impostato 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 SqlParameter classe che utilizza il nome del parametro, il tipo del parametro, le dimensioni del parametro, un ParameterDirection, la precisione del parametro, la scala del parametro, la colonna di origine, un DataRowVersion oggetto 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 da mappare.

dbType: SqlDbType

Uno dei SqlDbType valori.

size: Int32

Lunghezza del parametro.

direction: ParameterDirection

Uno dei ParameterDirection valori.

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 a cui Value viene risolto.

scale: Byte

Numero totale di posizioni decimali in cui Value viene risolto.

sourceColumn: String

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

sourceVersion: DataRowVersion

Uno dei DataRowVersion valori.

value: Object

Oggetto Object che rappresenta il valore dell'oggetto SqlParameter.

Eccezioni

ArgumentException

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

Esempio

Nell'esempio seguente viene creato un SqlParameter oggetto 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

Size e Precision vengono dedotti dal valore del dbType parametro se non vengono impostati 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 SqlParameter classe che utilizza il nome del parametro, il tipo del parametro, la lunghezza del parametro, la direzione, la precisione, la scala, il nome della colonna di origine, uno dei DataRowVersion valori, un valore Boolean per il mapping delle colonne di origine, il valore di SqlParameter, il nome del database in cui si trova l'insieme di schemi per questa istanza XML, 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 da mappare.

dbType: SqlDbType

Uno dei SqlDbType valori.

size: Int32

Lunghezza del parametro.

direction: ParameterDirection

Uno dei ParameterDirection valori.

precision: Byte

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

scale: Byte

Numero totale di posizioni decimali in cui Value viene risolto.

sourceColumn: String

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

sourceVersion: DataRowVersion

Uno dei DataRowVersion valori.

sourceColumnNullMapping: Boolean

true se la colonna di origine è nullable; false se non lo è.

value: Object

Oggetto Object che rappresenta il valore dell'oggetto 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 vengono impostati in modo esplicito nei size parametri e precision .

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?