UnmanagedMemoryStream.Write メソッド

.NET Framework クラス ライブラリ リファレンス

UnmanagedMemoryStream.Write メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

バッファのデータを使用して、現在のストリームにバイトのブロックを書き込みます。

このメソッドは、CLS に準拠していません。  

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Write
 ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
)

Visual Basic (使用法)

Dim instance As UnmanagedMemoryStream
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer

instance.Write(buffer, offset, count)

C#

public override void Write (
    byte[] buffer,
    int offset,
    int count
)

C++

public:
virtual void Write (
    array<unsigned char>^ buffer, 
    int offset, 
    int count
) override

J#

public void Write (
    byte[] buffer, 
    int offset, 
    int count
)

JScript

public override function Write (
    buffer : byte[], 
    offset : int, 
    count : int
)

パラメータ

buffer

現在のストリームにコピーするバイトのコピー元となるバイト配列。

offset

現在のストリームへのバイトのコピーを開始する位置のバッファのオフセット。

count

現在のストリームに書き込むバイト数。

例外

例外の種類	条件
ObjectDisposedException	ストリームが閉じられました。
NotSupportedException	基になるメモリが書き込みをサポートしていません。 または ストリームへの書き込みが行われようとしましたが、CanWrite プロパティが false です。 または count 値がストリームの容量を超えています。 または 位置がストリーム容量の末尾です。
IOException	I/O エラーが発生しました。
ArgumentOutOfRangeException	指定したパラメータのいずれかが 0 未満です。
ArgumentException	offset パラメータから buffer パラメータの長さを引いた値が count パラメータ未満です。
ArgumentNullException	buffer パラメータが null 参照 (Visual Basic では Nothing) です。

解説

書き込みは、ストリーム内の現在位置で行われます。

使用例

UnmanagedMemoryStream クラスを使用して、アンマネージ メモリから読み取る方法と、アンマネージ メモリに書き込む方法を次のコード例に示します。アンマネージ メモリのブロックは、Marshal クラスを使用して割り当ておよび割り当て解除されます。

C#

// 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.Text;
using System.Runtime.InteropServices;

unsafe class TestWriter
{
    
    static void Main()
    {
        
            // Create som data to read and write.
            byte[] message = UnicodeEncoding.Unicode.GetBytes("Here is some
 data.");

        // Allocate a block of unmanaged memory and return an IntPtr
 object.    
            IntPtr memIntPtr = Marshal.AllocHGlobal(message.Length);

            // Get a byte pointer from the IntPtr object.
            byte* memBytePtr = (byte*) memIntPtr.ToPointer();

            // Create an UnmanagedMemoryStream object using a pointer
 to unmanaged memory.
            UnmanagedMemoryStream writeStream = new UnmanagedMemoryStream(memBytePtr,
 message.Length, message.Length, FileAccess.Write);

            // Write the data.
            writeStream.Write(message, 0, message.Length);

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

            // Create another UnmanagedMemoryStream object using a pointer
 to unmanaged memory.
            UnmanagedMemoryStream readStream = new UnmanagedMemoryStream(memBytePtr,
 message.Length, message.Length, FileAccess.Read);

        // Create a byte array to hold data from unmanaged memory.
            byte[] outMessage = new byte[message.Length];

            // Read from unmanaged memory to the byte array.
            readStream.Read(outMessage, 0, message.Length);

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

            // Display the data to the console.
            Console.WriteLine(UnicodeEncoding.Unicode.GetString(outMessage));

            // Free the block of unmanaged memory.
            Marshal.FreeHGlobal(memIntPtr);

            Console.ReadLine();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
UnmanagedMemoryStream クラス
UnmanagedMemoryStream メンバ
System.IO 名前空間