BitmapImage.BeginInit Method
Signals the start of the BitmapImage initialization.
Namespace: System.Windows.Media.Imaging
Assembly: PresentationCore (in PresentationCore.dll)
| Exception | Condition |
|---|---|
| InvalidOperationException | The BitmapImage is currently being initialized. BeginInit has already been called. -or- The BitmapImage has already been initialized. |
Property initialization must be done between BeginInit and EndInit calls. Once the BitmapImage has been initialized, property changes are ignored.
The 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);
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.