Marshal.Copy Yöntem

Tanım

Yönetilen diziden yönetilmeyen bir bellek işaretçisine veya yönetilmeyen bir bellek işaretçisinden yönetilen bir diziye veri kopyalar.

Aşırı Yüklemeler

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

Tek boyutlu, yönetilen tek duyarlıklı kayan noktalı sayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen tek duyarlıklı kayan noktalı sayı dizisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen IntPtr bir diziye veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen 64 bit imzalı tamsayı dizisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen 32 bit imzalı tamsayı dizisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen 16 bit imzalı tamsayı dizisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen çift duyarlıklı kayan noktalı sayı dizisine veri kopyalar.

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

Tek boyutlu, yönetilen IntPtr bir diziden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen 8 bit imzasız tamsayı dizisine veri kopyalar.

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

Tek boyutlu, yönetilen 64 bit imzalı bir tamsayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Verileri tek boyutlu, yönetilen 32 bit imzalı bir tamsayı dizisinden yönetilmeyen bir bellek işaretçisine kopyalar.

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

Tek boyutlu, yönetilen 16 bit imzalı bir tamsayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Tek boyutlu, yönetilen çift duyarlıklı kayan noktalı sayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Tek boyutlu, yönetilen karakter dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Yönetilmeyen bir bellek işaretçisinden yönetilen karakter dizisine veri kopyalar.

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

Tek boyutlu, yönetilen 8 bit imzasız tamsayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen tek duyarlıklı kayan noktalı sayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (float[] source, int startIndex, IntPtr destination, int length);
public static void Copy (float[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Single[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

source, startIndex, destinationveya length şeklindedir null.

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen tek duyarlıklı kayan noktalı sayı dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, float[] destination, int startIndex, int length);
public static void Copy (IntPtr source, float[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Single[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen IntPtr bir diziye veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, IntPtr[] destination, int startIndex, int length);
public static void Copy (IntPtr source, IntPtr[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination

IntPtr[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. yöntemini çağırmadan Marshal.Copy önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen 64 bit imzalı tamsayı dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, long[] destination, int startIndex, int length);
public static void Copy (IntPtr source, long[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Int64[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresinesource karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen 32 bit imzalı tamsayı dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, int[] destination, int startIndex, int length);
public static void Copy (IntPtr source, int[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Int32[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen 16 bit imzalı tamsayı dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, short[] destination, int startIndex, int length);
public static void Copy (IntPtr source, short[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Int16[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen çift duyarlıklı kayan noktalı sayı dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, double[] destination, int startIndex, int length);
public static void Copy (IntPtr source, double[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Double[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen IntPtr bir diziden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr[] source, int startIndex, IntPtr destination, int length);
public static void Copy (IntPtr[] source, int startIndex, IntPtr destination, int length);

Parametreler

source

IntPtr[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Açıklamalar

Tek boyutlu yönetilen IntPtr bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen 8 bit imzasız tamsayı dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, byte[] destination, int startIndex, int length);
public static void Copy (IntPtr source, byte[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Byte[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen 64 bit imzalı bir tamsayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (long[] source, int startIndex, IntPtr destination, int length);
public static void Copy (long[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Int64[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

source, startIndex, destinationveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Verileri tek boyutlu, yönetilen 32 bit imzalı bir tamsayı dizisinden yönetilmeyen bir bellek işaretçisine kopyalar.

[System.Security.SecurityCritical]
public static void Copy (int[] source, int startIndex, IntPtr destination, int length);
public static void Copy (int[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Int32[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

startIndex veya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen 16 bit imzalı bir tamsayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (short[] source, int startIndex, IntPtr destination, int length);
public static void Copy (short[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Int16[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

source, startIndex, destinationveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen çift duyarlıklı kayan noktalı sayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (double[] source, int startIndex, IntPtr destination, int length);
public static void Copy (double[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Double[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

source, startIndex, destinationveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen karakter dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (char[] source, int startIndex, IntPtr destination, int length);
public static void Copy (char[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Char[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

startIndex, destinationveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

// 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);
        }
    }
}

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Yönetilmeyen bir bellek işaretçisinden yönetilen karakter dizisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (IntPtr source, char[] destination, int startIndex, int length);
public static void Copy (IntPtr source, char[] destination, int startIndex, int length);

Parametreler

source
IntPtr

Kopyalanacak bellek işaretçisi.

destination
Char[]

Kopyalanacak dizi.

startIndex
Int32

Hedef dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

source, destination, startIndexveya length şeklindedir null.

Örnekler

Aşağıdaki örnek bir diziyi yönetilmeyen belleğe kopyalar ve ardından yönetilmeyen diziyi yönetilen belleğe geri kopyalar.

// 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);
        }
    }
}

Açıklamalar

Yönetilmeyen C stili diziler, ve length parametrelerinin startIndex doğrulanmasını engelleyen sınır bilgileri içermez. Bu nedenle, parametresine source karşılık gelen yönetilmeyen veriler, kullanışlılığına bakılmaksızın yönetilen diziyi doldurur. Bu yöntemi çağırmadan önce yönetilen diziyi uygun boyutla başlatmanız gerekir.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
Marshal.cs
Kaynak:
Marshal.cs
Kaynak:
Marshal.cs

Tek boyutlu, yönetilen 8 bit imzasız tamsayı dizisinden yönetilmeyen bir bellek işaretçisine veri kopyalar.

[System.Security.SecurityCritical]
public static void Copy (byte[] source, int startIndex, IntPtr destination, int length);
public static void Copy (byte[] source, int startIndex, IntPtr destination, int length);

Parametreler

source
Byte[]

Kopyalanacak tek boyutlu dizi.

startIndex
Int32

Kaynak dizide kopyalamanın başlaması gereken sıfır tabanlı dizin.

destination
IntPtr

Kopyalanacak bellek işaretçisi.

length
Int32

Kopyalanacak dizi öğelerinin sayısı.

Öznitelikler

Özel durumlar

startIndex ve length geçerli değildir.

source, startIndex, destinationveya length şeklindedir null.

Örnekler

Aşağıdaki örnek, aşırı yüklemeyi kullanarak Copy(Byte[], Int32, IntPtr, Int32) bir diziyi yönetilmeyen belleğe kopyalar ve ardından aşırı yüklemeyi kullanarak yönetilmeyen diziyi Copy(IntPtr, Byte[], Int32, Int32) yönetilen belleğe geri kopyalar.

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);
        }
    }
}

Açıklamalar

Tek boyutlu yönetilen bir dizinin alt kümesini yönetilmeyen C stili bir diziye kopyalamak için bu yöntemi kullanabilirsiniz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0