Compartir a través de


DataObject.GetDataPresent Método

Definición

Determina si los datos están disponibles en un formato especificado o se pueden convertir a él.

Sobrecargas

GetDataPresent(String)

Determina si los datos están disponibles en un formato especificado por una cadena o se pueden convertir a él.

GetDataPresent(Type)

Determina si los datos están disponibles en un formato especificado por un objeto Type o se pueden convertir a él.

GetDataPresent(String, Boolean)

Determina si los datos están disponibles en un formato especificado o se pueden convertir a él. Un marcador de tipo Boolean indica si se comprueba si los datos se pueden convertir al formato especificado si no están disponibles en ese formato.

Comentarios

Llame GetDataPresent a para determinar si un formato está disponible en este objeto de datos antes de llamar a GetData. Llame GetFormats a para obtener una lista de todos los formatos disponibles en este objeto de datos.

GetDataPresent(String)

Determina si los datos están disponibles en un formato especificado por una cadena o se pueden convertir a él.

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

Parámetros

format
String

Cadena que especifica el formato de los datos. Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

Devoluciones

Es true si los datos tienen el formato especificado o se pueden convertir en él; de lo contrario, es false.

Implementaciones

Excepciones

format es null.

Ejemplos

En el ejemplo siguiente se usa este método para consultar la presencia de un formato de datos determinado por cadena de descriptor.

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

Comentarios

Llame GetDataPresent a para determinar si un formato está disponible en este objeto de datos antes de llamar a GetData. Llame GetFormats a para obtener una lista de todos los formatos disponibles en este objeto de datos.

Consulte también

Se aplica a

GetDataPresent(Type)

Determina si los datos están disponibles en un formato especificado por un objeto Type o se pueden convertir a él.

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

Parámetros

format
Type

Type que especifica el formato de datos que se va a comprobar. Para obtener un conjunto de formatos de datos predefinidos, vea la clase DataFormats.

Devoluciones

Es true si los datos tienen el formato especificado o se pueden convertir en él; de lo contrario, es false.

Implementaciones

Excepciones

format es null.

Ejemplos

En el ejemplo siguiente se usa este método para consultar la presencia de un formato de datos determinado por tipo.

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

Comentarios

Llame GetDataPresent a para determinar si un formato está disponible en este objeto de datos antes de llamar a GetData. Llame GetFormats a para obtener una lista de todos los formatos disponibles en este objeto de datos.

Consulte también

Se aplica a

GetDataPresent(String, Boolean)

Determina si los datos están disponibles en un formato especificado o se pueden convertir a él. Un marcador de tipo Boolean indica si se comprueba si los datos se pueden convertir al formato especificado si no están disponibles en ese formato.

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

Parámetros

format
String

Cadena que especifica el formato de datos que se va a comprobar. Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

autoConvert
Boolean

Es false para comprobar sólo el formato especificado; es true para comprobar también si los datos almacenados en este objeto de datos se puede convertir al formato especificado.

Devoluciones

Es true si los datos tienen el formato especificado o se pueden convertir en él; de lo contrario, es false.

Implementaciones

Excepciones

format es null.

Ejemplos

En el ejemplo siguiente se usa este método para consultar los datos por cadena de descriptor y se especifica cómo tratar los formatos de datos convertibles automáticamente.

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

Comentarios

Llame GetDataPresent a para determinar si un formato está disponible en este objeto de datos antes de llamar a GetData. Llame GetFormats a para obtener una lista de todos los formatos disponibles en este objeto de datos.

Consulte también

Se aplica a