BitmapFrame.CreateInPlaceBitmapMetadataWriter 方法

定義

命名空間:

System.Windows.Media.Imaging

組件:

PresentationCore.dll

在衍生類別中覆寫時，建立 InPlaceBitmapMetadataWriter 的執行個體，這個執行個體可用來建立中繼資料與 BitmapFrame 的關聯。

public:
 abstract System::Windows::Media::Imaging::InPlaceBitmapMetadataWriter ^ CreateInPlaceBitmapMetadataWriter();

public abstract System.Windows.Media.Imaging.InPlaceBitmapMetadataWriter CreateInPlaceBitmapMetadataWriter ();

abstract member CreateInPlaceBitmapMetadataWriter : unit -> System.Windows.Media.Imaging.InPlaceBitmapMetadataWriter

Public MustOverride Function CreateInPlaceBitmapMetadataWriter () As InPlaceBitmapMetadataWriter

傳回

InPlaceBitmapMetadataWriter

InPlaceBitmapMetadataWriter。

範例

下列程式碼範例示範如何使用 BitmapFrame 物件開啟可攜式網狀圖形 (PNG) 圖形，並使用 CreateInPlaceBitmapMetadataWriter 方法撰寫中繼資料。

Stream^ pngStream = gcnew FileStream("smiley.png", FileMode::Open, FileAccess::ReadWrite, FileShare::ReadWrite);
PngBitmapDecoder^ pngDecoder = gcnew PngBitmapDecoder(pngStream, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapFrame^ pngFrame = pngDecoder->Frames[0];
InPlaceBitmapMetadataWriter^ pngInplace = pngFrame->CreateInPlaceBitmapMetadataWriter();
if (pngInplace->TrySave() == true)
{
   pngInplace->SetQuery("/Text/Description", "Have a nice day.");
}
pngStream->Close();

Stream pngStream = new System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite);
PngBitmapDecoder pngDecoder = new PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapFrame pngFrame = pngDecoder.Frames[0];
InPlaceBitmapMetadataWriter pngInplace = pngFrame.CreateInPlaceBitmapMetadataWriter();
if (pngInplace.TrySave() == true)
{ pngInplace.SetQuery("/Text/Description", "Have a nice day."); }
pngStream.Close();

Dim pngStream As New System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite)
Dim pngDecoder As New PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim pngFrame As BitmapFrame = pngDecoder.Frames(0)
Dim pngInplace As InPlaceBitmapMetadataWriter = pngFrame.CreateInPlaceBitmapMetadataWriter()
If pngInplace.TrySave() = True Then
    pngInplace.SetQuery("/Text/Description", "Have a nice day.")
End If
pngStream.Close()

備註

只有當影像檔包含足夠的空間供新中繼資料使用時，才能新增或編輯 CreateInPlaceBitmapMetadataWriter 中繼資料;否則，可以使用 屬性來新增 Metadata 中繼資料。

另請參閱

• Metadata