Sdílet prostřednictvím


SqlParameter Konstruktory

Definice

Inicializuje novou instanci SqlParameter třídy.

Přetížení

SqlParameter()

Inicializuje novou instanci SqlParameter třídy.

SqlParameter(String, SqlDbType)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru a datový typ.

SqlParameter(String, Object)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nové SqlParameter.

SqlParameter(String, SqlDbType, Int32)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, a velikost.

SqlParameter(String, SqlDbType, Int32, String)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, velikost a název zdrojového sloupce.

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

Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, velikost parametru, ParameterDirectiona , přesnost parametru, měřítko parametru, zdrojový sloupec, DataRowVersion použít a hodnotu parametru.

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

Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, délku parametru směr, přesnost, měřítko, název zdrojového sloupce, jednu z DataRowVersion hodnot, logickou hodnotu pro mapování zdrojového SqlParametersloupce, hodnotu , název databáze, ve které se nachází kolekce schémat pro tuto instanci XML. vlastnící relační schéma, ve kterém je umístěna kolekce schémat pro tuto instanci XML, a název kolekce schémat pro tento parametr.

SqlParameter()

Inicializuje novou instanci SqlParameter třídy.

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

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Viz také

Platí pro

SqlParameter(String, SqlDbType)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru a datový typ.

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)

Parametry

parameterName
String

Název parametru, který se má mapovat.

dbType
SqlDbType

Jedna z SqlDbType hodnot.

Výjimky

Hodnota zadaná v parametru dbType je neplatný back-endový datový typ.

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

Datový typ a případně Velikost a Precision se odvozují z hodnoty parametru dbType .

Viz také

Platí pro

SqlParameter(String, Object)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nové 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)

Parametry

parameterName
String

Název parametru, který se má mapovat.

value
Object

Jedná Object se o hodnotu SqlParameter.

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

Když zadáte parametr Object v parametru valueSqlDbType , je odvozen z typu ObjectRozhraní Microsoft .NET Framework .

Při použití tohoto přetížení konstruktoru SqlParameter k zadání hodnot celočíselných parametrů buďte opatrní. Vzhledem k tomu, že toto přetížení přebírá value typ Object, musíte převést celočíselnou hodnotu na Object typ, pokud je hodnota nula, jak ukazuje následující příklad jazyka C#.

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

Pokud tento převod neprovedete, kompilátor předpokládá, že se pokoušíte volat SqlParameter(String, SqlDbType) konstruktor přetížení.

Viz také

Platí pro

SqlParameter(String, SqlDbType, Int32)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, a velikost.

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)

Parametry

parameterName
String

Název parametru, který se má mapovat.

dbType
SqlDbType

Jedna z SqlDbType hodnot.

size
Int32

Délka parametru.

Výjimky

Hodnota zadaná v parametru dbType je neplatný back-endový datový typ.

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

Velikost je odvozena z hodnoty parametrudbType, pokud není explicitně nastavena v parametrusize.

Viz také

Platí pro

SqlParameter(String, SqlDbType, Int32, String)

Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, velikost a název zdrojového sloupce.

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)

Parametry

parameterName
String

Název parametru, který se má mapovat.

dbType
SqlDbType

Jedna z SqlDbType hodnot.

size
Int32

Délka parametru.

sourceColumn
String

Název zdrojového sloupce (SourceColumn), pokud SqlParameter se používá při volání Update.

Výjimky

Hodnota zadaná v parametru dbType je neplatný back-endový datový typ.

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

Velikost je odvozena z hodnoty parametrudbType, pokud není explicitně nastavena v parametrusize.

Viz také

Platí pro

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

Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, velikost parametru, ParameterDirectiona , přesnost parametru, měřítko parametru, zdrojový sloupec, DataRowVersion použít a hodnotu 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 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)

Parametry

parameterName
String

Název parametru, který se má mapovat.

dbType
SqlDbType

Jedna z SqlDbType hodnot.

size
Int32

Délka parametru.

direction
ParameterDirection

Jedna z ParameterDirection hodnot.

isNullable
Boolean

truepokud hodnota pole může být null; v opačném případě . false

precision
Byte

Celkový počet číslic vlevo a vpravo od desetinné čárky, na kterou Value je překládán.

scale
Byte

Celkový počet desetinných míst, na který Value se přeloží.

sourceColumn
String

Název zdrojového sloupce (SourceColumn), pokud SqlParameter se používá při volání Update.

sourceVersion
DataRowVersion

Jedna z DataRowVersion hodnot.

value
Object

Jedná Object se o hodnotu SqlParameter.

Výjimky

Hodnota zadaná v parametru dbType je neplatný back-endový datový typ.

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

Hodnoty Size a Precision jsou odvozeny z hodnoty parametrudbType, pokud nejsou explicitně nastaveny v parametrech size aprecision.

Viz také

Platí pro

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

Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, délku parametru směr, přesnost, měřítko, název zdrojového sloupce, jednu z DataRowVersion hodnot, logickou hodnotu pro mapování zdrojového SqlParametersloupce, hodnotu , název databáze, ve které se nachází kolekce schémat pro tuto instanci XML. vlastnící relační schéma, ve kterém je umístěna kolekce schémat pro tuto instanci XML, a název kolekce schémat pro tento parametr.

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)

Parametry

parameterName
String

Název parametru, který se má mapovat.

dbType
SqlDbType

Jedna z SqlDbType hodnot.

size
Int32

Délka parametru.

direction
ParameterDirection

Jedna z ParameterDirection hodnot.

precision
Byte

Celkový počet číslic vlevo a vpravo od desetinné čárky, na kterou Value je překládán.

scale
Byte

Celkový počet desetinných míst, na který Value se přeloží.

sourceColumn
String

Název zdrojového sloupce (SourceColumn), pokud SqlParameter se používá při volání Update.

sourceVersion
DataRowVersion

Jedna z DataRowVersion hodnot.

sourceColumnNullMapping
Boolean

true pokud zdrojový sloupec má možnou hodnotu null; false pokud není.

value
Object

Jedná Object se o hodnotu SqlParameter.

xmlSchemaCollectionDatabase
String

Název databáze, ve které se nachází kolekce schémat pro tuto instanci XML.

xmlSchemaCollectionOwningSchema
String

Vlastnící relační schéma, kde se nachází kolekce schémat pro tuto instanci XML.

xmlSchemaCollectionName
String

Název kolekce schémat pro tento parametr.

Poznámky

Hodnoty Size a Precision jsou odvozeny z hodnoty parametru dbType , pokud nejsou explicitně nastaveny v parametrech size a precision .

Viz také

Platí pro