Metodo Ink.Save (PersistenceFormat, CompressionMode)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Converte l'oggetto Ink nel formato specificato, lo salva utilizzando il formato di compressione specificato e restituisce i dati binari in una matrice Byte.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

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

Parametri

p
Tipo: Microsoft.Ink.PersistenceFormat
Membro dell'enumerazione PersistenceFormat che indica il formato dell'input penna persistente.

c
Tipo: Microsoft.Ink.CompressionMode
Membro dell'enumerazione CompressionMode che specifica la modalità di compressione dell'input penna persistente.

Valore restituito

Tipo: array<System.Byte[]
Matrice Byte contenente l'input penna persistente.

Note

Il tentativo di salvare un oggetto Ink vuoto in formato Gif genera un errore.

Nota

Quando si chiama il metodo Save con il parametro p impostato suBase64InkSerializedFormat, il valore restituito è una matrice di byte con terminazione null. Per scrivere l'input penna salvato in un file XML, rimuovere innanzitutto l'ultimo byte dalla matrice prima di convertire la matrice in una stringa con codifica UTF-8 (Unicode Transformation Format) a 8 bit .

Esempi

In questo esempio, l'oggetto Ink di un oggetto InkOverlay viene salvato in un file nel formato Gif. La proprietà CompressionMode è impostata su 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
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.