JpegBitmapDecoder Конструкторы

Определение

Пространство имен:

System.Windows.Media.Imaging

Сборка:

PresentationCore.dll

Инициализирует новый экземпляр класса JpegBitmapDecoder.

Перегрузки

JpegBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	Инициализирует новый экземпляр JpegBitmapDecoder из заданного файлового потока с указанными параметрами createOptions и cacheOption.
JpegBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	Инициализирует новый экземпляр JpegBitmapDecoder из заданного объекта Uri указанными параметрами createOptions и cacheOption.

JpegBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

Инициализирует новый экземпляр JpegBitmapDecoder из заданного файлового потока с указанными параметрами createOptions и cacheOption.

public:
 JpegBitmapDecoder(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

[System.Security.SecurityCritical]
public JpegBitmapDecoder (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

public JpegBitmapDecoder (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.JpegBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder

new System.Windows.Media.Imaging.JpegBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder

Public Sub New (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

Параметры

bitmapStream

Stream

Декодируемый поток растрового изображения.

createOptions

BitmapCreateOptions

Параметры инициализации растрового изображения.

cacheOption

BitmapCacheOption

Метод кэширования, предназначенный для использования применительно к растровому изображению.

Атрибуты

SecurityCriticalAttribute

Исключения

ArgumentNullException

Значение bitmapStream равно null.

FileFormatException

Изображение bitmapStream не является совместным фотографическим экспертным группой (JPEG).

Примеры

В следующем примере кода показано, как создать экземпляр и использовать его JpegBitmapDecoder из файлового потока. Декодированные изображения используются в качестве источника Image элемента управления.

// Open a Stream and decode a JPEG image
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.jpg", FileMode::Open, FileAccess::Read, FileShare::Read);
JpegBitmapDecoder^ decoder = gcnew JpegBitmapDecoder(imageStreamSource, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource = decoder->Frames[0];

// Draw the Image
Image^ myImage = gcnew Image();
myImage->Source = bitmapSource;
myImage->Stretch = Stretch::None;
myImage->Margin = System::Windows::Thickness(20);

// Open a Stream and decode a JPEG image
Stream imageStreamSource = new FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read);
JpegBitmapDecoder decoder = new JpegBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage = new Image();
myImage.Source = bitmapSource;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(20);

' Open a Stream and decode a JPEG image
Dim imageStreamSource As New FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New JpegBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage As New Image()
myImage.Source = bitmapSource
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(20)

Комментарии

OnLoad Используйте параметр кэша, если вы хотите закрыть bitmapStream после создания декодера. Параметр кэша по умолчанию OnDemand сохраняет доступ к потоку, пока не потребуется растровое изображение и очистка не будет обработана сборщиком мусора.

JpegBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

Инициализирует новый экземпляр JpegBitmapDecoder из заданного объекта Uri указанными параметрами createOptions и cacheOption.

public:
 JpegBitmapDecoder(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

[System.Security.SecurityCritical]
public JpegBitmapDecoder (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

public JpegBitmapDecoder (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.JpegBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder

new System.Windows.Media.Imaging.JpegBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder

Public Sub New (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

Параметры

bitmapUri

Uri

Объект Uri, определяющий декодируемое растровое изображение.

createOptions

BitmapCreateOptions

Параметры инициализации растрового изображения.

cacheOption

BitmapCacheOption

Метод кэширования, предназначенный для использования применительно к растровому изображению.

Атрибуты

SecurityCriticalAttribute

Исключения

ArgumentNullException

Значение bitmapUri равно null.

FileFormatException

Изображение bitmapUri не является совместным фотографическим экспертным группой (JPEG).

Примеры

В следующем примере кода показано, как создать экземпляр и использовать его JpegBitmapDecoder на основе Uri. Декодированные изображения используются в качестве источника Image элемента управления.

// Open a Uri and decode a JPEG image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.jpg", UriKind::RelativeOrAbsolute);
JpegBitmapDecoder^ decoder2 = gcnew JpegBitmapDecoder(myUri, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource2 = decoder2->Frames[0];

// Draw the Image
Image^ myImage2 = gcnew Image();
myImage2->Source = bitmapSource2;
myImage2->Stretch = Stretch::None;
myImage2->Margin = System::Windows::Thickness(20);

// Open a Uri and decode a JPEG image
Uri myUri = new Uri("tulipfarm.jpg", UriKind.RelativeOrAbsolute);
JpegBitmapDecoder decoder2 = new JpegBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource2 = decoder2.Frames[0];

// Draw the Image
Image myImage2 = new Image();
myImage2.Source = bitmapSource2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);

' Open a Uri and decode a JPEG image
Dim myUri As New Uri("tulipfarm.jpg", UriKind.RelativeOrAbsolute)
Dim decoder2 As New JpegBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource2 As BitmapSource = decoder2.Frames(0)

' Draw the Image
Dim myImage2 As New Image()
myImage2.Source = bitmapSource2
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)

Комментарии

Исключение возникает, если декодер не может загрузить указанный bitmapUri.