This documentation is archived and is not being maintained.

WriteableBitmap.WritePixels Method (Int32Rect, Array, Int32, Int32, Int32)

Updates the pixels in the specified region of the bitmap.

Namespace:  System.Windows.Media.Imaging
Assembly:  PresentationCore (in PresentationCore.dll)

public void WritePixels(
	Int32Rect sourceRect,
	Array sourceBuffer,
	int sourceBufferStride,
	int destinationX,
	int destinationY
)
You cannot use methods in XAML.

Parameters

sourceRect
Type: System.Windows.Int32Rect

The rectangle in sourceBuffer to copy.

sourceBuffer
Type: System.Array

The input buffer used to update the bitmap.

sourceBufferStride
Type: System.Int32

The stride of the input buffer, in bytes.

destinationX
Type: System.Int32

The destination x-coordinate of the left-most pixel in the back buffer.

destinationY
Type: System.Int32

The destination y-coordinate of the top-most pixel in the back buffer.

ExceptionCondition
ArgumentOutOfRangeException

One or more of the following conditions is true.

sourceRect falls outside the bounds of the WriteableBitmap.

destinationX or destinationY is outside the bounds of the WriteableBitmap.

sourceBufferStride < 1

ArgumentNullException

sourceBuffer is null.

ArgumentException

sourceBuffer has a rank other than 1 or 2, or its length is less than or equal to 0.

Call the WritePixels method to update the WriteableBitmap automatically with the contents of sourceBuffer. Calling this method is the equivalent of using the Lock and Unlock workflow described in the WriteableBitmap class remarks.

NoteNote:

Use this overload in partial trust.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5 SP1, 3.0 SP2
Show: