Marshal.SizeOf Méthode

Définition

Retourne la taille non managée (en octets) d'une classe.

Surcharges

SizeOf(Object)
Obsolète.

Retourne la taille non managée d'un objet en octets.

SizeOf(Type)
Obsolète.

Retourne la taille d'un type non managé en octets.

SizeOf<T>()

Retourne la taille d'un type non managé en octets.

SizeOf<T>(T)

Retourne la taille non managée en octets d'un objet d'un type spécifié.

SizeOf(Object)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Attention

SizeOf(Object) may be unavailable in future releases. Instead, use SizeOf<T>(). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296514

Retourne la taille non managée d'un objet en octets.

C#
[System.Obsolete("SizeOf(Object) may be unavailable in future releases. Instead, use SizeOf<T>(). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296514")]
public static int SizeOf(object structure);
C#
public static int SizeOf(object structure);
C#
[System.Runtime.InteropServices.ComVisible(true)]
public static int SizeOf(object structure);

Paramètres

structure
Object

Objet dont la taille doit être retournée.

Retours

Taille de l'objet spécifié dans le code non managé.

Attributs

Exceptions

Le paramètre structure a la valeur null.

Exemples

L’exemple suivant crée une structure managée, la transfère à la mémoire non managée, puis la transfère à la mémoire managée. Cet exemple utilise la SizeOf méthode pour déterminer la quantité de mémoire non managée à allouer.

C#
using System;
using System.Runtime.InteropServices;

public struct Point
{
    public int x;
    public int y;
}

class Example
{

    static void Main()
    {

        // Create a point struct.
        Point p;
        p.x = 1;
        p.y = 1;

        Console.WriteLine("The value of first point is " + p.x + " and " + p.y + ".");

        // Initialize unmanged memory to hold the struct.
        IntPtr pnt = Marshal.AllocHGlobal(Marshal.SizeOf(p));

        try
        {

            // Copy the struct to unmanaged memory.
            Marshal.StructureToPtr(p, pnt, false);

            // Create another point.
            Point anotherP;

            // Set this Point to the value of the
            // Point in unmanaged memory.
            anotherP = (Point)Marshal.PtrToStructure(pnt, typeof(Point));

            Console.WriteLine("The value of new point is " + anotherP.x + " and " + anotherP.y + ".");
        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
    }
}

Remarques

Cette méthode accepte une instance d’une structure, qui peut être un type référence ou un type valeur boxed. La disposition doit être séquentielle ou explicite.

La taille retournée est la taille de l’objet non managé. Les tailles non managées et managées d’un objet peuvent différer. Pour les types de caractères, la taille est affectée par la CharSet valeur appliquée à cette classe.

Vous pouvez utiliser la SizeOf méthode pour déterminer la quantité de mémoire non managée à allouer à l’aide des AllocHGlobal méthodes et AllocCoTaskMem .

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions (Obsolète)
.NET Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 2.0, 2.1 (1.2, 1.3, 1.4, 1.5, 1.6)
UWP (10.0)

SizeOf(Type)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Attention

SizeOf(Type) may be unavailable in future releases. Instead, use SizeOf<T>(). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296515

Retourne la taille d'un type non managé en octets.

C#
[System.Obsolete("SizeOf(Type) may be unavailable in future releases. Instead, use SizeOf<T>(). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296515")]
public static int SizeOf(Type t);
C#
public static int SizeOf(Type t);

Paramètres

t
Type

Type dont la taille doit être retournée.

Retours

Taille du type spécifié dans le code non managé.

Attributs

Exceptions

Le paramètre t est une définition de type générique.

Le paramètre t a la valeur null.

Exemples

L'exemple suivant montre l'appel à la méthode SizeOf. Cet exemple de code fait partie d’un exemple plus grand fourni pour la Marshal classe .

C#
// Demonstrate the use of the SizeOf method of the Marshal class.
Console.WriteLine("Number of bytes needed by a Point object: {0}",
    Marshal.SizeOf(typeof(Point)));
Point p = new Point();
Console.WriteLine("Number of bytes needed by a Point object: {0}",
    Marshal.SizeOf(p));

Remarques

Vous pouvez utiliser cette méthode lorsque vous n’avez pas de structure. La disposition doit être séquentielle ou explicite.

La taille retournée correspond à la taille du type non managé. Les tailles non managées et managées d’un objet peuvent différer. Pour les types de caractères, la taille est affectée par la CharSet valeur appliquée à cette classe.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions (Obsolète)
.NET Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 2.0, 2.1 (1.2, 1.3, 1.4, 1.5, 1.6)
UWP (10.0)

SizeOf<T>()

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Retourne la taille d'un type non managé en octets.

C#
public static int SizeOf<T>();

Paramètres de type

T

Type dont la taille doit être retournée.

Retours

Taille, en octets, du type spécifié par le paramètre de type générique T.

Remarques

Vous pouvez utiliser cette méthode lorsque vous n’avez pas de structure. La disposition doit être séquentielle ou explicite.

La taille retournée correspond à la taille du type non managé. Les tailles non managées et managées d’un objet peuvent différer. Pour les types de caractères, la taille est affectée par la CharSet valeur appliquée à cette classe.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

SizeOf<T>(T)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Retourne la taille non managée en octets d'un objet d'un type spécifié.

C#
public static int SizeOf<T>(T structure);

Paramètres de type

T

Type du paramètre structure.

Paramètres

structure
T

Objet dont la taille doit être retournée.

Retours

Taille, en octets, de l'objet spécifié dans le code non managé.

Exceptions

Le paramètre structure a la valeur null.

Remarques

Cette méthode accepte une instance d’une structure, qui peut être un type référence ou un type valeur boxed. La disposition doit être séquentielle ou explicite.

La taille retournée est la taille de l’objet non managé. Les tailles non managées et managées d’un objet peuvent différer. Pour les types de caractères, la taille est affectée par la CharSet valeur appliquée à cette classe.

Vous pouvez utiliser la SizeOf<T>(T) méthode pour déterminer la quantité de mémoire non managée à allouer à l’aide des AllocHGlobal méthodes et AllocCoTaskMem .

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0