Aracılığıyla paylaş


AdomdDataReader.GetChars Yöntemi

Dizisi döndürür Char belirtilen sütun değerleri akışı içeren nesneleri.

Ad Alanı:  Microsoft.AnalysisServices.AdomdClient
Derleme:  Microsoft.AnalysisServices.AdomdClient (Microsoft.AnalysisServices.AdomdClient içinde.dll)

Sözdizimi

'Bildirim
Public Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Kullanım
Dim instance As AdomdDataReader
Dim ordinal 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(ordinal, _
    dataIndex, buffer, bufferIndex, length)
public long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) sealed
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
public final function GetChars(
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Parametreler

  • ordinal
    Tür: System.Int32
    Sıfır tabanlı sıralı konumunu alınacak sütun.
  • dataIndex
    Tür: System.Int64
    Veri Okuma başlayacağı sütun içinde sıfır tabanlı dizin.
  • buffer
    Tür: array<System.Char[]
    Arabellek içine karakter akışı okunamıyor.
  • bufferIndex
    Tür: System.Int32
    Veri yazılırken başlayacağı arabelleğindeki sıfır tabanlı dizin.
  • length
    Tür: System.Int32
    Okumak için karakter sayısını sütun.

Dönüş Değeri

Tür: System.Int64
A uzun gerçekten okunan karakterlerin sayısını içeren sütun.

Uygulamalar

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

Kural dışı durumlar

Özel durum Koşul
System.IndexOutOfRangeException

The value ofdataIndex is greater than Int32.MaxValue.

Değeri bufferIndex ise daha az 0 veya bu değerden toplam length ve uzunluğunu buffer.

Açıklamalar

GetChars yöntem döndürür karakter sayısı olarak kullanılabilir alan.Çoğu durumda alan tam uzunluk budur.Ancak, döndürülen sayı alanının gerçek uzunluğundan daha olabilir GetChars zaten kullanılmıştı elde karakter alan.

Başarılı olursa bir nullnull başvuru (Visual Basic'te Nothing) başvurusu (hiçbir şey Visual Basic) içinde buffer parametresi, GetBytes uzunluğunu döndürür sütun karakterler.

Hiçbir dönüşümleri gerçekleştirilir; Bu nedenle alınan veriler zaten bir karakter dizisi olmalıdır.