StringReader.Read Méthode

Définition

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

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

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 connexes.

Action à réaliser... Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte. Procédure : écrire du texte dans un fichier
Écrivez dans un fichier texte. Procédure : écrire du texte dans un fichier
Lire à 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
Obtient les attributs d’un fichier. File.GetAttributes
Définissez les attributs d’un fichier. File.SetAttributes
Déterminez si un fichier existe. File.Exists
Lit à 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

S’applique à

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.

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

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

S’applique à

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.

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

buffer a la valeur null.

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

index ou count est un nombre négatif.

Le lecteur actuel est fermé.

Remarques

Cette méthode se substitue à TextReader.Read.

La méthode lit jusqu’aux count caractères du tableau de StringReader buffer 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 connexes.

Action à réaliser... Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte. Procédure : écrire du texte dans un fichier
Écrivez dans un fichier texte. Procédure : écrire du texte dans un fichier
Lire à 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
Obtient les attributs d’un fichier. File.GetAttributes
Définissez les attributs d’un fichier. File.SetAttributes
Déterminez si un fichier existe. File.Exists
Lit à 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

S’applique à