StreamReader.Peek Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert het volgende beschikbare teken, maar verbruikt het niet.
public:
override int Peek();
public override int Peek();
override this.Peek : unit -> int
Public Overrides Function Peek () As Integer
Retouren
Een geheel getal dat het volgende teken aangeeft dat moet worden gelezen of -1 als er geen tekens moeten worden gelezen of als de stream geen ondersteuning biedt voor zoeken.
Uitzonderingen
Er treedt een I/O-fout op.
Voorbeelden
In het volgende codevoorbeeld worden regels van een bestand gelezen totdat het einde van het bestand is bereikt.
using System;
using System.IO;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
try
{
if (File.Exists(path))
{
File.Delete(path);
}
using (StreamWriter sw = new StreamWriter(path))
{
sw.WriteLine("This");
sw.WriteLine("is some text");
sw.WriteLine("to test");
sw.WriteLine("Reading");
}
using (StreamReader sr = new StreamReader(path))
{
while (sr.Peek() > -1)
{
Console.WriteLine(sr.ReadLine());
}
}
}
catch (Exception e)
{
Console.WriteLine("The process failed: {0}", e.ToString());
}
}
}
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
Try
If File.Exists(path) Then
File.Delete(path)
End If
Dim sw As StreamWriter = New StreamWriter(path)
sw.WriteLine("This")
sw.WriteLine("is some text")
sw.WriteLine("to test")
sw.WriteLine("Reading")
sw.Close()
Dim sr As StreamReader = New StreamReader(path)
Do While sr.Peek() > -1
Console.WriteLine(sr.ReadLine())
Loop
sr.Close()
Catch e As Exception
Console.WriteLine("The process failed: {0}", e.ToString())
End Try
End Sub
End Class
Opmerkingen
De Peek methode retourneert een geheel getal om te bepalen of het einde van het bestand of een andere fout is opgetreden. Hierdoor kan een gebruiker eerst controleren of de geretourneerde waarde -1 is voordat deze naar een Char type wordt gecast.
Deze methode overschrijft TextReader.Peek.
De huidige positie van het StreamReader object wordt niet gewijzigd door Peek.