UnmanagedMemoryStream コンストラクター

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

オーバーロード

UnmanagedMemoryStream()	UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。
UnmanagedMemoryStream(Byte*, Int64)	指定した場所とメモリの長さを使用して、UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。
UnmanagedMemoryStream(SafeBuffer, Int64, Int64)	指定したオフセットと長さを使用して、セーフ バッファー内の UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。
UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)	指定した場所、メモリの長さ、メモリの総量、ファイル アクセスの値を使用して、UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。
UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)	指定したオフセット、長さ、およびファイル アクセスを使用して、安全なバッファー内の UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

UnmanagedMemoryStream()

ソース:

UnmanagedMemoryStream.cs

UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

protected:
 UnmanagedMemoryStream();

protected UnmanagedMemoryStream ();

Protected Sub New ()

例外

SecurityException

ユーザーに必要なアクセス許可がありません。

UnmanagedMemoryStream(Byte*, Int64)

ソース:

UnmanagedMemoryStream.cs

重要

この API は CLS 準拠ではありません。

指定した場所とメモリの長さを使用して、UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

public:
 UnmanagedMemoryStream(System::Byte* pointer, long length);

[System.CLSCompliant(false)]
public UnmanagedMemoryStream (byte* pointer, long length);

[<System.CLSCompliant(false)>]
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 -> System.IO.UnmanagedMemoryStream

パラメーター

pointer

Byte*

アンマネージ メモリの場所へのポインター。

length

Int64

使用するメモリの長さ。

属性

CLSCompliantAttribute

例外

SecurityException

ユーザーに必要なアクセス許可がありません。

ArgumentNullException

pointer 値は nullです。

ArgumentOutOfRangeException

length 値が 0 未満です。

-又は-

length はオーバーフローを引き起こすのに十分な大きさです。

例

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

// 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));
    }
}

注釈

このコンストラクターは、UnmanagedMemoryStream クラスの新しいインスタンスを作成し、既定で CanWrite プロパティを false に設定し、CanRead プロパティを trueに設定します。 Length プロパティは、length パラメーターの値に設定され、変更できません。

UnmanagedMemoryStream(SafeBuffer, Int64, Int64)

ソース:

UnmanagedMemoryStream.cs

指定したオフセットと長さを使用して、セーフ バッファー内の UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

public:
 UnmanagedMemoryStream(System::Runtime::InteropServices::SafeBuffer ^ buffer, long offset, long length);

public UnmanagedMemoryStream (System.Runtime.InteropServices.SafeBuffer buffer, long offset, long length);

new System.IO.UnmanagedMemoryStream : System.Runtime.InteropServices.SafeBuffer * int64 * int64 -> System.IO.UnmanagedMemoryStream

Public Sub New (buffer As SafeBuffer, offset As Long, length As Long)

パラメーター

buffer

SafeBuffer

アンマネージ メモリ ストリームを格納するバッファー。

offset

Int64

アンマネージ メモリ ストリームを開始するバッファー内のバイト位置。

length

Int64

アンマネージ メモリ ストリームの長さ。

UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)

ソース:

UnmanagedMemoryStream.cs

重要

この API は CLS 準拠ではありません。

指定した場所、メモリの長さ、メモリの総量、ファイル アクセスの値を使用して、UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

public:
 UnmanagedMemoryStream(System::Byte* pointer, long length, long capacity, System::IO::FileAccess access);

[System.CLSCompliant(false)]
public UnmanagedMemoryStream (byte* pointer, long length, long capacity, System.IO.FileAccess access);

[<System.CLSCompliant(false)>]
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> System.IO.UnmanagedMemoryStream

パラメーター

pointer

Byte*

アンマネージ メモリの場所へのポインター。

length

Int64

使用するメモリの長さ。

capacity

Int64

ストリームに割り当てられたメモリの合計量。

access

FileAccess

FileAccess 値の 1 つ。

属性

CLSCompliantAttribute

例外

SecurityException

ユーザーに必要なアクセス許可がありません。

ArgumentNullException

pointer 値は nullです。

ArgumentOutOfRangeException

length 値が 0 未満です。

-又は-

capacity 値が 0 未満です。

-又は-

length 値が capacity 値より大きい。

例

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

// 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 some 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();
    }
}

注釈

length パラメーターは、現在使用されているメモリ量を定義します。 ストリームにデータを読み取ったり追加したりする場合、length 値は、読み取りまたは保持されるストリーム内の有効なデータの量と等しい必要があります。 ストリームに書き込む場合、この値は 0 にする必要があります。

capacity パラメーターは、使用可能な合計メモリ量を示します。 この値は、指定された長さより長い領域を記述することも、追加可能な領域を示す場合もあります。 この値を超えて書き込もうとすると失敗します。

access パラメーターは、CanReadおよび CanWrite プロパティを設定します。 Write を指定しても、ストリームが書き込み可能になることは保証されないことに注意してください。 アクセス パラメーターを使用すると、実装者は、実装が公開されている実際のストリームと一致するオブジェクトを作成できます。

UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)

ソース:

UnmanagedMemoryStream.cs

指定したオフセット、長さ、およびファイル アクセスを使用して、安全なバッファー内の UnmanagedMemoryStream クラスの新しいインスタンスを初期化します。

public:
 UnmanagedMemoryStream(System::Runtime::InteropServices::SafeBuffer ^ buffer, long offset, long length, System::IO::FileAccess access);

public UnmanagedMemoryStream (System.Runtime.InteropServices.SafeBuffer buffer, long offset, long length, System.IO.FileAccess access);

new System.IO.UnmanagedMemoryStream : System.Runtime.InteropServices.SafeBuffer * int64 * int64 * System.IO.FileAccess -> System.IO.UnmanagedMemoryStream

Public Sub New (buffer As SafeBuffer, offset As Long, length As Long, access As FileAccess)

パラメーター

buffer

SafeBuffer

アンマネージ メモリ ストリームを格納するバッファー。

offset

Int64

アンマネージ メモリ ストリームを開始するバッファー内のバイト位置。

length

Int64

アンマネージ メモリ ストリームの長さ。

access

FileAccess

アンマネージド メモリ ストリームへのファイル アクセスのモード。