TextReader.ReadLine Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Beolvas egy karaktersort a szövegolvasóból, és sztringként adja vissza az adatokat.
public:
virtual System::String ^ ReadLine();public virtual string ReadLine();public virtual string? ReadLine();abstract member ReadLine : unit -> string
override this.ReadLine : unit -> stringPublic Overridable Function ReadLine () As StringVálaszok
Az olvasó következő sora, vagy null ha az összes karakter el lett olvasva.
Kivételek
I/O-hiba történik.
Nincs elegendő memória a visszaadott sztring pufferének lefoglalásához.
A TextReader lezárva.
A következő sorban szereplő karakterek száma nagyobb, mint az Int32.MaxValue
Megjegyzések
A vonal karaktersorozatként van definiálva, amelyet a kocsivisszaadás (0x000d), a vonalcsatorna (0x000a), a kocsi visszatérése és egy sorcsatorna követ, Environment.NewLinevagy az olvasó bemenetének vége. A visszaadott sztring nem tartalmazza a befejező kocsivissza- vagy vonalbetöltést. A visszatérési érték az, null ha a bemenet vége el lett érve.
Ha a bemenet egy újsoros sorozattal végződik, a rendszer nem ad vissza további üres sort. Az azt tartalmazó "line1\nline2\n" bemenet például ugyanazt a két sort ("line1" és "line2") állítja elő, mint a bemenetet tartalmazó "line1\nline2".
Ha a metódus kivételt OutOfMemoryException jelez, az olvasó pozícióját a mögöttes forrásban az olvasható karakterek száma emeli ki, de a belső ReadLine pufferbe már beolvasott karakterek elvesznek. Mivel az olvasó pozíciója az alapul szolgáló forrásban nem állítható vissza, a már beolvasott karakterek helyreállíthatatlanok, és csak az TextReader objektum újraincializálásával érhetők el. Ha a mögöttes forráson belüli kezdeti pozíció ismeretlen, vagy a forrás nem támogatja az áthelyezést, a mögöttes forrást is újra kell inicializálni.
Az ilyen helyzetek elkerülése és a robusztus kód létrehozása érdekében használja a Read metódust, és tárolja az olvasási karaktereket egy előre kihelyezett pufferben.
Az TextReader osztály egy absztrakt osztály. Ezért nem példányosíthatja azt a kódban. A metódus használatára ReadLine példaként tekintse meg a metódust StreamReader.ReadLine .
