Buffer Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memanipulasi array jenis primitif.
public ref class Buffer abstract sealed
public ref class Buffer sealed
public static class Buffer
public sealed class Buffer
[System.Runtime.InteropServices.ComVisible(true)]
public static class Buffer
type Buffer = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type Buffer = class
Public Class Buffer
Public NotInheritable Class Buffer
- Warisan
-
Buffer
- Atribut
Contoh
Contoh kode berikut mengilustrasikan penggunaan beberapa Buffer metode kelas.
// Example of the Buffer class methods.
using System;
class BufferClassDemo
{
// Display the array elements from right to left in hexadecimal.
public static void DisplayArray( short[ ] arr )
{
Console.Write( " arr:" );
for( int loopX = arr.Length - 1; loopX >= 0; loopX-- )
Console.Write( " {0:X4}", arr[ loopX ] );
Console.WriteLine( );
}
public static void Main( )
{
// This array is to be modified and displayed.
short[ ] arr = { 258, 259, 260, 261, 262, 263, 264,
265, 266, 267, 268, 269, 270, 271 };
Console.WriteLine( "This example of the Buffer class " +
"methods generates the following output.\n" +
"Note: The array is displayed from right to left.\n" );
Console.WriteLine( "Initial values of array:\n" );
// Display the initial array values and ByteLength.
DisplayArray( arr );
Console.WriteLine( "\nBuffer.ByteLength( arr ): {0}",
Buffer.ByteLength( arr ) );
// Copy a region of the array; set a byte within the array.
Console.WriteLine( "\nCall these methods: \n" +
" Buffer.BlockCopy( arr, 5, arr, 16, 9 ),\n" +
" Buffer.SetByte( arr, 7, 170 ).\n" );
Buffer.BlockCopy( arr, 5, arr, 16, 9 );
Buffer.SetByte( arr, 7, 170 );
// Display the array and a byte within the array.
Console.WriteLine( "Final values of array:\n" );
DisplayArray( arr );
Console.WriteLine( "\nBuffer.GetByte( arr, 26 ): {0}",
Buffer.GetByte( arr, 26 ) );
}
}
/*
This example of the Buffer class methods generates the following output.
Note: The array is displayed from right to left.
Initial values of array:
arr: 010F 010E 010D 010C 010B 010A 0109 0108 0107 0106 0105 0104 0103 0102
Buffer.ByteLength( arr ): 28
Call these methods:
Buffer.BlockCopy( arr, 5, arr, 16, 9 ),
Buffer.SetByte( arr, 7, 170 ).
Final values of array:
arr: 010F 0101 0801 0701 0601 0501 0109 0108 0107 0106 AA05 0104 0103 0102
Buffer.GetByte( arr, 26 ): 15
*/
open System
// Display the array elements from right to left in hexadecimal.
let displayArray (arr: int16 []) =
printf " arr:"
for i = arr.Length - 1 downto 0 do
printf $" {arr[i]:X4}"
printfn ""
// This array is to be modified and displayed.
let arr =
[| 258s; 259s; 260s; 261s; 262s; 263s; 264s
265s; 266s; 267s; 268s; 269s; 270s; 271s |]
printfn "This example of the Buffer class methods generates the following output.\nNote: The array is displayed from right to left.\n"
printfn "Initial values of array:\n"
// Display the initial array values and ByteLength.
displayArray arr
printfn $"\nBuffer.ByteLength(arr): {Buffer.ByteLength arr}"
// Copy a region of the array; set a byte within the array.
printfn "\nCall these methods: \n Buffer.BlockCopy(arr, 5, arr, 16, 9),\n Buffer.SetByte(arr, 7, 170).\n"
Buffer.BlockCopy(arr, 5, arr, 16, 9)
Buffer.SetByte(arr, 7, 170uy)
// Display the array and a byte within the array.
printfn "Final values of array:\n"
displayArray arr
printfn $"\nBuffer.GetByte(arr, 26): {Buffer.GetByte(arr, 26)}"
// This example of the Buffer class methods generates the following output.
// Note: The array is displayed from right to left.
//
// Initial values of array:
//
// arr: 010F 010E 010D 010C 010B 010A 0109 0108 0107 0106 0105 0104 0103 0102
//
// Buffer.ByteLength(arr): 28
//
// Call these methods:
// Buffer.BlockCopy(arr, 5, arr, 16, 9),
// Buffer.SetByte(arr, 7, 170).
//
// Final values of array:
//
// arr: 010F 0101 0801 0701 0601 0501 0109 0108 0107 0106 AA05 0104 0103 0102
//
// Buffer.GetByte(arr, 26): 15
' Example of the Buffer class methods.
Module BufferClassDemo
' Display the array elements from right to left in hexadecimal.
Sub DisplayArray( arr( ) As Short )
Console.Write( " arr:" )
Dim loopX As Integer
For loopX = arr.Length - 1 To 0 Step -1
Console.Write( " {0:X4}", arr( loopX ) )
Next loopX
Console.WriteLine( )
End Sub
Sub Main( )
' This array is to be modified and displayed.
Dim arr( ) As Short = { 258, 259, 260, 261, 262, 263, 264, _
265, 266, 267, 268, 269, 270, 271 }
Console.WriteLine( _
"This example of the Buffer class methods generates " & _
"the following output." & vbCrLf & "Note: The " & _
"array is displayed from right to left." & vbCrLf )
Console.WriteLine( "Initial values of array:" & vbCrLf )
' Display the initial array values and ByteLength.
DisplayArray( arr )
Console.WriteLine( vbCrLf & _
"Buffer.ByteLength( arr ): {0}", _
Buffer.ByteLength( arr ) )
' Copy a region of the array; set a byte within the array.
Console.WriteLine( vbCrLf & _
"Call these methods: " & vbCrLf & _
" Buffer.BlockCopy( arr, 5, arr, 16, 9 )," & vbCrLf & _
" Buffer.SetByte( arr, 7, 170 )." & vbCrLf )
Buffer.BlockCopy( arr, 5, arr, 16, 9 )
Buffer.SetByte( arr, 7, 170 )
' Display the array and a byte within the array.
Console.WriteLine( "Final values of array:" & vbCrLf )
DisplayArray( arr )
Console.WriteLine( vbCrLf & _
"Buffer.GetByte( arr, 26 ): {0}", _
Buffer.GetByte( arr, 26 ) )
End Sub
End Module
' This example of the Buffer class methods generates the following output.
' Note: The array is displayed from right to left.
'
' Initial values of array:
'
' arr: 010F 010E 010D 010C 010B 010A 0109 0108 0107 0106 0105 0104 0103 0102
'
' Buffer.ByteLength( arr ): 28
'
' Call these methods:
' Buffer.BlockCopy( arr, 5, arr, 16, 9 ),
' Buffer.SetByte( arr, 7, 170 ).
'
' Final values of array:
'
' arr: 010F 0101 0801 0701 0601 0501 0109 0108 0107 0106 AA05 0104 0103 0102
'
' Buffer.GetByte( arr, 26 ): 15
Keterangan
Buffer hanya memengaruhi array jenis primitif; kelas ini tidak berlaku untuk objek. Setiap jenis primitif diperlakukan sebagai serangkaian byte tanpa memperhatikan perilaku atau batasan apa pun yang terkait dengan jenis primitif.
Buffer menyediakan metode untuk menyalin byte dari satu array jenis primitif ke array jenis primitif lainnya, mendapatkan byte dari array, mengatur byte dalam array, dan mendapatkan panjang array. Kelas ini memberikan performa yang lebih baik untuk memanipulasi jenis primitif daripada metode serupa di System.Array kelas .
Bufferberlaku untuk jenis primitif berikut: Boolean, , Char, SByte, Byte, Int16, UInt16Int32, UInt32, Int64, , UInt64, , IntPtr, , UIntPtr, Singledan Double.
Metode
| Nama | Deskripsi |
|---|---|
| BlockCopy(Array, Int32, Array, Int32, Int32) |
Menyalin jumlah byte tertentu dari array sumber yang dimulai pada offset tertentu ke array tujuan yang dimulai pada offset tertentu. |
| ByteLength(Array) |
Mengembalikan jumlah byte dalam array yang ditentukan. |
| GetByte(Array, Int32) |
Mengambil byte pada lokasi yang ditentukan dalam array yang ditentukan. |
| MemoryCopy(Void*, Void*, Int64, Int64) |
Menyalin sejumlah byte yang ditentukan sebagai nilai bilangan bulat panjang dari satu alamat dalam memori ke alamat lainnya. API ini bukan kompatibel CLS. |
| MemoryCopy(Void*, Void*, UInt64, UInt64) |
Menyalin sejumlah byte yang ditentukan sebagai nilai bilangan bulat panjang yang tidak ditandatangani dari satu alamat dalam memori ke alamat lainnya. API ini bukan kompatibel CLS. |
| SetByte(Array, Int32, Byte) |
Menetapkan nilai yang ditentukan ke byte di lokasi tertentu dalam array tertentu. |