Partager via


DataObject.GetDataPresent Méthode

Définition

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié.

Surcharges

GetDataPresent(String)

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié par une chaîne.

GetDataPresent(Type)

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié par un objet Type.

GetDataPresent(String, Boolean)

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié. Un indicateur Boolean indique s'il faut vérifier si les données peuvent être converties au format spécifié si elles ne sont pas disponibles dans ce format.

Remarques

Appelez GetDataPresent pour déterminer si un format est disponible dans cet objet de données avant d’appeler GetData. Appelez GetFormats pour obtenir la liste de tous les formats disponibles dans cet objet de données.

GetDataPresent(String)

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié par une chaîne.

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

Paramètres

format
String

Chaîne qui spécifie le format des données. Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

Retours

true en présence de données dans le format spécifié ou en cas de possibilité de conversion des données dans le format spécifié ; sinon false.

Implémente

Exceptions

format a la valeur null.

Exemples

L’exemple suivant utilise cette méthode pour rechercher la présence d’un format de données particulier par chaîne de descripteur.

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

Remarques

Appelez GetDataPresent pour déterminer si un format est disponible dans cet objet de données avant d’appeler GetData. Appelez GetFormats pour obtenir la liste de tous les formats disponibles dans cet objet de données.

Voir aussi

S’applique à

GetDataPresent(Type)

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié par un objet Type.

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

Paramètres

format
Type

Type qui spécifie le format de données à vérifier. Pour obtenir un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

Retours

true en présence de données dans le format spécifié ou en cas de possibilité de conversion des données dans le format spécifié ; sinon false.

Implémente

Exceptions

format a la valeur null.

Exemples

L’exemple suivant utilise cette méthode pour rechercher la présence d’un format de données particulier par type.

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

Remarques

Appelez GetDataPresent pour déterminer si un format est disponible dans cet objet de données avant d’appeler GetData. Appelez GetFormats pour obtenir la liste de tous les formats disponibles dans cet objet de données.

Voir aussi

S’applique à

GetDataPresent(String, Boolean)

Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié. Un indicateur Boolean indique s'il faut vérifier si les données peuvent être converties au format spécifié si elles ne sont pas disponibles dans ce format.

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

Paramètres

format
String

Chaîne qui spécifie le format de données à vérifier. Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

autoConvert
Boolean

false pour vérifier uniquement le format spécifié ; true pour vérifier également si les données stockées dans cet objet de données peut être converti au format spécifié.

Retours

true en présence de données dans le format spécifié ou en cas de possibilité de conversion des données dans le format spécifié ; sinon false.

Implémente

Exceptions

format a la valeur null.

Exemples

L’exemple suivant utilise cette méthode pour interroger des données par chaîne de descripteur et spécifie comment traiter les formats de données convertibles automatiquement.

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

Remarques

Appelez GetDataPresent pour déterminer si un format est disponible dans cet objet de données avant d’appeler GetData. Appelez GetFormats pour obtenir la liste de tous les formats disponibles dans cet objet de données.

Voir aussi

S’applique à