Marshal.ReadInt16 Méthode

Définition

Espace de noms:: System.Runtime.InteropServices

Assemblys:: mscorlib.dll, System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lit un entier signé 16 bits à partir de la mémoire non managée. La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Surcharges

Nom	Description
ReadInt16(IntPtr)	Lit un entier signé 16 bits à partir de la mémoire non managée.
ReadInt16(IntPtr, Int32)	Lit un entier signé 16 bits à un décalage donné de la mémoire non managée.
ReadInt16(Object, Int32)	Obsolète. Lit un entier signé 16 bits à un décalage donné de la mémoire non managée.

ReadInt16(IntPtr)

Lit un entier signé 16 bits à partir de la mémoire non managée.

public:
 static short ReadInt16(IntPtr ptr);

[System.Security.SecurityCritical]
public static short ReadInt16(IntPtr ptr);

public static short ReadInt16(IntPtr ptr);

[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint -> int16

static member ReadInt16 : nativeint -> int16

Public Shared Function ReadInt16 (ptr As IntPtr) As Short

Paramètres

ptr: IntPtr
nativeint

Adresse dans la mémoire non managée à partir de laquelle lire.

Retours

Int16

Entier signé 16 bits lu à partir de la mémoire non managée.

Attributs: SecurityCriticalAttribute

Exceptions

AccessViolationException

ptr n’est pas un format reconnu.

-ou-

ptr a la valeur null.

-ou-

ptr n’est pas valide.

Exemples

L’exemple suivant montre comment lire et écrire dans un tableau non managé à l’aide des méthodes et WriteInt16 des ReadInt16 méthodes.

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

L’exemple suivant montre comment utiliser la ReadInt16 méthode pour lire la valeur d’une variable non managée short .


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



void main()
{
    // Create an unmanaged short.
    short myShort = 42;

    // Read the short as a managed Int16.
        Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) &myShort);

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

Remarques

ReadInt16 a un décalage implicite de 0. Cette méthode permet une interaction directe avec un tableau de style Int16 C non managé, éliminant ainsi les frais de copie d’un tableau non managé (utilisant Marshal.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

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

S’applique à

ReadInt16(IntPtr, Int32)

Lit un entier signé 16 bits à un décalage donné de la mémoire non managée.

public:
 static short ReadInt16(IntPtr ptr, int ofs);

[System.Security.SecurityCritical]
public static short ReadInt16(IntPtr ptr, int ofs);

public static short ReadInt16(IntPtr ptr, int ofs);

[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint * int -> int16

static member ReadInt16 : nativeint * int -> int16

Public Shared Function ReadInt16 (ptr As IntPtr, ofs As Integer) As Short

Paramètres

ptr: IntPtr
nativeint

Adresse de base dans la mémoire non managée à partir de laquelle lire.

ofs: Int32

Décalage d’octet supplémentaire, ajouté au paramètre avant la ptr lecture.

Retours

Int16

Entier signé 16 bits lu à partir de la mémoire non managée au décalage donné.

Attributs: SecurityCriticalAttribute

Exceptions

AccessViolationException

L’adresse de base (ptr) plus l’octet de décalage (ofs) produit une adresse null ou non valide.

Exemples

L’exemple suivant montre comment lire et écrire dans un tableau non managé à l’aide des méthodes et WriteInt16 des ReadInt16 méthodes.

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

L’exemple suivant montre comment utiliser la ReadInt16 méthode pour lire la valeur d’une variable non managée short .


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

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

    // Read value as a managed Int16.
    Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) myShort, 0);

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

Remarques

ReadInt16 permet une interaction directe avec un tableau signé 16 bits non managé, éliminant ainsi les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

S’applique à

ReadInt16(Object, Int32)

Attention

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

Lit un entier signé 16 bits à un décalage donné de la mémoire non managée.

public:
 static short ReadInt16(System::Object ^ ptr, int ofs);

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

public static short ReadInt16(object ptr, int ofs);

[System.Security.SecurityCritical]
public static short ReadInt16(object ptr, int ofs);

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

[<System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt16 : obj * int -> int16

static member ReadInt16 : obj * int -> int16

[<System.Security.SecurityCritical>]
static member ReadInt16 : obj * int -> int16

[<System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt16 : obj * int -> int16

Public Shared Function ReadInt16 (ptr As Object, ofs As Integer) As Short

Paramètres

ptr: Object

Adresse de base en mémoire non managée de l’objet source.

ofs: Int32

Décalage d’octet supplémentaire, ajouté au paramètre avant la ptr lecture.

Retours

Int16

Entier signé 16 bits lu à partir de la mémoire non managée au décalage donné.

Attributs: ObsoleteAttribute SecurityCriticalAttribute

Exceptions

AccessViolationException

L’adresse de base (ptr) plus l’octet de décalage (ofs) produit une adresse null ou non valide.

ArgumentException

ptr est un ArrayWithOffset objet. Cette méthode n’accepte pas les ArrayWithOffset paramètres.

Remarques

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?