Objects.Add Method

Adds a new object to the list of objects stored in the <ds:Signature> node.

[Visual Basic]
Public Function Add( _
   ByVal Id As String, _
   ByVal MimeType As String, _
   ByVal Encoding As String, _
   ByVal Data As Object _
) As Object

Parameters

Id: An identifier, which is used to identify the <ds:Object> node. This allows the node to be referenced from another location.
MimeType: The mime type of the data that is being added to the object. See the Remarks section.
Encoding: The encoding of the data that is being added to the object. See the Remarks section.
Data: The data that should be added to the object.

Return Value

The newly added object.

Remarks

To sign the object, you have to add reference to it. The following types of source data are supported.
Encoding MimeType Description
base64 (any value) The data is base64 encoded. The following types of data are supported: a byte array, a Data object or a custom object that implements the IStream interface.
(not specified) text/xml or any other XML mime type The data should be an XML document or node. The following types of data are supported: a Data object, an IXmlDomElement, a string, a byte array or a custom object that implements the IStream interface.
(not specified) text/plain The type of data should be a string.
(not specified) (not specified) See the table below.

Encoding	MimeType	Description
base64	(any value)	The data is base64 encoded. The following types of data are supported: a byte array, a Data object or a custom object that implements the `IStream` interface.
(not specified)	text/xml or any other XML mime type	The data should be an XML document or node. The following types of data are supported: a Data object, an `IXmlDomElement`, a string, a byte array or a custom object that implements the `IStream` interface.
(not specified)	text/plain	The type of data should be a string.
(not specified)	(not specified)	See the table below.

When MimeType and Encoding are not specified, data is handled as shown in the next table.

Source data type	Description
A string	The data is handled as a plain text.
An XML element	The data is handled as an XML (IXMLDomElement).
A byte array	The data is handled as a stream of bytes. It is base64 encoded before it is added to the XML.
A Data object	The data is handled as a Data object.
A custom object that implements the `IStream` interface	The data is handled as a custom object.

Some of the objects that implement the IStream interface: ASP Request object, ASP Response object, ADO stream.

Requirements

Requires CreaSign Pro (not supported by CreaSign Lite).

Objects.Add Method

Parameters

Return Value

Remarks

Requirements

See Also