UnmanagedMemoryStream.WriteByte(Byte) Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

UnmanagedMemoryStream.cs

Écrit un octet à la position actuelle dans le flux de fichier.

public:
 override void WriteByte(System::Byte value);

public override void WriteByte (byte value);

override this.WriteByte : byte -> unit

Public Overrides Sub WriteByte (value As Byte)

Paramètres

value

Byte

Valeur d'octet écrite dans le flux.

Exceptions

ObjectDisposedException

Le flux est fermé.

NotSupportedException

La mémoire sous-jacente ne prend pas en charge l’écriture.

- ou -

Une tentative d’écriture dans le flux a été effectuée, et la propriété CanWrite est false.

- ou -

La position actuelle se situe à la fin de la capacité du flux.

IOException

La valeur fournie (value) provoque un dépassement de la capacité maximale du flux.

Exemples

L’exemple de code suivant montre comment lire et écrire dans la mémoire non managée à l’aide de la UnmanagedMemoryStream classe . Un bloc de mémoire non managée est alloué et désalloué à l’aide de la Marshal classe . Dans cet exemple, un UnmanagedMemoryStream objet est passé à une méthode qui vérifie la CanWrite propriété avant d’essayer d’écrire les données dans le flux.

// Note: You must compile this sample using the unsafe flag.
// From the command line, type the following: csc sample.cs /unsafe
using System;
using System.IO;
using System.Runtime.InteropServices;
using System.Text;

unsafe class Program
{
    static void Main()
    {
        // Create some data to write.
        byte[] text = UnicodeEncoding.Unicode.GetBytes("Data to write.");

        // Allocate a block of unmanaged memory.
        IntPtr memIntPtr = Marshal.AllocHGlobal(text.Length);

        // Get a byte pointer from the unmanaged memory block.
        byte* memBytePtr = (byte*)memIntPtr.ToPointer();

        UnmanagedMemoryStream writeStream =
            new UnmanagedMemoryStream(
            memBytePtr, text.Length, text.Length, FileAccess.Write);

        // Write the data.
        WriteToStream(writeStream, text);

        // Close the stream.
        writeStream.Close();

        // Create another UnmanagedMemoryStream for reading.
        UnmanagedMemoryStream readStream =
            new UnmanagedMemoryStream(memBytePtr, text.Length);

        // Display the contents of the stream to the console.
        PrintStream(readStream);

        // Close the reading stream.
        readStream.Close();

        // Free up the unmanaged memory.
        Marshal.FreeHGlobal(memIntPtr);
    }

    public static void WriteToStream(UnmanagedMemoryStream writeStream, byte[] text)
    {
        // Verify that the stream is writable:
        // By default, UnmanagedMemoryStream objects do not have write access,
        // write access must be set explicitly.
        if (writeStream.CanWrite)
        {
            // Write the data, byte by byte
            for (int i = 0; i < writeStream.Length; i++)
            {
                writeStream.WriteByte(text[i]);
            }
        }
    }

    public static void PrintStream(UnmanagedMemoryStream readStream)
    {
        byte[] text = new byte[readStream.Length];
        // Verify that the stream is writable:
        // By default, UnmanagedMemoryStream objects do not have write access,
        // write access must be set explicitly.
        if (readStream.CanRead)
        {
            // Write the data, byte by byte
            for (int i = 0; i < readStream.Length; i++)
            {
                text[i] = (byte)readStream.ReadByte();
            }
        }

        Console.WriteLine(UnicodeEncoding.Unicode.GetString(text));
    }
}