StringReader.Read Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Legge il carattere o il gruppo di caratteri successivo dalla stringa di input.

Overload

Read()	Legge il carattere successivo dalla stringa di input e fa avanzare di un carattere la posizione del carattere.
Read(Span<Char>)	Legge tutti i caratteri dalla stringa di input, a partire dalla posizione corrente e fa avanzare la posizione corrente fino alla fine della stringa di input.
Read(Char[], Int32, Int32)	Legge un blocco di caratteri dalla stringa di input e fa avanzare la posizione del carattere di count.

Read()

Origine:

StringReader.cs

Legge il carattere successivo dalla stringa di input e fa avanzare di un carattere la posizione del carattere.

public:
 override int Read();

public override int Read ();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

Restituisce

Int32

Carattere successivo della stringa sottostante oppure -1 se non sono disponibili altri caratteri.

Eccezioni

ObjectDisposedException

Il lettore corrente è chiuso.

Esempio

Questo esempio di codice fa parte di un esempio più grande fornito per 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()

Commenti

Questo metodo esegue l'override del TextReader.Read metodo.

Nella tabella seguente sono elencati esempi di altre attività di I/O tipiche o correlate.

Per eseguire questa operazione...	Vedere l'esempio riportato in questo argomento...
Creare un file di testo.	Procedura: Scrivere un testo in un file
Scrivere in un file di testo.	Procedura: Scrivere un testo in un file
Leggere da un file di testo.	Procedura: Leggere testo da un file
Aggiungere testo a un file.	Procedura: Aprire e accodare un file di log File.AppendText FileInfo.AppendText
Ottenere le dimensioni di un file.	FileInfo.Length
Ottenere gli attributi di un file.	File.GetAttributes
Impostare gli attributi di un file.	File.SetAttributes
Determinare se esiste un file.	File.Exists
Leggere da un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato
Scrivere in un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato

Vedi anche

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

Read(Span<Char>)

Origine:

StringReader.cs

Legge tutti i caratteri dalla stringa di input, a partire dalla posizione corrente e fa avanzare la posizione corrente fino alla fine della stringa di input.

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

Parametri

buffer

Span<Char>

Al termine, questo metodo contiene i caratteri letti dall'origine corrente. Se il numero totale di caratteri letti è zero, l'intervallo rimane invariato.

Restituisce

Int32

Numero complessivo di caratteri letti nel buffer.

Eccezioni

ObjectDisposedException

L'istanza corrente del lettore di stringhe è chiusa.

Read(Char[], Int32, Int32)

Origine:

StringReader.cs

Legge un blocco di caratteri dalla stringa di input e fa avanzare la posizione del carattere di 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

Parametri

buffer

Char[]

Quando questo metodo viene restituito, contiene la matrice di caratteri specificata con i valori compresi tra index e (index + + count - 1) sostituiti con i caratteri letti dall'origine corrente.

index

Int32

Indice iniziale nel buffer.

count

Int32

Numero di caratteri da leggere.

Restituisce

Int32

Numero complessivo di caratteri letti nel buffer. È possibile che sia inferiore al numero di caratteri richiesti se la quantità di caratteri non è correntemente disponibile oppure può corrispondere a zero se è stata raggiunta la fine della stringa sottostante.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentException

La lunghezza del buffer meno index è minore di count.

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

Il lettore corrente è chiuso.

Commenti

Questo metodo esegue l'override di TextReader.Read.

Il metodo leggerà fino a count caratteri dall'oggetto StringReaderbuffer nella matrice di caratteri a partire dalla posizione index. Restituisce il numero effettivo di caratteri letti o zero se la fine della stringa è stata raggiunta e non vengono letti caratteri.

Nella tabella seguente sono elencati esempi di altre attività di I/O tipiche o correlate.

Per eseguire questa operazione...	Vedere l'esempio riportato in questo argomento...
Creare un file di testo.	Procedura: Scrivere un testo in un file
Scrivere in un file di testo.	Procedura: Scrivere un testo in un file
Leggere da un file di testo.	Procedura: Leggere testo da un file
Aggiungere testo a un file.	Procedura: Aprire e accodare un file di log File.AppendText FileInfo.AppendText
Ottenere le dimensioni di un file.	FileInfo.Length
Ottenere gli attributi di un file.	File.GetAttributes
Impostare gli attributi di un file.	File.SetAttributes
Determinare se esiste un file.	File.Exists
Leggere da un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato
Scrivere in un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato

Vedi anche

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