BinaryReader.ReadChars(Int32) Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

BinaryReader.cs

Legge il numero specificato di caratteri dal flusso corrente, restituisce i dati in una matrice di caratteri e sposta in avanti la posizione corrente secondo il valore Encoding usato e il carattere specifico letto dal flusso.

public:
 virtual cli::array <char> ^ ReadChars(int count);

public virtual char[] ReadChars (int count);

abstract member ReadChars : int -> char[]
override this.ReadChars : int -> char[]

Public Overridable Function ReadChars (count As Integer) As Char()

Parametri

count

Int32

Numero di caratteri da leggere.

Restituisce

Char[]

Matrice di caratteri contenente dati letti dal flusso sottostante. Può essere minore del numero di caratteri necessari se viene raggiunta la fine del flusso.

Eccezioni

ArgumentException

Il numero dei caratteri decodificati da leggere è maggiore di count. Questa situazione può verificarsi se un decodificatore Unicode restituisce caratteri di fallback o una coppia di surrogati.

ObjectDisposedException

Il flusso è chiuso.

IOException

Si è verificato un errore di I/O.

ArgumentOutOfRangeException

count è negativo.

Esempio

Nell'esempio di codice seguente viene illustrato come leggere e scrivere dati usando la memoria come archivio di backup.

using namespace System;
using namespace System::IO;
int main()
{
   array<Char>^invalidPathChars = Path::InvalidPathChars;
   MemoryStream^ memStream = gcnew MemoryStream;
   BinaryWriter^ binWriter = gcnew BinaryWriter( memStream );
   
   // Write to memory.
   binWriter->Write( "Invalid file path characters are: " );
   binWriter->Write( Path::InvalidPathChars );
   
   // Create the reader using the same MemoryStream 
   // as used with the writer.
   BinaryReader^ binReader = gcnew BinaryReader( memStream );
   
   // Set Position to the beginning of the stream.
   binReader->BaseStream->Position = 0;
   
   // Read the data from memory and write it to the console.
   Console::Write( binReader->ReadString() );
   Console::WriteLine( binReader->ReadChars( (int)(memStream->Length - memStream->Position) ) );
}

using System;
using System.IO;

class BinaryRW
{
    static void Main()
    {
        char[] invalidPathChars = Path.InvalidPathChars;
        MemoryStream memStream = new MemoryStream();
        BinaryWriter binWriter = new BinaryWriter(memStream);

        // Write to memory.
        binWriter.Write("Invalid file path characters are: ");
        binWriter.Write(Path.InvalidPathChars);

        // Create the reader using the same MemoryStream
        // as used with the writer.
        BinaryReader binReader = new BinaryReader(memStream);

        // Set Position to the beginning of the stream.
        memStream.Position = 0;

        // Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString());
        Console.WriteLine(binReader.ReadChars(
            (int)(memStream.Length - memStream.Position)));
    }
}

open System.IO

let invalidPathChars = Path.GetInvalidPathChars()
let memStream = new MemoryStream()
let binWriter = new BinaryWriter(memStream)

// Write to memory.
binWriter.Write "Invalid file path characters are: "
binWriter.Write invalidPathChars

// Create the reader using the same MemoryStream
// as used with the writer.
let binReader = new BinaryReader(memStream)

// Set Position to the beginning of the stream.
memStream.Position <- 0

// Read the data from memory and write it to the console.
printf $"{binReader.ReadString()}"
printfn $"{binReader.ReadChars(int (memStream.Length - memStream.Position))}"

Imports System.IO

Public Class BinaryRW

    Shared Sub Main()
    
        Dim invalidPathChars() As Char = Path.InvalidPathChars
        Dim memStream As new MemoryStream()
        Dim binWriter As New BinaryWriter(memStream)

        ' Write to memory.
        binWriter.Write("Invalid file path characters are: ")
        binWriter.Write(Path.InvalidPathChars)

        ' Create the reader using the same MemoryStream 
        ' as used with the writer.
        Dim binReader As New BinaryReader(memStream)

        ' Set Position to the beginning of the stream.
        memStream.Position = 0

        ' Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString())
        Console.WriteLine(binReader.ReadChars( _
            CInt(memStream.Length - memStream.Position)))
    
    End Sub
End Class

Commenti

BinaryReader non ripristina la posizione del file dopo un'operazione di lettura non riuscita.

Quando si legge da flussi di rete, in alcuni casi rari, il ReadChars metodo potrebbe leggere un carattere aggiuntivo dal flusso se è BinaryReader stato costruito con codifica Unicode. In questo caso, è possibile usare il ReadBytes metodo per leggere una matrice di byte a lunghezza fissa e quindi passare tale matrice al ReadChars metodo.

Vedi anche

• Encoding
• File e Stream I/O
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file