SqlParameter.Value Özellik

Tanım

Parametresinin değerini alır veya ayarlar.Gets or sets the value of the parameter.

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
[<System.Data.DataSysDescription("DataParameter_Value")>]
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set
Public Overrides Property Value As Object
Public Property Value As Object

Özellik Değeri

Object

ObjectBu, parametresinin değeridir.An Object that is the value of the parameter. Varsayılan değer boştur.The default value is null.

Uygulamalar

Öznitelikler

Örnekler

Aşağıdaki örnek bir oluşturur SqlParameter ve bazı özelliklerini ayarlar.The following example creates a SqlParameter and sets some of its properties.

static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}
Private Sub CreateSqlParameterVersion()
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar, 88)
    parameter.Value = "garden hose"
End Sub

Açıklamalar

Giriş parametreleri için, değeri SqlCommand sunucusuna gönderilen öğesine bağlanır.For input parameters, the value is bound to the SqlCommand that is sent to the server. Çıkış ve dönüş değeri parametreleri için değer, SqlCommand kapatıldıktan sonra ve ' nin tamamlanmasıyla ayarlanır SqlDataReader .For output and return value parameters, the value is set on completion of the SqlCommand and after the SqlDataReader is closed.

Bu özellik veya olarak ayarlanabilir null DBNull.Value .This property can be set to null or DBNull.Value. DBNull.ValueParametresinin değeri olarak null değer göndermek için kullanın.Use DBNull.Value to send a NULL value as the value of the parameter. null Value Parametresi için varsayılan değeri kullanmak üzere öğesini kullanın veya ayarlayın.Use null or do not set Value to use the default value for the parameter.

Unicode olmayan XML verileri dize olarak geçirilmezse bir özel durum oluşturulur.An exception is thrown if non-Unicode XML data is passed as a string.

Uygulama veritabanı türünü belirtiyorsa, sağlayıcı verileri sunucuya gönderdiğinde, bağlanan değer bu türe dönüştürülür.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. Sağlayıcı, arabirimi destekliyorsa herhangi bir değer türünü dönüştürmeye çalışır IConvertible .The provider tries to convert any type of value if it supports the IConvertible interface. Belirtilen tür değerle uyumlu değilse, dönüştürme hataları ortaya çıkabilir.Conversion errors may result if the specified type is not compatible with the value.

Hem DbType hem de SqlDbType Özellikleri, değeri ayarlanarak çıkarsanamıyor.Both the DbType and SqlDbType properties can be inferred by setting the Value.

ValueÖzelliğinin üzerine yazılır SqlDataAdapter.UpdateCommand .The Value property is overwritten by SqlDataAdapter.UpdateCommand.

Akış hakkında daha fazla bilgi için bkz. SqlClient akış desteği.For information about streaming, see SqlClient Streaming Support.

Şunlara uygulanır