DataObject.GetData Method (String)

Returns data in a format specified by a string.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

public Object GetData(
	string format
)
You cannot use methods in XAML.

Parameters

format
Type: System.String

A string that specifies the format for the data. For a set of predefined data formats, see the DataFormats class.

Return Value

Type: System.Object
An object that contains the data in the specified format, or null if the data is unavailable in the specified format.

Implements

IDataObject.GetData(String)

ExceptionCondition
ArgumentNullException

format is null.

The following example uses this method to first check whether 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.

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[];
}

The following example code uses the GetDataPresent(String, Boolean) method 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.

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[];
}

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2015 Microsoft