OleDbParameter Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-rc.1.24431.7

Kaynak:

OleDbParameter.cs

bir parametresini OleDbCommand ve isteğe bağlı olarak bir DataSet sütuna eşlemesini temsil eder. Bu sınıf devralınamaz.

public ref class OleDbParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))]
public sealed class OleDbParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))>]
type OleDbParameter = class
    inherit DbParameter
    interface IDataParameter
    interface IDbDataParameter
    interface ICloneable

Public NotInheritable Class OleDbParameter
Inherits DbParameter
Implements ICloneable

Devralma

Object

MarshalByRefObject

DbParameter

OleDbParameter

Öznitelikler

TypeConverterAttribute

Uygulamalar

IDataParameter IDbDataParameter ICloneable

Örnekler

Aşağıdaki örnek içinde OleDbDataAdapterkoleksiyonu aracılığıyla OleDbParameterCollection birden çok örneği OleDbParameter oluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri öğesine DataSetyerleştirmek için kullanılır. Bu örnekte, uygun şema, komutlar ve bağlantı kullanılarak bir DataSet ve'nin OleDbDataAdapter önceden oluşturulduğu varsayılır.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Açıklamalar

OLE DB.NET Framework Veri Sağlayıcısı, adlandırılmış parametreler yerine soru işareti (?) ile işaretlenmiş konumsal parametreler kullanır.

Oracle için Microsoft OLE DB Sağlayıcısı (MSDAORA) ve OLE DB.NET Framework Veri Sağlayıcısı'nı kullanarak oracle veritabanını sorgularken, sabit uzunluktaki alanlardaki değerleri sorgulamak için yan tümcesini LIKE kullanmak beklenen tüm eşleşmeleri döndürmeyebilir. Bunun nedeni, Oracle bir LIKE yan tümcedeki sabit uzunluklu alanların değerlerini eşlediğinde, sonundaki boşluklar da dahil olmak üzere dizenin tüm uzunluğuyla eşleşmesidir. Örneğin, Oracle veritabanındaki bir tabloda olarak char(3)tanımlanan "Alan1" adlı bir alan varsa ve bu tablonun satırına "a" değerini girerseniz, aşağıdaki kod satırı döndürmez.

Dim queryString As String = "SELECT * FROM Table1 WHERE Field1 LIKE ?"  
Dim command As OleDbCommand = New OleDbCommand(queryString, connection)  
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a"  
Dim reader As OleDbDataReader = command.ExecuteReader()  

string queryString = "SELECT * FROM Table1 WHERE Field1 LIKE ?";  
OleDbCommand command = new OleDbCommand(queryString, connection);  
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a";  
OleDbDataReader reader = command.ExecuteReader();  

Bunun nedeni Oracle'ın sütun değerini "a" olarak depolaması (sonunda boşluklar olan "a"yı sabit alan uzunluğuna 3) depolaması ve sabit uzunluklu alanların karşılaştırması durumunda Oracle'ın "a" parametre değeri için bir LIKE eşleşme olarak davranmamasıdır.

Bu sorunu çözmek için parametre değerine bir yüzde ("%") joker karakteri ekleyin ()"a%" veya bunun yerine bir SQL = karşılaştırması kullanın.

Oluşturucular

OleDbParameter()	OleDbParameter sınıfının yeni bir örneğini başlatır.
OleDbParameter(String, Object)	parametre adını ve yeni değerini kullanan sınıfının yeni OleDbParameterbir örneğini OleDbParameter başlatır.
OleDbParameter(String, OleDbType)	Parametre adını ve veri türünü kullanan sınıfın yeni bir örneğini OleDbParameter başlatır.
OleDbParameter(String, OleDbType, Int32)	Parametre adını, veri türünü ve uzunluğu kullanan sınıfın yeni bir örneğini OleDbParameter başlatır.
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Parametre adı, veri türü, uzunluk, kaynak sütun adı, parametre yönü, sayısal duyarlık ve diğer özellikleri kullanan sınıfın yeni bir örneğini OleDbParameter başlatır.
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	Parametre adı, veri türü, uzunluk, kaynak sütun adı, parametre yönü, sayısal duyarlık ve diğer özellikleri kullanan sınıfın yeni bir örneğini OleDbParameter başlatır.
OleDbParameter(String, OleDbType, Int32, String)	Parametre adını, veri türünü, uzunluğu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini OleDbParameter başlatır.

Özellikler

DbType	parametresini DbType alır veya ayarlar.
Direction	Parametrenin yalnızca giriş, yalnızca çıkış, çift yönlü veya saklı yordam dönüş değeri parametresi olup olmadığını gösteren bir değeri alır veya ayarlar.
IsNullable	Parametresinin null değerleri kabul edip etmediğini belirten bir değer alır veya ayarlar.
OleDbType	parametresini OleDbType alır veya ayarlar.
ParameterName	öğesinin adını OleDbParameteralır veya ayarlar.
Precision	Özelliği temsil Value etmek için kullanılan en fazla basamak sayısını alır veya ayarlar.
Scale	Çözülen ondalık basamak Value sayısını alır veya ayarlar.
Size	Sütundaki verilerin bayt cinsinden en büyük boyutunu alır veya ayarlar.
SourceColumn	ile eşlenen ve yükleme veya döndürme için kullanılan kaynak sütunun DataSetValueadını alır veya ayarlar.
SourceColumnNullMapping	Kaynak sütunun null atanabilir olup olmadığını gösteren bir değer alır veya ayarlar. Bu, boş değer atanabilir sütunlar için Update deyimlerinin doğru şekilde oluşturulmasını sağlar DbCommandBuilder .
SourceVersion	yüklerken Valuekullanılacak öğesini DataRowVersion alır veya ayarlar.
Value	parametresinin değerini alır veya ayarlar.

Yöntemler

CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ResetDbType()	Bu OleDbParameterile ilişkili türü sıfırlar.
ResetOleDbType()	Bu OleDbParameterile ilişkili türü sıfırlar.
ToString()	öğesini içeren ParameterNamebir dize alır.

Belirtik Arabirim Kullanımları

ICloneable.Clone()	Bu üyenin açıklaması için bkz Clone(). .
IDbDataParameter.Precision	Sayısal parametrelerin duyarlığı gösterir. (Devralındığı yer: DbParameter)
IDbDataParameter.Scale	Bu üyenin açıklaması için bkz Scale. . (Devralındığı yer: DbParameter)

Ayrıca bkz.

• Komutlarla Çalışma