OdbcDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Metod

Definition

Namnområde:
System.Data.Odbc
Sammansättning:
System.Data.Odbc.dll
Sammansättning:
System.Data.dll
Paket:
System.Data.Odbc v11.0.0-preview.4.26230.115
Källa:
OdbcDataReader.cs
Källa:
OdbcDataReader.cs
Källa:
OdbcDataReader.cs
Källa:
OdbcDataReader.cs

Läser en dataström med tecken från den angivna kolumnförskjutningen till bufferten som en matris, med början vid den specifika buffertförskjutningen.

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 -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parametrar

i
Int32

Den nollbaserade kolumnordningen.

dataIndex
Int64

Indexet i raden där läsåtgärden ska starta.

buffer
Char[]

Bufferten som data ska kopieras till.

bufferIndex
Int32

Indexet i den buffer plats där skrivåtgärden ska starta.

length
Int32

Antalet tecken som ska läsas.

Returer

Int64

Det faktiska antalet tecken som lästs.

Implementeringar

GetChars(Int32, Int64, Char[], Int32, Int32)

Kommentarer

GetChars returnerar antalet tillgängliga tecken i fältet. För det mesta är det den exakta längden på fältet. Talet som returneras kan dock vara mindre än fältets sanna längd om GetChars det redan har använts för att hämta tecken från fältet. Detta kan till exempel vara fallet om OdbcDataReader läser en stor datastruktur i en buffert. Mer information finns i inställningen SequentialAccess för CommandBehavior.

Om du skickar en buffert som är ett null-värde GetChars returnerar längden på fältet med tecken.

Konverteringar utförs baserat på de underliggande funktionerna i ODBC-drivrutinen. Om konverteringen inte stöds misslyckas metodanropet.

Note

Inget undantag utlöses om värdet bufferIndex för ligger utanför matrisen. Inga data kommer att läsas och metoden returnerar 0.

Gäller för

Se även