Ink.Save Method (PersistenceFormat)

Article
10/19/2012

Converts the Ink object to the specified format, saves it by using the DefaultCompressionMode and returns the binary data in a Byte array.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function Save ( _
    p As PersistenceFormat _
) As Byte()
'Usage
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 function Save(
    p : PersistenceFormat
) : byte[]

Parameters

p
Type: Microsoft.Ink.PersistenceFormat

A member of the PersistenceFormat enumeration that indicates the format of the persisted ink.

Return Value

Type: array<System.Byte[]
The Byte array that contains the persisted ink.

Remarks

Attempting to save an empty Ink object in Gif format generates an error.

Note

When calling the Save method with the p parameter set to Base64InkSerializedFormat, the return value is a null-terminated byte array. To write the saved ink to an XML file, first remove the last byte from the array before converting the array to an 8-bit Unicode Transformation Format (UTF-8)-encoded string.

Examples

In this example, the Ink object of an InkOverlay object is saved to a file in Gif format.

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
}

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via