When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.
Type Reason ArgumentNullException buffer is null. ArgumentException The buffer length minus index is less than count. ArgumentOutOfRangeException index or count is less than zero. InvalidOperationException The XmlWriter.WriteState is WriteState.Closed.
For example, the byte buffer may contain the binary contents of a GIF image. This clearly would not be valid XML. The Base64 encoding is designed to represent arbitrary byte sequences in a text form comprised of the 65 US-ASCII characters ([A-Za-z0-9+/=]) where each character encodes 6 bits of the binary data. For more information, see Requests for Comments (RFC) 1521 located on the Request for Comments Web site at http://www.rfc-editor.org/.
For the asynchronous version of this method, see XmlWriter.WriteBase64Async(Byte[], int, int).