Método Marshal.PtrToStringAnsi (IntPtr)

Artigo
04/22/2017

Copia todos os caracteres até o primeiro caractere nulo de uma cadeia de caracteres ANSI não gerenciada para um String gerenciado e amplia cada caractere ANSI para Unicode.

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

Sintaxe

[SecurityCriticalAttribute]
public static string PtrToStringAnsi(
    IntPtr ptr
)

public:
[SecurityCriticalAttribute]
static String^ PtrToStringAnsi(
    IntPtr ptr
)

[<SecurityCriticalAttribute>]
static member PtrToStringAnsi : 
        ptr:nativeint -> string

<SecurityCriticalAttribute>
Public Shared Function PtrToStringAnsi (
    ptr As IntPtr
) As String

Parâmetros

ptr
Type: System.IntPtr

O endereço do primeiro caractere da cadeia de caracteres não gerenciada.

Valor Retornado

Type: System.String

Uma cadeia de caracteres gerenciada que mantém uma cópia da cadeia de caracteres ANSI não gerenciada. Se ptr for null, o método retornará uma cadeia de caracteres nula.

Comentários

PtrToStringAnsi is useful for custom marshaling or when mixing managed and unmanaged code. Because this method creates a copy of the unmanaged string's contents, you must free the original string as appropriate. This method provides the opposite functionality of the Marshal.StringToCoTaskMemAnsi and Marshal.StringToHGlobalAnsi methods.

Exemplos

The following example uses the M:System.Runtime.InteropServices.Marshal.PtrToStringAnsi(System.IntPtr) method to create a managed string from an unmanaged char array.

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

void main()
{
    // Create an unmanaged c string.
    const char * myString = "Hello managed world (from the unmanaged world)!";

    // Convert the c string to a managed String.
    String ^ myManagedString = Marshal::PtrToStringAnsi((IntPtr) (char *) myString);

    // Display the string to the console.
    Console::WriteLine(myManagedString);
}

Segurança

SecurityCriticalAttribute

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

Informações de Versão

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 8.0
Windows Phone
Disponível desde 8.1

Confira Também

StringToCoTaskMemAnsi
StringToHGlobalAnsi
PtrToStringAnsi Sobrecarga
Classe Marshal
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via