DataTableReader.GetChars(Int32, Int64, Char[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された列の値を 1 つの文字配列として返します。
public:
override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);override this.GetChars : int * int64 * char[] * int * int -> int64Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Longパラメーター
- ordinal
- Int32
0 から始まる列序数。
- dataIndex
- Int64
読み取り操作を開始する位置を示すフィールド内のインデックス。
- buffer
- Char[]
char のストリームの読み込み先のバッファー。
- bufferIndex
- Int32
バッファー内でデータの配置を開始するインデックス。
- length
- Int32
バッファーにコピーする最大長。
戻り値
実際に読み取られた文字数。
例外
渡されたインデックスが 0 から FieldCount - 1 の範囲にありません。
削除した行からデータを取得しようとしました。
閉じている DataTableReader の列を読み取るかアクセスしようとしました。
指定した列には文字配列が含まれていません。
例
GetCharsメソッドの例を次に示します。 メソッドには TestGetChars 、最初の列のファイル名と 2 番目の列の文字の配列という 2 つのデータ列が入力された が渡 DataTableReader されることを想定しています。 さらに、 では、 TestGetChars の文字配列からデータを読み取る際に使用するバッファー サイズを DataTableReader指定できます。 TestGetChars では、 の最初の列に DataTableReader指定されたデータをファイル名として使用して、 内のデータの DataTableReader 各行に対応するファイルを作成します。
この手順では、 に格納されたデータを GetChars 文字配列として読み取るメソッドの DataTable 使用方法を示します。 その他の種類のデータでは、 メソッドが GetChars をスローします InvalidCastException。
using System;
using System.Data;
using System.IO;
class Class1
{
static void Main()
{
DataTable table = new DataTable();
table.Columns.Add("FileName", typeof(string));
table.Columns.Add("Data", typeof(char[]));
table.Rows.Add(new object[] { "File1.txt", "0123456789ABCDEF".ToCharArray() });
table.Rows.Add(new object[] { "File2.txt", "0123456789ABCDEF".ToCharArray() });
DataTableReader reader = new DataTableReader(table);
TestGetChars(reader, 7);
}
private static void TestGetChars(DataTableReader reader, int bufferSize)
{
// The filename is in column 0, and the contents are in column 1.
const int FILENAME_COLUMN = 0;
const int DATA_COLUMN = 1;
char[] buffer;
long offset;
int charsRead = 0;
string fileName;
int currentBufferSize = 0;
while (reader.Read())
{
// Reinitialize the buffer size and the buffer itself.
currentBufferSize = bufferSize;
buffer = new char[bufferSize];
// For each row, write the data to the specified file.
// First, verify that the FileName column isn't null.
if (!reader.IsDBNull(FILENAME_COLUMN))
{
// Get the file name, and create a file with
// the supplied name.
fileName = reader.GetString(FILENAME_COLUMN);
// Start at the beginning.
offset = 0;
using (StreamWriter outputStream =
new StreamWriter(fileName, false))
{
try
{
// Loop through all the characters in the input field,
// incrementing the offset for the next time. If this
// pass through the loop reads characters, write them to
// the output stream.
do
{
charsRead = (int)reader.GetChars(DATA_COLUMN, offset,
buffer, 0, bufferSize);
if (charsRead > 0)
{
outputStream.Write(buffer, 0, charsRead);
offset += charsRead;
}
} while (charsRead > 0);
}
catch (Exception ex)
{
Console.WriteLine(fileName + ": " + ex.Message);
}
}
}
}
Console.WriteLine("Press Enter key to finish.");
Console.ReadLine();
}
}
Imports System.Data
Imports System.IO
Module Module1
Private Sub TestGetChars( _
ByVal reader As DataTableReader, ByVal bufferSize As Integer)
' The filename is in column 0, and the contents are in column 1.
Const FILENAME_COLUMN As Integer = 0
Const DATA_COLUMN As Integer = 1
Dim buffer() As Char
Dim offset As Integer
Dim charsRead As Integer
Dim fileName As String
Dim currentBufferSize As Integer
While reader.Read
' Reinitialize the buffer size and the buffer itself.
currentBufferSize = bufferSize
ReDim buffer(bufferSize - 1)
' For each row, write the data to the specified file.
' First, verify that the FileName column isn't null.
If Not reader.IsDBNull(FILENAME_COLUMN) Then
' Get the file name, and create a file with
' the supplied name.
fileName = reader.GetString(FILENAME_COLUMN)
' Start at the beginning.
offset = 0
Using outputStream As New StreamWriter(fileName, False)
Try
' Loop through all the characters in the input field,
' incrementing the offset for the next time. If this
' pass through the loop reads characters, write them to
' the output stream.
Do
charsRead = Cint(reader.GetChars(DATA_COLUMN, offset, _
buffer, 0, bufferSize))
If charsRead > 0 Then
outputStream.Write(buffer, 0, charsRead)
offset += charsRead
End If
Loop While charsRead > 0
Catch ex As Exception
Console.WriteLine(fileName & ": " & ex.Message)
End Try
End Using
End If
End While
Console.WriteLine("Press Enter key to finish.")
Console.ReadLine()
End Sub
Sub Main()
Dim table As New DataTable
table.Columns.Add("FileName", GetType(System.String))
table.Columns.Add("Data", GetType(System.Char()))
table.Rows.Add("File1.txt", "0123456789ABCDEF".ToCharArray)
table.Rows.Add("File2.txt", "0123456789ABCDEF".ToCharArray)
Dim reader As New DataTableReader(table)
TestGetChars(reader, 7)
End Sub
End Module
注釈
GetChars は、フィールドで使用可能な文字数を返します。 ほとんどの場合、これはフィールドの正確な長さです。 ただし、既に GetChars を使用してフィールドから文字を取得している場合、返される文字数はフィールドの正しい長さよりも少なくなる場合があります。
読み取られる実際の文字数は、フィールドの末尾に達した場合に、要求された長さより小さくすることができます。 null ( Visual Basic では )NothingGetChars のバッファーを渡すと、バッファー オフセット パラメーターに基づく残りのサイズではなく、フィールド全体の長さが文字で返されます。
変換は実行されません。したがって、取得するデータは、既に文字配列であるか、文字配列に強制的に変換できる必要があります。
適用対象
.NET