Ink.Save, méthode (PersistenceFormat, CompressionMode)

Article
11/05/2008

Mise à jour : November 2007

Convertit l'objet Ink au format spécifié, l'enregistre en utilisant le format de compression spécifié et retourne les données binaires dans un tableau Byte (page pouvant être en anglais).

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

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

Paramètres

p
Type : Microsoft.Ink.PersistenceFormat
Membre de l'énumération PersistenceFormat qui indique le format de l'entrée manuscrite persistante.

c
Type : Microsoft.Ink.CompressionMode
Membre de l'énumération CompressionMode qui spécifie le mode de compression de l'entrée manuscrite persistante.

Valeur de retour

Type : array<System.Byte[]
Tableau Byte (page pouvant être en anglais) qui contient l'entrée manuscrite rendue persistante.

Notes

La tentative d'enregistrement d'un objet Ink vide au format Gif génère une erreur.

Remarque :
Lors de l'appel à la méthode Save avec le paramètre p ayant la valeur Base64InkSerializedFormat, la valeur de retour est un tableau d'octets se terminant par null. Pour écrire l'entrée manuscrite enregistrée dans un fichier XML, supprimez d'abord le dernier octet du tableau avant de convertir le tableau au format UTF-8 (Unicode Transformation Format de 8 bits) (chaîne codée).

Exemples

Dans cet exemple, l'objet Ink d'un objet InkOverlay est enregistré dans un fichier au format Gif. La propriété CompressionMode a la valeur 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
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.