StringReader Klas
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.
Implementeert een TextReader tekenreeks die wordt gelezen uit een tekenreeks.
public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader
type StringReader = class
inherit TextReader
[<System.Serializable>]
type StringReader = class
inherit TextReader
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
inherit TextReader
Public Class StringReader
Inherits TextReader
- Overname
- Overname
- Kenmerken
Voorbeelden
In het volgende voorbeeld ziet u hoe u een hele tekenreeks asynchroon kunt lezen.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
ReadCharacters();
}
static async void ReadCharacters()
{
StringBuilder stringToRead = new StringBuilder();
stringToRead.AppendLine("Characters in 1st line to read");
stringToRead.AppendLine("and 2nd line");
stringToRead.AppendLine("and the end");
using (StringReader reader = new StringReader(stringToRead.ToString()))
{
string readText = await reader.ReadToEndAsync();
Console.WriteLine(readText);
}
}
}
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
ReadCharacters()
End Sub
Async Sub ReadCharacters()
Dim stringToRead = New StringBuilder()
stringToRead.AppendLine("Characters in 1st line to read")
stringToRead.AppendLine("and 2nd line")
stringToRead.AppendLine("and the end")
Using reader As StringReader = New StringReader(stringToRead.ToString())
Dim readText As String = Await reader.ReadToEndAsync()
Console.WriteLine(readText)
End Using
End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'
Opmerkingen
StringReader hiermee kunt u een tekenreeks synchroon of asynchroon lezen. U kunt een teken tegelijk lezen met de Read of de ReadAsync methode, een regel tegelijk met behulp van de ReadLine methode of de ReadLineAsync methode en een hele tekenreeks met behulp van de ReadToEnd of de ReadToEndAsync methode.
Note
Met dit type wordt de IDisposable interface geïmplementeerd, maar er zijn geen resources om te verwijderen. Dit betekent dat het verwijderen ervan door het rechtstreeks aanroepen van Dispose() of met behulp van een taalconstructie zoals using (in C#) of Using (in Visual Basic) niet nodig is.
De volgende tabel bevat voorbeelden van andere typische of gerelateerde I/O-taken.
| Om dit te doen… | Zie het voorbeeld in dit onderwerp... |
|---|---|
| Maak een tekstbestand. | Procedure: Tekst naar een bestand schrijven |
| Schrijf naar een tekstbestand. | Procedure: Tekst naar een bestand schrijven |
| Lezen uit een tekstbestand. | Procedure: Tekst uit een bestand lezen |
| Voeg tekst toe aan een bestand. |
Procedure: Openen en toevoegen aan een logboekbestand File.AppendText FileInfo.AppendText |
| De grootte van een bestand ophalen. | FileInfo.Length |
| Haal de kenmerken van een bestand op. | File.GetAttributes |
| Stel de kenmerken van een bestand in. | File.SetAttributes |
| Bepaal of er een bestand bestaat. | File.Exists |
| Lezen uit een binair bestand. | Procedure: lezen en schrijven naar een nieuw gegevensbestand |
| Schrijven naar een binair bestand. | Procedure: lezen en schrijven naar een nieuw gegevensbestand |
Constructors
| Name | Description |
|---|---|
| StringReader(String) |
Initialiseert een nieuw exemplaar van de StringReader klasse die wordt gelezen uit de opgegeven tekenreeks. |
Methoden
| Name | Description |
|---|---|
| Close() |
Hiermee sluit u de StringReader. |
| CreateObjRef(Type) |
Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject) |
| Dispose() |
Alle resources die door het TextReader object worden gebruikt, worden vrijgegeven. (Overgenomen van TextReader) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de StringReader beheerde resources en brengt eventueel de beheerde resources vrij. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetLifetimeService() |
Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| InitializeLifetimeService() |
Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MemberwiseClone(Boolean) |
Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject) |
| Peek() |
Retourneert het volgende beschikbare teken, maar verbruikt het niet. |
| Read() |
Hiermee wordt het volgende teken uit de invoertekenreeks gelezen en wordt de positie van het teken met één teken vooruit. |
| Read(Char[], Int32, Int32) |
Hiermee wordt een blok tekens uit de invoertekenreeks gelezen en wordt de positie |
| Read(Span<Char>) |
Hiermee worden alle tekens uit de invoertekenreeks gelezen, beginnend bij de huidige positie en wordt de huidige positie naar het einde van de invoertekenreeks doorgegaan. |
| ReadAsync(Char[], Int32, Int32) |
Leest een opgegeven maximum aantal tekens uit de huidige tekenreeks asynchroon en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index. |
| ReadAsync(Memory<Char>, CancellationToken) |
Asynchroon worden alle tekens uit de invoertekenreeks gelezen, beginnend bij de huidige positie en wordt de huidige positie naar het einde van de invoertekenreeks doorgegaan. |
| ReadBlock(Char[], Int32, Int32) |
Leest een opgegeven maximum aantal tekens van de huidige tekstlezer en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index. (Overgenomen van TextReader) |
| ReadBlock(Span<Char>) |
Leest alle tekens uit de invoertekenreeks vanaf de huidige positie en gaat naar het einde van de invoertekenreeks. |
| ReadBlockAsync(Char[], Int32, Int32) |
Leest een opgegeven maximum aantal tekens uit de huidige tekenreeks asynchroon en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index. |
| ReadBlockAsync(Memory<Char>, CancellationToken) |
Asynchroon worden alle tekens uit de invoertekenreeks vanaf de huidige positie gelezen en wordt de huidige positie naar het einde van de invoertekenreeks doorgegaan. |
| ReadLine() |
Leest een regel tekens uit de huidige tekenreeks en retourneert de gegevens als een tekenreeks. |
| ReadLineAsync() |
Leest asynchroon een regel tekens uit de huidige tekenreeks en retourneert de gegevens als een tekenreeks. |
| ReadToEnd() |
Leest alle tekens van de huidige positie tot het einde van de tekenreeks en retourneert deze als één tekenreeks. |
| ReadToEndAsync() |
Leest alle tekens van de huidige positie naar het einde van de tekenreeks asynchroon en retourneert ze als één tekenreeks. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IDisposable.Dispose() |
Zie voor een beschrijving van dit lid Dispose(). (Overgenomen van TextReader) |