DataTableReader.Item[] Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling.
Overloads
| Name | Description |
|---|---|
| Item[Int32] |
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomordinaal. |
| Item[String] |
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomnaam. |
Item[Int32]
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomordinaal.
public:
virtual property System::Object ^ default[int] { System::Object ^ get(int ordinal); };
public override object this[int ordinal] { get; }
member this.Item(int) : obj
Default Public Overrides ReadOnly Property Item(ordinal As Integer) As Object
Parameters
- ordinal
- Int32
De op nul gebaseerde kolomordinaal.
Waarde van eigenschap
De waarde van de opgegeven kolom in de systeemeigen indeling.
Uitzonderingen
De doorgegeven index lag buiten het bereik van 0 tot FieldCount - 1.
Voorbeelden
In het volgende voorbeeld wordt de inhoud van alle kolommen weergegeven, in alle rijen van de opgegeven DataTableReader. De code maakt gebruik van de methode Item[] (de indexeerfunctie in Microsoft C#) om de waarde op te halen die in elke kolom is opgenomen.
private static void DisplayItems(DataTableReader reader)
{
int rowNumber = 0;
while (reader.Read())
{
Console.WriteLine("Row " + rowNumber);
for (int i = 0; i < reader.FieldCount; i++)
{
Console.WriteLine("{0}: {1}", reader.GetName(i), reader[i]);
}
rowNumber++;
}
}
Private Sub DisplayItems(ByVal reader As DataTableReader)
Dim rowNumber As Integer
While reader.Read()
Console.WriteLine("Row " & rowNumber)
For i As Integer = 0 To reader.FieldCount - 1
Console.WriteLine("{0}: {1}", reader.GetName(i), reader.Item(i))
Next
rowNumber += 1
End While
End Sub
Opmerkingen
Deze overbelasting voor Item[] gedraagt zich identiek aan de GetValue methode.
Zie ook
Van toepassing op
Item[String]
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomnaam.
public:
virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ name); };
public override object this[string name] { get; }
member this.Item(string) : obj
Default Public Overrides ReadOnly Property Item(name As String) As Object
Parameters
- name
- String
De naam van de kolom.
Waarde van eigenschap
De waarde van de opgegeven kolom in de systeemeigen indeling.
Uitzonderingen
De opgegeven naam is geen geldige kolomnaam.
Er is een poging gedaan om gegevens op te halen uit een verwijderde rij.
Er is geprobeerd een kolom in een gesloten DataTableReaderkolom te lezen of te openen.
Voorbeelden
Bij een DataTableReader en een kolomnaam retourneert de procedure GetValueByName de waarde van de opgegeven kolom. Voordat u deze procedure aanroept, moet u een nieuw DataTableReader exemplaar maken en de leesmethode ten minste één keer aanroepen om de rijaanwijzer op een rij met gegevens te plaatsen.
private static object GetValueByName(
DataTableReader reader, string columnName)
{
// Consider when to use a procedure like this one carefully:
// if you're going to retrieve information from a column
// in a loop, it would be better to retrieve the column
// ordinal once, store the value, and use the methods
// of the DataTableReader class directly.
// Use this string-based indexer sparingly.
object columnValue = null;
try
{
columnValue = reader[columnName];
}
catch (ArgumentException ex)
{
// Throw all other errors back out to the caller.
columnValue = null;
}
return columnValue;
}
Private Function GetValueByName( _
ByVal reader As DataTableReader, _
ByVal columnName As String) As Object
' Consider when to use a procedure like this one carefully:
' If you're going to retrieve information from a column
' in a loop, it would be better to retrieve the column
' ordinal once, store the value, and use the methods
' of the DataTableReader class directly.
' Use Item(columnName) sparingly.
Dim columnValue As Object
Try
columnValue = reader.Item(columnName)
Catch ex As ArgumentException
' Throw all other errors back out to the caller.
columnValue = Nothing
End Try
Return columnValue
End Function
Opmerkingen
Eerst wordt een hoofdlettergevoelige zoekopdracht uitgevoerd. Als dit mislukt, wordt een tweede niet hoofdlettergevoelige zoekopdracht uitgevoerd.
Deze methode is niet gevoelig voor kana-breedte.
Deze overbelaste versie komt overeen met het aanroepen van Item[] de GetOrdinal methode en roept vervolgens de GetValue methode aan.