BinaryReader.ReadChars(Int32) Méthode

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: BinaryReader.cs

Source:: BinaryReader.cs

Source:: BinaryReader.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lit le nombre spécifié de caractères dans le flux actuel, retourne les données dans un tableau de caractères et avance la position actuelle conformément à la valeur Encoding utilisée et au caractère spécifique en cours de lecture dans le flux.

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()

Paramètres

count: Int32

Nombre de caractères à lire.

Retours

Char[]

Tableau de caractères contenant des données lues dans le flux sous-jacent. Cette valeur peut être inférieure au nombre de caractères demandés si la fin du flux est atteinte.

Exceptions

ArgumentException

Le nombre de caractères décodés à lire est supérieur à count. Cela peut arriver si un décodeur Unicode retourne des caractères de secours ou une paire de substitution.

ObjectDisposedException

Le flux est fermé.

IOException

Une erreur d'E/S s'est produite.

ArgumentOutOfRangeException

count est un nombre négatif.

Exemples

L’exemple de code suivant montre comment lire et écrire des données à l’aide de la mémoire comme magasin de stockage.

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

Remarques

BinaryReader ne restaure pas la position du fichier après une opération de lecture infructueuse.

Lors de la lecture à partir de flux réseau, dans de rares cas, la ReadChars méthode peut lire un caractère supplémentaire à partir du flux si le BinaryReader a été construit avec un encodage Unicode. Si cela se produit, vous pouvez utiliser la ReadBytes méthode pour lire un tableau d’octets de longueur fixe, puis passer ce tableau à la ReadChars méthode .

S’applique à

Partager via