StringReader Klass

Definition

Namnområde:

System.IO

Sammansättning:

mscorlib.dll

Implementerar en TextReader som läser från en sträng.

public ref class StringReader : System::IO::TextReader

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Arv

Object

MarshalByRefObject

TextReader

StringReader

Attribut

SerializableAttribute ComVisibleAttribute

Exempel

I följande exempel visas hur du läser en hel sträng asynkront.

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
'

Kommentarer

StringReader gör att du kan läsa en sträng synkront eller asynkront. Du kan läsa ett tecken i taget med metoden ellerReadAsync, en rad i taget med metoden ReadLine eller ReadLineAsync och en hel sträng med hjälp av ReadToEnd metoden eller ReadToEndAsync .Read

Note

Den här typen implementerar IDisposable gränssnittet, men har faktiskt inga resurser att ta bort. Det innebär att det inte är nödvändigt att exponera den genom att direkt anropa Dispose() eller genom att använda en språkkonstruktion som using (i C#) eller Using (i Visual Basic).

I följande tabell visas exempel på andra typiska eller relaterade I/O-uppgifter.

För att göra det här...	Se exemplet i det här avsnittet...
Skapa en textfil.	Anvisningar: Skriva text till en fil
Skriv till en textfil.	Anvisningar: Skriva text till en fil
Läs från en textfil.	Anvisningar: Läsa text från en fil
Lägg till text i en fil.	Anvisningar: Öppna och lägg till i en loggfil File.AppendText FileInfo.AppendText
Hämta storleken på en fil.	FileInfo.Length
Hämta attributen för en fil.	File.GetAttributes
Ange attributen för en fil.	File.SetAttributes
Kontrollera om det finns en fil.	File.Exists
Läs från en binär fil.	Anvisningar: Läsa och skriva till en nyligen skapad datafil
Skriv till en binär fil.	Anvisningar: Läsa och skriva till en nyligen skapad datafil

Konstruktorer

Name	Description
StringReader(String)	Initierar en ny instans av StringReader klassen som läser från den angivna strängen.

Metoder

Name	Description
Close()	StringReaderStänger .
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Dispose()	Frigör alla resurser som används av TextReader objektet. (Ärvd från TextReader)
Dispose(Boolean)	Släpper de ohanterade resurser som används av StringReader och släpper eventuellt de hanterade resurserna.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
InitializeLifetimeService()	Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
Peek()	Returnerar nästa tillgängliga tecken men använder det inte.
Read()	Läser nästa tecken från indatasträngen och flyttar fram teckenpositionen med ett tecken.
Read(Char[], Int32, Int32)	Läser ett teckenblock från indatasträngen och flyttar fram teckenpositionen med count.
ReadAsync(Char[], Int32, Int32)	Läser ett angivet maximalt antal tecken från den aktuella strängen asynkront och skriver data till en buffert med början vid det angivna indexet.
ReadBlock(Char[], Int32, Int32)	Läser ett angivet maximalt antal tecken från den aktuella textläsaren och skriver data till en buffert, med början vid det angivna indexet. (Ärvd från TextReader)
ReadBlockAsync(Char[], Int32, Int32)	Läser ett angivet maximalt antal tecken från den aktuella strängen asynkront och skriver data till en buffert med början vid det angivna indexet.
ReadLine()	Läser en rad med tecken från den aktuella strängen och returnerar data som en sträng.
ReadLineAsync()	Läser en rad tecken asynkront från den aktuella strängen och returnerar data som en sträng.
ReadToEnd()	Läser alla tecken från den aktuella positionen till slutet av strängen och returnerar dem som en enda sträng.
ReadToEndAsync()	Läser alla tecken från den aktuella positionen till slutet av strängen asynkront och returnerar dem som en enda sträng.
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Se även

• TextReader
• StringWriter
• Fil- och ström-I/O
• Anvisningar: Läsa text från en fil
• Anvisningar: Skriva text till en fil