DataObject.GetDataPresent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
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 -> boolPublic Function GetDataPresent (format As String) As BooleanPará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 -> boolPublic Function GetDataPresent (format As Type) As BooleanPará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 -> boolPublic Function GetDataPresent (format As String, autoConvert As Boolean) As BooleanPará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.
