BitmapFrame.Create Methode

Referenz

Definition

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt auf der Grundlage der angegebenen Argumente einen neuen BitmapFrame.

Überlädt

Create(Stream)	Erstellt einen neuen BitmapFrame aus einer bestimmten Stream.
Create(Uri)	Erstellt einen neuen BitmapFrame aus einer bestimmten Uri.
Create(BitmapSource)	Erstellt einen neuen BitmapFrame aus einer bestimmten BitmapSource.
Create(Uri, RequestCachePolicy)	Erstellt einen BitmapFrame aus einem angegebenen Uri mit der angegebenen RequestCachePolicy.
Create(BitmapSource, BitmapSource)	Erstellt einen neuen BitmapFrame mit der angegebenen Miniaturansicht aus einer angegebenen BitmapSource.
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Erstellt einen neuen BitmapFrame aus einem angegebenen Stream mit den angegebenen BitmapCreateOptions und der angegebenen BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Erstellt einen BitmapFrame aus einem angegebenen Uri mit den angegebenen BitmapCreateOptions und der angegebenen BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Erstellt einen BitmapFrame aus einem angegebenen Uri mit den angegebenen BitmapCreateOptions, der angegebenen BitmapCacheOption und der angegebenen RequestCachePolicy.
Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)	Erstellt einen neuen BitmapFrame aus einer bestimmten BitmapSource mit der angegebenen Miniaturansicht, den angegebenen BitmapMetadata und dem angegebenen ColorContext.

Create(Stream)

Erstellt einen neuen BitmapFrame aus einer bestimmten Stream.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::IO::Stream ^ bitmapStream);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.IO.Stream bitmapStream);

static member Create : System.IO.Stream -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapStream As Stream) As BitmapFrame

Parameter

bitmapStream: Stream

Der Stream, der zum Erstellen des BitmapFrame verwendet wird.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einer bestimmten Stream.

Hinweise

Kann bitmapStream nur geschlossen werden, wenn die Cacheoption verwendet wird, nachdem der OnLoad Frame erstellt wurde. Die Standardcacheoption OnDemand behält den Stream bei, bis der Frame benötigt wird. Verwenden Sie die Create(Stream, BitmapCreateOptions, BitmapCacheOption) -Methode, um Die Optionen zum Erstellen und Zwischenspeichern anzugeben.

Gilt für:

Create(Uri)

Erstellt einen neuen BitmapFrame aus einer bestimmten Uri.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri);

static member Create : Uri -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri) As BitmapFrame

Parameter

bitmapUri: Uri

Der Uri, der die Quelle des BitmapFrame identifiziert.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einer bestimmten Uri.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, BitmapFrame wie aus einer bestimmten Urierstellt wird.

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

Gilt für:

Create(BitmapSource)

Erstellt einen neuen BitmapFrame aus einer bestimmten BitmapSource.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source);

static member Create : System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource) As BitmapFrame

Parameter

source: BitmapSource

Die BitmapSource, mit der dieser BitmapFrame erstellt wird.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einer bestimmten BitmapSource.

Gilt für:

Create(Uri, RequestCachePolicy)

Erstellt einen BitmapFrame aus einem angegebenen Uri mit der angegebenen RequestCachePolicy.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Net.Cache.RequestCachePolicy uriCachePolicy);

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

Public Shared Function Create (bitmapUri As Uri, uriCachePolicy As RequestCachePolicy) As BitmapFrame

Parameter

bitmapUri: Uri

Der Speicherort der Bitmap, anhand derer der BitmapFrame erstellt wird.

uriCachePolicy: RequestCachePolicy

Die Zwischenspeicheranforderungen für diesen BitmapFrame.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einem angegebenen Uri mit der angegebenen RequestCachePolicy

Hinweise

Create(Uri, RequestCachePolicy)wird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für:

Create(BitmapSource, BitmapSource)

Erstellt einen neuen BitmapFrame mit der angegebenen Miniaturansicht aus einer angegebenen BitmapSource.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource) As BitmapFrame

Parameter

source: BitmapSource

Die Quelle, aus der der BitmapFrame erstellt wird.

thumbnail: BitmapSource

Eine Miniaturansicht des resultierenden BitmapFrame-Elements.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einem angegebenen BitmapSource mit der angegebenen Miniaturansicht und.

Gilt für:

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Erstellt einen neuen BitmapFrame aus einem angegebenen Stream mit den angegebenen BitmapCreateOptions und der angegebenen BitmapCacheOption.

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

public static System.Windows.Media.Imaging.BitmapFrame 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.BitmapFrame

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

