Ink.Save (Método) (PersistenceFormat, CompressionMode)

Artículo
11/26/2008

Actualización: noviembre 2007

Convierte el objeto Ink en el formato especificado, lo guarda mediante el formato de compresión especificado y devuelve los datos binarios en una matriz de bytes.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function Save ( _
    p As PersistenceFormat, _
    c As CompressionMode _
) As Byte()
'Uso
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[]

Parámetros

p
Tipo: Microsoft.Ink.PersistenceFormat
Un miembro de la enumeración PersistenceFormat que indica el formato de las entradas manuscritas almacenadas.

c
Tipo: Microsoft.Ink.CompressionMode
Un miembro de la enumeración CompressionMode que especifica el modo de compresión de las entradas manuscritas almacenadas.

Valor devuelto

Tipo: array<System.Byte[]
La matriz de bytes que contiene las entradas manuscritas almacenadas.

Comentarios

Si intenta guardar un objeto Ink vacío en formato Gif, se genera un error.

Nota

Al llamar al método Save con el parámetro p establecido en Base64InkSerializedFormat, el valor devuelto es una matriz de bytes terminada en null. Para escribir la entrada manuscrita guardada en un archivo XML, primero quite el último byte de la matriz antes de convertir la matriz en una cadena codificada con Formato de transformación Unicode de 8 bits (UTF-8).

Ejemplos

En este ejemplo, el objeto Ink de un objeto InkOverlay se guarda en un archivo en formato Gif. La propiedad CompressionMode se establece en 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
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.