UIntPtr.Add(UIntPtr, Int32) Método

Definição

Adiciona um deslocamento ao valor de um ponteiro sem sinal.Adds an offset to the value of an unsigned pointer.

public:
 static UIntPtr Add(UIntPtr pointer, int offset);
public static UIntPtr Add (UIntPtr pointer, int offset);
static member Add : unativeint * int -> unativeint
Public Shared Function Add (pointer As UIntPtr, offset As Integer) As UIntPtr

Parâmetros

pointer
UIntPtr

O ponteiro sem sinal ao qual adicionar o deslocamento.The unsigned pointer to add the offset to.

offset
Int32

O deslocamento a ser adicionado.The offset to add.

Retornos

Um novo ponteiro sem sinal que reflete a adição de offset a pointer.A new unsigned pointer that reflects the addition of offset to pointer.

Exemplos

O exemplo a seguir instancia um objeto UIntPtr que aponta para o início de uma matriz de dez elementos e, em seguida, chama o método Add para iterar os elementos na matriz.The following example instantiates a UIntPtr object that points to the beginning of a ten-element array, and then calls the Add method to iterate the elements in the array.

using System;

public class Example
{
   public static void Main()
   {
      int[] arr = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
      UIntPtr ptr = (UIntPtr) arr[0];
      for (int ctr = 0; ctr < arr.Length; ctr++)
      {
         UIntPtr newPtr = UIntPtr.Add(ptr, ctr);
         Console.Write("{0}   ", newPtr);
      }      
   }
}
// The example displays the following output:
//       1   2   3   4   5   6   7   8   9   10
Module Example
   Public Sub Main()
      Dim arr() As Integer = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
      Dim ptr As UIntPtr = CType(arr(0), UIntPtr)
      For ctr As Integer= 0 To arr.Length - 1
         Dim newPtr As UIntPtr = UIntPtr.Add(ptr, ctr)
         Console.Write("{0}   ", newPtr)
      Next
   End Sub
End Module
' The example displays the following output:
'       1   2   3   4   5   6   7   8   9   10

Comentários

O método Add não lançará uma exceção se o resultado for muito grande para representar como um ponteiro na plataforma especificada.The Add method does not throw an exception if the result is too large to represent as a pointer on the specified platform. Em vez disso, a operação de adição é executada em um contexto desmarcado.Instead, the addition operation is performed in an unchecked context.

Idiomas que não dão suporte a sobrecarga de operador ou operadores personalizados podem usar esse método para adicionar um deslocamento ao valor de um ponteiro não assinado.Languages that do not support operator overloading or custom operators can use this method to add an offset to the value of an unsigned pointer.

Aplica-se a

Veja também