SqlParameter Konstruktory

Reference

Definice

Obor názvů:: Microsoft.Data.SqlClient

Sestavení:: Microsoft.Data.SqlClient.dll

Balíček:: Microsoft.Data.SqlClient v1.0.19269.1

Balíček:: Microsoft.Data.SqlClient v1.1.4

Balíček:: Microsoft.Data.SqlClient v2.0.1

Balíček:: Microsoft.Data.SqlClient v2.1.4

Balíček:: Microsoft.Data.SqlClient v3.0.1

Balíček:: Microsoft.Data.SqlClient v3.1.0

Balíček:: Microsoft.Data.SqlClient v4.0.1

Balíček:: Microsoft.Data.SqlClient v4.1.0

Balíček:: Microsoft.Data.SqlClient v5.0.0

Balíček:: Microsoft.Data.SqlClient v5.1.0

Balíček:: Microsoft.Data.SqlClient v5.2.0

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 `SqlParameter`sloupce, hodnotu , název databáze, ve které se nachází kolekce schémat pro tuto instanci XML, vlastnící relační schéma, kde 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.

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

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.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

ArgumentException

Hodnota zadaná v parametru dbType je neplatným datovým typem back-endu.

Příklady

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

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

Poznámky

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

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 Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.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.

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

Poznámky

Když v parametru Objectvalue zadáte , SqlDbType je odvozena z rozhraní Microsoft .NET Framework typu Object.

Při použití tohoto přetížení konstruktoru SqlParameter k určení hodnot celočíselných parametrů buďte opatrní. Vzhledem k tomu, že toto přetížení přijímá valueObjecttyp , musíte při nulové hodnotě převést celočíselnou hodnotu na Object typ, 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 přetížení konstruktoru SqlParameter(String, SqlDbType) .

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

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

dbType: SqlDbType

Jedna z SqlDbType hodnot.

size: Int32

Délka parametru

Výjimky

ArgumentException

Hodnota zadaná v parametru dbType je neplatným datovým typem back-endu.

Příklady

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

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

Poznámky

Velikost se odvodí z hodnoty parametru dbType , pokud není explicitně nastavená v parametru size .

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

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 se SqlParameter používá při volání .Update(DataSet)>

Výjimky

ArgumentException

Hodnota zadaná v parametru dbType je neplatným datovým typem back-endu.

Příklady

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

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

Poznámky

Velikost se odvodí z hodnoty parametru dbType , pokud není explicitně nastavená v parametru size .

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

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 se přeloží.

scale: Byte

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

sourceColumn: String

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

sourceVersion: DataRowVersion

Jedna z DataRowVersion hodnot.

value: Object

Jedná Object se o hodnotu SqlParameter.

Výjimky

ArgumentException

Hodnota zadaná v parametru dbType je neplatným datovým typem back-endu.

Příklady

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

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

Poznámky

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

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, kde 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 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

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 se přeloží.

scale: Byte

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

sourceColumn: String

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

sourceVersion: DataRowVersion

Jedna z DataRowVersion hodnot.

sourceColumnNullMapping: Boolean

true Pokud zdrojový sloupec je nullable; false pokud není.

value: Object

Jedná Object se o hodnotu SqlParameter.

xmlSchemaCollectionDatabase: String

Název databáze, ve které je umístěna kolekce schémat pro tuto instanci XML.

xmlSchemaCollectionOwningSchema: String

Vlastnící relační schéma, kde je umístěna 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 .

Platí pro

Sdílet prostřednictvím

SqlParameter Konstruktory

Definice

Přetížení

SqlParameter()

Příklady

Platí pro

SqlParameter(String, SqlDbType)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

SqlParameter(String, Object)

Parametry

Příklady

Poznámky

Platí pro

SqlParameter(String, SqlDbType, Int32)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

SqlParameter(String, SqlDbType, Int32, String)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Platí pro

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

Parametry

Poznámky

Platí pro

Další materiály