Ink.Save-Methode (PersistenceFormat, CompressionMode)

Artikel
11/26/2008

Konvertiert das Ink-Objekt in das angegebene Format, speichert es unter Verwendung des angegebenen Komprimierungsformats und gibt die Binärdaten in einem Byte-Array zurück.

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

Syntax

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

Parameter

p
Typ: Microsoft.Ink.PersistenceFormat
Ein Member der PersistenceFormat-Enumeration, mit dem das Format der gespeicherten Freihandeingaben angegeben wird.

c
Typ: Microsoft.Ink.CompressionMode
Ein Member der CompressionMode-Enumeration, mit dem der Komprimierungsmodus für die gespeicherten Freihandeingaben angegeben wird.

Rückgabewert

Typ: array<System.Byte[]
Das Byte-Array, das den beibehaltenen Link enthält.

Hinweise

Der Versuch, ein leeres Ink-Objekt im Gif-Format zu speichern, erzeugt einen Fehler.

Hinweis

Wenn die Save-Methode mit dem p-Parameterwert Base64InkSerializedFormat aufgerufen wird, ergibt sich als Rückgabewert ein nullterminiertes Byte-Array. Um gespeicherte Freihandeingaben in einer XML-Datei zu speichern, müssen Sie das letzte Byte aus dem Array entfernen, bevor Sie das Array in eine UTF-8-codierte Zeichenfolge umwandeln.

Beispiele

In diesem Beispiel wird das Ink-Objekt eines InkOverlay-Objekts in einer Datei im Gif-Format gespeichert. Die CompressionMode-Enumeration wird auf NoCompression festgelegt.

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
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.