XmlTextWriter.WriteChars(Char[], Int32, Int32) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skriver text en buffert i taget.
public:
override void WriteChars(cli::array <char> ^ buffer, int index, int count);public override void WriteChars(char[] buffer, int index, int count);override this.WriteChars : char[] * int * int -> unitPublic Overrides Sub WriteChars (buffer As Char(), index As Integer, count As Integer)Parametrar
- buffer
- Char[]
Teckenmatris som innehåller texten som ska skrivas.
- index
- Int32
Positionen i bufferten som anger början av texten som ska skrivas.
- count
- Int32
Antalet tecken som ska skrivas.
Undantag
buffer är null.
index eller count är mindre än noll.
-eller-
Buffertlängden minus index är mindre än count. anropet resulterar i att surrogatpartecken delas upp eller att ett ogiltigt surrogatpar skrivs.
är WriteState Stängd.
Exempel
using (XmlTextWriter writer = new XmlTextWriter(Console.Out))
{
writer.WriteStartDocument();
char[] ch = new char[4];
ch[0] = 't';
ch[1] = 'e';
ch[2] = 'x';
ch[3] = 't';
writer.WriteStartElement("WriteCharacters");
writer.WriteChars(ch, 0, ch.Length);
writer.WriteEndElement();
writer.WriteEndDocument();
}
Kommentarer
Note
Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.
Den här metoden kan användas för att skriva stora mängder text en buffert i taget.
Särskild hantering måste göras för att säkerställa WriteChars att metoden inte delar upp surrogatpartecken över flera buffertskrivningar. XML-specifikationen definierar giltiga intervall för surrogatpar.
Ett undantag utlöses om surrogatpartecken skrivs som skulle resultera i att surrogatparens tecken delas upp i bufferten.
