OdbcDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Methode
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.
Leest een stroom tekens van de opgegeven kolom offset in de buffer als matrix, te beginnen bij de specifieke buffer offset.
public:
override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public:
virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[]? buffer, int bufferIndex, int length);public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);override this.GetChars : int * int64 * char[] * int * int -> int64abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParameters
- i
- Int32
De op nul gebaseerde kolomordinaal.
- dataIndex
- Int64
De index in de rij waar de leesbewerking moet worden gestart.
- buffer
- Char[]
De buffer waarin gegevens moeten worden gekopieerd.
- bufferIndex
- Int32
De index binnen de buffer plaats waar de schrijfbewerking moet worden gestart.
- length
- Int32
Het aantal tekens dat moet worden gelezen.
Retouren
Het werkelijke aantal tekens dat wordt gelezen.
Implementeringen
Opmerkingen
GetChars retourneert het aantal beschikbare tekens in het veld. Meestal is dit de exacte lengte van het veld. Het geretourneerde getal kan echter kleiner zijn dan de werkelijke lengte van het veld als GetChars het al is gebruikt om tekens uit het veld te verkrijgen. Dit kan bijvoorbeeld het geval zijn als een OdbcDataReader grote gegevensstructuur in een buffer wordt gelezen. Zie voor meer informatie de SequentialAccess instelling voor CommandBehavior.
Als u een buffer doorgeeft die een null-waarde is, GetChars wordt de lengte van het veld in tekens geretourneerd.
Conversies worden uitgevoerd op basis van de onderliggende mogelijkheden van het ODBC-stuurprogramma. Als de conversie niet wordt ondersteund, mislukt de methode-aanroep.
Note
Er wordt geen uitzondering gegenereerd als de waarde bufferIndex buiten de matrix valt. Er worden geen gegevens gelezen en de methode retourneert 0.
