Partilhar via


DataObject.GetDataPresent Método

Definição

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

Sobrecargas

GetDataPresent(String)

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

GetDataPresent(Type)

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

GetDataPresent(String, Boolean)

Determina se os dados estão disponíveis em um formato especificado ou se podem ser convertidos nele. Um sinalizador Boolean indica se é necessário verificar se os dados podem ser convertidos no formato especificado, se ele não estiver disponível 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 em um formato especificado por uma cadeia de caracteres ou se eles podem ser convertidos nesse formato.

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 um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Retornos

Boolean

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

Implementações

Exceções

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

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.

Confira também

Aplica-se a

GetDataPresent(Type)

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

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 dos dados a ser verificado. F ou um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Retornos

Boolean

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

Implementações

Exceções

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

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.

Confira também

Aplica-se a

GetDataPresent(String, Boolean)

Determina se os dados estão disponíveis em um formato especificado ou se podem ser convertidos nele. Um sinalizador Boolean indica se é necessário verificar se os dados podem ser convertidos no formato especificado, se ele não estiver disponível 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 dos dados a ser verificado. Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

autoConvert
Boolean

false para verificar somente em busca do formato especificado; true para também verificar se os dados armazenados neste objeto de dados podem ser convertidos no formato especificado.

Retornos

Boolean

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

Implementações

Exceções

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

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.

Confira também

Aplica-se a