BitmapDecoder.Create Méthode

Définition

Espace de noms:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Crée un BitmapDecoder en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.

Surcharges

Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Crée un BitmapDecoder à partir d'un Stream en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions, le BitmapCacheOption et le RequestCachePolicy spécifiés.

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crée un BitmapDecoder à partir d'un Stream en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.

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

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

static member Create : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapDecoder

Public Shared Function Create (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapDecoder

Paramètres

bitmapStream

Stream

Flux de fichier qui identifie la bitmap à décoder.

createOptions

BitmapCreateOptions

Identifie le BitmapCreateOptions pour ce décodeur.

cacheOption

BitmapCacheOption

Identifie le BitmapCacheOption pour ce décodeur.

Retours

BitmapDecoder

Un BitmapDecoder d'un Stream en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiées.

Exemples

L’exemple suivant montre comment utiliser la Create méthode pour créer un décodeur pour une image donnée. Le premier BitmapFrame de l’image est utilisé comme source d’un Image contrôle.

Stream imageStream = new FileStream("sampleImages/waterlilies.jpg",
   FileMode.Open, FileAccess.Read, FileShare.Read);

BitmapDecoder streamBitmap = BitmapDecoder.Create(
   imageStream, BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image streamImage = new Image();
streamImage.Width = 200;
// Set image source using the first frame.
streamImage.Source = streamBitmap.Frames[0];

Dim imageStream As FileStream = New FileStream("sampleImages/waterlilies.jpg", FileMode.Open, FileAccess.Read, FileShare.Read)

Dim streamBitmap As BitmapDecoder = BitmapDecoder.Create(imageStream, BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim streamImage As New Image()
streamImage.Width = 200
' Set image source using the first frame.
streamImage.Source = streamBitmap.Frames(0)

Remarques

Utilisez l’option OnLoad de cache si vous souhaitez fermer le bitmapStream après la création du décodeur. L’option de cache par défaut OnDemand conserve l’accès au flux jusqu’à ce que la bitmap soit nécessaire et que le nettoyage soit géré par le garbage collector.

Voir aussi

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.

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

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

static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapDecoder

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapDecoder

Paramètres

bitmapUri

Uri

Uri de la bitmap à décoder.

createOptions

BitmapCreateOptions

Identifie le BitmapCreateOptions pour ce décodeur.

cacheOption

BitmapCacheOption

Identifie le BitmapCacheOption pour ce décodeur.

Retours

BitmapDecoder

Un BitmapDecoder d'un Uri en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiées.

Exceptions

ArgumentNullException

bitmapUri a la valeur null.

FileFormatException

Le bitmapUri spécifie un ID de classe d'un type de format non pris en charge.

Exemples

L’exemple suivant montre comment utiliser la Create(Uri, BitmapCreateOptions, BitmapCacheOption) méthode pour créer un décodeur pour une image donnée. Le premier BitmapFrame de l’image est utilisé comme source d’un Image contrôle.

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];

Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

Voir aussi

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions, le BitmapCacheOption et le RequestCachePolicy spécifiés.

public:
 static System::Windows::Media::Imaging::BitmapDecoder ^ Create(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapDecoder Create (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption, System.Net.Cache.RequestCachePolicy uriCachePolicy);

static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapDecoder

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption, uriCachePolicy As RequestCachePolicy) As BitmapDecoder

Paramètres

bitmapUri

Uri

Emplacement de la bitmap à partir de laquelle le BitmapDecoder est créé.

createOptions

BitmapCreateOptions

Options qui sont utilisées pour créer ce BitmapDecoder.

cacheOption

BitmapCacheOption

Option de cache qui est utilisée pour créer ce BitmapDecoder.

uriCachePolicy

RequestCachePolicy

Exigences de mise en cache pour ce BitmapDecoder.

Retours

BitmapDecoder

Un BitmapDecoder d'un Uri en utilisant les BitmapCreateOptions, BitmapCacheOption et RequestCachePolicy spécifiées.

Remarques

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) est introduit dans le .NET Framework version 3.5.