DataObject.GetData Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

Возвращает данные в указанном формате.

Перегрузки

GetData(String)	Возвращает данные в формате, указанном строкой.
GetData(Type)	Возвращает объект данных в формате, указанном объектом Type.
GetData(String, Boolean)	Возвращает объект данных в указанном формате, при необходимости преобразуя данные в этот формат.

GetData(String)

Возвращает данные в формате, указанном строкой.

public:
 virtual System::Object ^ GetData(System::String ^ format);

public object GetData (string format);

abstract member GetData : string -> obj
override this.GetData : string -> obj

Public Function GetData (format As String) As Object

Параметры

format

String

Строка, задающая формат для данных. Набор предопределенных форматов данных см. в статье о классе DataFormats.

Возвращаемое значение

Object

Объект, содержащий данные в указанном формате, или значение null, если данные недоступны в указанном формате.

Реализации

GetData(String)

Исключения

ArgumentNullException

format имеет значение null.

Примеры

В следующем примере используется этот метод, чтобы сначала проверить, доступен ли указанный формат данных (в собственном коде или с помощью автоматического преобразования); Если указанный формат доступен, в примере извлекаются данные с помощью GetData(String) метода.

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

Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing

' 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) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

В следующем примере кода используется GetDataPresent(String, Boolean) метод, чтобы сначала проверить, доступен ли указанный формат данных в собственном коде (автоматически преобразуемые форматы данных фильтруются); если указанный формат доступен, пример извлекает данные с помощью GetData(String) метода.

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

Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing

' 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) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

См. также раздел

• Загрузка примера удаленного файла

GetData(Type)

Возвращает объект данных в формате, указанном объектом Type.

public:
 virtual System::Object ^ GetData(Type ^ format);

public object GetData (Type format);

abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Function GetData (format As Type) As Object

Параметры

format

Type

Type, указывающий формат данных. Набор предопределенных форматов данных см. в статье о классе DataFormats.

Возвращаемое значение

Object

Объект данных с данными в указанном формате или значение null, если данные в указанном формате недоступны.

Реализации

GetData(Type)

Исключения

ArgumentNullException

format имеет значение null.

См. также раздел

• Загрузка примера удаленного файла

GetData(String, Boolean)

Возвращает объект данных в указанном формате, при необходимости преобразуя данные в этот формат.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object GetData (string format, bool autoConvert);

abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

Параметры

format

String

Строка, задающая формат для данных. Набор предопределенных форматов данных см. в статье о классе DataFormats.

autoConvert

Boolean

Значение true — пытаться автоматически преобразовать данные в указанный формат; значение false — без преобразования формата данных.

Возвращаемое значение

Object

Объект данных с данными в указанном формате или значение null, если данные в указанном формате недоступны.

Если параметр autoConvert равен true, а данные нельзя преобразовать в указанный формат, или если автоматическое преобразование отключено (вызовом метода SetData(String, Object, Boolean) с параметром autoConvert, равным false), данный метод возвращает значение null.

Реализации

GetData(String, Boolean)

Исключения

ArgumentNullException

Параметр format имеет значение NULL.

См. также раздел

• Загрузка примера удаленного файла