Save(Stream) Method (DeviceCapabilityCollection)

In This Topic

Saves information about current values of capabilites to the stream.

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration

Public Sub Save( _
   ByVal streamStream to save the current values of capabilities.
 As System.IO.Stream _
)

public void Save(
   System.IO.Stream stream
)

public: void Save(
   System.IO.Stream* stream
)

public:
void Save(
   System.IO.Stream^ stream
)

Parameters

stream: Stream to save the current values of capabilities.

Exceptions

Exception	Description
System.ArgumentNullException	Thrown if stream is null (Nothing in VB).
System.ArgumentException	Thrown if the stream does not support writing.
TwainInvalidStateException	Thrown if device is in wrong state.
TwainDeviceCapabilityException	Thrown if device does not support capability.
DebuggerException	Thrown if the .NET debugger is used and the function evaluation requires all threads to run.

Remarks

The method ignores the "custom" capabilities, i.e. capabilities, which are added using the Add(UInt16) method.

Example

This C#/VB.NET code shows how to save values of current device capabilities to a file.

VB.NET


''' <summary>
''' Saves the device capability collection to a file.
''' </summary>
Public Shared Sub SaveDeviceCapabilityCollection(device As Vintasoft.Twain.Device)
        ' open the device
        device.Open()
        ' open file
        Using fs As New System.IO.FileStream("scanner-capabilities.xml", System.IO.FileMode.Append, System.IO.FileAccess.Write)
                ' save the device capability collection to a file
                device.Capabilities.Save(fs)
        End Using
End Sub


/// <summary>
/// Saves the device capability collection to a file.
/// </summary>
public static void SaveDeviceCapabilityCollection(Vintasoft.Twain.Device device)
{
    // open the device
    device.Open();
    // open file
    using (System.IO.FileStream fs = new System.IO.FileStream("scanner-capabilities.xml", System.IO.FileMode.Append, System.IO.FileAccess.Write))
    {
        // save the device capability collection to a file
        device.Capabilities.Save(fs);
    }
}

Requirements

Target Platforms: .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Reference

DeviceCapabilityCollection Class
DeviceCapabilityCollection Members

Load(Stream)

Send Feedback