StringReader.Read Méthode

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll
Assembly:
netstandard.dll

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

Surcharges

Nom Description
Read()

Lit le caractère suivant de la chaîne d’entrée et avance la position du caractère 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 jusqu’à la fin de la chaîne d’entrée.
Read(Char[], Int32, Int32)

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

Read()

Lit le caractère suivant de la chaîne d’entrée et avance la position du caractère 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 aucun caractère supplémentaire 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 = (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.

Pour ce faire... Consultez l’exemple de cette rubrique...
Créez un fichier texte. Guide pratique pour écrire du texte dans un fichier
Écrire dans un fichier texte. Guide pratique pour écrire du texte dans un fichier
Lire à partir d’un fichier texte. Guide pratique pour lire du texte à partir d’un fichier
Ajoutez du texte à un fichier. Guide pratique pour ouvrir et ajouter à un fichier journal

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. Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
Écrivez dans un fichier binaire. Guide pratique pour lire et écrire dans un fichier de données nouvellement créé

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 jusqu’à 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>

Lorsque cette méthode est retournée, 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 de lecteur de chaîne actuelle est fermée.

S’applique à

Read(Char[], Int32, Int32)

Lit un bloc de caractères de la chaîne d’entrée et avance la position du caractère par 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[]

Lorsque cette méthode retourne, contient le tableau de caractères spécifié avec les valeurs comprises entre index et (index + count - 1) remplacées par les caractères lus à partir de la source actuelle.

index
Int32

Index de départ 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 de nombreux caractères ne sont pas actuellement disponibles, ou 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 négatif.

ObjectDisposedException

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 caractères à partir de StringReader la buffer 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.

Pour ce faire... Consultez l’exemple de cette rubrique...
Créez un fichier texte. Guide pratique pour écrire du texte dans un fichier
Écrire dans un fichier texte. Guide pratique pour écrire du texte dans un fichier
Lire à partir d’un fichier texte. Guide pratique pour lire du texte à partir d’un fichier
Ajoutez du texte à un fichier. Guide pratique pour ouvrir et ajouter à un fichier journal

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. Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
Écrivez dans un fichier binaire. Guide pratique pour lire et écrire dans un fichier de données nouvellement créé

Voir aussi

S’applique à