XmlWriter.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.
När du åsidosätter i en härledd klass skriver du text en buffert i taget.
public:
abstract void WriteChars(cli::array <char> ^ buffer, int index, int count);public abstract void WriteChars(char[] buffer, int index, int count);abstract member WriteChars : char[] * int * int -> unitPublic MustOverride 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.
Parametervärdet buffer är inte giltigt.
En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
Exempel
using (XmlWriter writer = XmlWriter.Create("WriteChars.xml"))
{
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
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.
Den asynkrona versionen av den här metoden finns i WriteCharsAsync.
