StringReader.Read Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Lit le caractère ou le jeu de caractères suivant dans la chaîne d’entrée.

Surcharges

Read()	Lit le caractère suivant dans la chaîne d’entrée et avance sa position d’un caractère.
Read(Span<Char>)	Lit tous les caractères de la chaîne d’entrée en commençant à la position actuelle, et avance la position actuelle à la fin de la chaîne d’entrée.
Read(Char[], Int32, Int32)	Lit un bloc de caractères dans la chaîne d’entrée et avance la position du caractère de count.

Read()

Source:

StringReader.cs

Lit le caractère suivant dans la chaîne d’entrée et avance sa position d’un caractère.

public:
 override int Read();

public override int Read ();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

Retours

Int32

Caractère suivant de la chaîne sous-jacente, ou -1 si plus aucun caractère n’est disponible.

Exceptions

ObjectDisposedException

Le lecteur actuel est fermé.

Exemples

Cet exemple de code fait partie d’un exemple plus grand fourni pour la StringReader classe .

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Remarques

Cette méthode remplace la TextReader.Read méthode.

Le tableau suivant répertorie des exemples d’autres tâches d’E/S classiques ou associées.

Action à réaliser...	Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte.	Procédure : écrire du texte dans un fichier
Écrire dans un fichier texte.	Procédure : écrire du texte dans un fichier
Lecture à partir d’un fichier texte.	Procédure : lire le texte d’un fichier
Ajoutez du texte à un fichier.	Procédure : ouvrir un fichier journal et y ajouter des éléments File.AppendText FileInfo.AppendText
Obtenez la taille d’un fichier.	FileInfo.Length
Obtenir les attributs d’un fichier.	File.GetAttributes
Définissez les attributs d’un fichier.	File.SetAttributes
Déterminez si un fichier existe.	File.Exists
Lire à partir d’un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment
Écrire dans un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment

Voir aussi

• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier

Read(Span<Char>)

Source:

StringReader.cs

Lit tous les caractères de la chaîne d’entrée en commençant à la position actuelle, et avance la position actuelle à la fin de la chaîne d’entrée.

public:
 override int Read(Span<char> buffer);

public override int Read (Span<char> buffer);

override this.Read : Span<char> -> int

Public Overrides Function Read (buffer As Span(Of Char)) As Integer

Paramètres

buffer

Span<Char>

Quand cette méthode retourne un résultat, contient les caractères lus à partir de la source actuelle. Si le nombre total de caractères lus est égal à zéro, l’étendue reste inchangée.

Retours

Int32

Nombre total de caractères lus dans la mémoire tampon.

Exceptions

ObjectDisposedException

L’instance du lecteur de chaînes actuel est fermée.

Read(Char[], Int32, Int32)

Source:

StringReader.cs

Lit un bloc de caractères dans la chaîne d’entrée et avance la position du caractère de count.

public:
 override int Read(cli::array <char> ^ buffer, int index, int count);

public override int Read (char[] buffer, int index, int count);

override this.Read : char[] * int * int -> int

Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Paramètres

buffer

Char[]

Quand cette méthode est retournée, contient le tableau de caractères spécifié dont les valeurs comprises entre index et (index + count - 1) sont remplacées par les caractères lus dans la source actuelle.

index

Int32

Index de début dans la mémoire tampon.

count

Int32

Nombre de caractères à lire.

Retours

Int32

Nombre total de caractères lus dans la mémoire tampon. Cela peut être inférieur au nombre de caractères demandé si ce nombre n’est pas actuellement disponible, ou égal à zéro si la fin de la chaîne sous-jacente a été atteinte.

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentException

La longueur de la mémoire tampon moins index est inférieure à count.

ArgumentOutOfRangeException

index ou count est un nombre négatif.

ObjectDisposedException

Le lecteur actuel est fermé.

Remarques

Cette méthode se substitue à TextReader.Read.

La méthode lit les count caractères du dans le StringReaderbuffer tableau de caractères en commençant à la position index. Renvoie le nombre réel de caractères lus, ou zéro si la fin de la chaîne a été atteinte et qu’aucun caractère n’est lu.

Le tableau suivant répertorie des exemples d’autres tâches d’E/S classiques ou associées.

Action à réaliser...	Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte.	Procédure : écrire du texte dans un fichier
Écrire dans un fichier texte.	Procédure : écrire du texte dans un fichier
Lecture à partir d’un fichier texte.	Procédure : lire le texte d’un fichier
Ajoutez du texte à un fichier.	Procédure : ouvrir un fichier journal et y ajouter des éléments File.AppendText FileInfo.AppendText
Obtenez la taille d’un fichier.	FileInfo.Length
Obtenir les attributs d’un fichier.	File.GetAttributes
Définissez les attributs d’un fichier.	File.SetAttributes
Déterminez si un fichier existe.	File.Exists
Lire à partir d’un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment
Écrire dans un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment

Voir aussi

• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier