DataObject.GetDataPresent Método

Definição

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado.

Sobrecargas

Nome	Description
GetDataPresent(String)	Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado por uma cadeia de caracteres.
GetDataPresent(Type)	Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado por um Type objeto.
GetDataPresent(String, Boolean)	Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado. Um `Boolean` sinalizador indica se os dados podem ser convertidos no formato especificado se não estiverem disponíveis nesse formato.

Comentários

Chamada GetDataPresent para determinar se um formato está disponível neste objeto de dados antes de chamar GetData. Chame GetFormats para obter uma lista de todos os formatos disponíveis neste objeto de dados.

GetDataPresent(String)

Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado por uma cadeia de caracteres.

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

Uma cadeia de caracteres que especifica o formato dos dados. Para obter um conjunto de formatos de dados predefinidos, consulte a DataFormats classe.

Retornos

Boolean

true se os dados estiverem dentro ou puderem ser convertidos no formato especificado; caso contrário, false.

Implementações

GetDataPresent(String)

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo a seguir usa esse método para consultar a presença de um formato de dados específico por cadeia de caracteres de descritor.

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

Comentários

Confira também

Carregar um exemplo de arquivo descartado

Aplica-se a

GetDataPresent(Type)

Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado por um Type objeto.

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

Um Type que especifica o formato de dados a ser verificado. F ou um conjunto de formatos de dados predefinidos, consulte a DataFormats classe.

Retornos

Boolean

true se os dados estiverem dentro ou puderem ser convertidos no formato especificado; caso contrário, false.

Implementações

GetDataPresent(Type)

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo a seguir usa esse método para consultar a presença de um formato de dados específico 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

Comentários

Confira também

Carregar um exemplo de arquivo descartado

Aplica-se a

GetDataPresent(String, Boolean)

Determina se os dados estão disponíveis ou podem ser convertidos em um formato especificado. Um Boolean sinalizador indica se os dados podem ser convertidos no formato especificado se não estiverem disponíveis nesse 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

Uma cadeia de caracteres que especifica o formato de dados a ser verificado. Para obter um conjunto de formatos de dados predefinidos, consulte a DataFormats classe.

autoConvert: Boolean

false para verificar somente o formato especificado; true para verificar também se os dados armazenados nesse objeto de dados podem ser convertidos no formato especificado.

Retornos

Boolean

true se os dados estiverem dentro ou puderem ser convertidos no formato especificado; caso contrário, false.

Implementações

GetDataPresent(String, Boolean)

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo a seguir usa esse método para consultar dados por cadeia de caracteres de descritor e especifica como tratar formatos de dados conversíveis automáticos.

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

Comentários

Confira também

Carregar um exemplo de arquivo descartado

Aplica-se a

Comentários

Esta página foi útil?