Marshal.StringToHGlobalUni(String) Méthode

Définition

Copie le contenu d'un objet String managé dans la mémoire non managée.

[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni (string s);
public static IntPtr StringToHGlobalUni (string? s);
public static IntPtr StringToHGlobalUni (string s);

Paramètres

s
String

Chaîne managée à copier.

Retours

IntPtr

Adresse, dans la mémoire non managée, où s a été copié, ou 0 si s est null.

Attributs

Exceptions

La méthode n'a pas pu allouer suffisamment de mémoire de tas natif.

Le paramètre s dépasse la longueur maximale autorisée par le système d'exploitation.

Remarques

StringToHGlobalUni est utile pour le marshaling personnalisé ou pour une utilisation lors de la combinaison de code managé et non managé. Étant donné que cette méthode alloue la mémoire non managée requise pour une chaîne, libérez toujours la mémoire en appelant FreeHGlobal. Cette méthode fournit les fonctionnalités opposées de Marshal.PtrToStringUni.

Cette méthode copie les caractères Null incorporés et inclut un caractère null de fin.

Cette API reflète la définition Windows d’Unicode, qui est un encodage de 2 octets UTF-16. Sur de nombreuses plateformes non-Windows, le wchar_t type de données est de 4 octets, et non de 2 octets. Consultez votre compilateur pour vérifier si wchar_t peut être utilisé ou char16_t doit être utilisé à la place.

S’applique à

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 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, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Voir aussi