OleDbDataReader.GetOrdinal(String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar kolumnordningen med namnet på kolumnen.
public:
virtual int GetOrdinal(System::String ^ name);
public:
override int GetOrdinal(System::String ^ name);
public int GetOrdinal(string name);
public override int GetOrdinal(string name);
abstract member GetOrdinal : string -> int
override this.GetOrdinal : string -> int
override this.GetOrdinal : string -> int
Public Function GetOrdinal (name As String) As Integer
Public Overrides Function GetOrdinal (name As String) As Integer
Parametrar
- name
- String
Kolumnens namn.
Returer
Den nollbaserade kolumnordningen.
Implementeringar
Undantag
Det angivna namnet är inte ett giltigt kolumnnamn.
Exempel
I följande exempel visas hur du använder GetOrdinal metoden.
public static void ReadData(string connectionString)
{
string queryString = "SELECT DISTINCT CustomerID FROM Orders";
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
int customerID = reader.GetOrdinal("CustomerID");
while (reader.Read())
{
Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
}
reader.Close();
}
}
Public Sub ReadData(ByVal connectionString As String)
Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"
Using connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader()
Dim customerID As Integer = reader.GetOrdinal("CustomerID")
While reader.Read()
Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
End While
reader.Close()
End Using
End Sub
Kommentarer
GetOrdinal utför en skiftlägeskänslig sökning först. Om det misslyckas görs en andra skiftlägeskänslig sökning. Metoden utlöser ett IndexOutOfRange undantag om den nollbaserade kolumnordningen inte hittas.
GetOrdinal är kana-bredd okänslig.
Eftersom ordningsbaserade sökningar är effektivare än namngivna sökningar är det ineffektivt att anropa GetOrdinal i en loop. Spara tid genom att anropa GetOrdinal en gång och tilldela resultatet till en heltalsvariabel för användning i loopen.