BitmapImage.BeginInit Method

Definition

表示 BitmapImage 初始化開始。Signals the start of the BitmapImage initialization.

public:
 virtual void BeginInit();
public void BeginInit ();
abstract member BeginInit : unit -> unit
override this.BeginInit : unit -> unit
Public Sub BeginInit ()

Implements

Exceptions

BitmapImage 目前正在起始。The BitmapImage is currently being initialized. 已經呼叫 BeginInit()BeginInit() has already been called.

-或--or- BitmapImage 已經完成初始化。The BitmapImage has already been initialized.

Examples

下列範例示範如何使用 BeginInitEndInit 方法,初始化具有一組屬性的 BitmapImageThe following example demonstrates how to initialize a BitmapImage with a set of properties by using the BeginInit and EndInit methods.

// Define a BitmapImage.
Image myImage = new Image();
BitmapImage bi = new BitmapImage();

// Begin initialization.
bi.BeginInit();

// Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand;
bi.CreateOptions = BitmapCreateOptions.DelayCreation;
bi.DecodePixelHeight = 125;
bi.DecodePixelWidth = 125;
bi.Rotation = Rotation.Rotate90;
MessageBox.Show(bi.IsDownloading.ToString());
bi.UriSource = new Uri("smiley.png", UriKind.Relative);

// End initialization.
bi.EndInit();
myImage.Source = bi;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(5);
' Define a BitmapImage.
Dim myImage As New Image()
Dim bi As New BitmapImage()

' Begin initialization.
bi.BeginInit()

' Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand
bi.CreateOptions = BitmapCreateOptions.DelayCreation
bi.DecodePixelHeight = 125
bi.DecodePixelWidth = 125
bi.Rotation = Rotation.Rotate90
MessageBox.Show(bi.IsDownloading.ToString())
bi.UriSource = New Uri("smiley.png", UriKind.Relative)

' End initialization.
bi.EndInit()
myImage.Source = bi
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(5)

Remarks

必須在 BeginInitEndInit 呼叫之間進行屬性初始化。Property initialization must be done between BeginInit and EndInit calls. 一旦初始化 BitmapImage,就會忽略屬性變更。Once the BitmapImage has been initialized, property changes are ignored.

Applies to

See also