SqlParameter Oluşturucular

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Aşırı Yüklemeler

SqlParameter()	SqlParameter sınıfının yeni bir örneğini başlatır.
SqlParameter(String, SqlDbType)	Parametre adını ve veri türünü kullanan sınıfının yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, Object)	parametre adını ve yeni değerini kullanan sınıfının yeni SqlParameterbir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32)	parametre adı, SqlDbTypeve boyutunu kullanan sınıfının yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, String)	Parametre adı, SqlDbType, boyutu ve kaynak sütun adını kullanan sınıfının yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Parametre adını, parametrenin türünü, parametrenin boyutunu, bir ParameterDirection, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütunu, kullanılacak bir değerini ve parametresinin değerini kullanan sınıfının yeni bir DataRowVersion örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Parametre adını, parametrenin türünü, parametrenin yönünün uzunluğunu, duyarlığı, ölçeği, kaynak sütunun adını, değerlerden biriniDataRowVersion, kaynak sütun eşlemesi için Boole değerini, değerini, SqlParameterbu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfının yeni bir örneğini SqlParameter başlatır. bu XML örneği için şema koleksiyonunun bulunduğu sahip olan ilişkisel şema ve bu parametre için şema koleksiyonunun adı.

SqlParameter()

SqlParameter sınıfının yeni bir örneğini başlatır.

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

SqlParameter(String, SqlDbType)

Parametre adını ve veri türünü kullanan sınıfının yeni bir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName

String

Eşlenecek parametrenin adı.

dbType

SqlDbType

Değerlerden SqlDbType biri.

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türüdür.

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

Açıklamalar

Veri türü ve uygunsa Boyut ve Precision parametresinin değerinden dbType çıkarılır.

SqlParameter(String, Object)

parametre adını ve yeni değerini kullanan sınıfının yeni SqlParameterbir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName

String

Eşlenecek parametrenin adı.

value

Object

Object değerinin değeridirSqlParameter.

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

Açıklamalar

parametresinde bir Object belirttiğinizdevalue, SqlDbType öğesinin Microsoft .NET Framework türünden Objectçıkarılır.

Tamsayı parametre değerlerini belirtmek için oluşturucunun bu aşırı yüklemesini SqlParameter kullanırken dikkatli olun. Bu aşırı yükleme türünde Objectbir value aldığından, aşağıdaki C# örneğinde gösterildiği gibi, değer sıfır olduğunda integral değerini bir Object türe dönüştürmeniz gerekir.

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

Bu dönüştürmeyi gerçekleştirmezseniz, derleyici oluşturucu aşırı yüklemesini SqlParameter(String, SqlDbType) çağırmaya çalıştığınızı varsayar.

SqlParameter(String, SqlDbType, Int32)

parametre adı, SqlDbTypeve boyutunu kullanan sınıfının yeni bir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName

String

Eşlenecek parametrenin adı.

dbType

SqlDbType

Değerlerden SqlDbType biri.

size

Int32

Parametre uzunluğu.

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türüdür.

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

Açıklamalar

Parametresinde açıkça ayarlanmadıysa , Boyut parametresinin dbType değerinden size çıkarılır.

SqlParameter(String, SqlDbType, Int32, String)

Parametre adı, SqlDbType, boyutu ve kaynak sütun adını kullanan sınıfının yeni bir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName

String

Eşlenecek parametrenin adı.

dbType

SqlDbType

Değerlerden SqlDbType biri.

size

Int32

Parametre uzunluğu.

sourceColumn

String

Çağrısında SqlParameter kullanılıyorsa Update(DataSet)>kaynak sütunun adı (SourceColumn).

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türüdür.

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

Açıklamalar

Parametresinde açıkça ayarlanmadıysa , Boyut parametresinin dbType değerinden size çıkarılır.

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

Parametre adını, parametrenin türünü, parametrenin boyutunu, bir ParameterDirection, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütunu, kullanılacak bir değerini ve parametresinin değerini kullanan sınıfının yeni bir DataRowVersion örneğini SqlParameter başlatır.

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)

Parametreler

parameterName

String

Eşlenecek parametrenin adı.

dbType

SqlDbType

Değerlerden SqlDbType biri.

size

Int32

Parametre uzunluğu.

direction

ParameterDirection

Değerlerden ParameterDirection biri.

isNullable

Boolean

true alanın değeri null olabilir; aksi takdirde , false.

precision

Byte

Çözülen ondalık noktasının Value solunda ve sağındaki toplam basamak sayısı.

scale

Byte

Çözümlenen Value ondalık basamakların toplam sayısı.

sourceColumn

String

Çağrısında SqlParameter kullanılıyorsa Update(DataSet)kaynak sütunun adı (SourceColumn).

sourceVersion

DataRowVersion

Değerlerden DataRowVersion biri.

value

Object

Object değerinin değeridirSqlParameter.

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türüdür.

Örnekler

Aşağıdaki örnek bir SqlParameter oluşturur ve özelliklerinden bazılarını ayarlar.

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

Açıklamalar

Ve parametrelerinde açıkça ayarlanmadıysa, Boyut ve Precisionprecision parametresinin dbType değerinden size çıkarılır.

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

Parametre adını, parametrenin türünü, parametrenin yönünün uzunluğunu, duyarlığı, ölçeği, kaynak sütunun adını, değerlerden biriniDataRowVersion, kaynak sütun eşlemesi için Boole değerini, değerini, SqlParameterbu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfının yeni bir örneğini SqlParameter başlatır. bu XML örneği için şema koleksiyonunun bulunduğu sahip olan ilişkisel şema ve bu parametre için şema koleksiyonunun adı.

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)

Parametreler

parameterName

String

Eşlenecek parametrenin adı.

dbType

SqlDbType

Değerlerden SqlDbType biri.

size

Int32

Parametre uzunluğu.

direction

ParameterDirection

Değerlerden ParameterDirection biri.

precision

Byte

Çözülen ondalık noktasının Value solunda ve sağındaki toplam basamak sayısı.

scale

Byte

Çözümlenen Value ondalık basamakların toplam sayısı.

sourceColumn

String

Çağrısında SqlParameter kullanılıyorsa Update(DataSet)>kaynak sütunun adı (SourceColumn).

sourceVersion

DataRowVersion

Değerlerden DataRowVersion biri.

sourceColumnNullMapping

Boolean

true kaynak sütun null atanabilirse; false değilse.

value

Object

Object değerinin değeridirSqlParameter.

xmlSchemaCollectionDatabase

String

Bu XML örneği için şema koleksiyonunun bulunduğu veritabanının adı.

xmlSchemaCollectionOwningSchema

String

Bu XML örneği için şema koleksiyonunun bulunduğu sahip olan ilişkisel şema.

xmlSchemaCollectionName

String

Bu parametre için şema koleksiyonunun adı.

Açıklamalar

Size ve Precision parametrelerinde açıkça ayarlanmadıysa ve precision parametresinin dbType değerinden size çıkarılır.