SqlParameter Oluşturucular

Tanım

Ad Alanı:: System.Data.SqlClient

Bütünleştirilmiş Kod:: System.Data.SqlClient.dll

Bütünleştirilmiş Kod:: System.Data.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Aşırı Yüklemeler

Name	Description
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 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ını, SqlParameterve boyutunu kullanan sınıfın yeni bir örneğini SqlDbType başlatır.
SqlParameter(String, SqlDbType, Int32, String)	parametre adını, SqlParameter, boyutunu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini SqlDbType başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Parametre adını, parametrenin türünü, parametresinin boyutunu, bir SqlParameter, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütununu, kullanılacak a'yı ve parametrenin değerini kullanan sınıfın yeni bir ParameterDirection örneğini DataRowVersion 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 biriniSqlParameter, kaynak sütun eşlemesi için Boole değerini, değeriniDataRowVersion, bu XML örneği için şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfın yeni bir örneğini `SqlParameter` başlatır. bu XML örneğinin şema koleksiyonunun bulunduğu sahip olan ilişkisel şema ve bu parametre için şema koleksiyonunun adı.

SqlParameter()

Kaynak:: System.Data.SqlClient.notsupported.cs

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.

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

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType)

Kaynak:: System.Data.SqlClient.notsupported.cs

Parametre adını ve veri türünü kullanan sınıfı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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.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ü.

Örnekler

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

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

Açıklamalar

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

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, Object)

Kaynak:: System.Data.SqlClient.notsupported.cs

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

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

Açıklamalar

Object parametresinde bir value belirttiğinizde, SqlDbType Object Microsoft .NET türünden çı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 valueolduğundanObject, aşağıdaki C# örneğinde gösterildiği gibi, tamsayıyı sıfır olduğunda 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 çağırmaya SqlParameter(String, SqlDbType) çalıştığınızı varsayar.

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType, Int32)

Kaynak:: System.Data.SqlClient.notsupported.cs

parametre adını, SqlParameterve boyutunu kullanan sınıfın yeni bir örneğini SqlDbType 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 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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametresinin uzunluğu.

Özel durumlar

ArgumentException

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

Örnekler

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

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

Açıklamalar

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

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType, Int32, String)

Kaynak:: System.Data.SqlClient.notsupported.cs

parametre adını, SqlParameter, boyutunu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini SqlDbType 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 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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametresinin uzunluğu.

sourceColumn: String

BuSourceColumn, çağrısında SqlParameterkullanılıyorsa kaynak sütunun (Update) adı.

Özel durumlar

ArgumentException

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

Örnekler

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

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

Açıklamalar

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

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:: System.Data.SqlClient.notsupported.cs

Parametre adını, parametrenin türünü, parametresinin boyutunu, bir SqlParameter, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütununu, kullanılacak a'yı ve parametrenin değerini kullanan sınıfın yeni bir ParameterDirection örneğini DataRowVersion 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 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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametresinin 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 ayırıcı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

BuSourceColumn, çağrısında SqlParameterkullanılıyorsa kaynak sütunun (Update) adı.

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

Örnekler

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

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

Açıklamalar

Ve parametrelerinde açıkça ayarlanmadıysa, Boyut ve PrecisiondbType parametresinin değerinden sizeprecision çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:: System.Data.SqlClient.notsupported.cs

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 biriniSqlParameter, kaynak sütun eşlemesi için Boole değerini, değeriniDataRowVersion, bu XML örneği için şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfın yeni bir örneğini SqlParameter başlatır. bu XML örneğinin ş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 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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametresinin uzunluğu.

direction: ParameterDirection

Değerlerden ParameterDirection biri.

precision: Byte

Çözülen ondalık ayırıcı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

BuSourceColumn, çağrısında SqlParameterkullanılıyorsa kaynak sütunun (Update) adı.

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ğinin şema koleksiyonunun bulunduğu sahip olan ilişkisel şema.

xmlSchemaCollectionName: String

Bu parametre için şema koleksiyonunun adı.

Açıklamalar

Size ve Precision parametresinde açıkça ayarlanmadıysa parametresinin dbType değerinden sizeprecision çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?