Parameter

bitmapStream: Stream

Der Stream, aus dem der BitmapFrame erstellt wird.

createOptions: BitmapCreateOptions

Die Optionen, die zum Erstellen des BitmapFrame verwendet werden.

cacheOption: BitmapCacheOption

Die zum Erstellen des BitmapFrame verwendete Zwischenspeicherungsoption.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einem angegebenen Stream mit der angegebenen BitmapCreateOptions und BitmapCacheOption.

Hinweise

Verwenden Sie die OnLoad Cacheoption, wenn Sie die nach der bitmapStream Erstellung der Bitmap schließen möchten. Die Standardcacheoption OnDemand behält den Zugriff auf den Stream bei, bis die Bitmap benötigt wird und die Bereinigung vom Garbage Collector verarbeitet wird.

Gilt für:

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Erstellt einen BitmapFrame aus einem angegebenen Uri mit den angegebenen BitmapCreateOptions und der angegebenen BitmapCacheOption.

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

public static System.Windows.Media.Imaging.BitmapFrame 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.BitmapFrame

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

Parameter

bitmapUri: Uri

Der Speicherort der Bitmap, anhand derer der BitmapFrame erstellt wird.

createOptions: BitmapCreateOptions

Die Optionen, die zum Erstellen des BitmapFrame verwendet werden.

cacheOption: BitmapCacheOption

Die zum Erstellen des BitmapFrame verwendete Zwischenspeicherungsoption.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einem angegebenen Uri mit der angegebenen BitmapCreateOptions und BitmapCacheOption.

Gilt für:

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Erstellt einen BitmapFrame aus einem angegebenen Uri mit den angegebenen BitmapCreateOptions, der angegebenen BitmapCacheOption und der angegebenen RequestCachePolicy.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ 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.BitmapFrame 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.BitmapFrame

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

Parameter

bitmapUri: Uri

Der Speicherort der Bitmap, anhand derer der BitmapFrame erstellt wird.

createOptions: BitmapCreateOptions

Die Optionen, die zum Erstellen des BitmapFrame verwendet werden.

cacheOption: BitmapCacheOption

Die zum Erstellen des BitmapFrame verwendete Zwischenspeicherungsoption.

uriCachePolicy: RequestCachePolicy

Die Zwischenspeicheranforderungen für diesen BitmapFrame.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einem angegebenen Uri mit der angegebenen BitmapCreateOptions, BitmapCacheOption und RequestCachePolicy.

Hinweise

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)wird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für:

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Erstellt einen neuen BitmapFrame aus einer bestimmten BitmapSource mit der angegebenen Miniaturansicht, den angegebenen BitmapMetadata und dem angegebenen ColorContext.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail, System::Windows::Media::Imaging::BitmapMetadata ^ metadata, System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Media::ColorContext ^> ^ colorContexts);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail, System.Windows.Media.Imaging.BitmapMetadata metadata, System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> colorContexts);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapMetadata * System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource, metadata As BitmapMetadata, colorContexts As ReadOnlyCollection(Of ColorContext)) As BitmapFrame

Parameter

source: BitmapSource

Die BitmapSource, mit der dieser BitmapFrame erstellt wird.

thumbnail: BitmapSource

Eine Miniaturansicht des resultierenden BitmapFrame-Elements.

metadata: BitmapMetadata

Die Metadaten, die diesem BitmapFrame zugeordnet werden sollen.

colorContexts: ReadOnlyCollection<ColorContext>

Die ColorContext-Objekte, die diesem BitmapFrame zugeordnet sind.

Gibt zurück

BitmapFrame

Ein BitmapFrame aus einer bestimmten BitmapSource mit der angegebenen Miniaturansicht, den angegebenen BitmapMetadata und dem angegebenen ColorContext.

Gilt für:

Freigeben über

BitmapFrame.Create Methode

Definition

Überlädt

Create(Stream)

Parameter

Gibt zurück

Hinweise

Gilt für:

Create(Uri)

Parameter

Gibt zurück

Beispiele

Gilt für:

Create(BitmapSource)

Parameter

Gibt zurück

Gilt für:

Create(Uri, RequestCachePolicy)

Parameter

Gibt zurück

Hinweise

Gilt für:

Create(BitmapSource, BitmapSource)

Parameter

Gibt zurück

Gilt für:

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Parameter

Gibt zurück

Hinweise

Gilt für:

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Parameter

Gibt zurück

Gilt für:

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Parameter

Gibt zurück

Hinweise

Gilt für:

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Parameter

Gibt zurück

Gilt für:

Zusätzliche Ressourcen