DataObject.GetDataPresent Méthode

Définition

Espace de noms:: System.Windows

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

Nom	Description
GetDataPresent(String)	Détermine si les données sont disponibles ou peuvent être converties en format spécifié par une chaîne.
GetDataPresent(Type)	Détermine si les données sont disponibles ou peuvent être converties en un format spécifié par un Type objet.
GetDataPresent(String, Boolean)	Détermine si les données sont disponibles ou peuvent être converties dans un format spécifié. Un `Boolean` indicateur indique s’il faut vérifier si les données peuvent être converties au format spécifié s’il n’est pas disponible dans ce format.

Remarques

Appel 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 ou peuvent être converties en 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 obtenir un ensemble de formats de données prédéfinis, consultez la DataFormats classe.

Retours

Boolean

true si les données se trouvent ou peuvent être converties au format spécifié ; sinon, false.

Implémente

GetDataPresent(String)

Exceptions

ArgumentNullException

format a la valeur null.

Exemples

L’exemple suivant utilise cette méthode pour interroger 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

Voir aussi

Charger un exemple de fichier supprimé

S’applique à

GetDataPresent(Type)

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

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

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

Retours

Boolean

true si les données se trouvent ou peuvent être converties au format spécifié ; sinon, false.

Implémente

GetDataPresent(Type)

Exceptions

ArgumentNullException

format a la valeur null.

Exemples

L’exemple suivant utilise cette méthode pour interroger 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

Voir aussi

Charger un exemple de fichier supprimé

S’applique à

GetDataPresent(String, Boolean)

Détermine si les données sont disponibles ou peuvent être converties dans un format spécifié. Un Boolean indicateur indique s’il faut vérifier si les données peuvent être converties au format spécifié s’il n’est pas disponible 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 obtenir un ensemble de formats de données prédéfinis, consultez la DataFormats classe.

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 peuvent être converties au format spécifié.

Retours

Boolean

true si les données se trouvent ou peuvent être converties au format spécifié ; sinon, false.

Implémente

GetDataPresent(String, Boolean)

Exceptions

ArgumentNullException

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

Voir aussi

Charger un exemple de fichier supprimé

S’applique à

Commentaires

Cette page a-t-elle été utile ?