IntPtr.Add(IntPtr, Int32) IntPtr.Add(IntPtr, Int32) IntPtr.Add(IntPtr, Int32) IntPtr.Add(IntPtr, Int32) Method

정의

포인터의 값에 오프셋을 더합니다.Adds an offset to the value of a pointer.

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

매개 변수

pointer
IntPtr IntPtr IntPtr IntPtr

오프셋을 더할 포인터입니다.The pointer to add the offset to.

offset
Int32 Int32 Int32 Int32

더할 오프셋입니다.The offset to add.

반환

offsetpointer 더하기를 반영하는 새 포인터입니다.A new pointer that reflects the addition of offset to pointer.

예제

다음 예제에서는 IntPtr 호출를 10 개 요소 배열의 시작 부분을 가리키는 개체는 Add 배열에서 요소를 반복 하는 방법입니다.The following example instantiates an IntPtr 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;
using System.Runtime.InteropServices;

public class Example
{
   public static void Main()
   {
      int[] arr = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
      unsafe {
         fixed(int* parr = arr) {
            IntPtr ptr = new IntPtr(parr);
            // Get the size of an array element.
            int size = sizeof(int);
            for (int ctr = 0; ctr < arr.Length; ctr++)
            {
               IntPtr newPtr = IntPtr.Add(ptr, ctr * size);
               Console.Write("{0}   ", Marshal.ReadInt32(newPtr));
            }
         }      
      }
   }
}
// The example displays the following output:
//       2   4   6   8   10   12   14   16   18   20
Imports System.Runtime.InteropServices

Module Example
   Public Sub Main()
      Dim arr() As Integer = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 }
      Dim ptr As IntPtr = Marshal.UnsafeAddrOfPinnedArrayElement(arr, 0)

      For ctr As Integer= 0 To arr.Length - 1
         Dim newPtr As IntPtr = IntPtr.Add(ptr, ctr * Len(arr(0)))
         Console.Write("{0}   ", Marshal.ReadInt32(newPtr))
      Next
   End Sub
End Module
' The example displays the following output:
'       2   4   6   8   10   12   14   16   18   20

설명

Add 메서드 결과가 너무 커서 지정된 된 플랫폼에 대 한 포인터로 표시할 이면 예외를 throw 하지 않습니다.The Add method does not throw an exception if the result is too large to represent as a pointer on the specified platform. 대신, 더하기 연산 unchecked 컨텍스트에서 수행 됩니다.Instead, the addition operation is performed in an unchecked context.

연산자 오버 로드 또는 사용자 지정 연산자를 지원 하지 않는 언어에 대 한 포인터의 값에 오프셋을 더할 수이 메서드를 사용할 수 있습니다.Languages that do not support operator overloading or custom operators can use this method to add an offset to the value of a pointer.

적용 대상

추가 정보