Ink.Save 方法 (PersistenceFormat)

项目
11/04/2008

将 Ink 对象转换为指定格式，使用默认 CompressionMode 进行保存，并在 Byte 数组中返回二进制数据。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Function Save ( _
    p As PersistenceFormat _
) As Byte()
用法
Dim instance As Ink
Dim p As PersistenceFormat
Dim returnValue As Byte()

returnValue = instance.Save(p)

public byte[] Save(
    PersistenceFormat p
)

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

public byte[] Save(
    PersistenceFormat p
)

public function Save(
    p : PersistenceFormat
) : byte[]

参数

p
类型：Microsoft.Ink.PersistenceFormat
PersistenceFormat 枚举的一个成员，该成员指示保存的墨迹的格式。

返回值

类型：array<System.Byte[]
包含保存的墨迹的 Byte 数组。

备注

试图以 Gif 格式保存空 Ink 对象将生成错误。

备注

如果在 p 参数设置为 Base64InkSerializedFormat 的情况下调用 Save 方法，则返回值是以 null 结尾的字节数组。若要将保存的墨迹写入 XML 文件，请首先从数组移除最后一个字节，然后将数组转换为 8 位 Unicode 转换格式 (UTF-8) 编码的字符串。

示例

在此示例中，InkOverlay 对象的 Ink 对象以 Gif 格式保存到文件中。

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)
        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);
        FS.Write(isf, 0, isf.Length);
    }
}
catch
{
    // handle or rethrow
}