Marshal.ReadInt32 Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Runtime.InteropServices
Bütünleştirilmiş Kod:
System.Runtime.InteropServices.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Yönetilmeyen bellekten 32 bit imzalı bir tamsayı okur. Hizalanmamış bellek konumlarından okuma desteklenir.

Aşırı Yüklemeler

ReadInt32(IntPtr)

Yönetilmeyen bellekten 32 bit imzalı bir tamsayı okur.
ReadInt32(IntPtr, Int32)

Yönetilmeyen bellekten belirli bir uzaklıkta 32 bit imzalı tamsayı okur.
ReadInt32(Object, Int32)
Geçersiz.

Yönetilmeyen bellekten belirli bir uzaklıkta 32 bit imzalı tamsayı okur.

ReadInt32(IntPtr)

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bellekten 32 bit imzalı bir tamsayı okur.

public:
 static int ReadInt32(IntPtr ptr);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr);
public static int ReadInt32 (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint -> int
static member ReadInt32 : nativeint -> int
Public Shared Function ReadInt32 (ptr As IntPtr) As Integer

Parametreler

ptr
IntPtr

nativeint

Yönetilmeyen bellekteki okunacak adres.

Döndürülenler

Int32

Yönetilmeyen bellekten okunan 32 bit imzalı tamsayı.

Öznitelikler
SecurityCriticalAttribute

Özel durumlar

AccessViolationException

ptr tanınan bir biçim değildir.

-veya-

ptr, null değeridir.

-veya-

ptr geçersizdir.

Örnekler

Aşağıdaki örnek, ve WriteInt32 yöntemlerini kullanarak ReadInt32 yönetilmeyen bir diziyi nasıl okuyup yazacaklarını göstermektedir.

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

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt32(unmanagedArray, i * elementSize, ((Int32)(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.ReadInt32(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Aşağıdaki örnekte, yönetilmeyen int bir değişkenin ReadInt32 değerini okumak için yönteminin nasıl kullanılacağı gösterilmektedir.

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



void main()
{
    // Create an unmanaged integer.
    int myVal = 42;

    // Read the int as a managed Int32.
        Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) &myVal);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Açıklamalar

ReadInt32 0 zımni uzaklığı vardır. Bu yöntem yönetilmeyen bir C stili Int32 diziyle doğrudan etkileşime olanak sağlayarak, tüm yönetilmeyen diziyi (kullanarak Marshal.Copy) öğe değerlerini okumadan önce ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

Şunlara uygulanır

ReadInt32(IntPtr, Int32)

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bellekten belirli bir uzaklıkta 32 bit imzalı tamsayı okur.

public:
 static int ReadInt32(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr, int ofs);
public static int ReadInt32 (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint * int -> int
static member ReadInt32 : nativeint * int -> int
Public Shared Function ReadInt32 (ptr As IntPtr, ofs As Integer) As Integer

Parametreler

ptr
IntPtr

nativeint

Yönetilmeyen bellekte okunacak temel adres.

ofs
Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

Int32

Yönetilmeyen bellekten okunan 32 bit imzalı tamsayı.

Öznitelikler
SecurityCriticalAttribute

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

Örnekler

Aşağıdaki örnek, ve WriteInt32 yöntemlerini kullanarak ReadInt32 yönetilmeyen bir diziyi nasıl okuyup yazacaklarını göstermektedir.

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

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt32(unmanagedArray, i * elementSize, ((Int32)(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.ReadInt32(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Aşağıdaki örnekte, yönetilmeyen int bir değişkenin ReadInt32 değerini okumak için yönteminin nasıl kullanılacağı gösterilmektedir.

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



void main()
{
    // Create an unmanaged int pointer.
    int * myVal;
    int tmp = 42;
    // Initialize it to another value.
    myVal = &tmp;

    // Read value as a managed Int32.
    Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) myVal, 0);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Açıklamalar

ReadInt32 yönetilmeyen 32 bit imzalı bir diziyle doğrudan etkileşime olanak sağlayarak, tüm yönetilmeyen diziyi (kullanarak Marshal.Copy) öğe değerlerini okumadan önce ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

Şunlara uygulanır

ReadInt32(Object, Int32)

Kaynak:
Marshal.CoreCLR.cs
Kaynak:
Marshal.CoreCLR.cs
Kaynak:
Marshal.CoreCLR.cs

Dikkat

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

Yönetilmeyen bellekten belirli bir uzaklıkta 32 bit imzalı tamsayı okur.

public:
 static int ReadInt32(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
public static int ReadInt32 (object ptr, int ofs);
public static int ReadInt32 (object ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt32 : obj * int -> int
static member ReadInt32 : obj * int -> int
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
Public Shared Function ReadInt32 (ptr As Object, ofs As Integer) As Integer

Parametreler

ptr
Object

Kaynak nesnenin yönetilmeyen belleğindeki temel adres.

ofs
Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

Int32

Verilen uzaklıkta yönetilmeyen bellekten okunan 32 bit imzalı tamsayı.

Öznitelikler
ObsoleteAttribute SecurityCriticalAttribute

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

ArgumentException

ptr bir ArrayWithOffset nesnedir. Bu yöntem parametreleri kabul ArrayWithOffset etmez.

Açıklamalar

ReadInt32 yönetilmeyen 32 bit imzalı bir diziyle doğrudan etkileşime olanak sağlayarak, tüm yönetilmeyen diziyi (kullanarak Marshal.Copy) öğe değerlerini okumadan önce ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

Şunlara uygulanır