SqlDataReader.GetChars-Methode
Liest beginnend am angegebenen Pufferoffset einen Stream von Zeichen aus dem angegebenen Spaltenoffset in den Puffer eines Arrays.
Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Overrides Function GetChars ( _
i As Integer, _
dataIndex As Long, _
buffer As Char(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'Usage
Dim instance As SqlDataReader
Dim i As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(i, dataIndex, buffer, bufferIndex, length)
public override long GetChars (
int i,
long dataIndex,
char[] buffer,
int bufferIndex,
int length
)
public:
virtual long long GetChars (
int i,
long long dataIndex,
array<wchar_t>^ buffer,
int bufferIndex,
int length
) override
public long GetChars (
int i,
long dataIndex,
char[] buffer,
int bufferIndex,
int length
)
public override function GetChars (
i : int,
dataIndex : long,
buffer : char[],
bufferIndex : int,
length : int
) : long
Parameter
- i
Die nullbasierte Ordnungszahl der Spalte.
- dataIndex
Der Index im Feld, an dem der Lesevorgang beginnen soll.
- buffer
Der Puffer, in den der Bytestream gelesen werden soll.
- bufferIndex
Der Index für buffer, an dem der Schreibvorgang beginnen soll.
- length
Die maximal in den Puffer zu kopierende Länge.
Rückgabewert
Die tatsächlich gelesene Anzahl von Zeichen.
Hinweise
GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. Häufig ist dies die genaue Länge des Felds. Die zurückgegebene Anzahl kann jedoch kleiner als die tatsächliche Länge des Felds sein, wenn GetChars bereits zum Abrufen von Zeichen aus dem Feld verwendet wurde. Dies kann z. B. der Fall sein, wenn der SqlDataReader eine umfangreiche Datenstruktur in einen Puffer liest. Weitere Informationen finden Sie unter der SequentialAccess-Einstellung für CommandBehavior.
Die tatsächliche Anzahl gelesener Zeichen kann geringer sein als die angeforderte Länge, wenn das Ende des Felds erreicht ist. Wenn Sie einen Puffer übergeben, der NULL (Nothing in Visual Basic) ist, gibt GetChars die Länge des gesamten Felds in Zeichen zurück, und nicht die entsprechend dem Pufferoffsetparameter verbleibende Größe.
Es werden keine Konvertierungen durchgeführt, daher müssen die abgerufenen Daten bereits als Zeichenarray vorliegen.
Hinweis
GetChars kann nicht zum segmentweisen Lesen einer VarChar-Spalte verwendet werden, wenn CommandBehavior auf SequentialAccess festgelegt ist.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
SqlDataReader-Klasse
SqlDataReader-Member
System.Data.SqlClient-Namespace
Weitere Ressourcen
Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server