How to: Retrieve Data in a Particular Data Format

The following examples show how to retrieve data from a data object in a specified format.

Example

Description

The following example code uses the GetDataPresent(String) overload to first check if a specified data format is available (natively or by auto-convert); if the specified format is available, the example retrieves the data by using the GetData(String) method.

Code

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format. 
// This particular overload of GetDataPresent looks for both native and auto-convertible  
// data formats. 
if (dataObject.GetDataPresent(desiredFormat))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the 
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}

Example

Description

The following example code uses the GetDataPresent(String, Boolean) overload to first check if a specified data format is available natively (auto-convertible data formats are filtered); if the specified format is available, the example retrieves the data by using the GetData(String) method.

Code

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format. 
// The autoconvert parameter is set to false to filter out auto-convertible data formats, 
// returning true only if the specified data format is available natively. 
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the 
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}

See Also

Concepts

Drag and Drop Overview

Reference

IDataObject

Other Resources

Drag and Drop Samples