Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Estrutura IntPtr

 

Um tipo específico da plataforma que é usado para representar um ponteiro ou um identificador.

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

[SerializableAttribute]
[ComVisibleAttribute(true)]
public struct IntPtr : ISerializable

NomeDescrição
System_CAPS_pubmethodIntPtr(Int32)

Inicializa uma nova instância de IntPtr usando o ponteiro de 32 bits especificado ou o identificador.

System_CAPS_pubmethodIntPtr(Int64)

Inicializa uma nova instância de IntPtr usando o ponteiro de 64 bits especificado.

System_CAPS_pubmethodIntPtr(Void*)

Inicializa uma nova instância do IntPtr usando o ponteiro especificado para um tipo não especificado.

NomeDescrição
System_CAPS_pubpropertySystem_CAPS_staticSize

Obtém o tamanho desta instância.

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticAdd(IntPtr, Int32)

Adiciona um deslocamento para o valor de um ponteiro.

System_CAPS_pubmethodEquals(Object)

Retorna um valor que indica se esta instância é igual ao objeto especificado.(Substitui o ValueType.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Retorna o hash code para essa instância. (Substitui o ValueType.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticSubtract(IntPtr, Int32)

Subtrai um deslocamento do valor de um ponteiro.

System_CAPS_pubmethodToInt32()

Converte o valor dessa instância em um inteiro assinado de 32 bits.

System_CAPS_pubmethodToInt64()

Converte o valor dessa instância em um inteiro assinado de 64 bits.

System_CAPS_pubmethodToPointer()

Converte o valor dessa instância em um ponteiro para um tipo não especificado.

System_CAPS_pubmethodToString()

Converte o valor numérico do atual IntPtr objeto em sua representação de cadeia de caracteres equivalente.(Substitui o ValueType.ToString().)

System_CAPS_pubmethodToString(String)

Converte o valor numérico do atual IntPtr objeto em sua representação de cadeia de caracteres equivalente.

NomeDescrição
System_CAPS_pubfieldSystem_CAPS_staticZero

Um campo somente leitura que representa um ponteiro ou identificador que foi inicializado para zero.

NomeDescrição
System_CAPS_puboperatorSystem_CAPS_staticAddition(IntPtr, Int32)

Adiciona um deslocamento para o valor de um ponteiro.

System_CAPS_puboperatorSystem_CAPS_staticEquality(IntPtr, IntPtr)

Determina se duas instâncias especificadas do IntPtr são iguais.

System_CAPS_puboperatorSystem_CAPS_staticExplicit(Int32 to IntPtr)

Converte o valor de um inteiro assinado de 32 bits para um IntPtr.

System_CAPS_puboperatorSystem_CAPS_staticExplicit(Int64 to IntPtr)

Converte o valor de um inteiro assinado de 64 bits para um IntPtr.

System_CAPS_puboperatorSystem_CAPS_staticExplicit(IntPtr to Int32)

Converte o valor especificado IntPtr em um inteiro assinado de 32 bits.

System_CAPS_puboperatorSystem_CAPS_staticExplicit(IntPtr to Int64)

Converte o valor especificado IntPtr em um inteiro assinado de 64 bits.

System_CAPS_puboperatorSystem_CAPS_staticExplicit(IntPtr to Void*)

Converte o valor especificado IntPtr em um ponteiro para um tipo não especificado.

System_CAPS_puboperatorSystem_CAPS_staticExplicit(Void* to IntPtr)

Converte o ponteiro especificado para um tipo não especificado para um IntPtr.

System_CAPS_puboperatorSystem_CAPS_staticInequality(IntPtr, IntPtr)

Determina se duas instâncias especificadas do IntPtr não são iguais.

System_CAPS_puboperatorSystem_CAPS_staticSubtraction(IntPtr, Int32)

Subtrai um deslocamento do valor de um ponteiro.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Preenche uma SerializationInfo objeto com os dados necessários para serializar atual IntPtr objeto.

The T:System.IntPtr type is designed to be an integer whose size is platform-specific. That is, an instance of this type is expected to be 32-bits on 32-bit hardware and operating systems, and 64-bits on 64-bit hardware and operating systems.

The T:System.IntPtr type can be used by languages that support pointers, and as a common means of referring to data between languages that do and do not support pointers.

IntPtr objects can also be used to hold handles. For example, instances of IntPtr are used extensively in the System.IO.FileStream class to hold file handles.

The T:System.IntPtr type is CLS-compliant, while the T:System.UIntPtr type is not. Only the T:System.IntPtr type is used in the common language runtime. The T:System.UIntPtr type is provided mostly to maintain architectural symmetry with the T:System.IntPtr type.

This type implements the T:System.Runtime.Serialization.ISerializable interface.

The following example uses managed pointers to reverse the characters in an array. After it initializes a T:System.String object and gets its length, it does the following:

  1. Calls the M:System.Runtime.InteropServices.Marshal.StringToHGlobalAnsi(System.String) method to copy the Unicode string to unmanaged memory as an ANSI (one-byte) character. The method returns an T:System.IntPtr object that points to the beginning of the unmanaged string. The Visual Basic example uses this pointer directly; in the C++ and C# examples, it is cast to a pointer to a byte.

  2. Calls the M:System.Runtime.InteropServices.Marshal.AllocHGlobal(System.Int32) method to allocate the same number of bytes as the unmanaged string occupies. The method returns an T:System.IntPtr object that points to the beginning of the unmanaged block of memory. The Visual Basic example uses this pointer directly; in the C++ and C# examples, it is cast to a pointer to a byte.

  3. The Visual Basic example defines a variable named offset that is equal to the length of the ANSI string. It is used to determine the offset into unmanaged memory to which the next charter in the ANSI string is copied. Because its starting value is the length of the string, the copy operation will copy a character from the start of the string to the end of the memory block.

    The C# and C++ examples call the M:System.IntPtr.ToPointer method to get an unmanaged pointer to the starting address of the string and the unmanaged block of memory, and they add one less than the length of the string to the starting address of the ANSI string. Because the unmanaged string pointer now points to the end of the string, the copy operation will copy a character from the end of the string to the start of the memory block.

  4. Uses a loop to copy each character from the string to the unmanaged block of memory.

    The Visual Basic example calls the M:System.Runtime.InteropServices.Marshal.ReadByte(System.IntPtr,System.Int32) method to read the byte (or one-byte character) at a specified offset from the managed pointer to the ANSI string. The offset is incremented with each iteration of the loop. It then calls the M:System.Runtime.InteropServices.Marshal.WriteByte(System.IntPtr,System.Int32,System.Byte) method to write the byte to the memory address defined by the starting address of the unmanaged block of memory plus offset. It then decrements offset.

    The C# and C++ examples perform the copy operation, then decrement the pointer to the address of the next location in the unmanaged ANSI string and increment the pointer to the next address in the unmanaged block.

  5. All examples call the M:System.Runtime.InteropServices.Marshal.PtrToStringAnsi(System.IntPtr,System.Int32) to convert the unmanaged memory block containing the copied ANSI string to a managed Unicode T:System.String object.

  6. After displaying the original and reversed strings, all examples call the M:System.Runtime.InteropServices.Marshal.FreeHGlobal(System.IntPtr) method to free the memory allocated for the unmanaged ANSI string and the unmanaged block of memory.

using System;
using System.Runtime.InteropServices;

class NotTooSafeStringReverse
{
    static public void Main()
    {
        string stringA = "I seem to be turned around!";
        int copylen = stringA.Length;

        // Allocate HGlobal memory for source and destination strings
        IntPtr sptr = Marshal.StringToHGlobalAnsi(stringA);
        IntPtr dptr = Marshal.AllocHGlobal(copylen + 1);

        // The unsafe section where byte pointers are used.
        unsafe
        {
            byte *src = (byte *)sptr.ToPointer();
            byte *dst = (byte *)dptr.ToPointer();

            if (copylen > 0)
            {
                // set the source pointer to the end of the string
                // to do a reverse copy.
                src += copylen - 1;

                while (copylen-- > 0)
                {
                    *dst++ = *src--;
                }
                *dst = 0;
            }
        }
        string stringB = Marshal.PtrToStringAnsi(dptr);

        Console.WriteLine("Original:\n{0}\n", stringA);
        Console.WriteLine("Reversed:\n{0}", stringB);

        // Free HGlobal memory
        Marshal.FreeHGlobal(dptr);
        Marshal.FreeHGlobal(sptr);
    }
}

// The progam has the following output:
//
// Original:
// I seem to be turned around!
//
// Reversed:
// !dnuora denrut eb ot mees I

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 7.0
Windows Phone
Disponível desde 8.1

This type is thread safe.

Retornar ao início
Mostrar: