Marshal::ReadByte Method (IntPtr)

.NET Framework (current version)

Reads a single byte from unmanaged memory.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
[SecurityCriticalAttribute]
static unsigned char ReadByte(
	IntPtr ptr
)

Parameters

ptr: Type: System::IntPtr
The address in unmanaged memory from which to read.

Return Value

Type: System::Byte

The byte read from unmanaged memory.

Exceptions

Exception	Condition
AccessViolationException	ptr is not a recognized format. -or- ptr is null. -or- ptr is invalid.

ReadByte has an implied offset of 0. This method enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using Marshal::Copy) to a separate managed array before reading its element values.

Reading from unaligned memory locations is supported.

Examples

The following example creates a block of unmanaged memory, writes a byte to the unmanaged memory, reads the byte back from unmanaged memory, and then disposes the unmanaged memory.

C++

No code example is currently available or this language may not be supported.

The following example demonstrates how to use the ReadByte method to read the value of an unmanaged character.

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

Security

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1