XmlWriter.WriteBase64(Byte[], Int32, Int32) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

当在派生类中被重写时，将指定的二进制字节编码为 Base64 并写出结果文本。

C#

public abstract void WriteBase64 (byte[] buffer, int index, int count);

参数

buffer

Byte[]

要进行编码的字节数组。

index

Int32

缓冲区中指示要写入字节的起始位置的位置。

count

Int32

要写入的字节数。

例外

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

index 或 count 小于零。

• 或 - 缓冲区长度减去 index 小于 count。

InvalidOperationException

在上一次异步操作完成之前调用了 XmlWriter 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

示例

以下示例使用 WriteBase64 该方法写入 Base64 数据。 数据 Base64 嵌入在 <image> 元素中。

C#

public static void Base64EncodeImageFile() {

  int bufferSize = 1000;
  byte[] buffer = new byte[bufferSize];
  int readBytes = 0;
    
  using (XmlWriter writer = XmlWriter.Create("output.xml")) {

       FileStream inputFile = new FileStream(@"C:\artFiles\sunset.jpg",
                                                                    FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read);
       writer.WriteStartDocument();
       writer.WriteStartElement("image");
       BinaryReader br = new BinaryReader(inputFile);
       Console.WriteLine("\r\nWriting Base64 data...");

       do {
          readBytes = br.Read(buffer, 0, bufferSize);
          writer.WriteBase64(buffer, 0, readBytes);
       } while (bufferSize <= readBytes);
       br.Close();
        
    writer.WriteEndElement();// </image>
    writer.WriteEndDocument();
  }
}

注解

例如，字节缓冲区可能包含 GIF 图像的二进制内容。 这显然不是有效的 XML。 编码 Base64 旨在表示由 65 个 US-ASCII 字符组成的文本形式的任意字节序列 ([A-Za-z0-9+/=]) ，其中每个字符对二进制数据的 6 位进行编码。 有关详细信息，请参阅请求网站上的 RFC (RFC) 1521 的请求。

有关此方法的异步版本，请参阅 WriteBase64Async。

适用于