DataObject
Wisej.Web.DataObject
Last updated
Wisej.Web.DataObject
Last updated
Namespace: Wisej.Web
Assembly: Wisej.Framework (3.1.0.0)
Implements a basic data transfer mechanism.
Initializes a new instance of the DataObject class.
Initializes a new instance of the DataObject class and adds the specified object to it.
| Name | Type | Description |
|---|---|---|
data | The data to store. |
Initializes a new instance of the DataObject class and adds the specified object in the specified format.
| Name | Type | Description |
|---|---|---|
format | The format of the specified data. See DataFormats for predefined formats. | |
data | The data to store. |
Initializes a new instance of the DataObject class and adds the specified object in the specified format.
| Name | Type | Description |
|---|---|---|
format | A Type representing the format of the data. | |
data | The data to store. |
Indicates whether the data object contains data in the WaveAudio format.
Returns: Boolean. true if the data object contains audio data; otherwise, false.
Indicates whether the data object contains data that is in the FileDrop format or can be converted to that format.
Returns: Boolean. true if the data object contains a file drop list; otherwise, false.
Indicates whether the data object contains data that is in the Bitmap format or can be converted to that format.
Returns: Boolean. true if the data object contains image data; otherwise, false.
Indicates whether the data object contains data in the UnicodeText format.
Returns: Boolean. true if the data object contains text data; otherwise, false.
Indicates whether the data object contains text data in the format indicated by the specified TextDataFormat value.
| Parameter | Type | Description |
|---|---|---|
format | One of the TextDataFormat values. |
Returns: Boolean. true if the data object contains text data in the specified format; otherwise, false.
Retrieves an audio stream from the data object.
Returns: Stream. A Stream containing audio data or null if the data object does not contain any data in the WaveAudio format.
Returns the data associated with the specified class type format.
Returns: Object. The data associated with the specified format, or null.
Returns the data associated with the specified data format.
| Parameter | Type | Description |
|---|---|---|
format | The format of the data to retrieve. See DataFormats for predefined formats. |
Returns: Object. The data associated with the specified format, or null.
Returns the data associated with the specified data format, using an automated conversion parameter to determine whether to convert the data to the format.
| Parameter | Type | Description |
|---|---|---|
format | The format of the data to retrieve. See DataFormats for predefined formats. | |
autoConvert | true to the convert data to the specified format; otherwise, false. |
Returns: Object. The data associated with the specified format, or null.
Determines whether data stored in this DataObject is associated with, or can be converted to, the specified format.
Returns: Boolean. true if data stored in this DataObject is associated with, or can be converted to, the specified format; otherwise, false.
Returns the data associated with the specified class type format.
Returns: Boolean. The data associated with the specified format, or null.
Determines whether this DataObject contains data in the specified format or, optionally, contains data that can be converted to the specified format.
| Parameter | Type | Description |
|---|---|---|
format | The format to check for. See DataFormats for predefined formats. | |
autoConvert | true to determine whether data stored in this DataObject can be converted to the specified format; false to check whether the data is in the specified format. |
Returns: Boolean. true if the data is in, or can be converted to, the specified format; otherwise, false.
Returns the list of file types from the data object.
Returns: String[]. A string array containing the file types in the data object.
Returns the HttpFileCollection of files uploaded by the client in a drag & drop operation.
Returns: HttpFileCollection. A string array containing the file types in the data object.
Returns a list of all formats that data stored in this DataObject is associated with or can be converted to.
Returns: String[]. An array of type String, containing a list of all formats that are supported by the data stored in this object.
Returns a list of all formats that data stored in this DataObject is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.
| Parameter | Type | Description |
|---|---|---|
autoConvert | true to retrieve all formats that data stored in this DataObject is associated with, or can be converted to; false to retrieve only native data formats. |
Returns: String[]. An array of type String, containing a list of all formats that are supported by the data stored in this object.
Retrieves an image from the data object.
Returns: Image. An Image representing the image data in the data object or null if the data object does not contain any data that is in the Bitmap format or can be converted to that format.
Retrieves text data from the data object in the UnicodeText format.
Returns: String. The text data in the data object or Empty if the data object does not contain data in the UnicodeText format.
Retrieves text data from the data object in the format indicated by the specified TextDataFormat value.
| Parameter | Type | Description |
|---|---|---|
format | One of the TextDataFormat values. |
Returns: String. The text data in the data object or Empty if the data object does not contain data in the specified format.
Adds a Byte array to the data object in the WaveAudio format after converting it to a Stream.
Throws:
ArgumentNullException audioBytes is null.
Adds a Stream to the data object in the WaveAudio format.
Throws:
ArgumentNullException audioStream is null.
Adds the specified object to the DataObject using the object type as the data format.
| Parameter | Type | Description |
|---|---|---|
data | The data to store. |
Adds the specified object to the DataObject using the specified type as the format.
| Parameter | Type | Description |
|---|---|---|
format | A Type representing the format associated with the data. | |
data | The data to store. |
Adds the specified object to the DataObject using the specified format.
| Parameter | Type | Description |
|---|---|---|
format | The format associated with the data. See DataFormats for predefined formats. | |
data | The data to store. |
Adds the specified object to the DataObject using the specified format and indicating whether the data can be converted to another format.
| Parameter | Type | Description |
|---|---|---|
format | The format associated with the data. See DataFormats for predefined formats. | |
autoConvert | true to allow the data to be converted to another format; otherwise, false. | |
data | The data to store. |
Adds a url using DownloadURL format. The specified url is parsed to compose the DownloadURL as: "mime-type:file-name:url".
| Parameter | Type | Description |
|---|---|---|
url | The url to the file to download. | |
fileName | The name of the file to download from the url. |
Adds a collection of file names to the data object in the FileDrop format.
| Parameter | Type | Description |
|---|---|---|
filePaths | A StringCollection containing the file names. |
Throws:
ArgumentNullException filePaths is null.
Adds a collection of file names to the data object in the FileDrop format.
| Parameter | Type | Description |
|---|---|---|
filePaths | A StringCollection containing the file names. |
Throws:
ArgumentNullException filePaths is null.
Adds an Image to the data object in the Bitmap format.
Throws:
ArgumentNullException image is null.
Adds text data to the data object in the UnicodeText format.
| Parameter | Type | Description |
|---|---|---|
textData | The text to add to the data object. |
Throws:
ArgumentNullException textData is null or Empty.
Adds text data to the data object in the format indicated by the specified TextDataFormat value.
| Parameter | Type | Description |
|---|---|---|
textData | The text to add to the data object. | |
format | One of the TextDataFormat values. |
Throws:
ArgumentNullException textData is null or Empty.
| Name | Description |
|---|---|
Provides a format-independent mechanism for transferring data. |
