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) с набором autoConvertfalseпараметров), этот метод возвращаетсяnull.

Реализации

GetData(String, Boolean)

Исключения

ArgumentNullException

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

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

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