OdbcParameter Osztály

Definíció

Névtér:

System.Data.Odbc

Szerelvény:

System.Data.Odbc.dll

Csomag:

System.Data.Odbc v11.0.0-preview.5.26302.115

Forrás:

OdbcParameter.cs

Egy paramétert jelöl egy OdbcCommand adott paraméterhez, és opcionálisan annak leképezését egy DataColumn. Ez az osztály nem örökölhető.

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

public sealed class OdbcParameter : System.Data.Common.DbParameter, ICloneable

type OdbcParameter = class
    inherit DbParameter
    interface IDataParameter
    interface IDbDataParameter
    interface ICloneable

Public NotInheritable Class OdbcParameter
Inherits DbParameter
Implements ICloneable

Öröklődés

Object

DbParameter

OdbcParameter

Megvalósítás

IDataParameter IDbDataParameter ICloneable

Példák

Az alábbi példa több példányt OdbcParameter hoz létre a OdbcParameterCollection rendszeren belül OdbcDataAdapter. Ezek a paraméterek az adatforrásból származó adatok kiválasztására és az adatok elhelyezésére szolgálnak az DataSetadatforrásban. Ez a példa feltételezi, hogy egy DataSet és egy OdbcDataAdapter már létrejött a megfelelő sémával, parancsokkal és kapcsolattal.

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

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OdbcType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OdbcType.Int).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 OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OdbcType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OdbcType.Int).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

Megjegyzések

A paraméternevek nem megkülönböztetik a kis- és nagybetűket.

Ha oracle-adatbázist kérdez le az Microsoft OLE DB Provider for Oracle (MSDAORA) és az ODBC .NET Framework Data Provider használatával, a LIKE záradék használatával rögzített hosszúságú mezők értékeinek lekérdezése nem feltétlenül adja vissza az összes várt egyezést. Ennek az az oka, hogy amikor az Oracle egy záradék rögzített hosszúságú mezőinek értékeit egyezik meg, akkor az a sztring LIKE teljes hosszával egyezik, beleértve a záró szóközöket is. Ha például egy Oracle-adatbázisban egy tábla egy "Field1" nevű mezőt tartalmaz, amely a következőképpen van definiálva char(3), és az "a" értéket adja meg a tábla egyik sorába, az alábbi kód nem adja vissza a sort.

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

Ennek az az oka, hogy az Oracle az oszlop értékét "a" értékként tárolja (a záró szóközökkel együtt a rögzített mezőhossz 3), amelyet az Oracle nem tekint egyezésként az "a" paraméterértékhez rögzített hosszúságú mezők összehasonlítása esetén LIKE .

A probléma megoldásához fűzjön hozzá egy százalék ("%") helyettesítő karaktert a paraméter értékéhez ("a%"), vagy használjon inkább SQL-összehasonlítást = .

Konstruktorok

Name	Description
OdbcParameter()	Inicializálja a OdbcParameter osztály új példányát.
OdbcParameter(String, Object)	Inicializálja az OdbcParameter osztály új példányát, amely a paraméter nevét és egy objektumot OdbcParameter használja.
OdbcParameter(String, OdbcType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicializálja az OdbcParameter osztály új példányát, amely a paraméternevet, az adattípust, a hosszt, a forrásoszlop nevét, a paraméter irányát, a numerikus pontosságot és egyéb tulajdonságokat használja.
OdbcParameter(String, OdbcType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	Inicializálja az OdbcParameter osztály új példányát, amely a paraméternevet, az adattípust, a hosszt, a forrásoszlop nevét, a paraméter irányát, a numerikus pontosságot és egyéb tulajdonságokat használja.
OdbcParameter(String, OdbcType, Int32, String)	Inicializálja az osztály új példányát, amely a OdbcParameter paraméter nevét, adattípusát, hosszát és forrásoszlopnevét használja.
OdbcParameter(String, OdbcType, Int32)	Inicializálja az OdbcParameter osztály új példányát, amely a paraméter nevét, adattípusát és hosszát használja.
OdbcParameter(String, OdbcType)	Inicializálja az OdbcParameter osztály új példányát, amely a paraméter nevét és adattípusát használja.

Tulajdonságok

Name	Description
DbType	Lekéri vagy beállítja a DbType paramétert.
Direction	Lekéri vagy beállít egy értéket, amely jelzi, hogy a paraméter csak bemeneti, kimeneti, kétirányú vagy tárolt eljárás visszatérési érték paramétere-e.
IsNullable	Lekéri vagy beállít egy értéket, amely jelzi, hogy a paraméter elfogadja-e a null értékeket.
OdbcType	Lekéri vagy beállítja a OdbcType paramétert.
ParameterName	Lekéri vagy beállítja a OdbcParameternevét.
Precision	Lekéri vagy beállítja a tulajdonság megjelenítéséhez Value használt számjegyek számát.
Scale	Lekéri vagy beállítja a feloldott tizedesjegyek Value számát.
Size	Lekéri vagy beállítja az oszlopban lévő adatok maximális méretét.
SourceColumn	Lekéri vagy beállítja annak a forrásoszlopnak a nevét, amely megfeleltethető a DataSet forrásoszlopnak, és a betöltéshez vagy a Valuevisszatéréshez használatos.
SourceColumnNullMapping	Lekéri vagy beállít egy értéket, amely jelzi, hogy a forrásoszlop null értékű-e. DbCommandBuilder Így helyesen hozhat létre frissítési utasításokat a null értékű oszlopokhoz.
SourceVersion	Betöltéskor DataRowVersionlekéri vagy beállítja a Value használni kívánt elemet.
Value	Lekéri vagy beállítja a paraméter értékét.

Metódusok

Name	Description
ResetDbType()	Alaphelyzetbe állítja az ehhez a típushoz társított típust OdbcParameter.
ResetOdbcType()	Alaphelyzetbe állítja az ehhez a típushoz társított típust OdbcParameter.
ToString()	Lekéri a sztringet, amely tartalmazza a ParameterName.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .

Lásd még

• Parancsok használata