Ink.Save 方法 (PersistenceFormat, CompressionMode)

發行項
10/29/2008

將 Ink 物件轉換成指定格式、藉由使用指定的壓縮格式進行儲存，並以 Byte 陣列的方式傳回二進位資料。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Function Save ( _
    p As PersistenceFormat, _
    c As CompressionMode _
) As Byte()
'用途
Dim instance As Ink
Dim p As PersistenceFormat
Dim c As CompressionMode
Dim returnValue As Byte()

returnValue = instance.Save(p, c)

public byte[] Save(
    PersistenceFormat p,
    CompressionMode c
)

public:
array<unsigned char>^ Save(
    PersistenceFormat p, 
    CompressionMode c
)

public byte[] Save(
    PersistenceFormat p,
    CompressionMode c
)

public function Save(
    p : PersistenceFormat, 
    c : CompressionMode
) : byte[]

參數

p
型別：Microsoft.Ink.PersistenceFormat
PersistenceFormat 列舉型別的成員，表示所保存筆墨的格式。

c
型別：Microsoft.Ink.CompressionMode
CompressionMode 列舉型別的成員，表示所保存筆墨的壓縮模式。

傳回值

型別：array<System.Byte[]
Byte 陣列，包含保存的筆墨。

備註

嘗試以 Gif 格式儲存空白的 Ink 物件，會產生錯誤。

注意事項：
呼叫 Save 方法並將 p 參數設為 Base64InkSerializedFormat 時，傳回值是以 null 結尾的位元組陣列。若要將儲存的筆墨寫入 XML 檔案，請先移除陣列中最後一個位元組，然後才將陣列轉換成 8 位元 Unicode 轉換格式 (UTF-8) 編碼的字串。

範例

在這個範例中，會以 Gif 格式將 InkOverlay 物件的 Ink 物件儲存到檔案中。CompressionMode 是設為 NoCompression。

Try
    ' FILE_NAME is a class level const
    Using FS As FileStream = New FileStream(FILE_NAME, FileMode.Create)
        Dim isf As Byte() = mInkOverlay.Ink.Save(PersistenceFormat.Gif, CompressionMode.NoCompression)
        FS.Write(isf, 0, isf.Length)
    End Using

Catch
    ' handle or rethrow
End Try

try
{
    // FILE_NAME is a class level const
    using (FileStream FS = new FileStream(FILE_NAME, FileMode.Create))
    {
        byte[] isf = mInkOverlay.Ink.Save(PersistenceFormat.Gif, CompressionMode.NoCompression);
        FS.Write(isf, 0, isf.Length);
    }
}
catch
{
    // handle or rethrow
}