SqlDataReader.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 een matrix die begint bij de opgegeven 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);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 het veld waaruit de leesbewerking moet worden gestart.
- buffer
- Char[]
De buffer waarin de stroom van bytes moet worden gelezen.
- bufferIndex
- Int32
De index binnen de buffer plaats waar de schrijfbewerking moet worden gestart.
- length
- Int32
De maximale lengte die moet worden gekopieerd naar de buffer.
Retouren
Het werkelijke aantal tekens dat wordt gelezen.
Implementeringen
Opmerkingen
GetChars retourneert het aantal beschikbare tekens in het veld. Dit is vaak 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 SqlDataReader grote gegevensstructuur in een buffer wordt gelezen. Zie voor meer informatie de SequentialAccess instelling voor CommandBehavior.
Het werkelijke aantal tekens dat wordt gelezen, kan kleiner zijn dan de aangevraagde lengte als het einde van het veld is bereikt. Als u een buffer doorgeeft, nullGetChars wordt de lengte van het hele veld in tekens geretourneerd, niet de resterende grootte op basis van de bufferverschilparameter.
Er worden geen conversies uitgevoerd; Daarom. de opgehaalde gegevens moeten al een tekenmatrix zijn.
Note
De GetChars methode retourneert 0 wanneer dataIndex dit negatief is.
