Marshal.Copy 方法

定義

從 Managed 陣列複製資料到 Unmanaged 記憶體指標,或從 Unmanaged 記憶體指標複製資料到 Managed 陣列。Copies data from a managed array to an unmanaged memory pointer, or from an unmanaged memory pointer to a managed array.

多載

Copy(Single[], Int32, IntPtr, Int32)

從一維、Managed 單精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed single-precision floating-point number array to an unmanaged memory pointer.

Copy(IntPtr[], Int32, IntPtr, Int32)

從一維、Managed IntPtr 陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed IntPtr array to an unmanaged memory pointer.

Copy(IntPtr, Single[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 單精確度浮點數陣列。Copies data from an unmanaged memory pointer to a managed single-precision floating-point number array.

Copy(IntPtr, Int64[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 64 位元帶正負號的整數陣列。Copies data from an unmanaged memory pointer to a managed 64-bit signed integer array.

Copy(IntPtr, Int32[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 32 位元帶正負號的整數陣列。Copies data from an unmanaged memory pointer to a managed 32-bit signed integer array.

Copy(IntPtr, Int16[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 16 位元帶正負號的整數陣列。Copies data from an unmanaged memory pointer to a managed 16-bit signed integer array.

Copy(IntPtr, Double[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到Managed 雙精確度浮點數陣列。Copies data from an unmanaged memory pointer to a managed double-precision floating-point number array.

Copy(IntPtr, IntPtr[], Int32, Int32)

從 Unmanaged 記憶體指標,將資料複製到 Managed IntPtr 陣列。Copies data from an unmanaged memory pointer to a managed IntPtr array.

Copy(IntPtr, Byte[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列。Copies data from an unmanaged memory pointer to a managed 8-bit unsigned integer array.

Copy(Int64[], Int32, IntPtr, Int32)

從一維、Managed 64 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 64-bit signed integer array to an unmanaged memory pointer.

Copy(Int32[], Int32, IntPtr, Int32)

從一維、Managed 32 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 32-bit signed integer array to an unmanaged memory pointer.

Copy(Int16[], Int32, IntPtr, Int32)

從一維、Managed 16 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 16-bit signed integer array to an unmanaged memory pointer.

Copy(IntPtr, Char[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 字元陣列。Copies data from an unmanaged memory pointer to a managed character array.

Copy(Double[], Int32, IntPtr, Int32)

從一維、Managed 雙精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed double-precision floating-point number array to an unmanaged memory pointer.

Copy(Char[], Int32, IntPtr, Int32)

從一維、Managed 字元陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed character array to an unmanaged memory pointer.

Copy(Byte[], Int32, IntPtr, Int32)

從一維、Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 8-bit unsigned integer array to an unmanaged memory pointer.

Copy(Single[], Int32, IntPtr, Int32)

從一維、Managed 單精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed single-precision floating-point number array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <float> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (float[] source, int startIndex, IntPtr destination, int length);
static member Copy : single[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Single(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Single[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

sourcestartIndexdestinationlengthnullsource, startIndex, destination, or length is null.

備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(IntPtr[], Int32, IntPtr, Int32)

從一維、Managed IntPtr 陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed IntPtr array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <IntPtr> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr[] source, int startIndex, IntPtr destination, int length);
static member Copy : nativeint[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As IntPtr(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
IntPtr[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

備註

您可以使用這個方法,將一維 managed IntPtr 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed IntPtr array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(IntPtr, Single[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 單精確度浮點數陣列。Copies data from an unmanaged memory pointer to a managed single-precision floating-point number array.

public:
 static void Copy(IntPtr source, cli::array <float> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, float[] destination, int startIndex, int length);
static member Copy : nativeint * single[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Single(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Single[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to the source parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(IntPtr, Int64[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 64 位元帶正負號的整數陣列。Copies data from an unmanaged memory pointer to a managed 64-bit signed integer array.

public:
 static void Copy(IntPtr source, cli::array <long> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, long[] destination, int startIndex, int length);
static member Copy : nativeint * int64[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Long(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Int64[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        Int64[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            Int64[] managedArray2 = new Int64[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Int64() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Int64

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to thesource parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(IntPtr, Int32[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 32 位元帶正負號的整數陣列。Copies data from an unmanaged memory pointer to a managed 32-bit signed integer array.

public:
 static void Copy(IntPtr source, cli::array <int> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, int[] destination, int startIndex, int length);
static member Copy : nativeint * int[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Integer(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Int32[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        int[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            int[] managedArray2 = new int[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Integer() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Integer

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to the source parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(IntPtr, Int16[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 16 位元帶正負號的整數陣列。Copies data from an unmanaged memory pointer to a managed 16-bit signed integer array.

public:
 static void Copy(IntPtr source, cli::array <short> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, short[] destination, int startIndex, int length);
static member Copy : nativeint * int16[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Short(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Int16[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        short[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            short[] managedArray2 = new short[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Short() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Short

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to the source parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(IntPtr, Double[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到Managed 雙精確度浮點數陣列。Copies data from an unmanaged memory pointer to a managed double-precision floating-point number array.

public:
 static void Copy(IntPtr source, cli::array <double> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, double[] destination, int startIndex, int length);
static member Copy : nativeint * double[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Double(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Double[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        double[] managedArray = { 0.1, 0.2, 0.3, 0.4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            double[] managedArray2 = new double[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Double() = {0.1, 0.2, 0.3, 0.4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Double

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to the source parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(IntPtr, IntPtr[], Int32, Int32)

從 Unmanaged 記憶體指標,將資料複製到 Managed IntPtr 陣列。Copies data from an unmanaged memory pointer to a managed IntPtr array.

public:
 static void Copy(IntPtr source, cli::array <IntPtr> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, IntPtr[] destination, int startIndex, int length);
static member Copy : nativeint * nativeint[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As IntPtr(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
IntPtr[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Therefore, the unmanaged data that corresponds to the source parameter populates the managed array regardless of its usefulness. 在呼叫 Marshal.Copy 方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling the Marshal.Copy method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(IntPtr, Byte[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列。Copies data from an unmanaged memory pointer to a managed 8-bit unsigned integer array.

public:
 static void Copy(IntPtr source, cli::array <System::Byte> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, byte[] destination, int startIndex, int length);
static member Copy : nativeint * byte[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Byte(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Byte[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        byte[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            byte[] managedArray2 = new byte[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Byte() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Byte

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to the source parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(Int64[], Int32, IntPtr, Int32)

從一維、Managed 64 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 64-bit signed integer array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <long> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (long[] source, int startIndex, IntPtr destination, int length);
static member Copy : int64[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Long(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Int64[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

sourcestartIndexdestinationlengthnullsource, startIndex, destination, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        Int64[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            Int64[] managedArray2 = new Int64[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Int64() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Int64

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(Int32[], Int32, IntPtr, Int32)

從一維、Managed 32 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 32-bit signed integer array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <int> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (int[] source, int startIndex, IntPtr destination, int length);
static member Copy : int[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Integer(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Int32[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

startIndexlengthnullstartIndex or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        int[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            int[] managedArray2 = new int[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Integer() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Integer

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(Int16[], Int32, IntPtr, Int32)

從一維、Managed 16 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 16-bit signed integer array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <short> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (short[] source, int startIndex, IntPtr destination, int length);
static member Copy : int16[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Short(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Int16[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

sourcestartIndexdestinationlengthnullsource, startIndex, destination, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        short[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            short[] managedArray2 = new short[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Short() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Short

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(IntPtr, Char[], Int32, Int32)

從 Unmanaged 記憶體指標將資料複製到 Managed 字元陣列。Copies data from an unmanaged memory pointer to a managed character array.

public:
 static void Copy(IntPtr source, cli::array <char> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, char[] destination, int startIndex, int length);
static member Copy : nativeint * char[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Char(), startIndex As Integer, length As Integer)

參數

source
IntPtr

要複製的來源記憶體指標。The memory pointer to copy from.

destination
Char[]

要複製到其中的陣列。The array to copy to.

startIndex
Int32

複製應該在此處開始之目的地陣列中以零起始的索引。The zero-based index in the destination array where copying should start.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

sourcedestinationstartIndexlengthnullsource, destination, startIndex, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

// Remember that the actual size of System.Char in unmanaged memory is 2.
using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        char[] managedArray = new char[1000];
        managedArray[0] = 'a';
        managedArray[1] = 'b';
        managedArray[2] = 'c';
        managedArray[3] = 'd';
        managedArray[999] = 'Z';

        // Initialize unmanaged memory to hold the array.
        // int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;  // Incorrect
        int size = Marshal.SystemDefaultCharSize * managedArray.Length;       // Correct


        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            char[] managedArray2 = new char[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
            Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}",
                               managedArray2[0], managedArray2[1], managedArray2[2], managedArray2[3],
                               managedArray2[999]);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }



    }

}
' Remember that the actual size of System.Char in unmanaged memory is 2.

Imports System.Runtime.InteropServices



Module Module1

    Sub Main()
        ' Create a managed array.
        Dim managedArray As Char() = New Char(999) {}
        managedArray(0) = "a"c
        managedArray(1) = "b"c
        managedArray(2) = "c"c
        managedArray(3) = "d"c
        managedArray(999) = "Z"c

        ' Initialize unmanaged memory to hold the array.
        ' Dim size As Integer = Marshal.SizeOf(managedArray[0]) * managedArray.Length;  ' Incorrect
        Dim size As Integer = Marshal.SystemDefaultCharSize * managedArray.Length       ' Correct

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.

            Dim managedArray2 As Char() = New Char(managedArray.Length - 1) {}

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
            Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}", managedArray2(0), managedArray2(1), managedArray2(2), managedArray2(3), managedArray2(999))


            Console.WriteLine("The array was copied to unmanaged memory and back.")
        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)

        End Try
    End Sub
End Module

備註

非受控的 C 樣式陣列不包含界限資訊,可防止驗證 startIndexlength 參數。Unmanaged, C-style arrays do not contain bounds information, which prevents the startIndex and length parameters from being validated. 因此,對應至 source 參數的非受控資料會填入 managed 陣列,不論其實用性為何。Thus, the unmanaged data corresponding to the source parameter populates the managed array regardless of its usefulness. 在呼叫這個方法之前,您必須使用適當的大小來初始化 managed 陣列。You must initialize the managed array with the appropriate size before calling this method.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

另請參閱

Copy(Double[], Int32, IntPtr, Int32)

從一維、Managed 雙精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed double-precision floating-point number array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <double> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (double[] source, int startIndex, IntPtr destination, int length);
static member Copy : double[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Double(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Double[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

sourcestartIndexdestinationlengthnullsource, startIndex, destination, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        double[] managedArray = { 0.1, 0.2, 0.3, 0.4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            double[] managedArray2 = new double[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Double() = {0.1, 0.2, 0.3, 0.4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Double

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(Char[], Int32, IntPtr, Int32)

從一維、Managed 字元陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed character array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <char> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (char[] source, int startIndex, IntPtr destination, int length);
static member Copy : char[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Char(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Char[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

startIndexdestinationlengthnullstartIndex, destination, or length is null.

範例

下列範例會將陣列複製到未受管理的記憶體,然後將非受控陣列複製回受控記憶體。The following example copies an array to unmanaged memory and then copies the unmanaged array back to managed memory.

// Remember that the actual size of System.Char in unmanaged memory is 2.
using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        char[] managedArray = new char[1000];
        managedArray[0] = 'a';
        managedArray[1] = 'b';
        managedArray[2] = 'c';
        managedArray[3] = 'd';
        managedArray[999] = 'Z';

        // Initialize unmanaged memory to hold the array.
        // int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;  // Incorrect
        int size = Marshal.SystemDefaultCharSize * managedArray.Length;       // Correct


        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            char[] managedArray2 = new char[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
            Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}",
                               managedArray2[0], managedArray2[1], managedArray2[2], managedArray2[3],
                               managedArray2[999]);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }



    }

}
' Remember that the actual size of System.Char in unmanaged memory is 2.

Imports System.Runtime.InteropServices



Module Module1

    Sub Main()
        ' Create a managed array.
        Dim managedArray As Char() = New Char(999) {}
        managedArray(0) = "a"c
        managedArray(1) = "b"c
        managedArray(2) = "c"c
        managedArray(3) = "d"c
        managedArray(999) = "Z"c

        ' Initialize unmanaged memory to hold the array.
        ' Dim size As Integer = Marshal.SizeOf(managedArray[0]) * managedArray.Length;  ' Incorrect
        Dim size As Integer = Marshal.SystemDefaultCharSize * managedArray.Length       ' Correct

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.

            Dim managedArray2 As Char() = New Char(managedArray.Length - 1) {}

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
            Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}", managedArray2(0), managedArray2(1), managedArray2(2), managedArray2(3), managedArray2(999))


            Console.WriteLine("The array was copied to unmanaged memory and back.")
        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)

        End Try
    End Sub
End Module

備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

Copy(Byte[], Int32, IntPtr, Int32)

從一維、Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列將資料複製到 Unmanaged 記憶體指標。Copies data from a one-dimensional, managed 8-bit unsigned integer array to an unmanaged memory pointer.

public:
 static void Copy(cli::array <System::Byte> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (byte[] source, int startIndex, IntPtr destination, int length);
static member Copy : byte[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Byte(), startIndex As Integer, destination As IntPtr, length As Integer)

參數

source
Byte[]

要複製的一維陣列。The one-dimensional array to copy from.

startIndex
Int32

複製應該在此處開始之來源陣列中以零起始的索引。The zero-based index in the source array where copying should start.

destination
IntPtr

要複製到的記憶體指標。The memory pointer to copy to.

length
Int32

要複製的陣列元素數目。The number of array elements to copy.

屬性

例外狀況

startIndexlength 無效。startIndex and length are not valid.

sourcestartIndexdestinationlengthnullsource, startIndex, destination, or length is null.

範例

下列範例會使用 Copy(Byte[], Int32, IntPtr, Int32) 多載,將陣列複製到非受控記憶體,然後使用 Copy(IntPtr, Byte[], Int32, Int32) 多載將不受管理的陣列複製回 managed 記憶體。The following example copies an array to unmanaged memory by using the Copy(Byte[], Int32, IntPtr, Int32) overload, and then copies the unmanaged array back to managed memory by using the Copy(IntPtr, Byte[], Int32, Int32) overload.

using System;
using System.Runtime.InteropServices;

class Example
{

    static void Main()
    {
        // Create a managed array.
        byte[] managedArray = { 1, 2, 3, 4 };

        // Initialize unmanaged memory to hold the array.
        int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;

        IntPtr pnt = Marshal.AllocHGlobal(size);

        try
        {
            // Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length);

            // Copy the unmanaged array back to another managed array.

            byte[] managedArray2 = new byte[managedArray.Length];

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);

            Console.WriteLine("The array was copied to unmanaged memory and back.");

        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
        


    }

}
Imports System.Runtime.InteropServices



Module Example


    Sub Main()
        ' Create a managed array.
        Dim managedArray As Byte() = {1, 2, 3, 4}

        ' Initialize unmanaged memory to hold the array.
        Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length

        Dim pnt As IntPtr = Marshal.AllocHGlobal(size)

        Try
            ' Copy the array to unmanaged memory.
            Marshal.Copy(managedArray, 0, pnt, managedArray.Length)

            ' Copy the unmanaged array back to another managed array.
            Dim managedArray2(managedArray.Length) As Byte

            Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)

            Console.WriteLine("The array was copied to unmanaged memory and back.")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module


備註

您可以使用這個方法,將一維 managed 陣列的子集複製到非受控的 C 樣式陣列。You can use this method to copy a subset of a one-dimensional managed array to an unmanaged C-style array.

安全性

SecurityCriticalAttribute
需要完全信任立即呼叫者。requires full trust for the immediate caller. 部分信任或透明的程式碼無法使用這個成員。This member cannot be used by partially trusted or transparent code.

適用於