Marshal.ReadByte メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

アンマネージ メモリから 1 バイトを読み取ります。 アライメントされていないメモリ位置からの読み取りがサポートされています。

オーバーロード

ReadByte(IntPtr, Int32)	アンマネージ メモリから、指定されたオフセット (またはインデックス) で 1 バイトを読み取ります。
ReadByte(Object, Int32)	古い. アンマネージ メモリから、指定されたオフセット (またはインデックス) で 1 バイトを読み取ります。
ReadByte(IntPtr)	アンマネージ メモリから 1 バイトを読み取ります。

ReadByte(IntPtr, Int32)

ソース:

Marshal.cs

アンマネージ メモリから、指定されたオフセット (またはインデックス) で 1 バイトを読み取ります。

C#

public static byte ReadByte (IntPtr ptr, int ofs);

パラメーター

ptr

IntPtr

読み取り元のアンマネージ メモリ内のベース アドレス。

ofs

Int32

読み取る前に ptr パラメーターに追加されるバイト オフセット。

戻り値

Byte

指定されたオフセットにあるアンマネージ メモリから読み取られたバイト。

例外

AccessViolationException

ベース アドレス (ptr) とオフセット バイト (ofs) は、null または無効なアドレスを生成します。

例

次の例では、ReadByte メソッドと WriteByte メソッドを使用して、アンマネージ配列の読み取りと書き込みを行う方法を示します。

C#

static void ReadWriteByte()
{
    // Allocate unmanaged memory. 
    int elementSize = 1;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteByte(unmanagedArray, i * elementSize, ((Byte)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadByte(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

次の例では、ReadByte メソッドを使用してアンマネージ文字の値を読み取る方法を示します。

C++

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged byte.
    const char * myString = "bB";

    // Read the second character of the c string as a managed byte.
        Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString, 1);

    // Display the byte to the console.
    Console::WriteLine(myManagedByte);
}

注釈

ReadByte を使用すると、アンマネージ C スタイルのバイト配列と直接やり取りできるため、要素値を読み取る前に (Marshal.Copyを使用して) アンマネージド配列全体を別のマネージド配列にコピーする手間が省けます。

アライメントされていないメモリ位置からの読み取りがサポートされています。

こちらもご覧ください

• Copy(Int32[], Int32, IntPtr, Int32)

ReadByte(Object, Int32)

ソース:

Marshal.CoreCLR.cs

注意事項

ReadByte(Object, Int32) may be unavailable in future releases.

アンマネージ メモリから、指定されたオフセット (またはインデックス) で 1 バイトを読み取ります。

C#

[System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")]
public static byte ReadByte (object ptr, int ofs);

パラメーター

ptr

Object

ソース オブジェクトのアンマネージ メモリ内のベース アドレス。

ofs

Int32

読み取る前に ptr パラメーターに追加されるバイト オフセット。

戻り値

Byte

指定されたオフセットにあるアンマネージ メモリから読み取られたバイト。

属性

ObsoleteAttribute

例外

AccessViolationException

ベース アドレス (ptr) とオフセット バイト (ofs) は、null または無効なアドレスを生成します。

ArgumentException

ptr は ArrayWithOffset オブジェクトです。 このメソッドは、ArrayWithOffset パラメーターを受け取りません。

注釈

ReadByte を使用すると、アンマネージ C スタイルのバイト配列と直接やり取りできるため、要素値を読み取る前に (Marshal.Copyを使用して) アンマネージド配列全体を別のマネージド配列にコピーする手間が省けます。

アライメントされていないメモリ位置からの読み取りがサポートされています。

こちらもご覧ください

• Copy(Int32[], Int32, IntPtr, Int32)

ReadByte(IntPtr)

ソース:

Marshal.cs

アンマネージ メモリから 1 バイトを読み取ります。

C#

public static byte ReadByte (IntPtr ptr);

パラメーター

ptr

IntPtr

読み取り元のアンマネージ メモリ内のアドレス。

戻り値

Byte

アンマネージ メモリから読み取られたバイト。

例外

AccessViolationException

ptr は認識されない形式です。

-又は-

ptr は nullです。

-又は-

ptr が無効です。

例

次の例では、アンマネージ メモリのブロックを作成し、アンマネージ メモリにバイトを書き込み、アンマネージ メモリからバイトを読み取り、アンマネージ メモリを破棄します。

C#

using System;
using System.Runtime.InteropServices;

 class Example
 {
     static void Main(string[] args)
     {
          // Allocate 1 byte of unmanaged memory.
          IntPtr hGlobal = Marshal.AllocHGlobal(1);

          // Create a new byte.
          byte b = 1;
          Console.WriteLine("Byte written to unmanaged memory: " + b);

          // Write the byte to unmanaged memory.
          Marshal.WriteByte(hGlobal, b);

          // Read byte from unmanaged memory.
          byte c = Marshal.ReadByte(hGlobal);
          Console.WriteLine("Byte read from unmanaged memory: " + c);

          // Free the unmanaged memory.
          Marshal.FreeHGlobal(hGlobal);
          Console.WriteLine("Unmanaged memory was disposed.");
     }
}

次の例では、ReadByte メソッドを使用してアンマネージ文字の値を読み取る方法を示します。

C++

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged byte.
    const char * myString = "b";

    // Read the c string as a managed byte.
        Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString);

    // Display the byte to the console.
    Console::WriteLine(myManagedByte);
}

注釈

ReadByte の暗黙のオフセットは 0 です。 このメソッドを使用すると、アンマネージ C スタイルのバイト配列を直接操作できるため、要素値を読み取る前にアンマネージド配列全体 (Marshal.Copyを使用) を別のマネージド配列にコピーする手間が省けます。

アライメントされていないメモリ位置からの読み取りがサポートされています。

こちらもご覧ください

• Copy(Int32[], Int32, IntPtr, Int32)