DataObject.GetDataPresent Método

Definición

Espacio de nombres:: System.Windows

Ensamblado:: PresentationCore.dll

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 .

Sobrecargas

Nombre	Description
GetDataPresent(String)	Determina si los datos están disponibles en un formato especificado por una cadena o se pueden convertir a ellos.
GetDataPresent(Type)	Determina si los datos están disponibles en un formato especificado por un Type objeto o se pueden convertir a ellos.
GetDataPresent(String, Boolean)	Determina si los datos están disponibles en un formato especificado o se pueden convertir a . Una `Boolean` marca indica si se pueden convertir los datos al formato especificado si no está disponible 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 ellos.

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 obtener un conjunto de formatos de datos predefinidos, consulte la DataFormats clase .

Devoluciones

Boolean

true si los datos están en , o se pueden convertir a , el formato especificado; de lo contrario, false.

Implementaciones

GetDataPresent(String)

Excepciones

ArgumentNullException

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

Consulte también

Carga de un ejemplo de archivo quitado

Se aplica a

GetDataPresent(Type)

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

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

que Type especifica el formato de datos que se va a comprobar. F o un conjunto de formatos de datos predefinidos, consulte la DataFormats clase .

Devoluciones

Boolean

true si los datos están en , o se pueden convertir a , el formato especificado; de lo contrario, false.

Implementaciones

GetDataPresent(Type)

Excepciones

ArgumentNullException

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

Consulte también

Carga de un ejemplo de archivo quitado

Se aplica a

GetDataPresent(String, Boolean)

Determina si los datos están disponibles en un formato especificado o se pueden convertir a . Una Boolean marca indica si se pueden convertir los datos al formato especificado si no está disponible 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 obtener un conjunto de formatos de datos predefinidos, consulte la DataFormats clase .

autoConvert: Boolean

false para comprobar solo el formato especificado; true para comprobar también si los datos almacenados en este objeto de datos se pueden convertir al formato especificado.

Devoluciones

Boolean

true si los datos están en , o se pueden convertir a , el formato especificado; de lo contrario, false.

Implementaciones

GetDataPresent(String, Boolean)

Excepciones

ArgumentNullException

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

Consulte también

Carga de un ejemplo de archivo quitado

Se aplica a

Comentarios

¿Le ha resultado útil esta página?