Udostępnij za pośrednictwem


SqlParameter Konstruktory

Definicja

Przeciążenia

SqlParameter()

Inicjuje nowe wystąpienie klasy SqlParameter.

SqlParameter(String, SqlDbType)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i typu danych.

SqlParameter(String, Object)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i wartości nowego SqlParameter.

SqlParameter(String, SqlDbType, Int32)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbTypei rozmiaru.

SqlParameter(String, SqlDbType, Int32, String)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbType, rozmiaru i nazwy kolumny źródłowej.

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

Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, rozmiaru parametru, ParameterDirectionprecyzji parametru, skali parametru, kolumny źródłowej, DataRowVersion wartości do użycia i wartości parametru.

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

Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, długości parametru kierunku, dokładności, skali, nazwy kolumny źródłowej, jednej z DataRowVersion wartości, wartości logicznej mapowania kolumny źródłowej, wartości , nazwy SqlParameterbazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML, jest właścicielem schematu relacyjnego, w którym znajduje się kolekcja schematów dla tego wystąpienia XML, oraz nazwa kolekcji schematów dla tego parametru.

SqlParameter()

Inicjuje nowe wystąpienie klasy SqlParameter.

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

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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);
    }
}

Dotyczy

SqlParameter(String, SqlDbType)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i typu danych.

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)

Parametry

parameterName
String

Nazwa parametru do mapowania.

dbType
SqlDbType

SqlDbType Jedna z wartości.

Wyjątki

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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);
    }
}

Uwagi

Typ danych i, jeśli to konieczne, Size i Precision są wnioskowane z wartości parametru dbType .

Dotyczy

SqlParameter(String, Object)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i wartości nowego 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.SqlParameter
Public Sub New (parameterName As String, value As Object)

Parametry

parameterName
String

Nazwa parametru do mapowania.

value
Object

Wartość Object , która jest wartością .SqlParameter

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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);
    }
}

Uwagi

Po określeniu Object elementu w parametrze valueSqlDbType element jest wywnioskowany z typu Microsoft .NET Framework typu Object.

Należy zachować ostrożność podczas używania tego przeciążenia konstruktora SqlParameter do określania wartości parametrów całkowitych. Ponieważ to przeciążenie przyjmuje value typ Object, należy przekonwertować wartość całkowitą na Object typ, gdy wartość jest równa zero, jak pokazano w poniższym przykładzie języka C#.

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

Jeśli nie wykonasz tej konwersji, kompilator zakłada, że próbujesz wywołać przeciążenie konstruktora SqlParameter(String, SqlDbType) .

Dotyczy

SqlParameter(String, SqlDbType, Int32)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbTypei rozmiaru.

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Parametry

parameterName
String

Nazwa parametru do mapowania.

dbType
SqlDbType

SqlDbType Jedna z wartości.

size
Int32

Długość parametru.

Wyjątki

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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);
    }
}

Uwagi

Parametr Size jest wywnioskowany z wartości parametru dbType , jeśli nie jest jawnie ustawiony w parametrze size .

Dotyczy

SqlParameter(String, SqlDbType, Int32, String)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbType, rozmiaru i nazwy kolumny źródłowej.

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

Parametry

parameterName
String

Nazwa parametru do mapowania.

dbType
SqlDbType

SqlDbType Jedna z wartości.

size
Int32

Długość parametru.

sourceColumn
String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update(DataSet)>.

Wyjątki

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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);
    }
}

Uwagi

Parametr Size jest wywnioskowany z wartości parametru dbType , jeśli nie jest jawnie ustawiony w parametrze size .

Dotyczy

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

Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, rozmiaru parametru, ParameterDirectionprecyzji parametru, skali parametru, kolumny źródłowej, DataRowVersion wartości do użycia i wartości parametru.

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.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)

Parametry

parameterName
String

Nazwa parametru do mapowania.

dbType
SqlDbType

SqlDbType Jedna z wartości.

size
Int32

Długość parametru.

direction
ParameterDirection

ParameterDirection Jedna z wartości.

isNullable
Boolean

true jeśli wartość pola może mieć wartość null; w przeciwnym razie , false.

precision
Byte

Całkowita liczba cyfr po lewej i prawej stronie punktu dziesiętnego, do którego Value jest rozpoznawana.

scale
Byte

Całkowita liczba miejsc dziesiętnych, do których Value jest rozpoznawana.

sourceColumn
String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update(DataSet).

sourceVersion
DataRowVersion

DataRowVersion Jedna z wartości.

value
Object

Wartość Object , która jest wartością .SqlParameter

Wyjątki

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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);
    }
}

Uwagi

Parametr Size i Precision są wnioskowane z wartości parametru dbType , jeśli nie są jawnie ustawione w parametrach size i precision .

Dotyczy

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

Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, długości parametru kierunku, dokładności, skali, nazwy kolumny źródłowej, jednej z DataRowVersion wartości, wartości logicznej mapowania kolumny źródłowej, wartości , nazwy SqlParameterbazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML, jest właścicielem schematu relacyjnego, w którym znajduje się kolekcja schematów dla tego wystąpienia XML, oraz nazwa kolekcji schematów dla tego parametru.

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.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)

Parametry

parameterName
String

Nazwa parametru do mapowania.

dbType
SqlDbType

SqlDbType Jedna z wartości.

size
Int32

Długość parametru.

direction
ParameterDirection

ParameterDirection Jedna z wartości.

precision
Byte

Całkowita liczba cyfr po lewej i prawej stronie punktu dziesiętnego, do którego Value jest rozpoznawana.

scale
Byte

Całkowita liczba miejsc dziesiętnych, do których Value jest rozpoznawana.

sourceColumn
String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update(DataSet)>.

sourceVersion
DataRowVersion

DataRowVersion Jedna z wartości.

sourceColumnNullMapping
Boolean

true jeśli kolumna źródłowa ma wartość null; false jeśli tak nie jest.

value
Object

Wartość Object , która jest wartością .SqlParameter

xmlSchemaCollectionDatabase
String

Nazwa bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML.

xmlSchemaCollectionOwningSchema
String

Schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML.

xmlSchemaCollectionName
String

Nazwa kolekcji schematów dla tego parametru.

Uwagi

Parametry Size i Precision są wnioskowane z wartości parametru dbType , jeśli nie są jawnie ustawione w parametrach size i precision .

Dotyczy