DataObject.GetDataPresent Метод

Определение

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в указанный формат.Determines whether the data is available in, or can be converted to, a specified format.

Перегрузки

GetDataPresent(String)

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в формат, указанный строкой.Determines whether the data is available in, or can be converted to, a format specified by a string.

GetDataPresent(Type)

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в формат, указанный объектом Type.Determines whether the data is available in, or can be converted to, a format specified by a Type object.

GetDataPresent(String, Boolean)

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в указанный формат.Determines whether the data is available in, or can be converted to, a specified format. Флаг Boolean указывает, проверить ли возможность преобразования данных в указанный формат, если они не доступны в этом формате.A Boolean flag indicates whether to check if the data can be converted to the specified format if it is not available in that format.

Комментарии

Вызовите метод GetDataPresent , чтобы определить, доступен ли формат в этом объекте данных перед вызовом метода GetData .Call GetDataPresent to determine whether a format is available in this data object before calling GetData. Вызовите метод, GetFormats чтобы получить список всех форматов, доступных в этом объекте данных.Call GetFormats to obtain a list of all the formats that are available in this data object.

GetDataPresent(String)

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в формат, указанный строкой.Determines whether the data is available in, or can be converted to, a format specified by a string.

public:
 virtual bool GetDataPresent(System::String ^ format);
public bool GetDataPresent (string format);
abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool
Public Function GetDataPresent (format As String) As Boolean

Параметры

format
String

Строка, задающая формат для данных.A string that specifies the format for the data. Набор предопределенных форматов данных см. в статье о классе DataFormats.For a set of predefined data formats, see the DataFormats class.

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

Boolean

Значение true, если данные находятся в указанном формате или могут быть в него преобразованы; в противном случае — значение false.true if the data is in, or can be converted to, the specified format; otherwise, false.

Реализации

Исключения

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

Примеры

В следующем примере этот метод используется для запроса наличия определенного формата данных по строке дескриптора.The following example uses this method to query for the presence of a particular data format by descriptor string.

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

// Query for the presence of Text data in the data object, by a data format descriptor string.
// In this overload of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, string data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.StringFormat))
{
    textData = dataObject.GetData(DataFormats.StringFormat) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by a data format descriptor string.
' In this overload of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, string data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.StringFormat) Then
    textData = TryCast(dataObject.GetData(DataFormats.StringFormat), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText) Then
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Комментарии

Вызовите метод GetDataPresent , чтобы определить, доступен ли формат в этом объекте данных перед вызовом метода GetData .Call GetDataPresent to determine whether a format is available in this data object before calling GetData. Вызовите метод, GetFormats чтобы получить список всех форматов, доступных в этом объекте данных.Call GetFormats to obtain a list of all the formats that are available in this data object.

Применяется к

GetDataPresent(Type)

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в формат, указанный объектом Type.Determines whether the data is available in, or can be converted to, a format specified by a Type object.

public:
 virtual bool GetDataPresent(Type ^ format);
public bool GetDataPresent (Type format);
abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool
Public Function GetDataPresent (format As Type) As Boolean

Параметры

format
Type

Type, указывающий формат данных для проверки.A Type that specifies the data format to check. Сведения о преопределенных форматах данных см. в описании класса DataFormats.F or a set of predefined data formats, see the DataFormats class.

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

Boolean

Значение true, если данные находятся в указанном формате или могут быть в него преобразованы; в противном случае — значение false.true if the data is in, or can be converted to, the specified format; otherwise, false.

Реализации

Исключения

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

Примеры

В следующем примере этот метод используется для запроса наличия определенного формата данных по типу.The following example uses this method to query for the presence of a particular data format by type.

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

// Query for the presence of String data in the data object, by type.  In this overload 
// of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, the Text data present in the data object can be autoconverted
// to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
string stringData = null;
if (dataObject.GetDataPresent(typeof(string)))
{
    stringData = dataObject.GetData(DataFormats.Text) as string;
}
Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of String data in the data object, by type.  In this overload 
' of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, the Text data present in the data object can be autoconverted
' to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
Dim stringData As String = Nothing
If dataObject.GetDataPresent(GetType(String)) Then
    stringData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

Комментарии

Вызовите метод GetDataPresent , чтобы определить, доступен ли формат в этом объекте данных перед вызовом метода GetData .Call GetDataPresent to determine whether a format is available in this data object before calling GetData. Вызовите метод, GetFormats чтобы получить список всех форматов, доступных в этом объекте данных.Call GetFormats to obtain a list of all the formats that are available in this data object.

Применяется к

GetDataPresent(String, Boolean)

Определяет, доступны ли данные в указанном формате, или возможность их преобразования в указанный формат.Determines whether the data is available in, or can be converted to, a specified format. Флаг Boolean указывает, проверить ли возможность преобразования данных в указанный формат, если они не доступны в этом формате.A Boolean flag indicates whether to check if the data can be converted to the specified format if it is not available in that format.

public:
 virtual bool GetDataPresent(System::String ^ format, bool autoConvert);
public bool GetDataPresent (string format, bool autoConvert);
abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool
Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Параметры

format
String

Строка, указывающая формат данных для проверки.A string that specifies the data format to check. Набор предопределенных форматов данных см. в статье о классе DataFormats.For a set of predefined data formats, see the DataFormats class.

autoConvert
Boolean

false, чтобы проверить только указанный формат; true — чтобы также проверить, можно ли преобразовать хранящиеся в этом объекте данные в указанный формат.false to check only for the specified format; true to also check whether data stored in this data object can be converted to the specified format.

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

Boolean

Значение true, если данные находятся в указанном формате или могут быть в него преобразованы; в противном случае — значение false.true if the data is in, or can be converted to, the specified format; otherwise, false.

Реализации

Исключения

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

Примеры

В следующем примере этот метод используется для запроса данных по строке дескриптора и указывает, как следует обрабатывать автопреобразуемые форматы данных.The following example uses this method to query for data by descriptor string, and specifies how to treat auto-convertible data formats.

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

// Query for the presence of Text data in the data object, by data format descriptor string,
// and specifying whether auto-convertible data formats are acceptable.  

// In this case, Text data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.Text, false /* Auto-convert? */))
{
    textData = dataObject.GetData(DataFormats.Text) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, but it is not available natively, so GetDataPresent returns "false".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText, false /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
if (dataObject.GetDataPresent(DataFormats.UnicodeText, true /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by data format descriptor string,
' and specifying whether auto-convertible data formats are acceptable.  

' In this case, Text data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.Text, False) Then ' Auto-convert? 
    textData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, but it is not available natively, so GetDataPresent returns "false".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText, False) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
If dataObject.GetDataPresent(DataFormats.UnicodeText, True) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Комментарии

Вызовите метод GetDataPresent , чтобы определить, доступен ли формат в этом объекте данных перед вызовом метода GetData .Call GetDataPresent to determine whether a format is available in this data object before calling GetData. Вызовите метод, GetFormats чтобы получить список всех форматов, доступных в этом объекте данных.Call GetFormats to obtain a list of all the formats that are available in this data object.

Применяется к